oneentry 1.0.150 → 1.0.152

package/changelog.md

@@ -1,5 +1,35 @@
 # SDK Change Log
 
+## v.1.0.152
+
+### Bug Fixes
+
+- Auth — eliminated the spurious `401` logged on every page load for a valid restored session. `browserResponse` now does a **proactive refresh** when a refresh token is present but there is no access token yet: it fetches the access token *before* the first request (clean `200`) instead of sending an unauthenticated request that is guaranteed to `401` and then reactively refreshing. After the proactive refresh it attaches `Authorization` and drops the `x-guest-id` scoping. The reactive `401 → refresh → retry` path is retained for mid-session token expiry.
+
+- Auth — `refreshToken` is now **single-flight**.
+
+## v.1.0.151
+
+### What's New
+
+- Pages > `PageType` — new page-specific type union (`'catalog_page' | 'common_page' | 'error_page' | 'external_page'`), a page subset of `BlockType`.
+
+- Orders > `IOrderSplit`, `IOrderSplitStage` — new interfaces describing the split (staged) payment configuration returned by the by-id order endpoint.
+
+### What's Changed
+
+- Pages > `IPagesEntity.type` — now typed as the page-specific `PageType` instead of the broad `BlockType` (the value set is unchanged, just narrowed semantically). The page Zod schema validates `type` against the same set.
+
+- Pages > `IPagesEntity.categoryPath` — now `string | null` (was `string`); the API returns `null` for nested pages. Page Zod schema relaxed to `z.string().nullable().optional()`.
+
+- FormsData > `IPostFormResponseData.fingerprint` — now `string | null` (was `string`); anonymous / app-token submissions return `null`. `PostFormResponseSchema` relaxed to `z.string().nullable()` (previously rejected the real response under strict validation).
+
+- Orders > `IOrderDiscountConfig.bonus` — now optional (`bonus?`); the API omits the key entirely on orders without a bonus context (previously failed validation when embedded in create/update order responses).
+
+- Orders > `IOrderByMarkerEntity` — now exposes `discountConfig` (`IOrderDiscountConfig | null`), `totalSumRaw`, `isPartial` (`boolean | null`), `paymentStrategy`, and `split`; these fields are returned by the API and were previously stripped from the validated result. `OrderEntitySchema` extended accordingly, and `IOrderDiscountSettings` / `OrderDiscountConfigSchema.settings` gained `giftRefundPolicy`, `maxBonusPaymentPercent`, `minBonusAmount`, `minOrderAmountForBonus`.
+
+- FileUploading > `IUploadingReturn.contentType` — added (the upload endpoint always returns the file MIME type); `UploadingReturnSchema` extended with `contentType: z.string()`.
+
 ## v.1.0.150
 
 ### What's New

package/dist/base/asyncModules.d.ts

