@cobaltio/cobalt-js 3.0.2 → 3.0.3

package/README.md

@@ -59,8 +59,7 @@ cobalt.token = "COBALT_SESSION_TOKEN";
 
 <dl>
 <dt><a href="#Cobalt">Cobalt</a></dt>
-<dd><p>Cobalt Frontend SDK</p>
-</dd>
+<dd></dd>
 </dl>
 
 ## Typedefs
@@ -69,14 +68,8 @@ cobalt.token = "COBALT_SESSION_TOKEN";
 <dt><a href="#Application">Application</a> : <code>Object</code></dt>
 <dd><p>An application in Cobalt.</p>
 </dd>
-<dt><a href="#Label">Label</a> : <code>Object</code></dt>
-<dd><p>Field Mapping Label</p>
-</dd>
-<dt><a href="#DynamicField">DynamicField</a> : <code>Object</code></dt>
-<dd><p>Field Mapping Label</p>
-</dd>
-<dt><a href="#DynamicFields">DynamicFields</a> : <code>Object</code></dt>
-<dd><p>The dynamic fields payload.</p>
+<dt><a href="#InputField">InputField</a> : <code>Object</code></dt>
+<dd><p>An Input field to take input from the user.</p>
 </dd>
 <dt><a href="#Config">Config</a> : <code>Object</code></dt>
 <dd><p>The configuration data for an application.</p>
@@ -84,13 +77,20 @@ cobalt.token = "COBALT_SESSION_TOKEN";
 <dt><a href="#Workflow">Workflow</a> : <code>Object</code></dt>
 <dd><p>The workflow.</p>
 </dd>
+<dt><a href="#DynamicFields">DynamicFields</a> : <code>Object</code></dt>
+<dd><p>The dynamic fields payload.</p>
+</dd>
+<dt><a href="#DynamicField">DynamicField</a> : <code>Object</code></dt>
+<dd><p>Field Mapping Label</p>
+</dd>
+<dt><a href="#Label">Label</a> : <code>Object</code></dt>
+<dd><p>Field Mapping Label</p>
+</dd>
 </dl>
 
 <a name="Cobalt"></a>
 
 ## Cobalt
