@gofynd/fdk-client-javascript 1.1.6 → 1.3.0

package/sdk/application/Common/CommonApplicationModel.js

@@ -1,51 +1,206 @@
 const Joi = require("joi");
 
-class CommonModel {
+/**
+ * @typedef Application
+ * @property {number} [__v] - Version key for tracking revisions. Default value is zero.
+ * @property {string} [_id] - The unique identifier (24-digit Mongo Object ID)
+ *   of the sales channel
+ * @property {string} [app_type] - It shows whether application is live or in
+ *   development mode
+ * @property {ApplicationAuth} [auth]
+ * @property {SecureUrl} [banner]
+ * @property {number} [cache_ttl] - An integer value that specifies the number
+ *   of seconds until the key expires
+ * @property {string} [channel_type] - It indicates different channel types like
+ *   store, website-and-mobile-apps. Default value is store.
+ * @property {number} [company_id] - Numeric ID allotted to a business account
+ *   where the sales channel exists
+ * @property {ApplicationCors} [cors]
+ * @property {string} [created_at] - ISO 8601 timestamp of sales channel creation
+ * @property {string} [description] - It contains detailed information about the
+ *   sales channel
+ * @property {Domain} [domain]
+ * @property {Domain[]} [domains]
+ * @property {SecureUrl} [favicon]
+ * @property {boolean} [is_active] - Indicates whether a sales channel is active
+ *   or not active
+ * @property {boolean} [is_internal] - Indicates whether a sales channel is
+ *   internal or not
+ * @property {SecureUrl} [logo]
+ * @property {ApplicationMeta[]} [meta]
+ * @property {SecureUrl} [mobile_logo]
+ * @property {string} [name] - Name of the sales channel, e.g. Zenz Fashion
+ * @property {string} [owner] - The unique identifier (24-digit Mongo Object ID)
+ *   of owner who owns the application
+ * @property {ApplicationRedirections[]} [redirections]
+ * @property {string} [token] - Randomly generated fixed-length string for sales
+ *   channel. It is required and auto-generated.
+ * @property {string} [updated_at] - ISO 8601 timestamp of sales channel updation
+ * @property {ApplicationWebsite} [website]
+ */
+
+/**
+ * @typedef ApplicationAuth
+ * @property {boolean} [enabled] - Shows sales channel auth is enabled or not enabled.
+ */
+
+/**
+ * @typedef ApplicationCors
+ * @property {string[]} [domains]
+ */
+
+/**
+ * @typedef ApplicationMeta
+ * @property {string} [name] - Indicates the name of application meta
+ * @property {string} [value] - Value related to application meta name
+ */
+
+/**
+ * @typedef ApplicationRedirections
+ * @property {string} [redirect_from] - Old domain URL of the sales channel
+ * @property {string} [redirect_to] - New domain URL of the sales channel. Users
+ *   will be automatically redirected from old domain to new domain.
+ * @property {string} [type] - It shows domain redirection type. Permanent
+ *   redirection is for long time period redirection, and temporary redirection
+ *   for a short time period.
+ */
+
+/**
+ * @typedef ApplicationResponse
+ * @property {Application} [application]
+ */
+
+/**
+ * @typedef ApplicationWebsite
+ * @property {string} [basepath] - Base path for the current sales channel website
+ * @property {boolean} [enabled] - Shows whether sales channel website URL is
+ *   enabled or not
+ */
+
+/**
+ * @typedef BadRequest
+ * @property {string} [message] - Failure message (in a string format)
+ */
+
+/**
+ * @typedef Domain
+ * @property {string} [_id] - The unique identifier (24-digit Mongo Object ID)
+ *   of the domain
+ * @property {boolean} [is_predefined] - Domain is hosting domain or not
+ * @property {boolean} [is_primary] - Indicates domain is primary or not.
+ *   Primary domain is the default/main domain.
+ * @property {boolean} [is_shortlink] - Shortlink is present or not for the domain
+ * @property {string} [name]
+ * @property {boolean} [verified] - Indicates domain is verified or not. TXT and
+ *   A records should propagate correctly.
+ */
+
+/**
+ * @typedef LocationCountry
+ * @property {number} [__v]
+ * @property {string} [_id]
+ * @property {string} [capital]
+ * @property {string} [country_code]
+ * @property {string} [currency]
+ * @property {LocationDefaultCurrency} [default_currency]
+ * @property {LocationDefaultLanguage} [default_language]
+ * @property {string} [iso2]
+ * @property {string} [iso3]
+ * @property {string} [latitude]
+ * @property {string} [longitude]
+ * @property {string} [name]
+ * @property {string} [parent]
+ * @property {string} [phone_code]
+ * @property {string} [state_code]
+ * @property {string} [type]
+ * @property {number} [uid]
+ */
+
+/**
+ * @typedef LocationDefaultCurrency
+ * @property {string} [code]
+ * @property {string} [name]
+ * @property {string} [symbol]
+ */
+
+/**
+ * @typedef LocationDefaultLanguage
+ * @property {string} [code]
+ * @property {string} [name]
+ */
+
+/**
+ * @typedef Locations
+ * @property {LocationCountry[]} [items]
+ */
+
+/**
+ * @typedef NotFound
+ * @property {string} [message] - Response message for not found
+ */
+
+/**
+ * @typedef SecureUrl
+ * @property {string} [secure_url] - Hosted URL of the image
+ */
+
+class CommonApplicationModel {
+  /** @returns {Application} */
   static Application() {
     return Joi.object({
       __v: Joi.number(),
       _id: Joi.string().allow(""),
       app_type: Joi.string().allow(""),
-      auth: CommonModel.ApplicationAuth(),
-      banner: CommonModel.SecureUrl(),
+      auth: CommonApplicationModel.ApplicationAuth(),
+      banner: CommonApplicationModel.SecureUrl(),
       cache_ttl: Joi.number(),
       channel_type: Joi.string().allow(""),
       company_id: Joi.number(),
-      cors: CommonModel.ApplicationCors(),
+      cors: CommonApplicationModel.ApplicationCors(),
       created_at: Joi.string().allow(""),
       description: Joi.string().allow(""),
-      domain: CommonModel.Domain(),
-      domains: Joi.array().items(CommonModel.Domain()),
-      favicon: CommonModel.SecureUrl(),
+      domain: CommonApplicationModel.Domain(),
+      domains: Joi.array().items(CommonApplicationModel.Domain()),
+      favicon: CommonApplicationModel.SecureUrl(),
       is_active: Joi.boolean(),
       is_internal: Joi.boolean(),
-      logo: CommonModel.SecureUrl(),
-      meta: Joi.array().items(CommonModel.ApplicationMeta()),
-      mobile_logo: CommonModel.SecureUrl(),
+      logo: CommonApplicationModel.SecureUrl(),
+      meta: Joi.array().items(CommonApplicationModel.ApplicationMeta()),
+      mobile_logo: CommonApplicationModel.SecureUrl(),
       name: Joi.string().allow(""),
       owner: Joi.string().allow(""),
-      redirections: Joi.array().items(CommonModel.ApplicationRedirections()),
+      redirections: Joi.array().items(
+        CommonApplicationModel.ApplicationRedirections()
+      ),
       token: Joi.string().allow(""),
       updated_at: Joi.string().allow(""),
-      website: CommonModel.ApplicationWebsite(),
+      website: CommonApplicationModel.ApplicationWebsite(),
     });
   }
+
+  /** @returns {ApplicationAuth} */
   static ApplicationAuth() {
     return Joi.object({
       enabled: Joi.boolean(),
     });
   }
+
+  /** @returns {ApplicationCors} */
   static ApplicationCors() {
     return Joi.object({
       domains: Joi.array().items(Joi.string().allow("")),
     });
   }
+
+  /** @returns {ApplicationMeta} */
   static ApplicationMeta() {
     return Joi.object({
       name: Joi.string().allow(""),
       value: Joi.string().allow(""),
     });
   }
+
+  /** @returns {ApplicationRedirections} */
   static ApplicationRedirections() {
     return Joi.object({
       redirect_from: Joi.string().allow(""),
@@ -53,34 +208,30 @@ class CommonModel {
       type: Joi.string().allow(""),
     });
   }
+
+  /** @returns {ApplicationResponse} */
   static ApplicationResponse() {
     return Joi.object({
-      application: CommonModel.Application(),
+      application: CommonApplicationModel.Application(),
     });
   }
+
+  /** @returns {ApplicationWebsite} */
   static ApplicationWebsite() {
     return Joi.object({
       basepath: Joi.string().allow(""),
       enabled: Joi.boolean(),
     });
   }
+
+  /** @returns {BadRequest} */
   static BadRequest() {
     return Joi.object({
       message: Joi.string().allow(""),
     });
   }
-  static Currency() {
-    return Joi.object({
-      _id: Joi.string().allow(""),
-      code: Joi.string().allow(""),
-      created_at: Joi.string().allow(""),
-      decimal_digits: Joi.number(),
-      is_active: Joi.boolean(),
-      name: Joi.string().allow(""),
-      symbol: Joi.string().allow(""),
-      updated_at: Joi.string().allow(""),
-    });
-  }
+
+  /** @returns {Domain} */
   static Domain() {
     return Joi.object({
       _id: Joi.string().allow(""),
@@ -91,6 +242,8 @@ class CommonModel {
       verified: Joi.boolean(),
     });
   }
+
+  /** @returns {LocationCountry} */
   static LocationCountry() {
     return Joi.object({
       __v: Joi.number(),
@@ -98,8 +251,8 @@ class CommonModel {
       capital: Joi.string().allow(""),
       country_code: Joi.string().allow(""),
       currency: Joi.string().allow(""),
-      default_currency: CommonModel.LocationDefaultCurrency(),
-      default_language: CommonModel.LocationDefaultLanguage(),
+      default_currency: CommonApplicationModel.LocationDefaultCurrency(),
+      default_language: CommonApplicationModel.LocationDefaultLanguage(),
       iso2: Joi.string().allow(""),
       iso3: Joi.string().allow(""),
       latitude: Joi.string().allow(""),
@@ -112,6 +265,8 @@ class CommonModel {
       uid: Joi.number(),
     });
   }
+
+  /** @returns {LocationDefaultCurrency} */
   static LocationDefaultCurrency() {
     return Joi.object({
       code: Joi.string().allow(""),
@@ -119,37 +274,34 @@ class CommonModel {
       symbol: Joi.string().allow(""),
     });
   }
+
+  /** @returns {LocationDefaultLanguage} */
   static LocationDefaultLanguage() {
     return Joi.object({
       code: Joi.string().allow(""),
       name: Joi.string().allow(""),
     });
   }
+
+  /** @returns {Locations} */
   static Locations() {
     return Joi.object({
-      items: Joi.array().items(Joi.any()),
+      items: Joi.array().items(CommonApplicationModel.LocationCountry()),
     });
   }
+
+  /** @returns {NotFound} */
   static NotFound() {
     return Joi.object({
       message: Joi.string().allow(""),
     });
   }
-  static Page() {
-    return Joi.object({
-      current: Joi.number(),
-      has_next: Joi.boolean(),
-      has_previous: Joi.boolean(),
-      item_total: Joi.number(),
-      next_id: Joi.string().allow(""),
-      size: Joi.number(),
-      type: Joi.string().allow("").required(),
-    });
-  }
+
+  /** @returns {SecureUrl} */
   static SecureUrl() {
     return Joi.object({
       secure_url: Joi.string().allow(""),
     });
   }
 }
-module.exports = CommonModel;
+module.exports = CommonApplicationModel;

package/sdk/application/Common/CommonApplicationValidator.d.ts

@@ -1,5 +1,43 @@
-export = CommonValidator;
-declare class CommonValidator {
-    static getLocations(): any;
-    static searchApplication(): any;
+export = CommonApplicationValidator;
+/**
+ * @typedef GetLocationsParam
+ * @property {string} [locationType] - Provide location type to query on.
+ *   Possible values : country, state, city
+ * @property {string} [id] - Field is optional when location_type is country. If
+ *   querying for state, provide id of country. If querying for city, provide id
+ *   of state.
+ */
+/**
+ * @typedef SearchApplicationParam
+ * @property {string} [authorization]
+ * @property {string} [query] - Provide application name
+ */
+declare class CommonApplicationValidator {
+    /** @returns {GetLocationsParam} */
+    static getLocations(): GetLocationsParam;
+    /** @returns {SearchApplicationParam} */
+    static searchApplication(): SearchApplicationParam;
 }
+declare namespace CommonApplicationValidator {
+    export { GetLocationsParam, SearchApplicationParam };
+}
+type GetLocationsParam = {
+    /**
+     * - Provide location type to query on.
+     * Possible values : country, state, city
+     */
+    locationType?: string;
+    /**
+     * - Field is optional when location_type is country. If
+     * querying for state, provide id of country. If querying for city, provide id
+     * of state.
+     */
+    id?: string;
+};
+type SearchApplicationParam = {
+    authorization?: string;
+    /**
+     * - Provide application name
+     */
+    query?: string;
+};

package/sdk/application/Common/CommonApplicationValidator.js

@@ -1,7 +1,24 @@
 const Joi = require("joi");
 
-const CommonModel = require("./CommonApplicationModel");
-class CommonValidator {
+const CommonApplicationModel = require("./CommonApplicationModel");
+
+/**
+ * @typedef GetLocationsParam
+ * @property {string} [locationType] - Provide location type to query on.
+ *   Possible values : country, state, city
+ * @property {string} [id] - Field is optional when location_type is country. If
+ *   querying for state, provide id of country. If querying for city, provide id
+ *   of state.
+ */
+
+/**
+ * @typedef SearchApplicationParam
+ * @property {string} [authorization]
+ * @property {string} [query] - Provide application name
+ */
+
+class CommonApplicationValidator {
+  /** @returns {GetLocationsParam} */
   static getLocations() {
     return Joi.object({
       locationType: Joi.string().allow(""),
@@ -9,6 +26,7 @@ class CommonValidator {
     });
   }
 
+  /** @returns {SearchApplicationParam} */
   static searchApplication() {
     return Joi.object({
       authorization: Joi.string().allow(""),
@@ -17,4 +35,4 @@ class CommonValidator {
   }
 }
 
-module.exports = CommonValidator;
+module.exports = CommonApplicationValidator;

package/sdk/application/Communication/CommunicationApplicationClient.d.ts

@@ -10,30 +10,43 @@ declare class Communication {
     _urls: {};
     updateUrls(urls: any): void;
     /**
-     * @param {Object} arg - Arg object.
-     * @returns {Promise<CommunicationConsent>} - Success response
+     * @param {CommunicationApplicationValidator.GetCommunicationConsentParam} arg
+     *   - Arg object.
+     *
+     * @param {object} [arg.requestHeaders={}] - Request headers. Default is `{}`
+     * @param {import("../ApplicationAPIClient").Options} - Options
+     * @returns {Promise<CommunicationApplicationModel.CommunicationConsent>} -
+     *   Success response
+     * @name getCommunicationConsent
      * @summary: Get communication consent
-     * @description: Use this API to retrieve the consent provided by the user for receiving communication messages over Email/SMS/WhatsApp.
+     * @description: Use this API to retrieve the consent provided by the user for receiving communication messages over Email/SMS/WhatsApp. - Check out [method documentation](https://partners.fynd.com/help/docs/sdk/application/communication/getCommunicationConsent/).
      */
-    getCommunicationConsent({}?: any): Promise<CommunicationConsent>;
+    getCommunicationConsent({ requestHeaders }?: any, { responseHeaders }?: object): Promise<CommunicationApplicationModel.CommunicationConsent>;
     /**
-     * @param {Object} arg - Arg object.
-     * @param {PushtokenReq} arg.body
-     * @returns {Promise<PushtokenRes>} - Success response
+     * @param {CommunicationApplicationValidator.UpsertAppPushtokenParam} arg -
+     *   Arg object.
+     * @param {object} [arg.requestHeaders={}] - Request headers. Default is `{}`
+     * @param {import("../ApplicationAPIClient").Options} - Options
+     * @returns {Promise<CommunicationApplicationModel.PushtokenRes>} - Success response
+     * @name upsertAppPushtoken
      * @summary: Upsert push token of a user
-     * @description: Use this API to update and insert the push token of the user.
+     * @description: Use this API to update and insert the push token of the user. - Check out [method documentation](https://partners.fynd.com/help/docs/sdk/application/communication/upsertAppPushtoken/).
      */
-    upsertAppPushtoken({ body }?: {
-        body: PushtokenReq;
-    }): Promise<PushtokenRes>;
+    upsertAppPushtoken({ body, requestHeaders }?: CommunicationApplicationValidator.UpsertAppPushtokenParam, { responseHeaders }?: object): Promise<CommunicationApplicationModel.PushtokenRes>;
     /**
-     * @param {Object} arg - Arg object.
-     * @param {CommunicationConsentReq} arg.body
-     * @returns {Promise<CommunicationConsentRes>} - Success response
+     * @param {CommunicationApplicationValidator.UpsertCommunicationConsentParam} arg
+     *   - Arg object.
+     *
+     * @param {object} [arg.requestHeaders={}] - Request headers. Default is `{}`
+     * @param {import("../ApplicationAPIClient").Options} - Options
+     * @returns {Promise<CommunicationApplicationModel.CommunicationConsentRes>}
+     *   - Success response
+     *
+     * @name upsertCommunicationConsent
      * @summary: Upsert communication consent
-     * @description: Use this API to update and insert the consent provided by the user for receiving communication messages over Email/SMS/WhatsApp.
+     * @description: Use this API to update and insert the consent provided by the user for receiving communication messages over Email/SMS/WhatsApp. - Check out [method documentation](https://partners.fynd.com/help/docs/sdk/application/communication/upsertCommunicationConsent/).
      */
-    upsertCommunicationConsent({ body }?: {
-        body: CommunicationConsentReq;
-    }): Promise<CommunicationConsentRes>;
+    upsertCommunicationConsent({ body, requestHeaders }?: CommunicationApplicationValidator.UpsertCommunicationConsentParam, { responseHeaders }?: object): Promise<CommunicationApplicationModel.CommunicationConsentRes>;
 }
+import CommunicationApplicationModel = require("./CommunicationApplicationModel");
+import CommunicationApplicationValidator = require("./CommunicationApplicationValidator");