oneentry 1.0.176 → 1.0.178

package/esm/products/productsInterfaces.d.ts

@@ -42,7 +42,7 @@ interface IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
      * @returns {IProductsResponse} Array with ProductEntity objects
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -60,7 +60,7 @@ interface IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
      * @returns {Promise<IProductsResponse | IError>} Products without a category: `{ items, total }`, the same container as getProducts.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -80,7 +80,7 @@ interface IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
      * @returns {IProductsResponse} Array with ProductEntity objects
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -98,7 +98,7 @@ interface IProductsApi {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
-          "signPrice": "orders",
+          "signPrice": "my_order",
           "statusMarker": "in_stock"
         }
      * @returns {IProductsInfo} Array with ProductInformation objects.
@@ -119,7 +119,7 @@ interface IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
      * @returns {IProductsResponse} Array with ProductEntity objects.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
@@ -138,7 +138,7 @@ interface IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
+          "signPrice": "my_order",
           "statusMarker": "in_stock",
           "templateMarker": "template_12345"
         }
@@ -150,14 +150,14 @@ interface IProductsApi {
     /**
      * Find products by its ids.
      * @handleName getProductsByIds
-     * @param {string} ids - Comma-separated IDs of the product pages to fetch. Example: "12345,67890".
+     * @param {string} ids - Comma-separated product IDs. Unknown ids are dropped and repeated ones collapsed; a non-numeric one answers `400 Incorrect request`. Example: "12345,67890".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {IProductsByIdsQuery} [userQuery] - Optional query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
      * @returns {IProductsEntity[]} Array with ProductEntity objects
      * @throws {IError} If there is an error during the fetch operation, it will return an error object.
@@ -169,31 +169,35 @@ interface IProductsApi {
      * @handleName getProductById
      * @param {number} id - Product ID. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {boolean} [isNormalized] - When `true`, the product is returned in normalized form.
+     * @param {boolean} [isNormalized] - Deprecated: the API no longer reads it, the answer is the same with `true`, `false` or without it. Kept for compatibility.
+     * @param {string} [signPrice] - Marker of an orders storage to fix the price for; the product then carries a `signedPrice`. An unknown marker answers `404`.
      * @returns {IProductsEntity} ProductEntity object.
      * @throws {IError} If there is an error during the fetch operation, it will return an error object.
      * @description This method retrieves one product object.
      */
-    getProductById(id: number, langCode?: string, isNormalized?: boolean): Promise<IProductsEntity | IError>;
+    getProductById(id: number, langCode?: string, isNormalized?: boolean, signPrice?: string): Promise<IProductsEntity | IError>;
     /**
      * Getting a product block object by product id.
      * @handleName getProductBlockById
      * @param {number} id - Product ID. Example: 12345.
-     * @returns {IProductBlock}
+     * @param {string} [langCode] - Language code. Default: the client's language.
+     * @returns {IProductBlock[]} Array of the product's block objects.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets a product block object by product id.
      */
-    getProductBlockById(id: number): Promise<IProductBlock[] | IError>;
+    getProductBlockById(id: number, langCode?: string): Promise<IProductBlock[] | IError>;
     /**
      * Quick search for product page objects with limited output.
      * @handleName searchProduct
      * @param {string} name - Text to search for in product titles (`localizeInfos.title`) in the requested language. Example: 'laminat'.
      * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [url] - URL of a catalog page to search within that category. Default: the whole catalog.
+     * @param {boolean} [correct] - Correct typos by the project's search dictionary first. The API defaults to `true`; pass `false` to search the query as is.
      * @returns {IProductsEntity[] | IProductSearchResult[]} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method performs a quick search for product page objects with limited output. With traficLimit enabled the raw quick search response is returned as short cards; otherwise full product entities are fetched for the found ids.
      */
-    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
+    searchProduct(name: string, langCode?: string, url?: string, correct?: boolean): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
     /**
      * Getting the number of products for the entire catalog.
      * @handleName getProductsCount
@@ -202,30 +206,16 @@ interface IProductsApi {
         [
           {
             "attributeMarker": "price",
-            "conditionMarker": "in",
-            "statusMarker": "status_1",
-            "conditionValue": {},
-            "pageUrls": [
-            "23-laminat-floorwood-maxima"
-            ],
-            "title": "Iphone 17 Pro"
-          },
-          {
-            "attributeMarker": "price",
-            "conditionMarker": "in",
-            "statusMarker": "status_1",
-            "conditionValue": {},
-            "pageUrls": [
-            "23-laminat-floorwood-maxima"
-            ],
-            "title": "Iphone 17 Pro"
+            "conditionMarker": "eq",
+            "conditionValue": 51
           }
         ]
      * @returns {IProductsCount} Object with product items count.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be an active language of the project — an inactive one answers `400`; the count reflects products visible in that language.
      * @description This method calculates and returns the total number of products present across the entire catalog, optionally applying specified filters.
      */
-    getProductsCount(body?: object[]): Promise<IProductsCount | IError>;
+    getProductsCount(body?: object[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Getting the number of products on a catalog page by page ID.
      * @handleName getProductsCountByPageId
@@ -235,63 +225,35 @@ interface IProductsApi {
         [
           {
             "attributeMarker": "price",
-            "conditionMarker": "in",
-            "statusMarker": "status_1",
-            "conditionValue": {},
-            "pageUrls": [
-            "23-laminat-floorwood-maxima"
-            ],
-            "title": "Iphone 17 Pro"
-          },
-          {
-            "attributeMarker": "price",
-            "conditionMarker": "in",
-            "statusMarker": "status_1",
-            "conditionValue": {},
-            "pageUrls": [
-            "23-laminat-floorwood-maxima"
-            ],
-            "title": "Iphone 17 Pro"
+            "conditionMarker": "eq",
+            "conditionValue": 51
           }
         ]
      * @returns {IProductsCount} Object with product items count.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be an active language of the project — an inactive one answers `400`; the count reflects products visible in that language.
      * @description This method calculates and returns the number of products available on a given catalog page, identified by its page ID, with optional filtering.
      */
-    getProductsCountByPageId(id: number | string, body?: object[]): Promise<IProductsCount | IError>;
+    getProductsCountByPageId(id: number | string, body?: object[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Getting the number of products on a catalog page by page URL.
      * @handleName getProductsCountByPageUrl
      * @param {string} url - Page URL. Example: "catalog".
-     * @param {string} body - Filter objects with search conditions. Default: `[]`.
+     * @param {object[]} [body] - Filter objects with search conditions. Default: `[]`.
      * @example
         [
           {
             "attributeMarker": "price",
-            "conditionMarker": "in",
-            "statusMarker": "status_1",
-            "conditionValue": {},
-            "pageUrls": [
-            "23-laminat-floorwood-maxima"
-            ],
-            "title": "Iphone 17 Pro"
-          },
-          {
-            "attributeMarker": "price",
-            "conditionMarker": "in",
-            "statusMarker": "status_1",
-            "conditionValue": {},
-            "pageUrls": [
-            "23-laminat-floorwood-maxima"
-            ],
-            "title": "Iphone 17 Pro"
+            "conditionMarker": "eq",
+            "conditionValue": 51
           }
         ]
      * @returns {IProductsCount} Object with product items count.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be an active language of the project — an inactive one answers `400`; the count reflects products visible in that language.
      * @description This method calculates and returns the number of products available on a given catalog page, identified by its URL, with optional filtering.
      */
-    getProductsCountByPageUrl(url: string, body?: object[]): Promise<IProductsCount | IError>;
+    getProductsCountByPageUrl(url: string, body?: object[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Semantic (vector) search for products.
      * @handleName getProductsByVectorSearch
@@ -311,7 +273,7 @@ interface IProductsApi {
  * @property {number} limit - Maximum number of records to return. Default: 30.
  * @property {string} sortOrder - Sort order: "DESC" or "ASC". Default: "DESC".
  * @property {string} sortKey - Field to sort by: "id", "position", "title", "date", "price" or "status". Default: null.
- * @property {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
+ * @property {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time. Must be an existing orders storage marker of the project, e.g. "my_order"; a marker with no such storage fails the whole request with `404 Specified orders storage for price signature not found`.
  * @see {@link https://js-sdk.oneentry.cloud/docs/products/#Fixing-the-price-signPrice Fixing the price} documentation.
  * @description Base query parameters shared by the product listing endpoints (getProducts, getProductsEmptyPage, getProductsByPageId, getProductsByPageUrl): pagination, sorting and price fixing.
  */
@@ -342,7 +304,7 @@ interface IProductsRelatedQuery extends IProductsQueryBase {
  * @property {number} [offset] - Number of records to skip. Default: 0.
  * @property {number} [limit] - Maximum number of records to return. Default: 30.
  * @property {string} [sortOrder] - Sort order: "DESC" or "ASC". Default: "DESC".
- * @property {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
+ * @property {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time. Must be an existing orders storage marker of the project, e.g. "my_order"; a marker with no such storage fails the whole request with `404 Specified orders storage for price signature not found`.
  * @property {string | null} [statusMarker] - Marker of the product status. Default: null. Example: "in_stock".
  */
 type IProductsPriceQuery = Omit<IProductsQueryBase, 'sortKey'> & {
@@ -352,7 +314,7 @@ type IProductsPriceQuery = Omit<IProductsQueryBase, 'sortKey'> & {
  * Query parameters for getProductsByIds: only price fixing — `ids` is passed
  * as a dedicated method argument.
  * @typedef {object} IProductsByIdsQuery
- * @property {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
+ * @property {string} [signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time. Must be an existing orders storage marker of the project, e.g. "my_order"; a marker with no such storage fails the whole request with `404 Specified orders storage for price signature not found`.
  */
 type IProductsByIdsQuery = Pick<IProductsQueryBase, 'signPrice'>;
 /**
@@ -389,7 +351,7 @@ interface IFilterParams {
 }
 /**
  * @interface IProductAdditional
- * @property {object} prices - Aggregated price range for the product across all variants.
+ * @property {object} prices - Price range of the **whole catalogue**, the same on every product: it depends neither on the product nor on the request filter (two products priced 51 and 150 both carry `{ min: 51, max: 180 }`). Use it for the bounds of a price slider, not for a product's own "from–to" price.
  * @property {number} prices.min - Minimum price value. Example: 5.
  * @property {number} prices.max - Maximum price value. Example: 150.
  * @description Additional indexed values attached to a product entity.
@@ -399,8 +361,8 @@ interface IProductAdditional {
 }
 /**
  * @interface IProductPriceRange
- * @property {number} min - Minimum price across product variants. Example: 5.
- * @property {number} max - Maximum price across product variants. Example: 150.
+ * @property {number} min - Lowest price in the catalogue. Example: 5.
+ * @property {number} max - Highest price in the catalogue. Example: 150.
  * @description Aggregated price range for a product, computed from all its variants.
  */
 interface IProductPriceRange {
@@ -442,14 +404,20 @@ interface IProductPageRef {
     }
  * @property {string | null} sku - Product SKU from the search index, or `null`. Example: "SKU_12345".
  * @property {boolean} isSync - Whether the product is indexed. Example: true.
- * @property {IAttributeValues} attributeValues - Attribute values keyed by attribute marker.
+ * @property {IAttributeValues} attributeValues - Attribute values keyed by attribute marker (an object, not an array).
  * @example
-    [
-      {
-        "id": "color",
-        "value": "red"
+    {
+      "product-name": {
+        "type": "string",
+        "value": "Split",
+        "position": 0
+      },
+      "price": {
+        "type": "integer",
+        "value": 150,
+        "position": 1
       }
-    ]
+    }
  * @property {string[]} categories - URLs of the catalog pages the product belongs to.
  * @example
     [
@@ -461,7 +429,7 @@ interface IProductPageRef {
  * @property {Array<IFormConfig>} [moduleFormConfigs] - Form configurations of the module.
  * @property {IRating} [rating] - Rating data: average value, likes and dislikes, and the calculation method.
  * @property {boolean} [isPositionLocked] - Whether the sorting position is locked. Example: false.
- * @property {number[]} relatedIds - IDs of related products.
+ * @property {number[]} [relatedIds] - IDs of related products.
  * @example
     [
       12345,
@@ -485,7 +453,7 @@ interface IProductPageRef {
         "categoryPath": "products"
       }
     ]
- * @property {string[]} [blocks] - Markers of the blocks attached to the product.
+ * @property {string[]} [blocks] - Markers of the blocks shown on the product page (not the blocks whose selection includes the product).
  * @example
     [
       "block_12345",
@@ -613,19 +581,20 @@ interface IProductInfo {
  * @property {number} version - Version number of the product block. Example: 1.
  * @property {number} position - Position of the product block in a list or layout. Example: 1.
  * @property {string} identifier - Marker of the product block. Example: "product_block_12345".
- * @property {BlockType} type - Block type. Example: "product".
+ * @property {BlockType} type - Block type. Example: "product_block".
  * @property {object} customSettings - Custom settings of the product block: slider delay, product configuration, similar-product rules and conditions. Example: {}
  * @property {string | null} templateIdentifier - Marker of the template used by the product block, or `null`. Example: "template_12345".
  * @property {boolean} isVisible - Whether the product block is visible. Example: true.
  * @property {boolean} isSync - Whether the product block is synchronized. Example: false.
- * @property {IAttributeValues} attributeValues - Attribute values keyed by attribute marker.
+ * @property {IAttributeValues} attributeValues - Attribute values keyed by attribute marker (an object, not an array); `{}` when the block has no attributes.
  * @example
-    [
-      {
-        "id": "color",
-        "value": "red"
+    {
+      "block-text": {
+        "type": "string",
+        "value": "Similar products",
+        "position": 0
       }
-    ]
+    }
  * @description This interface defines the structure of a product block entity, including its identifiers, attributes, and custom settings.
  */
 /**
@@ -725,4 +694,4 @@ interface IVectorSearchProducts {
     maxHits?: number;
     debug?: boolean;
 }
-export type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductInfo, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductSearchResult, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts, };
+export type { IAggregatedProductGroup, IFilterParams, IProductAdditional, IProductBlock, IProductBlockProductConfig, IProductBlockSettings, IProductBlockSimilarRule, IProductInfo, IProductPageRef, IProductPriceRange, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductSearchResult, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts, };

package/esm/search/searchApi.d.ts

@@ -22,15 +22,16 @@ export default class SearchApi extends AsyncModules implements ISearchApi {
      * Public search across titles and attribute values of visible records.
      * @handleName globalSearch
      * @param {string} query - Search query. Example: "winter".
-     * @param {TGlobalSearchEntityType[]} [types] - Entity types to search in, sent comma-separated. Searches every type when omitted.
+     * @param {TGlobalSearchEntityType[]} [types] - Entity types to search in, sent comma-separated. Searches every type when omitted or empty.
      * @param {'all' | 'visible' | 'hidden'} [visibility] - Visibility filter of the searched records. Default: "all".
      * @param {number} [offset] - Offset for drilldown mode. Pass it only together with exactly one accessible type in `types`.
      * @param {number} [limit] - Page size for drilldown mode. Pass it only together with exactly one accessible type in `types`; otherwise the API responds with `400 Drilldown mode (limit/offset) requires exactly one accessible type in types`. Without it, every group is returned in full.
      * @param {string} [langCode] - Language code. Default: "en_US". The search index is built per language: words in another locale are found only when you pass that locale's `langCode`.
+     * @param {number} [limitPerType] - Dropdown mode: maximum items per type group (API default 5, max 20). Independent from `limit`/`offset`, which page a single type in drilldown mode.
      * @returns {Promise<IGlobalSearchResponse | IError>} Returns the query and the found records grouped by entity type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Searches names and attribute values of visible records across entity types. The index is per language — the request carries `langCode`, so a bilingual project finds a word of either locale.
      * @see {@link https://js-sdk.oneentry.cloud/docs/search/globalSearch globalSearch} documentation.
      */
-    globalSearch(query: string, types?: TGlobalSearchEntityType[], visibility?: 'all' | 'visible' | 'hidden', offset?: number, limit?: number, langCode?: string): Promise<IGlobalSearchResponse | IError>;
+    globalSearch(query: string, types?: TGlobalSearchEntityType[], visibility?: 'all' | 'visible' | 'hidden', offset?: number, limit?: number, langCode?: string, limitPerType?: number): Promise<IGlobalSearchResponse | IError>;
 }

package/esm/search/searchApi.js

@@ -22,30 +22,33 @@ export default class SearchApi extends AsyncModules {
      * Public search across titles and attribute values of visible records.
      * @handleName globalSearch
      * @param {string} query - Search query. Example: "winter".
-     * @param {TGlobalSearchEntityType[]} [types] - Entity types to search in, sent comma-separated. Searches every type when omitted.
+     * @param {TGlobalSearchEntityType[]} [types] - Entity types to search in, sent comma-separated. Searches every type when omitted or empty.
      * @param {'all' | 'visible' | 'hidden'} [visibility] - Visibility filter of the searched records. Default: "all".
      * @param {number} [offset] - Offset for drilldown mode. Pass it only together with exactly one accessible type in `types`.
      * @param {number} [limit] - Page size for drilldown mode. Pass it only together with exactly one accessible type in `types`; otherwise the API responds with `400 Drilldown mode (limit/offset) requires exactly one accessible type in types`. Without it, every group is returned in full.
      * @param {string} [langCode] - Language code. Default: "en_US". The search index is built per language: words in another locale are found only when you pass that locale's `langCode`.
+     * @param {number} [limitPerType] - Dropdown mode: maximum items per type group (API default 5, max 20). Independent from `limit`/`offset`, which page a single type in drilldown mode.
      * @returns {Promise<IGlobalSearchResponse | IError>} Returns the query and the found records grouped by entity type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Searches names and attribute values of visible records across entity types. The index is per language — the request carries `langCode`, so a bilingual project finds a word of either locale.
      * @see {@link https://js-sdk.oneentry.cloud/docs/search/globalSearch globalSearch} documentation.
      */
-    async globalSearch(query, types, visibility, offset, limit, langCode = this.state.lang) {
+    async globalSearch(query, types, visibility, offset, limit, langCode = this.state.lang, limitPerType) {
         // `types` is sent comma-separated — the array stringifies to exactly that.
         // `langCode` is not optional decoration: the index is per language, and
         // without it a word of a second locale answers an empty group (CMS-912).
         const params = {
             q: query,
-            types,
+            // An empty array would go out as `types=` and the API answers no groups
+            types: types && types.length > 0 ? types : undefined,
             visibility,
             offset,
             limit,
+            limitPerType,
             langCode,
         };
         const data = await this._fetchGet(`?` + this._queryParamsToString(params));
         const validated = await this._validateResponse(data, schema('GlobalSearchResponseSchema'));
-        return this._normalizeData(validated);
+        return this._normalizeData(validated, langCode);
     }
 }

package/esm/search/searchInterfaces.d.ts

@@ -14,11 +14,12 @@ interface ISearchApi {
      * @param {number} [offset] - Offset for drilldown mode. Pass it only together with exactly one accessible type in `types`.
      * @param {number} [limit] - Page size for drilldown mode. Pass it only together with exactly one accessible type in `types`; otherwise the API responds with `400 Drilldown mode (limit/offset) requires exactly one accessible type in types`. Without it, every group is returned in full.
      * @param {string} [langCode] - Language code. Default: "en_US". The search index is built per language: words in another locale are found only when you pass that locale's `langCode`.
+     * @param {number} [limitPerType] - Dropdown mode: maximum items per type group (API default 5, max 20). Independent from `limit`/`offset`, which page a single type in drilldown mode.
      * @returns {Promise<IGlobalSearchResponse | IError>} Returns the query and the found records grouped by entity type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Searches names and attribute values of visible records across entity types. The index is per language — the request carries `langCode`, so a bilingual project finds a word of either locale.
      */
-    globalSearch(query: string, types?: TGlobalSearchEntityType[], visibility?: 'all' | 'visible' | 'hidden', offset?: number, limit?: number, langCode?: string): Promise<IGlobalSearchResponse | IError>;
+    globalSearch(query: string, types?: TGlobalSearchEntityType[], visibility?: 'all' | 'visible' | 'hidden', offset?: number, limit?: number, langCode?: string, limitPerType?: number): Promise<IGlobalSearchResponse | IError>;
 }
 /**
  * Entity type a global search group or item belongs to.

package/esm/sitemap/sitemapInterfaces.d.ts

@@ -21,17 +21,21 @@ interface ISitemapApi {
 /**
  * Query parameters for sitemap requests.
  * @interface ISitemapQuery
- * @property {Record<string, string>} [baseUrls] - Base URLs per language for sitemap generation. Example: `{ "en_US": "https://example.com/" }`.
- * @property {string} [url] - URL of a single sitemap entry.
- * @property {string} [lastmod] - Last modification date of the entry.
- * @property {string} [changefreq] - How often the entry changes.
- * @property {number} [priority] - Sitemap `priority` of the entry.
+ * @property {Record<string, string>} baseUrls - Base URL per active language, an absolute `http(s)://` address; the entry for the default language is required. Without it the API does not generate a sitemap. Example: `{ "en_US": "https://example.com/" }`.
+ * @property {string} [url] - Deprecated: ignored by the API.
+ * @property {string} [lastmod] - Deprecated: ignored by the API.
+ * @property {string} [changefreq] - Deprecated: ignored by the API.
+ * @property {number} [priority] - Deprecated: ignored by the API.
  */
 interface ISitemapQuery {
-    baseUrls?: Record<string, string>;
+    baseUrls: Record<string, string>;
+    /** @deprecated Ignored by the API. */
     url?: string;
+    /** @deprecated Ignored by the API. */
     lastmod?: string;
+    /** @deprecated Ignored by the API. */
     changefreq?: string;
+    /** @deprecated Ignored by the API. */
     priority?: number;
 }
 /**

package/esm/subscriptions/subscriptionsApi.d.ts

@@ -45,7 +45,7 @@ export default class SubscriptionsApi extends AsyncModules implements ISubscript
      * @handleName getAllSubscriptions
      * @returns {Promise<ISubscriptionEntity[] | IError>} Returns an array of available subscriptions.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method requires user authorization.
+     * @description Lists the plans available for subscription. It does not need a signed-in user: a guest gets the same list.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      * @see {@link https://js-sdk.oneentry.cloud/docs/subscriptions/getAllSubscriptions getAllSubscriptions} documentation.
      */

package/esm/subscriptions/subscriptionsApi.js

@@ -51,7 +51,7 @@ export default class SubscriptionsApi extends AsyncModules {
      * @handleName getAllSubscriptions
      * @returns {Promise<ISubscriptionEntity[] | IError>} Returns an array of available subscriptions.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method requires user authorization.
+     * @description Lists the plans available for subscription. It does not need a signed-in user: a guest gets the same list.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      * @see {@link https://js-sdk.oneentry.cloud/docs/subscriptions/getAllSubscriptions getAllSubscriptions} documentation.
      */

package/esm/subscriptions/subscriptionsInterfaces.d.ts

@@ -30,7 +30,7 @@ interface ISubscriptionsApi {
      * @handleName getAllSubscriptions
      * @returns {Promise<ISubscriptionEntity[] | IError>} Returns an array of available subscriptions.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method requires user authorization.
+     * @description Lists the plans available for subscription. It does not need a signed-in user: a guest gets the same list.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
     getAllSubscriptions(): Promise<ISubscriptionEntity[] | IError>;

package/esm/system/systemApi.d.ts

@@ -23,6 +23,7 @@ export default class SystemApi extends AsyncModules implements ISystemApi {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method is used to test the 404 error handling by sending a GET request to a specific endpoint.
      * @see {@link https://js-sdk.oneentry.cloud/docs/system/test404 test404} documentation.
+     * @deprecated The platform removed `/api/content/system/test404` (CMS-1056, 2026-10-29): the call answers `404 "Cannot GET /api/content/system/test404"`. Kept for compatibility and will be removed.
      */
     test404(): Promise<unknown | IError>;
     /**
@@ -32,6 +33,7 @@ export default class SystemApi extends AsyncModules implements ISystemApi {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method is used to test the 500 error handling by sending a GET request to a specific endpoint.
      * @see {@link https://js-sdk.oneentry.cloud/docs/system/test500 test500} documentation.
+     * @deprecated The platform removed `/api/content/system/test500` (CMS-1056, 2026-10-29): the call answers `404 "Cannot GET /api/content/system/test500"`. Kept for compatibility and will be removed.
      */
     test500(): Promise<unknown | IError>;
     /**

package/esm/system/systemApi.js

@@ -21,6 +21,7 @@ export default class SystemApi extends AsyncModules {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method is used to test the 404 error handling by sending a GET request to a specific endpoint.
      * @see {@link https://js-sdk.oneentry.cloud/docs/system/test404 test404} documentation.
+     * @deprecated The platform removed `/api/content/system/test404` (CMS-1056, 2026-10-29): the call answers `404 "Cannot GET /api/content/system/test404"`. Kept for compatibility and will be removed.
      */
     async test404() {
         const result = await this._fetchGet('/test404');
@@ -33,6 +34,7 @@ export default class SystemApi extends AsyncModules {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method is used to test the 500 error handling by sending a GET request to a specific endpoint.
      * @see {@link https://js-sdk.oneentry.cloud/docs/system/test500 test500} documentation.
+     * @deprecated The platform removed `/api/content/system/test500` (CMS-1056, 2026-10-29): the call answers `404 "Cannot GET /api/content/system/test500"`. Kept for compatibility and will be removed.
      */
     async test500() {
         const result = await this._fetchGet('/test500');

package/esm/system/systemInterfaces.d.ts

@@ -9,6 +9,7 @@ interface ISystemApi {
      * @handleName test404
      * @returns {unknown} Returns a Promise that resolves with any data.
      * @description This method tests 404 error.
+     * @deprecated The platform removed `/api/content/system/test404` (CMS-1056, 2026-10-29): the call answers `404 "Cannot GET /api/content/system/test404"`. Kept for compatibility and will be removed.
      */
     test404(): Promise<unknown | IError>;
     /**
@@ -16,6 +17,7 @@ interface ISystemApi {
      * @handleName test500
      * @returns {unknown} Returns a Promise that resolves with any data.
      * @description This method tests 500 error.
+     * @deprecated The platform removed `/api/content/system/test500` (CMS-1056, 2026-10-29): the call answers `404 "Cannot GET /api/content/system/test500"`. Kept for compatibility and will be removed.
      */
     test500(): Promise<unknown | IError>;
     /**

package/esm/templates/templatesApi.d.ts

@@ -9,7 +9,7 @@ import type { ITemplateEntity, ITemplatesApi } from './templatesInterfaces.js';
  * @handle /api/content/templates
  * @description This module provides a set of controllers for handling operations related to template objects.
  */
-export default class TemplatesPreviewApi extends AsyncModules implements ITemplatesApi {
+export default class TemplatesApi extends AsyncModules implements ITemplatesApi {
     protected state: StateModule;
     protected _url: string;
     /**
@@ -31,7 +31,7 @@ export default class TemplatesPreviewApi extends AsyncModules implements ITempla
     /**
      * Get template objects by type.
      * @handleName getTemplateByType
-     * @param {BlockType} type - Type of templates to fetch. Example: "product".
+     * @param {BlockType} type - Type of templates to fetch. Example: "product_block". A type with no templates gives an empty array.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<ITemplateEntity[] | IError>} Array of `ITemplateEntity` objects of the given type.
      * @throws {IError} When isShell=false and an error occurs during the fetch

package/esm/templates/templatesApi.js

@@ -8,7 +8,7 @@ const schema = createSchemaLoader(() => import('./templatesSchemas.js'));
  * @handle /api/content/templates
  * @description This module provides a set of controllers for handling operations related to template objects.
  */
-export default class TemplatesPreviewApi extends AsyncModules {
+export default class TemplatesApi extends AsyncModules {
     /**
      * Constructor for TemplatesApi class.
      * @param {StateModule} state - The state module instance.
@@ -28,13 +28,14 @@ export default class TemplatesPreviewApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getAllTemplates getAllTemplates} documentation.
      */
     async getAllTemplates(langCode = this.state.lang) {
-        const response = await this._fetchGet(`/all?langCode=${langCode}`);
+        const response = await this._fetchGet(`/all?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(response, schema('GroupedTemplatesResponseSchema'));
+        if (this._isErrorResponse(validated)) {
+            return validated;
+        }
         const result = {};
-        if (validated &&
-            typeof validated === 'object' &&
-            !('statusCode' in validated)) {
+        if (validated && typeof validated === 'object') {
             const grouped = validated;
             // eslint-disable-next-line no-restricted-syntax
             for (const item in grouped) {
@@ -46,7 +47,7 @@ export default class TemplatesPreviewApi extends AsyncModules {
     /**
      * Get template objects by type.
      * @handleName getTemplateByType
-     * @param {BlockType} type - Type of templates to fetch. Example: "product".
+     * @param {BlockType} type - Type of templates to fetch. Example: "product_block". A type with no templates gives an empty array.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<ITemplateEntity[] | IError>} Array of `ITemplateEntity` objects of the given type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -54,10 +55,10 @@ export default class TemplatesPreviewApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByType getTemplateByType} documentation.
      */
     async getTemplateByType(type, langCode = this.state.lang) {
-        const result = await this._fetchGet(`?type=${type}&langCode=${langCode}`);
+        const result = await this._fetchGet(`?type=${encodeURIComponent(type)}&langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('TemplatesResponseSchema'));
-        return this._normalizeData(validated);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Get one template object by marker.
@@ -70,9 +71,9 @@ export default class TemplatesPreviewApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByMarker getTemplateByMarker} documentation.
      */
     async getTemplateByMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('TemplateEntitySchema'));
-        return this._normalizeData(validated);
+        return this._normalizeData(validated, langCode);
     }
 }