oneentry 1.0.160 → 1.0.162

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/discountsApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { IBonusBalanceEntity, IBonusTransactionEntity, IBonusTransactionType, ICouponValidationResult, IDiscountsApi, IDiscountsEntity, IDiscountsResponse, IDiscountType } from './discountsInterfaces';
+import type { IBonusBalanceEntity, IBonusTransactionEntity, IBonusTransactionType, ICouponValidationResult, IDiscountsApi, IDiscountsEntity, IDiscountsResponse, IDiscountsVectorSearch, IDiscountType } from './discountsInterfaces';
 /**
  * Controllers for working with events
  * @handle /api/content/events
@@ -78,4 +78,17 @@ export default class DiscountsApi extends AsyncModules implements IDiscountsApi
      * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/validateDiscountsCoupon validateDiscountsCoupon} documentation.
      */
     validateDiscountsCoupon(code: string): Promise<ICouponValidationResult | IError>;
+    /**
+     * Semantic (vector) search for discounts.
+     * @handleName getDiscountsByVectorSearch
+     * @param {IDiscountsVectorSearch} body - Vector search body. Example: `{ queryText: "winter sale" }`.
+     * @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<IDiscountsResponse | IError>} Returns an object with an array of found discounts and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method performs a semantic (vector) search for discounts.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/getDiscountsByVectorSearch getDiscountsByVectorSearch} documentation.
+     */
+    getDiscountsByVectorSearch(body: IDiscountsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IDiscountsResponse | IError>;
 }

package/dist/discounts/discountsApi.js

@@ -117,5 +117,26 @@ class DiscountsApi extends asyncModules_1.default {
         const data = await this._fetchGet(`/coupons/validate?` + this._queryParamsToString(query));
         return this._normalizeData(data);
     }
+    /**
+     * Semantic (vector) search for discounts.
+     * @handleName getDiscountsByVectorSearch
+     * @param {IDiscountsVectorSearch} body - Vector search body. Example: `{ queryText: "winter sale" }`.
+     * @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<IDiscountsResponse | IError>} Returns an object with an array of found discounts and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method performs a semantic (vector) search for discounts.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/getDiscountsByVectorSearch getDiscountsByVectorSearch} documentation.
+     */
+    async getDiscountsByVectorSearch(body, langCode = this.state.lang, offset = 0, limit = 30) {
+        const query = {
+            langCode,
+            offset,
+            limit,
+        };
+        const data = await this._fetchPost(`/vector/search?` + this._queryParamsToString(query), body);
+        return this._normalizeData(data, langCode);
+    }
 }
 exports.default = DiscountsApi;

package/dist/discounts/discountsInterfaces.d.ts

