oneentry 1.0.174 → 1.0.176

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

@@ -85,9 +85,9 @@ interface IFormsData {
 /**
  * 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] - Number of top candidates fetched before pagination. Default: 100. Maximum: 500. Example: 10.
+ * @property {string} queryText - Natural-language search query, 1 to 512 characters: an empty one answers `400 queryText should not be empty`, a longer one `400 queryText must be shorter than or equal to 512 characters`. Example: "order confirmation".
+ * @property {number} [vectorDistanceThreshold] - Override of the cosine distance threshold (0..2); a negative value answers `400`. Example: 0.3.
+ * @property {number} [maxHits] - Number of top candidates fetched before pagination, from 1. Default: 100. Maximum: 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.
  */
@@ -113,14 +113,14 @@ type FormDataStatus = 'sent' | 'moderation' | 'approved' | 'banned' | 'deleted';
  * @property {number} [parentId] - Identifier of the parent record — the way to fetch replies to one comment. Example: 10.
  * @property {string} [userIdentifier] - Text identifier of the sender; an empty string means "no filter". Example: "admin".
  * @property {FormDataStatus[]} [status] - Moderation statuses to keep. Must be an array — a bare string is rejected with `400`. An empty array means "no filter". Example: ["approved"].
- * @property {string} [dateFrom] - Lower bound of the submission date, `YYYY-MM-DD`; an empty string means "no bound" — `getFormsDataByMarker` strips it from the body, since the endpoint rejects an empty date with a `400`. A non-empty value the API cannot parse still fails the request. Example: "2025-01-01".
- * @property {string} [dateTo] - Upper bound of the submission date, `YYYY-MM-DD`; an empty string means "no bound", handled like `dateFrom`. Example: "2025-12-31".
+ * @property {string} [dateFrom] - Lower bound of the submission date, `YYYY-MM-DD` or `YYYY-MM-DD HH:MM:SS`; an empty string means "no bound" — `getFormsDataByMarker` strips it from the body, since the endpoint rejects an empty date with a `400`. A non-empty value the API cannot parse still fails the request. Example: "2025-01-01".
+ * @property {string} [dateTo] - Upper bound of the submission date, `YYYY-MM-DD` or `YYYY-MM-DD HH:MM:SS`; an empty string means "no bound", handled like `dateFrom`. Example: "2025-12-31".
  * @description Filter for reading form submissions. Every field is optional and an omitted one is simply not applied.
  *
- * Typed rather than left as `object` on purpose: the API **ignores** a field it
- * does not know, so `statuses: ['approved']` (note the "s") is not an error —
- * it returns every record, unmoderated ones included. That is premoderation
- * leaking onto a public page, from one typo the compiler used to accept.
+ * Typed rather than left as `object` on purpose: the API **refuses** a field it
+ * does not know, so `statuses: ['approved']` (note the "s") answers
+ * `400 property statuses should not exist` — the compiler catches the typo
+ * before the request does.
  */
 interface IFormsDataFilter {
     /**
@@ -419,7 +419,7 @@ 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>;
+type FormDataType = IBodyTypeStringNumberFloat | IBodyTypeTimeDate | IBodyTypeText | IBodyTypeTextWithHeader | IBodyTypeImageGroupOfImages | IBodyTypeFile | IBodyTypeRadioButtonList | IBodyTypeEntity | IBodyTypeTimeInterval | Record<string, unknown>;
 /**
  * Value shapes accepted by a SUBMISSION (`POST /form-data`).
  *
@@ -588,13 +588,13 @@ interface IBodyPostFormData {
  * Represents a form data entity with a simple value.
  * @interface IBodyTypeStringNumberFloat
  * @property {string} marker - marker name. Example: "some_marker".
- * @property {string} type - Type value. "string" | "number" | "float". Example: "string".
- * @property {string | number | null} value - Value of the form data entity. Send it as a string; in responses numeric fields come back normalized to `number`, or `null` when the field is empty. Example: "string".
+ * @property {string} type - Type value. "string" | "integer" | "number" | "float". Example: "string".
+ * @property {string | number | null} value - Value of the form data entity. A submission may send a number or a string; responses return numeric fields **as strings** — `3` comes back as `"3"`, `2.565` as `"2.565"` — or `null` when the field is empty. Convert with `Number(value)` before arithmetic. Example: "string".
  * @description Represents a form data entity with a marker, type, and value.
  */
 interface IBodyTypeStringNumberFloat {
     marker: string;
-    type: 'string' | 'number' | 'float';
+    type: 'string' | 'integer' | 'number' | 'float';
     value: string | number | null;
 }
 /**
@@ -633,43 +633,46 @@ interface ITimeDateValue {
  * @interface IBodyTypeText
  * @property {string} marker - marker name. Example: "some_marker".
  * @property {string} type - Type value. Example: "text".
- * @property {object} value - Text Object. Contains html as string, plain text and params.
+ * @property {ITextValue | ITextValue[]} value - Text value. A read returns a one-element **array**, without `plainValue` and with `params.editorMode`; older records may hold a single object.
  * @example
-    {
-      "htmlValue": "<p>Hello world</p>",
-      "plainValue": "",
-      "params": {
-        "isEditorDisabled": false,
-        "isImageCompressed": true
+    [
+      {
+        "htmlValue": "<p>Hello world</p>",
+        "params": {
+          "isImageCompressed": true,
+          "editorMode": "html"
+        }
       }
-    }
- * @description Represents a text value with HTML and plain text representations, along with parameters for editor and image compression settings.
+    ]
+ * @description Represents a text value with HTML and plain text representations, along with parameters for editor and image compression settings. To submit a text field use {@link IBodyPostTypeText}.
  */
 interface IBodyTypeText {
     marker: string;
     type: 'text';
-    value: ITextValue;
+    value: ITextValue | ITextValue[];
 }
 /**
  * @interface ITextEditorParams
- * @property {boolean} isEditorDisabled - Whether the rich-text editor is disabled. Example: false.
+ * @property {boolean} [isEditorDisabled] - Whether the rich-text editor is disabled. Older records only; current reads carry `editorMode` instead. Example: false.
  * @property {boolean} isImageCompressed - Whether embedded images are compressed. Example: true.
+ * @property {string} [editorMode] - Editor the value was written in. Example: "html".
  * @description Editor parameters attached to text-type form values.
  */
 interface ITextEditorParams {
-    isEditorDisabled: boolean;
+    isEditorDisabled?: boolean;
     isImageCompressed: boolean;
+    editorMode?: string;
 }
 /**
  * @interface ITextValue
  * @property {string} htmlValue - HTML representation of the text. Example: "<p>Hello world</p>".
- * @property {string} plainValue - Plain-text representation.
+ * @property {string} [plainValue] - Plain-text representation. Absent from current reads. Example: "Hello world".
  * @property {ITextEditorParams} params - Editor configuration applied to this value.
  * @description Value payload for `text` form fields.
  */
 interface ITextValue {
     htmlValue: string;
-    plainValue: string;
+    plainValue?: string;
     params: ITextEditorParams;
 }
 /**
@@ -677,36 +680,37 @@ interface ITextValue {
  * @interface IBodyTypeTextWithHeader
  * @property {string} marker - marker name. Example: "about".
  * @property {string} type - Type value. Example: "textWithHeader".
- * @property {object} value - Text Object. Contains html as string, header and params.
+ * @property {ITextWithHeaderValue | ITextWithHeaderValue[]} value - Text with a header. A read returns a one-element **array**, without `plainValue` and with `params.editorMode`; older records may hold a single object.
  * @example
-    {
-      "header": "Headline",
-      "htmlValue": "<p>Hello World</p>",
-      "plainValue": "",
-      "params": {
-        "isEditorDisabled": false,
-        "isImageCompressed": true
+    [
+      {
+        "header": "Headline",
+        "htmlValue": "<p>Hello World</p>",
+        "params": {
+          "isImageCompressed": true,
+          "editorMode": "html"
+        }
       }
-    }
+    ]
  * @description Represents a text value with a header, HTML and plain text representations, along with parameters for editor and image compression settings.
  */
 interface IBodyTypeTextWithHeader {
     marker: string;
     type: 'textWithHeader';
-    value: ITextWithHeaderValue;
+    value: ITextWithHeaderValue | ITextWithHeaderValue[];
 }
 /**
  * @interface ITextWithHeaderValue
  * @property {string} header - Headline text. Example: "Headline".
  * @property {string} htmlValue - HTML body. Example: "<p>Hello world</p>".
- * @property {string} plainValue - Plain-text body.
+ * @property {string} [plainValue] - Plain-text body. Absent from current reads. Example: "Hello world".
  * @property {ITextEditorParams} params - Editor configuration applied to this value.
  * @description Value payload for `textWithHeader` form fields.
  */
 interface ITextWithHeaderValue {
     header: string;
     htmlValue: string;
-    plainValue: string;
+    plainValue?: string;
     params: ITextEditorParams;
 }
 /**
@@ -765,7 +769,7 @@ interface IImageValue {
  * @interface IBodyTypeFile
  * @property {string} marker - marker name. Example: "picture".
  * @property {'file'} type - Type value. Example: "file".
- * @property {object} value - The attached file. Three shapes are accepted and may be mixed in one array: a `File`/`Blob` (also a `FileList`), which the SDK uploads first; the descriptor `FileUploading.upload` returns for a file **already in storage**, which is passed through as it is; or a hand-built {@link IFileValue}. In a SUBMISSION the value must be an **array** — a lone descriptor or {@link IFileValue} answers `400 formData's marker '<marker>' value must be an array`, while a lone `File`/`Blob` is fine because the SDK wraps the upload result. A READ returns a single attached file as the object itself.
+ * @property {object} value - The attached file. Three shapes are accepted and may be mixed in one array: a `File`/`Blob` (also a `FileList`), which the SDK uploads first; the descriptor `FileUploading.upload` returns for a file **already in storage**, which is passed through as it is; or a hand-built {@link IFileValue}. In a SUBMISSION the value must be an **array** — a lone descriptor or {@link IFileValue} answers `400 formData's marker '<marker>' value must be an array`, while a lone `File`/`Blob` is fine because the SDK wraps the upload result. A READ returns the files as an array too — a single attached file is a one-element array.
  * @example
     [
       {
@@ -800,24 +804,41 @@ interface IFileValue {
  * @interface IBodyTypeRadioButtonList
  * @property {string} marker - marker name. Example: "selector".
  * @property {string} type - Type value. Example: 'list'.
- * @property {Array} value - Array of list or radioButton bojects.
+ * @property {IListOptionValue[] | string[] | string} value - Chosen option(s). A read of a submission returns the option **values as stored**: `list` — an array of strings (`["1"]`), `radioButton` — one string (`"1"`). The `[{ title, value, extended }]` form is the shape of a page attribute.
  * @example
-    [
-      {
-        "title": "red",
-        "value": "1",
-        "extended": {
-          "value": "red",
-          "type": "string"
-        }
-      }
-    ]
- * @description Represents a list or radio button selection with multiple options, each containing a title, value, and extended information.
+    ["1"]
+ * @description Represents a list or radio button selection. Look the titles up in the form's attribute (`Forms.getFormByMarker`) by the stored value.
  */
 interface IBodyTypeRadioButtonList {
     marker: string;
     type: 'list' | 'radioButton';
-    value: IListOptionValue[];
+    value: IListOptionValue[] | string[] | string;
+}
+/**
+ * Represents an `entity` form data field — links to other entities.
+ * @interface IBodyTypeEntity
+ * @property {string} marker - marker name. Example: "related".
+ * @property {'entity'} type - Type value. Example: "entity".
+ * @property {number[]} value - Identifiers of the linked entities. Example: [2954, 2957].
+ * @description A form field that stores links to other entities (for example products) by id.
+ */
+interface IBodyTypeEntity {
+    marker: string;
+    type: 'entity';
+    value: number[];
+}
+/**
+ * Represents a `timeInterval` form data field.
+ * @interface IBodyTypeTimeInterval
+ * @property {string} marker - marker name. Example: "booking".
+ * @property {'timeInterval'} type - Type value. Example: "timeInterval".
+ * @property {string[][]} value - Intervals as `[start, end]` pairs of ISO dates. Example: [["2025-02-11T16:00:00.000Z", "2025-02-13T16:00:00.000Z"]].
+ * @description A form field that stores one or more time intervals.
+ */
+interface IBodyTypeTimeInterval {
+    marker: string;
+    type: 'timeInterval';
+    value: string[][];
 }
 /**
  * @interface IListOptionExtended
@@ -841,4 +862,4 @@ interface IListOptionValue {
     value: string;
     extended: IListOptionExtended;
 }
-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, };
+export type { FormDataPostType, FormDataStatus, FormDataType, IBodyPostFormData, IBodyPostTypeList, IBodyPostTypeSpam, IBodyPostTypeText, IBodyTypeEntity, IBodyTypeFile, IBodyTypeImageGroupOfImages, IBodyTypeRadioButtonList, IBodyTypeStringNumberFloat, IBodyTypeText, IBodyTypeTextWithHeader, IBodyTypeTimeDate, IBodyTypeTimeInterval, 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/integration-collections/integrationCollectionsApi.js

@@ -108,7 +108,7 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/validateICollectionMarker validateICollectionMarker} documentation.
      */
     async validateICollectionMarker(marker) {
-        const result = await this._fetchGet(`/marker-validation/${marker}`);
+        const result = await this._fetchGet(`/marker-validation/${this._pathSegment(marker)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('CollectionIsValidSchema'));
         return this._normalizeData(validated);
@@ -123,7 +123,7 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollectionRowsByMarker getICollectionRowsByMarker} documentation.
      */
     async getICollectionRowsByMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}/rows?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}/rows?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('CollectionRowsResponseSchema'));
         return this._normalizeData(validated, langCode);
@@ -139,7 +139,7 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollectionRowByMarkerAndId getICollectionRowByMarkerAndId} documentation.
      */
     async getICollectionRowByMarkerAndId(marker, id, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}/rows/${id}?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}/rows/${id}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('CollectionRowSchema'));
         return this._normalizeData(validated, langCode);
@@ -167,7 +167,7 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/createICollectionRow createICollectionRow} documentation.
      */
     async createICollectionRow(marker, body, langCode = this.state.lang) {
-        const response = await this._fetchPost(`/marker/${marker}/rows?langCode=${langCode}`, body);
+        const response = await this._fetchPost(`/marker/${this._pathSegment(marker)}/rows?langCode=${langCode}`, body);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(response, schema('CollectionRowSchema'));
         return this._normalizeData(validated, langCode);
@@ -198,7 +198,8 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/updateICollectionRow updateICollectionRow} documentation.
      */
     async updateICollectionRow(marker, id, body, langCode = this.state.lang) {
-        const response = await this._fetchPut(`/marker/${marker}/rows/${id}?` + `langCode=${langCode}`, body);
+        const response = await this._fetchPut(`/marker/${this._pathSegment(marker)}/rows/${id}?` +
+            `langCode=${langCode}`, body);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(response, schema('CollectionRowSchema'));
         return this._normalizeData(validated, langCode);
@@ -214,7 +215,7 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/deleteICollectionRowByMarkerAndId deleteICollectionRowByMarkerAndId} documentation.
      */
     async deleteICollectionRowByMarkerAndId(marker, id) {
-        const result = await this._fetchDelete(`/marker/${marker}/rows/${id}`);
+        const result = await this._fetchDelete(`/marker/${this._pathSegment(marker)}/rows/${id}`);
         return result;
     }
 }

package/esm/menus/menusApi.js

@@ -27,7 +27,7 @@ export default class MenusApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/menus/getMenusByMarker getMenusByMarker} documentation.
      */
     async getMenusByMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('MenuEntitySchema'));
         return this._normalizeData(validated, langCode);

package/esm/orders/ordersApi.js

@@ -48,7 +48,7 @@ export default class OrdersApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/getAllOrdersByMarker getAllOrdersByMarker} documentation.
      */
     async getAllOrdersByMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
-        const result = await this._fetchGet(`/marker/${marker}/orders?langCode=${langCode}&limit=${limit}&offset=${offset}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}/orders?langCode=${langCode}&limit=${limit}&offset=${offset}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('OrdersResponseSchema'));
         return this._normalizeData(validated);
@@ -65,7 +65,7 @@ export default class OrdersApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/getOrdersStorageByMarker getOrdersStorageByMarker} documentation.
      */
     async getOrdersStorageByMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${langCode}`);
         return this._normalizeData(result);
     }
     /**
@@ -81,7 +81,7 @@ export default class OrdersApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/getOrderByMarkerAndId getOrderByMarkerAndId} documentation.
      */
     async getOrderByMarkerAndId(marker, id, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}/orders/${id}?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}/orders/${id}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('OrderEntitySchema'));
         return this._normalizeData(validated);
@@ -149,7 +149,7 @@ export default class OrdersApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/createOrder createOrder} documentation.
      */
     async createOrder(marker, body, langCode = this.state.lang) {
-        const result = await this._fetchPost(`/marker/${marker}/orders`, this._wrapOrderFormData(body, langCode));
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/orders`, this._wrapOrderFormData(body, langCode));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('CreateOrderResponseSchema'));
         return this._normalizeData(validated);
