feat: Docs related to workflows and modules

.github/styles/config/vocabularies/technical/accept.txt

@@ -39,8 +39,40 @@ Signup
 reCAPTCHA
 Edition
 Embed
+Datasources
+Workflow
+Workflows
+Webhook
+workflow
+SMTP
+Postman
+assignRequest
+message
+resolutions
+requestName
+metadata
+requestToUsers
+requestToGroups
+Metadata
+Queries
+queries
+Functions
+functions
+JavaScript
+javascript
+Datasource
+datasource
+Human-in-the-Loop
+workflowInstanceId
+resolution
+payload
+executeWorkflow
+data
+Data
+Resolution
+workflows
 Exec
 Libraries
 libraries
 JS
-UserAgent
+UserAgent

website/docs/advanced-concepts/granular-access-control/roles.md

@@ -41,7 +41,7 @@ In this section, you'll find permissions related to the application and its reso
 | **App** | Create pages and queries inside the app | Edit pages and queries inside the app. | Delete the app and its pages and queries. | View the app and its pages and queries. | - | Make the application public | Export that particular application. |
 | **Page** | Create queries on the page. | Edit the page and its queries. | Delete the page and its queries. | View the page and its queries. | - | - | - |
 | **Query** | - | Edit the query. | Delete the query. | View the query. | Execute the query. | - | - |
-
+| **Workflows** | Create new workflows and resources inside a workflow. | Required to make changes to the Workflow.| Required to delete a workflow. Users will need **Edit** permission to delete individual actions inside the workflow. | An **Edit** permission also enables the permission to view workflow run history.| An **Edit** permission also enables the **Execute** permission to run workflow.| - | -|
 
 ### Datasource and environments
 

website/docs/packages/how-to-guides/create-js-module.md

