oneentry 1.0.166 → 1.0.168

package/esm/base/validation.js

@@ -169,12 +169,15 @@ export function createPaginatedSchema(itemSchema) {
     });
 }
 /**
- * Validation helper function
+ * Validation helper function.
+ *
+ * This is the strict half of the pair: it reports a failure instead of hiding it.
+ * Strictness is the choice of function, not an option — `validateResponseSafe` is the
+ * lenient one, and `_validateResponse` picks between them by `config.validation.strictMode`.
  * @param {z.ZodSchema<T>} schema - Zod schema to validate against
  * @param {unknown} data - Data to validate
- * @param {object} options - Validation options
- * @param {boolean} options.strict - Whether to use strict mode
- * @param {boolean} options.logErrors - Whether to log errors
+ * @param {object} [options] - Validation options
+ * @param {boolean} [options.logErrors] - Whether to log errors
  * @returns {object} Validated data or error
  */
 export function validateResponse(schema, data, options) {

package/esm/discounts/discountsApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules.js';
 import type StateModule from '../base/stateModule.js';
 import type { IError } from '../base/utils.js';
-import type { IBonusBalanceEntity, IBonusTransactionEntity, IBonusTransactionType, ICouponValidationResult, IDiscountsApi, IDiscountsEntity, IDiscountsResponse, IDiscountsVectorSearch, IDiscountType } from './discountsInterfaces.js';
+import type { IBonusBalanceEntity, IBonusHistoryResponse, IBonusTransactionType, ICouponValidationResult, IDiscountsApi, IDiscountsEntity, IDiscountsResponse, IDiscountsVectorSearch, IDiscountType } from './discountsInterfaces.js';
 /**
  * Controllers for working with events
  * @handle /api/content/events
@@ -63,11 +63,11 @@ export default class DiscountsApi extends AsyncModules implements IDiscountsApi
      * @param {number} [discountId] - Discount id filter.
      * @param {number} [moduleId] - Module id filter.
      * @param {boolean} [isAdmin] - Admin filter.
-     * @returns {Promise<IBonusTransactionEntity[] | IError>} Returns array of bonus transactions or an error object.
+     * @returns {Promise<IBonusHistoryResponse | IError>} Returns the container with the transactions and their total, or an error object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/getBonusHistory getBonusHistory} documentation.
      */
-    getBonusHistory(type?: IBonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean): Promise<IBonusTransactionEntity[] | IError>;
+    getBonusHistory(type?: IBonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean): Promise<IBonusHistoryResponse | IError>;
     /**
      * Validate discounts coupon
      * @handleName validateDiscountsCoupon

package/esm/discounts/discountsApi.js

@@ -80,7 +80,7 @@ export default class DiscountsApi extends AsyncModules {
      * @param {number} [discountId] - Discount id filter.
      * @param {number} [moduleId] - Module id filter.
      * @param {boolean} [isAdmin] - Admin filter.
-     * @returns {Promise<IBonusTransactionEntity[] | IError>} Returns array of bonus transactions or an error object.
+     * @returns {Promise<IBonusHistoryResponse | IError>} Returns the container with the transactions and their total, or an error object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/getBonusHistory getBonusHistory} documentation.
      */

package/esm/discounts/discountsInterfaces.d.ts

@@ -55,10 +55,10 @@ interface IDiscountsApi {
      * @param {number} [discountId] - Discount id filter.
      * @param {number} [moduleId] - Module id filter.
      * @param {boolean} [isAdmin] - Admin filter.
-     * @returns {Promise<IBonusTransactionEntity[] | IError>} Returns array of bonus transactions or an error object.
+     * @returns {Promise<IBonusHistoryResponse | IError>} Returns the container with the transactions and their total, or an error object.
      * @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>;
+    getBonusHistory(type?: IBonusTransactionType, dateFrom?: string, dateTo?: string, discountId?: number, moduleId?: number, isAdmin?: boolean): Promise<IBonusHistoryResponse | IError>;
     /**
      * Semantic (vector) search for discounts.
      * @handleName getDiscountsByVectorSearch
@@ -284,6 +284,18 @@ interface IBonusTransactionEntity {
     expiresAt?: string;
     createdAt?: string;
 }
+/**
+ * @interface IBonusHistoryResponse
+ * @property {IBonusTransactionEntity[]} items - The transactions of the current page.
+ * @property {number} total - How many transactions the filter matches in total.
+ * @description Container the bonus history arrives in. The endpoint answers
+ * `{ items, total }`, not a bare array — measured on the SDK test stand,
+ * 2026-09-28: an account with no transactions answers `{"items":[],"total":0}`.
+ */
+interface IBonusHistoryResponse {
+    items: IBonusTransactionEntity[];
+    total: number;
+}
 /**
  * @interface IBonusBalanceEntity
  * @description Represents the balance of bonus points.
@@ -292,4 +304,4 @@ interface IBonusTransactionEntity {
 interface IBonusBalanceEntity {
     balance: number;
 }
-export type { IBonusBalanceEntity, IBonusHistoryQuery, IBonusTransactionEntity, IBonusTransactionType, ICouponEntity, ICouponValidationResult, IDiscountByMarkerQuery, IDiscountCondition, IDiscountsApi, IDiscountsEntity, IDiscountsQuery, IDiscountsResponse, IDiscountsValidateCoupon, IDiscountsVectorSearch, IDiscountType, IDiscountValue, };
+export type { IBonusBalanceEntity, IBonusHistoryQuery, IBonusHistoryResponse, IBonusTransactionEntity, IBonusTransactionType, ICouponEntity, ICouponValidationResult, IDiscountByMarkerQuery, IDiscountCondition, IDiscountsApi, IDiscountsEntity, IDiscountsQuery, IDiscountsResponse, IDiscountsValidateCoupon, IDiscountsVectorSearch, IDiscountType, IDiscountValue, };

package/esm/file-uploading/fileUploadingApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules.js';
 import type StateModule from '../base/stateModule.js';
 import type { IError } from '../base/utils.js';
-import type { IFileUploading, IUploadingQuery, IUploadingReturn } from './fileUploadingInterfaces.js';
+import type { IFileSearchResponse, IFileUploading, IUploadingQuery, IUploadingReturn } from './fileUploadingInterfaces.js';
 /**
  * Controllers for working with file uploading
  * @handle /api/content/files
@@ -67,6 +67,32 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
      * @see {@link https://js-sdk.oneentry.cloud/docs/file-uploading/delete delete} documentation.
      */
     delete(filename: string, fileQuery?: IUploadingQuery): Promise<boolean | IError>;
+    /**
+     * Public search across the content of files attached to records.
+     * @handleName searchFileContent
+     * @param {string} query - Search query, at least 3 characters — shorter is rejected with 400. Example: "transportation".
+     * @param {string} [langCode] - Language of the query. Example: "en_US".
+     * @param {string[]} [extensions] - Filter by file extension, sent comma-separated. Example: ["pdf", "docx"].
+     * @param {string[]} [ownerTables] - Filter by the section the attached record belongs to, sent comma-separated. Example: ["products", "pages"].
+     * @param {string[]} [localeCodes] - Filter by the locale of the link, not of the file content. Example: ["en_US"].
+     * @param {boolean} [onlyTruncated] - Return only files whose extracted text was cut at the size ceiling.
+     * @param {number} [offset] - Parameter for pagination. Default: 0.
+     * @param {number} [limit] - Parameter for pagination. Default: 10, maximum 50 — a larger value is rejected with 400 "limit must not be greater than 50".
+     * @returns {Promise<IFileSearchResponse | IError>} Returns the found files with their matching fragments.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description The unit of the result is a **file, not a fragment**: one `snippet` per file,
+     * even when the document matches on many pages. Matches inside the snippet are wrapped in the
+     * control characters `U+0002` and `U+0003` rather than HTML, so replace them before rendering.
+     * The result is narrowed by access: only files of visible records of the sections enabled in the
+     * project settings, personal sections only down to the caller's own records, and the admins
+     * section is never returned. A separate 403 means the feature is not part of the project tariff.
+     * @example
+     * ```ts
+     * const found = await api.FileUploading.searchFileContent('transportation', 'en_US', ['pdf']);
+     * ```
+     * @see {@link https://js-sdk.oneentry.cloud/docs/file-uploading/searchFileContent searchFileContent} documentation.
+     */
+    searchFileContent(query: string, langCode?: string, extensions?: string[], ownerTables?: string[], localeCodes?: string[], onlyTruncated?: boolean, offset?: number, limit?: number): Promise<IFileSearchResponse | IError>;
     /**
      * Create a File object from a URL.
      * @param {string} url - The URL to fetch the file from.

package/esm/file-uploading/fileUploadingApi.js

@@ -87,6 +87,48 @@ export default class FileUploadingApi extends AsyncModules {
         const result = await this._fetchDelete(`?filename=${filename}&` + this._queryParamsToString(query));
         return result;
     }
+    /**
+     * Public search across the content of files attached to records.
+     * @handleName searchFileContent
+     * @param {string} query - Search query, at least 3 characters — shorter is rejected with 400. Example: "transportation".
+     * @param {string} [langCode] - Language of the query. Example: "en_US".
+     * @param {string[]} [extensions] - Filter by file extension, sent comma-separated. Example: ["pdf", "docx"].
+     * @param {string[]} [ownerTables] - Filter by the section the attached record belongs to, sent comma-separated. Example: ["products", "pages"].
+     * @param {string[]} [localeCodes] - Filter by the locale of the link, not of the file content. Example: ["en_US"].
+     * @param {boolean} [onlyTruncated] - Return only files whose extracted text was cut at the size ceiling.
+     * @param {number} [offset] - Parameter for pagination. Default: 0.
+     * @param {number} [limit] - Parameter for pagination. Default: 10, maximum 50 — a larger value is rejected with 400 "limit must not be greater than 50".
+     * @returns {Promise<IFileSearchResponse | IError>} Returns the found files with their matching fragments.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description The unit of the result is a **file, not a fragment**: one `snippet` per file,
+     * even when the document matches on many pages. Matches inside the snippet are wrapped in the
+     * control characters `U+0002` and `U+0003` rather than HTML, so replace them before rendering.
+     * The result is narrowed by access: only files of visible records of the sections enabled in the
+     * project settings, personal sections only down to the caller's own records, and the admins
+     * section is never returned. A separate 403 means the feature is not part of the project tariff.
+     * @example
+     * ```ts
+     * const found = await api.FileUploading.searchFileContent('transportation', 'en_US', ['pdf']);
+     * ```
+     * @see {@link https://js-sdk.oneentry.cloud/docs/file-uploading/searchFileContent searchFileContent} documentation.
+     */
+    async searchFileContent(query, langCode = this.state.lang, extensions, ownerTables, localeCodes, onlyTruncated, offset, limit) {
+        // Array filters are sent comma-separated — an array stringifies to exactly that.
+        const params = {
+            q: query,
+            langCode,
+            extensions,
+            ownerTables,
+            localeCodes,
+            onlyTruncated,
+            offset,
+            limit,
+        };
+        const result = await this._fetchGet(`/search?` + this._queryParamsToString(params));
+        // Validate response if validation is enabled
+        const validated = await this._validateResponse(result, schema('FileSearchResponseSchema'));
+        return this._normalizeData(validated);
+    }
     /**
      * Create a File object from a URL.
      * @param {string} url - The URL to fetch the file from.

package/esm/file-uploading/fileUploadingInterfaces.d.ts

@@ -71,6 +71,22 @@ interface IFileUploading {
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
     getFile(id: number, type: string, entity: string, filename: string, template?: string): Promise<Response | IError>;
+    /**
+     * Public search across the content of files attached to records.
+     * @handleName searchFileContent
+     * @param {string} query - Search query, at least 3 characters. Example: "transportation".
+     * @param {string} [langCode] - Language of the query. Example: "en_US".
+     * @param {string[]} [extensions] - Filter by file extension, sent comma-separated. Example: ["pdf", "docx"].
+     * @param {string[]} [ownerTables] - Filter by the section the attached record belongs to. Example: ["products", "pages"].
+     * @param {string[]} [localeCodes] - Filter by the locale of the link, not of the file content. Example: ["en_US"].
+     * @param {boolean} [onlyTruncated] - Return only files whose extracted text was cut at the size ceiling.
+     * @param {number} [offset] - Parameter for pagination. Default: 0.
+     * @param {number} [limit] - Parameter for pagination, 1 to 50. Default: 10.
+     * @returns {IFileSearchResponse} Returns the found files with their matching fragments.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method searches the content of files attached to records.
+     */
+    searchFileContent(query: string, langCode?: string, extensions?: string[], ownerTables?: string[], localeCodes?: string[], onlyTruncated?: boolean, offset?: number, limit?: number): Promise<IFileSearchResponse | IError>;
 }
 /**
  * Represents a file entity that may contain a file object or a path as a string.
@@ -113,4 +129,89 @@ interface IUploadingReturn {
     size: number;
     contentType: string;
 }
-export type { IFileEntity, IFileUploading, IUploadingQuery, IUploadingReturn };
+/**
+ * The `IFileSearchOwner` interface describes one record a found file is attached to.
+ * @interface IFileSearchOwner
+ * @property {string} tableName - Section the record belongs to. Example: "products".
+ * @property {number} dataId - Identifier of the record. Example: 644.
+ * @property {string} title - Title of the record. Example: "COG — March 17, 2016".
+ * @property {string} langCode - Locale of the link, not of the file content. Example: "en_US".
+ * @description One record a found file is attached to. The same file can be attached to several records, and a record contributes one entry per locale.
+ */
+interface IFileSearchOwner {
+    tableName: string;
+    dataId: number;
+    title: string;
+    langCode: string;
+}
+/**
+ * The `IFileSearchSnippet` interface describes the matching fragment of a file.
+ * @interface IFileSearchSnippet
+ * @property {string} text - The fragment itself. Every match inside it is wrapped in the control characters U+0002 and U+0003 — not HTML, so replace them before rendering. Example: "… Active \u0002Transportation\u0003 2…".
+ * @property {number | null} pageFrom - Page the fragment starts on, for paged formats. Example: 86.
+ * @description The matching fragment of a file. One fragment per file, even when the document matches on many pages.
+ */
+interface IFileSearchSnippet {
+    text: string;
+    pageFrom: number | null;
+}
+/**
+ * The `IFileSearchItem` interface describes one found file.
+ * @interface IFileSearchItem
+ * @property {number} id - Identifier of the indexed file. Example: 1077.
+ * @property {string} storageKey - Key of the object in the storage; the file link is built from it. Example: "files/project/file/644/product/db1918c4.pdf".
+ * @property {string} extension - File extension. Example: "pdf".
+ * @property {string | null} title - Title from the document metadata, `null` when the document carries none. Example: "Microsoft Word - COG Agenda.docx".
+ * @property {string | null} langCode - Language of the file content, detected on indexing. Example: "en".
+ * @property {number | null} pageCount - Number of pages, for paged formats. Example: 244.
+ * @property {number} rank - Relevance of the match; the API sorts by it descending. Example: 0.0971.
+ * @property {IFileSearchSnippet | null} snippet - The matching fragment.
+ * @property {IFileSearchOwner[]} owners - Records the file is attached to, limited to those the caller may see.
+ * @property {number} ownersTotal - How many records visible to the caller reference the file. Example: 2.
+ * @description One found file. The unit of the result is a file, not a fragment.
+ */
+interface IFileSearchItem {
+    id: number;
+    storageKey: string;
+    extension: string;
+    title: string | null;
+    langCode: string | null;
+    pageCount: number | null;
+    rank: number;
+    snippet: IFileSearchSnippet | null;
+    owners: IFileSearchOwner[];
+    ownersTotal: number;
+}
+/**
+ * The `IFileSearchQueryLanguage` interface describes how the query language was resolved.
+ * @interface IFileSearchQueryLanguage
+ * @property {string[]} resolved - Languages the query was actually run in. Example: ["english"].
+ * @property {string} source - How they were chosen: "explicit" when taken from `langCode`, otherwise detected. Example: "explicit".
+ * @property {string[]} candidates - Languages considered. Example: ["english"].
+ * @description How the query language was resolved for the search.
+ */
+interface IFileSearchQueryLanguage {
+    resolved: string[];
+    source: string;
+    candidates: string[];
+}
+/**
+ * The `IFileSearchResponse` interface describes the result of a file content search.
+ * @interface IFileSearchResponse
+ * @property {number} total - Total number of matching files. Example: 166.
+ * @property {number} offset - Offset the page starts at. Example: 0.
+ * @property {number} limit - Page size. Example: 10.
+ * @property {IFileSearchQueryLanguage} queryLanguage - How the query language was resolved.
+ * @property {string[]} warnings - Warnings about the search, empty when there are none.
+ * @property {IFileSearchItem[]} items - The found files.
+ * @description The result of a file content search.
+ */
+interface IFileSearchResponse {
+    total: number;
+    offset: number;
+    limit: number;
+    queryLanguage: IFileSearchQueryLanguage;
+    warnings: string[];
+    items: IFileSearchItem[];
+}
+export type { IFileEntity, IFileSearchItem, IFileSearchOwner, IFileSearchQueryLanguage, IFileSearchResponse, IFileSearchSnippet, IFileUploading, IUploadingQuery, IUploadingReturn, };

package/esm/file-uploading/fileUploadingSchemas.d.ts

@@ -22,3 +22,76 @@ export declare const UploadResponseSchema: z.ZodArray<z.ZodObject<{
     size: z.ZodNumber;
     contentType: z.ZodString;
 }, z.core.$strip>>;
+/**
+ * One record a found file is attached to
+ */
+export declare const FileSearchOwnerSchema: z.ZodObject<{
+    tableName: z.ZodString;
+    dataId: z.ZodNumber;
+    title: z.ZodString;
+    langCode: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Matching fragment of a found file
+ */
+export declare const FileSearchSnippetSchema: z.ZodObject<{
+    text: z.ZodString;
+    pageFrom: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * One found file
+ */
+export declare const FileSearchItemSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    storageKey: z.ZodString;
+    extension: z.ZodString;
+    title: z.ZodNullable<z.ZodString>;
+    langCode: z.ZodNullable<z.ZodString>;
+    pageCount: z.ZodNullable<z.ZodNumber>;
+    rank: z.ZodNumber;
+    snippet: z.ZodNullable<z.ZodObject<{
+        text: z.ZodString;
+        pageFrom: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    owners: z.ZodArray<z.ZodObject<{
+        tableName: z.ZodString;
+        dataId: z.ZodNumber;
+        title: z.ZodString;
+        langCode: z.ZodString;
+    }, z.core.$strip>>;
+    ownersTotal: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * File content search response
+ */
+export declare const FileSearchResponseSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+    queryLanguage: z.ZodObject<{
+        resolved: z.ZodArray<z.ZodString>;
+        source: z.ZodString;
+        candidates: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    warnings: z.ZodArray<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        storageKey: z.ZodString;
+        extension: z.ZodString;
+        title: z.ZodNullable<z.ZodString>;
+        langCode: z.ZodNullable<z.ZodString>;
+        pageCount: z.ZodNullable<z.ZodNumber>;
+        rank: z.ZodNumber;
+        snippet: z.ZodNullable<z.ZodObject<{
+            text: z.ZodString;
+            pageFrom: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        owners: z.ZodArray<z.ZodObject<{
+            tableName: z.ZodString;
+            dataId: z.ZodNumber;
+            title: z.ZodString;
+            langCode: z.ZodString;
+        }, z.core.$strip>>;
+        ownersTotal: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

package/esm/file-uploading/fileUploadingSchemas.js

@@ -17,3 +17,49 @@ export const UploadingReturnSchema = z.object({
  * Upload response schema (array of upload results)
  */
 export const UploadResponseSchema = z.array(UploadingReturnSchema);
+/**
+ * One record a found file is attached to
+ */
+export const FileSearchOwnerSchema = z.object({
+    tableName: z.string(),
+    dataId: z.number(),
+    title: z.string(),
+    langCode: z.string(),
+});
+/**
+ * Matching fragment of a found file
+ */
+export const FileSearchSnippetSchema = z.object({
+    text: z.string(),
+    pageFrom: z.number().nullable(),
+});
+/**
+ * One found file
+ */
+export const FileSearchItemSchema = z.object({
+    id: z.number(),
+    storageKey: z.string(),
+    extension: z.string(),
+    title: z.string().nullable(),
+    langCode: z.string().nullable(),
+    pageCount: z.number().nullable(),
+    rank: z.number(),
+    snippet: FileSearchSnippetSchema.nullable(),
+    owners: z.array(FileSearchOwnerSchema),
+    ownersTotal: z.number(),
+});
+/**
+ * File content search response
+ */
+export const FileSearchResponseSchema = z.object({
+    total: z.number(),
+    offset: z.number(),
+    limit: z.number(),
+    queryLanguage: z.object({
+        resolved: z.array(z.string()),
+        source: z.string(),
+        candidates: z.array(z.string()),
+    }),
+    warnings: z.array(z.string()),
+    items: z.array(FileSearchItemSchema),
+});

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

@@ -420,6 +420,133 @@ interface IUpdateFormsData {
  * Contains an array of data form objects with the following values
  */
 type FormDataType = IBodyTypeStringNumberFloat | IBodyTypeTimeDate | IBodyTypeText | IBodyTypeTextWithHeader | IBodyTypeImageGroupOfImages | IBodyTypeFile | IBodyTypeRadioButtonList | Record<string, unknown>;
+/**
+ * Value shapes accepted by a SUBMISSION (`POST /form-data`).
+ *
+ * For three field kinds they are not the shapes a page attribute uses, and a
+ * body written from the read types is refused. Measured on
+ * rwah2o.oneentry.cloud, 2026-09-12 and again 2026-09-28 (CMS-888).
+ *
+ * `list` takes a list of strings; the `[{ title, value }]` form of a page
+ * attribute answers `400 formData's marker '<marker>' value[0] must be a string`.
+ *
+ * `text` takes a one-element array holding exactly ONE of `plainValue`,
+ * `htmlValue` or `mdValue`, and no `params`. The object form answers
+ * `400 … value must be an array`, `params` answers `… is not allowed`, and two
+ * representations answer `Only one of htmlValue, plainValue or mdValue can be provided`.
+ *
+ * `spam` takes the captcha event, not the bare token.
+ */
+type FormDataPostType = IBodyTypeStringNumberFloat | IBodyTypeTimeDate | IBodyPostTypeText | IBodyPostTypeList | IBodyPostTypeSpam | IBodyTypeTextWithHeader | IBodyTypeImageGroupOfImages | IBodyTypeFile | Record<string, unknown>;
+/**
+ * Represents a `list` field of a form SUBMISSION.
+ * @interface IBodyPostTypeList
+ * @property {string} marker - marker name. Example: "recipient".
+ * @property {string} type - Type value. Example: "list".
+ * @property {string[]} value - Chosen options as plain strings. Example: ["Tom Hoffart"].
+ * @example
+    {
+      "marker": "recipient",
+      "type": "list",
+      "value": ["Tom Hoffart"]
+    }
+ * @description A submission sends the chosen options as strings. The `[{ title, value }]`
+ * shape a page attribute stores is refused here with `value[0] must be a string`.
+ */
+interface IBodyPostTypeList {
+    marker: string;
+    type: 'list';
+    value: string[];
+}
+/**
+ * Represents a `text` field of a form SUBMISSION.
+ * @interface IBodyPostTypeText
+ * @property {string} marker - marker name. Example: "your_message".
+ * @property {string} type - Type value. Example: "text".
+ * @property {ITextSubmissionValue[]} value - One-element array holding exactly one representation.
+ * @example
+    {
+      "marker": "your_message",
+      "type": "text",
+      "value": [{ "plainValue": "Hello" }]
+    }
+ * @description The array holds one object carrying exactly one of `plainValue`,
+ * `htmlValue` or `mdValue`. Editor `params` are refused, and so is sending two
+ * representations at once.
+ */
+interface IBodyPostTypeText {
+    marker: string;
+    type: 'text';
+    value: ITextSubmissionValue[];
+}
+/**
+ * @interface ITextSubmissionValuePlain
+ * @property {string} plainValue - Plain-text representation. Example: "Hello".
+ * @description Plain-text branch of a submitted text value.
+ */
+interface ITextSubmissionValuePlain {
+    plainValue: string;
+}
+/**
+ * @interface ITextSubmissionValueHtml
+ * @property {string} htmlValue - HTML representation. Example: "<p>Hello</p>".
+ * @description HTML branch of a submitted text value.
+ */
+interface ITextSubmissionValueHtml {
+    htmlValue: string;
+}
+/**
+ * @interface ITextSubmissionValueMd
+ * @property {string} mdValue - Markdown representation. Must not be empty. Example: "**Hello**".
+ * @description Markdown branch of a submitted text value.
+ */
+interface ITextSubmissionValueMd {
+    mdValue: string;
+}
+/**
+ * Exactly one representation of a submitted text value.
+ */
+type ITextSubmissionValue = ITextSubmissionValuePlain | ITextSubmissionValueHtml | ITextSubmissionValueMd;
+/**
+ * Represents a `spam` (captcha) field of a form SUBMISSION.
+ * @interface IBodyPostTypeSpam
+ * @property {string} marker - marker name. Example: "spam".
+ * @property {string} type - Type value. Example: "spam".
+ * @property {ICaptchaValue} value - The captcha event, not the bare token.
+ * @example
+    {
+      "marker": "spam",
+      "type": "spam",
+      "value": { "event": { "token": "<reCAPTCHA v3 token>", "siteKey": "6Ldjk7Yt…" } }
+    }
+ * @description The field carries a reCAPTCHA v3 token obtained in the browser.
+ * A bare string is refused with the same sentence as a wrong token —
+ * `Captcha Validation Failed, captcha type is: google` — so a malformed value
+ * is indistinguishable from a bot.
+ */
+interface IBodyPostTypeSpam {
+    marker: string;
+    type: 'spam';
+    value: ICaptchaValue;
+}
+/**
+ * @interface ICaptchaEvent
+ * @property {string} token - The token issued by the captcha provider in the browser.
+ * @property {string} siteKey - The site key the token was issued for. Example: "6Ldjk7Yt…".
+ * @description The captcha payload of a `spam` field.
+ */
+interface ICaptchaEvent {
+    token: string;
+    siteKey: string;
+}
+/**
+ * @interface ICaptchaValue
+ * @property {ICaptchaEvent} event - The captcha payload.
+ * @description Wrapper the platform expects around the captcha payload.
+ */
+interface ICaptchaValue {
+    event: ICaptchaEvent;
+}
 /**
  * Represents the structure of the body for posting form data.
  * @interface IBodyPostFormData
@@ -428,7 +555,7 @@ type FormDataType = IBodyTypeStringNumberFloat | IBodyTypeTimeDate | IBodyTypeTe
  * @property {string} moduleEntityIdentifier - Text identifier (marker) of the module entity. Example: "blog".
  * @property {string | null} replayTo - Email to reply to. Example: "some@email.com".
  * @property {string} status - Status of the form. Example: "sent".
- * @property {FormDataType[]} formData - Array of form data objects.
+ * @property {FormDataPostType[]} formData - Array of form data objects. A submission's value shapes differ from the read shapes — see FormDataPostType.
  * @example
     [
       {
@@ -455,7 +582,7 @@ interface IBodyPostFormData {
     moduleEntityIdentifier: string;
     replayTo: string | null;
     status: string;
-    formData: FormDataType[];
+    formData: FormDataPostType[];
     fileQuery?: IUploadingQuery;
 }
 /**
@@ -711,4 +838,4 @@ interface IListOptionValue {
     value: string;
     extended: IListOptionExtended;
 }
-export type { FormDataStatus, FormDataType, IBodyPostFormData, IBodyTypeFile, IBodyTypeImageGroupOfImages, IBodyTypeRadioButtonList, IBodyTypeStringNumberFloat, IBodyTypeText, IBodyTypeTextWithHeader, IBodyTypeTimeDate, IFileValue, IFormByMarkerDataEntity, IFormDataEntity, IFormDataSearchEntity, IFormsByMarkerDataEntity, IFormsData, IFormsDataEntity, IFormsDataFilter, IFormsDataSearchResponse, IFormsDataVectorSearch, IImageValue, IImageValueParams, IListOptionExtended, IListOptionValue, IPostFormResponse, IPostFormResponseData, ITextEditorParams, ITextValue, ITextWithHeaderValue, ITimeDateValue, IUpdateFormsData, };
+export type { FormDataPostType, FormDataStatus, FormDataType, IBodyPostFormData, IBodyPostTypeList, IBodyPostTypeSpam, IBodyPostTypeText, IBodyTypeFile, IBodyTypeImageGroupOfImages, IBodyTypeRadioButtonList, IBodyTypeStringNumberFloat, IBodyTypeText, IBodyTypeTextWithHeader, IBodyTypeTimeDate, ICaptchaEvent, ICaptchaValue, IFileValue, IFormByMarkerDataEntity, IFormDataEntity, IFormDataSearchEntity, IFormsByMarkerDataEntity, IFormsData, IFormsDataEntity, IFormsDataFilter, IFormsDataSearchResponse, IFormsDataVectorSearch, IImageValue, IImageValueParams, IListOptionExtended, IListOptionValue, IPostFormResponse, IPostFormResponseData, ITextEditorParams, ITextSubmissionValue, ITextValue, ITextWithHeaderValue, ITimeDateValue, IUpdateFormsData, };

package/esm/index.d.ts

@@ -28,6 +28,7 @@ import SystemApi from './system/systemApi.js';
 import TemplatesApi from './templates/templatesApi.js';
 import TemplatePreviewsApi from './templates-preview/templatesPreviewApi.js';
 import UserActivityApi from './user-activity/userActivityApi.js';
+import UserGroupsApi from './user-groups/userGroupsApi.js';
 import UsersApi from './users/usersApi.js';
 import WsApi from './web-socket/wsApi.js';
 export { getAdditionalFields, getAttributeFile, getAttributeFiles, isFileAttribute, isListAttribute, isNumberAttribute, isStringAttribute, } from './base/attributes.js';
@@ -62,6 +63,7 @@ export type * from './types.js';
  * @property {TemplatesApi} Templates - Templates API module.
  * @property {TemplatePreviewsApi} TemplatePreviews - Template previews API module.
  * @property {UserActivityApi} UserActivity - User activity API module.
+ * @property {UserGroupsApi} UserGroups - User groups API module.
  * @property {UsersApi} Users - Users API module.
  * @property {WsApi} WS - WebSocket API module.
  */
@@ -118,6 +120,8 @@ interface IDefineApi {
     TemplatePreviews: TemplatePreviewsApi;
     /** User/guest activity tracking: trackUserActivity */
     UserActivity: UserActivityApi;
+    /** User groups tree: getUserGroups, getRootUserGroups, getUserGroupByMarker, getChildUserGroupsByMarker */
+    UserGroups: UserGroupsApi;
     /** Current authenticated user: getUser, updateUser */
     Users: UsersApi;
     /** WebSocket real-time updates */

package/esm/index.js

@@ -28,6 +28,7 @@ import SystemApi from './system/systemApi.js';
 import TemplatesApi from './templates/templatesApi.js';
 import TemplatePreviewsApi from './templates-preview/templatesPreviewApi.js';
 import UserActivityApi from './user-activity/userActivityApi.js';
+import UserGroupsApi from './user-groups/userGroupsApi.js';
 import UsersApi from './users/usersApi.js';
 import WsApi from './web-socket/wsApi.js';
 export { getAdditionalFields, getAttributeFile, getAttributeFiles, isFileAttribute, isListAttribute, isNumberAttribute, isStringAttribute, } from './base/attributes.js';
@@ -90,6 +91,7 @@ export function defineOneEntry(url, config) {
     const Templates = new TemplatesApi(stateModule);
     const TemplatePreviews = new TemplatePreviewsApi(stateModule);
     const UserActivity = new UserActivityApi(stateModule);
+    const UserGroups = new UserGroupsApi(stateModule);
     const Users = new UsersApi(stateModule);
     const WS = new WsApi(stateModule);
     return {
@@ -119,6 +121,7 @@ export function defineOneEntry(url, config) {
         Templates,
         TemplatePreviews,
         UserActivity,
+        UserGroups,
         Users,
         WS,
     };

package/esm/orders/ordersApi.d.ts

@@ -70,6 +70,20 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/getOrderByMarkerAndId getOrderByMarkerAndId} documentation.
      */
     getOrderByMarkerAndId(marker: string, id: number, langCode?: string): Promise<IOrderByMarkerEntity | IError>;
+    /**
+     * Getting a single order created by the user, by its own id.
+     * @handleName getOrderById
+     * @param {number} id - ID of the order object. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @returns {Promise<IOrderByMarkerEntity | IError>} Returns an object with the order.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method requires user authorization. Unlike `getOrderByMarkerAndId`,
+     * it does not need the storage marker — use it when only the order id is at hand, for
+     * example on the return URL of a payment provider or in a link from a notification.
+     * @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/getOrderById getOrderById} documentation.
+     */
+    getOrderById(id: number, langCode?: string): Promise<IOrderByMarkerEntity | IError>;
     /**
      * Preview order calculation with discounts and coupons (without saving).
      * @handleName previewOrder