oneentry 1.0.156 → 1.0.157

package/dist/forms/formsInterfaces.d.ts

@@ -71,7 +71,7 @@ interface IFromPages {
  * @property {string} identifier - The textual identifier for the record field. Example: "form_contact_us".
  * @property {string} processingType - Type of form processing. Example: "async".
  * @property {number | null} templateId - The identifier of the template used by the form, or null if no template is used. Example: 6789.
- * @property {IFormAttribute[]} attributes - Form fields with their localization, validators and form-specific flags.
+ * @property {IFormAttribute[]} attributes - Form fields with their localization, validators and form-specific flags, sorted by `position`.
  * @property {number | string} [total] - Total count of related entries. Example: "1".
  * @property {IFormConfig[]} [moduleFormConfigs] - Array of module form configurations associated with the form.
  * @description This interface defines the structure of a form entity, including its identifiers, attributes, and processing data.
@@ -153,7 +153,7 @@ interface IFormAttribute {
  * @interface IFormAttributeAdditionalField
  * @property {string} marker - Marker of the additional field. Example: "additional_field".
  * @property {string} type - Type of the additional field. Example: "string".
- * @property {unknown} value - Value of the additional field. Example: "Additional field data".
+ * @property {unknown} value - Value of the additional field, normalized like any other attribute value: `number | null` for numeric types, the file object itself for a single-file `image`/`file`, `null` when empty. Example: "Additional field data".
  * @description A single nested entry inside {@link IFormAttribute}'s `additionalFields` map.
  */
 interface IFormAttributeAdditionalField {

package/dist/forms-data/formsDataApi.js

@@ -123,7 +123,7 @@ class FormsDataApi extends asyncModules_1.default {
         const result = await this._fetchPost(``, body);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, formsDataSchemas_1.PostFormResponseSchema);
-        return this._dataPostProcess(validated);
+        return this._normalizeData(validated);
     }
     /**
      * Get one object of form data by marker.
@@ -152,7 +152,7 @@ class FormsDataApi extends asyncModules_1.default {
         const result = await this._fetchPost(`/marker/${marker}?formModuleConfigId=${formModuleConfigId}&isExtended=${isExtended}&langCode=${langCode}&offset=${offset}&limit=${limit}`, body);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, formsDataSchemas_1.FormsByMarkerDataResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Update one object of form data by id. Requires user authentication.

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

@@ -346,13 +346,13 @@ interface IBodyPostFormData {
  * @interface IBodyTypeStringNumberFloat
  * @property {string} marker - marker name. Example: "some_marker".
  * @property {string} type - Type value. "string" | "number" | "float". Example: "string".
- * @property {string} value - Value of the form data entity, which can be a "string", "number", or "float". Example: "string".
+ * @property {string | number | null} value - Value of the form data entity. Send it as a string; in responses numeric fields come back normalized to `number`, or `null` when the field is empty. Example: "string".
  * @description Represents a form data entity with a marker, type, and value.
  */
 interface IBodyTypeStringNumberFloat {
     marker: string;
     type: 'string' | 'number' | 'float';
-    value: string;
+    value: string | number | null;
 }
 /**
  * Represents a date/time form data entity.
@@ -520,7 +520,7 @@ interface IImageValue {
  * @interface IBodyTypeFile
  * @property {string} marker - marker name. Example: "picture".
  * @property {'file'} type - Type value. Example: "file".
- * @property {object} value - File Object. Contains file information.
+ * @property {object} value - File Object. Contains file information. A single attached file is returned as the object itself, several files as an array.
  * @example
     [
       {
@@ -534,7 +534,7 @@ interface IImageValue {
 interface IBodyTypeFile {
     marker: string;
     type: 'file';
-    value: IFileValue;
+    value: IFileValue | IFileValue[];
 }
 /**
  * @interface IFileValue

package/dist/integration-collections/integrationCollectionsApi.js

@@ -52,7 +52,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`?` + this._queryParamsToString(query));
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, integrationCollectionsSchemas_1.CollectionsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Get a single collection object by id.
@@ -67,7 +67,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/${id}?` + this._queryParamsToString({ langCode }));
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, integrationCollectionsSchemas_1.CollectionEntitySchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Get all records belonging to the collection by collection id.
@@ -100,7 +100,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
             }));
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, integrationCollectionsSchemas_1.CollectionRowsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Check for the existence of a text identifier (marker).
@@ -119,7 +119,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/marker-validation/${marker}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, integrationCollectionsSchemas_1.CollectionIsValidSchema);
-        return this._dataPostProcess(validated);
+        return this._normalizeData(validated);
     }
     /**
      * Getting all records from the collection.
@@ -134,7 +134,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/marker/${marker}/rows?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, integrationCollectionsSchemas_1.CollectionRowsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Getting one record from the collection.
@@ -150,7 +150,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/marker/${marker}/rows/${id}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, integrationCollectionsSchemas_1.CollectionRowSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Create a record in the collection.

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

@@ -244,6 +244,8 @@ interface ICollectionFormObject {
  * @property {string | null} entityType - Type of the entity associated with the collection row. Example: "product", "order", "etc".
  * @property {number | null} entityId - Identifier of the entity associated with the collection row. Example: 12345.
  * @property {string | null} [attributeSetIdentifier] - Identifier of the attribute set used by the form attached to the collection row, or null if not applicable. Example: "attributeSet1" or null.
+ * @property {string | null} [langCode] - Language code the row was stored under. Example: "en_US".
+ * @property {string | null} [formIdentifier] - Text identifier of the form the row was created from; returned by the create/update row endpoints. Example: "collection_form".
  * @property {string} total - Total count. Example: "1".
  * @description Represents a row in a collection, containing various properties such as identifiers, dates, form data, and an optional total value.
  */
@@ -256,6 +258,8 @@ interface ICollectionRow {
     entityType: string | null;
     entityId: number | null;
     attributeSetIdentifier?: string | null;
+    langCode?: string | null;
+    formIdentifier?: string | null;
     total?: string;
 }
 /**

package/dist/integration-collections/integrationCollectionsSchemas.d.ts

@@ -49,6 +49,8 @@ export declare const CollectionRowSchema: z.ZodObject<{
     entityType: z.ZodNullable<z.ZodString>;
     entityId: z.ZodNullable<z.ZodNumber>;
     attributeSetIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    langCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    formIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     total: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
@@ -68,6 +70,8 @@ export declare const CollectionRowsResponseSchema: z.ZodObject<{
         entityType: z.ZodNullable<z.ZodString>;
         entityId: z.ZodNullable<z.ZodNumber>;
         attributeSetIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        langCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        formIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         total: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     total: z.ZodNumber;

package/dist/integration-collections/integrationCollectionsSchemas.js

@@ -44,6 +44,8 @@ exports.CollectionRowSchema = zod_1.z.object({
     entityType: zod_1.z.string().nullable(),
     entityId: zod_1.z.number().nullable(),
     attributeSetIdentifier: zod_1.z.string().nullable().optional(),
+    langCode: zod_1.z.string().nullable().optional(),
+    formIdentifier: zod_1.z.string().nullable().optional(),
     total: zod_1.z.string().optional(),
 });
 /**

package/dist/menus/menusApi.js

@@ -34,7 +34,7 @@ class MenusApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, menusSchemas_1.MenuEntitySchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
 }
 exports.default = MenusApi;

package/dist/orders/ordersInterfaces.d.ts

@@ -317,6 +317,7 @@ interface IOrderProductsData {
  * @property {string} totalSum - Total order amount. Example: "150".
  * @property {string} [createdDate] - Order creation date. Example: "2023-10-01T12:00:00Z".
  * @property {string} [statusIdentifier] - Text identifier of order status object (if not set, default status will be assigned). Example: "status-1".
+ * @property {ILocalizeInfo} [statusLocalizeInfos] - Localized status name assigned to the created/updated order.
  * @property {string} [couponCode] -
  * @property {string[]} [additionalDiscountsMarkers] -
  * @property {IOrderDiscountConfig} [discountConfig] - Resolved discount configuration applied to the order.
@@ -334,6 +335,7 @@ interface IBaseOrdersEntity {
     totalSum: string;
     createdDate?: string;
     statusIdentifier?: string;
+    statusLocalizeInfos?: ILocalizeInfo;
     couponCode?: string;
     additionalDiscountsMarkers?: string[];
     discountConfig?: IOrderDiscountConfig;
@@ -567,6 +569,10 @@ interface IOrderSplit {
  * @property {boolean | null} [isPartial] - Indicates that the order is partially paid; null on older orders where it was not tracked. Example: false.
  * @property {string} [paymentStrategy] - Payment strategy of the order. Example: "once".
  * @property {ILocalizeInfo} [statusLocalizeInfos] - Localized status name.
+ * @property {string | null} [fulfillmentStatusIdentifier] - Text identifier of the fulfillment (delivery) status; null while no fulfillment status is assigned. Example: "shipped".
+ * @property {ILocalizeInfo | null} [fulfillmentStatusLocalizeInfos] - Localized fulfillment status name; null while no fulfillment status is assigned.
+ * @property {string | null} [paymentStatusIdentifier] - Text identifier of the payment status; null while no payment status is assigned. Example: "inProgress-payment".
+ * @property {ILocalizeInfo | null} [paymentStatusLocalizeInfos] - Localized payment status name; null while no payment status is assigned.
  * @property {IOrderDiscountConfig | null} [discountConfig] - Resolved discount configuration applied to the order (orderDiscounts, productDiscounts, coupon, settings, bonus, totals); null on older orders without a resolved discount config.
  * @property {IOrderSplit} [split] - Split (staged) payment configuration; present on the by-id order endpoint.
  * @description Represents an order storage object created by the user.
@@ -590,6 +596,10 @@ interface IOrderByMarkerEntity {
     isPartial?: boolean | null;
     paymentStrategy?: string;
     statusLocalizeInfos?: ILocalizeInfo;
+    fulfillmentStatusIdentifier?: string | null;
+    fulfillmentStatusLocalizeInfos?: ILocalizeInfo | null;
+    paymentStatusIdentifier?: string | null;
+    paymentStatusLocalizeInfos?: ILocalizeInfo | null;
     discountConfig?: IOrderDiscountConfig | null;
     split?: IOrderSplit;
 }

package/dist/orders/ordersSchemas.d.ts

@@ -69,6 +69,10 @@ export declare const OrderEntitySchema: z.ZodObject<{
     isPartial: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     paymentStrategy: z.ZodOptional<z.ZodString>;
     statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    fulfillmentStatusIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fulfillmentStatusLocalizeInfos: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    paymentStatusIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    paymentStatusLocalizeInfos: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
     discountConfig: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         bonus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             availableBalance: z.ZodNumber;
@@ -133,6 +137,10 @@ export declare const OrdersResponseSchema: z.ZodObject<{
         isPartial: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         paymentStrategy: z.ZodOptional<z.ZodString>;
         statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        fulfillmentStatusIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fulfillmentStatusLocalizeInfos: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+        paymentStatusIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        paymentStatusLocalizeInfos: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
         discountConfig: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             bonus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                 availableBalance: z.ZodNumber;
@@ -220,6 +228,7 @@ export declare const CreateOrderResponseSchema: z.ZodObject<{
     totalSum: z.ZodNumber;
     createdDate: z.ZodOptional<z.ZodString>;
     statusIdentifier: z.ZodOptional<z.ZodString>;
+    statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     couponCode: z.ZodOptional<z.ZodString>;
     additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     discountConfig: z.ZodOptional<z.ZodObject<{
@@ -267,6 +276,7 @@ export declare const UpdateOrderResponseSchema: z.ZodObject<{
     totalSum: z.ZodNumber;
     createdDate: z.ZodOptional<z.ZodString>;
     statusIdentifier: z.ZodOptional<z.ZodString>;
+    statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     couponCode: z.ZodOptional<z.ZodString>;
     additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     discountConfig: z.ZodOptional<z.ZodObject<{

package/dist/orders/ordersSchemas.js

@@ -75,6 +75,16 @@ exports.OrderEntitySchema = zod_1.z.object({
     isPartial: zod_1.z.boolean().nullable().optional(),
     paymentStrategy: zod_1.z.string().optional(),
     statusLocalizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+    fulfillmentStatusIdentifier: zod_1.z.string().nullable().optional(),
+    fulfillmentStatusLocalizeInfos: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.any())
+        .nullable()
+        .optional(),
+    paymentStatusIdentifier: zod_1.z.string().nullable().optional(),
+    paymentStatusLocalizeInfos: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.any())
+        .nullable()
+        .optional(),
     discountConfig: exports.OrderDiscountConfigSchema.nullable().optional(),
     split: zod_1.z
         .object({
@@ -132,6 +142,7 @@ exports.CreateOrderResponseSchema = zod_1.z.object({
     totalSum: zod_1.z.number(),
     createdDate: zod_1.z.string().optional(),
     statusIdentifier: zod_1.z.string().optional(),
+    statusLocalizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
     couponCode: zod_1.z.string().optional(),
     additionalDiscountsMarkers: zod_1.z.array(zod_1.z.string()).optional(),
     discountConfig: exports.OrderDiscountConfigSchema.optional(),
@@ -153,6 +164,7 @@ exports.UpdateOrderResponseSchema = zod_1.z.object({
     totalSum: zod_1.z.number(),
     createdDate: zod_1.z.string().optional(),
     statusIdentifier: zod_1.z.string().optional(),
+    statusLocalizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
     couponCode: zod_1.z.string().optional(),
     additionalDiscountsMarkers: zod_1.z.array(zod_1.z.string()).optional(),
     discountConfig: exports.OrderDiscountConfigSchema.optional(),

package/dist/pages/pagesApi.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 { IPageConfig, IPagesApi, IPagesEntity, IPositionBlock } from './pagesInterfaces';
+import type { IPageConfig, IPagesApi, IPageSearchResult, IPagesEntity, IPositionBlock } from './pagesInterfaces';
 /**
  * Controllers for working with page objects, including catalog pages
  * @handle /api/content/pages
@@ -96,12 +96,12 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @param {string} name - Text for searching page objects (search is performed on the title field of the localizeInfos object with the language taken into account). Example: "About Us".
      * @param {string} [url] - Page URL. Example: "catalog".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data)
+     * @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.
+     * @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.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/searchPage searchPage} documentation.
      */
-    searchPage(name: string, url?: string, langCode?: string): Promise<IPagesEntity[] | IError>;
+    searchPage(name: string, url?: string, langCode?: string): Promise<IPagesEntity[] | IPageSearchResult[] | IError>;
     /**
      * Add template data to pages
      * @handleName addTemplateToPages

package/dist/pages/pagesApi.js

@@ -201,16 +201,18 @@ class PagesApi extends asyncModules_1.default {
      * @param {string} name - Text for searching page objects (search is performed on the title field of the localizeInfos object with the language taken into account). Example: "About Us".
      * @param {string} [url] - Page URL. Example: "catalog".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data)
+     * @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.
+     * @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.
      * @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 data = await this._fetchGet(`/quick/search?${urlPart}lang=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
+        const searchPages = await this._fetchGet(`/quick/search?${urlPart}lang=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
         // /quick/search?url=catalog&langCode=en_US&name=cat
+        // Validate response if validation is enabled
+        const data = this._validateResponse(searchPages, pagesSchemas_1.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
@@ -224,13 +226,12 @@ class PagesApi extends asyncModules_1.default {
             }));
             // Add templates to the fetched pages
             const withTemplate = await this.addTemplateToPages(pageList);
-            // Post-process the data and return it; ensures consistent structure or handles errors
-            return this._dataPostProcess(withTemplate, langCode);
+            // Normalize the data and return it; ensures consistent structure or handles errors
+            return this._normalizeData(withTemplate, langCode);
         }
-        // If there is a traffic limit, add templates to the initially fetched data without fetching detailed information
-        const withTemplate = await this.addTemplateToPages(data);
-        // Normalize the data and return it; ensures consistent structure or handles errors
-        return this._normalizeData(withTemplate, langCode);
+        // With a traffic limit (or on an API error) return the quick search response as is:
+        // short cards carry no templateIdentifier, so there is nothing to attach a template to
+        return this._normalizeData(data, langCode);
     }
     /**
      * Add template data to pages

package/dist/pages/pagesInterfaces.d.ts

@@ -81,11 +81,11 @@ interface IPagesApi {
      * @param {string} name - Text for searching page objects (search is performed on the title field of the localizeInfos object with the language taken into account). Example: "About Us".
      * @param {string} [url] - Optional page URL to filter search results. Example: "catalog".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {IPagesEntity[]} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data)
+     * @returns {IPagesEntity[] | IPageSearchResult[]} 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} - If there is an error during the fetch operation, it will return an error object.
-     * @description This method performs a quick search for page objects with limited output.
+     * @description This method performs a quick search for page objects with limited output. With traficLimit enabled the raw quick search response is returned as short cards; otherwise full page entities are fetched for the found ids.
      */
-    searchPage(name: string, url?: string, langCode?: LangType): Promise<IPagesEntity[] | IError>;
+    searchPage(name: string, url?: string, langCode?: LangType): Promise<IPagesEntity[] | IPageSearchResult[] | IError>;
 }
 /**
  * @interface IPageConfig
@@ -294,4 +294,14 @@ interface IPagesEntity {
     total?: string;
     categoryPath?: string | null;
 }
-export type { IPageConfig, IPagesApi, IPagesEntity, IPositionBlock, IPositionForm, PageType, };
+/**
+ * @interface IPageSearchResult
+ * @property {number} id - The identifier of the page. Example: 10.
+ * @property {string} title - Page title in the requested language. Example: "Catalog".
+ * @description This interface defines the short page card returned by the quick search endpoint when the traficLimit config option is enabled. It contains only identification fields, without attributeValues, localizeInfos, blocks and other fields of a full page entity.
+ */
+interface IPageSearchResult {
+    id: number;
+    title: string;
+}
+export type { IPageConfig, IPagesApi, IPageSearchResult, IPagesEntity, IPositionBlock, IPositionForm, PageType, };

package/dist/pages/pagesSchemas.d.ts

@@ -66,6 +66,21 @@ export declare const PagesResponseSchema: z.ZodArray<z.ZodObject<{
     total: z.ZodOptional<z.ZodString>;
     categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>>;
+/**
+ * Page search result schema
+ * Short card returned by the quick search endpoint
+ */
+export declare const PageSearchResultSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Page search response schema (array of short cards)
+ */
+export declare const PageSearchResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+}, z.core.$strip>>;
 /**
  * Single page response schema
  */

package/dist/pages/pagesSchemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PageConfigSchema = exports.SinglePageSchema = exports.PagesResponseSchema = exports.PageEntitySchema = void 0;
+exports.PageConfigSchema = exports.SinglePageSchema = exports.PageSearchResponseSchema = exports.PageSearchResultSchema = exports.PagesResponseSchema = exports.PageEntitySchema = void 0;
 /**
  * Validation schemas for Pages module
  * @description Zod schemas for validating pages-related API responses
@@ -38,6 +38,18 @@ exports.PageEntitySchema = zod_1.z.object({
  * Pages response schema (array of pages)
  */
 exports.PagesResponseSchema = zod_1.z.array(exports.PageEntitySchema);
+/**
+ * Page search result schema
+ * Short card returned by the quick search endpoint
+ */
+exports.PageSearchResultSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    title: zod_1.z.string(),
+});
+/**
+ * Page search response schema (array of short cards)
+ */
+exports.PageSearchResponseSchema = zod_1.z.array(exports.PageSearchResultSchema);
 /**
  * Single page response schema
  */

