oneentry 1.0.175 → 1.0.176

package/dist/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/dist/integration-collections/integrationCollectionsApi.js

@@ -146,7 +146,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @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);
@@ -161,7 +161,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @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);
@@ -177,7 +177,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @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);
@@ -205,7 +205,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @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);
@@ -236,7 +236,8 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @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);
@@ -252,7 +253,7 @@ class IntegrationCollectionsApi extends asyncModules_1.default {
      * @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/dist/menus/menusApi.js

@@ -65,7 +65,7 @@ class MenusApi extends asyncModules_1.default {
      * @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/dist/orders/ordersApi.js

@@ -86,7 +86,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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);
@@ -103,7 +103,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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);
     }
     /**
@@ -119,7 +119,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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);
@@ -187,7 +187,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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);
@@ -223,7 +223,7 @@ class OrdersApi extends asyncModules_1.default {
      * @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);
@@ -246,7 +246,8 @@ class OrdersApi extends asyncModules_1.default {
             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/dist/pages/pagesApi.js

@@ -415,13 +415,13 @@ class StaffModule extends asyncModules_1.default {
     // ({ 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/dist/product-statuses/productStatusesApi.js

@@ -80,7 +80,7 @@ class ProductStatusesApi extends asyncModules_1.default {
      * @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);
@@ -95,7 +95,7 @@ class ProductStatusesApi extends asyncModules_1.default {
      * @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/dist/templates/templatesApi.js

@@ -108,7 +108,7 @@ class TemplatesPreviewApi extends asyncModules_1.default {
      * @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/dist/templates-preview/templatesPreviewApi.js

@@ -80,7 +80,7 @@ class TemplatePreviewsApi extends asyncModules_1.default {
      * @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/dist/user-groups/userGroupsApi.js

@@ -119,7 +119,7 @@ class UserGroupsApi extends asyncModules_1.default {
      * @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);
@@ -136,7 +136,7 @@ class UserGroupsApi extends asyncModules_1.default {
      * @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/attribute-sets/attributeSetsApi.js

@@ -58,7 +58,7 @@ export default class AttributesSetsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributesByMarker getAttributesByMarker} documentation.
      */
     async getAttributesByMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/${marker}/attributes?langCode=${langCode}`);
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/attributes?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('AttributesArrayResponseSchema'));
         return this._normalizeData(validated, langCode);
@@ -74,7 +74,7 @@ export default class AttributesSetsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getSingleAttributeByMarkerSet getSingleAttributeByMarkerSet} documentation.
      */
     async getSingleAttributeByMarkerSet(setMarker, attributeMarker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/${setMarker}/attributes/${attributeMarker}?langCode=${langCode}`);
+        const result = await this._fetchGet(`/${this._pathSegment(setMarker)}/attributes/${this._pathSegment(attributeMarker)}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('AttributeEntitySchema'));
         return this._normalizeData(validated, langCode);
@@ -89,7 +89,7 @@ export default class AttributesSetsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributeSetByMarker getAttributeSetByMarker} documentation.
      */
     async getAttributeSetByMarker(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('AttributeSetEntitySchema'));
         return this._normalizeData(validated, langCode);

package/esm/auth-provider/authProviderApi.js

@@ -88,7 +88,7 @@ export default class AuthProviderApi extends AsyncModules {
     async signUp(marker, body, langCode = this.state.lang) {
         // `langCode` goes onto our own copy — the caller's body stays as it was
         // given, so a retry or a second parallel call sends the same thing (CMS-909).
-        const result = await this._fetchPost(`/marker/${marker}/users/sign-up`, this._normalizePostBody({ ...body, langCode }, langCode));
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/users/sign-up`, this._normalizePostBody({ ...body, langCode }, langCode));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('SignUpResponseSchema'));
         return this._normalizeData(validated);
@@ -109,7 +109,7 @@ export default class AuthProviderApi extends AsyncModules {
             userIdentifier,
             eventIdentifier,
         };
