oneentry 1.0.146 → 1.0.148

package/dist/forms/formsInterfaces.d.ts

@@ -1,5 +1,6 @@
 import type { IPosition } from '../admins/adminsInterfaces';
-import type { IAttributes, IError, ILocalizeInfo } from '../base/utils';
+import type { AttributeType, IAttributeValidators, IListTitle } from '../attribute-sets/attributeSetsInterfaces';
+import type { IAttributeLocalizeInfo, IError, ILocalizeInfo } from '../base/utils';
 /**
  * Interface for retrieving forms in the system.
  * @interface IForms
@@ -60,7 +61,7 @@ interface IFromPages {
  * @property {number} id - The identifier of the object. Example: 12345.
  * @property {number | null} attributeSetId - The identifier of the attribute set being used, or null if not applicable. Example: 1234.
  * @property {string | null} type - Form type. Example: "contact".
- * @property {ILocalizeInfo} localizeInfos - The name of the form, taking into account localization.
+ * @property {IFormLocalizeInfo} localizeInfos - The name of the form and form-side localization fields (success/error messages, processing config, etc.).
  * @example
     {
       "key": "value"
@@ -70,11 +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 {IAttributes[] | Record<string, any>} [attributes] - The attributes of the form, which can be an array of attribute objects or a record of key-value pairs.
- * @example
-    {
-      "key": "value"
-    }
+ * @property {IFormAttribute[]} attributes - Form fields with their localization, validators and form-specific flags.
  * @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.
@@ -83,16 +80,87 @@ interface IFormsEntity {
     id: number;
     attributeSetId: number | null;
     type: 'order' | 'sing_in_up' | 'collection' | 'data' | 'rating' | null;
-    localizeInfos: ILocalizeInfo;
+    localizeInfos: IFormLocalizeInfo;
     version: number;
     position: number;
     identifier: string;
     processingType: string;
     templateId: number | null;
-    attributes?: IAttributes[] | Record<string, unknown>;
+    attributes: IFormAttribute[];
     total?: number | string;
     moduleFormConfigs?: IFormConfig[];
 }
+/**
+ * @interface IFormLocalizeInfo
+ * @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).
+ */
+interface IFormLocalizeInfo extends ILocalizeInfo {
+    titleForSite?: string;
+    successMessage?: string;
+    unsuccessMessage?: string;
+    urlAddress?: string;
+    database?: string;
+    script?: string;
+}
+/**
+ * @interface IFormAttribute
+ * @property {string} marker - Field marker (machine name). Example: "email".
+ * @property {AttributeType} type - Attribute data type (e.g. "string", "file").
+ * @property {number} position - Sort position of the field. Example: 1.
+ * @property {boolean} isVisible - Whether the field is exposed to the user. Example: true.
+ * @property {IAttributeLocalizeInfo} localizeInfos - Localized labels for the field. For `timeInterval` attributes, also carries the `intervals` schedule payload.
+ * @property {unknown} initialValue - Default value applied when the field is not filled.
+ * @property {IListTitle[]} listTitles - Predefined options for `list`/`radioButton` fields; empty array for other types.
+ * @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.
+ */
+interface IFormAttribute {
+    marker: string;
+    type: AttributeType;
+    position: number;
+    isVisible: boolean;
+    localizeInfos: IAttributeLocalizeInfo;
+    initialValue: unknown;
+    listTitles: IListTitle[];
+    validators: IAttributeValidators;
+    settings: Record<string, unknown>;
+    additionalFields: Record<string, IFormAttributeAdditionalField>;
+    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} type - Type of the additional field. Example: "string".
+ * @property {unknown} value - Value of the additional field. Example: "Additional field data".
+ * @description A single nested entry inside {@link IFormAttribute}'s `additionalFields` map.
+ */
+interface IFormAttributeAdditionalField {
+    marker: string;
+    type: string;
+    value: unknown;
+}
 /**
  * Represents the structure of a form configuration.
  * @interface IFormConfig
@@ -132,10 +200,7 @@ interface IFormConfig {
     commentOnlyUserData?: boolean;
     viewOnlyMyData?: boolean;
     commentOnlyMyData?: boolean;
-    entityIdentifiers: {
-        id: string;
-        isNested: boolean;
-    }[];
+    entityIdentifiers: IEntityIdentifier[];
     nestedEntityIdentifiers?: string[];
     exceptionIds?: string[];
     formDataCount?: number;
@@ -147,6 +212,16 @@ interface IFormConfig {
     maxRatingScale?: number | null;
     ratingCalculation?: string;
 }
+/**
+ * @interface IEntityIdentifier
+ * @property {string} id - Entity identifier (e.g. page or product marker). Example: "blog".
+ * @property {boolean} isNested - Whether the entit, is treated as ,ested unde, its parent. Exa,ple: false.
+ * @description Reference to an entity attached to a form configuration.
+ */
+interface IEntityIdentifier {
+    id: string;
+    isNested: boolean;
+}
 /**
  * Represents the paginated response structure for forms.
  * @interface IFormsResponse
@@ -157,4 +232,4 @@ interface IFormsResponse {
     total: number;
     items: IFormsEntity[];
 }
-export type { IFormConfig, IForms, IFormsEntity, IFormsResponse, IFromPages };
+export type { IEntityIdentifier, IFormAttribute, IFormAttributeAdditionalField, IFormConfig, IFormLocalizeInfo, IForms, IFormsEntity, IFormsResponse, IFromPages, };

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

@@ -244,20 +244,35 @@ interface IFormsByMarkerDataEntity {
  * @property {string} actionMessage - Action message for the form data (can be localized). Example: "Form submitted successfully".
  */
 interface IPostFormResponse {
-    formData: {
-        id: number;
-        formIdentifier: string;
-        time: string;
-        entityIdentifier: string;
-        fingerprint: string;
-        isUserAdmin: boolean;
-        formModuleId: number;
-        userIdentifier: string | null;
-        parentId: number | null;
-        formData: FormDataType[] | Record<string, any>;
-    };
+    formData: IPostFormResponseData;
     actionMessage: string;
 }
