oneentry 1.0.172 → 1.0.173

package/dist/system/systemApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { ISystemApi } from './systemInterfaces';
+import type { IApiStatEntry, ISystemApi } from './systemInterfaces';
 /**
  * Controllers for working with system components
  * @handle /api/content/system
@@ -37,10 +37,10 @@ export default class SystemApi extends AsyncModules implements ISystemApi {
     /**
      * Getting the number of requests to API.
      * @handleName getApiStat
-     * @returns {Promise<unknown | IError>} Return object with date and count.
+     * @returns {Promise<IApiStatEntry[] | IError>} Array of one-key objects `{ [YYYY-MM-DD]: count }`, one per day. Example: `[{ "2026-10-25": 17280 }, { "2026-10-26": 13671 }]`.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Getting the number of requests to API.
+     * @description Getting the number of requests to API, per day.
      * @see {@link https://js-sdk.oneentry.cloud/docs/system/getApiStat getApiStat} documentation.
      */
-    getApiStat(): Promise<unknown>;
+    getApiStat(): Promise<IApiStatEntry[] | IError>;
 }

package/dist/system/systemApi.js

@@ -46,9 +46,9 @@ class SystemApi extends asyncModules_1.default {
     /**
      * Getting the number of requests to API.
      * @handleName getApiStat
-     * @returns {Promise<unknown | IError>} Return object with date and count.
+     * @returns {Promise<IApiStatEntry[] | IError>} Array of one-key objects `{ [YYYY-MM-DD]: count }`, one per day. Example: `[{ "2026-10-25": 17280 }, { "2026-10-26": 13671 }]`.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Getting the number of requests to API.
+     * @description Getting the number of requests to API, per day.
      * @see {@link https://js-sdk.oneentry.cloud/docs/system/getApiStat getApiStat} documentation.
      */
     async getApiStat() {

package/dist/system/systemInterfaces.d.ts

@@ -19,11 +19,17 @@ interface ISystemApi {
      */
     test500(): Promise<unknown | IError>;
     /**
-     * getApiStat
+     * Getting the number of requests to API.
      * @handleName getApiStat
-     * @returns {unknown} Returns a Promise that resolves with any data.
-     * @description This method getApiStat.
+     * @returns {Promise<IApiStatEntry[] | IError>} Array of one-key objects `{ [YYYY-MM-DD]: count }`, one per day. Example: `[{ "2026-10-25": 17280 }, { "2026-10-26": 13671 }]`.
+     * @description Getting the number of requests to API, per day.
      */
-    getApiStat(): Promise<unknown>;
+    getApiStat(): Promise<IApiStatEntry[] | IError>;
 }
-export type { ISystemApi };
+/**
+ * One day of API request statistics: a single key — the date `YYYY-MM-DD` — holding the number of requests.
+ * @typedef {Record<string, number>} IApiStatEntry
+ * @description Element of the array returned by getApiStat. Example: `{ "2026-10-26": 13671 }`.
+ */
+type IApiStatEntry = Record<string, number>;
+export type { IApiStatEntry, ISystemApi };

package/dist/templates/templatesApi.d.ts

@@ -22,7 +22,7 @@ export default class TemplatesPreviewApi extends AsyncModules implements ITempla
      * Get all template objects grouped by types.
      * @handleName getAllTemplates
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<Record<BlockType, ITemplateEntity[]> | IError>} Returns an object GroupedTemplatesObject, which contains an array of template objects TemplateEntity
+     * @returns {Promise<Record<BlockType, ITemplateEntity[]> | IError>} Object keyed by `BlockType`; each value is an array of `ITemplateEntity` of that type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This function is designed to fetch organized template objects in groups based on their types.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getAllTemplates getAllTemplates} documentation.
@@ -33,7 +33,7 @@ export default class TemplatesPreviewApi extends AsyncModules implements ITempla
      * @handleName getTemplateByType
      * @param {BlockType} type - The type of templates to retrieve. This parameter specifies the category or classification of templates being requested. Example: "product".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<ITemplateEntity[] | IError>} Returns a TemplateEntity object.
+     * @returns {Promise<ITemplateEntity[] | IError>} Array of `ITemplateEntity` objects of the given type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch template objects that belong to a specific type, with an optional filter by language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByType getTemplateByType} documentation.
@@ -44,7 +44,7 @@ export default class TemplatesPreviewApi extends AsyncModules implements ITempla
      * @handleName getTemplateByMarker
      * @param {string} marker - The unique marker of the template to retrieve. Example: "template_12345".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<ITemplateEntity | IError>} Returns a TemplateEntity object
