oneentry 1.0.160 → 1.0.162

package/README.md

@@ -58,6 +58,7 @@ const {
     Payments,
     Products,
     ProductStatuses,
+    Search,
     Sitemap,
     Subscriptions,
     System,
@@ -276,6 +277,7 @@ Now you can use the following links to jump to specific entries documentation:
 - [Payments](https://js-sdk.oneentry.cloud/docs/category/payments)
 - [ProductStatuses](https://js-sdk.oneentry.cloud/docs/category/productstatuses)
 - [Products](https://js-sdk.oneentry.cloud/docs/category/products-1)
+- [Search](https://js-sdk.oneentry.cloud/docs/category/search)
 - [Sitemap](https://js-sdk.oneentry.cloud/docs/category/sitemap)
 - [Subscriptions](https://js-sdk.oneentry.cloud/docs/category/subscriptions)
 - [System](https://js-sdk.oneentry.cloud/docs/category/system)

package/changelog.md

@@ -1,5 +1,66 @@
 # SDK Change Log
 
+## v.1.0.162
+
+### What's New
+
+- `distance?: number` is now declared on the entities the vector search endpoints return — `IAdminEntity`, `IDiscountsEntity`, `IOrderByMarkerEntity`, `IPagesEntity`, `IUserEntity`, `IFormDataSearchEntity` — and validated by the matching Zod schemas, mirroring `IProductsEntity.distance`. The field is the cosine distance to the query and is returned **only** when the search body carries `debug: true`.
+
+- AttributeSets > `IAttributeSchemaItem.multiselect?: boolean` — for `list` fields, whether several options from `listTitles` may be selected. The panel has always stored the flag; the API only now declares it. Note it is still absent from every attribute the test project returns, so the field is declared but not yet observed in real data.
+
+- Menus > `IMenusPages` — `parentType?: 'page' | 'custom' | null` and `itemType?: 'page' | 'custom'` are now declared (and validated by `MenusPagesSchema`). Page ids and custom item ids overlap, so `parentId` alone addresses a parent ambiguously; `itemType` is the value an item's children must pass in `parentType`. Both are already returned by the API.
+
+### What's Changed
+
+- Blocks > the eight recommendation methods (`getCartComplement`, `getCartSimilar`, `getPersonalRecommendations`, `getRecentlyViewed`, `getRepeatPurchase`, `getTrending`, `getWishlistSimilar`, `getFrequentlyOrderedProducts`) accept a trailing optional `limit` — the query parameter the endpoints now support. It is not defaulted: when omitted, the block's own quantity setting keeps applying, so existing calls are unchanged.
+
+- FormData > `IFormDataSearchEntity` — `formModuleId?: number` is added, and `userIdentifier` / `parentId` are widened to `string | null` / `number | null`. `formModuleId` is absent from the swagger schema but present in every record the endpoint returns; the two nullable fields are declared non-nullable there while the real data returns `null`.
+
+### What's Deleted
+
+- **Breaking** — Pages > `getConfigPageByUrl` is removed, along with the `IPageConfig` type and `PageConfigSchema`. The API dropped `GET /api/content/pages/{url}/config` (and its `ConfigPageDto`); the route now answers `404`. Page display settings are available through the `config` field of a page entity.
+
+## v.1.0.161
+
+### What's New
+
+- **Search — a new module** wrapping `GET /api/content/search`, the public cross-entity search over names and attribute values of visible records:
+
+  ```ts
+  const { Search } = defineOneEntry('your-url', config)
+
+  const all = await Search.globalSearch('winter')
+  // drilldown: offset/limit require exactly one accessible type, else the API answers 400
+  const products = await Search.globalSearch('winter', ['products'], 'visible', 0, 20)
+  ```
+
+  Results come back grouped by entity type (`IGlobalSearchResponse` → `IGlobalSearchGroup[]`), each item carrying the context of how it matched — `matchKind`, `matchedField`, `fragment`, `langCode` and, where relevant, `parent` or `matchedAttribute`. `types` accepts any of the 18 searchable entity types and is sent comma-separated.
+
+  `offset` and `limit` switch the endpoint into drilldown mode and are accepted only alongside exactly one accessible type in `types` — otherwise the API answers `400`. Omit them (the SDK does not default them) to get every group in full.
+
+- **Semantic (vector) search in six more modules**, alongside the existing `Products.getProductsByVectorSearch`. Each takes the same body — `{ queryText, vectorDistanceThreshold?, maxHits?, debug? }` — plus `langCode`, `offset` and `limit`, and returns an `{ items, total }` container:
+
+  - Admins > `getAdminsByVectorSearch` → `IAdminsResponse`;
+  - Discounts > `getDiscountsByVectorSearch` → `IDiscountsResponse`;
+  - FormData > `getFormsDataByVectorSearch` → `IFormsDataSearchResponse`;
+  - Orders > `getOrdersByVectorSearch` → `IOrdersByMarkerEntity` (searches the authorized user's orders);
+  - Pages > `getPagesByVectorSearch` → `IPagesResponse`;
+  - Users > `getUsersByVectorSearch` → `IUsersResponse` (requires user authorization).
+
+- FormData > `IFormDataSearchEntity` — new exported type for the records returned by the form data vector search. It carries the moderation and sender fields of the raw record (`status`, `ip`, `fingerprint`, `isUserAdmin`, `userIdentifier`, `entityIdentifier`, `parentId`), which `IFormDataEntity` does not declare.
+
+### What's Changed
+
+- Payments > `IAccountsEntity.type` — the union is widened from `'stripe' | 'custom'` to `'stripe' | 'yookassa' | 'midtrans' | 'xendit' | 'custom'`, matching the payment providers the API actually reports. Accounts of these types were already returned; the declared type simply did not list them.
+
+- Products > `IFilterParams.conditionMarker` — three operators the API accepts are now declared: `'pat'` (matches pattern), `'same'` (matches the value exactly) and `'same_part'` (matches a part of the value exactly). Filter bodies using them were valid before but did not type-check.
+
+- Filters > `IContentFilterItem.value` — widened from `string | null` to `string | string[] | null` (and `ContentFilterItemSchema` accepts both). A range attribute node returns the array of values within the range; the other node types keep returning a single string or `null`.
+
+### What's Deleted
+
+- **Breaking** — TemplatePreviews > `ITemplatesPreviewEntity.attributeSetIdentifier` is removed, along with its Zod schema field. The API no longer returns it — it is absent from every template preview in the test project and has been dropped from the endpoint's response schema.
+
 ## v.1.0.160
 
 > Re-release of v.1.0.159. The 1.0.159 tarball was published from a stale build directory: the files changed by that release were updated, but the files it added (`dist/base/lazySchema.js`, `dist/web-socket/lazySocket.js`, `dist/types.js`, the root `types.js` / `types.d.ts` stubs and the whole `esm/` build) never made it into the package, so `require('oneentry')` threw `Cannot find module '../base/lazySchema'`. Use 1.0.160 instead — same feature set, complete build.

package/dist/admins/adminsApi.d.ts

@@ -2,7 +2,7 @@ import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
 import type { IFilterParams } from '../products/productsInterfaces';
-import type { IAdminEntity, IAdmins } from './adminsInterfaces';
+import type { IAdminEntity, IAdmins, IAdminsResponse, IAdminsVectorSearch } from './adminsInterfaces';
 /**
  * Controllers for working with users - admins.
  * @class AdminsApi
@@ -13,6 +13,7 @@ import type { IAdminEntity, IAdmins } from './adminsInterfaces';
 export default class AdminsApi extends AsyncModules implements IAdmins {
     protected state: StateModule;
     protected _url: string;
+    private _adminsUrl;
     /**
      * Initializes the AdminsApi with the provided state module.
      * @class
@@ -49,4 +50,17 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
      * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsInfo getAdminsInfo} documentation.
      */
     getAdminsInfo(body?: IFilterParams[], langCode?: string, offset?: number, limit?: number): Promise<IAdminEntity[] | IError>;
+    /**
+     * Semantic (vector) search for admins.
+     * @handleName getAdminsByVectorSearch
+     * @param {IAdminsVectorSearch} body - Vector search body. Example: `{ queryText: "content manager" }`.
+     * @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<IAdminsResponse | IError>} Returns an object with an array of found admins and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method performs a semantic (vector) search for admins.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsByVectorSearch getAdminsByVectorSearch} documentation.
+     */
+    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IAdminsResponse | IError>;
 }

package/dist/admins/adminsApi.js

@@ -57,6 +57,7 @@ class AdminsApi extends asyncModules_1.default {
     constructor(state) {
         super(state);
         this._url = state.url + '/api/content/admins/all';
+        this._adminsUrl = state.url + '/api/content/admins';
     }
     /**
      * Get all admins objects with filters.
@@ -96,5 +97,33 @@ class AdminsApi extends asyncModules_1.default {
         const validated = await this._validateResponse(response, schema('AdminsResponseSchema'));
         return this._normalizeData(validated, langCode);
     }
+    /**
+     * Semantic (vector) search for admins.
+     * @handleName getAdminsByVectorSearch
+     * @param {IAdminsVectorSearch} body - Vector search body. Example: `{ queryText: "content manager" }`.
+     * @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<IAdminsResponse | IError>} Returns an object with an array of found admins and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method performs a semantic (vector) search for admins.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsByVectorSearch getAdminsByVectorSearch} documentation.
+     */
+    async getAdminsByVectorSearch(body, langCode = this.state.lang, offset = 0, limit = 30) {
+        const query = {
+            langCode,
+            offset,
+            limit,
+        };
+        const savedUrl = this._url;
+        this._url = this._adminsUrl;
+        try {
+            const response = await this._fetchPost(`/vector/search?` + this._queryParamsToString(query), body);
+            return this._normalizeData(response, langCode);
+        }
+        finally {
+            this._url = savedUrl;
+        }
+    }
 }
 exports.default = AdminsApi;

package/dist/admins/adminsInterfaces.d.ts

@@ -33,6 +33,42 @@ interface IAdmins {
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
     getAdminsInfo(body?: IFilterParams[], langCode?: string, offset?: number, limit?: number): Promise<IAdminEntity[] | IError>;
+    /**
+     * Semantic (vector) search for admins.
+     * @handleName getAdminsByVectorSearch
+     * @param {IAdminsVectorSearch} body - Vector search body. Example: `{ queryText: "content manager" }`.
+     * @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 {IAdminsResponse} Returns an object with an array of found admins and total count.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     */
+    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IAdminsResponse | IError>;
+}
+/**
+ * Body for semantic (vector) admin search.
+ * @interface IAdminsVectorSearch
+ * @property {string} queryText - Natural-language search query. Example: "content manager".
+ * @property {number} [vectorDistanceThreshold] - Override of the cosine distance threshold (0..2). Example: 0.3.
+ * @property {number} [maxHits] - Top-K candidates fetched before pagination. Default: 100. Max: 500. Example: 10.
+ * @property {boolean} [debug] - When true, each returned item gets a `distance` field. Example: false.
+ * @description Body for the admins vector/search endpoint.
+ */
+interface IAdminsVectorSearch {
+    queryText: string;
+    vectorDistanceThreshold?: number;
+    maxHits?: number;
+    debug?: boolean;
+}
+/**
+ * @interface IAdminsResponse
+ * @property {IAdminEntity[]} items - Array of found admin objects.
+ * @property {number} total - Total number of found records. Example: 100.
+ * @description This interface defines the structure of a response containing multiple admin entities, including the total count and an array of admin items.
+ */
+interface IAdminsResponse {
+    items: IAdminEntity[];
+    total: number;
 }
 /**
  * Interface representing a Position entity.
@@ -73,6 +109,7 @@ interface IPosition {
       }
     ]
  * @property {IFormConfig[]} [moduleFormConfigs] - Array of module form configurations associated with the admin.
+ * @property {number} [distance] - Cosine distance to the query. Returned only by the semantic (vector) search endpoint when `debug: true` is passed in the search body. Example: 0.12.
  * @description This interface captures the essential details and additional attributes of an admin entity.
  */
 interface IAdminEntity {
@@ -84,6 +121,7 @@ interface IAdminEntity {
     isSync: boolean;
     attributeValues: IAttributeValues;
     moduleFormConfigs?: IFormConfig[];
+    distance?: number;
 }
 /**
  * Interface representing a query for fetching admin data.
@@ -98,4 +136,4 @@ interface IAdminQuery {
     limit: number;
     offset: number;
 }
-export type { IAdminEntity, IAdminQuery, IAdmins, IPosition };
+export type { IAdminEntity, IAdminQuery, IAdmins, IAdminsResponse, IAdminsVectorSearch, IPosition, };

package/dist/admins/adminsSchemas.d.ts

@@ -22,6 +22,7 @@ export declare const AdminEntitySchema: z.ZodObject<{
         additionalFields?: Record<string, unknown> | unknown[];
     }, unknown>>>>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+    distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /**
  * Admins response schema (array of admin entities)
@@ -45,4 +46,5 @@ export declare const AdminsResponseSchema: z.ZodArray<z.ZodObject<{
         additionalFields?: Record<string, unknown> | unknown[];
     }, unknown>>>>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+    distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;

package/dist/admins/adminsSchemas.js

@@ -27,6 +27,7 @@ exports.AdminEntitySchema = zod_1.z.object({
     isSync: zod_1.z.boolean(),
     attributeValues: zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), AttributeValueSchema)),
     moduleFormConfigs: zod_1.z.array(zod_1.z.any()).optional(),
+    distance: zod_1.z.number().optional(),
 });
 /**
  * Admins response schema (array of admin entities)

package/dist/attribute-sets/attributeSetsInterfaces.d.ts

@@ -146,6 +146,7 @@ interface IAttributesSetsEntity {
  * @property {number} [position] - Sort position of the field inside the set. Optional. Example: 1.
  * @property {IListTitle[]} [listTitles] - Options for `list`/`radioButton`/`entity` fields (with extended data or linked-entity values). Optional.
  * @property {string} [listType] - For `entity` fields — how the option list is organized. Optional. Example: "nested".
+ * @property {boolean} [multiselect] - For `list` fields — whether several options from `listTitles` may be selected. Optional. Example: false.
  * @property {string} [moduleIdentifier] - For `entity` fields — identifier of the module the linked entities are taken from. Optional. Example: "catalog".
  * @property {number | null} [parentId] - Identifier of the parent field, `null` for top-level. Optional, seen on `groupOfImages` fields.
  * @property {Record<string, IAttributeSchemaItem>} [additionalFields] - Nested sub-fields keyed by marker. Optional.
@@ -171,6 +172,7 @@ interface IAttributeSchemaItem {
     type: AttributeType;
     position?: number;
     listTitles?: IListTitle[];
+    multiselect?: boolean;
     listType?: string;
     moduleIdentifier?: string;
     parentId?: number | null;

package/dist/auth-provider/authProviderSchemas.d.ts

@@ -54,6 +54,7 @@ export declare const UserResponseSchema: z.ZodObject<{
     state: z.ZodRecord<z.ZodString, z.ZodAny>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
     rating: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /**
  * Auth provider entity schema

package/dist/base/lazySchema.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Creates a lazy schema loader bound to a module of Zod schemas.
+ *
+ * Validation is opt-in (`config.validation.enabled`, `false` by default), yet a static
+ * `import { PageEntitySchema } from './pagesSchemas'` would put Zod into the import graph
+ * of every consumer regardless. Binding the module behind a dynamic `import()` keeps it —
+ * and Zod — out of the bundle until a request actually needs to be validated.
+ * @param {() => Promise<TSchemas>} importSchemas - Dynamic import of the module holding the schemas.
+ * @returns {(name: keyof TSchemas) => () => Promise<TSchemas[keyof TSchemas]>} Function that takes
+ * a schema name and returns a loader for that schema.
+ * @description Usage: `const schema = createSchemaLoader(() => import('./pagesSchemas'))`,
+ * then `this._validateResponse(data, schema('PageEntitySchema'))`. The schema name is
+ * checked against the module's exports, so a typo is a compile-time error.
+ */
+export default function createSchemaLoader<TSchemas>(importSchemas: () => Promise<TSchemas>): <TName extends keyof TSchemas>(name: TName) => () => Promise<TSchemas[TName]>;

package/dist/base/lazySchema.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = createSchemaLoader;
+/**
+ * Creates a lazy schema loader bound to a module of Zod schemas.
+ *
+ * Validation is opt-in (`config.validation.enabled`, `false` by default), yet a static
+ * `import { PageEntitySchema } from './pagesSchemas'` would put Zod into the import graph
+ * of every consumer regardless. Binding the module behind a dynamic `import()` keeps it —
+ * and Zod — out of the bundle until a request actually needs to be validated.
+ * @param {() => Promise<TSchemas>} importSchemas - Dynamic import of the module holding the schemas.
+ * @returns {(name: keyof TSchemas) => () => Promise<TSchemas[keyof TSchemas]>} Function that takes
+ * a schema name and returns a loader for that schema.
+ * @description Usage: `const schema = createSchemaLoader(() => import('./pagesSchemas'))`,
+ * then `this._validateResponse(data, schema('PageEntitySchema'))`. The schema name is
+ * checked against the module's exports, so a typo is a compile-time error.
+ */
+function createSchemaLoader(importSchemas) {
+    return (name) => () => importSchemas().then((schemas) => schemas[name]);
+}

package/dist/base/validation.d.ts

@@ -50,6 +50,7 @@ export declare const UserEntitySchema: z.ZodObject<{
     state: z.ZodRecord<z.ZodString, z.ZodAny>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
     rating: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /**
  * Auth entity schema

package/dist/base/validation.js

@@ -53,6 +53,7 @@ exports.UserEntitySchema = zod_1.z.object({
     state: zod_1.z.record(zod_1.z.string(), zod_1.z.any()),
     moduleFormConfigs: zod_1.z.array(zod_1.z.any()).optional(),
     rating: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    distance: zod_1.z.number().optional(),
 });
 /**
  * Auth entity schema

package/dist/blocks/blocksApi.d.ts

@@ -96,11 +96,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getFrequentlyOrderedProducts getFrequentlyOrderedProducts} documentation.
      */
-    getFrequentlyOrderedProducts(productId: number, marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
+    getFrequentlyOrderedProducts(productId: number, marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Quick search for block objects with limited output.
      * @handleName searchBlock
@@ -118,11 +119,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplement getCartComplement} documentation.
      */
-    getCartComplement(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
+    getCartComplement(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get "complete your cart" products by an explicit list of productIds (POST body).
      * @handleName getCartComplementByProductIds
@@ -145,11 +147,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilar getCartSimilar} documentation.
      */
-    getCartSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
+    getCartSimilar(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to cart" products by an explicit list of productIds (POST body).
      * @handleName getCartSimilarByProductIds
@@ -172,11 +175,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getPersonalRecommendations getPersonalRecommendations} documentation.
      */
-    getPersonalRecommendations(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
+    getPersonalRecommendations(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get recently viewed products.
      * @handleName getRecentlyViewed
@@ -184,11 +188,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRecentlyViewed getRecentlyViewed} documentation.
      */
-    getRecentlyViewed(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
+    getRecentlyViewed(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get products for repeat purchase.
      * @handleName getRepeatPurchase
@@ -196,11 +201,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRepeatPurchase getRepeatPurchase} documentation.
      */
-    getRepeatPurchase(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
+    getRepeatPurchase(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get the block's slides tree as a flat pre-order array (slider_block only).
      * @handleName getSlides
@@ -217,11 +223,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getTrending getTrending} documentation.
      */
-    getTrending(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
+    getTrending(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to wishlist" products by the wishlist from context (auth user or guest).
      * @handleName getWishlistSimilar
@@ -229,11 +236,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilar getWishlistSimilar} documentation.
      */
-    getWishlistSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
+    getWishlistSimilar(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to wishlist" products by an explicit list of productIds (POST body).
      * @handleName getWishlistSimilarByProductIds

package/dist/blocks/blocksApi.js

@@ -223,14 +223,16 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getFrequentlyOrderedProducts getFrequentlyOrderedProducts} documentation.
      */
-    async getFrequentlyOrderedProducts(productId, marker, langCode = this.state.lang, signPrice) {
+    async getFrequentlyOrderedProducts(productId, marker, langCode = this.state.lang, signPrice, limit) {
         const query = {
             langCode,
             signPrice,
+            limit,
         };
         const data = await this._fetchGet(`/${marker}/products/${productId}/frequently-ordered?` +
             this._queryParamsToString(query));
@@ -258,12 +260,13 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplement getCartComplement} documentation.
      */
-    async getCartComplement(marker, langCode = this.state.lang, signPrice) {
-        const query = { langCode, signPrice };
+    async getCartComplement(marker, langCode = this.state.lang, signPrice, limit) {
+        const query = { langCode, signPrice, limit };
         const data = await this._fetchGet(`/${marker}/cart-complement?` + this._queryParamsToString(query));
         return this._normalizeData(data);
     }
@@ -292,12 +295,13 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilar getCartSimilar} documentation.
      */
-    async getCartSimilar(marker, langCode = this.state.lang, signPrice) {
-        const query = { langCode, signPrice };
+    async getCartSimilar(marker, langCode = this.state.lang, signPrice, limit) {
+        const query = { langCode, signPrice, limit };
         const data = await this._fetchGet(`/${marker}/cart-similar?` + this._queryParamsToString(query));
         return this._normalizeData(data);
     }
@@ -326,12 +330,13 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getPersonalRecommendations getPersonalRecommendations} documentation.
      */
-    async getPersonalRecommendations(marker, langCode = this.state.lang, signPrice) {
-        const query = { langCode, signPrice };
+    async getPersonalRecommendations(marker, langCode = this.state.lang, signPrice, limit) {
+        const query = { langCode, signPrice, limit };
         const data = await this._fetchGet(`/${marker}/personal-recommendations?` + this._queryParamsToString(query));
         return this._normalizeData(data);
     }
@@ -342,12 +347,13 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRecentlyViewed getRecentlyViewed} documentation.
      */
-    async getRecentlyViewed(marker, langCode = this.state.lang, signPrice) {
-        const query = { langCode, signPrice };
+    async getRecentlyViewed(marker, langCode = this.state.lang, signPrice, limit) {
+        const query = { langCode, signPrice, limit };
         const data = await this._fetchGet(`/${marker}/recently-viewed?` + this._queryParamsToString(query));
         return this._normalizeData(data);
     }
@@ -358,12 +364,13 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRepeatPurchase getRepeatPurchase} documentation.
      */
-    async getRepeatPurchase(marker, langCode = this.state.lang, signPrice) {
-        const query = { langCode, signPrice };
+    async getRepeatPurchase(marker, langCode = this.state.lang, signPrice, limit) {
+        const query = { langCode, signPrice, limit };
         const data = await this._fetchGet(`/${marker}/repeat-purchase?` + this._queryParamsToString(query));
         return this._normalizeData(data);
     }
@@ -386,12 +393,13 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getTrending getTrending} documentation.
      */
-    async getTrending(marker, langCode = this.state.lang, signPrice) {
-        const query = { langCode, signPrice };
+    async getTrending(marker, langCode = this.state.lang, signPrice, limit) {
+        const query = { langCode, signPrice, limit };
         const data = await this._fetchGet(`/${marker}/trending?` + this._queryParamsToString(query));
         return this._normalizeData(data);
     }
@@ -402,12 +410,13 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilar getWishlistSimilar} documentation.
      */
-    async getWishlistSimilar(marker, langCode = this.state.lang, signPrice) {
-        const query = { langCode, signPrice };
+    async getWishlistSimilar(marker, langCode = this.state.lang, signPrice, limit) {
+        const query = { langCode, signPrice, limit };
         const data = await this._fetchGet(`/${marker}/wishlist-similar?` + this._queryParamsToString(query));
         return this._normalizeData(data);
     }