oneentry 1.0.171 → 1.0.173

package/dist/forms-data/formsDataApi.js

@@ -117,9 +117,12 @@ class FormsDataApi extends asyncModules_1.default {
             // Create an instance of FileUploadingApi with the current state
             const fileUploader = new fileUploadingApi_1.default(this.state);
             // Process each element in formData[langCode] asynchronously
-            formData[langCode] = await Promise.all(formData[langCode].map(async (fd) => {
+            formData[langCode] = await Promise.all(formData[langCode].map(async (field) => {
                 // Check if the type is one of the specified types
-                if (['file', 'image', 'groupOfImages'].includes(fd.type)) {
+                if (['file', 'image', 'groupOfImages'].includes(field.type)) {
+                    // Work on a copy: the caller's field keeps its File and its fileQuery,
+                    // so a reused body sends the same form again (CMS-1071)
+                    const fd = { ...field };
                     // If fileQuery does not exist, we create it and assign it to an object with the following properties:
                     if (!fd.fileQuery) {
                         const fileQuery = {
@@ -157,13 +160,15 @@ class FormsDataApi extends asyncModules_1.default {
                     delete fd.fileQuery;
                     // Remove the 'contentType' property from the file object because it is not needed and not valid
                     fd.value = this._stripContentType(fd.value);
+                    return fd;
                 }
-                // Return the processed form data element
-                return fd;
+                // Return the form data element untouched
+                return field;
             }));
         }
-        body.formData = formData;
-        const result = await this._fetchPost(``, body);
+        // The wrapped formData goes into a new body: written back into the caller's
+        // object, a second call with it wrapped the wrapper and answered `400` (CMS-1071)
+        const result = await this._fetchPost(``, { ...body, formData });
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('PostFormResponseSchema'));
         return this._normalizeData(validated);
@@ -183,7 +188,7 @@ class FormsDataApi extends asyncModules_1.default {
     /**
      * Removes `contentType` from a file value, which the endpoint does not accept.
      * @param {T} value - Value of a `file` / `image` / `groupOfImages` field, after the uploads.
-     * @returns {T} The same value, without `contentType`.
+     * @returns {T} The value without `contentType`; entries that carried it are copies, the caller's objects are not modified.
      * @description `FileUploading.upload` returns `contentType` and form data rejects it,
      * so it is stripped from an array of values and from a lone value object alike. A value
      * of any other shape is returned untouched and the endpoint names the field it cannot
@@ -191,18 +196,20 @@ class FormsDataApi extends asyncModules_1.default {
      * request is made (CMS-990).
      */
     _stripContentType(value) {
+        // An entry carrying `contentType` is copied without it rather than edited:
+        // a descriptor passed through untouched belongs to the caller (CMS-1071)
         const strip = (item) => {
-            if (item && typeof item === 'object' && !Array.isArray(item)) {
-                delete item.contentType;
+            if (item &&
+                typeof item === 'object' &&
+                !Array.isArray(item) &&
+                'contentType' in item) {
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                const { contentType, ...rest } = item;
+                return rest;
             }
+            return item;
         };
-        if (Array.isArray(value)) {
-            value.forEach(strip);
-        }
-        else {
-            strip(value);
-        }
-        return value;
+        return (Array.isArray(value) ? value.map(strip) : strip(value));
     }
     /**
      * Drops the date bounds the endpoint refuses to parse.
@@ -309,7 +316,7 @@ class FormsDataApi 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 {Promise<IFormsDataSearchResponse | IError>} Returns an object with an array of found form data records and total count.
+     * @returns {Promise<IVectorSearchResponse<IFormsDataSearchResponse> | IError>} Returns an object with an array of found form data records and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for form data.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByVectorSearch getFormsDataByVectorSearch} documentation.

package/dist/forms-data/formsDataInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IError } from '../base/utils';
+import type { IError, IVectorSearchResponse } from '../base/utils';
 import type { IUploadingQuery, IUploadingReturn } from '../file-uploading/fileUploadingInterfaces';
 /**
  * Interface for retrieving and posting form data in the system.
@@ -77,10 +77,10 @@ interface IFormsData {
      * @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 {Promise<IFormsDataSearchResponse | IError>} Returns an object with an array of found form data records and total count.
+     * @returns {Promise<IVectorSearchResponse<IFormsDataSearchResponse> | IError>} Returns an object with an array of found form data records and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
-    getFormsDataByVectorSearch(body: IFormsDataVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IFormsDataSearchResponse | IError>;
+    getFormsDataByVectorSearch(body: IFormsDataVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IFormsDataSearchResponse> | IError>;
 }
 /**
  * Body for semantic (vector) form data search.

package/dist/general-types/generalTypesSchemas.d.ts

@@ -10,7 +10,6 @@ import { z } from 'zod';
 export declare const GeneralTypeEntitySchema: z.ZodObject<{
     id: z.ZodNumber;
     type: z.ZodEnum<{
-        none: "none";
         product: "product";
         order: "order";
         form: "form";
@@ -41,7 +40,6 @@ export declare const GeneralTypeEntitySchema: z.ZodObject<{
 export declare const GeneralTypesResponseSchema: z.ZodArray<z.ZodObject<{
     id: z.ZodNumber;
     type: z.ZodEnum<{
-        none: "none";
         product: "product";
         order: "order";
         form: "form";

package/dist/general-types/generalTypesSchemas.js

@@ -36,7 +36,6 @@ exports.GeneralTypeEntitySchema = zod_1.z.object({
         'service',
         'external_page',
         'discount',
-        'none',
     ]),
 });
 /**

package/dist/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/dist/index.js

@@ -59,7 +59,7 @@ Object.defineProperty(exports, "isTimeIntervalAttribute", { enumerable: true, ge
  * @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/dist/integration-collections/integrationCollectionsApi.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 { ICollectionEntity, ICollectionFormObject, ICollectionIsValid, ICollectionQuery, ICollectionRow, ICollectionRowsResponce, ICollectionsApi } from './integrationCollectionsInterfaces';
+import type { ICollectionEntity, ICollectionFormObject, ICollectionIsValid, ICollectionQuery, ICollectionRow, ICollectionRowsResponce, ICollectionsApi, ICollectionsListQuery } from './integrationCollectionsInterfaces';
 /**
  * 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/dist/integration-collections/integrationCollectionsApi.js

@@ -65,18 +65,14 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * 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.
      */
@@ -108,16 +104,16 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @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/dist/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, };

package/dist/orders/ordersApi.d.ts

@@ -1,6 +1,6 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
-import type { IError } from '../base/utils';
+import type { IError, IVectorSearchResponse } from '../base/utils';
 import type { IBaseOrdersEntity, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderPreviewResponse, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrderStatus, IOrdersVectorSearch, IRefundRequest } from './ordersInterfaces';
 /**
  * Controllers for working with orders.
@@ -204,13 +204,13 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @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 {Promise<IOrdersByMarkerEntity | IError>} Returns an object with an array of found orders and total count.
+     * @returns {Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>} Returns an object with an array of found orders and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search over the orders of the authorized user. It 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}.
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/getOrdersByVectorSearch getOrdersByVectorSearch} documentation.
      */
-    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
+    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>;
     /**
      * Runs a fetch against the `/orders` base URL instead of the default
      * `/orders-storage`, then restores the original URL.
@@ -224,4 +224,17 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @template T
      */
     private _withOrdersUrl;
+    /**
+     * Builds the order body the API expects: `formData` wrapped in a map keyed by locale.
+     *
+     * The wrapping is done on a copy. Writing it back into the caller's object made
+     * a reused body — a retry, a shared template — arrive wrapped twice: `createOrder`
+     * answered `400 formData's marker '#0' marker is required`, and
+     * `updateOrderByMarkerAndId` answered `200` and stored the broken `formData` in
+     * the order (CMS-1063).
+     * @param {IOrderData} body - Order body as the caller passed it. Left unchanged.
+     * @param {string} langCode - Locale key to wrap `formData` into.
+     * @returns {object} A new body with `formData` as `{ [langCode]: [...] }`.
+     */
+    private _wrapOrderFormData;
 }

package/dist/orders/ordersApi.js

@@ -187,13 +187,7 @@ class OrdersApi extends asyncModules_1.default {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/createOrder createOrder} documentation.
      */
     async createOrder(marker, body, langCode = this.state.lang) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const formData = {};
-        formData[langCode] = Array.isArray(body.formData)
-            ? body.formData
-            : [body.formData];
-        body.formData = formData;
-        const result = await this._fetchPost(`/marker/${marker}/orders`, body);
+        const result = await this._fetchPost(`/marker/${marker}/orders`, this._wrapOrderFormData(body, langCode));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('CreateOrderResponseSchema'));
         return this._normalizeData(validated);
@@ -229,13 +223,7 @@ class OrdersApi extends asyncModules_1.default {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/updateOrderByMarkerAndId updateOrderByMarkerAndId} documentation.
      */
     async updateOrderByMarkerAndId(marker, id, body, langCode = this.state.lang) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const formData = {};
-        formData[langCode] = Array.isArray(body.formData)
-            ? body.formData
-            : [body.formData];
-        body.formData = formData;
-        const result = await this._fetchPut(`/marker/${marker}/orders/${id}?langCode=${langCode}`, body);
+        const result = await this._fetchPut(`/marker/${marker}/orders/${id}?langCode=${langCode}`, this._wrapOrderFormData(body, langCode));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('UpdateOrderResponseSchema'));
         return this._normalizeData(validated);
@@ -305,7 +293,7 @@ class OrdersApi 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 {Promise<IOrdersByMarkerEntity | IError>} Returns an object with an array of found orders and total count.
+     * @returns {Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>} Returns an object with an array of found orders and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search over the orders of the authorized user. It 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}.
@@ -342,5 +330,27 @@ class OrdersApi extends asyncModules_1.default {
             this._url = savedUrl;
         }
     }
+    /**
+     * Builds the order body the API expects: `formData` wrapped in a map keyed by locale.
+     *
+     * The wrapping is done on a copy. Writing it back into the caller's object made
+     * a reused body — a retry, a shared template — arrive wrapped twice: `createOrder`
+     * answered `400 formData's marker '#0' marker is required`, and
+     * `updateOrderByMarkerAndId` answered `200` and stored the broken `formData` in
+     * the order (CMS-1063).
+     * @param {IOrderData} body - Order body as the caller passed it. Left unchanged.
+     * @param {string} langCode - Locale key to wrap `formData` into.
+     * @returns {object} A new body with `formData` as `{ [langCode]: [...] }`.
+     */
+    _wrapOrderFormData(body, langCode) {
+        return {
+            ...body,
+            formData: {
+                [langCode]: Array.isArray(body.formData)
+                    ? body.formData
+                    : [body.formData],
+            },
+        };
+    }
 }
 exports.default = OrdersApi;

package/dist/orders/ordersInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IError, ILocalizeInfo } from '../base/utils';
+import type { IError, ILocalizeInfo, IVectorSearchResponse } from '../base/utils';
 /**
  * @interface IOrdersApi
  * @description Represents the API for managing orders in the order storage.
@@ -176,10 +176,10 @@ interface IOrdersApi {
      * @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 {Promise<IOrdersByMarkerEntity | IError>} Returns an object with an array of found orders and total count.
+     * @returns {Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>} Returns an object with an array of found orders and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
-    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
+    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>;
 }
 /**
  * Body for semantic (vector) order search.
@@ -211,7 +211,7 @@ interface IOrdersVectorSearch {
         "formData": [
           {
           "marker": "order_name",
-          "value": "Ivan",
+          "value": "John",
           "type": "string"
           }
         ],
@@ -578,7 +578,7 @@ interface IOrderSplit {
     [
       {
         "marker": "order_name",
-        "value": "Ivan",
+        "value": "John",
         "type": "string"
       }
     ]

package/dist/pages/pagesApi.d.ts

@@ -1,6 +1,6 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
-import type { IError } from '../base/utils';
+import type { IError, IVectorSearchResponse } from '../base/utils';
 import type { IPagesApi, IPageSearchResult, IPagesEntity, IPagesResponse, IPagesVectorSearch, IPositionBlock } from './pagesInterfaces';
 /**
  * Controllers for working with page objects, including catalog pages
@@ -88,7 +88,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IPagesEntity[] | IPageSearchResult[] | IError>} Returns found pages as an array of PageEntity objects, an array of short PageSearchResult cards when the traficLimit config option is enabled, or an empty array [] (if there is no data)
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Quick search for page objects with limited output. The quick search endpoint returns short cards ({ id, title }); with traficLimit enabled they are returned as is, otherwise full page entities are fetched for the found ids.
+     * @description Quick search for page objects with limited output. The quick search endpoint returns short cards ({ id, title }); with traficLimit enabled they are returned as is, otherwise full page entities are fetched for the found ids. The search runs in `langCode`, and a found page that cannot be loaded in that language is left out of the result.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/searchPage searchPage} documentation.
      */
     searchPage(name: string, url?: string, langCode?: string): Promise<IPagesEntity[] | IPageSearchResult[] | IError>;
