oneentry 1.0.146 → 1.0.148

package/dist/base/utils.d.ts

@@ -1,8 +1,5 @@
 /**
- * @typedef {string} Types - Type of block.
- */
-type Types = 'product' | 'error_page' | 'catalog_page' | 'product_preview' | 'similar_products_block' | 'product_block' | 'form' | 'common_page' | 'common_block' | 'order' | 'service' | 'external_page' | 'discount' | 'frequently_ordered_block' | 'none';
-/**
+ * @interface IConfig
  * @property {string} [token] - If your project is protected by a token, specify this token in this parameter.
  * @property {string} [langCode] - specify the default language to avoid specifying it in every request.
  * @property {boolean} [traficLimit] - Some methods use multiple queries to make it easier to work with the API. Set this parameter to "false" to save traffic and decide for yourself what data you need.
@@ -62,30 +59,46 @@ interface IConfig {
     errors?: {
         isShell?: boolean;
         customErrors?: {
-            400?: (data?: IError) => any;
-            401?: (data?: IError) => any;
-            403?: (data?: IError) => any;
-            404?: (data?: IError) => any;
-            429?: (data?: IError) => any;
-            500?: (data?: IError) => any;
-            502?: (data?: IError) => any;
-            503?: (data?: IError) => any;
-            504?: (data?: IError) => any;
+            400?: (data?: IError) => unknown;
+            401?: (data?: IError) => unknown;
+            403?: (data?: IError) => unknown;
+            404?: (data?: IError) => unknown;
+            429?: (data?: IError) => unknown;
+            500?: (data?: IError) => unknown;
+            502?: (data?: IError) => unknown;
+            503?: (data?: IError) => unknown;
+            504?: (data?: IError) => unknown;
         };
     };
 }
 /**
  * @interface IAttributes
- * @property {Array<object>} listTitles - List of titles.
- * @property {ILocalizeInfo} localizeInfos - Localization information.
- * @property {string} marker - Attribute marker.
- * @property {number} position - Attribute position.
- * @property {boolean} isVisible - Indicates whether the attribute is visible.
- * @property {string} type - Attribute type.
- * @property {Record<string, any>} settings - Additional settings for the attribute.
- * @property {Record<string, any>} validators - Validators for the attribute.
- * @property {Record<string, any>} additionalFields - Additional fields for the attribute.
- * @description Interface for attributes.
+ * @property {Array<object>} listTitles - Predefined option list for `list`/`enum`-style attributes. Each entry holds a localized label, raw value, sort position, and an `extended` payload with the typed value used by the runtime.
+ * @example
+    [
+      {
+        "title": "Red",
+        "value": "red",
+        "position": 1,
+        "extended": { "value": "#ff0000", "type": "string" }
+      }
+    ]
+ * @property {IAttributeLocalizeInfo} localizeInfos - Localized labels for the attribute (title and other text fields shown in UI). For `timeInterval` attributes, also carries the `intervals` schedule payload.
+ * @property {string} marker - Machine-readable identifier of the attribute, unique within its set. Example: "color".
+ * @property {number} position - Sort position of the attribute inside its set. Example: 1.
+ * @property {boolean} isVisible - Whether the attribute is exposed in the public API/UI. Example: true.
+ * @property {string} type - Attribute data type (e.g. "string", "integer", "list", "file", "image").
+ * @property {Record<string, unknown>} [settings] - Type-specific configuration (e.g. min/max for numbers, accepted MIME types for files). Optional.
+ * @property {Record<string, unknown>} validators - Validation rules applied to the attribute value (e.g. `requiredValidator`, `regexValidator`). Example: { "requiredValidator": { "strict": true } }.
+ * @property {Record<string, IAttributes>} [additionalFields] - Nested sub-attributes attached to this attribute, keyed by marker. Optional.
+ * @property {boolean} [isIcon] - Block/preview attribute flag — whether the field is treated as an icon. Optional.
+ * @property {boolean} [isProductPreview] - Block/preview attribute flag — whether the field is shown in product preview. Optional.
+ * @property {boolean} [isLogin] - Form attribute flag — whether the field carries the login value used for authentication. Optional.
+ * @property {boolean} [isSignUp] - Form attribute flag — whether the field is required during sign-up. Optional.
+ * @property {boolean} [isNotificationEmail] - Form attribute flag — whether the field stores the email used for notifications. Optional.
+ * @property {boolean} [isNotificationPhonePush] - Form attribute flag — whether the field stores the phone number used for push notifications. Optional.
+ * @property {boolean} [isNotificationPhoneSMS] - Form attribute flag — whether the field stores the phone number used for SMS notifications. Optional.
+ * @description Definition of a single attribute inside an attribute set — describes how a field is labeled, validated and rendered.
  */
 interface IAttributes {
     listTitles: Array<{
@@ -97,85 +110,152 @@ interface IAttributes {
             type: string | number | null;
         };
     }>;
-    localizeInfos: ILocalizeInfo;
+    localizeInfos: IAttributeLocalizeInfo;
     marker: string;
     position: number;
     isVisible: boolean;
     type: string;
-    settings?: Record<string, any>;
-    validators: Record<string, any>;
-    additionalFields?: any;
-    [key: string]: any;
+    settings?: Record<string, unknown>;
+    validators: Record<string, unknown>;
+    additionalFields?: Record<string, IAttributes>;
+    isIcon?: boolean;
+    isProductPreview?: boolean;
+    isLogin?: boolean;
+    isSignUp?: boolean;
+    isNotificationEmail?: boolean;
+    isNotificationPhonePush?: boolean;
+    isNotificationPhoneSMS?: boolean;
 }
 /**
- * @interface ILocalizeInfos
- * @property {Record<string, ILocalizeInfo>} - Localization information.
- * @description Interface for localization information.
+ * @interface ILocalizeInfo
+ * @property {string} title - Localized title of the entity. Example: "Catalog".
+ * @property {string | null} [plainValue] - Localized plain-text content (without HTML markup). Example: "Plain description".
+ * @property {string | null} [htmlValue] - Localized HTML-rendered content. Example: "<p>Description</p>".
+ * @property {string | null} [htmlContent] - Localized HTML body content for richer pages. Example: "<div>...</div>".
+ * @property {string | null} [menuTitle] - Localized title used in menus and navigation. Example: "Home".
+ * @description Normalized localization payload for a single locale, returned by the SDK after unwrapping the API's per-language map.
  */
