Generate Client using OpenAPI spec tool, Update Sanitations, Update Overview, Setup Guide and Quickstart and Add Test Cases and examples

README.md

@@ -8,21 +8,162 @@
 
 ## Overview
 
-[//]: # (TODO: Add overview mentioning the purpose of the module, supported REST API versions, and other high-level details.)
+[HubSpot](https://www.hubspot.com) is an AI-powered customer relationship management (CRM) platform. 
+
+The ballerinax/hubspot.crm.commerce.taxes offers APIs to connect and interact with the [Taxes](https://developers.hubspot.com/docs/guides/api/crm/commerce/taxes) endpoints, specifically based on the [Taxes API Docs](https://developers.hubspot.com/docs/reference/api/crm/commerce/taxes)
 
 ## Setup guide
 
-[//]: # (TODO: Add detailed steps to obtain credentials and configure the module.)
+You need a [HubSpot developer account](https://developers.hubspot.com/get-started) with an [app](https://developers.hubspot.com/docs/guides/apps/public-apps/overview) to use HubSpot connectors.
+>To create a HubSpot Developer account, [click here](https://app.hubspot.com/signup-hubspot/developers)
+
+### Step 1: Create HubSpot Developer Project
+1. [Login](https://app.hubspot.com/login) to HubSpot developer account.
+
+2. Create a public app by clicking on `Create app`.
+
+   ![alt text](<https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/docs/setup/resources/build_public_app.png>)
+
+3. Click on `Create app`.
+![alt text](<https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/docs/setup/resources/create_app.png>)
+
+4. Under `App Info`
+   - Enter `Public app name`.
+   - Update `App logo` (optional).
+   - Update `Description` (optional). 
+
+   ![alt text](<https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/docs/setup/resources/enter_app_details.png>)
+
+- Then move to `Auth` tab.
+
+5. Setup the `Redirect URLs` with respective links.
+   >Example: http://localhost:9090  
+
+   ![alt text](<https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/docs/setup/resources/auth_page.png>)
+
+Finally `Create app`.
+
+### Step 2: Get `Client ID` and `Client secret`.
+Navigate to `Auth` tab.
+
+![alt text](<https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/docs/setup/resources/client_id_secret.png>)
+
+### Step 3: Get `access token` and `refresh token`.
+
+1. Set scopes under `Auth` tab for your app based on the [API requirements](https://developers.hubspot.com/docs/reference/api).
+
+   >Example: https://developers.hubspot.com/docs/reference/api/crm/commerce/taxes
+   ![alt text](<https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/docs/setup/resources/exmaple_api_reference.png>)
+
+2. Under `Auth` tab under `Sample install URL (OAuth)` section `Copy full URL`.
+   >**Note:** The above copied URL is in the following format.
+   ```
+   https://app.hubspot.com/oauth/authorize?client_id=<client_id>&redirect_uri=<redirect_url>&scope=<scopes>
+   ```
+
+3. Choose the preferred account.
+
+   ![alt text](<https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/docs/setup/resources/account_chose.png>)
+
+   Choose account and authorize the client.
+
+4. `This site can’t be reached` message will appear. Look in the URL and find the authorization code.
+   >Example: code=na1-*************************
+
+5. Send a http request to the HubSpot.
+
+   * Linux/macOS
+
+     ```bash
+     curl --request POST \
+     --url https://api.hubapi.com/oauth/v1/token \
+     --header 'content-type: application/x-www-form-urlencoded' \
+     --data 'grant_type=authorization_code&code=<CODE>&redirect_uri=<YOUR_REDIRECT_URI>&client_id=<YOUR_CLIENT_ID>&client_secret=<YOUR_CLIENT_SECRET>'
+     ```
+
+   * Windows
+
+     ```bash
+     curl --request POST ^
+     --url https://api.hubapi.com/oauth/v1/token ^
+     --header 'content-type: application/x-www-form-urlencoded' ^
+     --data 'grant_type=authorization_code&code=<CODE>&redirect_uri=<YOUR_REDIRECT_URI>&client_id=<YOUR_CLIENT_ID>&client_secret=<YOUR_CLIENT_SECRET>'
+     ```
+
+6. Above command returns the `access token` and `refresh token`.
+
+7. Use these tokens to authorize the client.
 
 ## Quickstart
 
-[//]: # (TODO: Add a quickstart guide to demonstrate a basic functionality of the module, including sample code snippets.)
+To use the `HubSpot CRM Commerce Taxes` connector in your Ballerina application, update the `.bal` file as follows:
+
+### Step 1: Import the module
+
+Import the `hubspot.crm.commerce.taxes` module and `oauth2` module.
+
+```ballerina
+import ballerinax/hubspot.crm.commerce.taxes;
+import ballerina/oauth2;
+```
+
+### Step 2: Instantiate a new connector
+
+1. Create a `Config.toml` file and, configure the obtained credentials obtained in the above steps as follows:
+
+   ```toml
+    clientId = <Client Id>
+    clientSecret = <Client Secret>
+    refreshToken = <Refresh Token>
+   ```
+
+2. Instantiate a `OAuth2RefreshTokenGrantConfig` with the obtained credentials and initialize the connector with it.
+
+    ```ballerina
+   configurable string clientId = ?;
+   configurable string clientSecret = ?;
+   configurable string refreshToken = ?;
+
+   taxes:ConnectionConfig config = {
+      auth : {
+         clientId,
+         clientSecret,
+         refreshToken,
+         credentialBearer: oauth2:POST_BODY_BEARER 
+      }
+   };
+   final taxes:Client hubSpotClient = check new taxes:Client(config);
+   ```
+
+### Step 3: Invoke the connector operation
+
+Now, utilize the available connector operations. A sample usecase is shown below.
+
+#### Create a New Tax
+
+```ballerina
+
+   taxes:SimplePublicObjectInputForCreate payload = {
+
+      associations: [],
+      objectWriteTraceId: "1234",
+      properties: {
+         "hs_label": "A percentage-based tax of 6%",
+         "hs_type": "PERCENT",
+         "hs_value": "6"
+      }
+
+      taxes:SimplePublicObject|error response = check hubspotClientTax->/.post(payload);
+
+   };
+```
 
 ## Examples
 
 The `HubSpot CRM Commerce Taxes` connector provides practical examples illustrating usage in various scenarios. Explore these [examples](https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/examples/), covering the following use cases:
 
-[//]: # (TODO: Add examples)
+1. [Manage Taxes](https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/examples/manage-taxes/) - see how the Hubspot taxes API can be used to create a tax and manage it through the sales pipeline.
+2. [Search Taxes](https://github.com/module-ballerinax-hubspot.crm.commerce.taxes/tree/main/examples/search_taxes/) - see how the Hubspot taxes API can be used to search for taxes using properties and create a batch of taxes
 
 ## Build from the source
 

ballerina/Ballerina.toml

@@ -2,15 +2,15 @@
 distribution = "2201.10.0"
 org = "ballerinax"
 name = "hubspot.crm.commerce.taxes"
-version = "1"
+version = "1.0.0"
 license = ["Apache-2.0"]
 authors = ["Ballerina"]
-keywords = []
-# icon = "icon.png" # TODO: update icon.png
+keywords = [] # TODO: Add keywords
+# icon = "icon.png" # TODO: Add icon
 repository = "https://github.com/ballerina-platform/module-ballerinax-hubspot.crm.commerce.taxes"
 
 [build-options]
 observabilityIncluded = true
 
-[platform.java21]
+[platform.java17]
 graalvmCompatible = true