@@ -185,7 +185,7 @@ export default class OrdersApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/updateOrderByMarkerAndId updateOrderByMarkerAndId} documentation.
      */
     async updateOrderByMarkerAndId(marker, id, body, langCode = this.state.lang) {
-        const result = await this._fetchPut(`/marker/${marker}/orders/${id}?langCode=${langCode}`, this._wrapOrderFormData(body, langCode));
+        const result = await this._fetchPut(`/marker/${this._pathSegment(marker)}/orders/${id}?langCode=${langCode}`, this._wrapOrderFormData(body, langCode));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('UpdateOrderResponseSchema'));
         return this._normalizeData(validated);
@@ -208,7 +208,8 @@ export default class OrdersApi extends AsyncModules {
             offset,
             limit,
         };
-        const data = await this._fetchGet(`/marker/${marker}/order-statuses?` + this._queryParamsToString(query));
+        const data = await this._fetchGet(`/marker/${this._pathSegment(marker)}/order-statuses?` +
+            this._queryParamsToString(query));
         return this._normalizeData(data);
     }
     /**

package/esm/pages/pagesApi.js

@@ -376,13 +376,13 @@ class StaffModule extends AsyncModules {
     // ({ total, items }) to match BlocksApi's similarProducts contract.
     async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         // Fetch similar products from the server
-        const result = await this._fetchGet(`/${marker}/similar-products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/similar-products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
         return this._normalizeData(result);
     }
     // Method to fetch products by block marker
     async getProductsByBlockMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         // Fetch products from the server
-        const result = await this._fetchGet(`/${marker}/products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
         // On API error responses there is no `items` array — return the (normalized)
         // error as-is instead of producing `undefined` from `result.items`.
         if (!Array.isArray(result === null || result === void 0 ? void 0 : result.items)) {

package/esm/product-statuses/productStatusesApi.js

@@ -42,7 +42,7 @@ export default class ProductStatusesApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/product-statuses/getProductsByStatusMarker getProductsByStatusMarker} documentation.
      */
     async getProductsByStatusMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('ProductStatusEntitySchema'));
         return this._normalizeData(validated, langCode);
