oneentry 1.0.141 → 1.0.142

package/dist/base/utils.d.ts

@@ -1,197 +0,0 @@
-/**
- * @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' | 'none';
-/**
- * @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.
- * @property {boolean} [rawData] - Set to true to receive raw API responses without any transformation.
- * @property {object} [validation] - Validation settings for API responses.
- * @property {boolean} [auth] - An object with authorization settings.
- * @property {boolean} [auth.customAuth] - Set this flag to true if you want to configure the authorization process yourself. Set the flag to false, or do not pass it at all to have automatic authorization and token renewal.
- * @property {boolean} [auth.refreshToken] - Transfer the refresh token here, for example from the local storage, to resume the user's session. Otherwise, the user will need to log in every time a new session is created.
- * @property {boolean} [auth.providerMarker] - The marker of the provider, for example, email, google, facebook, etc. Default 'email';
- * @property {boolean} [auth.saveFunction] - If you want to store the token between sessions, for example in local storage, create a custom function that takes refreshToken as a parameter and executes the necessary instructions. This function will be called every time the tokens are updated.
- * @property {object} [errors] - Error handling settings.
- * @example
- * ```ts
- * const saveToken = (token) => {
- *     localStorage.setItem('refresh', token)
- * }
- *
- * const config = {
- *     token: 'project.token.here',
- *     langCode: 'en_US',
- *     multipleRequests: true,
- *     auth: {
- *         customAuth: false,
- *         refreshToken: 'user.refresh.token',
- *         providerMarker: 'email',
- *         saveFunction: saveToken
- *     },
- *     errors: {
- *         isShell: true,
- *         customErrors: {
- *             '400': badRequestFunction,
- *             '404': notFoundFunction,
- *             '429': rateLimitFunction,
- *             '500': serverErrorFunction,
- *             '503': serviceUnavailableFunction
- *         }
- *     }
- * }
- * ```
- */
-interface IConfig {
-    token?: string;
-    langCode?: string;
-    traficLimit?: boolean;
-    rawData?: boolean;
-    validation?: {
-        enabled?: boolean;
-        strictMode?: boolean;
-        logErrors?: boolean;
-    };
-    auth?: {
-        customAuth?: boolean;
-        refreshToken?: string;
-        providerMarker?: string;
-        saveFunction?: (refreshToken: string) => void;
-    };
-    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;
-        };
-    };
-}
-/**
- * @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.
- */
-interface IAttributes {
-    listTitles: Array<{
-        title: string;
-        value: number | string | null;
-        position: number;
-        extended: {
-            value: string | number | null;
-            type: string | number | null;
-        };
-    }>;
-    localizeInfos: ILocalizeInfo;
-    marker: string;
-    position: number;
-    isVisible: boolean;
-    type: string;
-    settings?: Record<string, any>;
-    validators: Record<string, any>;
-    additionalFields?: any;
-    [key: string]: any;
-}
-/**
- * @interface ILocalizeInfos
- * @property {Record<string, ILocalizeInfo>} - Localization information.
- * @description Interface for localization information.
- */
-interface ILocalizeInfos {
-    [key: string]: ILocalizeInfo;
-}
-/**
- * Interface for localization information.
- * @property {Record<string, any>} - Localization information.
- * @description Interface for localization information.
- */
-interface ILocalizeInfo {
-    [key: string]: any;
-}
-/**
- * @interface IAttributeValues
- * @property {Record<string, IAttributeValue>} - Attribute values.
- * @description Interface for attribute values.
- */
-interface IAttributeValues {
-    [key: string]: IAttributeValue;
-}
-/**
- * @interface IAttributeValue
- * @property {Record<string, any>} - Attribute value.
- * @description Interface for attribute value.
- */
-interface IAttributeValue {
-    [key: string]: any;
-}
-/**
- * @interface IError
- * @property {string} message - Error message.
- * @property {any} pageData - Page data.
- * @property {number} statusCode - Status code.
- * @property {string} timestamp - Timestamp.
- * @property {Record<string, any>} - Attribute value.
- * @description Interface for error.
- */
-interface IError {
-    message: string;
-    pageData: any;
-    statusCode: number;
-    timestamp: string;
-    [key: string]: any;
-}
-/**
- * @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
- */
-interface IHttpHeaders {
-    'Content-Type'?: string;
-    'x-app-token'?: string;
-    'x-device-metadata'?: string;
-    Authorization?: string;
-    [key: string]: string | undefined;
-}
-/**
- * @interface IHttpOptions
- * @property {string} method - HTTP method
- * @property {IHttpHeaders} headers - HTTP headers
- * @property {string | FormData | Blob} [body] - Request body
- * @description Interface for HTTP request options
- */
-interface IHttpOptions {
-    method: string;
-    headers: IHttpHeaders;
-    body?: string | FormData | Blob;
-}
-/**
- * AttributeType
- */
-type AttributeType = IAttributeValue | IAttributeValues;
-/**
- * LangType
- */
-type LangType = string | Array<string>;
-/**
- * LocalizeType
- */
-type LocalizeType = ILocalizeInfos | ILocalizeInfo;
-export type { AttributeType, IAttributes, IAttributeValues, IConfig, IError, IHttpHeaders, IHttpOptions, ILocalizeInfo, ILocalizeInfos, LangType, LocalizeType, Types, };