-interface ILocalizeInfos {
-    [key: string]: ILocalizeInfo;
+interface ILocalizeInfo {
+    title: string;
+    plainValue?: string | null;
+    htmlValue?: string | null;
+    htmlContent?: string | null;
+    menuTitle?: string | null;
 }
 /**
- * Interface for localization information.
- * @property {Record<string, any>} - Localization information.
- * @description Interface for localization information.
+ * @interface IAttributeLocalizeInfo
+ * @property {ITimeIntervalSchedule[]} [intervals] - For attributes of type `timeInterval`, the precomputed schedule data attached to the localization payload.
+ * @description Extension of {@link ILocalizeInfo} used by attribute entities — adds attribute-type-specific fields the API exposes via `localizeInfos`.
  */
-interface ILocalizeInfo {
-    [key: string]: any;
+interface IAttributeLocalizeInfo extends ILocalizeInfo {
+    intervals?: ITimeIntervalSchedule[];
+    [key: string]: unknown;
 }
 /**
- * @interface IAttributeValues
- * @property {Record<string, IAttributeValue>} - Attribute values.
- * @description Interface for attribute values.
+ * @interface ITimeIntervalSchedule
+ * @property {string} id - Schedule entry identifier (UUID). Example: "c6466cd8-c55d-4583-97c5-42b684210f12".
+ * @property {number} fullMonth - Month index this schedule covers (0-11). Example: 2.
+ * @property {boolean} inEveryMonth - Whether the schedule repeats every month. Example: true.
+ * @property {number} selectedYear - Year the schedule applies to. Example: 2025.
+ * @property {ITimeIntervalRange[]} intervals - Daily time ranges configured for the schedule.
+ * @property {unknown[]} external - External overrides; empty array when none.
+ * @property {unknown[]} range - Date ranges; empty array when none.
+ * @description One entry of a `timeInterval` attribute's schedule.
  */
-interface IAttributeValues {
-    [key: string]: IAttributeValue;
+interface ITimeIntervalSchedule {
+    id: string;
+    fullMonth: number;
+    inEveryMonth: boolean;
+    selectedYear: number;
+    intervals: ITimeIntervalRange[];
+    external: unknown[];
+    range: unknown[];
+}
+/**
+ * @interface ITimeIntervalPoint
+ * @property {number} hours - Hour component (0-23).
+ * @property {number} minutes - Minute component (0-59).
+ * @description A point in time within a day, used as start/end of {@link ITimeIntervalRange}.
+ */
+interface ITimeIntervalPoint {
+    hours: number;
+    minutes: number;
+}
+/**
+ * @interface ITimeIntervalRange
+ * @property {string} id - Range identifier (UUID).
+ * @property {ITimeIntervalPoint} start - Start time of the range.
+ * @property {ITimeIntervalPoint} end - End time of the range.
+ * @property {number} period - Slot duration in minutes. Example: 60.
+ * @description A single daily time range inside a {@link ITimeIntervalSchedule}.
+ */
+interface ITimeIntervalRange {
+    id: string;
+    start: ITimeIntervalPoint;
+    end: ITimeIntervalPoint;
+    period: number;
 }
 /**
  * @interface IAttributeValue
- * @property {Record<string, any>} - Attribute value.
- * @description Interface for attribute value.
+ * @property {string} type - Attribute data type (e.g. "string", "integer", "list", "file", "image").
+ * @property {unknown} value - Attribute value — actual TS type depends on `type` (string for "string"/"text", number for "integer", array for "list", etc.). Example: "Admins text".
+ * @property {number} [position] - Sort position of the value inside its set. Example: 0.
+ * @property {Record<string, IAttributeValue> | unknown[]} [additionalFields] - Nested attribute values keyed by marker; the API may also return an empty array when none are configured. Optional.
+ * @property {boolean} [isIcon] - Block/preview attribute flag — whether the field is treated as an icon. Optional.
+ * @property {boolean} [isProductPreview] - Block/preview attribute flag — whether the field is shown in product preview. Optional.
+ * @description A single attribute value attached to an entity (admin, user, page, product, …).
  */
 interface IAttributeValue {
-    [key: string]: any;
+    type: string;
+    value: unknown;
+    position?: number;
+    additionalFields?: Record<string, IAttributeValue> | unknown[];
+    isIcon?: boolean;
+    isProductPreview?: boolean;
+}
+/**
+ * @interface IAttributeValues
+ * @description Map of attribute values keyed by attribute marker.
+ */
+interface IAttributeValues {
+    [key: string]: IAttributeValue;
 }
 /**
  * @interface IRating
- * @property {number} value - Average rating value. Example: 4.5.
- * @property {number} like - Number of likes. Example: 10.
- * @property {number} dislike - Number of dislikes. Example: 2.
- * @property {string} method - Rating calculation method. Example: "average".
- * @description Interface for rating data.
+ * @property {number} [value] - Average rating value. Example: 4.5.
+ * @property {number} [like] - Number of likes. Example: 10.
+ * @property {number} [dislike] - Number of dislikes. Example: 2.
+ * @property {string} [method] - Rating calculation method. Example: "average".
+ * @description Rating data attached to an entity. All fields are optional — the API returns an empty object when no rating has been collected yet.
  */
 interface IRating {
-    value: number;
-    like: number;
-    dislike: number;
-    method: string;
+    value?: number;
+    like?: number;
+    dislike?: number;
+    method?: string;
 }
 /**
  * @interface IError
  * @property {string} message - Error message.
- * @property {any} pageData - Page data.
+ * @property {unknown} pageData - Page data.
  * @property {number} statusCode - Status code.
  * @property {string} timestamp - Timestamp.
- * @property {Record<string, any>} - Attribute value.
- * @description Interface for error.
+ * @property {string} [localizeMessage] - Human-readable localized error message; populated by the SDK when response validation fails. Optional.
+ * @property {unknown[]} [validationErrors] - Detailed validation issues from Zod when response validation fails. Optional.
+ * @description Interface for error responses returned by the SDK either from the API or from local response validation.
  */
 interface IError {
     message: string;
-    pageData: any;
+    pageData: unknown;
     statusCode: number;
     timestamp: string;
-    [key: string]: any;
+    localizeMessage?: string;
+    validationErrors?: unknown[];
 }
 /**
  * @interface IHttpHeaders
- * @property {string} [Content-Type] - Content type header
- * @property {string} [x-app-token] - App token header
- * @property {string} [x-device-metadata] - Device metadata header
- * @property {string} [Authorization] - Authorization header
- * @description Interface for HTTP headers
+ * @property {string} [Authorization] - Authorization header.
+ * @description Interface for HTTP headers. Supports the standard `Content-Type`, `Authorization`, and OneEntry-specific `x-app-token` / `x-device-metadata` headers, plus arbitrary string entries via the index signature.
  */
 interface IHttpHeaders {
     'Content-Type'?: string;
@@ -196,10 +276,6 @@ interface IHttpOptions {
     headers: IHttpHeaders;
     body?: string | FormData | Blob;
 }
-/**
- * AttributeType
- */
-type AttributeType = IAttributeValue | IAttributeValues;
 /**
  * LangType
  */
@@ -207,5 +283,5 @@ type LangType = string | Array<string>;
 /**
  * LocalizeType
  */
-type LocalizeType = ILocalizeInfos | ILocalizeInfo;
-export type { AttributeType, IAttributes, IAttributeValues, IConfig, IError, IHttpHeaders, IHttpOptions, ILocalizeInfo, ILocalizeInfos, IRating, LangType, LocalizeType, Types, };
+type LocalizeType = ILocalizeInfo;
+export type { IAttributeLocalizeInfo, IAttributes, IAttributeValue, IAttributeValues, IConfig, IError, IHttpHeaders, IHttpOptions, ILocalizeInfo, IRating, ITimeIntervalPoint, ITimeIntervalRange, ITimeIntervalSchedule, LangType, LocalizeType, };

package/dist/blocks/blocksApi.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 { IProductsEntity } from '../products/productsInterfaces';
+import type { IProductsResponse } from '../products/productsInterfaces';
 import type { BlockType, IBlockEntity, IBlocks, IBlocksResponse, ISearchBlock } from './blocksInterfaces';
 /**
  * Controllers for working with blocks.
@@ -72,10 +72,10 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} marker - Block marker. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Sign price.
-     * @returns {Promise<IProductsEntity[] | IError>} Returns array of ProductEntity objects.
+     * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
-    getFrequentlyOrderedProducts(productId: number, marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    getFrequentlyOrderedProducts(productId: number, marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
      * Quick search for block objects with limited output.
      * @handleName searchBlock

package/dist/blocks/blocksApi.js

@@ -177,7 +177,7 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} marker - Block marker. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Sign price.
-     * @returns {Promise<IProductsEntity[] | IError>} Returns array of ProductEntity objects.
+     * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     async getFrequentlyOrderedProducts(productId, marker, langCode = this.state.lang, signPrice) {

package/dist/blocks/blocksInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { AttributeType, IError, ILocalizeInfo } from '../base/utils';
+import type { IAttributeValues, IError, ILocalizeInfo } from '../base/utils';
 import type { IProductsEntity, IProductsResponse } from '../products/productsInterfaces';
 /**
  * Interface for managing and retrieving blocks in the system.
@@ -47,10 +47,10 @@ interface IBlocks {
      * @param {string} marker - Block marker. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Sign price.
-     * @returns {IProductsEntity[]} A promise that resolves to an array of product entities or an error.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getFrequentlyOrderedProducts(productId: number, marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
+    getFrequentlyOrderedProducts(productId: number, marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
 }
 /**
  * Represents a response from the blocks API.
@@ -60,7 +60,7 @@ interface IBlocks {
  * @example
     [
       {
-        "attributeValues": [],
+        "attributeValues": {},
         "id": 1,
         "identifier": "block1",
         "isVisible": true,
@@ -96,7 +96,7 @@ interface IBlocksResponse {
 /**
  * Represents a block entity with various attributes and properties.
  * @interface IBlockEntity
- * @property {AttributeType} attributeValues - Type of attributes used in the block.
+ * @property {IAttributeValues} attributeValues - Map of attribute values keyed by marker; empty object when none.
  * @example
    {
     "block-text": {
@@ -116,7 +116,7 @@ interface IBlocksResponse {
     }
  * @property {number} version - Version of the block entity. Example: 1.
  * @property {string} identifier - Unique string identifier for the block. Example: "block1".
- * @property {string} type - Type of the block, such as 'product', 'error_page', etc. Example: "product".
+ * @property {BlockType} type - Type of the block. Example: "product".
  * @property {number} position - Position of the block for sorting. Example: 1.
  * @property {string | null} templateIdentifier - Identifier for the template used by the block, or null if not applicable. Example: "template1".
  * @property {boolean} isVisible - Indicates whether the block is visible. Example: true.
@@ -148,10 +148,10 @@ interface IBlockEntity {
     version: number;
     position: number;
     identifier: string;
-    type: string;
+    type: BlockType;
     templateIdentifier: string | null;
     isVisible: boolean;
-    attributeValues: AttributeType;
+    attributeValues: IAttributeValues;
     similarProducts?: IProductsResponse;
     countElementsPerRow?: number;
     quantity?: number;

package/dist/blocks/blocksSchemas.d.ts

@@ -22,7 +22,12 @@ export declare const BlockEntitySchema: z.ZodObject<{
             attributeSetIdentifier: z.ZodNullable<z.ZodString>;
             position: z.ZodNumber;
             price: z.ZodNullable<z.ZodNumber>;
-            additional: z.ZodRecord<z.ZodString, z.ZodAny>;
+            additional: z.ZodObject<{
+                prices: z.ZodObject<{
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>;
             sku: z.ZodNullable<z.ZodString>;
             isSync: z.ZodBoolean;
             attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
@@ -33,7 +38,13 @@ export declare const BlockEntitySchema: z.ZodObject<{
             templateIdentifier: z.ZodNullable<z.ZodOptional<z.ZodString>>;
             shortDescTemplateIdentifier: z.ZodNullable<z.ZodOptional<z.ZodString>>;
             signedPrice: z.ZodOptional<z.ZodString>;
-            productPages: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+            productPages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodNumber;
+                pageId: z.ZodNumber;
+                productId: z.ZodNumber;
+                positionId: z.ZodNumber;
+                categoryPath: z.ZodString;
+            }, z.core.$strip>>>;
             blocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
             isPositionLocked: z.ZodOptional<z.ZodBoolean>;
             relatedIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
@@ -52,7 +63,12 @@ export declare const BlockEntitySchema: z.ZodObject<{
         attributeSetIdentifier: z.ZodNullable<z.ZodString>;
         position: z.ZodNumber;
         price: z.ZodNullable<z.ZodNumber>;
-        additional: z.ZodRecord<z.ZodString, z.ZodAny>;
+        additional: z.ZodObject<{
+            prices: z.ZodObject<{
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
         sku: z.ZodNullable<z.ZodString>;
         isSync: z.ZodBoolean;
         attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
@@ -63,7 +79,13 @@ export declare const BlockEntitySchema: z.ZodObject<{
         templateIdentifier: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         shortDescTemplateIdentifier: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         signedPrice: z.ZodOptional<z.ZodString>;
-        productPages: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+        productPages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            pageId: z.ZodNumber;
+            productId: z.ZodNumber;
+            positionId: z.ZodNumber;
+            categoryPath: z.ZodString;
+        }, z.core.$strip>>>;
         blocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
         isPositionLocked: z.ZodOptional<z.ZodBoolean>;
         relatedIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
@@ -94,7 +116,12 @@ export declare const BlocksResponseSchema: z.ZodObject<{
                 attributeSetIdentifier: z.ZodNullable<z.ZodString>;
                 position: z.ZodNumber;
                 price: z.ZodNullable<z.ZodNumber>;
-                additional: z.ZodRecord<z.ZodString, z.ZodAny>;
+                additional: z.ZodObject<{
+                    prices: z.ZodObject<{
+                        min: z.ZodNumber;
+                        max: z.ZodNumber;
+                    }, z.core.$strip>;
+                }, z.core.$strip>;
                 sku: z.ZodNullable<z.ZodString>;
                 isSync: z.ZodBoolean;
                 attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
@@ -105,7 +132,13 @@ export declare const BlocksResponseSchema: z.ZodObject<{
                 templateIdentifier: z.ZodNullable<z.ZodOptional<z.ZodString>>;
                 shortDescTemplateIdentifier: z.ZodNullable<z.ZodOptional<z.ZodString>>;
                 signedPrice: z.ZodOptional<z.ZodString>;
-                productPages: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+                productPages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodNumber;
+                    pageId: z.ZodNumber;
+                    productId: z.ZodNumber;
+                    positionId: z.ZodNumber;
+                    categoryPath: z.ZodString;
+                }, z.core.$strip>>>;
                 blocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 isPositionLocked: z.ZodOptional<z.ZodBoolean>;
                 relatedIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
@@ -124,7 +157,12 @@ export declare const BlocksResponseSchema: z.ZodObject<{
             attributeSetIdentifier: z.ZodNullable<z.ZodString>;
             position: z.ZodNumber;
             price: z.ZodNullable<z.ZodNumber>;
-            additional: z.ZodRecord<z.ZodString, z.ZodAny>;
+            additional: z.ZodObject<{
+                prices: z.ZodObject<{
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>;
             sku: z.ZodNullable<z.ZodString>;
             isSync: z.ZodBoolean;
             attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
@@ -135,7 +173,13 @@ export declare const BlocksResponseSchema: z.ZodObject<{
             templateIdentifier: z.ZodNullable<z.ZodOptional<z.ZodString>>;
             shortDescTemplateIdentifier: z.ZodNullable<z.ZodOptional<z.ZodString>>;
             signedPrice: z.ZodOptional<z.ZodString>;
-            productPages: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+            productPages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodNumber;
+                pageId: z.ZodNumber;
+                productId: z.ZodNumber;
+                positionId: z.ZodNumber;
+                categoryPath: z.ZodString;
+            }, z.core.$strip>>>;
             blocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
             isPositionLocked: z.ZodOptional<z.ZodBoolean>;
             relatedIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;

package/dist/discounts/discountsInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IError } from '../base/utils';
+import type { IAttributeValues, IError, ILocalizeInfo } from '../base/utils';
 /**
  * Discount type.
  */
@@ -89,21 +89,21 @@ interface IDiscountCondition {
  * @interface IDiscountsEntity
  * @property {number} id - The unique identifier of the discount.
  * @property {number} [attributeSetId] - The identifier of the discount.
- * @property {object} [localizeInfos] - The name of the discount.
+ * @property {ILocalizeInfo} [localizeInfos] - The name of the discount.
  * @property {number} [version] - The version of the discount.
  * @property {string} [identifier] - The identifier of the discount.
  * @property {IDiscountType} type - The type of the discount.
  * @property {string} [startDate] - The start date of the discount.
  * @property {string} [endDate] - The end date of the discount.
- * @property {Record<string, unknown>} [discountValue] - The value of the discount.
+ * @property {IDiscountValue} [discountValue] - The value of the discount, including its type and amount limits.
  * @property {string} [conditionLogic] - The logic of the discount. Possible values are "AND" | "OR".
  * @property {IDiscountCondition[]} [conditions] - The conditions of the discount.
- * @property {object} [exclusions] - The exclusions of the discount.
- * @property {object} [gifts] - The gifts of the discount.
+ * @property {Record<string, unknown> | null} [exclusions] - The exclusions of the discount.
+ * @property {Record<string, unknown> | null} [gifts] - The gifts of the discount.
  * @property {boolean} [giftsReplaceCartItems] - Whether the gifts replace cart items.
- * @property {object} [userGroups] - The user groups of the discount.
- * @property {object} [userExclusions] - The user exclusions of the discount.
- * @property {object} [attributeValues] - The attribute values of the discount.
+ * @property {Record<string, unknown> | null} [userGroups] - The user groups of the discount.
+ * @property {Record<string, unknown> | null} [userExclusions] - The user exclusions of the discount.
+ * @property {IAttributeValues} [attributeValues] - The attribute values of the discount.
  * @property {string} [attributeSetIdentifier] - The identifier of the attribute set.
  * @property {Record<string, unknown>} [bonusEvent] - Bonus event configuration.
  * @property {number} [position] - Position number for sorting. Example: 1.
@@ -112,26 +112,60 @@ interface IDiscountCondition {
 interface IDiscountsEntity {
     id: number;
     attributeSetId?: number;
-    localizeInfos?: object;
+    localizeInfos?: ILocalizeInfo;
     version?: number;
     identifier?: string;
     type: IDiscountType;
     startDate?: string;
     endDate?: string;
-    discountValue?: Record<string, unknown>;
+    discountValue?: IDiscountValue;
     conditionLogic?: 'AND' | 'OR';
     conditions?: IDiscountCondition[];
-    exclusions?: object;
-    gifts?: object;
+    exclusions?: Record<string, unknown> | null;
+    gifts?: Record<string, unknown> | null;
     giftsReplaceCartItems?: boolean;
-    userGroups?: object;
-    userExclusions?: object;
-    attributeValues?: object;
+    userGroups?: Record<string, unknown> | null;
+    userExclusions?: Record<string, unknown> | null;
+    attributeValues?: IAttributeValues;
     attributeSetIdentifier?: string;
-    bonusEvent?: Record<string, unknown>;
+    bonusEvent?: Record<string, unknown> | null;
     position?: number;
     total?: number | string;
 }
+/**
+ * @interface IDiscountValue
+ * @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.
+ * @description Configuration of the discount calculation.
+ */
+interface IDiscountValue {
+    applicability: 'TO_PRODUCT' | 'TO_ORDER';
+    discountType: 'FIXED_AMOUNT' | 'PERCENT';
+    value: number;
+    maxAmount?: number;
+}
+/**
+ * @interface ICouponEntity
+ * @property {number} id - Coupon record id. Example: 1.
+ * @property {number} discountId - Discount the coupon belongs to. Example: 1.
+ * @property {string} code - Coupon code. Example: "SUMMER-KBWZ-2428".
+ * @property {boolean} isReusable - Whether the coupon can be used more than once. Example: false.
+ * @property {boolean} isUsed - Whether the coupon has already been used. Example: false.
+ * @property {number | null} orderId - Order id where the coupon was applied, or null. Example: null.
+ * @property {string | null} usedAt - When the coupon was used, or null. Example: null.
+ * @description Coupon entity returned by the discounts API.
+ */
+interface ICouponEntity {
+    id: number;
+    discountId: number;
+    code: string;
+    isReusable: boolean;
+    isUsed: boolean;
+    orderId: number | null;
+    usedAt: string | null;
+}
 /**
  * Paginated response for discounts list.
  * @interface IDiscountsResponse
@@ -154,12 +188,12 @@ interface IDiscountsValidateCoupon {
  * Result of coupon validation.
  * @interface ICouponValidationResult
  * @property {boolean} valid - Whether the coupon is valid.
- * @property {unknown} [coupon] - Coupon data if the coupon is valid.
+ * @property {ICouponEntity} [coupon] - Coupon data if the coupon is valid.
  * @property {string} [error] - Error message if the coupon is invalid.
  */
 interface ICouponValidationResult {
     valid: boolean;
-    coupon?: unknown;
+    coupon?: ICouponEntity;
     error?: string;
 }
 /**
@@ -230,4 +264,4 @@ interface IBonusTransactionEntity {
 interface IBonusBalanceEntity {
     balance: number;
 }
-export type { IBonusBalanceEntity, IBonusHistoryQuery, IBonusTransactionEntity, IBonusTransactionType, ICouponValidationResult, IDiscountByMarkerQuery, IDiscountCondition, IDiscountsApi, IDiscountsEntity, IDiscountsQuery, IDiscountsResponse, IDiscountsValidateCoupon, IDiscountType, };
+export type { IBonusBalanceEntity, IBonusHistoryQuery, IBonusTransactionEntity, IBonusTransactionType, ICouponEntity, ICouponValidationResult, IDiscountByMarkerQuery, IDiscountCondition, IDiscountsApi, IDiscountsEntity, IDiscountsQuery, IDiscountsResponse, IDiscountsValidateCoupon, IDiscountType, IDiscountValue, };