oneentry 1.0.137 → 1.0.138

package/dist/base/asyncModules.js

@@ -411,56 +411,10 @@ class AsyncModules extends syncModules_1.default {
                 // Store the response status and parse the response body as JSON
                 const status = response.status;
                 const res = await response.json();
-                // Handle different HTTP status codes with corresponding error functions
-                // Using strict equality (===) for type safety
-                if (status === 400) {
-                    if (this.state.errorsFunctions && this.state.errorsFunctions['400']) {
-                        this.state.errorsFunctions['400'](res);
-                    }
-                }
-                else if (status === 401) {
-                    if (this.state.errorsFunctions && this.state.errorsFunctions['401']) {
-                        this.state.errorsFunctions['401'](res);
-                    }
-                }
-                else if (status === 403) {
-                    if (this.state.errorsFunctions && this.state.errorsFunctions['403']) {
-                        this.state.errorsFunctions['403'](res);
-                    }
-                }
-                else if (status === 404) {
-                    if (this.state.errorsFunctions && this.state.errorsFunctions['404']) {
-                        this.state.errorsFunctions['404'](res);
-                    }
-                }
-                else if (status === 429) {
-                    // Handle rate limiting
-                    if (this.state.errorsFunctions && this.state.errorsFunctions['429']) {
-                        this.state.errorsFunctions['429'](res);
-                    }
-                }
-                else if (status === 500) {
-                    if (this.state.errorsFunctions && this.state.errorsFunctions['500']) {
-                        this.state.errorsFunctions['500'](res);
-                    }
-                }
-                else if (status === 502) {
-                    // Handle bad gateway
-                    if (this.state.errorsFunctions && this.state.errorsFunctions['502']) {
-                        this.state.errorsFunctions['502'](res);
-                    }
-                }
-                else if (status === 503) {
-                    // Handle service unavailable
-                    if (this.state.errorsFunctions && this.state.errorsFunctions['503']) {
-                        this.state.errorsFunctions['503'](res);
-                    }
-                }
-                else if (status === 504) {
-                    // Handle gateway timeout
-                    if (this.state.errorsFunctions && this.state.errorsFunctions['504']) {
-                        this.state.errorsFunctions['504'](res);
-                    }
+                const statusKey = status;
+                if (this.state.errorsFunctions &&
+                    this.state.errorsFunctions[statusKey]) {
+                    this.state.errorsFunctions[statusKey](res);
                 }
                 // Determine whether to return or throw the response based on 'isShell' state
                 if (this.state.isShell) {

package/dist/base/stateModule.d.ts

@@ -18,6 +18,7 @@ export default class StateModule {
     validationEnabled: boolean;
     validationStrictMode: boolean;
     validationLogErrors: boolean;
+    rawData: boolean;
     errorsFunctions: {
         400?: (data: IError) => any | null;
         401?: (data: IError) => any | null;

package/dist/base/stateModule.js

@@ -45,7 +45,7 @@ class StateModule {
      * @description Constructor for StateModule.
      */
     constructor(url, config) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1;
         this.url = url;
         this.lang = (_a = config.langCode) !== null && _a !== void 0 ? _a : 'en_US';
         this.token = config.token;
@@ -53,9 +53,10 @@ class StateModule {
         this.validationEnabled = (_c = (_b = config.validation) === null || _b === void 0 ? void 0 : _b.enabled) !== null && _c !== void 0 ? _c : false;
         this.validationStrictMode = (_e = (_d = config.validation) === null || _d === void 0 ? void 0 : _d.strictMode) !== null && _e !== void 0 ? _e : false;
         this.validationLogErrors = (_g = (_f = config.validation) === null || _f === void 0 ? void 0 : _f.logErrors) !== null && _g !== void 0 ? _g : true;
-        this.refreshToken = (_j = (_h = config.auth) === null || _h === void 0 ? void 0 : _h.refreshToken) !== null && _j !== void 0 ? _j : undefined;
-        this.providerMarker = (_l = (_k = config.auth) === null || _k === void 0 ? void 0 : _k.providerMarker) !== null && _l !== void 0 ? _l : 'email';
-        this.customAuth = (_o = (_m = config.auth) === null || _m === void 0 ? void 0 : _m.customAuth) !== null && _o !== void 0 ? _o : false;
+        this.rawData = (_h = config.rawData) !== null && _h !== void 0 ? _h : false;
+        this.refreshToken = (_k = (_j = config.auth) === null || _j === void 0 ? void 0 : _j.refreshToken) !== null && _k !== void 0 ? _k : undefined;
+        this.providerMarker = (_m = (_l = config.auth) === null || _l === void 0 ? void 0 : _l.providerMarker) !== null && _m !== void 0 ? _m : 'email';
+        this.customAuth = (_p = (_o = config.auth) === null || _o === void 0 ? void 0 : _o.customAuth) !== null && _p !== void 0 ? _p : false;
         this.errorsFunctions = {
             '400': undefined,
             '401': undefined,
@@ -67,28 +68,28 @@ class StateModule {
             '503': undefined,
             '504': undefined,
         };
-        this.saveFunction = (_q = (_p = config.auth) === null || _p === void 0 ? void 0 : _p.saveFunction) !== null && _q !== void 0 ? _q : null;
+        this.saveFunction = (_r = (_q = config.auth) === null || _q === void 0 ? void 0 : _q.saveFunction) !== null && _r !== void 0 ? _r : null;
         if (config.errors) {
-            this.isShell = (_r = config.errors.isShell) !== null && _r !== void 0 ? _r : true;
+            this.isShell = (_s = config.errors.isShell) !== null && _s !== void 0 ? _s : true;
             if (config.errors.customErrors) {
                 this.errorsFunctions['400'] =
-                    (_s = config.errors.customErrors['400']) !== null && _s !== void 0 ? _s : undefined;
+                    (_t = config.errors.customErrors['400']) !== null && _t !== void 0 ? _t : undefined;
                 this.errorsFunctions['401'] =
-                    (_t = config.errors.customErrors['401']) !== null && _t !== void 0 ? _t : undefined;
+                    (_u = config.errors.customErrors['401']) !== null && _u !== void 0 ? _u : undefined;
                 this.errorsFunctions['403'] =
-                    (_u = config.errors.customErrors['403']) !== null && _u !== void 0 ? _u : undefined;
+                    (_v = config.errors.customErrors['403']) !== null && _v !== void 0 ? _v : undefined;
                 this.errorsFunctions['404'] =
-                    (_v = config.errors.customErrors['404']) !== null && _v !== void 0 ? _v : undefined;
+                    (_w = config.errors.customErrors['404']) !== null && _w !== void 0 ? _w : undefined;
                 this.errorsFunctions['429'] =
-                    (_w = config.errors.customErrors['429']) !== null && _w !== void 0 ? _w : undefined;
+                    (_x = config.errors.customErrors['429']) !== null && _x !== void 0 ? _x : undefined;
                 this.errorsFunctions['500'] =
-                    (_x = config.errors.customErrors['500']) !== null && _x !== void 0 ? _x : undefined;
+                    (_y = config.errors.customErrors['500']) !== null && _y !== void 0 ? _y : undefined;
                 this.errorsFunctions['502'] =
-                    (_y = config.errors.customErrors['502']) !== null && _y !== void 0 ? _y : undefined;
+                    (_z = config.errors.customErrors['502']) !== null && _z !== void 0 ? _z : undefined;
                 this.errorsFunctions['503'] =
-                    (_z = config.errors.customErrors['503']) !== null && _z !== void 0 ? _z : undefined;
+                    (_0 = config.errors.customErrors['503']) !== null && _0 !== void 0 ? _0 : undefined;
                 this.errorsFunctions['504'] =
-                    (_0 = config.errors.customErrors['504']) !== null && _0 !== void 0 ? _0 : undefined;
+                    (_1 = config.errors.customErrors['504']) !== null && _1 !== void 0 ? _1 : undefined;
             }
         }
         else {

package/dist/base/syncModules.d.ts

@@ -109,6 +109,12 @@ export default abstract class SyncModules {
      * @returns {any} Intervals with added time intervals.
      */
     _addTimeIntervalsToFormSchedules(intervals: any[]): any;
+    /**
+     * Transforms additionalFields from array to object keyed by marker.
+     * Skipped when rawData is enabled in config.
+     * @param {any} attr - The attribute object that may contain additionalFields.
+     */
+    private _normalizeAdditionalFields;
     /**
      * Normalizes attributes within the data.
      * @param {any} data - The data to normalize.

package/dist/base/syncModules.js

@@ -1,5 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+// Using WeakMap to store unique instance IDs for each object instance
+const instanceIds = new WeakMap();
+// Counter to ensure even more uniqueness
+let instanceCounter = 0;
 /**
  * Abstract class representing synchronization modules.
  */
@@ -17,6 +21,15 @@ class SyncModules {
         this._sortAttributes = (data) => Object.fromEntries(Object.entries(data).sort(([, a], [, b]) => a.position - b.position));
         this.state = state;
         this._url = state.url;
+        // Generate and store a unique instance ID using WeakMap
+        if (!instanceIds.has(this)) {
+            const timestampPart = Date.now().toString(36);
+            const randomPart = Math.random().toString(36).substring(2, 15) +
+                Math.random().toString(36).substring(2, 15);
+            const counterPart = (++instanceCounter).toString(36);
+            const instanceId = `${timestampPart}${randomPart}${counterPart}`;
+            instanceIds.set(this, instanceId);
+        }
     }
     /**
      * Constructs the full URL path by appending the given path to the base URL.
@@ -319,6 +332,16 @@ class SyncModules {
         });
         return intervals;
     }
+    /**
+     * Transforms additionalFields from array to object keyed by marker.
+     * Skipped when rawData is enabled in config.
+     * @param {any} attr - The attribute object that may contain additionalFields.
+     */
+    _normalizeAdditionalFields(attr) {
+        if (!this.state.rawData && Array.isArray(attr.additionalFields)) {
+            attr.additionalFields = Object.fromEntries(attr.additionalFields.map((field) => [field.marker, field]));
+        }
+    }
     /**
      * Normalizes attributes within the data.
      * @param {any} data - The data to normalize.
@@ -330,6 +353,7 @@ class SyncModules {
         if ('attributeValues' in data) {
             for (const attr in data.attributeValues) {
                 const d = data.attributeValues[attr];
+                this._normalizeAdditionalFields(d);
                 // normalize numbers
                 if (d.type === 'integer' || d.type === 'float') {
                     const numValue = Number(d.value);
@@ -354,6 +378,7 @@ class SyncModules {
         if ('attributes' in data) {
             const d = data.attributes;
             for (const attr in d) {
+                this._normalizeAdditionalFields(d[attr]);
                 // Normalize numbers
                 // if (d[attr].type === 'integer' || d[attr].type === 'float') {
                 //   const numValue = Number(d[attr].value);
@@ -373,6 +398,7 @@ class SyncModules {
         }
         //  For single attribute - for attribute sets
         if ('type' in data) {
+            this._normalizeAdditionalFields(data);
             // Normalize numbers
             if (data.type === 'integer' || data.type === 'float') {
                 const numValue = Number(data.value);
@@ -429,12 +455,29 @@ class SyncModules {
         }
         // Access navigator through globalThis.window object to avoid direct reference
         const win = globalThis.window;
-        const nav = (win === null || win === void 0 ? void 0 : win.navigator) || {};
+        // Get the instance ID from the WeakMap
+        const instanceId = instanceIds.get(this) ||
+            Date.now().toString(36) +
+                Math.random().toString(36).substring(2, 15) +
+                Math.random().toString(36).substring(2, 15) +
+                (++instanceCounter).toString(36);
+        // Node.js environment - unique per-instance fingerprint (no shared process ID)
+        if (!win) {
+            return JSON.stringify({
+                fingerprint: `UQ_${instanceId}`,
+                deviceInfo: {
+                    os: 'Node.js',
+                    browser: `Node.js/${instanceId.substring(0, 10)}`,
+                    location: 'en-US',
+                },
+            });
+        }
+        const nav = win.navigator || {};
         const platform = nav.platform || 'Win32';
         const userAgent = nav.userAgent || 'Node.js/22';
         const language = nav.language || 'en-US';
         // Get screen information if available
-        const screen = (win === null || win === void 0 ? void 0 : win.screen) || {};
+        const screen = win.screen || {};
         const screenWidth = screen.width || 0;
         const screenHeight = screen.height || 0;
         const colorDepth = screen.colorDepth || 0;
@@ -451,7 +494,7 @@ class SyncModules {
         let isPrivateBrowsing = false;
         try {
             // Simple localStorage test to detect private browsing
-            if (win === null || win === void 0 ? void 0 : win.localStorage) {
+            if (win.localStorage) {
                 const testKey = 'test_private_browsing';
                 win.localStorage.setItem(testKey, '1');
                 win.localStorage.removeItem(testKey);
@@ -465,7 +508,7 @@ class SyncModules {
             isPrivateBrowsing = true; // Error during localStorage access indicates private browsing
         }
         // Create a stable fingerprint string using stable device/browser characteristics
-        const fingerprintString = `${platform}|${userAgent}|${language}|${screenWidth}|${screenHeight}|${colorDepth}|${timezone}|${isPrivateBrowsing ? 'private' : 'normal'}`;
+        const fingerprintString = `${platform}|${userAgent}|${language}|${screenWidth}|${screenHeight}|${colorDepth}|${timezone}|${isPrivateBrowsing ? 'private' : 'normal'}|${instanceId}`;
         // Simple but stable hash function
         let hash = 0;
         for (let i = 0; i < fingerprintString.length; i++) {
@@ -474,7 +517,7 @@ class SyncModules {
             hash = hash & hash; // Convert to 32-bit integer
         }
         const deviceMetadata = {
-            fingerprint: `UQ_${Math.abs(hash).toString(36)}`,
+            fingerprint: `UQ_${Math.abs(hash).toString(36)}_${instanceId.substring(0, 12)}`,
             deviceInfo: {
                 os: platform.replace(/ /g, '_'),
                 browser: userAgent.replace(/ /g, '_'),

package/dist/base/utils.d.ts

@@ -1,13 +1,19 @@
+/**
+ * @typedef {string} Types - Type of block.
+ */
 type Types = 'product' | 'error_page' | 'catalog_page' | 'product_preview' | 'similar_products_block' | 'product_block' | 'form' | 'common_page' | 'common_block' | 'order' | 'service' | 'none';
 /**
- * @param {string} [token] - If your project is protected by a token, specify this token in this parameter.
- * @param {string} [langCode] - specify the default language to avoid specifying it in every request.
- * @param {boolean} [traficLimit] - Some methods use multiple queries to make it easier to work with the API. Set this parameter to "false" to save traffic and decide for yourself what data you need.
- * @param {boolean} [auth] - An object with authorization settings.
- * @param {boolean} [auth.customAuth] - Set this flag to true if you want to configure the authorization process yourself. Set the flag to false, or do not pass it at all to have automatic authorization and token renewal.
- * @param {boolean} [auth.refreshToken] - Transfer the refresh token here, for example from the local storage, to resume the user's session. Otherwise, the user will need to log in every time a new session is created.
- * @param {boolean} [auth.providerMarker] - The marker of the provider, for example, email, google, facebook, etc. Default 'email';
- * @param {boolean} [auth.saveFunction] - If you want to store the token between sessions, for example in local storage, create a custom function that takes refreshToken as a parameter and executes the necessary instructions. This function will be called every time the tokens are updated.
+ * @property {string} [token] - If your project is protected by a token, specify this token in this parameter.
+ * @property {string} [langCode] - specify the default language to avoid specifying it in every request.
+ * @property {boolean} [traficLimit] - Some methods use multiple queries to make it easier to work with the API. Set this parameter to "false" to save traffic and decide for yourself what data you need.
+ * @property {boolean} [rawData] - Set to true to receive raw API responses without any transformation.
+ * @property {object} [validation] - Validation settings for API responses.
+ * @property {boolean} [auth] - An object with authorization settings.
+ * @property {boolean} [auth.customAuth] - Set this flag to true if you want to configure the authorization process yourself. Set the flag to false, or do not pass it at all to have automatic authorization and token renewal.
+ * @property {boolean} [auth.refreshToken] - Transfer the refresh token here, for example from the local storage, to resume the user's session. Otherwise, the user will need to log in every time a new session is created.
+ * @property {boolean} [auth.providerMarker] - The marker of the provider, for example, email, google, facebook, etc. Default 'email';
+ * @property {boolean} [auth.saveFunction] - If you want to store the token between sessions, for example in local storage, create a custom function that takes refreshToken as a parameter and executes the necessary instructions. This function will be called every time the tokens are updated.
+ * @property {object} [errors] - Error handling settings.
  * @example
  * ```ts
  * const saveToken = (token) => {
@@ -41,6 +47,7 @@ interface IConfig {
     token?: string;
     langCode?: string;
     traficLimit?: boolean;
+    rawData?: boolean;
     validation?: {
         enabled?: boolean;
         strictMode?: boolean;

package/dist/blocks/blocksApi.d.ts

@@ -24,8 +24,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IBlocksResponse} Returns BlocksEntity object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IBlocksResponse | IError>} Returns BlocksEntity object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     getBlocks(type?: BlockType, langCode?: string, offset?: number, limit?: number): Promise<IBlocksResponse | IError>;
     /**
@@ -35,8 +35,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IBlockEntity} - Returns a BlockEntity object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IBlockEntity | IError>} - Returns a BlockEntity object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method retrieves a block by its marker and includes additional information such as similar products or products associated with the block.
      */
     getBlockByMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IBlockEntity | IError>;
@@ -47,8 +47,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IProductsResponse} - Returns the total count and an array of product items in object by specified block marker.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IProductsResponse | IError>} - Returns the total count and an array of product items in object by specified block marker.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     private getSimilarProducts;
     /**
@@ -58,8 +58,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IProductsEntity[]} Return array of BlocksEntity object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IProductsEntity[] | IError>} Return array of BlocksEntity object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     private getProductsByBlockMarker;
     /**
@@ -67,8 +67,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName searchBlock
      * @param {string} name - Search string. Example: "product_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ISearchBlock[]} Returns an array of ISearchBlock objects.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<ISearchBlock[] | IError>} Returns an array of ISearchBlock objects.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     searchBlock(name: string, langCode?: string): Promise<ISearchBlock[] | IError>;
 }

package/dist/blocks/blocksApi.js

@@ -29,8 +29,8 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IBlocksResponse} Returns BlocksEntity object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IBlocksResponse | IError>} Returns BlocksEntity object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async getBlocks(type = '', langCode = this.state.lang, offset = 0, limit = 30) {
         const response = await this._fetchPost(`?langCode=${langCode}&type=${type}&offset=${offset}&limit=${limit}`);
@@ -83,8 +83,8 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IBlockEntity} - Returns a BlockEntity object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IBlockEntity | IError>} - Returns a BlockEntity object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method retrieves a block by its marker and includes additional information such as similar products or products associated with the block.
      */
     async getBlockByMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
@@ -135,8 +135,8 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IProductsResponse} - Returns the total count and an array of product items in object by specified block marker.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IProductsResponse | IError>} - Returns the total count and an array of product items in object by specified block marker.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         const query = {
@@ -154,8 +154,8 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IProductsEntity[]} Return array of BlocksEntity object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IProductsEntity[] | IError>} Return array of BlocksEntity object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async getProductsByBlockMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         const query = {
@@ -171,8 +171,8 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName searchBlock
      * @param {string} name - Search string. Example: "product_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ISearchBlock[]} Returns an array of ISearchBlock objects.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<ISearchBlock[] | IError>} Returns an array of ISearchBlock objects.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async searchBlock(name, langCode = this.state.lang) {
         const result = await this._fetchGet(`/quick/search?langCode=${langCode}&name=${name}`);

package/dist/blocks/blocksInterfaces.d.ts

@@ -111,6 +111,7 @@ interface IBlocksResponse {
  * @property {number} version - Version of the block entity. Example: 1.
  * @property {string} identifier - Unique string identifier for the block. Example: "block1".
  * @property {string} type - Type of the block, such as 'product', 'error_page', etc. Example: "product".
+ * @property {number} position - Position of the block for sorting. Example: 1.
  * @property {string | null} templateIdentifier - Identifier for the template used by the block, or null if not applicable. Example: "template1".
  * @property {boolean} isVisible - Indicates whether the block is visible. Example: true.
  * @property {number} [countElementsPerRow] - Number of elements displayed per row in the block, if applicable. Example: 3.

package/dist/events/eventsApi.d.ts

@@ -27,8 +27,8 @@ export default class EventsApi extends AsyncModules implements IEvents {
      * @handleName getAllSubscriptions
      * @param {number} [offset] - Optional offset for pagination. Default: 0.
      * @param {number} [limit] - Optional limit for pagination. Default: 30.
-     * @returns {ISubscriptions} Returns an object containing all subscriptions or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<ISubscriptions | IError>} Returns an object containing all subscriptions or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
@@ -40,7 +40,7 @@ export default class EventsApi extends AsyncModules implements IEvents {
      * @param {number} productId - Product id. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".=
      * @returns {Promise<boolean | IError>} Returns true if subscription was successful, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
@@ -51,8 +51,8 @@ export default class EventsApi extends AsyncModules implements IEvents {
      * @param {string} marker - The marker of the event to unsubscribe from. Example: "product_price_change".
      * @param {number} productId - The ID of the product to unsubscribe from. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {any} - Returns a promise that resolves to the result of the unsubscription operation or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<any | IError>} - Returns a promise that resolves to the result of the unsubscription operation or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */

package/dist/events/eventsApi.js

@@ -32,8 +32,8 @@ class EventsApi extends asyncModules_1.default {
      * @handleName getAllSubscriptions
      * @param {number} [offset] - Optional offset for pagination. Default: 0.
      * @param {number} [limit] - Optional limit for pagination. Default: 30.
-     * @returns {ISubscriptions} Returns an object containing all subscriptions or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<ISubscriptions | IError>} Returns an object containing all subscriptions or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
@@ -52,7 +52,7 @@ class EventsApi extends asyncModules_1.default {
      * @param {number} productId - Product id. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".=
      * @returns {Promise<boolean | IError>} Returns true if subscription was successful, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
@@ -75,8 +75,8 @@ class EventsApi extends asyncModules_1.default {
      * @param {string} marker - The marker of the event to unsubscribe from. Example: "product_price_change".
      * @param {number} productId - The ID of the product to unsubscribe from. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {any} - Returns a promise that resolves to the result of the unsubscription operation or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<any | IError>} - Returns a promise that resolves to the result of the unsubscription operation or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */

package/dist/events/eventsInterfaces.d.ts

@@ -42,26 +42,36 @@ interface IEvents {
  * Represents a response from the events API containing a total count and an array of subscription items.
  * @interface ISubscriptions
  * @property {number} total - Total number of found records. Example: 100.
- * @property {{ eventMarker: string; productId: number }[]} items - Array of subscription items, each containing an event marker and a product ID.
+ * @property {ISubscriptionItem[]} items - Array of subscription items, each containing an event marker and a product ID.
  * @example
-   [
-     {
-       eventMarker: 'product_price_change',
-       productId: 12345
-     },
-     {
-       eventMarker: 'product_stock_update',
-       productId: 67890
-     }
-   ]
+ [
+   {
+     eventMarker: 'product_price_change',
+     productId: 12345
+   },
+   {
+     eventMarker: 'product_stock_update',
+     productId: 67890
+   }
+ ]
+ * @property { string } items.eventMarker - Event marker.
+ * @property { number } items.productId - Product ID.
  * @description Represents a response from the events API containing a total count and an array of subscription items.
  */
 interface ISubscriptions {
     total: number;
-    items: Array<{
-        eventMarker: string;
-        productId: number;
-    }>;
+    items: Array<ISubscriptionItem>;
+}
+/**
+ * Represents item from the events API.
+ * @interface ISubscriptionItem
+ * @property { string } eventMarker -Event marker.
+ * @property { number } productId - Product ID.
+ * @description Represents item from the events API.
+ */
+interface ISubscriptionItem {
+    eventMarker: string;
+    productId: number;
 }
 /**
  * Interface for the body of the subscribe methods.

package/dist/file-uploading/fileUploadingApi.d.ts

@@ -41,8 +41,8 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
      * @param {number} [fileQuery.height] - Optional height parameter. Example: 0.
      * @param {boolean} [fileQuery.compress] - Optional flag of optimization (compression) for images. Example: true.
      * @param {any} [fileQuery.template] - preview template identifier. Example: 1.
-     * @returns {IUploadingReturn[]} Uploads a file to an Amazon S3-compatible cloud file storage.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IUploadingReturn[] | IError>} Uploads a file to an Amazon S3-compatible cloud file storage.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     upload(file: File | Blob, fileQuery?: IUploadingQuery): Promise<IUploadingReturn[] | IError>;
     /**
@@ -61,8 +61,8 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
      * @param {string} [fileQuery.entity] - Entity name from which the file is uploaded, determines the folder name in the storage. Example: "editor".
      * @param {number} [fileQuery.id] - Identifier of the object from which the file is uploaded, determines the folder name in the storage. Example: 3787.
      * @param {number} [fileQuery.template] - preview template identifier. Example: 1.
-     * @returns {any} Returns a promise that resolves to the result of the deletion operation or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<any | IError>} Returns a promise that resolves to the result of the deletion operation or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     delete(filename: string, fileQuery?: IUploadingQuery): Promise<any | IError>;
     /**
@@ -81,8 +81,8 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
      * @param {string} entity - Entity name, from which the file is uploaded, determines the folder name in the storage. Example: "editor".
      * @param {string} filename - Filename. Example: "file.png".
      * @param {string} [template] - Preview template identifier. Example: 1.
-     * @returns {any} Returns a promise that resolves to a Blob object containing the file data or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<any | IError>} Returns a promise that resolves to a Blob object containing the file data or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     getFile(id: number, type: string, entity: string, filename: string, template?: string): Promise<any | IError>;
 }

package/dist/file-uploading/fileUploadingApi.js

@@ -56,8 +56,8 @@ class FileUploadingApi extends asyncModules_1.default {
      * @param {number} [fileQuery.height] - Optional height parameter. Example: 0.
      * @param {boolean} [fileQuery.compress] - Optional flag of optimization (compression) for images. Example: true.
      * @param {any} [fileQuery.template] - preview template identifier. Example: 1.
-     * @returns {IUploadingReturn[]} Uploads a file to an Amazon S3-compatible cloud file storage.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IUploadingReturn[] | IError>} Uploads a file to an Amazon S3-compatible cloud file storage.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async upload(file, fileQuery) {
         const query = { ...this._defaultQuery, ...fileQuery };
@@ -84,8 +84,8 @@ class FileUploadingApi extends asyncModules_1.default {
      * @param {string} [fileQuery.entity] - Entity name from which the file is uploaded, determines the folder name in the storage. Example: "editor".
      * @param {number} [fileQuery.id] - Identifier of the object from which the file is uploaded, determines the folder name in the storage. Example: 3787.
      * @param {number} [fileQuery.template] - preview template identifier. Example: 1.
-     * @returns {any} Returns a promise that resolves to the result of the deletion operation or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<any | IError>} Returns a promise that resolves to the result of the deletion operation or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async delete(filename, fileQuery) {
         const query = { ...this._defaultQuery, ...fileQuery };
@@ -114,8 +114,8 @@ class FileUploadingApi extends asyncModules_1.default {
      * @param {string} entity - Entity name, from which the file is uploaded, determines the folder name in the storage. Example: "editor".
      * @param {string} filename - Filename. Example: "file.png".
      * @param {string} [template] - Preview template identifier. Example: 1.
-     * @returns {any} Returns a promise that resolves to a Blob object containing the file data or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<any | IError>} Returns a promise that resolves to a Blob object containing the file data or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async getFile(id, type, entity, filename, template) {
         // eslint-disable-next-line no-undef