@@ -59,6 +59,32 @@ interface IDiscountsApi {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     getBonusHistory(type?: IBonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean): Promise<IBonusTransactionEntity[] | IError>;
+    /**
+     * Semantic (vector) search for discounts.
+     * @handleName getDiscountsByVectorSearch
+     * @param {IDiscountsVectorSearch} body - Vector search body. Example: `{ queryText: "winter sale" }`.
+     * @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<IDiscountsResponse | IError>} Returns an object with an array of found discounts and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getDiscountsByVectorSearch(body: IDiscountsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IDiscountsResponse | IError>;
+}
+/**
+ * Body for semantic (vector) discount search.
+ * @interface IDiscountsVectorSearch
+ * @property {string} queryText - Natural-language search query. Example: "winter sale".
+ * @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 discounts vector/search endpoint.
+ */
+interface IDiscountsVectorSearch {
+    queryText: string;
+    vectorDistanceThreshold?: number;
+    maxHits?: number;
+    debug?: boolean;
 }
 /**
  * Query parameters for fetching discounts.
@@ -108,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;
@@ -131,6 +158,7 @@ interface IDiscountsEntity {
     bonusEvent?: Record<string, unknown> | null;
     position?: number;
     total?: number | string;
+    distance?: number;
 }
 /**
  * @interface IDiscountValue
@@ -264,4 +292,4 @@ interface IBonusTransactionEntity {
 interface IBonusBalanceEntity {
     balance: number;
 }
-export type { IBonusBalanceEntity, IBonusHistoryQuery, IBonusTransactionEntity, IBonusTransactionType, ICouponEntity, ICouponValidationResult, IDiscountByMarkerQuery, IDiscountCondition, IDiscountsApi, IDiscountsEntity, IDiscountsQuery, IDiscountsResponse, IDiscountsValidateCoupon, IDiscountType, IDiscountValue, };
+export type { IBonusBalanceEntity, IBonusHistoryQuery, IBonusTransactionEntity, IBonusTransactionType, ICouponEntity, ICouponValidationResult, IDiscountByMarkerQuery, IDiscountCondition, IDiscountsApi, IDiscountsEntity, IDiscountsQuery, IDiscountsResponse, IDiscountsValidateCoupon, IDiscountsVectorSearch, IDiscountType, IDiscountValue, };

package/dist/filters/filtersInterfaces.d.ts

@@ -28,7 +28,7 @@ type TContentFilterItemType = 'page' | 'product' | 'admin' | 'attribute' | 'disc
  * @property {string | null} [marker] - Marker of the linked entity, or null for type=page. Example: "about".
  * @property {string | null} [url] - Page URL (only for type=page; null otherwise). Example: "about".
  * @property {ILocalizeInfo} [localizeInfos] - Localized info of the linked entity in the requested locale.
- * @property {string | null} [value] - Unified node value (e.g. discount value, attribute title); null otherwise. Example: "10".
+ * @property {string | string[] | null} [value] - Unified node value: an array of values in range for a range attribute, a resolved title for a legacy checkbox attribute, the discount value for discount/personal-discount/bonus, the object id for product/admin/payment-method, and null for a page. Example: ["25", "50", "75"].
  * @property {number} [position] - Numeric position (per-level). Example: 1.
  * @property {IContentFilterItem[]} [children] - Nested tree nodes (regular and custom items in a single array).
  * @description A single node of a content filter items tree.
@@ -38,7 +38,7 @@ interface IContentFilterItem {
     marker?: string | null;
     url?: string | null;
     localizeInfos?: ILocalizeInfo;
-    value?: string | null;
+    value?: string | string[] | null;
     position?: number;
     children?: IContentFilterItem[];
 }

package/dist/filters/filtersSchemas.d.ts

@@ -12,7 +12,7 @@ type IContentFilterItemRaw = {
     marker?: string | null;
     url?: string | null;
     localizeInfos?: Record<string, unknown>;
-    value?: string | null;
+    value?: string | string[] | null;
     position?: number;
     children?: IContentFilterItemRaw[];
 };

package/dist/filters/filtersSchemas.js

@@ -15,7 +15,10 @@ exports.ContentFilterItemSchema = zod_1.z.lazy(() => zod_1.z.object({
     marker: zod_1.z.string().nullable().optional(),
     url: zod_1.z.string().nullable().optional(),
     localizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-    value: zod_1.z.string().nullable().optional(),
+    value: zod_1.z
+        .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
+        .nullable()
+        .optional(),
     position: zod_1.z.number().optional(),
     children: zod_1.z.array(exports.ContentFilterItemSchema).optional(),
 }));

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

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { IBodyPostFormData, IFormsByMarkerDataEntity, IFormsData, IPostFormResponse, IUpdateFormsData } from './formsDataInterfaces';
+import type { IBodyPostFormData, IFormsByMarkerDataEntity, IFormsData, IFormsDataSearchResponse, IFormsDataVectorSearch, IPostFormResponse, IUpdateFormsData } from './formsDataInterfaces';
 /**
  * Controllers for working with form data
  * @handle /api/content/form-data
@@ -108,4 +108,17 @@ export default class FormsDataApi extends AsyncModules implements IFormsData {
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/deleteFormsDataByid deleteFormsDataByid} documentation.
      */
     deleteFormsDataByid(id: number): Promise<boolean | IError>;
+    /**
+     * Semantic (vector) search for form data.
+     * @handleName getFormsDataByVectorSearch
+     * @param {IFormsDataVectorSearch} body - Vector search body. Example: `{ queryText: "order confirmation" }`.
+     * @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<IFormsDataSearchResponse | IError>} Returns an object with an array of found form data records and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method performs a semantic (vector) search for form data.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByVectorSearch getFormsDataByVectorSearch} documentation.
+     */
+    getFormsDataByVectorSearch(body: IFormsDataVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IFormsDataSearchResponse | IError>;
 }

package/dist/forms-data/formsDataApi.js

@@ -224,5 +224,26 @@ class FormsDataApi extends asyncModules_1.default {
         const result = await this._fetchDelete(`/${id}`);
         return result;
     }
+    /**
+     * Semantic (vector) search for form data.
+     * @handleName getFormsDataByVectorSearch
+     * @param {IFormsDataVectorSearch} body - Vector search body. Example: `{ queryText: "order confirmation" }`.
+     * @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<IFormsDataSearchResponse | IError>} Returns an object with an array of found form data records and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method performs a semantic (vector) search for form data.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByVectorSearch getFormsDataByVectorSearch} documentation.
+     */
+    async getFormsDataByVectorSearch(body, langCode = this.state.lang, offset = 0, limit = 30) {
+        const query = {
+            langCode,
+            offset,
+            limit,
+        };
+        const result = await this._fetchPost(`/vector/search?` + this._queryParamsToString(query), body);
+        return this._normalizeData(result, langCode);
+    }
 }
 exports.default = FormsDataApi;

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