+     * @returns {Promise<ITemplateEntity | IError>} Returns an `ITemplateEntity` object
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch a specific template object based on its unique marker.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByMarker getTemplateByMarker} documentation.

package/dist/templates/templatesApi.js

@@ -60,7 +60,7 @@ class TemplatesPreviewApi extends asyncModules_1.default {
      * Get all template objects grouped by types.
      * @handleName getAllTemplates
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<Record<BlockType, ITemplateEntity[]> | IError>} Returns an object GroupedTemplatesObject, which contains an array of template objects TemplateEntity
+     * @returns {Promise<Record<BlockType, ITemplateEntity[]> | IError>} Object keyed by `BlockType`; each value is an array of `ITemplateEntity` of that type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This function is designed to fetch organized template objects in groups based on their types.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getAllTemplates getAllTemplates} documentation.
@@ -86,7 +86,7 @@ class TemplatesPreviewApi extends asyncModules_1.default {
      * @handleName getTemplateByType
      * @param {BlockType} type - The type of templates to retrieve. This parameter specifies the category or classification of templates being requested. Example: "product".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<ITemplateEntity[] | IError>} Returns a TemplateEntity object.
+     * @returns {Promise<ITemplateEntity[] | IError>} Array of `ITemplateEntity` objects of the given type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch template objects that belong to a specific type, with an optional filter by language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByType getTemplateByType} documentation.
@@ -102,7 +102,7 @@ class TemplatesPreviewApi extends asyncModules_1.default {
      * @handleName getTemplateByMarker
      * @param {string} marker - The unique marker of the template to retrieve. Example: "template_12345".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<ITemplateEntity | IError>} Returns a TemplateEntity object
+     * @returns {Promise<ITemplateEntity | IError>} Returns an `ITemplateEntity` object
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch a specific template object based on its unique marker.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByMarker getTemplateByMarker} documentation.

package/dist/templates/templatesInterfaces.d.ts

@@ -9,7 +9,7 @@ interface ITemplatesApi {
      * Get all template objects grouped by types.
      * @handleName getAllTemplates
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Record<BlockType, ITemplateEntity[]>} Returns an object GroupedTemplatesObject, which contains an array of template objects TemplateEntity
+     * @returns {Record<BlockType, ITemplateEntity[]>} Object keyed by `BlockType`; each value is an array of `ITemplateEntity` of that type.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets all template objects grouped by types.
      */
@@ -19,7 +19,7 @@ interface ITemplatesApi {
      * @handleName getTemplateByType
      * @param {BlockType} type - The type of templates to retrieve. This parameter specifies the category or classification of templates being requested. Example: "product".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ITemplateEntity[]} Returns a TemplateEntity object.
+     * @returns {ITemplateEntity[]} Array of `ITemplateEntity` objects of the given type.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets template objects by type.
      */
@@ -29,7 +29,7 @@ interface ITemplatesApi {
      * @handleName getTemplateByMarker
      * @param {string} marker - The unique marker of the template to retrieve. Example: "template_12345".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ITemplateEntity} Returns a TemplateEntity object
+     * @returns {ITemplateEntity} Returns an `ITemplateEntity` object
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets one template object by id.
      */

package/esm/auth-provider/authProviderApi.d.ts

@@ -233,9 +233,9 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * Getting active user sessions data.
      * @handleName getActiveSessionsByMarker
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @returns {Promise<IActiveSession[] | IError>} Returns an auth provider object.
+     * @returns {Promise<IActiveSession[] | IError>} Array of the authenticated user's active sessions for this provider, one per device (`deviceInfo`).
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Getting a single authorization provider object by marker.
+     * @description Getting the authenticated user's active sessions for the authorization provider. This method requires user authorization.
      * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getActiveSessionsByMarker getActiveSessionsByMarker} documentation.
      */
     getActiveSessionsByMarker(marker: string): Promise<IActiveSession[] | IError>;

package/esm/auth-provider/authProviderApi.js