@@ -57,7 +57,7 @@ export default class ProductStatusesApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/product-statuses/validateMarker validateMarker} documentation.
      */
     async validateMarker(marker) {
-        const result = await this._fetchGet(`/marker-validation/${marker}`);
+        const result = await this._fetchGet(`/marker-validation/${this._pathSegment(marker)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('ValidateMarkerResponseSchema'));
         // Extract the 'valid' boolean value from the response object

package/esm/templates/templatesApi.js

@@ -70,7 +70,7 @@ export default class TemplatesPreviewApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByMarker getTemplateByMarker} documentation.
      */
     async getTemplateByMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('TemplateEntitySchema'));
         return this._normalizeData(validated);

package/esm/templates-preview/templatesPreviewApi.js

@@ -42,7 +42,7 @@ export default class TemplatePreviewsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates-preview/getTemplatePreviewByMarker getTemplatePreviewByMarker} documentation.
      */
     async getTemplatePreviewByMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('TemplatePreviewEntitySchema'));
         return this._normalizeData(validated, langCode);

package/esm/user-groups/userGroupsApi.js

@@ -81,7 +81,7 @@ export default class UserGroupsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/user-groups/getUserGroupByMarker getUserGroupByMarker} documentation.
      */
     async getUserGroupByMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('UserGroupEntitySchema'));
         return this._normalizeData(validated, langCode);
@@ -98,7 +98,7 @@ export default class UserGroupsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/user-groups/getChildUserGroupsByMarker getChildUserGroupsByMarker} documentation.
      */
     async getChildUserGroupsByMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${marker}/children?langCode=${langCode}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}/children?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('UserGroupsResponseSchema'));
         return this._normalizeData(validated, langCode);

package/esm/users/usersApi.d.ts

@@ -73,7 +73,7 @@ export default class UsersApi extends AsyncModules implements IUsersApi {
         ]
      * @param {string} body.authData[].marker - Identifies the field being used. Example: "email_reg".
      * @param {string} body.authData[].value - Contains the value of the field. Example: "example@oneentry.cloud".
-     * @param {string} body.formData - Contains additional data for the user.
+     * @param {FormDataType | FormDataType[]} body.formData - Form fields of the user. Field values: {@link FormDataType} — a value shaped by the field type (a string, a date object, a text object, a list, a file descriptor), not only a string. A file goes in as the descriptor `FileUploading.upload` returns: these methods do not upload a `File`/`Blob` themselves.
      * @example
         [
           {
@@ -84,7 +84,7 @@ export default class UsersApi extends AsyncModules implements IUsersApi {
         ]
      * @param {string} body.formData[].marker - The marker of the field. Example: "last_name".
      * @param {string} body.formData[].type - The type of the field. Example: "string".
-     * @param {string} body.formData[].value - The value of the field. Example: "Username".
+     * @param {unknown} body.formData[].value - The value of the field, shaped by its type. Example: "Username".
      * @param {string} body.notificationData - The notification data.
      * @example
         {

package/esm/users/usersApi.js

@@ -78,7 +78,7 @@ export default class UsersApi extends AsyncModules {
         ]
      * @param {string} body.authData[].marker - Identifies the field being used. Example: "email_reg".
      * @param {string} body.authData[].value - Contains the value of the field. Example: "example@oneentry.cloud".
-     * @param {string} body.formData - Contains additional data for the user.
+     * @param {FormDataType | FormDataType[]} body.formData - Form fields of the user. Field values: {@link FormDataType} — a value shaped by the field type (a string, a date object, a text object, a list, a file descriptor), not only a string. A file goes in as the descriptor `FileUploading.upload` returns: these methods do not upload a `File`/`Blob` themselves.
      * @example
         [
           {
@@ -89,7 +89,7 @@ export default class UsersApi extends AsyncModules {
         ]
      * @param {string} body.formData[].marker - The marker of the field. Example: "last_name".
      * @param {string} body.formData[].type - The type of the field. Example: "string".
-     * @param {string} body.formData[].value - The value of the field. Example: "Username".
+     * @param {unknown} body.formData[].value - The value of the field, shaped by its type. Example: "Username".
      * @param {string} body.notificationData - The notification data.
      * @example
         {

package/esm/users/usersInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IAuthData, IAuthFormData, INotificationData } from '../auth-provider/authProvidersInterfaces.js';
+import type { IAuthData, INotificationData } from '../auth-provider/authProvidersInterfaces.js';
 import type { IError, IRating, IVectorSearchResponse } from '../base/utils.js';
 import type { IFormConfig } from '../forms/formsInterfaces.js';
 import type { FormDataType } from '../forms-data/formsDataInterfaces.js';
@@ -64,7 +64,7 @@ interface IUsersApi {
         ]
      * @param {string} body.authData[index].marker - Identifies the field being used. Example: "email_reg".
      * @param {string} body.authData[index].value - Contains the value of the field. Example: "example@oneentry.cloud".
-     * @param {string} body.formData - Contains additional data for the user.
+     * @param {FormDataType | FormDataType[]} body.formData - Form fields of the user. Field values: {@link FormDataType} — a value shaped by the field type (a string, a date object, a text object, a list, a file descriptor), not only a string. A file goes in as the descriptor `FileUploading.upload` returns: these methods do not upload a `File`/`Blob` themselves.
      * @example
         [
           {
@@ -75,7 +75,7 @@ interface IUsersApi {
         ]
      * @param {string} body.formData[index].marker - The marker of the field. Example: "last_name".
      * @param {string} body.formData[index].type - The type of the field. Example: "string".
-     * @param {string} body.formData[index].value - The value of the field. Example: "Username".
+     * @param {unknown} body.formData[index].value - The value of the field, shaped by its type. Example: "Username".
      * @param {string} body.notificationData - The notification data.
      * @example
         {
@@ -264,7 +264,7 @@ interface IUsersResponse {
       }
     ]
  * @property {string} formIdentifier - Marker of the form. Example: "form_12345".
- * @property {string} total - Returned by the API as a numeric string, such as `"1"`. The API reference does not describe this field. Example: "0".
+ * @property {string} [total] - Deprecated, do not rely on it. A service counter that leaks into the response of a single user: always `"1"`, it carries no data about the user. The API reference does not describe it, and the field may disappear from the response. Example: "1".
  * @property {Array<string | number>} groups - User groups.
  * @example
     [
@@ -287,7 +287,8 @@ interface IUserEntity {
     authProviderIdentifier: string;
     formData: FormDataType[];
     formIdentifier: string;
-    total: string;
+    /** @deprecated Service counter leaking into the response, always `"1"`; the field may disappear. */
+    total?: string;
     groups: Array<string | number>;
     state: Record<string, unknown>;
     moduleFormConfigs?: Array<IFormConfig>;
@@ -306,7 +307,7 @@ interface IUserEntity {
         "value": "12345"
       }
     ]
- * @property {IAuthFormData | IAuthFormData[]} [formData] - One form field object or an array of them.
+ * @property {FormDataType | FormDataType[]} [formData] - One form field object or an array of them. Field values: {@link FormDataType} — a value shaped by the field type (a string, a date object, a text object, a list, a file descriptor), not only a string. A file goes in as the descriptor `FileUploading.upload` returns: these methods do not upload a `File`/`Blob` themselves.
  * @example
     [
       {
@@ -338,7 +339,7 @@ interface IUserBody {
     formIdentifier: string;
     langCode?: string;
     authData?: IAuthData[];
-    formData?: IAuthFormData | IAuthFormData[];
+    formData?: FormDataType | FormDataType[];
     notificationData?: INotificationData;
     state?: Record<string, unknown>;
 }

package/esm/users/usersSchemas.d.ts

@@ -13,7 +13,7 @@ export declare const UserResponseSchema: z.ZodObject<{
     authProviderIdentifier: z.ZodString;
     formData: z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>;
     formIdentifier: z.ZodString;
-    total: z.ZodString;
+    total: z.ZodOptional<z.ZodString>;
     groups: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     state: z.ZodRecord<z.ZodString, z.ZodAny>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oneentry",
-  "version": "1.0.174",
+  "version": "1.0.176",
   "description": "OneEntry NPM package",
   "main": "dist/index.js",
   "module": "esm/index.js",
@@ -48,7 +48,7 @@
   },
   "scripts": {
     "prepublishOnly": "node ../scripts/smoke-pack.js --files-only",
-    "postpublish": "node ../scripts/verify-published.js --named defineOneEntry --expect 1.0.174"
+    "postpublish": "node ../scripts/verify-published.js --named defineOneEntry --expect 1.0.176"
   },
   "sideEffects": false,
   "files": [