@@ -57,11 +57,17 @@ export default abstract class AsyncModules extends SyncModules {
      */
     protected _fetchDelete<T = unknown>(path: string, body?: unknown): Promise<T>;
     /**
-     * Refreshes the authentication token.
+     * Refreshes the authentication token (single-flight).
      * @returns {Promise<boolean>} A promise resolving to a boolean indicating success or failure.
-     * @description Define an asynchronous method 'refreshToken' that attempts to refresh the authentication token
+     * @description De-duplicates concurrent refreshes — the refresh token is single-use, so parallel requests must share one refresh call instead of each burning a rotated token.
      */
     protected refreshToken(): Promise<boolean>;
+    /**
+     * Performs the actual token refresh request (without de-duplication).
+     * @returns {Promise<boolean>} A promise resolving to a boolean indicating success or failure.
+     * @description Sends POST /users/refresh and, on success, stores the rotated access/refresh tokens and calls saveFunction.
+     */
+    private _performRefresh;
     /**
      * Creates options for HTTP requests.
      * @param {string} method - The HTTP method (GET, POST, PUT, DELETE, etc.).

package/dist/base/asyncModules.js

@@ -282,11 +282,33 @@ class AsyncModules extends syncModules_1.default {
         }
     }
     /**
-     * Refreshes the authentication token.
+     * Refreshes the authentication token (single-flight).
      * @returns {Promise<boolean>} A promise resolving to a boolean indicating success or failure.
-     * @description Define an asynchronous method 'refreshToken' that attempts to refresh the authentication token
+     * @description De-duplicates concurrent refreshes — the refresh token is single-use, so parallel requests must share one refresh call instead of each burning a rotated token.
      */
     async refreshToken() {
+        // Reuse an in-flight refresh if one is already running (shared via state
+        // across all module instances). Prevents parallel requests from each firing
+        // their own refresh and invalidating the single-use refresh token.
+        if (this.state._refreshPromise) {
+            return this.state._refreshPromise;
+        }
+        const promise = this._performRefresh();
+        this.state._refreshPromise = promise;
+        try {
+            return await promise;
+        }
+        finally {
+            // Clear so the next genuine 401 (e.g. mid-session expiry) can refresh again.
+            this.state._refreshPromise = null;
+        }
+    }
+    /**
+     * Performs the actual token refresh request (without de-duplication).
+     * @returns {Promise<boolean>} A promise resolving to a boolean indicating success or failure.
+     * @description Sends POST /users/refresh and, on success, stores the rotated access/refresh tokens and calls saveFunction.
+     */
+    async _performRefresh() {
         const url = this.state.url +
             `/api/content/users-auth-providers/marker/` +
             this.state.providerMarker +
@@ -396,7 +418,32 @@ class AsyncModules extends syncModules_1.default {
      * @description Define an asynchronous method 'browserResponse' that takes a path and options as parameters
      */
     async browserResponse(path, options) {
+        // Set when a proactive refresh ran and failed (dead/expired refresh token):
+        // used below to skip the reactive refresh so we don't fire a second,
+        // equally-doomed refresh on the 401 that the request is about to return.
+        let proactiveRefreshFailed = false;
         try {
+            // Proactive (eager) refresh: a session restored from storage has a refresh
+            // token but no access token yet. Sending the first authenticated request
+            // without an access token GUARANTEES a 401 (then a reactive refresh + retry)
+            // — a spurious 401 logged on every page load even for a perfectly valid
+            // session. Obtaining the access token up-front turns that into a clean 200.
+            // Fires at most once per session (skipped once accessToken is set), and is
+            // off for custom-auth callers who manage tokens themselves.
+            if (!this.state.accessToken &&
+                this.state.refreshToken &&
+                !this.state.customAuth) {
+                const refreshed = await this.refreshToken();
+                if (refreshed) {
+                    // Authenticated now — attach the bearer and drop the guest scoping
+                    // that makeOptions added while no access token was present.
+                    options.headers['Authorization'] = 'Bearer ' + this.state.accessToken;
+                    delete options.headers['x-guest-id'];
+                }
+                else {
+                    proactiveRefreshFailed = true;
+                }
+            }
             // Perform a fetch request using the full URL obtained from '_getFullPath' and the provided options
             const response = await fetch(this._getFullPath(path), options);
             // Check if the response status is OK (status code 200-299)
@@ -415,8 +462,12 @@ class AsyncModules extends syncModules_1.default {
             }
             else {
                 // Handle non-OK responses
-                // Check if the status is 401 (Unauthorized) and custom authentication is not used
-                if (response.status === 401 && !this.state.customAuth) {
+                // Reactive refresh for mid-session expiry: access token was present but
+                // the server rejected it. Skipped when a proactive refresh already ran
+                // and failed (the refresh token is dead — retrying would 400 again).
+                if (response.status === 401 &&
+                    !this.state.customAuth &&
+                    !proactiveRefreshFailed) {
                     // Attempt to refresh the access token
                     const refresh = await this.refreshToken();
                     if (refresh) {

package/dist/base/stateModule.d.ts

@@ -11,6 +11,7 @@ export default class StateModule {
     accessToken: string | undefined;
     traficLimit: boolean;
     refreshToken: string | undefined;
+    _refreshPromise: Promise<boolean> | null;
     providerMarker: string;
     customAuth: boolean;
     _NO_FETCH: boolean;

package/dist/base/stateModule.js

@@ -46,6 +46,10 @@ class StateModule {
      */
     constructor(url, config) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1;
+        // In-flight token refresh, shared across all module instances (they share this
+        // state object). De-duplicates concurrent refreshes so the single-use refresh
+        // token is not burned by parallel requests. Null when no refresh is running.
+        this._refreshPromise = null;
         this.url = url;
         this.lang = (_a = config.langCode) !== null && _a !== void 0 ? _a : 'en_US';
         this.token = config.token;

package/dist/blocks/blocksApi.d.ts

@@ -21,7 +21,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get blocks by parameters.
      * @handleName getBlocks
-     * @param {BlockType} type - Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "form" | "common_page" | "common_block" | "order" | "service" | "none". Example: 'product'.
+     * @param {BlockType} [type] - Optional block type to filter by. Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "form" | "common_page" | "common_block" | "order" | "service" | "none". When omitted, blocks of all types are returned. Example: 'product'.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
@@ -100,7 +100,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * Get "complete your cart" products by an explicit list of productIds (POST body).
      * @handleName getCartComplementByProductIds
      * @param {string} marker - Block marker. Example: "cart_complement_block".
-     * @param {IBlockProductsLookup} body - Lookup body. Example: `{ productIds: [1, 2], langCode: "en_US" }`.
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
@@ -119,7 +124,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * Get "similar to cart" products by an explicit list of productIds (POST body).
      * @handleName getCartSimilarByProductIds
      * @param {string} marker - Block marker. Example: "cart_similar_block".
-     * @param {IBlockProductsLookup} body - Lookup body. Example: `{ productIds: [1, 2], langCode: "en_US" }`.
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
@@ -186,7 +196,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * Get "similar to wishlist" products by an explicit list of productIds (POST body).
      * @handleName getWishlistSimilarByProductIds
      * @param {string} marker - Block marker. Example: "wishlist_similar_block".
-     * @param {IBlockProductsLookup} body - Lookup body. Example: `{ productIds: [1, 2], langCode: "en_US" }`.
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */

package/dist/blocks/blocksApi.js

@@ -25,15 +25,18 @@ class BlocksApi extends asyncModules_1.default {
     /**
      * Get blocks by parameters.
      * @handleName getBlocks
-     * @param {BlockType} type - Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "form" | "common_page" | "common_block" | "order" | "service" | "none". Example: 'product'.
+     * @param {BlockType} [type] - Optional block type to filter by. Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "form" | "common_page" | "common_block" | "order" | "service" | "none". When omitted, blocks of all types are returned. Example: 'product'.
      * @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<IBlocksResponse | IError>} Returns BlocksEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
-    async getBlocks(type = '', langCode = this.state.lang, offset = 0, limit = 30) {
-        const response = await this._fetchPost(`?langCode=${langCode}&type=${type}&offset=${offset}&limit=${limit}`);
+    async getBlocks(type, langCode = this.state.lang, offset = 0, limit = 30) {
+        // type is omitted from the query when not provided — the API rejects an
+        // empty type value, so it must not be sent at all.
+        const query = this._queryParamsToString({ langCode, type, offset, limit });
+        const response = await this._fetchPost(`?${query}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(response, blocksSchemas_1.BlocksResponseSchema);
         if (!this.state.traficLimit) {
@@ -223,7 +226,12 @@ class BlocksApi extends asyncModules_1.default {
      * Get "complete your cart" products by an explicit list of productIds (POST body).
      * @handleName getCartComplementByProductIds
      * @param {string} marker - Block marker. Example: "cart_complement_block".
-     * @param {IBlockProductsLookup} body - Lookup body. Example: `{ productIds: [1, 2], langCode: "en_US" }`.
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
@@ -249,7 +257,12 @@ class BlocksApi extends asyncModules_1.default {
      * Get "similar to cart" products by an explicit list of productIds (POST body).
      * @handleName getCartSimilarByProductIds
      * @param {string} marker - Block marker. Example: "cart_similar_block".
-     * @param {IBlockProductsLookup} body - Lookup body. Example: `{ productIds: [1, 2], langCode: "en_US" }`.
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
@@ -342,7 +355,12 @@ class BlocksApi extends asyncModules_1.default {
      * Get "similar to wishlist" products by an explicit list of productIds (POST body).
      * @handleName getWishlistSimilarByProductIds
      * @param {string} marker - Block marker. Example: "wishlist_similar_block".
-     * @param {IBlockProductsLookup} body - Lookup body. Example: `{ productIds: [1, 2], langCode: "en_US" }`.
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */

package/dist/blocks/blocksInterfaces.d.ts

@@ -9,7 +9,7 @@ interface IBlocks {
     /**
      * Retrieves all block objects of a specific type.
      * @handleName getBlocks
-     * @param {BlockType} type - The type of blocks to retrieve. Example: "product".
+     * @param {BlockType} [type] - Optional type of blocks to retrieve. When omitted, blocks of all types are returned. Example: "product".
      * @param {string} [langCode] - Optional language code for localization. Default: "en_US".
      * @param {number} [offset] - Optional offset for pagination. Default: 0.
      * @param {number} [limit] - Optional limit for pagination. Default: 30.
@@ -17,7 +17,7 @@ interface IBlocks {
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method retrieves all block objects of a specific type.
      */
-    getBlocks(type: BlockType, langCode?: string, offset?: number, limit?: number): Promise<IBlocksResponse | IError>;
+    getBlocks(type?: BlockType, langCode?: string, offset?: number, limit?: number): Promise<IBlocksResponse | IError>;
     /**
      * Retrieves a block object by its marker.
      * @handleName getBlockByMarker
@@ -65,7 +65,12 @@ interface IBlocks {
      * Get "complete your cart" products by an explicit list of productIds (POST body).
      * @handleName getCartComplementByProductIds
      * @param {string} marker - Block marker. Example: "cart_complement_block".
-     * @param {IBlockProductsLookup} body - Lookup body. Example: `{ productIds: [1, 2], langCode: "en_US" }`.
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -84,7 +89,12 @@ interface IBlocks {
      * Get "similar to cart" products by an explicit list of productIds (POST body).
      * @handleName getCartSimilarByProductIds
      * @param {string} marker - Block marker. Example: "cart_similar_block".
-     * @param {IBlockProductsLookup} body - Lookup body. Example: `{ productIds: [1, 2], langCode: "en_US" }`.
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -151,7 +161,12 @@ interface IBlocks {
      * Get "similar to wishlist" products by an explicit list of productIds (POST body).
      * @handleName getWishlistSimilarByProductIds
      * @param {string} marker - Block marker. Example: "wishlist_similar_block".
-     * @param {IBlockProductsLookup} body - Lookup body. Example: `{ productIds: [1, 2], langCode: "en_US" }`.
+     * @param {IBlockProductsLookup} body - Lookup body.
+     * @example
+        {
+          "productIds": [1, 2],
+          "langCode": "en_US"
+        }
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */

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

@@ -104,11 +104,13 @@ interface IUploadingQuery {
  * @property {string} filename - Filename with relative path. Example: "uploads/file.png".
  * @property {string} downloadLink - Link for downloading the file. Example: "https://example.com/uploads/file.png".
  * @property {number} size - Size of the file in bytes. Example: 1024.
+ * @property {string} contentType - MIME type of the uploaded file. Example: "image/png".
  * @description Represents the return value of an uploading operation, including the filename, download link, and file size.
  */
 interface IUploadingReturn {
     filename: string;
     downloadLink: string;
     size: number;
+    contentType: string;
 }
 export type { IFileEntity, IFileUploading, IUploadingQuery, IUploadingReturn };

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

@@ -11,6 +11,7 @@ export declare const UploadingReturnSchema: z.ZodObject<{
     filename: z.ZodString;
     downloadLink: z.ZodString;
     size: z.ZodNumber;
+    contentType: z.ZodString;
 }, z.core.$strip>;
 /**
  * Upload response schema (array of upload results)
@@ -19,4 +20,5 @@ export declare const UploadResponseSchema: z.ZodArray<z.ZodObject<{
     filename: z.ZodString;
     downloadLink: z.ZodString;
     size: z.ZodNumber;
+    contentType: z.ZodString;
 }, z.core.$strip>>;

package/dist/file-uploading/fileUploadingSchemas.js

@@ -14,6 +14,7 @@ exports.UploadingReturnSchema = zod_1.z.object({
     filename: zod_1.z.string(),
     downloadLink: zod_1.z.string(),
     size: zod_1.z.number(),
+    contentType: zod_1.z.string(),
 });
 /**
  * Upload response schema (array of upload results)

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

@@ -253,7 +253,7 @@ interface IPostFormResponse {
  * @property {string} formIdentifier - Identifier of the form. Example: "contact_form".
  * @property {string} time - Time of submission. Example: "2023-10-01T12:00:00Z".
  * @property {string} entityIdentifier - Identifier of the entity the form is attached to. Example: "blog".
- * @property {string} fingerprint - Submission fingerprint.
+ * @property {string | null} fingerprint - Submission fingerprint, or null for anonymous / app-token submissions.
  * @property {boolean} isUserAdmin - Whether the submitting user is an administrator. Example: false.
  * @property {number} formModuleId - Form module configuration identifier. Example: 2.
  * @property {string | null} userIdentifier - Identifier of the submitting user, or null when anonymous.
@@ -266,7 +266,7 @@ interface IPostFormResponseData {
     formIdentifier: string;
     time: string;
     entityIdentifier: string;
-    fingerprint: string;
+    fingerprint: string | null;
     isUserAdmin: boolean;
     formModuleId: number;
     userIdentifier: string | null;

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

@@ -74,7 +74,7 @@ export declare const PostFormResponseSchema: z.ZodObject<{
         formIdentifier: z.ZodString;
         time: z.ZodString;
         entityIdentifier: z.ZodString;
-        fingerprint: z.ZodString;
+        fingerprint: z.ZodNullable<z.ZodString>;
         isUserAdmin: z.ZodBoolean;
         formModuleId: z.ZodNumber;
         userIdentifier: z.ZodNullable<z.ZodString>;

package/dist/forms-data/formsDataSchemas.js

@@ -58,7 +58,7 @@ exports.PostFormResponseSchema = zod_1.z.object({
         formIdentifier: zod_1.z.string(),
         time: zod_1.z.string(),
         entityIdentifier: zod_1.z.string(),
-        fingerprint: zod_1.z.string(),
+        fingerprint: zod_1.z.string().nullable(),
         isUserAdmin: zod_1.z.boolean(),
         formModuleId: zod_1.z.number(),
         userIdentifier: zod_1.z.string().nullable(),

package/dist/orders/ordersInterfaces.d.ts

@@ -359,16 +359,24 @@ interface IOrderDiscountBonus {
  * @property {boolean} allowGiftStacking - Whether multiple gift discounts can be combined. Example: false.
  * @property {boolean} allowStacking - Whether multiple non-gift discounts can be combined. Example: false.
  * @property {number | null} maxDiscountValue - Hard cap on total discount value, or null if uncapped. Example: null.
+ * @property {string} [giftRefundPolicy] - Refund policy applied to gift products (present on newer orders). Example: "refund".
+ * @property {number | null} [maxBonusPaymentPercent] - Maximum share of the order payable with bonuses, or null if uncapped (present on newer orders).
+ * @property {number | null} [minBonusAmount] - Minimum bonus amount required to apply bonuses, or null when not configured (present on newer orders).
+ * @property {number | null} [minOrderAmountForBonus] - Minimum order amount required to earn/spend bonuses, or null when not configured (present on newer orders).
  * @description Stacking and cap settings for the order discount engine.
  */
 interface IOrderDiscountSettings {
     allowGiftStacking: boolean;
     allowStacking: boolean;
     maxDiscountValue: number | null;
+    giftRefundPolicy?: string;
+    maxBonusPaymentPercent?: number | null;
+    minBonusAmount?: number | null;
+    minOrderAmountForBonus?: number | null;
 }
 /**
  * @interface IOrderDiscountConfig
- * @property {IOrderDiscountBonus | null} bonus - Bonus calculation result, or null when bonuses are not used.
+ * @property {IOrderDiscountBonus | null} [bonus] - Bonus calculation result, null when bonuses are not used, or omitted entirely when the order has no bonus context.
  * @property {unknown | null} coupon - Resolved coupon, or null when no coupon is applied.
  * @property {unknown[]} orderDiscounts - Order-level discounts that were matched and applied.
  * @property {unknown[]} productDiscounts - Product-level discounts that were matched and applied.
@@ -382,7 +390,7 @@ interface IOrderDiscountSettings {
  * @description Resolved discount configuration returned alongside an order or order preview. Preview responses include only the calculation inputs (bonus, coupon, orderDiscounts, productDiscounts, settings); created/updated orders also carry the totals and applied markers.
  */
 interface IOrderDiscountConfig {
-    bonus: IOrderDiscountBonus | null;
+    bonus?: IOrderDiscountBonus | null;
     coupon: unknown | null;
     orderDiscounts: unknown[];
     productDiscounts: unknown[];
@@ -485,6 +493,36 @@ interface IOrderData {
     additionalDiscountsMarkers?: string[];
     bonusAmount?: number;
 }
+/**
+ * @interface IOrderSplitStage
+ * @property {string} marker - Stage marker. Example: "stage-1".
+ * @property {string | null} sessionId - Payment session identifier for the stage, or null when not yet started. Example: null.
+ * @property {number} productId - Identifier of the product covered by the stage. Example: 1.
+ * @property {string} title - Stage title. Example: "Deposit".
+ * @property {number} value - Stage amount. Example: 100.
+ * @property {string} status - Stage status. Example: "pending".
+ * @description A single stage of a split (staged) order payment.
+ */
+interface IOrderSplitStage {
+    marker: string;
+    sessionId: string | null;
+    productId: number;
+    title: string;
+    value: number;
+    status: string;
+}
+/**
+ * @interface IOrderSplit
+ * @property {boolean} completed - Whether all split stages are completed. Example: false.
+ * @property {boolean} partial - Whether the split is partially paid. Example: false.
+ * @property {IOrderSplitStage[]} stages - Ordered list of split payment stages.
+ * @description Split (staged) payment configuration of an order; returned by the by-id order endpoint.
+ */
+interface IOrderSplit {
+    completed: boolean;
+    partial: boolean;
+    stages: IOrderSplitStage[];
+}
 /**
  * Interface representing an order product data.
  * @interface IOrderByMarkerEntity
@@ -504,6 +542,7 @@ interface IOrderData {
     ]
  * @property {string | null} [attributeSetIdentifier] - Text identifier of the attribute set. Example: "attribute-set-1".
  * @property {string} totalSum - Total order amount. Example: "100.00".
+ * @property {string} [totalSumRaw] - Raw total order amount with full precision. Example: "100.00".
  * @property {string} currency - Currency used to pay for the order. Example: "USD".
  * @property {string | null} [paymentAccountIdentifier] - Textual identifier for the order payment. Example: "payment-1".
  * @property {ILocalizeInfo} [paymentAccountLocalizeInfos] - Payment account name considering localization.
@@ -522,7 +561,11 @@ interface IOrderData {
     ]
  * @property {string | null} paymentUrl - Payment link. Example: "https://example.com/pay/123".
  * @property {boolean | null} isCompleted - Indicates that the order has been completed. Example: true.
+ * @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 {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.
  */
 interface IOrderByMarkerEntity {
@@ -534,13 +577,18 @@ interface IOrderByMarkerEntity {
     formData: IOrdersFormData[];
     attributeSetIdentifier?: string;
     totalSum: string;
+    totalSumRaw?: string;
     currency: string;
     paymentAccountIdentifier?: string;
     paymentAccountLocalizeInfos?: ILocalizeInfo;
     paymentUrl: string | null;
     products: IOrderProducts[];
     isCompleted: boolean | null;
+    isPartial?: boolean | null;
+    paymentStrategy?: string;
     statusLocalizeInfos?: ILocalizeInfo;
+    discountConfig?: IOrderDiscountConfig | null;
+    split?: IOrderSplit;
 }
 /**
  * Interface representing an order status object.
@@ -665,4 +713,4 @@ interface ICreateRefundRequest {
     products: Record<string, IRefundProduct>;
     note?: string;
 }
-export type { IBaseOrdersEntity, IBaseOrdersEntityResponse, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderDiscountBonus, IOrderDiscountConfig, IOrderDiscountSettings, IOrderPreviewItem, IOrderPreviewResponse, IOrderProductData, IOrderProducts, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrdersFormData, IOrderStatus, IPaymentAccountIdentifiers, IPicture, IPreviewOrderProduct, IRefundProduct, IRefundRequest, };
+export type { IBaseOrdersEntity, IBaseOrdersEntityResponse, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderDiscountBonus, IOrderDiscountConfig, IOrderDiscountSettings, IOrderPreviewItem, IOrderPreviewResponse, IOrderProductData, IOrderProducts, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrdersFormData, IOrderSplit, IOrderSplitStage, IOrderStatus, IPaymentAccountIdentifiers, IPicture, IPreviewOrderProduct, IRefundProduct, IRefundRequest, };

package/dist/orders/ordersSchemas.d.ts

@@ -15,6 +15,37 @@ export declare const OrderItemSchema: z.ZodObject<{
     total: z.ZodNumber;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, z.core.$strip>;
+/**
+ * Order discount config schema
+ * @description Resolved discount configuration returned with an order or order preview.
+ */
+export declare const OrderDiscountConfigSchema: z.ZodObject<{
+    bonus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        availableBalance: z.ZodNumber;
+        bonusApplied: z.ZodNumber;
+        maxBonusDiscount: z.ZodNumber;
+        minBonusAmount: z.ZodNullable<z.ZodNumber>;
+        minOrderAmountForBonus: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    coupon: z.ZodNullable<z.ZodUnknown>;
+    orderDiscounts: z.ZodArray<z.ZodUnknown>;
+    productDiscounts: z.ZodArray<z.ZodUnknown>;
+    settings: z.ZodObject<{
+        allowGiftStacking: z.ZodBoolean;
+        allowStacking: z.ZodBoolean;
+        maxDiscountValue: z.ZodNullable<z.ZodNumber>;
+        giftRefundPolicy: z.ZodOptional<z.ZodString>;
+        maxBonusPaymentPercent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        minBonusAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        minOrderAmountForBonus: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>;
+    additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    bonusApplied: z.ZodOptional<z.ZodNumber>;
+    excludedGiftProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    totalDue: z.ZodOptional<z.ZodNumber>;
+    totalRaw: z.ZodOptional<z.ZodNumber>;
+    totalSumWithDiscount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
 /**
  * Order entity schema
  * @description Order entity schema for validating orders-related API responses
@@ -28,13 +59,55 @@ export declare const OrderEntitySchema: z.ZodObject<{
     formData: z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>;
     attributeSetIdentifier: z.ZodOptional<z.ZodString>;
     totalSum: z.ZodString;
+    totalSumRaw: z.ZodOptional<z.ZodString>;
     currency: z.ZodString;
     paymentAccountIdentifier: z.ZodOptional<z.ZodString>;
     paymentAccountLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     paymentUrl: z.ZodNullable<z.ZodString>;
     products: z.ZodArray<z.ZodAny>;
     isCompleted: z.ZodNullable<z.ZodBoolean>;
+    isPartial: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    paymentStrategy: z.ZodOptional<z.ZodString>;
     statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    discountConfig: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        bonus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            availableBalance: z.ZodNumber;
+            bonusApplied: z.ZodNumber;
+            maxBonusDiscount: z.ZodNumber;
+            minBonusAmount: z.ZodNullable<z.ZodNumber>;
+            minOrderAmountForBonus: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        coupon: z.ZodNullable<z.ZodUnknown>;
+        orderDiscounts: z.ZodArray<z.ZodUnknown>;
+        productDiscounts: z.ZodArray<z.ZodUnknown>;
+        settings: z.ZodObject<{
+            allowGiftStacking: z.ZodBoolean;
+            allowStacking: z.ZodBoolean;
+            maxDiscountValue: z.ZodNullable<z.ZodNumber>;
+            giftRefundPolicy: z.ZodOptional<z.ZodString>;
+            maxBonusPaymentPercent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            minBonusAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            minOrderAmountForBonus: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>;
+        additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bonusApplied: z.ZodOptional<z.ZodNumber>;
+        excludedGiftProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        totalDue: z.ZodOptional<z.ZodNumber>;
+        totalRaw: z.ZodOptional<z.ZodNumber>;
+        totalSumWithDiscount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    split: z.ZodOptional<z.ZodObject<{
+        completed: z.ZodBoolean;
+        partial: z.ZodBoolean;
+        stages: z.ZodArray<z.ZodObject<{
+            marker: z.ZodString;
+            sessionId: z.ZodNullable<z.ZodString>;
+            productId: z.ZodNumber;
+            title: z.ZodString;
+            value: z.ZodNumber;
+            status: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * Orders list response schema
@@ -50,13 +123,55 @@ export declare const OrdersResponseSchema: z.ZodObject<{
         formData: z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>;
         attributeSetIdentifier: z.ZodOptional<z.ZodString>;
         totalSum: z.ZodString;
+        totalSumRaw: z.ZodOptional<z.ZodString>;
         currency: z.ZodString;
         paymentAccountIdentifier: z.ZodOptional<z.ZodString>;
         paymentAccountLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         paymentUrl: z.ZodNullable<z.ZodString>;
         products: z.ZodArray<z.ZodAny>;
         isCompleted: z.ZodNullable<z.ZodBoolean>;
+        isPartial: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        paymentStrategy: z.ZodOptional<z.ZodString>;
         statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        discountConfig: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            bonus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                availableBalance: z.ZodNumber;
+                bonusApplied: z.ZodNumber;
+                maxBonusDiscount: z.ZodNumber;
+                minBonusAmount: z.ZodNullable<z.ZodNumber>;
+                minOrderAmountForBonus: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            coupon: z.ZodNullable<z.ZodUnknown>;
+            orderDiscounts: z.ZodArray<z.ZodUnknown>;
+            productDiscounts: z.ZodArray<z.ZodUnknown>;
+            settings: z.ZodObject<{
+                allowGiftStacking: z.ZodBoolean;
+                allowStacking: z.ZodBoolean;
+                maxDiscountValue: z.ZodNullable<z.ZodNumber>;
+                giftRefundPolicy: z.ZodOptional<z.ZodString>;
+                maxBonusPaymentPercent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                minBonusAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                minOrderAmountForBonus: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>;
+            additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            bonusApplied: z.ZodOptional<z.ZodNumber>;
+            excludedGiftProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            totalDue: z.ZodOptional<z.ZodNumber>;
+            totalRaw: z.ZodOptional<z.ZodNumber>;
+            totalSumWithDiscount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        split: z.ZodOptional<z.ZodObject<{
+            completed: z.ZodBoolean;
+            partial: z.ZodBoolean;
+            stages: z.ZodArray<z.ZodObject<{
+                marker: z.ZodString;
+                sessionId: z.ZodNullable<z.ZodString>;
+                productId: z.ZodNumber;
+                title: z.ZodString;
+                value: z.ZodNumber;
+                status: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
 }, z.core.$strip>;
@@ -90,33 +205,6 @@ export declare const OrdersStorageResponseSchema: z.ZodArray<z.ZodObject<{
     }, z.core.$strip>>;
     position: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>>;
-/**
- * Order discount config schema
- * @description Resolved discount configuration returned with an order or order preview.
- */
-export declare const OrderDiscountConfigSchema: z.ZodObject<{
-    bonus: z.ZodNullable<z.ZodObject<{
-        availableBalance: z.ZodNumber;
-        bonusApplied: z.ZodNumber;
-        maxBonusDiscount: z.ZodNumber;
-        minBonusAmount: z.ZodNullable<z.ZodNumber>;
-        minOrderAmountForBonus: z.ZodNullable<z.ZodNumber>;
-    }, z.core.$strip>>;
-    coupon: z.ZodNullable<z.ZodUnknown>;
-    orderDiscounts: z.ZodArray<z.ZodUnknown>;
-    productDiscounts: z.ZodArray<z.ZodUnknown>;
-    settings: z.ZodObject<{
-        allowGiftStacking: z.ZodBoolean;
-        allowStacking: z.ZodBoolean;
-        maxDiscountValue: z.ZodNullable<z.ZodNumber>;
-    }, z.core.$strip>;
-    additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    bonusApplied: z.ZodOptional<z.ZodNumber>;
-    excludedGiftProductIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    totalDue: z.ZodOptional<z.ZodNumber>;
-    totalRaw: z.ZodOptional<z.ZodNumber>;
-    totalSumWithDiscount: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
 /**
  * Create order response schema
  * API returns a simplified order object after creation
@@ -135,13 +223,13 @@ export declare const CreateOrderResponseSchema: z.ZodObject<{
     couponCode: z.ZodOptional<z.ZodString>;
     additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     discountConfig: z.ZodOptional<z.ZodObject<{
-        bonus: z.ZodNullable<z.ZodObject<{
+        bonus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             availableBalance: z.ZodNumber;
             bonusApplied: z.ZodNumber;
             maxBonusDiscount: z.ZodNumber;
             minBonusAmount: z.ZodNullable<z.ZodNumber>;
             minOrderAmountForBonus: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strip>>>;
         coupon: z.ZodNullable<z.ZodUnknown>;
         orderDiscounts: z.ZodArray<z.ZodUnknown>;
         productDiscounts: z.ZodArray<z.ZodUnknown>;
@@ -149,6 +237,10 @@ export declare const CreateOrderResponseSchema: z.ZodObject<{
             allowGiftStacking: z.ZodBoolean;
             allowStacking: z.ZodBoolean;
             maxDiscountValue: z.ZodNullable<z.ZodNumber>;
+            giftRefundPolicy: z.ZodOptional<z.ZodString>;
+            maxBonusPaymentPercent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            minBonusAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            minOrderAmountForBonus: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         }, z.core.$strip>;
         additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bonusApplied: z.ZodOptional<z.ZodNumber>;
@@ -178,13 +270,13 @@ export declare const UpdateOrderResponseSchema: z.ZodObject<{
     couponCode: z.ZodOptional<z.ZodString>;
     additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     discountConfig: z.ZodOptional<z.ZodObject<{
-        bonus: z.ZodNullable<z.ZodObject<{
+        bonus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             availableBalance: z.ZodNumber;
             bonusApplied: z.ZodNumber;
             maxBonusDiscount: z.ZodNumber;
             minBonusAmount: z.ZodNullable<z.ZodNumber>;
             minOrderAmountForBonus: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strip>>>;
         coupon: z.ZodNullable<z.ZodUnknown>;
         orderDiscounts: z.ZodArray<z.ZodUnknown>;
         productDiscounts: z.ZodArray<z.ZodUnknown>;
@@ -192,6 +284,10 @@ export declare const UpdateOrderResponseSchema: z.ZodObject<{
             allowGiftStacking: z.ZodBoolean;
             allowStacking: z.ZodBoolean;
             maxDiscountValue: z.ZodNullable<z.ZodNumber>;
+            giftRefundPolicy: z.ZodOptional<z.ZodString>;
+            maxBonusPaymentPercent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            minBonusAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            minOrderAmountForBonus: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         }, z.core.$strip>;
         additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
         bonusApplied: z.ZodOptional<z.ZodNumber>;

package/dist/orders/ordersSchemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UpdateOrderResponseSchema = exports.CreateOrderResponseSchema = exports.OrderDiscountConfigSchema = exports.OrdersStorageResponseSchema = exports.OrderStorageSchema = exports.OrdersResponseSchema = exports.OrderEntitySchema = exports.OrderItemSchema = void 0;
+exports.UpdateOrderResponseSchema = exports.CreateOrderResponseSchema = exports.OrdersStorageResponseSchema = exports.OrderStorageSchema = exports.OrdersResponseSchema = exports.OrderEntitySchema = exports.OrderDiscountConfigSchema = exports.OrderItemSchema = void 0;
 /**
  * Validation schemas for Orders module
  * @description Zod schemas for validating orders-related API responses
@@ -18,6 +18,40 @@ exports.OrderItemSchema = zod_1.z.object({
     total: zod_1.z.number(),
     attributes: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
 });
+/**
+ * Order discount config schema
+ * @description Resolved discount configuration returned with an order or order preview.
+ */
+exports.OrderDiscountConfigSchema = zod_1.z.object({
+    bonus: zod_1.z
+        .object({
+        availableBalance: zod_1.z.number(),
+        bonusApplied: zod_1.z.number(),
+        maxBonusDiscount: zod_1.z.number(),
+        minBonusAmount: zod_1.z.number().nullable(),
+        minOrderAmountForBonus: zod_1.z.number().nullable(),
+    })
+        .nullable()
+        .optional(),
+    coupon: zod_1.z.unknown().nullable(),
+    orderDiscounts: zod_1.z.array(zod_1.z.unknown()),
+    productDiscounts: zod_1.z.array(zod_1.z.unknown()),
+    settings: zod_1.z.object({
+        allowGiftStacking: zod_1.z.boolean(),
+        allowStacking: zod_1.z.boolean(),
+        maxDiscountValue: zod_1.z.number().nullable(),
+        giftRefundPolicy: zod_1.z.string().optional(),
+        maxBonusPaymentPercent: zod_1.z.number().nullable().optional(),
+        minBonusAmount: zod_1.z.number().nullable().optional(),
+        minOrderAmountForBonus: zod_1.z.number().nullable().optional(),
+    }),
+    additionalDiscountsMarkers: zod_1.z.array(zod_1.z.string()).optional(),
+    bonusApplied: zod_1.z.number().optional(),
+    excludedGiftProductIds: zod_1.z.array(zod_1.z.string()).optional(),
+    totalDue: zod_1.z.number().optional(),
+    totalRaw: zod_1.z.number().optional(),
+    totalSumWithDiscount: zod_1.z.number().optional(),
+});
 /**
  * Order entity schema
  * @description Order entity schema for validating orders-related API responses
@@ -31,13 +65,31 @@ exports.OrderEntitySchema = zod_1.z.object({
     formData: zod_1.z.union([zod_1.z.array(zod_1.z.any()), zod_1.z.record(zod_1.z.string(), zod_1.z.any())]),
     attributeSetIdentifier: zod_1.z.string().optional(),
     totalSum: zod_1.z.string(),
+    totalSumRaw: zod_1.z.string().optional(),
     currency: zod_1.z.string(),
     paymentAccountIdentifier: zod_1.z.string().optional(),
     paymentAccountLocalizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
     paymentUrl: zod_1.z.string().nullable(),
     products: zod_1.z.array(zod_1.z.any()),
     isCompleted: zod_1.z.boolean().nullable(),
+    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(),
+    discountConfig: exports.OrderDiscountConfigSchema.nullable().optional(),
+    split: zod_1.z
+        .object({
+        completed: zod_1.z.boolean(),
+        partial: zod_1.z.boolean(),
+        stages: zod_1.z.array(zod_1.z.object({
+            marker: zod_1.z.string(),
+            sessionId: zod_1.z.string().nullable(),
+            productId: zod_1.z.number(),
+            title: zod_1.z.string(),
+            value: zod_1.z.number(),
+            status: zod_1.z.string(),
+        })),
+    })
+        .optional(),
 });
 /**
  * Orders list response schema
@@ -65,35 +117,6 @@ exports.OrderStorageSchema = zod_1.z.object({
  * @returns Orders storage list response schema
  */
 exports.OrdersStorageResponseSchema = zod_1.z.array(exports.OrderStorageSchema);
-/**
- * Order discount config schema
- * @description Resolved discount configuration returned with an order or order preview.
- */
-exports.OrderDiscountConfigSchema = zod_1.z.object({
-    bonus: zod_1.z
-        .object({
-        availableBalance: zod_1.z.number(),
-        bonusApplied: zod_1.z.number(),
-        maxBonusDiscount: zod_1.z.number(),
-        minBonusAmount: zod_1.z.number().nullable(),
-        minOrderAmountForBonus: zod_1.z.number().nullable(),
-    })
-        .nullable(),
-    coupon: zod_1.z.unknown().nullable(),
-    orderDiscounts: zod_1.z.array(zod_1.z.unknown()),
-    productDiscounts: zod_1.z.array(zod_1.z.unknown()),
-    settings: zod_1.z.object({
-        allowGiftStacking: zod_1.z.boolean(),
-        allowStacking: zod_1.z.boolean(),
-        maxDiscountValue: zod_1.z.number().nullable(),
-    }),
-    additionalDiscountsMarkers: zod_1.z.array(zod_1.z.string()).optional(),
-    bonusApplied: zod_1.z.number().optional(),
-    excludedGiftProductIds: zod_1.z.array(zod_1.z.string()).optional(),
-    totalDue: zod_1.z.number().optional(),
-    totalRaw: zod_1.z.number().optional(),
-    totalSumWithDiscount: zod_1.z.number().optional(),
-});
 /**
  * Create order response schema
  * API returns a simplified order object after creation

package/dist/pages/pagesInterfaces.d.ts

@@ -169,7 +169,7 @@ interface IPositionForm {
  * @property {number} version - The version number of the object. Example: 0.
  * @property {number} position - The position of the object. Example: 1.
  * @property {string} identifier - The textual identifier for the record field. Example: "product_block".
- * @property {BlockType} type - Page type. Example: "product".
+ * @property {BlockType} type - Block type. Example: "product".
  * @property {string | null} templateIdentifier     - User id of the linked template. Example: null.
  * @property {boolean} isVisible - A sign of page visibility. Example: true.
  * @property {boolean} isSync - Indication of page indexing. Example: false.
@@ -202,6 +202,12 @@ interface IPositionBlock {
     countElementsPerRow?: number;
     quantity?: number;
 }
+/**
+ * PageType
+ * @type {PageType}
+ * @description This type defines the possible values for page types used in the system. It is a page-specific subset of {@link BlockType}.
+ */
+type PageType = 'catalog_page' | 'common_page' | 'error_page' | 'external_page';
 /**
  * @interface IPagesEntity
  * @property {number} id - The identifier of the object. Example: 8.
@@ -217,7 +223,7 @@ interface IPositionBlock {
       "plainContent": ""
     }
  * @property {boolean} isVisible - A sign of page visibility. Example: true.
- * @property {BlockType} type - Page type. Example: "common_page".
+ * @property {PageType} type - Page type. Example: "common_page".
  * @property {string | null} templateIdentifier - User id of the linked template. Example: "template".
  * @property {string | null} attributeSetIdentifier - Set of attributes id. Example: "page".
  * @property {IAttributeValues} attributeValues - Map of attribute values keyed by marker; empty object when none.
@@ -257,7 +263,7 @@ interface IPositionBlock {
  * @property {Array<IFormConfig>} [moduleFormConfigs] - Module form configurations linked to the page.
  * @property {IRating} [rating] - Rating data.
  * @property {string} [total] - Total number of products linked to the page. Example: "10".
- * @property {string} [categoryPath] - Category path string. Example: "catalog".
+ * @property {string | null} [categoryPath] - Category path string; null for nested pages that have no own category path. Example: "catalog".
  * @description This interface defines the structure of a page entity, including its identifiers, attributes, and hierarchical relationships.
  */
 interface IPagesEntity {
@@ -267,7 +273,7 @@ interface IPagesEntity {
     depth: number;
     localizeInfos: ILocalizeInfo;
     isVisible: boolean;
-    type: BlockType;
+    type: PageType;
     templateIdentifier: string | null;
     attributeSetIdentifier: string | null;
     attributeValues: IAttributeValues;
@@ -281,6 +287,6 @@ interface IPagesEntity {
     products?: number;
     childrenCount?: number;
     total?: string;
-    categoryPath?: string;
+    categoryPath?: string | null;
 }
-export type { IPageConfig, IPagesApi, IPagesEntity, IPositionBlock, IPositionForm, };
+export type { IPageConfig, IPagesApi, IPagesEntity, IPositionBlock, IPositionForm, PageType, };

package/dist/pages/pagesSchemas.d.ts

@@ -14,7 +14,12 @@ export declare const PageEntitySchema: z.ZodObject<{
     depth: z.ZodNumber;
     localizeInfos: z.ZodRecord<z.ZodString, z.ZodAny>;
     isVisible: z.ZodBoolean;
-    type: z.ZodString;
+    type: z.ZodEnum<{
+        error_page: "error_page";
+        catalog_page: "catalog_page";
+        common_page: "common_page";
+        external_page: "external_page";
+    }>;
     templateIdentifier: z.ZodNullable<z.ZodString>;
     attributeSetIdentifier: z.ZodNullable<z.ZodString>;
     attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
@@ -28,7 +33,7 @@ export declare const PageEntitySchema: z.ZodObject<{
     products: z.ZodOptional<z.ZodNumber>;
     childrenCount: z.ZodOptional<z.ZodNumber>;
     total: z.ZodOptional<z.ZodString>;
-    categoryPath: z.ZodOptional<z.ZodString>;
+    categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 /**
  * Pages response schema (array of pages)
@@ -40,7 +45,12 @@ export declare const PagesResponseSchema: z.ZodArray<z.ZodObject<{
     depth: z.ZodNumber;
     localizeInfos: z.ZodRecord<z.ZodString, z.ZodAny>;
     isVisible: z.ZodBoolean;
-    type: z.ZodString;
+    type: z.ZodEnum<{
+        error_page: "error_page";
+        catalog_page: "catalog_page";
+        common_page: "common_page";
+        external_page: "external_page";
+    }>;
     templateIdentifier: z.ZodNullable<z.ZodString>;
     attributeSetIdentifier: z.ZodNullable<z.ZodString>;
     attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
@@ -54,7 +64,7 @@ export declare const PagesResponseSchema: z.ZodArray<z.ZodObject<{
     products: z.ZodOptional<z.ZodNumber>;
     childrenCount: z.ZodOptional<z.ZodNumber>;
     total: z.ZodOptional<z.ZodString>;
-    categoryPath: z.ZodOptional<z.ZodString>;
+    categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>>;
 /**
  * Single page response schema
@@ -66,7 +76,12 @@ export declare const SinglePageSchema: z.ZodObject<{
     depth: z.ZodNumber;
     localizeInfos: z.ZodRecord<z.ZodString, z.ZodAny>;
     isVisible: z.ZodBoolean;
-    type: z.ZodString;
+    type: z.ZodEnum<{
+        error_page: "error_page";
+        catalog_page: "catalog_page";
+        common_page: "common_page";
+        external_page: "external_page";
+    }>;
     templateIdentifier: z.ZodNullable<z.ZodString>;
     attributeSetIdentifier: z.ZodNullable<z.ZodString>;
     attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
@@ -80,7 +95,7 @@ export declare const SinglePageSchema: z.ZodObject<{
     products: z.ZodOptional<z.ZodNumber>;
     childrenCount: z.ZodOptional<z.ZodNumber>;
     total: z.ZodOptional<z.ZodString>;
-    categoryPath: z.ZodOptional<z.ZodString>;
+    categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 /**
  * Page config schema

package/dist/pages/pagesSchemas.js

@@ -17,7 +17,8 @@ exports.PageEntitySchema = zod_1.z.object({
     depth: zod_1.z.number(),
     localizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()),
     isVisible: zod_1.z.boolean(),
-    type: zod_1.z.string(),
+    // Must stay in sync with PageType in src/pages/pagesInterfaces.ts
+    type: zod_1.z.enum(['catalog_page', 'common_page', 'error_page', 'external_page']),
     templateIdentifier: zod_1.z.string().nullable(),
     attributeSetIdentifier: zod_1.z.string().nullable(),
     attributeValues: zod_1.z.record(zod_1.z.string(), zod_1.z.any()),
@@ -31,7 +32,7 @@ exports.PageEntitySchema = zod_1.z.object({
     products: zod_1.z.number().optional(),
     childrenCount: zod_1.z.number().optional(),
     total: zod_1.z.string().optional(),
-    categoryPath: zod_1.z.string().optional(),
+    categoryPath: zod_1.z.string().nullable().optional(),
 });
 /**
  * Pages response schema (array of pages)

package/dist/products/productsApi.js

@@ -367,10 +367,22 @@ class ProductsApi extends asyncModules_1.default {
     async searchProduct(name, langCode = this.state.lang) {
         const searchProducts = await this._fetchGet(`/quick/search?langCode=${langCode}&name=${name}`);
         if (!this.state.traficLimit && Array.isArray(searchProducts)) {
-            // Promise.all preserves the input order, keeping the search relevance
-            // order from the API (manual push would reorder by completion time).
-            const productsList = await Promise.all(searchProducts.map((product) => this.getProductById(product.id, langCode)));
-            return this._dataPostProcess(productsList, langCode);
+            if (searchProducts.length === 0)
+                return searchProducts;
+            const ids = searchProducts.map((product) => product.id);
+            // One /ids request instead of one getProductById per result.
+            // limit is set to the number of ids so the default 30 does not truncate.
+            const products = await this.getProductsByIds(ids.join(','), langCode, {
+                limit: ids.length,
+            });
+            if (!Array.isArray(products))
+                return products;
+            // /ids re-sorts by id (DESC) by default, so restore the original
+            // search relevance order from the quick search response.
+            const byId = new Map(products.map((product) => [product.id, product]));
+            return ids
+                .map((id) => byId.get(id))
+                .filter((product) => product !== undefined);
         }
         return searchProducts;
     }

package/dist/products/productsInterfaces.d.ts

@@ -432,12 +432,12 @@ interface IProductPageRef {
  * @property {number | null} price - The value of the product page price taken from the index. Example: 150.00.
  * @property {object} additional - Additional value from the index.
  * @example
-    `{
-      prices: {
-        min: 5
-        max: 150
+    {
+      "prices": {
+        "min": 5,
+        "max": 150
       }
-    }`
+    }
  * @property {string | null} sku - Product SKU (Stock Keeping Unit), may be null. Example: "SKU_12345".
  * @property {boolean} isSync - Indication of page indexing. Example: true.
  * @property {IAttributeValues} attributeValues - Array of attribute values from the index, represented.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oneentry",
-  "version": "1.0.150",
+  "version": "1.0.152",
   "description": "OneEntry NPM package",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",