@@ -0,0 +1,257 @@
+---
+title: Refresh OAuth Tokens Using JS Modules
+hide_title: true
+---
+<!-- vale off -->
+
+<div className="tag-wrapper">
+ <h1>Refresh OAuth Tokens Using JS Modules</h1>
+
+<Tags
+tags={[
+{ name: "Business", link: "https://www.appsmith.com/pricing", additionalClass: "business" }
+]}
+/>
+
+</div>
+
+<!-- vale on -->
+
+This guide demonstrates how to use JS modules to refresh OAuth tokens across all apps, enabling you to renew and extend your authentication access.
+
+## Create JS module
+<div style={{ position: "relative", paddingBottom: "calc(50.520833333333336% + 41px)", height: "0", width: "100%" }}>
+  <iframe src="https://demo.arcade.software/3sTHVS5YLf5WTA05iplD?embed" frameborder="0" loading="lazy" webkitallowfullscreen mozallowfullscreen allowfullscreen style={{ position: "absolute", top: "0", left: "0", width: "100%", height: "100%", colorScheme: "light" }} title="Appsmith | Connect Data">
+  </iframe>
+</div>
+
+
+1. Click the **Create New** button from the top-right corner of your workspace and **Create a new package**.
+
+2. Click **New Module** > **JS Module**.
+
+
+:::info
+The JS module allows you to create queries and JS objects. The Main JS object represents the code for the JS module.
+:::
+
+
+
+3. Create a datasource within this JS module.
+
+<dd>
+
+*Example:* To create a refresh token module, start by establishing a new API endpoint to call the token refresh endpoint provided by your authentication service. For OAuth services, ensure that you add the refresh token in the request payload to receive a new access token.
+
+
+```js
+https://api.example.io/api/user/token-auth/
+```
+
+
+</dd>
+
+:::caution
+Passing Query Module data to JS modules is not supported.
+:::
+
+4. Inside Main JS Object / JS Module Code and add a function to refresh the token, like:
+
+
+<dd>
+
+*Example:* 
+
+Create a function named `verifyAccessToken` checks if the access token is still valid. If it's about to expire, another function, `refreshAccessToken`, automatically fetches a new token in the background. This ensures that users won't face interruptions while using the app, and their access remains secure and up-to-date.
+
+
+
+```js
+export default {
+  // Generate a new access token by calling the authorization API
+  async generateAccessToken() {
+    await api_authToken.run();
+    const generatedToken = api_authToken.data;
+    if (generatedToken)
+      this.storeToken(
+        generatedToken.access_token,
+        generatedToken.refresh_token,
+      );
+  },
+
+  // Store the access token, refresh token, and expiry in the Appsmith store
+  storeToken(accessToken, refreshToken) {
+    storeValue("authAccessToken", accessToken);
+    if (refreshToken) {
+      storeValue("authRefreshToken", refreshToken);
+    }
+    storeValue("authAccessTokenExp", this.getTokenExpiry(accessToken));
+  },
+
+  // Extract the expiry timestamp from the access token payload
+  getTokenExpiry(token) {
+    try {
+      return JSON.parse(atob(token.split(".")[1])).exp * 1000;
+    } catch (error) {
+      console.error("Error decoding token:", error);
+      return null;
+    }
+  },
+
+  // Verify if the access token has expired
+  verifyAccessTokenExpired() {
+    console.log(
+      "time left",
+      (new Date(appsmith.store.authAccessTokenExp).getTime() -
+        new Date().getTime()) /
+        (1000 * 60),
+      "mins",
+    );
+    return (
+      new Date().getTime() >
+      new Date(appsmith.store.authAccessTokenExp).getTime()
+    );
+  },
+
+  // Refresh the access token when expired by calling the API
+  async refreshAccessToken() {
+    // call to
+    await api_refreshAuthToken.run();
+    const refreshToken = api_refreshAuthToken.data;
+    if (refreshToken) {
+      // update the Appsmith store with the new access and refresh tokens
+      console.log("Token: " + refreshToken.access_token);
+      this.storeToken(refreshToken.access_token);
+    } else {
+      console.error("Failed to refresh access token");
+    }
+  },
+
+  // Get the access token, refresh it if needed, and return from the Appsmith store
+  async getAccessToken() {
+    // verify if the access token is present in the Appsmith store
+    if (appsmith.store.authAccessToken) {
+      // verify if the token has expired
+      if (this.verifyAccessTokenExpired()) {
+        //refresh the access token
+        await this.refreshAccessToken();
+      }
+    } else {
+      //generate initial access token with authorization
+      await this.generateAccessToken();
+    }
+    // return the access token from Appsmith store
+    return appsmith.store.authAccessToken;
+  },
+};
+```
+
+Configuration may vary depending on the authentication provider or tool you are using.
+
+</dd>
+
+5. Create a new API to handle the generation of tokens when an authentication token expires.
+
+<dd>
+
+```js
+https://api.example.io/api/user/token-refresh/
+``` 
+
+In the API configuration, provide the refresh token from the store in the request body:
+
+```js
+{
+    "refresh_token":{{appsmith.store.authRefreshToken}}
+}
+```
+</dd>
+
+
+
+5. Run and Publish the JS Module.
+
+
+
+
+## Use JS Module
+
+Once you've created a JS module, follow these steps to access its data in any application:
+
+<div style={{ position: "relative", paddingBottom: "calc(50.520833333333336% + 41px)", height: "0", width: "100%" }}>
+  <iframe src="https://demo.arcade.software/Nx2dcZBHP12JyiREzDZF?embed" frameborder="0" loading="lazy" webkitallowfullscreen mozallowfullscreen allowfullscreen style={{ position: "absolute", top: "0", left: "0", width: "100%", height: "100%", colorScheme: "light" }} title="Appsmith | Connect Data">
+  </iframe>
+</div>
+
+
+1. Open your **App** from the homepage and ensure that both the app and modules share the same workspace.
+
+2. In the entity explorer, select the JS module and configure the function settings as needed.
+
+3. Create a new API inside the app to fetch data using the generated token.
+
+
+<dd>
+
+*Example:* 
+
+```js
+https://api.baserow.io/api/database/rows/table/245748/?user_field_names=true
+```
+
+For the authorization header, add:
+
+```js
+Key: Authorization 
+Value: JWT {{Auth_Module.getAccessToken.data}}
+```
+
+Configure the query based on your specific endpoint or tool requirements.
+
+
+</dd>
+
+4. Create a new JavaScript object to execute the authentication module before fetching data, preventing potential errors in case of simultaneous execution on page load. 
+
+<dd>
+
+```js
+export default {
+	onPageLoad: () => {
+		Auth_Module.getAccessToken()
+			.then(() => getusers_API.run());
+}}
+```
+
+Set this JSobject to run on page load.
+
+
+
+</dd>
+
+5. To display the data, drag a Table widget, enable JS, and bind the data, like:
+
+
+<dd>
+
+*Example:*
+
+```js
+{{getusers_API.data.results}}
+```
+
+</dd>
+
+
+4. If you want to trigger a function based on an event, you can bind the JS module function to the event of that widget, like:
+
+<dd>
+
+*Example:*
+
+
+```js
+{{JSModule_manage_tokens.getAccessToken();}}
+```
+
+</dd>