oneentry 1.0.161 → 1.0.162

package/changelog.md

@@ -1,5 +1,25 @@
 # 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
@@ -10,7 +30,7 @@
   const { Search } = defineOneEntry('your-url', config)
 
   const all = await Search.globalSearch('winter')
-  // drilldown: offset/limit are applied by the API only when a single type is requested
+  // drilldown: offset/limit require exactly one accessible type, else the API answers 400
   const products = await Search.globalSearch('winter', ['products'], 'visible', 0, 20)
   ```
 
@@ -27,8 +47,6 @@
   - Pages > `getPagesByVectorSearch` → `IPagesResponse`;
   - Users > `getUsersByVectorSearch` → `IUsersResponse` (requires user authorization).
 
-  All six answer `500` on the test project at the time of release — the SDK side follows the documented contract, which is the same `ItemsWithTotal` container the working products endpoint returns.
-
 - 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

package/dist/admins/adminsInterfaces.d.ts

@@ -109,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 {
@@ -120,6 +121,7 @@ interface IAdminEntity {
     isSync: boolean;
     attributeValues: IAttributeValues;
     moduleFormConfigs?: IFormConfig[];
+    distance?: number;
 }
 /**
  * Interface representing a query for fetching admin data.

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/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);
     }

package/dist/blocks/blocksInterfaces.d.ts

@@ -48,10 +48,11 @@ interface 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 {IProductsResponse} A promise that resolves to a products response (items + total) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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>;
     /**
      * Get "complete your cart" products by the cart from context (auth user or guest).
      * @handleName getCartComplement
@@ -59,10 +60,11 @@ interface 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 {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -84,10 +86,11 @@ interface 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 {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -109,10 +112,11 @@ interface 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 {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -120,10 +124,11 @@ interface 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 {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -131,10 +136,11 @@ interface 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 {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -150,10 +156,11 @@ interface 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 {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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
@@ -161,10 +168,11 @@ interface 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 {IProductsResponse} A promise that resolves to a products response (items + total + totalFound) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    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/discounts/discountsInterfaces.d.ts

@@ -134,6 +134,7 @@ interface IDiscountCondition {
  * @property {Record<string, unknown>} [bonusEvent] - Bonus event configuration.
  * @property {number} [position] - Position number for sorting. Example: 1.
  * @property {number | string} [total] - Total count of related entries. Example: "1".
+ * @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.
  */
 interface IDiscountsEntity {
     id: number;
@@ -157,6 +158,7 @@ interface IDiscountsEntity {
     bonusEvent?: Record<string, unknown> | null;
     position?: number;
     total?: number | string;
+    distance?: number;
 }
 /**
  * @interface IDiscountValue

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

@@ -112,13 +112,15 @@ interface IFormsDataVectorSearch {
         "value": "Test"
       }
     ]
- * @property {string} [userIdentifier] - Text identifier of the user who submitted the form. Example: "user_12345".
- * @property {string} [entityIdentifier] - Text identifier of the entity the record belongs to. Example: "product_1".
- * @property {number} [parentId] - Identifier of the parent form data record. Example: 1.
+ * @property {string | null} [userIdentifier] - Text identifier of the user who submitted the form, or `null` for an anonymous submission. Example: null.
+ * @property {string} [entityIdentifier] - Text identifier of the entity the record belongs to. Example: "blog".
+ * @property {number | null} [parentId] - Identifier of the parent form data record, or `null` for a top-level record. Example: null.
  * @property {string} [ip] - IP address the form was submitted from. Example: "127.0.0.1".
  * @property {string} [fingerprint] - Device fingerprint of the sender. Example: "UQ_123456_abcdef".
  * @property {boolean} [isUserAdmin] - Whether the record was submitted by an admin. Example: false.
  * @property {'sent' | 'banned' | 'deleted' | 'moderation' | 'approved'} [status] - Moderation status of the record. Example: "sent".
+ * @property {number} [formModuleId] - Identifier of the form module the record belongs to. Example: 2.
+ * @property {number} [distance] - Cosine distance to the query. Returned only when `debug: true` is passed in the search body. Example: 0.12.
  * @description This interface defines a form data record as returned by the semantic (vector) search endpoint. Unlike IFormDataEntity it carries the moderation and sender fields of the raw record.
  */
 interface IFormDataSearchEntity {
@@ -126,13 +128,15 @@ interface IFormDataSearchEntity {
     formIdentifier?: string;
     time?: Date | string;
     formData?: FormDataType[];
-    userIdentifier?: string;
+    userIdentifier?: string | null;
     entityIdentifier?: string;
-    parentId?: number;
+    parentId?: number | null;
     ip?: string;
     fingerprint?: string;
     isUserAdmin?: boolean;
     status?: 'sent' | 'banned' | 'deleted' | 'moderation' | 'approved';
+    formModuleId?: number;
+    distance?: number;
 }
 /**
  * @interface IFormsDataSearchResponse

package/dist/menus/menusInterfaces.d.ts

@@ -44,6 +44,8 @@ interface IMenus {
     }
  * @property {number} position - The menu position. Example: 1.
  * @property {number | null} parentId - The menu parent id. Example: null.
+ * @property {'page' | 'custom' | null} [parentType] - Kind of the parent item: `page` for a menu page, `custom` for a custom item; `null` together with `parentId` means top level. Page ids and custom item ids overlap, so the parent is ambiguous without it. Example: null.
+ * @property {'page' | 'custom'} [itemType] - Kind of this item itself: `page` or `custom`. This is the value the item's children must pass in `parentType`. Example: "page".
  * @description This interface defines the structure of a menu page entity, including its identifiers, localization information, attributes, and hierarchical relationships.
  */
 interface IMenusPages {
@@ -54,6 +56,8 @@ interface IMenusPages {
     attributeValues: IAttributeValues;
     position: number;
     parentId: number | null;
+    parentType?: 'page' | 'custom' | null;
+    itemType?: 'page' | 'custom';
 }
 /**
  * @interface IMenusEntity

package/dist/menus/menusSchemas.js

@@ -15,6 +15,8 @@ exports.MenusPagesSchema = zod_1.z.lazy(() => zod_1.z.object({
     attributeValues: zod_1.z.record(zod_1.z.string(), zod_1.z.any()),
     position: zod_1.z.number(),
     parentId: zod_1.z.number().nullable(),
+    parentType: zod_1.z.enum(['page', 'custom']).nullable().optional(),
+    itemType: zod_1.z.enum(['page', 'custom']).optional(),
 }));
 /**
  * Menu entity schema

package/dist/orders/ordersInterfaces.d.ts

@@ -601,6 +601,7 @@ interface IOrderSplit {
  * @property {ILocalizeInfo | null} [paymentStatusLocalizeInfos] - Localized payment status name; null while no payment status is assigned.
  * @property {IOrderDiscountConfig | null} [discountConfig] - Resolved discount configuration applied to the order (orderDiscounts, productDiscounts, coupon, settings, bonus, totals); null on older orders without a resolved discount config.
  * @property {IOrderSplit} [split] - Split (staged) payment configuration; present on the by-id order endpoint.
+ * @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 Represents an order storage object created by the user.
  */
 interface IOrderByMarkerEntity {
@@ -628,6 +629,7 @@ interface IOrderByMarkerEntity {
     paymentStatusLocalizeInfos?: ILocalizeInfo | null;
     discountConfig?: IOrderDiscountConfig | null;
     split?: IOrderSplit;
+    distance?: number;
 }
 /**
  * Interface representing an order status object.

package/dist/orders/ordersSchemas.d.ts

@@ -112,6 +112,7 @@ export declare const OrderEntitySchema: z.ZodObject<{
             status: z.ZodString;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /**
  * Orders list response schema
@@ -180,6 +181,7 @@ export declare const OrdersResponseSchema: z.ZodObject<{
                 status: z.ZodString;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        distance: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
 }, z.core.$strip>;

package/dist/orders/ordersSchemas.js

@@ -100,6 +100,7 @@ exports.OrderEntitySchema = zod_1.z.object({
         })),
     })
         .optional(),
+    distance: zod_1.z.number().optional(),
 });
 /**
  * Orders list response schema