-Cobalt Frontend SDK
-
 **Kind**: global class
 
 * [Cobalt](#Cobalt)
@@ -100,8 +100,8 @@ Cobalt Frontend SDK
     * [.config(slug, configId, [fields])](#Cobalt+config) ⇒ [<code>Promise.&lt;Config&gt;</code>](#Config)
     * [.updateConfig(slug, configId, payload)](#Cobalt+updateConfig) ⇒ [<code>Promise.&lt;Config&gt;</code>](#Config)
     * [.deleteConfig(slug, configId)](#Cobalt+deleteConfig) ⇒ <code>Promise.&lt;unknown&gt;</code>
-* Additional Methods:
-    * [.getApp(slug)](#Cobalt+getApp) ⇒ [<code>Promise.&lt;Application&gt;</code>](#Application)
+Additional Methods:
+    * [.getApp([slug])](#Cobalt+getApp) ⇒ [<code>Promise.&lt;Application&gt;</code>](#Application)
     * [.getConfig(slug, configId)](#Cobalt+getConfig) ⇒ [<code>Promise.&lt;Config&gt;</code>](#Config)
 
 <a name="new_Cobalt_new"></a>
@@ -118,16 +118,17 @@ Cobalt Frontend SDK
 
 <a name="Cobalt+getApp"></a>
 
-### cobalt.getApp(slug) ⇒ [<code>Promise.&lt;Application&gt;</code>](#Application)
+### cobalt.getApp([slug]) ⇒ [<code>Promise.&lt;Application&gt;</code>](#Application)
 Returns the application details for the specified application, provided
-the application is enabled in Cobalt.
+the application is enabled in Cobalt. If no application is specified,
+it returns all the enabled applications.
 
 **Kind**: instance method of [<code>Cobalt</code>](#Cobalt)
 **Returns**: [<code>Promise.&lt;Application&gt;</code>](#Application) - The application details.
 
 | Param | Type | Description |
 | --- | --- | --- |
-| slug | <code>String</code> | The application slug. |
+| [slug] | <code>String</code> | The application slug. |
 
 <a name="Cobalt+connect"></a>
 
@@ -223,31 +224,51 @@ An application in Cobalt.
 | [slug] | <code>String</code> | The application slug for custom apps. |
 | auth_type | <code>&quot;oauth2&quot;</code> \| <code>&quot;keybased&quot;</code> | The type of auth used by application. |
 | [connected] | <code>Boolean</code> | Whether the user has connected the application. |
+| [auth_input_map] | [<code>Array.&lt;InputField&gt;</code>](#InputField) | The fields required from the user to connect the application (for `keybased` auth type). |
 
-<a name="Label"></a>
+<a name="InputField"></a>
 
-## Label : <code>Object</code>
-Field Mapping Label
+## InputField : <code>Object</code>
+An Input field to take input from the user.
 
 **Kind**: global typedef
 **Properties**
 
 | Name | Type | Description |
 | --- | --- | --- |
-| name | <code>string</code> | The Label name. |
-| value | <code>string</code> \| <code>number</code> \| <code>boolean</code> | The Label value. |
+| name | <code>String</code> | Key name of the field. |
+| type | <code>String</code> | Input type of the field. |
+| required | <code>String</code> | Whether the field is required. |
+| placeholder | <code>String</code> | The placeholder of the field. |
+| label | <code>String</code> | The label of the field. |
 
-<a name="DynamicField"></a>
+<a name="Config"></a>
 
-## DynamicField : <code>Object</code>
-Field Mapping Label
+## Config : <code>Object</code>
+The configuration data for an application.
 
 **Kind**: global typedef
 **Properties**
 
 | Name | Type | Description |
 | --- | --- | --- |
-| fields | [<code>Array.&lt;Label&gt;</code>](#Label) | The Label name. |
+| [config_id] | <code>String</code> | Unique ID for the config. |
+| application_data_slots | <code>Object.&lt;string, (string\|number\|boolean)&gt;</code> | A map of application data slots and their values. |
+| workflows | [<code>Array.&lt;Workflow&gt;</code>](#Workflow) | Whether the workflow is enabled. |
+
+<a name="Workflow"></a>
+
+## Workflow : <code>Object</code>
+The workflow.
+
+**Kind**: global typedef
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| id | <code>String</code> | The ID of the workflow. |
+| enabled | <code>Boolean</code> | Whether the workflow is enabled. |
+| data_slots | <code>Object.&lt;string, (string\|number\|boolean)&gt;</code> | A map of workflow's data slots and their values. |
 
 <a name="DynamicFields"></a>
 
@@ -261,30 +282,27 @@ The dynamic fields payload.
 | --- | --- | --- |
 | map_fields_object | <code>Object.&lt;string, DynamicField&gt;</code> | desc. |
 
-<a name="Config"></a>
+<a name="DynamicField"></a>
 
-## Config : <code>Object</code>
-The configuration data for an application.
+## DynamicField : <code>Object</code>
+Field Mapping Label
 
 **Kind**: global typedef
 **Properties**
 
 | Name | Type | Description |
 | --- | --- | --- |
-| [config_id] | <code>String</code> | Unique ID for the config. |
-| application_data_slots | <code>Object.&lt;string, (string\|number\|boolean)&gt;</code> | A map of application data slots and their values. |
-| workflows | [<code>Array.&lt;Workflow&gt;</code>](#Workflow) | Whether the workflow is enabled. |
+| fields | [<code>Array.&lt;Label&gt;</code>](#Label) | The Label name. |
 
-<a name="Workflow"></a>
+<a name="Label"></a>
 
-## Workflow : <code>Object</code>
-The workflow.
+## Label : <code>Object</code>
+Field Mapping Label
 
 **Kind**: global typedef
 **Properties**
 
 | Name | Type | Description |
 | --- | --- | --- |
-| id | <code>String</code> | The ID of the workflow. |
-| enabled | <code>Boolean</code> | Whether the workflow is enabled. |
-| data_slots | <code>Object.&lt;string, (string\|number\|boolean)&gt;</code> | A map of workflow's data slots and their values. |
+| name | <code>string</code> | The Label name. |
+| value | <code>string</code> \| <code>number</code> \| <code>boolean</code> | The Label value. |

package/cobalt.js

@@ -1,6 +1,58 @@
 /**
  * Cobalt Frontend SDK
  */
+
+/**
+ * @typedef {Object} Application An application in Cobalt.
+ * @property {String} name The application name.
+ * @property {String} description The application description.
+ * @property {String} icon The application icon.
+ * @property {String} type The application slug for native apps.
+ * @property {String} [slug] The application slug for custom apps.
+ * @property {"oauth2"|"keybased"} auth_type The type of auth used by application.
+ * @property {Boolean} [connected] Whether the user has connected the application.
+ * @property {InputField[]} [auth_input_map] The fields required from the user to connect the application (for `keybased` auth type).
+ */
+
+/**
+ * @typedef {Object} InputField An Input field to take input from the user.
+ * @property {String} name Key name of the field.
+ * @property {String} type Input type of the field.
+ * @property {String} required Whether the field is required.
+ * @property {String} placeholder The placeholder of the field.
+ * @property {String} label The label of the field.
+ */
+
+/**
+ * @typedef {Object} Config The configuration data for an application.
+ * @property {String} [config_id] Unique ID for the config.
+ * @property {Object.<string, string | number | boolean>} application_data_slots A map of application data slots and their values.
+ * @property {Workflow[]} workflows Whether the workflow is enabled.
+ */
+
+/**
+ * @typedef {Object} Workflow The workflow.
+ * @property {String} id The ID of the workflow.
+ * @property {Boolean} enabled Whether the workflow is enabled.
+ * @property {Object.<string, string | number | boolean>} data_slots A map of workflow's data slots and their values.
+ */
+
+/**
+ * @typedef {Object} DynamicFields The dynamic fields payload.
+ * @property {Object.<string, DynamicField>} map_fields_object desc.
+ */
+
+/**
+ * @typedef {Object} DynamicField Field Mapping Label
+ * @property {Label[]} fields The Label name.
+ */
+
+/**
+ * @typedef {Object} Label Field Mapping Label
+ * @property {string} name The Label name.
+ * @property {string | number | boolean} value The Label value.
+ */
+
 class Cobalt {
     /**
      * Cobalt Frontend SDK
@@ -21,25 +73,15 @@ class Cobalt {
         return this.sessionToken = typeof token === "string" ? token : "";
     };
 
-    /**
-     * @typedef {Object} Application An application in Cobalt.
-     * @property {String} name The application name.
-     * @property {String} description The application description.
-     * @property {String} icon The application icon.
-     * @property {String} type The application slug for native apps.
-     * @property {String} [slug] The application slug for custom apps.
-     * @property {"oauth2"|"keybased"} auth_type The type of auth used by application.
-     * @property {Boolean} [connected] Whether the user has connected the application.
-     */
-
     /**
      * Returns the application details for the specified application, provided
-     * the application is enabled in Cobalt.
-     * @param {String} slug The application slug.
+     * the application is enabled in Cobalt. If no application is specified,
+     * it returns all the enabled applications.
+     * @param {String} [slug] The application slug.
      * @returns {Promise<Application>} The application details.
      */
     async getApp(slug) {
-        const res = await fetch(`${this.baseUrl}/api/v1/linked-acc/application/${slug}`, {
+        const res = await fetch(`${this.baseUrl}/api/v1/linked-acc/application` + (slug ? `/${slug}` : ""), {
             headers: {
                 authorization: `Bearer ${this.token}`,
             },
@@ -169,22 +211,6 @@ class Cobalt {
         }
     }
 
-    /**
-     * @typedef {Object} Label Field Mapping Label
-     * @property {string} name The Label name.
-     * @property {string | number | boolean} value The Label value.
-     */
-
-    /**
-     * @typedef {Object} DynamicField Field Mapping Label
-     * @property {Label[]} fields The Label name.
-     */
-
-    /**
-     * @typedef {Object} DynamicFields The dynamic fields payload.
-     * @property {Object.<string, DynamicField>} map_fields_object desc.
-     */
-
     /**
      * Returns the specified config, or creates one if it doesn't exist.
      * @param {String} slug The application slug.
@@ -209,20 +235,6 @@ class Cobalt {
         return await res.json();
     }
 
-    /**
-     * @typedef {Object} Config The configuration data for an application.
-     * @property {String} [config_id] Unique ID for the config.
-     * @property {Object.<string, string | number | boolean>} application_data_slots A map of application data slots and their values.
-     * @property {Workflow[]} workflows Whether the workflow is enabled.
-     */
-
-    /**
-     * @typedef {Object} Workflow The workflow.
-     * @property {String} id The ID of the workflow.
-     * @property {Boolean} enabled Whether the workflow is enabled.
-     * @property {Object.<string, string | number | boolean>} data_slots A map of workflow's data slots and their values.
-     */
-
     /**
      * Returns the specified config.
      * @param {String} slug The application slug.

package/docs.md

@@ -2,8 +2,7 @@
 
 <dl>
 <dt><a href="#Cobalt">Cobalt</a></dt>
-<dd><p>Cobalt Frontend SDK</p>
-</dd>
+<dd></dd>
 </dl>
 
 ## Typedefs
@@ -12,14 +11,8 @@
 <dt><a href="#Application">Application</a> : <code>Object</code></dt>
 <dd><p>An application in Cobalt.</p>
 </dd>
-<dt><a href="#Label">Label</a> : <code>Object</code></dt>
-<dd><p>Field Mapping Label</p>
-</dd>
-<dt><a href="#DynamicField">DynamicField</a> : <code>Object</code></dt>
-<dd><p>Field Mapping Label</p>
-</dd>
-<dt><a href="#DynamicFields">DynamicFields</a> : <code>Object</code></dt>
-<dd><p>The dynamic fields payload.</p>
+<dt><a href="#InputField">InputField</a> : <code>Object</code></dt>
+<dd><p>An Input field to take input from the user.</p>
 </dd>
 <dt><a href="#Config">Config</a> : <code>Object</code></dt>
 <dd><p>The configuration data for an application.</p>
@@ -27,18 +20,25 @@
 <dt><a href="#Workflow">Workflow</a> : <code>Object</code></dt>
 <dd><p>The workflow.</p>
 </dd>
+<dt><a href="#DynamicFields">DynamicFields</a> : <code>Object</code></dt>
+<dd><p>The dynamic fields payload.</p>
+</dd>
+<dt><a href="#DynamicField">DynamicField</a> : <code>Object</code></dt>
+<dd><p>Field Mapping Label</p>
+</dd>
+<dt><a href="#Label">Label</a> : <code>Object</code></dt>
+<dd><p>Field Mapping Label</p>
+</dd>
 </dl>
 
 <a name="Cobalt"></a>
 
 ## Cobalt
-Cobalt Frontend SDK
-
 **Kind**: global class  
 
 * [Cobalt](#Cobalt)
     * [new Cobalt(options)](#new_Cobalt_new)
-    * [.getApp(slug)](#Cobalt+getApp) ⇒ [<code>Promise.&lt;Application&gt;</code>](#Application)
+    * [.getApp([slug])](#Cobalt+getApp) ⇒ [<code>Promise.&lt;Application&gt;</code>](#Application)
     * [.connect(slug, [payload])](#Cobalt+connect) ⇒ <code>Promise.&lt;Boolean&gt;</code>
     * [.disconnect(slug)](#Cobalt+disconnect) ⇒ <code>Promise.&lt;void&gt;</code>
     * [.config(slug, configId, [fields])](#Cobalt+config) ⇒ [<code>Promise.&lt;Config&gt;</code>](#Config)
@@ -60,16 +60,17 @@ Cobalt Frontend SDK
 
 <a name="Cobalt+getApp"></a>
 
-### cobalt.getApp(slug) ⇒ [<code>Promise.&lt;Application&gt;</code>](#Application)
+### cobalt.getApp([slug]) ⇒ [<code>Promise.&lt;Application&gt;</code>](#Application)
 Returns the application details for the specified application, provided
-the application is enabled in Cobalt.
+the application is enabled in Cobalt. If no application is specified,
+it returns all the enabled applications.
 
 **Kind**: instance method of [<code>Cobalt</code>](#Cobalt)  
 **Returns**: [<code>Promise.&lt;Application&gt;</code>](#Application) - The application details.  
 
 | Param | Type | Description |
 | --- | --- | --- |
-| slug | <code>String</code> | The application slug. |
+| [slug] | <code>String</code> | The application slug. |
 
 <a name="Cobalt+connect"></a>
 
@@ -165,31 +166,51 @@ An application in Cobalt.
 | [slug] | <code>String</code> | The application slug for custom apps. |
 | auth_type | <code>&quot;oauth2&quot;</code> \| <code>&quot;keybased&quot;</code> | The type of auth used by application. |
 | [connected] | <code>Boolean</code> | Whether the user has connected the application. |
+| [auth_input_map] | [<code>Array.&lt;InputField&gt;</code>](#InputField) | The fields required from the user to connect the application (for `keybased` auth type). |
 
-<a name="Label"></a>
+<a name="InputField"></a>
 
-## Label : <code>Object</code>
-Field Mapping Label
+## InputField : <code>Object</code>
+An Input field to take input from the user.
 
 **Kind**: global typedef  
 **Properties**
 
 | Name | Type | Description |
 | --- | --- | --- |
-| name | <code>string</code> | The Label name. |
-| value | <code>string</code> \| <code>number</code> \| <code>boolean</code> | The Label value. |
+| name | <code>String</code> | Key name of the field. |
+| type | <code>String</code> | Input type of the field. |
+| required | <code>String</code> | Whether the field is required. |
+| placeholder | <code>String</code> | The placeholder of the field. |
+| label | <code>String</code> | The label of the field. |
 
-<a name="DynamicField"></a>
+<a name="Config"></a>
 
-## DynamicField : <code>Object</code>
-Field Mapping Label
+## Config : <code>Object</code>
+The configuration data for an application.
 
 **Kind**: global typedef  
 **Properties**
 
 | Name | Type | Description |
 | --- | --- | --- |
-| fields | [<code>Array.&lt;Label&gt;</code>](#Label) | The Label name. |
+| [config_id] | <code>String</code> | Unique ID for the config. |
+| application_data_slots | <code>Object.&lt;string, (string\|number\|boolean)&gt;</code> | A map of application data slots and their values. |
+| workflows | [<code>Array.&lt;Workflow&gt;</code>](#Workflow) | Whether the workflow is enabled. |
+
+<a name="Workflow"></a>
+
+## Workflow : <code>Object</code>
+The workflow.
+
+**Kind**: global typedef  
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| id | <code>String</code> | The ID of the workflow. |
+| enabled | <code>Boolean</code> | Whether the workflow is enabled. |
+| data_slots | <code>Object.&lt;string, (string\|number\|boolean)&gt;</code> | A map of workflow's data slots and their values. |
 
 <a name="DynamicFields"></a>
 
@@ -203,31 +224,28 @@ The dynamic fields payload.
 | --- | --- | --- |
 | map_fields_object | <code>Object.&lt;string, DynamicField&gt;</code> | desc. |
 
-<a name="Config"></a>
+<a name="DynamicField"></a>
 
-## Config : <code>Object</code>
-The configuration data for an application.
+## DynamicField : <code>Object</code>
+Field Mapping Label
 
 **Kind**: global typedef  
 **Properties**
 
 | Name | Type | Description |
 | --- | --- | --- |
-| [config_id] | <code>String</code> | Unique ID for the config. |
-| application_data_slots | <code>Object.&lt;string, (string\|number\|boolean)&gt;</code> | A map of application data slots and their values. |
-| workflows | [<code>Array.&lt;Workflow&gt;</code>](#Workflow) | Whether the workflow is enabled. |
+| fields | [<code>Array.&lt;Label&gt;</code>](#Label) | The Label name. |
 
-<a name="Workflow"></a>
+<a name="Label"></a>
 
-## Workflow : <code>Object</code>
-The workflow.
+## Label : <code>Object</code>
+Field Mapping Label
 
 **Kind**: global typedef  
 **Properties**
 
 | Name | Type | Description |
 | --- | --- | --- |
-| id | <code>String</code> | The ID of the workflow. |
-| enabled | <code>Boolean</code> | Whether the workflow is enabled. |
-| data_slots | <code>Object.&lt;string, (string\|number\|boolean)&gt;</code> | A map of workflow's data slots and their values. |
+| name | <code>string</code> | The Label name. |
+| value | <code>string</code> \| <code>number</code> \| <code>boolean</code> | The Label value. |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobaltio/cobalt-js",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "Cobalt frontend SDK",
   "main": "./cobalt.js",
   "scripts": {