package/dist/products/productsApi.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 { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts } from './productsInterfaces';
+import type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductSearchResult, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts } from './productsInterfaces';
 /**
  * Controllers for working with product pages
  * @handle /api/content/products
@@ -267,12 +267,12 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @handleName searchProduct
      * @param {string} name - Text to search product page objects (search is based on the title field of the localizeInfos object with language consideration). Example: "laminat".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects
+     * @returns {Promise<IProductsEntity[] | IProductSearchResult[] | IError>} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Quick search for product page objects with limited output.
+     * @description Quick search for product page objects with limited output. The quick search endpoint returns short cards ({ id, title, pageId }); with traficLimit enabled they are returned as is, otherwise full product entities are fetched for the found ids.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/searchProduct searchProduct} documentation.
      */
-    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IError>;
+    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
     /**
      * Getting the number of products for the entire catalog.
      * @handleName getProductsCount

package/dist/products/productsApi.js

@@ -75,7 +75,7 @@ class ProductsApi extends asyncModules_1.default {
         const result = await this._fetchPost(`/all?` + this._queryParamsToString(query), { filter: body });
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Search for all product page objects with pagination (and aggregation) that do not have a category.
@@ -150,7 +150,7 @@ class ProductsApi extends asyncModules_1.default {
         const result = await this._fetchPost(`/page/${id}?langCode=${langCode}&` + this._queryParamsToString(query), { filter: body });
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Search for information about products and prices for the selected category.
@@ -229,7 +229,7 @@ class ProductsApi extends asyncModules_1.default {
             this._queryParamsToString(query), { filter: body });
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Find all related product page objects.
@@ -261,7 +261,7 @@ class ProductsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/${id}/related?langCode=${langCode}&` + this._queryParamsToString(query));
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Find products by its ids.
@@ -290,7 +290,7 @@ class ProductsApi extends asyncModules_1.default {
             ...userQuery,
         };
         const result = await this._fetchGet(`/ids?` + this._queryParamsToString(query));
-        return this._dataPostProcess(result, langCode);
+        return this._normalizeData(result, langCode);
     }
     /**
      * Retrieve one product object.
@@ -310,7 +310,7 @@ class ProductsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/${id}?` + this._queryParamsToString(query));
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductEntitySchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Getting a product block object by product id.
@@ -330,13 +330,15 @@ class ProductsApi extends asyncModules_1.default {
      * @handleName searchProduct
      * @param {string} name - Text to search product page objects (search is based on the title field of the localizeInfos object with language consideration). Example: "laminat".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects
+     * @returns {Promise<IProductsEntity[] | IProductSearchResult[] | IError>} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Quick search for product page objects with limited output.
+     * @description Quick search for product page objects with limited output. The quick search endpoint returns short cards ({ id, title, pageId }); with traficLimit enabled they are returned as is, otherwise full product entities are fetched for the found ids.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/searchProduct searchProduct} documentation.
      */
     async searchProduct(name, langCode = this.state.lang) {
-        const searchProducts = await this._fetchGet(`/quick/search?langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
+        const result = await this._fetchGet(`/quick/search?langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
+        // Validate response if validation is enabled
+        const searchProducts = this._validateResponse(result, productsSchemas_1.ProductSearchResponseSchema);
         if (!this.state.traficLimit && Array.isArray(searchProducts)) {
             if (searchProducts.length === 0)
                 return searchProducts;
@@ -453,7 +455,7 @@ class ProductsApi extends asyncModules_1.default {
             limit,
         };
         const result = await this._fetchPost(`/vector/search?` + this._queryParamsToString(query), body);
-        return this._dataPostProcess(result, langCode);
+        return this._normalizeData(result, langCode);
     }
     /**
      * Get products by page url.

package/dist/products/productsInterfaces.d.ts

@@ -189,11 +189,11 @@ interface IProductsApi {
      * @handleName searchProduct
      * @param {string} name - Text to search product page objects (search is based on the title field of the localizeInfos object with language consideration). Example: 'laminat'.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {IProductsEntity[]} Array with ProductEntity objects
+     * @returns {IProductsEntity[] | IProductSearchResult[]} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
-     * @description This method performs a quick search for product page objects with limited output.
+     * @description This method performs a quick search for product page objects with limited output. With traficLimit enabled the raw quick search response is returned as short cards; otherwise full product entities are fetched for the found ids.
      */
-    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IError>;
+    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
     /**
      * Getting the number of products for the entire catalog.
      * @handleName getProductsCount
@@ -539,6 +539,18 @@ interface IProductsResponse {
     items: IProductsEntity[];
     total: number;
 }
+/**
+ * @interface IProductSearchResult
+ * @property {number} id - The identifier of the product. Example: 2957.
+ * @property {string} title - Product title in the requested language. Example: "Cosmo".
+ * @property {number} pageId - The identifier of the catalog page the product is linked to. Example: 10.
+ * @description This interface defines the short product card returned by the quick search endpoint when the traficLimit config option is enabled. It contains only identification fields, without attributeValues, localizeInfos and other fields of a full product entity.
+ */
+interface IProductSearchResult {
+    id: number;
+    title: string;
+    pageId: number;
+}
 /**
  * @interface IProductsCount
  * @property {number} totalAll - The total number of products found. Example: 100.
@@ -700,4 +712,4 @@ interface IVectorSearchProducts {
     maxHits?: number;
     debug?: boolean;
 }
-export type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductInfo, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts, };
+export type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductInfo, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductSearchResult, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts, };

package/dist/products/productsSchemas.d.ts

@@ -148,6 +148,23 @@ export declare const SingleProductSchema: z.ZodObject<{
     distance: z.ZodOptional<z.ZodNumber>;
     discountConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, z.core.$strip>;
+/**
+ * Product search result schema
+ * Short card returned by the quick search endpoint
+ */
+export declare const ProductSearchResultSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    pageId: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Product search response schema (array of short cards)
+ */
+export declare const ProductSearchResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    pageId: z.ZodNumber;
+}, z.core.$strip>>;
 /**
  * Products count schema
  */