@@ -70,6 +70,83 @@ interface IFormsData {
      * @description This method retrieves form data by its marker.
      */
     getFormsDataByMarker(marker: string, formModuleConfigId: number, body?: object, isNested?: number, langCode?: string, offset?: number, limit?: number): Promise<IFormsByMarkerDataEntity | IError>;
+    /**
+     * Semantic (vector) search for form data.
+     * @handleName getFormsDataByVectorSearch
+     * @param {IFormsDataVectorSearch} body - Vector search body. Example: `{ queryText: "order confirmation" }`.
+     * @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<IFormsDataSearchResponse | IError>} Returns an object with an array of found form data records and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getFormsDataByVectorSearch(body: IFormsDataVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IFormsDataSearchResponse | IError>;
+}
+/**
+ * Body for semantic (vector) form data search.
+ * @interface IFormsDataVectorSearch
+ * @property {string} queryText - Natural-language search query. Example: "order confirmation".
+ * @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 form-data vector/search endpoint.
+ */
+interface IFormsDataVectorSearch {
+    queryText: string;
+    vectorDistanceThreshold?: number;
+    maxHits?: number;
+    debug?: boolean;
+}
+/**
+ * Represents a form data record returned by the vector search endpoint.
+ * @interface IFormDataSearchEntity
+ * @property {number} [id] - The unique identifier of the form data record. Example: 12345.
+ * @property {string} [formIdentifier] - Text identifier of the form. Example: "contact_form".
+ * @property {Date | string} [time] - Date and time the form data was last changed. Example: "2023-02-12 10:56".
+ * @property {FormDataType[]} [formData] - Data submitted by the form.
+ * @example
+    [
+      {
+        "marker": "name",
+        "type": "string",
+        "value": "Test"
+      }
+    ]
+ * @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 {
+    id?: number;
+    formIdentifier?: string;
+    time?: Date | string;
+    formData?: FormDataType[];
+    userIdentifier?: string | null;
+    entityIdentifier?: string;
+    parentId?: number | null;
+    ip?: string;
+    fingerprint?: string;
+    isUserAdmin?: boolean;
+    status?: 'sent' | 'banned' | 'deleted' | 'moderation' | 'approved';
+    formModuleId?: number;
+    distance?: number;
+}
+/**
+ * @interface IFormsDataSearchResponse
+ * @property {IFormDataSearchEntity[]} items - Array of found form data records.
+ * @property {number} total - Total number of found records. Example: 100.
+ * @description This interface defines the structure of the response returned by the form data vector search endpoint.
+ */
+interface IFormsDataSearchResponse {
+    items: IFormDataSearchEntity[];
+    total: number;
 }
 /**
  * Represents the structure of a form data entity.
@@ -594,4 +671,4 @@ interface IListOptionValue {
     value: string;
     extended: IListOptionExtended;
 }
-export type { FormDataType, IBodyPostFormData, IBodyTypeFile, IBodyTypeImageGroupOfImages, IBodyTypeRadioButtonList, IBodyTypeStringNumberFloat, IBodyTypeText, IBodyTypeTextWithHeader, IBodyTypeTimeDate, IFileValue, IFormByMarkerDataEntity, IFormDataEntity, IFormsByMarkerDataEntity, IFormsData, IFormsDataEntity, IImageValue, IImageValueParams, IListOptionExtended, IListOptionValue, IPostFormResponse, IPostFormResponseData, ITextEditorParams, ITextValue, ITextWithHeaderValue, ITimeDateValue, IUpdateFormsData, };
+export type { FormDataType, IBodyPostFormData, IBodyTypeFile, IBodyTypeImageGroupOfImages, IBodyTypeRadioButtonList, IBodyTypeStringNumberFloat, IBodyTypeText, IBodyTypeTextWithHeader, IBodyTypeTimeDate, IFileValue, IFormByMarkerDataEntity, IFormDataEntity, IFormDataSearchEntity, IFormsByMarkerDataEntity, IFormsData, IFormsDataEntity, IFormsDataSearchResponse, IFormsDataVectorSearch, IImageValue, IImageValueParams, IListOptionExtended, IListOptionValue, IPostFormResponse, IPostFormResponseData, ITextEditorParams, ITextValue, ITextWithHeaderValue, ITimeDateValue, IUpdateFormsData, };

package/dist/index.d.ts

@@ -21,6 +21,7 @@ import PagesApi from './pages/pagesApi';
 import PaymentsApi from './payments/paymentsApi';
 import ProductStatusesApi from './product-statuses/productStatusesApi';
 import ProductsApi from './products/productsApi';
+import SearchApi from './search/searchApi';
 import SitemapApi from './sitemap/sitemapApi';
 import SubscriptionsApi from './subscriptions/subscriptionsApi';
 import SystemApi from './system/systemApi';
@@ -53,6 +54,7 @@ export type * from './types';
  * @property {PaymentsApi} Payments - Payments API module.
  * @property {ProductsApi} Products - Products API module.
  * @property {ProductStatusesApi} ProductStatuses - Product statuses API module.
+ * @property {SearchApi} Search - Search API module.
  * @property {SitemapApi} Sitemap - Sitemap API module.
  * @property {SubscriptionsApi} Subscriptions - Subscriptions API module.
  * @property {SystemApi} System - System API module.
@@ -101,6 +103,8 @@ interface IDefineApi {
     Products: ProductsApi;
     /** Product statuses: getProductStatuses */
     ProductStatuses: ProductStatusesApi;
+    /** Public cross-entity search: globalSearch */
+    Search: SearchApi;
     /** Sitemap generation */
     Sitemap: SitemapApi;
     /** Paid subscriptions: subscribe, cancelSubscription, recoverSubscriptions, getAllSubscriptions, getActiveSubscriptions */

package/dist/index.js

@@ -28,6 +28,7 @@ const pagesApi_1 = __importDefault(require("./pages/pagesApi"));
 const paymentsApi_1 = __importDefault(require("./payments/paymentsApi"));
 const productStatusesApi_1 = __importDefault(require("./product-statuses/productStatusesApi"));
 const productsApi_1 = __importDefault(require("./products/productsApi"));
+const searchApi_1 = __importDefault(require("./search/searchApi"));
 const sitemapApi_1 = __importDefault(require("./sitemap/sitemapApi"));
 const subscriptionsApi_1 = __importDefault(require("./subscriptions/subscriptionsApi"));
 const systemApi_1 = __importDefault(require("./system/systemApi"));
@@ -91,6 +92,7 @@ function defineOneEntry(url, config) {
     const Payments = new paymentsApi_1.default(stateModule);
     const Products = new productsApi_1.default(stateModule);
     const ProductStatuses = new productStatusesApi_1.default(stateModule);
+    const Search = new searchApi_1.default(stateModule);
     const Sitemap = new sitemapApi_1.default(stateModule);
     const Subscriptions = new subscriptionsApi_1.default(stateModule);
     const System = new systemApi_1.default(stateModule);
@@ -119,6 +121,7 @@ function defineOneEntry(url, config) {
         Payments,
         Products,
         ProductStatuses,
+        Search,
         Sitemap,
         Subscriptions,
         System,

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/ordersApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { IBaseOrdersEntity, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderPreviewResponse, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrderStatus, IRefundRequest } from './ordersInterfaces';
+import type { IBaseOrdersEntity, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderPreviewResponse, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrderStatus, IOrdersVectorSearch, IRefundRequest } from './ordersInterfaces';
 /**
  * Controllers for working with orders.
  * @handle /api/content/orders-storage
@@ -183,6 +183,20 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/cancelRefundRequest cancelRefundRequest} documentation.
      */
     cancelRefundRequest(id: number): Promise<boolean | IError>;
+    /**
+     * Semantic (vector) search for the current user's orders.
+     * @handleName getOrdersByVectorSearch
+     * @param {IOrdersVectorSearch} body - Vector search body. Example: `{ queryText: "winter jacket" }`.
+     * @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<IOrdersByMarkerEntity | IError>} Returns an object with an array of found orders and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method performs a semantic (vector) search over the orders of the authorized user. It requires user authorization.
+     * @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/orders/getOrdersByVectorSearch getOrdersByVectorSearch} documentation.
+     */
+    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
     /**
      * Runs a fetch against the `/orders` base URL instead of the default
      * `/orders-storage`, then restores the original URL.

package/dist/orders/ordersApi.js

@@ -279,6 +279,28 @@ class OrdersApi extends asyncModules_1.default {
         const data = await this._withOrdersUrl(() => this._fetchDelete(`/${id}/refund`));
         return this._normalizeData(data);
     }
+    /**
+     * Semantic (vector) search for the current user's orders.
+     * @handleName getOrdersByVectorSearch
+     * @param {IOrdersVectorSearch} body - Vector search body. Example: `{ queryText: "winter jacket" }`.
+     * @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<IOrdersByMarkerEntity | IError>} Returns an object with an array of found orders and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method performs a semantic (vector) search over the orders of the authorized user. It requires user authorization.
+     * @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/orders/getOrdersByVectorSearch getOrdersByVectorSearch} documentation.
+     */
+    async getOrdersByVectorSearch(body, langCode = this.state.lang, offset = 0, limit = 30) {
+        const query = {
+            langCode,
+            offset,
+            limit,
+        };
+        const data = await this._withOrdersUrl(() => this._fetchPost(`/vector/search?` + this._queryParamsToString(query), body));
+        return this._normalizeData(data, langCode);
+    }
     /**
      * Runs a fetch against the `/orders` base URL instead of the default
      * `/orders-storage`, then restores the original URL.

package/dist/orders/ordersInterfaces.d.ts

@@ -158,6 +158,32 @@ interface IOrdersApi {
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
     cancelRefundRequest(id: number): Promise<boolean | IError>;
+    /**
+     * Semantic (vector) search for the current user's orders.
+     * @handleName getOrdersByVectorSearch
+     * @param {IOrdersVectorSearch} body - Vector search body. Example: `{ queryText: "winter jacket" }`.
+     * @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<IOrdersByMarkerEntity | IError>} Returns an object with an array of found orders and total count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     */
+    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
+}
+/**
+ * Body for semantic (vector) order search.
+ * @interface IOrdersVectorSearch
+ * @property {string} queryText - Natural-language search query. Example: "winter jacket".
+ * @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 orders vector/search endpoint.
+ */
+interface IOrdersVectorSearch {
+    queryText: string;
+    vectorDistanceThreshold?: number;
+    maxHits?: number;
+    debug?: boolean;
 }
 /**
  * Interface for the orders storage object.
@@ -575,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 {
@@ -602,6 +629,7 @@ interface IOrderByMarkerEntity {
     paymentStatusLocalizeInfos?: ILocalizeInfo | null;
     discountConfig?: IOrderDiscountConfig | null;
     split?: IOrderSplit;
+    distance?: number;
 }
 /**
  * Interface representing an order status object.
@@ -734,4 +762,4 @@ interface ICreateRefundRequest {
     products: Record<string, IRefundProduct>;
     note?: string;
 }
-export type { IBaseOrdersEntity, IBaseOrdersEntityResponse, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderDiscountBonus, IOrderDiscountConfig, IOrderDiscountSettings, IOrderPreviewItem, IOrderPreviewResponse, IOrderProductData, IOrderProducts, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrdersFormData, IOrderSplit, IOrderSplitStage, IOrderStatus, IPaymentAccountIdentifiers, IPicture, IPreviewOrderProduct, IRefundProduct, IRefundRequest, };
+export type { IBaseOrdersEntity, IBaseOrdersEntityResponse, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderDiscountBonus, IOrderDiscountConfig, IOrderDiscountSettings, IOrderPreviewItem, IOrderPreviewResponse, IOrderProductData, IOrderProducts, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrdersFormData, IOrderSplit, IOrderSplitStage, IOrderStatus, IOrdersVectorSearch, IPaymentAccountIdentifiers, IPicture, IPreviewOrderProduct, IRefundProduct, IRefundRequest, };

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