@@ -328,9 +328,9 @@ export default class AuthProviderApi extends AsyncModules {
      * Getting active user sessions data.
      * @handleName getActiveSessionsByMarker
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @returns {Promise<IActiveSession[] | IError>} Returns an auth provider object.
+     * @returns {Promise<IActiveSession[] | IError>} Array of the authenticated user's active sessions for this provider, one per device (`deviceInfo`).
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Getting a single authorization provider object by marker.
+     * @description Getting the authenticated user's active sessions for the authorization provider. This method requires user authorization.
      * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getActiveSessionsByMarker getActiveSessionsByMarker} documentation.
      */
     async getActiveSessionsByMarker(marker) {

package/esm/auth-provider/authProvidersInterfaces.d.ts

@@ -405,11 +405,11 @@ interface IAuthPostBody {
     {
       "os": "Win32",
       "browser": "Node.js/22",
-      "location": "ru-RU"
+      "location": "en-US"
     }
  * @property {string} deviceInfo.os - The operating system of the active session. Example: "Win32".
  * @property {string} deviceInfo.browser - The browser used in the active session. Example: "Node.js/22".
- * @property {string} deviceInfo.location - The location of the active session. Example: "ru-RU".
+ * @property {string} deviceInfo.location - The location of the active session. Example: "en-US".
  * @description This interface defines the structure of the body used in authentication requests, containing an array of authentication data.
  */
 interface IActiveSession {
@@ -419,7 +419,7 @@ interface IActiveSession {
  * @interface IDeviceInfo
  * @property {string} os - The operating system of the active session. Example: "Win32".
  * @property {string} browser - The browser used in the active session. Example: "Node.js/22".
- * @property {string} location - The locale of the active session. Example: "ru-RU".
+ * @property {string} location - The locale of the active session. Example: "en-US".
  * @description Information about the device tied to an active authentication session.
  */
 interface IDeviceInfo {

package/esm/base/utils.d.ts

@@ -4,7 +4,7 @@
  * @property {string} [guestId] - Guest identifier sent as the `x-guest-id` header on unauthenticated requests. Lets cart/wishlist/activity endpoints work for a guest. In the browser a stable id is auto-generated (localStorage) when omitted; on the server pass a per-visitor id. Can also be set later via `setGuestId`.
  * @property {string} [deviceMetadata] - Device-metadata string sent as the `x-device-metadata` header on POST requests and token refresh, overriding the environment-derived fingerprint. The API binds refresh tokens to this header, so server-side flows that issue tokens on behalf of a browser (e.g. an OAuth code exchange) must pass the browser's string here — otherwise the token is bound to the server's fingerprint and cannot be refreshed from the browser. Obtain the string in the browser via `getDeviceMetadata()`. Can also be set later via `setDeviceMetadata`.
  * @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} [traficLimit] - Some methods use multiple queries to make it easier to work with the API. Set it to `true` to save traffic and decide for yourself what data you need: the SDK then skips its follow-up requests (full pages behind quick search results, products of page blocks), and some results change shape — e.g. `searchPage` returns short `{ id, title }` cards. Default: false.
  * @property {boolean} [rawData] - Set to true to keep an attribute's nested `additionalFields` as the
  * array the API sends, instead of the marker-keyed map the SDK builds by default. It turns off only that
  * transformation — locale unwrapping, sorting by `position`, single-file unwrapping and number casting

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

@@ -23,7 +23,7 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
      * Upload file function.
      * @handleName upload
      * @param {File | Blob} file - File to upload. Example: `new File(["content"], "file.png", {"type": "image/png"})`
-     * @param {IUploadingQuery} [fileQuery] - Optional set query parameters.
+     * @param {IUploadingQuery} fileQuery - Where the file lives in the storage. Required: without `type`, `entity` and `id` the endpoint answers `400 … should not be empty`.
      * @example
         {
           "type": "page",
@@ -34,9 +34,9 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
           "compress": true,
           "template": 1
         }
-     * @param {string} [fileQuery.type] - Type, determines the folder name in the storage. Example: "page".
-     * @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 {string} fileQuery.type - Type, determines the folder name in the storage. Example: "page".
+     * @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.width] - Optional width parameter. Example: 0.
      * @param {number} [fileQuery.height] - Optional height parameter. Example: 0.
      * @param {boolean} [fileQuery.compress] - Optional flag of optimization (compression) for images. Example: true.
@@ -45,12 +45,12 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/file-uploading/upload upload} documentation.
      */
-    upload(file: File | Blob, fileQuery?: IUploadingQuery): Promise<IUploadingReturn[] | IError>;
+    upload(file: File | Blob, fileQuery: IUploadingQuery): Promise<IUploadingReturn[] | IError>;
     /**
      * Deletes a file from the cloud file storage.
      * @handleName delete
      * @param {string} filename - File name. Example: "file.png".
-     * @param {IUploadingQuery} [fileQuery] - Optional set query parameters.
+     * @param {IUploadingQuery} fileQuery - Where the file lives in the storage. Required: without `type`, `entity` and `id` the endpoint answers `400 … should not be empty`.
      * @example
         {
           "type": "page",
@@ -58,15 +58,15 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
           "id": 3787,
           "template": 1
         }
-     * @param {string} [fileQuery.type] - Type, determines the folder name in the storage. Example: "page".
-     * @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 {string} fileQuery.type - Type, determines the folder name in the storage. Example: "page".
+     * @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 {Promise<boolean | IError>} Returns a promise that resolves to true when the file was deleted or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/file-uploading/delete delete} documentation.
      */
-    delete(filename: string, fileQuery?: IUploadingQuery): Promise<boolean | IError>;
+    delete(filename: string, fileQuery: IUploadingQuery): Promise<boolean | IError>;
     /**
      * Public search across the content of files attached to records.
      * @handleName searchFileContent

package/esm/file-uploading/fileUploadingApi.js

@@ -18,9 +18,6 @@ export default class FileUploadingApi extends AsyncModules {
         super(state);
         /** FileUploadingApi class */
         this._defaultQuery = {
-            type: null,
-            entity: null,
-            id: null,
             width: null,
             height: null,
             compress: null,
@@ -31,7 +28,7 @@ export default class FileUploadingApi extends AsyncModules {
      * Upload file function.
      * @handleName upload
      * @param {File | Blob} file - File to upload. Example: `new File(["content"], "file.png", {"type": "image/png"})`
-     * @param {IUploadingQuery} [fileQuery] - Optional set query parameters.
+     * @param {IUploadingQuery} fileQuery - Where the file lives in the storage. Required: without `type`, `entity` and `id` the endpoint answers `400 … should not be empty`.
      * @example
         {
           "type": "page",
@@ -42,9 +39,9 @@ export default class FileUploadingApi extends AsyncModules {
           "compress": true,
           "template": 1
         }
-     * @param {string} [fileQuery.type] - Type, determines the folder name in the storage. Example: "page".
-     * @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 {string} fileQuery.type - Type, determines the folder name in the storage. Example: "page".
+     * @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.width] - Optional width parameter. Example: 0.
      * @param {number} [fileQuery.height] - Optional height parameter. Example: 0.
      * @param {boolean} [fileQuery.compress] - Optional flag of optimization (compression) for images. Example: true.
@@ -66,7 +63,7 @@ export default class FileUploadingApi extends AsyncModules {
      * Deletes a file from the cloud file storage.
      * @handleName delete
      * @param {string} filename - File name. Example: "file.png".
-     * @param {IUploadingQuery} [fileQuery] - Optional set query parameters.
+     * @param {IUploadingQuery} fileQuery - Where the file lives in the storage. Required: without `type`, `entity` and `id` the endpoint answers `400 … should not be empty`.
      * @example
         {
           "type": "page",
@@ -74,9 +71,9 @@ export default class FileUploadingApi extends AsyncModules {
           "id": 3787,
           "template": 1
         }
-     * @param {string} [fileQuery.type] - Type, determines the folder name in the storage. Example: "page".
-     * @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 {string} fileQuery.type - Type, determines the folder name in the storage. Example: "page".
+     * @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 {Promise<boolean | IError>} Returns a promise that resolves to true when the file was deleted or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch

package/esm/file-uploading/fileUploadingInterfaces.d.ts

@@ -17,7 +17,7 @@ interface IFileUploading {
      * Upload file function.
      * @handleName upload
      * @param {File | Blob} file - File to upload. Example: `new File(["content"], "file.png", {"type": "image/png"})`
-     * @param {IUploadingQuery} [fileQuery] - Optional set query parameters.
+     * @param {IUploadingQuery} fileQuery - Where the file lives in the storage. Required: without `type`, `entity` and `id` the endpoint answers `400 … should not be empty`.
      * @example
         {
           "type": "page",
@@ -28,9 +28,9 @@ interface IFileUploading {
           "compress": true,
           "template": 1
         }
-     * @param {string} [fileQuery.type] - Type, determines the folder name in the storage. Example: "page".
-     * @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 {string} fileQuery.type - Type, determines the folder name in the storage. Example: "page".
+     * @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.width] - Optional width parameter. Example: 0.
      * @param {number} [fileQuery.height] - Optional height parameter. Example: 0.
      * @param {boolean} [fileQuery.compress] - Optional flag of optimization (compression) for images. Example: true.
@@ -38,12 +38,12 @@ interface IFileUploading {
      * @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.
      */
-    upload(file: File | Blob, fileQuery?: IUploadingQuery): Promise<IUploadingReturn[] | IError>;
+    upload(file: File | Blob, fileQuery: IUploadingQuery): Promise<IUploadingReturn[] | IError>;
     /**
      * Deletes a file from the cloud file storage.
      * @handleName delete
      * @param {string} [filename] - File name. Example: "file.png".
-     * @param {IUploadingQuery} [fileQuery] - Optional set query parameters.
+     * @param {IUploadingQuery} fileQuery - Where the file lives in the storage. Required: without `type`, `entity` and `id` the endpoint answers `400 … should not be empty`.
      * @example
         {
           "type": "page",
@@ -51,14 +51,14 @@ interface IFileUploading {
           "id": 3787,
           "template": 1
         }
-     * @param {string} [fileQuery.type] - Type, determines the folder name in the storage. Example: "page".
-     * @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 {string} fileQuery.type - Type, determines the folder name in the storage. Example: "page".
+     * @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 {boolean | IError} Returns a promise that resolves to true when the file was deleted 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.
      */
-    delete(filename: string, fileQuery?: IUploadingQuery): Promise<boolean | IError>;
+    delete(filename: string, fileQuery: IUploadingQuery): Promise<boolean | IError>;
     /**
      * Get file by parameters.
      * @handleName getFile
@@ -106,12 +106,12 @@ interface IFileEntity {
  * @property {number} [width] - Width parameter. Example: 0.
  * @property {number} [height] - Height parameter. Example: 0.
  * @property {boolean} [compress] - Flag of optimization (compression) for images. Example: true.
- * @description Represents a query for uploading files, including type, entity, and optional parameters like width, height, and compression.
+ * @description Represents a query for uploading files, including type, entity, and optional parameters like width, height, and compression. `type`, `entity` and `id` are required by the endpoint: it answers `400 … should not be empty` without any of them (CMS-1085).
  */
 interface IUploadingQuery {
-    type: string | null;
-    entity: string | null;
-    id: number | null;
+    type: string;
+    entity: string;
+    id: number;
     [key: string]: string | number | boolean | null;
 }
 /**

package/esm/index.d.ts

@@ -136,7 +136,7 @@ interface IDefineApi {
  * @param {string} [config.guestId] - Optional guest identifier sent as the `x-guest-id` header for guest cart/wishlist/activity flows (only while unauthenticated). In the browser, if omitted, a stable per-device id is generated and persisted in localStorage. On the server you MUST pass a per-visitor `guestId` (or call `setGuestId`): the SDK never auto-generates a server id, to avoid sharing one guest across visitors.
  * @param {string} [config.deviceMetadata] - Optional device-metadata string sent as the `x-device-metadata` header instead of the environment-derived fingerprint. Refresh tokens are bound to this header, so a server issuing tokens for a browser (OAuth code exchange) must pass the browser's string (from `getDeviceMetadata()`), or the token will not be refreshable from that browser.
  * @param {string} [config.langCode] - Optional langCode parameter
- * @param {boolean} [config.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} [config.traficLimit] - Some methods use multiple queries to make it easier to work with the API. Set it to `true` to save traffic and decide for yourself what data you need: the SDK then skips its follow-up requests, and some results change shape (e.g. `searchPage` returns short `{ id, title }` cards). Default: false.
  * @param {string} [config.auth] - An object with authorization settings.
  * @param {boolean} [config.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 {string} [config.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.

package/esm/index.js

@@ -42,7 +42,7 @@ export { expandAttributeTimeIntervals, expandTimeIntervals, isTimeIntervalAttrib
  * @param {string} [config.guestId] - Optional guest identifier sent as the `x-guest-id` header for guest cart/wishlist/activity flows (only while unauthenticated). In the browser, if omitted, a stable per-device id is generated and persisted in localStorage. On the server you MUST pass a per-visitor `guestId` (or call `setGuestId`): the SDK never auto-generates a server id, to avoid sharing one guest across visitors.
  * @param {string} [config.deviceMetadata] - Optional device-metadata string sent as the `x-device-metadata` header instead of the environment-derived fingerprint. Refresh tokens are bound to this header, so a server issuing tokens for a browser (OAuth code exchange) must pass the browser's string (from `getDeviceMetadata()`), or the token will not be refreshable from that browser.
  * @param {string} [config.langCode] - Optional langCode parameter
- * @param {boolean} [config.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} [config.traficLimit] - Some methods use multiple queries to make it easier to work with the API. Set it to `true` to save traffic and decide for yourself what data you need: the SDK then skips its follow-up requests, and some results change shape (e.g. `searchPage` returns short `{ id, title }` cards). Default: false.
  * @param {string} [config.auth] - An object with authorization settings.
  * @param {boolean} [config.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 {string} [config.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.

package/esm/integration-collections/integrationCollectionsApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules.js';
 import type StateModule from '../base/stateModule.js';
 import type { IError } from '../base/utils.js';
-import type { ICollectionEntity, ICollectionFormObject, ICollectionIsValid, ICollectionQuery, ICollectionRow, ICollectionRowsResponce, ICollectionsApi } from './integrationCollectionsInterfaces.js';
+import type { ICollectionEntity, ICollectionFormObject, ICollectionIsValid, ICollectionQuery, ICollectionRow, ICollectionRowsResponce, ICollectionsApi, ICollectionsListQuery } from './integrationCollectionsInterfaces.js';
 /**
  * Controllers for working with attributes.
  * @handle /api/content/integration-collections
@@ -22,22 +22,18 @@ export default class IntegrationCollectionsApi extends AsyncModules implements I
      * Get all collections.
      * @handleName getICollections
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {object} [userQuery] - Optional set query parameters.
+     * @param {ICollectionsListQuery} [userQuery] - Optional set query parameters.
      * @example
         {
-          "limit": 0,
-          "offset": 30,
-          "entityType": "orders",
-          "entityId": 1
+          "limit": 30,
+          "offset": 0
         }
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 30.
-     * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
-     * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
+     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
+     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
      * @returns {Promise<ICollectionEntity[] | IError>} Returns an array of ICollection objects or an error object if there was an issue.
      * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollections getICollections} documentation.
      */
-    getICollections(langCode?: string, userQuery?: ICollectionQuery): Promise<ICollectionEntity[] | IError>;
+    getICollections(langCode?: string, userQuery?: ICollectionsListQuery): Promise<ICollectionEntity[] | IError>;
     /**
      * Get a single collection object by id.
      * @handleName getICollectionById
@@ -53,16 +49,16 @@ export default class IntegrationCollectionsApi extends AsyncModules implements I
      * @handleName getICollectionRowsById
      * @param {number} id - Collection id. Example: 1.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {any} [userQuery] - Optional set query parameters.
+     * @param {ICollectionQuery} [userQuery] - Optional set query parameters.
      * @example
         {
-          "limit": 0,
-          "offset": 30,
+          "limit": 30,
+          "offset": 0,
           "entityType": "orders",
           "entityId": 1
         }
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 30.
+     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
+     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
      * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
      * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
      * @returns {Promise<ICollectionRowsResponce | IError>} Returns object ItemsWithTotal, where items is an array of requested objects.

package/esm/integration-collections/integrationCollectionsApi.js

@@ -27,18 +27,14 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * Get all collections.
      * @handleName getICollections
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {object} [userQuery] - Optional set query parameters.
+     * @param {ICollectionsListQuery} [userQuery] - Optional set query parameters.
      * @example
         {
-          "limit": 0,
-          "offset": 30,
-          "entityType": "orders",
-          "entityId": 1
+          "limit": 30,
+          "offset": 0
         }
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 30.
-     * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
-     * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
+     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
+     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
      * @returns {Promise<ICollectionEntity[] | IError>} Returns an array of ICollection objects or an error object if there was an issue.
      * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollections getICollections} documentation.
      */
@@ -70,16 +66,16 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * @handleName getICollectionRowsById
      * @param {number} id - Collection id. Example: 1.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {any} [userQuery] - Optional set query parameters.
+     * @param {ICollectionQuery} [userQuery] - Optional set query parameters.
      * @example
         {
-          "limit": 0,
-          "offset": 30,
+          "limit": 30,
+          "offset": 0,
           "entityType": "orders",
           "entityId": 1
         }
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 30.
+     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
+     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
      * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
      * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
      * @returns {Promise<ICollectionRowsResponce | IError>} Returns object ItemsWithTotal, where items is an array of requested objects.

package/esm/integration-collections/integrationCollectionsInterfaces.d.ts

@@ -8,23 +8,19 @@ interface ICollectionsApi {
      * Get all collections.
      * @handleName getICollections
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {ICollectionQuery} [userQuery] - Query parameters.
+     * @param {ICollectionsListQuery} [userQuery] - Query parameters.
      * @example
         {
           "limit": 30,
-          "offset": 0,
-          "entityType": "orders",
-          "entityId": 1
+          "offset": 0
         }
-     * @param {number} [userQuery.limit] - Parameter for pagination. Default: 0.
-     * @param {number} [userQuery.offset] - Parameter for pagination. Default: 30.
-     * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
-     * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
+     * @param {number} [userQuery.limit] - Parameter for pagination. Default: 30.
+     * @param {number} [userQuery.offset] - Parameter for pagination. Default: 0.
      * @returns {ICollectionEntity[]} Returns an array of ICollection objects 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.
      * @description This method gets all collections.
      */
-    getICollections(langCode?: string, userQuery?: ICollectionQuery): Promise<ICollectionEntity[] | IError>;
+    getICollections(langCode?: string, userQuery?: ICollectionsListQuery): Promise<ICollectionEntity[] | IError>;
     /**
      * Get a single collection object by id.
      * @handleName getICollectionById
@@ -205,7 +201,7 @@ interface ICollectionFormData {
  * Collection form object
  * @interface ICollectionFormObject
  * @property {string} formIdentifier - Text identifier (marker) of the form. Example: "collection-form".
- * @property {Record<string, ICollectionFormData>} formData - An object where keys are form field markers and values are arrays of ICollectionFormData objects.
+ * @property {ICollectionFormData[] | Record<string, ICollectionFormData[]>} formData - Field values: a flat array `[{ marker, type, value }]` (as in the example), or the same array wrapped in a language code — `{ "en_US": [...] }`. The platform stores both; the SDK sends the value as is.
  * @example
     [
       {
@@ -221,9 +217,7 @@ interface ICollectionFormData {
  */
 interface ICollectionFormObject {
     formIdentifier: string;
-    formData: {
-        [key: string]: ICollectionFormData[];
-    };
+    formData: ICollectionFormData[] | Record<string, ICollectionFormData[]>;
 }
 /**
  * Collection row object
@@ -301,17 +295,24 @@ interface ICollectionIsValid {
     valid: boolean;
 }
 /**
- * Query parameters for collection requests.
+ * Query parameters for collection row requests. All of them are optional.
  * @interface ICollectionQuery
- * @property {number} limit - Parameter for pagination. Default: 30.
- * @property {number} offset - Parameter for pagination. Default: 0.
- * @property {string} entityType - Entity type. Example: "orders".
- * @property {number} entityId - Entity identifier. Example: 1.
+ * @property {number} [limit] - Parameter for pagination. Default: 30.
+ * @property {number} [offset] - Parameter for pagination. Default: 0.
+ * @property {string} [entityType] - Entity type. Example: "orders".
+ * @property {number} [entityId] - Entity identifier. Example: 1.
  */
 interface ICollectionQuery {
-    limit: number;
-    offset: number;
-    entityType: string;
-    entityId: number;
+    limit?: number;
+    offset?: number;
+    entityType?: string;
+    entityId?: number;
 }
-export type { ICollectionEntity, ICollectionFormObject, ICollectionIsValid, ICollectionQuery, ICollectionResponce, ICollectionRow, ICollectionRowsResponce, ICollectionsApi, };
+/**
+ * Query parameters for getICollections: pagination only — the collection list takes no entity filter.
+ * @typedef {object} ICollectionsListQuery
+ * @property {number} [limit] - Parameter for pagination. Default: 30.
+ * @property {number} [offset] - Parameter for pagination. Default: 0.
+ */
+type ICollectionsListQuery = Pick<ICollectionQuery, 'limit' | 'offset'>;
+export type { ICollectionEntity, ICollectionFormObject, ICollectionIsValid, ICollectionQuery, ICollectionResponce, ICollectionRow, ICollectionRowsResponce, ICollectionsApi, ICollectionsListQuery, };