package/dist/base/utils.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/base/validation.d.ts

@@ -1,118 +0,0 @@
-import { z } from 'zod';
-/**
- * Common validation schemas for API responses
- * @description Base schemas that can be reused across different modules
- */
-/**
- * Error response schema
- */
-export declare const ErrorSchema: z.ZodObject<{
-    statusCode: z.ZodNumber;
-    message: z.ZodString;
-    localizeMessage: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Localize info schema
- */
-export declare const LocalizeInfoSchema: z.ZodObject<{
-    title: z.ZodString;
-    content: z.ZodOptional<z.ZodString>;
-    menuTitle: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Attribute schema
- */
-export declare const AttributeSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodNumber>;
-    marker: z.ZodString;
-    type: z.ZodString;
-    isVisible: z.ZodOptional<z.ZodBoolean>;
-    isRequired: z.ZodOptional<z.ZodBoolean>;
-    position: z.ZodOptional<z.ZodNumber>;
-    localizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        title: z.ZodString;
-        content: z.ZodOptional<z.ZodString>;
-        menuTitle: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    value: z.ZodOptional<z.ZodAny>;
-}, z.core.$strip>;
-/**
- * User entity schema
- */
-export declare const UserEntitySchema: z.ZodObject<{
-    id: z.ZodNumber;
-    identifier: z.ZodOptional<z.ZodString>;
-    email: z.ZodOptional<z.ZodString>;
-    phoneMask: z.ZodOptional<z.ZodString>;
-    phoneCode: z.ZodOptional<z.ZodString>;
-    phoneNumber: z.ZodOptional<z.ZodString>;
-    statusMarker: z.ZodOptional<z.ZodString>;
-    formData: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
-    total: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-    authProviderIdentifier: z.ZodOptional<z.ZodString>;
-    formIdentifier: z.ZodOptional<z.ZodString>;
-    groups: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-    state: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
-}, z.core.$strip>;
-/**
- * Auth entity schema
- * API returns only accessToken and refreshToken
- * userIdentifier and authProviderIdentifier are optional legacy fields
- */
-export declare const AuthEntitySchema: z.ZodObject<{
-    accessToken: z.ZodString;
-    refreshToken: z.ZodString;
-    userIdentifier: z.ZodOptional<z.ZodString>;
-    authProviderIdentifier: z.ZodOptional<z.ZodString>;
-    user: z.ZodOptional<z.ZodObject<{
-        id: z.ZodNumber;
-        identifier: z.ZodOptional<z.ZodString>;
-        email: z.ZodOptional<z.ZodString>;
-        phoneMask: z.ZodOptional<z.ZodString>;
-        phoneCode: z.ZodOptional<z.ZodString>;
-        phoneNumber: z.ZodOptional<z.ZodString>;
-        statusMarker: z.ZodOptional<z.ZodString>;
-        formData: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
-        total: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-        authProviderIdentifier: z.ZodOptional<z.ZodString>;
-        formIdentifier: z.ZodOptional<z.ZodString>;
-        groups: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-        state: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-/**
- * Paginated response schema factory
- * @param {T} itemSchema - The schema for each item in the paginated response
- * @returns {any} Paginated response schema
- */
-export declare function createPaginatedSchema<T extends z.ZodTypeAny>(itemSchema: T): any;
-/**
- * Validation helper function
- * @param {z.ZodSchema<T>} schema - Zod schema to validate against
- * @param {unknown} data - Data to validate
- * @param {object} options - Validation options
- * @param {boolean} options.strict - Whether to use strict mode
- * @param {boolean} options.logErrors - Whether to log errors
- * @returns {object} Validated data or error
- */
-export declare function validateResponse<T>(schema: z.ZodSchema<T>, data: unknown, options?: {
-    strict?: boolean;
-    logErrors?: boolean;
-}): {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    error: z.ZodError;
-};
-/**
- * Safe validation helper - returns data even if validation fails
- * Used when strict mode is disabled
- * @param {z.ZodSchema<T>} schema - Zod schema to validate against
- * @param {unknown} data - Data to validate
- * @param {boolean} logErrors - Whether to log errors
- * @returns {T} Validated data or original data if validation fails in non-strict mode
- */
-export declare function validateResponseSafe<T>(schema: z.ZodSchema<T>, data: unknown, logErrors?: boolean): T;

package/dist/base/validation.js

@@ -1,132 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AuthEntitySchema = exports.UserEntitySchema = exports.AttributeSchema = exports.LocalizeInfoSchema = exports.ErrorSchema = void 0;
-exports.createPaginatedSchema = createPaginatedSchema;
-exports.validateResponse = validateResponse;
-exports.validateResponseSafe = validateResponseSafe;
-/* eslint-disable jsdoc/reject-any-type */
-/* eslint-disable jsdoc/no-undefined-types */
-const zod_1 = require("zod");
-/**
- * Common validation schemas for API responses
- * @description Base schemas that can be reused across different modules
- */
-/**
- * Error response schema
- */
-exports.ErrorSchema = zod_1.z.object({
-    statusCode: zod_1.z.number(),
-    message: zod_1.z.string(),
-    localizeMessage: zod_1.z.string().optional(),
-});
-/**
- * Localize info schema
- */
-exports.LocalizeInfoSchema = zod_1.z.object({
-    title: zod_1.z.string(),
-    content: zod_1.z.string().optional(),
-    menuTitle: zod_1.z.string().optional(),
-});
-/**
- * Attribute schema
- */
-exports.AttributeSchema = zod_1.z.object({
-    id: zod_1.z.number().optional(),
-    marker: zod_1.z.string(),
-    type: zod_1.z.string(),
-    isVisible: zod_1.z.boolean().optional(),
-    isRequired: zod_1.z.boolean().optional(),
-    position: zod_1.z.number().optional(),
-    localizeInfos: zod_1.z.record(zod_1.z.string(), exports.LocalizeInfoSchema).optional(),
-    value: zod_1.z.any().optional(),
-});
-/**
- * User entity schema
- */
-exports.UserEntitySchema = zod_1.z.object({
-    id: zod_1.z.number(),
-    identifier: zod_1.z.string().optional(),
-    email: zod_1.z.string().email().optional(),
-    phoneMask: zod_1.z.string().optional(),
-    phoneCode: zod_1.z.string().optional(),
-    phoneNumber: zod_1.z.string().optional(),
-    statusMarker: zod_1.z.string().optional(),
-    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())])
-        .optional(),
-    total: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).optional(),
-    authProviderIdentifier: zod_1.z.string().optional(),
-    formIdentifier: zod_1.z.string().optional(),
-    groups: zod_1.z.array(zod_1.z.number()).optional(),
-    state: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
-    moduleFormConfigs: zod_1.z.array(zod_1.z.any()).optional(),
-});
-/**
- * Auth entity schema
- * API returns only accessToken and refreshToken
- * userIdentifier and authProviderIdentifier are optional legacy fields
- */
-exports.AuthEntitySchema = zod_1.z.object({
-    accessToken: zod_1.z.string(),
-    refreshToken: zod_1.z.string(),
-    userIdentifier: zod_1.z.string().optional(),
-    authProviderIdentifier: zod_1.z.string().optional(),
-    user: exports.UserEntitySchema.optional(),
-});
-/**
- * Paginated response schema factory
- * @param {T} itemSchema - The schema for each item in the paginated response
- * @returns {any} Paginated response schema
- */
-function createPaginatedSchema(itemSchema) {
-    return zod_1.z.object({
-        items: zod_1.z.array(itemSchema),
-        total: zod_1.z.number(),
-        page: zod_1.z.number().optional(),
-        limit: zod_1.z.number().optional(),
-    });
-}
-/**
- * Validation helper function
- * @param {z.ZodSchema<T>} schema - Zod schema to validate against
- * @param {unknown} data - Data to validate
- * @param {object} options - Validation options
- * @param {boolean} options.strict - Whether to use strict mode
- * @param {boolean} options.logErrors - Whether to log errors
- * @returns {object} Validated data or error
- */
-function validateResponse(schema, data, options) {
-    try {
-        const validated = schema.parse(data);
-        return { success: true, data: validated };
-    }
-    catch (error) {
-        if (error instanceof zod_1.z.ZodError) {
-            if (options === null || options === void 0 ? void 0 : options.logErrors) {
-                // eslint-disable-next-line no-undef, no-console
-                console.error('Validation error:', {
-                    errors: error.issues,
-                    data,
-                });
-            }
-            return { success: false, error };
-        }
-        throw error;
-    }
-}
-/**
- * Safe validation helper - returns data even if validation fails
- * Used when strict mode is disabled
- * @param {z.ZodSchema<T>} schema - Zod schema to validate against
- * @param {unknown} data - Data to validate
- * @param {boolean} logErrors - Whether to log errors
- * @returns {T} Validated data or original data if validation fails in non-strict mode
- */
-function validateResponseSafe(schema, data, logErrors = false) {
-    const result = validateResponse(schema, data, { logErrors });
-    if (result.success) {
-        return result.data;
-    }
-    // Return original data if validation fails in non-strict mode
-    return data;
-}