@@ -99,12 +99,12 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @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 {Promise<IPagesResponse | IError>} Returns an object with an array of found pages and total count.
+     * @returns {Promise<IVectorSearchResponse<IPagesResponse> | IError>} Returns an object with an array of found pages and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for pages.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPagesByVectorSearch getPagesByVectorSearch} documentation.
      */
-    getPagesByVectorSearch(body: IPagesVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IPagesResponse | IError>;
+    getPagesByVectorSearch(body: IPagesVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IPagesResponse> | IError>;
     /**
      * Add template data to pages
      * @handleName addTemplateToPages

package/dist/pages/pagesApi.js

@@ -220,27 +220,23 @@ class PagesApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IPagesEntity[] | IPageSearchResult[] | IError>} Returns found pages as an array of PageEntity objects, an array of short PageSearchResult cards when the traficLimit config option is enabled, or an empty array [] (if there is no data)
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Quick search for page objects with limited output. The quick search endpoint returns short cards ({ id, title }); with traficLimit enabled they are returned as is, otherwise full page entities are fetched for the found ids.
+     * @description Quick search for page objects with limited output. The quick search endpoint returns short cards ({ id, title }); with traficLimit enabled they are returned as is, otherwise full page entities are fetched for the found ids. The search runs in `langCode`, and a found page that cannot be loaded in that language is left out of the result.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/searchPage searchPage} documentation.
      */
     async searchPage(name, url, langCode = this.state.lang) {
         // Fetch data from the server using a GET request to perform a quick search by page name and language code
         const urlPart = url ? `url=${encodeURIComponent(url)}&` : '';
-        const searchPages = await this._fetchGet(`/quick/search?${urlPart}lang=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
-        // /quick/search?url=catalog&langCode=en_US&name=cat
+        const searchPages = await this._fetchGet(`/quick/search?${urlPart}langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
         // Validate response if validation is enabled
         const data = (await this._validateResponse(searchPages, schema('PageSearchResponseSchema')));
         // Check if there is no traffic limit set in the state
         if (!this.state.traficLimit && Array.isArray(data)) {
-            // Initialize an empty array to store detailed page information
-            const pageList = [];
-            // Use Promise.all to fetch detailed information for each page concurrently
-            await Promise.all(data.map(async (page) => {
-                // Fetch detailed page information by page ID and push it to pageList
-                await this.getPageById(page.id, langCode).then((result) => {
-                    pageList.push(result);
-                });
-            }));
+            // Fetch detailed information for each page concurrently, keeping the search order
+            const fetched = await Promise.all(data.map((page) => this.getPageById(page.id, langCode)));
+            // A page the quick search found but getPageById could not load (404 in this
+            // language, closed route) is left out: an IError has no place in IPagesEntity[]
+            // and broke `page.localizeInfos.title` on the caller's side (CMS-1068)
+            const pageList = fetched.filter((page) => !this._isErrorResponse(page));
             // Add templates to the fetched pages
             const withTemplate = await this.addTemplateToPages(pageList);
             // Normalize the data and return it; ensures consistent structure or handles errors
@@ -257,7 +253,7 @@ class PagesApi 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 {Promise<IPagesResponse | IError>} Returns an object with an array of found pages and total count.
+     * @returns {Promise<IVectorSearchResponse<IPagesResponse> | IError>} Returns an object with an array of found pages and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for pages.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPagesByVectorSearch getPagesByVectorSearch} documentation.

package/dist/pages/pagesInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IAttributes, IAttributeValues, IError, ILocalizeInfo, IRating, LangType } from '../base/utils';
+import type { IAttributes, IAttributeValues, IError, ILocalizeInfo, IRating, IVectorSearchResponse, LangType } from '../base/utils';
 import type { BlockType, IBlockEntity } from '../blocks/blocksInterfaces';
 import type { IFormConfig } from '../forms/formsInterfaces';
 import type { IProductsEntity, IProductsResponse } from '../products/productsInterfaces';
@@ -84,11 +84,11 @@ interface IPagesApi {
      * @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 {IPagesResponse} A promise that resolves to a pages response (items + total) or an error.
+     * @returns {IVectorSearchResponse<IPagesResponse>} A promise that resolves to a pages response (items + total + indexReady) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method performs a semantic (vector) search for pages.
      */
-    getPagesByVectorSearch(body: IPagesVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IPagesResponse | IError>;
+    getPagesByVectorSearch(body: IPagesVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IPagesResponse> | IError>;
 }
 /**
  * Body for semantic (vector) page search.

package/dist/product-statuses/productStatusesApi.d.ts

@@ -29,7 +29,7 @@ export default class ProductStatusesApi extends AsyncModules implements IProduct
     /**
      * Search for a product status object by its textual identifier (marker).
      * @handleName getProductsByStatusMarker
-     * @param {string} marker - Product marker. Example: "in_stock".
+     * @param {string} marker - Product status marker. Example: "in_stock".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IProductStatusEntity | IError>} Returns a product status object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -40,7 +40,7 @@ export default class ProductStatusesApi extends AsyncModules implements IProduct
     /**
      * Check the existence of a textual identifier.
      * @handleName validateMarker
-     * @param {string} marker - Product marker. Example: "in_stock".
+     * @param {string} marker - Product status marker. Example: "in_stock".
      * @returns {Promise<boolean | IError>} Returns true if the textual identifier (marker) exists or false if it doesn't.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Check the existence of a textual identifier.