oneentry 1.0.142 → 1.0.143

package/dist/orders/ordersSchemas.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateOrderResponseSchema = exports.CreateOrderResponseSchema = exports.OrdersStorageResponseSchema = exports.OrderStorageSchema = exports.OrdersResponseSchema = exports.OrderEntitySchema = exports.OrderItemSchema = void 0;
+/**
+ * Validation schemas for Orders module
+ * @description Zod schemas for validating orders-related API responses
+ */
+const zod_1 = require("zod");
+/**
+ * Order item schema
+ * @description Order item schema for validating orders-related API responses
+ */
+exports.OrderItemSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    productId: zod_1.z.number(),
+    quantity: zod_1.z.number(),
+    price: zod_1.z.number(),
+    total: zod_1.z.number(),
+    attributes: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+});
+/**
+ * Order entity schema
+ * @description Order entity schema for validating orders-related API responses
+ */
+exports.OrderEntitySchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    storageId: zod_1.z.number().optional(),
+    createdDate: zod_1.z.string().optional(),
+    statusIdentifier: zod_1.z.string().optional(),
+    formIdentifier: 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(),
+    attributeSetIdentifier: zod_1.z.string().optional().nullable(),
+    totalSum: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).optional(),
+    currency: zod_1.z.string().optional(),
+    paymentAccountIdentifier: zod_1.z.string().optional().nullable(),
+    paymentAccountLocalizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+    paymentUrl: zod_1.z.string().optional().nullable(),
+    products: zod_1.z.array(zod_1.z.any()).optional(),
+    isCompleted: zod_1.z.boolean().optional().nullable(),
+    statusLocalizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+});
+/**
+ * Orders list response schema
+ * @returns Orders list response schema
+ */
+exports.OrdersResponseSchema = zod_1.z.object({
+    items: zod_1.z.array(exports.OrderEntitySchema),
+    total: zod_1.z.number(),
+});
+/**
+ * Order storage schema
+ * @returns Order storage validation schema
+ */
+exports.OrderStorageSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    identifier: zod_1.z.string().nullable(),
+    localizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()),
+    formIdentifier: zod_1.z.string().nullable(),
+    generalTypeId: zod_1.z.number().nullable(),
+    paymentAccountIdentifiers: zod_1.z.array(zod_1.z.object({ identifier: zod_1.z.string() })),
+    position: zod_1.z.number().nullable(),
+});
+/**
+ * Orders storage list response schema
+ * @returns Orders storage list response schema
+ */
+exports.OrdersStorageResponseSchema = zod_1.z.array(exports.OrderStorageSchema);
+/**
+ * Create order response schema
+ * API returns a simplified order object after creation
+ * @returns Create order response schema
+ */
+exports.CreateOrderResponseSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    formIdentifier: zod_1.z.string().optional(),
+    paymentAccountIdentifier: 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(),
+    products: zod_1.z.array(zod_1.z.any()).optional(),
+    currency: zod_1.z.string().optional(),
+    totalSum: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).optional(),
+    createdDate: zod_1.z.string().optional(),
+});
+/**
+ * Update order response schema
+ * API returns the full order object after update
+ */
+exports.UpdateOrderResponseSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    formIdentifier: zod_1.z.string().optional(),
+    paymentAccountIdentifier: 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(),
+    products: zod_1.z.array(zod_1.z.any()).optional(),
+    currency: zod_1.z.string().optional(),
+    totalSum: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).optional(),
+});

package/dist/pages/pagesApi.d.ts