-        const result = await this._fetchPost(`/marker/${marker}/users/generate-code`, data);
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/users/generate-code`, data);
         return result;
     }
     /**
@@ -130,7 +130,7 @@ export default class AuthProviderApi extends AsyncModules {
             eventIdentifier,
             code,
         };
-        const result = await this._fetchPost(`/marker/${marker}/users/check-code`, data);
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/users/check-code`, data);
         return result;
     }
     /**
@@ -149,7 +149,7 @@ export default class AuthProviderApi extends AsyncModules {
             userIdentifier: userIdentifier,
             code: code,
         };
-        const result = await this._fetchPost(`/marker/${marker}/users/activate`, data);
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/users/activate`, data);
         return result;
     }
     /**
@@ -186,7 +186,7 @@ export default class AuthProviderApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/auth auth} documentation.
      */
     async auth(marker, body) {
-        const result = await this._fetchPost(`/marker/${marker}/users/auth`, body);
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/users/auth`, body);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('AuthResponseSchema'));
         if (!('statusCode' in validated)) {
@@ -210,7 +210,7 @@ export default class AuthProviderApi extends AsyncModules {
      */
     async refresh(marker, token) {
         const data = { refreshToken: token };
-        const result = await this._fetchPost(`/marker/${marker}/users/refresh`, data);
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/users/refresh`, data);
         if (!('statusCode' in result)) {
             this.state.accessToken = result.accessToken;
             this.state.refreshToken = result.refreshToken;
@@ -235,7 +235,7 @@ export default class AuthProviderApi extends AsyncModules {
         const data = {
             refreshToken: token,
         };
-        const result = await this._fetchPost(`/marker/${marker}/users/logout`, data);
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/users/logout`, data);
         if (result) {
             this.state.accessToken = undefined;
             this.state.refreshToken = undefined;
@@ -256,7 +256,7 @@ export default class AuthProviderApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/logoutAll logoutAll} documentation.
      */
     async logoutAll(marker) {
-        const result = await this._fetchPost(`/marker/${marker}/users/logout-all`);
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/users/logout-all`);
         if (result) {
             this.state.accessToken = undefined;
             this.state.refreshToken = undefined;
@@ -290,7 +290,7 @@ export default class AuthProviderApi extends AsyncModules {
             password1: newPassword,
             password2: repeatPassword !== null && repeatPassword !== void 0 ? repeatPassword : newPassword,
         };
-        const result = await this._fetchPost(`/marker/${marker}/users/change-password`, data);
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/users/change-password`, data);
         return result;
     }
     /**
@@ -321,7 +321,7 @@ export default class AuthProviderApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getAuthProviderByMarker getAuthProviderByMarker} documentation.
      */
     async getAuthProviderByMarker(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);
     }
     /**
@@ -334,7 +334,7 @@ export default class AuthProviderApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getActiveSessionsByMarker getActiveSessionsByMarker} documentation.
      */
     async getActiveSessionsByMarker(marker) {
-        const result = await this._fetchGet(`/marker/${marker}/users/sessions`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}/users/sessions`);
         return this._normalizeData(result);
     }
     /**
@@ -357,7 +357,7 @@ export default class AuthProviderApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/oauth oauth} documentation.
      */
     async oauth(marker, body, langCode = this.state.lang) {
-        const result = await this._fetchPost(`/marker/${marker}/oauth`, this._normalizePostBody(body, langCode));
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}/oauth`, this._normalizePostBody(body, langCode));
         return result;
     }
 }

package/esm/base/asyncModules.d.ts

@@ -36,6 +36,17 @@ export default abstract class AsyncModules extends SyncModules {
      * validation disabled (the default) never pulls Zod into its bundle.
      */
     protected _validateResponse<T>(data: unknown, loadSchema?: () => Promise<z.ZodSchema<T>>): Promise<T | IError>;
+    /**
+     * Prepares a caller value (a marker) to be one segment of a request path.
+     * @param {string} value - The value to put into the path.
+     * @returns {string} The value encoded as a single path segment.
+     * @description `encodeURIComponent` keeps `?`, `#` and `/` from cutting the query or
+     * adding segments, but leaves `.` alone, and `URL` resolves a `.` or `..` segment
+     * (`%2E` included) — `form-data/marker/..` turned a read into `POST /form-data/`,
+     * the create endpoint. A dot-only value is sent with its `%` escaped instead, so the
+     * API gets a marker it rejects as invalid rather than another route.
+     */
+    protected _pathSegment(value: string): string;
     /**
      * Performs an HTTP GET request.
      * @param {string} path - The path to append to the base URL.

package/esm/base/asyncModules.js

@@ -79,6 +79,20 @@ export default class AsyncModules extends SyncModules {
             return validateResponseSafe(schema, data, this.state.validationLogErrors);
         }
     }
+    /**
+     * Prepares a caller value (a marker) to be one segment of a request path.
+     * @param {string} value - The value to put into the path.
+     * @returns {string} The value encoded as a single path segment.
+     * @description `encodeURIComponent` keeps `?`, `#` and `/` from cutting the query or
+     * adding segments, but leaves `.` alone, and `URL` resolves a `.` or `..` segment
+     * (`%2E` included) — `form-data/marker/..` turned a read into `POST /form-data/`,
+     * the create endpoint. A dot-only value is sent with its `%` escaped instead, so the
+     * API gets a marker it rejects as invalid rather than another route.
+     */
+    _pathSegment(value) {
+        const encoded = encodeURIComponent(value);
+        return /^\.{1,2}$/.test(value) ? encoded.replace(/\./g, '%252E') : encoded;
+    }
     /**
      * Performs an HTTP GET request.
      * @param {string} path - The path to append to the base URL.