+/**
+ * @interface IPostFormResponseData
+ * @property {number} id - Identifier of the created form data record. Example: 42.
+ * @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 {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.
+ * @property {number | null} parentId - Identifier of the parent record, or null when top-level.
+ * @property {FormDataType[]} formData - Submitted form fields.
+ * @description Inner `formData` payload of {@link IPostFormResponse} — describes the created form data record.
+ */
+interface IPostFormResponseData {
+    id: number;
+    formIdentifier: string;
+    time: string;
+    entityIdentifier: string;
+    fingerprint: string;
+    isUserAdmin: boolean;
+    formModuleId: number;
+    userIdentifier: string | null;
+    parentId: number | null;
+    formData: FormDataType[];
+}
 /**
  * Represents the structure of the response after updating form data.
  * @interface IUpdateFormsData
@@ -287,7 +302,7 @@ interface IUpdateFormsData {
 /**
  * Contains an array of data form objects with the following values
  */
-type FormDataType = IBodyTypeStringNumberFloat | IBodyTypeTimeDate | IBodyTypeText | IBodyTypeTextWithHeader | IBodyTypeImageGroupOfImages | IBodyTypeFile | IBodyTypeRadioButtonList | Record<string, any>;
+type FormDataType = IBodyTypeStringNumberFloat | IBodyTypeTimeDate | IBodyTypeText | IBodyTypeTextWithHeader | IBodyTypeImageGroupOfImages | IBodyTypeFile | IBodyTypeRadioButtonList | Record<string, unknown>;
 /**
  * Represents the structure of the body for posting form data.
  * @interface IBodyPostFormData
@@ -356,11 +371,19 @@ interface IBodyTypeStringNumberFloat {
 interface IBodyTypeTimeDate {
     marker: string;
     type: 'date' | 'dateTime' | 'time';
-    value: {
-        fullDate: string;
-        formattedValue: string;
-        formatString: string;
-    };
+    value: ITimeDateValue;
+}
+/**
+ * @interface ITimeDateValue
+ * @property {string} fullDate - ISO date string. Example: "2024-05-07T21:02:00.000Z".
+ * @property {string} formattedValue - Human-readable formatted date. Example: "08-05-2024 00:02".
+ * @property {string} formatString - Format mask used to render `formattedValue`. Example: "DD-MM-YYYY HH:mm".
+ * @description Value payload for `date`/`dateTime`/`time` form fields.
+ */
+interface ITimeDateValue {
+    fullDate: string;
+    formattedValue: string;
+    formatString: string;
 }
 /**
  * Represents a text form data entity.
@@ -382,14 +405,29 @@ interface IBodyTypeTimeDate {
 interface IBodyTypeText {
     marker: string;
     type: 'text';
-    value: {
-        htmlValue: string;
-        plainValue: string;
-        params: {
-            isEditorDisabled: boolean;
-            isImageCompressed: boolean;
-        };
-    };
+    value: ITextValue;
+}
+/**
+ * @interface ITextEditorParams
+ * @property {boolean} isEditorDisabled - Whether the rich-text editor is disabled. Example: false.
+ * @property {boolean} isImageCompressed - Whether embedded images are compressed. Example: true.
+ * @description Editor parameters attached to text-type form values.
+ */
+interface ITextEditorParams {
+    isEditorDisabled: boolean;
+    isImageCompressed: boolean;
+}
+/**
+ * @interface ITextValue
+ * @property {string} htmlValue - HTML representation of the text. Example: "<p>Hello world</p>".
+ * @property {string} plainValue - Plain-text representation.
+ * @property {ITextEditorParams} params - Editor configuration applied to this value.
+ * @description Value payload for `text` form fields.
+ */
+interface ITextValue {
+    htmlValue: string;
+    plainValue: string;
+    params: ITextEditorParams;
 }
 /**
  * Represents a text with header form data entity.
@@ -412,15 +450,21 @@ interface IBodyTypeText {
 interface IBodyTypeTextWithHeader {
     marker: string;
     type: 'textWithHeader';
-    value: {
-        header: string;
-        htmlValue: string;
-        plainValue: string;
-        params: {
-            isEditorDisabled: boolean;
-            isImageCompressed: boolean;
-        };
-    };
+    value: ITextWithHeaderValue;
+}
+/**
+ * @interface ITextWithHeaderValue
+ * @property {string} header - Headline text. Example: "Headline".
+ * @property {string} htmlValue - HTML body. Example: "<p>Hello world</p>".
+ * @property {string} plainValue - Plain-text body.
+ * @property {ITextEditorParams} params - Editor configuration applied to this value.
+ * @description Value payload for `textWithHeader` form fields.
+ */
+interface ITextWithHeaderValue {
+    header: string;
+    htmlValue: string;
+    plainValue: string;
+    params: ITextEditorParams;
 }
 /**
  * Represents an image or group of images form data entity.
@@ -445,23 +489,31 @@ interface IBodyTypeTextWithHeader {
 interface IBodyTypeImageGroupOfImages {
     marker: string;
     type: 'image' | 'groupOfImage';
-    value: {
-        filename: string;
-        downloadLink: string;
-        size: number;
-        previewLink: string;
-        params: {
-            isImageCompressed: boolean;
-        };
-    } | Array<{
-        filename: string;
-        downloadLink: string;
-        size: number;
-        previewLink: string;
-        params: {
-            isImageCompressed: boolean;
-        };
-    }>;
+    value: IImageValue | IImageValue[];
+}
+/**
+ * @interface IImageValueParams
+ * @property {boolean} isImageCompressed - Whether the stored image has been compressed by the server. Example: true.
+ * @description Per-image parameters attached to an image form value.
+ */
+interface IImageValueParams {
+    isImageCompressed: boolean;
+}
+/**
+ * @interface IImageValue
+ * @property {string} filename - Server-side path to the image. Example: "files/project/page/10/image/foo.png".
+ * @property {string} downloadLink - Public URL to download the image.
+ * @property {number} size - File size in bytes. Example: 392585.
+ * @property {string} previewLink - URL to a preview-sized version (may be empty).
+ * @property {IImageValueParams} params - Image-specific parameters.
+ * @description Value payload for `image`/`groupOfImage` form fields.
+ */
+interface IImageValue {
+    filename: string;
+    downloadLink: string;
+    size: number;
+    previewLink: string;
+    params: IImageValueParams;
 }
 /**
  * Represents a file form data entity.
@@ -482,11 +534,19 @@ interface IBodyTypeImageGroupOfImages {
 interface IBodyTypeFile {
     marker: string;
     type: 'file';
-    value: {
-        filename: string;
-        downloadLink: string;
-        size: number;
-    };
+    value: IFileValue;
+}
+/**
+ * @interface IFileValue
+ * @property {string} filename - Server-side path to the file.
+ * @property {string} downloadLink - Public URL to download the file.
+ * @property {number} size - File size in bytes.
+ * @description Value payload for `file` form fields.
+ */
+interface IFileValue {
+    filename: string;
+    downloadLink: string;
+    size: number;
 }
 /**
  * Represents a radio button or list selection form data entity.
@@ -510,13 +570,28 @@ interface IBodyTypeFile {
 interface IBodyTypeRadioButtonList {
     marker: string;
     type: 'list' | 'radioButton';
-    value: Array<{
-        title: string;
-        value: string;
-        extended: {
-            value: string;
-            type: string;
-        };
-    }>;
+    value: IListOptionValue[];
+}
+/**
+ * @interface IListOptionExtended
+ * @property {string} value - Extended option value (e.g. color code "#ff0000"). Example: "red".
+ * @property {string} type - Type of the extended value (e.g. "string", "color"). Example: "string".
+ * @description Extended payload attached to a list/radio option.
+ */
+interface IListOptionExtended {
+    value: string;
+    type: string;
+}
+/**
+ * @interface IListOptionValue
+ * @property {string} title - Option title shown to the user.
+ * @property {string} value - Underlying option value.
+ * @property {IListOptionExtended} extended - Extended payload (e.g. color/code) attached to the option.
+ * @description Value payload for `list`/`radioButton` form fields.
+ */
+interface IListOptionValue {
+    title: string;
+    value: string;
+    extended: IListOptionExtended;
 }