package/dist/blocks/blocksApi.d.ts

@@ -1,76 +0,0 @@
-import AsyncModules from '../base/asyncModules';
-import type StateModule from '../base/stateModule';
-import type { IError } from '../base/utils';
-import type { BlockType, IBlockEntity, IBlocks, IBlocksResponse, ISearchBlock } from './blocksInterfaces';
-/**
- * Controllers for working with blocks.
- * @handle /api/content/blocks
- * @class BlocksApi
- * @augments AsyncModules
- * @implements {IBlocks}
- * @description This class provides methods to interact with blocks.
- */
-export default class BlocksApi extends AsyncModules implements IBlocks {
-    protected state: StateModule;
-    protected _url: string;
-    /**
-     * Constructor for BlocksApi class.
-     */
-    constructor(state: StateModule);
-    /**
-     * 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 {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
-     */
-    getBlocks(type?: BlockType, langCode?: string, offset?: number, limit?: number): Promise<IBlocksResponse | IError>;
-    /**
-     * Get block by marker.
-     * @handleName getBlockByMarker
-     * @param {string} marker - Marker of Block. Example: "product_block".
-     * @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<IBlockEntity | IError>} - Returns a BlockEntity object.
-     * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method retrieves a block by its marker and includes additional information such as similar products or products associated with the block.
-     */
-    getBlockByMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IBlockEntity | IError>;
-    /**
-     * Get similar products by block marker.
-     * @handleName getSimilarProducts
-     * @param {string} marker - Block identifier. Example: "similar_products_block".
-     * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @param {string} [signPrice] - Sign price.
-     * @returns {Promise<IProductsResponse | IError>} - Returns the total count and an array of product items in object by specified block marker.
-     * @throws {IError} When isShell=false and an error occurs during the fetch
-     */
-    private getSimilarProducts;
-    /**
-     * Get products by block marker.
-     * @handleName getProductsByBlockMarker
-     * @param {string} marker - Block identifier. Example: "product_block".
-     * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Parameter for pagination. Default: 0.
-     * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @param {string} [signPrice] - Sign price.
-     * @returns {Promise<IProductsEntity[] | IError>} Return array of BlocksEntity object.
-     * @throws {IError} When isShell=false and an error occurs during the fetch
-     */
-    private getProductsByBlockMarker;
-    /**
-     * Quick search for block objects with limited output.
-     * @handleName searchBlock
-     * @param {string} name - Search string. Example: "product_block".
-     * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<ISearchBlock[] | IError>} Returns an array of ISearchBlock objects.
-     * @throws {IError} When isShell=false and an error occurs during the fetch
-     */
-    searchBlock(name: string, langCode?: string): Promise<ISearchBlock[] | IError>;
-}