oneentry 1.0.160 → 1.0.161

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,48 @@
 # SDK Change Log
 
+## 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 are applied by the API only when a single type is requested
+  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).
+
+  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
+
+- 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.
@@ -98,4 +134,4 @@ interface IAdminQuery {
     limit: number;
     offset: number;
 }
-export type { IAdminEntity, IAdminQuery, IAdmins, IPosition };
+export type { IAdminEntity, IAdminQuery, IAdmins, IAdminsResponse, IAdminsVectorSearch, IPosition, };

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/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.
@@ -264,4 +290,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,79 @@ 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} [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} [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".
+ * @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;
+    entityIdentifier?: string;
+    parentId?: number;
+    ip?: string;
+    fingerprint?: string;
+    isUserAdmin?: boolean;
+    status?: 'sent' | 'banned' | 'deleted' | 'moderation' | 'approved';
+}
+/**
+ * @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 +667,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/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.