@@ -0,0 +1,151 @@
+import AsyncModules from '../base/asyncModules';
+import type StateModule from '../base/stateModule';
+import type { IError } from '../base/utils';
+import type { IPageConfig, IPagesApi, IPagesEntity, IPositionBlock } from './pagesInterfaces';
+/**
+ * Controllers for working with page objects, including catalog pages
+ * @handle /api/content/pages
+ * @description Controllers for working with page objects, including catalog pages
+ */
+export default class PagesApi extends AsyncModules implements IPagesApi {
+    protected state: StateModule;
+    protected _url: string;
+    /**
+     * Constructor
+     * @param {StateModule} state - The state module.
+     * @description Constructor initializes the PageApi with a given state.
+     */
+    constructor(state: StateModule);
+    /**
+     * Get all top-level page objects.
+     * @handleName getRootPages
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages without parents as an array of PageEntity objects or an empty array [] (if there is no data)
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get all top-level page objects.
+     */
+    getRootPages(langCode?: string): Promise<IPagesEntity[] | IError>;
+    /**
+     * Get all page objects with product information as an array.
+     * @handleName getPages
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data).
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get all page objects with product information as an array.
+     */
+    getPages(langCode?: string): Promise<IPagesEntity[] | IError>;
+    /**
+     * Get page object with information about forms, blocks, menus, linked to the page.
+     * @handleName getPageById
+     * @param {number} id - The unique identifier of the page to be fetched. Example: 1.
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity | IError>} Returns PageEntity object
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get page object with information about forms, blocks, menus, linked to the page.
+     */
+    getPageById(id: number, langCode?: string): Promise<IPagesEntity | IError>;
+    /**
+     * Get page object with information about forms, blocks, menus, linked to the page by URL.
+     * @handleName getPageByUrl
+     * @param {string} url - Page URL. Example: "about".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity | IError>} Returns PageEntity object
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get page object with information about forms, blocks, menus, linked to the page by URL.
+     */
+    getPageByUrl(url: string, langCode?: string): Promise<IPagesEntity | IError>;
+    /**
+     * Get child pages object with information as an array.
+     * @handleName getChildPagesByParentUrl
+     * @param {string} url - The URL of the parent page for which child pages are to be fetched. Example: "about/our-team".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data) for the selected parent
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get child pages object with information as an array.
+     */
+    getChildPagesByParentUrl(url: string, langCode?: string): Promise<IPagesEntity[] | IError>;
+    /**
+     * Get all blocks by page url.
+     * @handleName getBlocksByPageUrl
+     * @param {string} url - Page URL. Example: "about".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPositionBlock[] | IError>} Returns all blocks as an array of PositionBlock objects or an empty array [] (if there is no data) for the selected parent
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get all blocks by page url.
+     */
+    getBlocksByPageUrl(url: string, langCode?: string): Promise<IPositionBlock[] | IError>;
+    /**
+     * Get settings for the page.
+     * @handleName getConfigPageByUrl
+     * @param {string} url - Page URL. Example: "about".
+     * @returns {Promise<IPageConfig | IError>} Returns a ConfigPage object with page display settings
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get settings for the page.
+     */
+    getConfigPageByUrl(url: string): Promise<IPageConfig | IError>;
+    /**
+     * Quick search for page objects with limited output.
+     * @handleName searchPage
+     * @param {string} name - Text for searching page objects (search is performed on the title field of the localizeInfos object with the language taken into account). Example: "About Us".
+     * @param {string} [url] - Page URL. Example: "catalog".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data)
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Quick search for page objects with limited output.
+     */
+    searchPage(name: string, url?: string, langCode?: string): Promise<IPagesEntity[] | IError>;
+    /**
+     * Add template data to pages
+     * @handleName addTemplateToPages
+     * @param {IPagesEntity[]} data - An array of page objects (IPagesEntity[]) to which template data will be added.
+     * @example
+        [
+          {
+            "id": 8,
+            "parentId": null,
+            "moduleFormConfigs": [],
+            "pageUrl": "blog",
+            "depth": 0,
+            "localizeInfos": {
+              "title": "Blog",
+              "menuTitle": "Blog",
+              "htmlContent": "",
+              "plainContent": "",
+            },
+            "isVisible": true,
+            "forms": [],
+            "blocks": [],
+            "type": "common_page",
+            "templateIdentifier": "template",
+            "attributeSetIdentifier": "page",
+            "attributeValues": {},
+            "isSync": true,
+            "template": {
+              "id": 4,
+              "attributeSetIdentifier": null,
+              "title": "Template",
+              "generalTypeId": 4,
+              "identifier": "template",
+              "version": 0,
+              "generalTypeName": "catalog_page",
+              "attributeValues": {},
+              "position": 1,
+            }
+          }
+        ]
+     * @returns {Promise<any | IError>} An array of page objects with template data added
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Add template data to pages. Optimized to avoid N+1 query problem by fetching only unique templates in parallel.
+     * For example, if 100 pages use 3 different templates, this method makes 3 requests instead of 100.
+     */
+    protected addTemplateToPages(data: IPagesEntity[]): Promise<any | IError>;
+    /**
+     * Add template data to page by page templateIdentifier
+     * @handleName addTemplateToPage
+     * @param {IPagesEntity} data - Page object (IPagesEntity) to which template data will be added.
+     * @returns {Promise<any | IError>} An array of page objects with template data added
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Add template data to page by page templateIdentifier
+     */
+    protected addTemplateToPage(data: IPagesEntity): Promise<any | IError>;
+}