-export type { FormDataType, IBodyPostFormData, IBodyTypeFile, IBodyTypeImageGroupOfImages, IBodyTypeRadioButtonList, IBodyTypeStringNumberFloat, IBodyTypeText, IBodyTypeTextWithHeader, IBodyTypeTimeDate, IFormByMarkerDataEntity, IFormDataEntity, IFormsByMarkerDataEntity, IFormsData, IFormsDataEntity, IPostFormResponse, IUpdateFormsData, };
+export type { FormDataType, IBodyPostFormData, IBodyTypeFile, IBodyTypeImageGroupOfImages, IBodyTypeRadioButtonList, IBodyTypeStringNumberFloat, IBodyTypeText, IBodyTypeTextWithHeader, IBodyTypeTimeDate, IFileValue, IFormByMarkerDataEntity, IFormDataEntity, IFormsByMarkerDataEntity, IFormsData, IFormsDataEntity, IImageValue, IImageValueParams, IListOptionExtended, IListOptionValue, IPostFormResponse, IPostFormResponseData, ITextEditorParams, ITextValue, ITextWithHeaderValue, ITimeDateValue, IUpdateFormsData, };

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

@@ -19,12 +19,12 @@ export declare const GeneralTypeEntitySchema: z.ZodObject<{
         product_preview: "product_preview";
         similar_products_block: "similar_products_block";
         product_block: "product_block";
+        frequently_ordered_block: "frequently_ordered_block";
         common_page: "common_page";
         common_block: "common_block";
         service: "service";
         external_page: "external_page";
         discount: "discount";
-        frequently_ordered_block: "frequently_ordered_block";
     }>;
 }, z.core.$strip>;
 /**
@@ -42,11 +42,11 @@ export declare const GeneralTypesResponseSchema: z.ZodArray<z.ZodObject<{
         product_preview: "product_preview";
         similar_products_block: "similar_products_block";
         product_block: "product_block";
+        frequently_ordered_block: "frequently_ordered_block";
         common_page: "common_page";
         common_block: "common_block";
         service: "service";
         external_page: "external_page";
         discount: "discount";
-        frequently_ordered_block: "frequently_ordered_block";
     }>;
 }, z.core.$strip>>;

package/dist/menus/menusInterfaces.d.ts

@@ -82,6 +82,6 @@ interface IMenusEntity {
     id: number;
     identifier: string;
     localizeInfos: ILocalizeInfo;
-    pages: IMenusPages[] | IMenusPages;
+    pages: IMenusPages[];
 }
 export type { IMenus, IMenusEntity, IMenusPages };

package/dist/orders/ordersInterfaces.d.ts

@@ -316,7 +316,7 @@ interface IOrderProductsData {
  * @property {string} [statusIdentifier] - Text identifier of order status object (if not set, default status will be assigned). Example: "status-1".
  * @property {string} [couponCode] -
  * @property {string[]} [additionalDiscountsMarkers] -
- * @property {unknown} [discountConfig] -
+ * @property {IOrderDiscountConfig} [discountConfig] - Resolved discount configuration applied to the order.
  * @property {number} [bonusAmount] - Bonus amount applied to the order.
  * @property {number} [bonusApplied] - Bonus applied to the order.
  * @property {number} [totalDue] - Total due after bonuses.
@@ -333,11 +333,67 @@ interface IBaseOrdersEntity {
     statusIdentifier?: string;
     couponCode?: string;
     additionalDiscountsMarkers?: string[];
-    discountConfig?: unknown;
+    discountConfig?: IOrderDiscountConfig;
     bonusAmount?: number;
     bonusApplied?: number;
     totalDue?: number;
 }
+/**
+ * @interface IOrderDiscountBonus
+ * @property {number} availableBalance - User bonus balance available at the moment of calculation. Example: 0.
+ * @property {number} bonusApplied - Bonus amount actually applied to this order. Example: 0.
+ * @property {number} maxBonusDiscount - Maximum bonus amount allowed to be spent on this order. Example: 0.
+ * @property {number | null} minBonusAmount - Minimum bonus balance required to use bonuses, or null if no threshold. Example: null.
+ * @property {number | null} minOrderAmountForBonus - Minimum order total required to apply bonuses, or null if no threshold. Example: null.
+ * @description Bonus subsection of the order discount configuration.
+ */
+interface IOrderDiscountBonus {
+    availableBalance: number;
+    bonusApplied: number;
+    maxBonusDiscount: number;
+    minBonusAmount: number | null;
+    minOrderAmountForBonus: number | null;
+}
+/**
+ * @interface IOrderDiscountSettings
+ * @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.
+ * @description Stacking and cap settings for the order discount engine.
+ */
+interface IOrderDiscountSettings {
+    allowGiftStacking: boolean;
+    allowStacking: boolean;
+    maxDiscountValue: number | null;
+}
+/**
+ * @interface IOrderDiscountConfig
+ * @property {IOrderDiscountBonus | null} bonus - Bonus calculation result, or null when bonuses are not used.
+ * @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.
+ * @property {IOrderDiscountSettings} settings - Stacking and cap settings used during calculation.
+ * @property {string[]} [additionalDiscountsMarkers] - Markers of extra discounts requested by the client (omitted in preview responses).
+ * @property {number} [bonusApplied] - Bonus amount applied to the order (omitted in preview responses). Example: 0.
+ * @property {string[]} [excludedGiftProductIds] - Product ids excluded from gift selection (omitted in preview responses).
+ * @property {number} [totalDue] - Total amount due after discounts and bonuses (omitted in preview responses). Example: 300.
+ * @property {number} [totalRaw] - Total amount before discounts (omitted in preview responses). Example: 300.
+ * @property {number} [totalSumWithDiscount] - Total amount after discounts but before bonuses (omitted in preview responses). Example: 300.
+ * @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;
+    coupon: unknown | null;
+    orderDiscounts: unknown[];
+    productDiscounts: unknown[];
+    settings: IOrderDiscountSettings;
+    additionalDiscountsMarkers?: string[];
+    bonusApplied?: number;
+    excludedGiftProductIds?: string[];
+    totalDue?: number;
+    totalRaw?: number;
+    totalSumWithDiscount?: number;
+}
 /**
  * Interface representing a response from the order storage.
  * @interface IBaseOrdersEntityResponse
@@ -450,11 +506,10 @@ interface IOrderData {
  * @property {string} totalSum - Total order amount. 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 {Record<string, unknown>} paymentAccountLocalizeInfos - Payment account name considering localization.
+ * @property {ILocalizeInfo} [paymentAccountLocalizeInfos] - Payment account name considering localization.
  * @example
   {
-    "en_US": "USD Payment",
-    "ru_RU": "Оплата в долларах США"
+    "title": "Cash"
   }
  * @property {IOrderProducts[]} products - Array of products added to order.
  * @example
@@ -467,7 +522,7 @@ 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 {object} [statusLocalizeInfos] - Localization information.
+ * @property {ILocalizeInfo} [statusLocalizeInfos] - Localized status name.
  * @description Represents an order storage object created by the user.
  */
 interface IOrderByMarkerEntity {
@@ -481,17 +536,17 @@ interface IOrderByMarkerEntity {
     totalSum: string;
     currency: string;
     paymentAccountIdentifier?: string;
-    paymentAccountLocalizeInfos?: Record<string, unknown>;
+    paymentAccountLocalizeInfos?: ILocalizeInfo;
     paymentUrl: string | null;
     products: IOrderProducts[];
     isCompleted: boolean | null;
-    statusLocalizeInfos?: object;
+    statusLocalizeInfos?: ILocalizeInfo;
 }
 /**
  * Interface representing an order status object.
  * @interface IOrderStatus
  * @property {number} [id] - Status identifier. Example: 1.
- * @property {object} [localizeInfos] - Localized information for the status.
+ * @property {ILocalizeInfo} [localizeInfos] - Localized information for the status.
  * @property {string} [identifier] - Text identifier of the status. Example: "inProgress".
  * @property {number} [position] - Position of the status. Example: 1.
  * @property {boolean} [isUsed] - Whether the status is in use. Example: true.
@@ -499,7 +554,7 @@ interface IOrderByMarkerEntity {
  */
 interface IOrderStatus {
     id?: number;
-    localizeInfos?: object;
+    localizeInfos?: ILocalizeInfo;
     identifier?: string;
     position?: number;
     isUsed?: boolean;
@@ -514,7 +569,6 @@ interface IOrderStatus {
 interface IPreviewOrderProduct {
     productId?: number;
     quantity?: number;
-    [key: string]: unknown;
 }
 /**
  * Interface representing the body for order preview calculation.
@@ -529,21 +583,29 @@ interface ICreateOrderPreview {
     couponCode?: string;
     additionalDiscountsMarkers?: string[];
     bonusAmount?: number;
-    [key: string]: unknown;
 }
 /**
- * Interface representing a single item in an order preview.
  * @interface IOrderPreviewItem
+ * @property {number} id - Product identifier. Example: 2954.
+ * @property {number} price - Product unit price before discounts. Example: 51.
+ * @property {number} quantity - Quantity of the product. Example: 1.
+ * @property {number | null} discountPrice - Unit price after discounts, or null when no discount applies. Example: null.
+ * @property {boolean} isGift - Whether the product is delivered as a gift. Example: false.
+ * @description A single line item in the order preview response.
  */
 interface IOrderPreviewItem {
-    [key: string]: unknown;
+    id: number;
+    price: number;
+    quantity: number;
+    discountPrice: number | null;
+    isGift: boolean;
 }
 /**
  * Interface representing the response from an order preview calculation.
  * @interface IOrderPreviewResponse
  * @property {number} totalSum - Total order amount before discounts. Example: 300.
  * @property {number} totalSumWithDiscount - Total order amount after discounts. Example: 250.
- * @property {unknown} discountConfig - Discount configuration applied to the order.
+ * @property {IOrderDiscountConfig} discountConfig - Discount configuration applied to the order.
  * @property {string} currency - Currency of the order. Example: "USD".
  * @property {IOrderPreviewItem[]} orderPreview - Array of order preview items.
  * @property {number} bonusApplied - Bonus applied to the order.
@@ -552,7 +614,7 @@ interface IOrderPreviewItem {
 interface IOrderPreviewResponse {
     totalSum: number;
     totalSumWithDiscount: number;
-    discountConfig: unknown;
+    discountConfig: IOrderDiscountConfig;
     currency: string;
     orderPreview: IOrderPreviewItem[];
     bonusApplied: number;
@@ -565,7 +627,7 @@ interface IOrderPreviewResponse {
  * @property {string} status - Refund status.
  * @property {number} amount - Refund amount.
  * @property {string} note - Refund note.
- * @property {Record<string, unknown>} products - Products for refund.
+ * @property {Record<string, IRefundProduct>} products - Map of product id to refund details.
  * @property {number} orderId - Order id.
  * @property {number} orderStorageId - Order storage id.
  * @property {number} userId - User id.
@@ -578,7 +640,7 @@ interface IRefundRequest {
     status: string;
     amount: number;
     note: string;
-    products: Record<string, unknown>;
+    products: Record<string, IRefundProduct>;
     orderId: number;
     orderStorageId: number;
     userId: number;
@@ -603,4 +665,4 @@ interface ICreateRefundRequest {
     products: Record<string, IRefundProduct>;
     note?: string;
 }
-export type { IBaseOrdersEntity, IBaseOrdersEntityResponse, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, 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, IOrderStatus, IPaymentAccountIdentifiers, IPicture, IPreviewOrderProduct, IRefundProduct, IRefundRequest, };