oneentry 1.0.156 → 1.0.158

package/dist/blocks/blocksInterfaces.d.ts

@@ -59,10 +59,10 @@ interface IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getCartComplement(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    getCartComplement(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get "complete your cart" products by an explicit list of productIds (POST body).
      * @handleName getCartComplementByProductIds
@@ -73,10 +73,10 @@ interface IBlocks {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getCartComplementByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
+    getCartComplementByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to cart" products by the cart from context (auth user or guest).
      * @handleName getCartSimilar
@@ -84,10 +84,10 @@ interface IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getCartSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    getCartSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to cart" products by an explicit list of productIds (POST body).
      * @handleName getCartSimilarByProductIds
@@ -98,10 +98,10 @@ interface IBlocks {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getCartSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
+    getCartSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsResponse | IError>;
     /**
      * Get personal recommendations for the user.
      * @handleName getPersonalRecommendations
@@ -109,10 +109,10 @@ interface IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getPersonalRecommendations(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    getPersonalRecommendations(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get recently viewed products.
      * @handleName getRecentlyViewed
@@ -120,10 +120,10 @@ interface IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getRecentlyViewed(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    getRecentlyViewed(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get products for repeat purchase.
      * @handleName getRepeatPurchase
@@ -131,10 +131,10 @@ interface IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getRepeatPurchase(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    getRepeatPurchase(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get the block's slides tree as a flat pre-order array (slider_block only).
      * @handleName getSlides
@@ -150,10 +150,10 @@ interface IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getTrending(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    getTrending(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to wishlist" products by the wishlist from context (auth user or guest).
      * @handleName getWishlistSimilar
@@ -161,10 +161,10 @@ interface IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getWishlistSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    getWishlistSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to wishlist" products by an explicit list of productIds (POST body).
      * @handleName getWishlistSimilarByProductIds
@@ -175,10 +175,10 @@ interface IBlocks {
           "productIds": [1, 2],
           "langCode": "en_US"
         }
-     * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getWishlistSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
+    getWishlistSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsResponse | IError>;
 }
 /**
  * Represents a response from the blocks API.

package/dist/blocks/blocksSchemas.d.ts

@@ -53,6 +53,7 @@ export declare const BlockEntitySchema: z.ZodObject<{
             discountConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
         }, z.core.$strip>>;
         total: z.ZodNumber;
+        totalFound: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     countElementsPerRow: z.ZodOptional<z.ZodNumber>;
     quantity: z.ZodOptional<z.ZodNumber>;
@@ -149,6 +150,7 @@ export declare const BlocksResponseSchema: z.ZodObject<{
                 discountConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
             }, z.core.$strip>>;
             total: z.ZodNumber;
+            totalFound: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
         countElementsPerRow: z.ZodOptional<z.ZodNumber>;
         quantity: z.ZodOptional<z.ZodNumber>;

package/dist/discounts/discountsInterfaces.d.ts

@@ -88,7 +88,7 @@ interface IDiscountCondition {
  * Represents a discount entity.
  * @interface IDiscountsEntity
  * @property {number} id - The unique identifier of the discount.
- * @property {number} [attributeSetId] - The identifier of the discount.
+ * @property {number | null} [attributeSetId] - The identifier of the attribute set linked to the discount, or `null` when no set is linked.
  * @property {ILocalizeInfo} [localizeInfos] - The name of the discount.
  * @property {number} [version] - The version of the discount.
  * @property {string} [identifier] - The identifier of the discount.
@@ -111,7 +111,7 @@ interface IDiscountCondition {
  */
 interface IDiscountsEntity {
     id: number;
-    attributeSetId?: number;
+    attributeSetId?: number | null;
     localizeInfos?: ILocalizeInfo;
     version?: number;
     identifier?: string;
@@ -137,14 +137,14 @@ interface IDiscountsEntity {
  * @property {'TO_PRODUCT' | 'TO_ORDER'} applicability - What the discount applies to. Example: "TO_PRODUCT".
  * @property {'FIXED_AMOUNT' | 'PERCENT'} discountType - How the discount value is interpreted. Example: "FIXED_AMOUNT".
  * @property {number} value - Discount amount (currency units for FIXED_AMOUNT, percentage points for PERCENT). Example: 10.
- * @property {number} [maxAmount] - Optional cap on the absolute discount applied. Example: 5.
+ * @property {number | null} [maxAmount] - Cap on the absolute discount applied, or `null` when uncapped. Example: 5.
  * @description Configuration of the discount calculation.
  */
 interface IDiscountValue {
     applicability: 'TO_PRODUCT' | 'TO_ORDER';
     discountType: 'FIXED_AMOUNT' | 'PERCENT';
     value: number;
-    maxAmount?: number;
+    maxAmount?: number | null;
 }
 /**
  * @interface ICouponEntity

package/dist/events/eventsApi.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 { IContentApiEvent, IEvents, IListFormSubscription, ISubscribeFormEvent, ISubscriptions } from './eventsInterfaces';
+import type { IContentApiEvent, IEvents, IFormSubscriptionsResponse, ISubscribeFormEvent, ISubscriptions } from './eventsInterfaces';
 /**
  * Controllers for working with events
  * @handle /api/content/events
@@ -86,13 +86,13 @@ export default class EventsApi extends AsyncModules implements IEvents {
      * @handleName getFormSubscriptions
      * @param {number} [offset] - Optional offset for pagination. Default: 0.
      * @param {number} [limit] - Optional limit for pagination. Default: 30.
-     * @returns {Promise<IListFormSubscription[] | IError>} Returns an array of form subscriptions.
+     * @returns {Promise<IFormSubscriptionsResponse | IError>} Returns an object with an array of form subscriptions and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      * @see {@link https://js-sdk.oneentry.cloud/docs/events/getFormSubscriptions getFormSubscriptions} documentation.
      */
-    getFormSubscriptions(offset?: number, limit?: number): Promise<IListFormSubscription[] | IError>;
+    getFormSubscriptions(offset?: number, limit?: number): Promise<IFormSubscriptionsResponse | IError>;
     /**
      * Unsubscribe from form notifications by marker.
      * @handleName unsubscribeFromForm

package/dist/events/eventsApi.js

@@ -115,7 +115,7 @@ class EventsApi extends asyncModules_1.default {
      * @handleName getFormSubscriptions
      * @param {number} [offset] - Optional offset for pagination. Default: 0.
      * @param {number} [limit] - Optional limit for pagination. Default: 30.
-     * @returns {Promise<IListFormSubscription[] | IError>} Returns an array of form subscriptions.
+     * @returns {Promise<IFormSubscriptionsResponse | IError>} Returns an object with an array of form subscriptions and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.

package/dist/events/eventsInterfaces.d.ts

@@ -61,12 +61,12 @@ interface IEvents {
      * @handleName getFormSubscriptions
      * @param {number} [offset] - Optional offset for pagination. Default: 0.
      * @param {number} [limit] - Optional limit for pagination. Default: 30.
-     * @returns {Promise<IListFormSubscription[] | IError>} A promise that resolves to an array of form subscriptions or an error.
+     * @returns {Promise<IFormSubscriptionsResponse | IError>} A promise that resolves to an object with an array of form subscriptions and total count, or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method returns all form subscriptions. This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
-    getFormSubscriptions(offset?: number, limit?: number): Promise<IListFormSubscription[] | IError>;
+    getFormSubscriptions(offset?: number, limit?: number): Promise<IFormSubscriptionsResponse | IError>;
     /**
      * Unsubscribe from form notifications by marker.
      * @handleName unsubscribeFromForm
@@ -131,14 +131,14 @@ interface ISubscribeBody {
  * @property {number} id - Event identifier. Example: 1.
  * @property {string} identifier - Event text identifier. Example: "price_change".
  * @property {Record<string, unknown>} localizeInfos - Localized info of the event.
- * @property {string} module - Module the event belongs to. Example: "catalog".
+ * @property {string} [module] - Module the event belongs to; absent on system events not bound to a module (e.g. "send_code"). Example: "catalog".
  * @description Represents a single available event.
  */
 interface IContentApiEvent {
     id: number;
     identifier: string;
     localizeInfos: Record<string, unknown>;
-    module: string;
+    module?: string;
 }
 /**
  * Represents a form subscription item.
@@ -151,6 +151,17 @@ interface IListFormSubscription {
     eventMarker: string;
     formDataId: number;
 }
+/**
+ * Represents the response of the form subscriptions list endpoint.
+ * @interface IFormSubscriptionsResponse
+ * @property {IListFormSubscription[]} items - Array of form subscriptions.
+ * @property {number} total - Total number of subscriptions. Example: 0.
+ * @description Container returned by `getFormSubscriptions`.
+ */
+interface IFormSubscriptionsResponse {
+    items: IListFormSubscription[];
+    total: number;
+}
 /**
  * Body for subscribing to / unsubscribing from a form event.
  * @interface ISubscribeFormEvent
@@ -162,4 +173,4 @@ interface ISubscribeFormEvent {
     formDataId: number;
     status?: string;
 }
-export type { IContentApiEvent, IEvents, IListFormSubscription, ISubscribeBody, ISubscribeFormEvent, ISubscriptions, };
+export type { IContentApiEvent, IEvents, IFormSubscriptionsResponse, IListFormSubscription, ISubscribeBody, ISubscribeFormEvent, ISubscriptions, };

package/dist/forms/formsApi.js

@@ -38,7 +38,7 @@ class FormsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`?langCode=${langCode}&offset=${offset}&limit=${limit}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, formsSchemas_1.FormsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Get one form by form marker.
@@ -53,7 +53,7 @@ class FormsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, formsSchemas_1.FormEntitySchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
 }
 exports.default = FormsApi;

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`. The API returns an empty object for forms with no attributes — the SDK normalizes it to an empty array.
  * @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.
@@ -92,15 +92,17 @@ interface IFormsEntity {
 }
 /**
  * @interface IFormLocalizeInfo
+ * @property {string} [title] - Localized name of the form. Optional — the payload is an empty object when the form has no localization for the requested language (e.g. in list responses). Example: "Contact form".
  * @property {string} [titleForSite] - Public-facing title shown on the website. Example: "Form title (for application)".
  * @property {string} [successMessage] - Message shown to the user after successful submission.
  * @property {string} [unsuccessMessage] - Message shown to the user after a failed submission.
  * @property {string} [urlAddress] - URL where the form data is sent for processing (used by `processingType: "url"`).
  * @property {string} [database] - Database flag/id used by the form processor (stringly-typed in the API: "0" / "1" / id).
  * @property {string} [script] - Script flag/id used by the form processor (stringly-typed in the API: "0" / "1" / id).
- * @description Localization payload of a form — extends {@link ILocalizeInfo} with form-side fields (messages, processing config).
+ * @description Localization payload of a form — extends {@link ILocalizeInfo} with form-side fields (messages, processing config). Unlike the base type, `title` is optional here.
  */
-interface IFormLocalizeInfo extends ILocalizeInfo {
+interface IFormLocalizeInfo extends Omit<ILocalizeInfo, 'title'> {
+    title?: string;
     titleForSite?: string;
     successMessage?: string;
     unsuccessMessage?: string;
@@ -120,14 +122,14 @@ interface IFormLocalizeInfo extends ILocalizeInfo {
  * @property {IAttributeValidators} validators - Validation rules; empty object when no validators are configured.
  * @property {Record<string, unknown>} settings - Field-specific configuration; empty object by default.
  * @property {Record<string, IFormAttributeAdditionalField>} additionalFields - Nested sub-fields keyed by marker; empty object when none.
- * @property {boolean} isLogin - Whether this field carries the login value used for authentication. Example: false.
- * @property {boolean} isSignUp - Whether this field is required during sign-up. Example: false.
- * @property {boolean} isPassword - Whether this field carries the password value used for authentication. Example: false.
- * @property {boolean} isSignUpRequired - Whether this field is required during sign-up. Example: false.
- * @property {boolean} isNotificationEmail - Whether this field stores the email used for notifications. Example: false.
- * @property {boolean} isNotificationPhonePush - Whether this field stores the phone number used for push notifications. Example: false.
- * @property {boolean} isNotificationPhoneSMS - Whether this field stores the phone number used for SMS notifications. Example: false.
- * @description Definition of a single field inside a form — extends a generic attribute with form-specific authentication / notification flags.
+ * @property {boolean} [isLogin] - Whether this field carries the login value used for authentication. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isSignUp] - Whether this field is required during sign-up. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isPassword] - Whether this field carries the password value used for authentication. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isSignUpRequired] - Whether this field is required during sign-up. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isNotificationEmail] - Whether this field stores the email used for notifications. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isNotificationPhonePush] - Whether this field stores the phone number used for push notifications. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @property {boolean} [isNotificationPhoneSMS] - Whether this field stores the phone number used for SMS notifications. Optional — present only on attributes of sign-in/sign-up forms. Example: false.
+ * @description Definition of a single field inside a form — extends a generic attribute with form-specific authentication / notification flags (returned only for sign-in/sign-up forms).
  */
 interface IFormAttribute {
     marker: string;
@@ -140,24 +142,24 @@ interface IFormAttribute {
     validators: IAttributeValidators;
     settings: Record<string, unknown>;
     additionalFields: Record<string, IFormAttributeAdditionalField>;
-    isLogin: boolean;
-    isSignUp: boolean;
-    isPassword: boolean;
-    isSignUpRequired: boolean;
-    isNotificationEmail: boolean;
-    isNotificationPhonePush: boolean;
-    isNotificationPhoneSMS: boolean;
+    isLogin?: boolean;
+    isSignUp?: boolean;
+    isPassword?: boolean;
+    isSignUpRequired?: boolean;
+    isNotificationEmail?: boolean;
+    isNotificationPhonePush?: boolean;
+    isNotificationPhoneSMS?: boolean;
     [key: string]: unknown;
 }
 /**
  * @interface IFormAttributeAdditionalField
- * @property {string} marker - Marker of the additional field. Example: "additional_field".
+ * @property {string} [marker] - Marker of the additional field. Optional — the API returns entries as `{ type, value }`, the marker itself is the key of the `additionalFields` map. 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 {
-    marker: string;
+    marker?: string;
     type: string;
     value: unknown;
 }

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

@@ -314,9 +314,10 @@ interface IOrderProductsData {
       }
     ]
  * @property {string} currency - Currency used to pay for the order. Example: "USD".
- * @property {string} totalSum - Total order amount. Example: "150".
+ * @property {number} 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.
@@ -331,9 +332,10 @@ interface IBaseOrdersEntity {
     formData: IOrdersFormData[];
     products: IOrderProductsData[];
     currency: string;
-    totalSum: string;
+    totalSum: number;
     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;
 }
@@ -598,10 +608,14 @@ interface IOrderByMarkerEntity {
  * @interface IOrderStatus
  * @property {number} [id] - Status identifier. Example: 1.
  * @property {ILocalizeInfo} [localizeInfos] - Localized information for the status.
- * @property {string} [identifier] - Text identifier of the status. Example: "inProgress".
+ * @property {string} [identifier] - Text identifier of the status. Example: "inProgress-payment".
  * @property {number} [position] - Position of the status. Example: 1.
  * @property {boolean} [isUsed] - Whether the status is in use. Example: true.
  * @property {boolean} [isDefault] - Whether the status is the default status. Example: true.
+ * @property {string} [axis] - Status axis (pipeline) the status belongs to. Example: "payment".
+ * @property {boolean} [isCancelFinal] - Whether the status is a final cancellation status. Example: false.
+ * @property {boolean} [isFinalSuccess] - Whether the status is a final successful status. Example: true.
+ * @property {boolean} [isMapped] - Whether the status is mapped to its axis. Example: true.
  */
 interface IOrderStatus {
     id?: number;
@@ -610,6 +624,10 @@ interface IOrderStatus {
     position?: number;
     isUsed?: boolean;
     isDefault?: boolean;
+    axis?: string;
+    isCancelFinal?: boolean;
+    isFinalSuccess?: boolean;
+    isMapped?: boolean;
 }
 /**
  * Interface representing a product in an order preview.