package/dist/pages/pagesApi.js

@@ -0,0 +1,390 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable jsdoc/reject-any-type */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const asyncModules_1 = __importDefault(require("../base/asyncModules"));
+const templatesApi_1 = __importDefault(require("../templates/templatesApi"));
+const pagesSchemas_1 = require("./pagesSchemas");
+/**
+ * Controllers for working with page objects, including catalog pages
+ * @handle /api/content/pages
+ * @description Controllers for working with page objects, including catalog pages
+ */
+class PagesApi extends asyncModules_1.default {
+    /**
+     * Constructor
+     * @param {StateModule} state - The state module.
+     * @description Constructor initializes the PageApi with a given state.
+     */
+    constructor(state) {
+        super(state);
+        this._url = state.url + '/api/content/pages';
+    }
+    /**
+     * Get all top-level page objects.
+     * @handleName getRootPages
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages without parents as an array of PageEntity objects or an empty array [] (if there is no data)
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get all top-level page objects.
+     */
+    async getRootPages(langCode = this.state.lang) {
+        // Fetch data from the server using a GET request to retrieve root pages for the specified language code
+        const data = await this._fetchGet(`/root?langCode=${langCode}`);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(data, pagesSchemas_1.PagesResponseSchema);
+        // Add template information to each page in the fetched root pages data
+        const withTemplate = await this.addTemplateToPages(validated);
+        // Normalize the data and return it; ensures consistent structure or handles errors
+        return this._normalizeData(withTemplate, langCode);
+    }
+    /**
+     * Get all page objects with product information as an array.
+     * @handleName getPages
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data).
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get all page objects with product information as an array.
+     */
+    async getPages(langCode = this.state.lang) {
+        // Fetch data from the server using a GET request to retrieve all pages for the specified language code
+        const data = await this._fetchGet(`?langCode=${langCode}`);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(data, pagesSchemas_1.PagesResponseSchema);
+        // Add template information to each page in the fetched data
+        const withTemplate = await this.addTemplateToPages(validated);
+        // Normalize the data and return it; ensures consistent structure or handles errors
+        return this._normalizeData(withTemplate, langCode);
+    }
+    /**
+     * Get page object with information about forms, blocks, menus, linked to the page.
+     * @handleName getPageById
+     * @param {number} id - The unique identifier of the page to be fetched. Example: 1.
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity | IError>} Returns PageEntity object
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get page object with information about forms, blocks, menus, linked to the page.
+     */
+    async getPageById(id, langCode = this.state.lang) {
+        // Fetch data from the server using a GET request to retrieve page details by ID and language code
+        const data = await this._fetchGet(`/${id}?langCode=${langCode}`);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(data, pagesSchemas_1.PageEntitySchema);
+        // Add template information to the fetched page data
+        const withTemplate = await this.addTemplateToPage(validated);
+        // Normalize the data and return it; ensures consistent structure or handles errors
+        return this._normalizeData(withTemplate, langCode);
+    }
+    /**
+     * Get page object with information about forms, blocks, menus, linked to the page by URL.
+     * @handleName getPageByUrl
+     * @param {string} url - Page URL. Example: "about".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity | IError>} Returns PageEntity object
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get page object with information about forms, blocks, menus, linked to the page by URL.
+     */
+    async getPageByUrl(url, langCode = this.state.lang) {
+        // Fetch data from the server using a GET request with the specified URL and language code
+        const data = await this._fetchGet(`/url/${url}?langCode=${langCode}`);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(data, pagesSchemas_1.PageEntitySchema);
+        // Add template information to the fetched page data
+        const withTemplate = await this.addTemplateToPage(validated);
+        // Normalize the result data and return it; ensures consistent structure or handles errors
+        return this._normalizeData(withTemplate, langCode);
+    }
+    /**
+     * Get child pages object with information as an array.
+     * @handleName getChildPagesByParentUrl
+     * @param {string} url - The URL of the parent page for which child pages are to be fetched. Example: "about/our-team".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data) for the selected parent
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get child pages object with information as an array.
+     */
+    async getChildPagesByParentUrl(url, langCode = this.state.lang) {
+        // Fetch data from the server using a GET request to retrieve child pages for the specified parent URL and language code
+        const data = await this._fetchGet(`/${url}/children?langCode=${langCode}`);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(data, pagesSchemas_1.PagesResponseSchema);
+        // Add template information to each of the fetched child pages
+        const withTemplate = await this.addTemplateToPages(validated);
+        // Normalize the result data and return it; ensures consistent structure or handles errors
+        return this._normalizeData(withTemplate, langCode);
+    }
+    /**
+     * Get all blocks by page url.
+     * @handleName getBlocksByPageUrl
+     * @param {string} url - Page URL. Example: "about".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPositionBlock[] | IError>} Returns all blocks as an array of PositionBlock objects or an empty array [] (if there is no data) for the selected parent
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get all blocks by page url.
+     */
+    async getBlocksByPageUrl(url, langCode = this.state.lang) {
+        const response = await this._fetchGet(`/${url}/blocks?langCode=${langCode}`);
+        // Normalize the fetched response data
+        const normalizeResponse = this._normalizeData(response);
+        // Iterate over each item in the normalized response
+        normalizeResponse.map((item) => {
+            const customSettings = item.customSettings;
+            // Check if customSettings contains 'productConfig' property
+            if (customSettings &&
+                Object.prototype.hasOwnProperty.call(customSettings, 'productConfig')) {
+                // If 'countElementsPerRow' exists, set it on the item
+                if (customSettings.productConfig.countElementsPerRow)
+                    item.countElementsPerRow =
+                        +customSettings.productConfig.countElementsPerRow;
+                // If 'quantity' exists, set it on the item
+                if (customSettings.productConfig.quantity)
+                    item.quantity = +customSettings.productConfig.quantity;
+            }
+            // Remove unnecessary properties from the item
+            delete item.customSettings;
+            delete item.attributesSetIdentifier;
+            // Return the modified item
+            return item;
+        });
+        // Check if traffic limit is not set
+        if (!this.state.traficLimit) {
+            // Create an instance of 'StaffModule' with the current state
+            const staffModule = new StaffModule(this.state);
+            // If the block type is 'similar_products_block', fetch similar products
+            if (normalizeResponse.type === 'similar_products_block') {
+                try {
+                    await staffModule
+                        .getSimilarProducts(normalizeResponse.identifier, langCode)
+                        .then((result) => {
+                        normalizeResponse.similarProducts = this._normalizeData(result);
+                    });
+                }
+                catch {
+                    // Handle errors by setting an empty array
+                    normalizeResponse.similarProducts = [];
+                }
+                // If the block type is 'product_block', fetch products
+            }
+            else if (normalizeResponse.type === 'product_block') {
+                try {
+                    await staffModule
+                        .getProductsByBlockMarker(normalizeResponse.identifier, langCode)
+                        .then((result) => {
+                        normalizeResponse.products = this._normalizeData(result);
+                    });
+                }
+                catch {
+                    // Handle errors by setting an empty array
+                    normalizeResponse.products = [];
+                }
+            }
+        }
+        // Return the final normalized response
+        return this._normalizeData(normalizeResponse);
+    }
+    /**
+     * Get settings for the page.
+     * @handleName getConfigPageByUrl
+     * @param {string} url - Page URL. Example: "about".
+     * @returns {Promise<IPageConfig | IError>} Returns a ConfigPage object with page display settings
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get settings for the page.
+     */
+    async getConfigPageByUrl(url) {
+        // Fetch data from the server using a GET request to retrieve forms for the specified page URL and language code
+        const result = await this._fetchGet(`/${url}/config`);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, pagesSchemas_1.PageConfigSchema);
+        // return fetched data
+        return validated;
+    }
+    /**
+     * Quick search for page objects with limited output.
+     * @handleName searchPage
+     * @param {string} name - Text for searching page objects (search is performed on the title field of the localizeInfos object with the language taken into account). Example: "About Us".
+     * @param {string} [url] - Page URL. Example: "catalog".
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IPagesEntity[] | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data)
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Quick search for page objects with limited output.
+     */
+    async searchPage(name, url, langCode = this.state.lang) {
+        // Fetch data from the server using a GET request to perform a quick search by page name and language code
+        const data = await this._fetchGet(`/quick/search?${url && 'url=' + url}&lang=${langCode}&name=${name}`);
+        // /quick/search?url=catalog&langCode=en_US&name=cat
+        // Check if there is no traffic limit set in the state
+        if (!this.state.traficLimit) {
+            // Initialize an empty array to store detailed page information
+            const pageList = [];
+            // Use Promise.all to fetch detailed information for each page concurrently
+            await Promise.all(data.map(async (page) => {
+                // Fetch detailed page information by page ID and push it to pageList
+                await this.getPageById(page.id, langCode).then((result) => {
+                    pageList.push(result);
+                });
+            }));
+            // Add templates to the fetched pages
+            const withTemplate = await this.addTemplateToPages(pageList);
+            // Post-process the data and return it; ensures consistent structure or handles errors
+            return this._dataPostProcess(withTemplate, langCode);
+        }
+        // If there is a traffic limit, add templates to the initially fetched data without fetching detailed information
+        const withTemplate = await this.addTemplateToPages(data);
+        // Normalize the data and return it; ensures consistent structure or handles errors
+        return this._normalizeData(withTemplate, langCode);
+    }
+    /**
+     * Add template data to pages
+     * @handleName addTemplateToPages
+     * @param {IPagesEntity[]} data - An array of page objects (IPagesEntity[]) to which template data will be added.
+     * @example
+        [
+          {
+            "id": 8,
+            "parentId": null,
+            "moduleFormConfigs": [],
+            "pageUrl": "blog",
+            "depth": 0,
+            "localizeInfos": {
+              "title": "Blog",
+              "menuTitle": "Blog",
+              "htmlContent": "",
+              "plainContent": "",
+            },
+            "isVisible": true,
+            "forms": [],
+            "blocks": [],
+            "type": "common_page",
+            "templateIdentifier": "template",
+            "attributeSetIdentifier": "page",
+            "attributeValues": {},
+            "isSync": true,
+            "template": {
+              "id": 4,
+              "attributeSetIdentifier": null,
+              "title": "Template",
+              "generalTypeId": 4,
+              "identifier": "template",
+              "version": 0,
+              "generalTypeName": "catalog_page",
+              "attributeValues": {},
+              "position": 1,
+            }
+          }
+        ]
+     * @returns {Promise<any | IError>} An array of page objects with template data added
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Add template data to pages. Optimized to avoid N+1 query problem by fetching only unique templates in parallel.
+     * For example, if 100 pages use 3 different templates, this method makes 3 requests instead of 100.
+     */
+    async addTemplateToPages(data) {
+        // Step 1: Collect unique templateIdentifiers from all pages
+        const uniqueIdentifiers = [
+            ...new Set(data
+                .filter((page) => 'templateIdentifier' in page &&
+                page.templateIdentifier !== null &&
+                page.templateIdentifier !== '')
+                .map((page) => page.templateIdentifier)),
+        ];
+        // Step 2: If no templates needed, return pages as-is
+        if (uniqueIdentifiers.length === 0) {
+            return data;
+        }
+        // Step 3: Fetch unique templates in parallel (not N queries, but unique count queries)
+        const Templates = new templatesApi_1.default(this.state);
+        const templatePromises = uniqueIdentifiers.map((identifier) => Templates.getTemplateByMarker(identifier).catch((error) => {
+            // eslint-disable-next-line no-undef, no-console
+            console.error(`Template fetch error for ${identifier}: `, error);
+            return null; // Return null for failed templates
+        }));
+        const templates = await Promise.all(templatePromises);
+        // Step 4: Create a Map for O(1) template lookup
+        const templateMap = new Map();
+        templates.forEach((template, index) => {
+            if (template !== null) {
+                templateMap.set(uniqueIdentifiers[index], template);
+            }
+        });
+        // Step 5: Apply templates to pages (no additional API calls)
+        return data.map((page) => {
+            if ('templateIdentifier' in page &&
+                page.templateIdentifier !== null &&
+                page.templateIdentifier !== '') {
+                const template = templateMap.get(page.templateIdentifier);
+                if (template) {
+                    return {
+                        ...page,
+                        template,
+                    };
+                }
+            }
+            // Return page without template if identifier is missing or template not found
+            return page;
+        });
+    }
+    /**
+     * Add template data to page by page templateIdentifier
+     * @handleName addTemplateToPage
+     * @param {IPagesEntity} data - Page object (IPagesEntity) to which template data will be added.
+     * @returns {Promise<any | IError>} An array of page objects with template data added
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Add template data to page by page templateIdentifier
+     */
+    async addTemplateToPage(data) {
+        // Check if 'templateIdentifier' exists in 'data' and is not null or an empty string
+        if ('templateIdentifier' in data &&
+            data.templateIdentifier !== null &&
+            data.templateIdentifier !== '') {
+            // Destructure 'templateIdentifier' from 'data'
+            const { templateIdentifier } = data;
+            try {
+                // Create a new instance of templatesApi with the current state
+                const Templates = new templatesApi_1.default(this.state);
+                // Fetch the template using the 'templateIdentifier'
+                const result = await Templates.getTemplateByMarker(templateIdentifier);
+                // Return the original data object with the fetched template added
+                return {
+                    ...data,
+                    template: result,
+                };
+            }
+            catch (error) {
+                // Log any errors that occur during the template fetching process
+                // eslint-disable-next-line no-undef, no-console
+                console.error('Template fetch error: ', error);
+                // Return the original data object unchanged if an error occurs
+                return data;
+            }
+        }
+        else {
+            // If 'templateIdentifier' doesn't exist or is invalid, return the original data
+            return data;
+        }
+    }
+}
+exports.default = PagesApi;
+/**
+ * Helper module for working with blocks, similar products and product blocks
+ * @description Internal module for fetching products and similar products for blocks
+ */
+class StaffModule extends asyncModules_1.default {
+    constructor(state) {
+        super(state); // Call parent constructor
+        this._url = state.url + '/api/content/blocks'; // Set URL for content blocks
+    }
+    // Method to fetch similar products by marker
+    async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30) {
+        // Fetch similar products from the server
+        const result = await this._fetchGet(`/${marker}/similar-products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
+        return this._normalizeData(result.items);
+    }
+    // Method to fetch products by block marker
+    async getProductsByBlockMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
+        // Fetch products from the server
+        const result = await this._fetchGet(`/${marker}/products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
+        return this._normalizeData(result.items);
+    }
+}