oneentry 1.0.175 → 1.0.176

package/esm/blocks/blocksApi.js

@@ -62,7 +62,7 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getBlockByMarker getBlockByMarker} documentation.
      */
     async getBlockByMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
-        const response = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
+        const response = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${langCode}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(response, schema('BlockEntitySchema'));
         const normalizeResponse = this._normalizeData(validated);
@@ -146,7 +146,8 @@ export default class BlocksApi extends AsyncModules {
             signPrice,
             productId,
         };
-        const result = await this._fetchGet(`/${marker}/similar-products?` + this._queryParamsToString(query));
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/similar-products?` +
+            this._queryParamsToString(query));
         return this._normalizeData(result);
     }
     /**
@@ -169,7 +170,8 @@ export default class BlocksApi extends AsyncModules {
             limit,
             signPrice,
         };
-        const result = await this._fetchGet(`/${marker}/products?` + this._queryParamsToString(query));
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/products?` +
+            this._queryParamsToString(query));
         // 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)) {
@@ -196,7 +198,7 @@ export default class BlocksApi extends AsyncModules {
             signPrice,
             limit,
         };
-        const data = await this._fetchGet(`/${marker}/products/${productId}/frequently-ordered?` +
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/products/${productId}/frequently-ordered?` +
             this._queryParamsToString(query));
         return this._normalizeData(data);
     }
@@ -229,7 +231,8 @@ export default class BlocksApi extends AsyncModules {
      */
     async getCartComplement(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/cart-complement?` + this._queryParamsToString(query));
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/cart-complement?` +
+            this._queryParamsToString(query));
         return this._normalizeData(data);
     }
     /**
@@ -247,7 +250,7 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplementByProductIds getCartComplementByProductIds} documentation.
      */
     async getCartComplementByProductIds(marker, body) {
-        const data = await this._fetchPost(`/${marker}/cart-complement`, { langCode: this.state.lang, ...body });
+        const data = await this._fetchPost(`/${this._pathSegment(marker)}/cart-complement`, { langCode: this.state.lang, ...body });
         return this._normalizeData(data);
     }
     /**
@@ -264,7 +267,8 @@ export default class BlocksApi extends AsyncModules {
      */
     async getCartSimilar(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/cart-similar?` + this._queryParamsToString(query));
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/cart-similar?` +
+            this._queryParamsToString(query));
         return this._normalizeData(data);
     }
     /**
@@ -282,7 +286,7 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilarByProductIds getCartSimilarByProductIds} documentation.
      */
     async getCartSimilarByProductIds(marker, body) {
-        const data = await this._fetchPost(`/${marker}/cart-similar`, { langCode: this.state.lang, ...body });
+        const data = await this._fetchPost(`/${this._pathSegment(marker)}/cart-similar`, { langCode: this.state.lang, ...body });
         return this._normalizeData(data);
     }
     /**
@@ -299,7 +303,8 @@ export default class BlocksApi extends AsyncModules {
      */
     async getPersonalRecommendations(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/personal-recommendations?` + this._queryParamsToString(query));
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/personal-recommendations?` +
+            this._queryParamsToString(query));
         return this._normalizeData(data);
     }
     /**
@@ -316,7 +321,8 @@ export default class BlocksApi extends AsyncModules {
      */
     async getRecentlyViewed(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/recently-viewed?` + this._queryParamsToString(query));
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/recently-viewed?` +
+            this._queryParamsToString(query));
         return this._normalizeData(data);
     }
     /**
@@ -333,7 +339,8 @@ export default class BlocksApi extends AsyncModules {
      */
     async getRepeatPurchase(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/repeat-purchase?` + this._queryParamsToString(query));
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/repeat-purchase?` +
+            this._queryParamsToString(query));
         return this._normalizeData(data);
     }
     /**
@@ -345,7 +352,7 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getSlides getSlides} documentation.
      */
     async getSlides(marker) {
-        const data = await this._fetchGet(`/${marker}/slides`);
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/slides`);
         return this._normalizeData(data);
     }
     /**
@@ -362,7 +369,8 @@ export default class BlocksApi extends AsyncModules {
      */
     async getTrending(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/trending?` + this._queryParamsToString(query));
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/trending?` +
+            this._queryParamsToString(query));
         return this._normalizeData(data);
     }
     /**
@@ -379,7 +387,8 @@ export default class BlocksApi extends AsyncModules {
      */
     async getWishlistSimilar(marker, langCode = this.state.lang, signPrice, limit) {
         const query = { langCode, signPrice, limit };
-        const data = await this._fetchGet(`/${marker}/wishlist-similar?` + this._queryParamsToString(query));
+        const data = await this._fetchGet(`/${this._pathSegment(marker)}/wishlist-similar?` +
+            this._queryParamsToString(query));
         return this._normalizeData(data);
     }
     /**
@@ -397,7 +406,7 @@ export default class BlocksApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilarByProductIds getWishlistSimilarByProductIds} documentation.
      */
     async getWishlistSimilarByProductIds(marker, body) {
-        const data = await this._fetchPost(`/${marker}/wishlist-similar`, { langCode: this.state.lang, ...body });
+        const data = await this._fetchPost(`/${this._pathSegment(marker)}/wishlist-similar`, { langCode: this.state.lang, ...body });
         return this._normalizeData(data);
     }
 }

package/esm/discounts/discountsApi.js

@@ -57,7 +57,8 @@ export default class DiscountsApi extends AsyncModules {
             marker: '',
             langCode,
         };
-        const data = await this._fetchGet(`/marker/${marker}?` + this._queryParamsToString(query));
+        const data = await this._fetchGet(`/marker/${this._pathSegment(marker)}?` +
+            this._queryParamsToString(query));
         return this._normalizeData(data);
     }
     /**

package/esm/events/eventsApi.js

@@ -57,7 +57,7 @@ export default class EventsApi extends AsyncModules {
             locale: langCode,
             productId,
         };
-        return this._fetchBoolean(() => this._fetchPost(`/subscribe/marker/${marker}`, body));
+        return this._fetchBoolean(() => this._fetchPost(`/subscribe/marker/${this._pathSegment(marker)}`, body));
     }
     /**
      * Unsubscribing to an event on a product.
@@ -76,7 +76,7 @@ export default class EventsApi extends AsyncModules {
             productId: productId,
             locale: langCode,
         };
-        return this._fetchBoolean(() => this._fetchDelete(`/unsubscribe/marker/${marker}`, body));
+        return this._fetchBoolean(() => this._fetchDelete(`/unsubscribe/marker/${this._pathSegment(marker)}`, body));
     }
     /**
      * Returns all available events.
@@ -102,7 +102,7 @@ export default class EventsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/events/subscribeToForm subscribeToForm} documentation.
      */
     async subscribeToForm(marker, body) {
-        return this._fetchBoolean(() => this._fetchPost(`/forms/subscribe/marker/${marker}`, body));
+        return this._fetchBoolean(() => this._fetchPost(`/forms/subscribe/marker/${this._pathSegment(marker)}`, body));
     }
     /**
      * Returns all form subscriptions.
@@ -135,6 +135,6 @@ export default class EventsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/events/unsubscribeFromForm unsubscribeFromForm} documentation.
      */
     async unsubscribeFromForm(marker, body) {
-        return this._fetchBoolean(() => this._fetchDelete(`/forms/unsubscribe/marker/${marker}`, body));
+        return this._fetchBoolean(() => this._fetchDelete(`/forms/unsubscribe/marker/${this._pathSegment(marker)}`, body));
     }
 }

package/esm/filters/filtersApi.js

@@ -29,7 +29,7 @@ export default class FiltersApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/filters/getFilterByMarker getFilterByMarker} documentation.
      */
     async getFilterByMarker(marker, langCode = this.state.lang) {
-        const data = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
+        const data = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${langCode}`);
         const validated = await this._validateResponse(data, schema('ContentFilterSchema'));
         return this._normalizeData(validated);
     }

package/esm/forms/formsApi.js

@@ -46,7 +46,7 @@ export default class FormsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms/getFormByMarker getFormByMarker} documentation.
      */
     async getFormByMarker(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('FormEntitySchema'));
         return this._normalizeData(validated, langCode);

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

@@ -118,17 +118,19 @@ export default class FormsDataApi extends AsyncModules implements IFormsData {
      * @param {number} [body.parentId] - Identifier of the parent record, to fetch replies to one submission. Example: 10.
      * @param {string} [body.userIdentifier] - Text identifier of the sender. Example: "admin".
      * @param {FormDataStatus[]} [body.status] - Moderation statuses to keep: "sent", "moderation", "approved", "banned", "deleted". Must be an array; anything outside the set is rejected with `400 each value in status must be a valid enum value`. Example: ["approved"].
-     * @param {string} [body.dateFrom] - Lower bound of the submission date, `YYYY-MM-DD`. An empty string means "no bound" — the SDK removes it from the body, because the endpoint answers `400 dateFrom must be a valid date in format "YYYY-MM-DD"` to one. An unparsable non-empty value still fails the request. Example: "2025-01-01".
-     * @param {string} [body.dateTo] - Upper bound of the submission date, `YYYY-MM-DD`. An empty string means "no bound", handled like `dateFrom`. Example: "2025-12-31".
+     * @param {string} [body.dateFrom] - Lower bound of the submission date, `YYYY-MM-DD` or `YYYY-MM-DD HH:MM:SS`. An empty string means "no bound" — the SDK removes it from the body, because the endpoint answers `400 dateFrom must be a valid date in format "YYYY-MM-DD"` to one. An unparsable non-empty value still fails the request. Example: "2025-01-01".
+     * @param {string} [body.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".
      * @param {number} [isExtended] - Pass `1` to return additional fields for each record. Default: `0`. Example: 1.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Number of records to skip. Default: 0.
-     * @param {number} [limit] - Maximum number of records to return. Default: 30.
+     * @param {number} [offset] - Number of records to skip, `0` or more (a negative one answers `400 offset must not be less than 0`). Default: 0.
+     * @param {number} [limit] - Maximum number of records to return, `1` or more (`0` answers `400 limit must not be less than 1`). Default: 30.
      * @returns {Promise<IFormsByMarkerDataEntity | IError>} Returns an object containing the form data or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Each record's `formData` comes back **already unwrapped from its locale**. The API sends `formData: { "en_US": [ … ] }`; the SDK normalizes the response and hands over the array for `langCode`, so read `record.formData` — `record.formData[langCode]` is `undefined` and yields an empty list with no error. This holds for both values of `isExtended`.
      *
-     * The filter body is typed for a reason: the API silently ignores a field it does not know, so a misspelled `statuses` returns every record — unmoderated ones included — and the code looks like it works.
+     * The filter body is typed because the API refuses a field it does not know: a misspelled `statuses` answers `400 property statuses should not exist`.
+     *
+     * A marker or `formModuleConfigId` that matches nothing answers `200` with `{ items: [], total: 0 }`, not `404` — an empty list does not prove the form exists.
      *
      * Empty `dateFrom` / `dateTo` are stripped from the body before it is sent: the endpoint validates the pair as dates and rejects an empty string with a `400`, while every other field still treats "" as "no filter".
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByMarker getFormsDataByMarker} documentation.
@@ -164,11 +166,11 @@ export default class FormsDataApi extends AsyncModules implements IFormsData {
      * @handleName getFormsDataByVectorSearch
      * @param {IFormsDataVectorSearch} body - Vector search parameters. Example: `{ queryText: "order confirmation" }`.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Number of records to skip. Default: 0.
-     * @param {number} [limit] - Maximum number of records to return. Default: 30.
+     * @param {number} [offset] - Number of records to skip, `0` or more. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return, `1` or more. Default: 30.
      * @returns {Promise<IVectorSearchResponse<IFormsDataSearchResponse> | IError>} Returns an object with an array of found form data records and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method performs a semantic (vector) search for form data.
+     * @description This method performs a semantic (vector) search for form data. The body is checked by the API: an empty `queryText` or one longer than 512 characters, a negative `vectorDistanceThreshold` and a `maxHits` below `1` each answer `400`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByVectorSearch getFormsDataByVectorSearch} documentation.
      */
     getFormsDataByVectorSearch(body: IFormsDataVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IFormsDataSearchResponse> | IError>;

package/esm/forms-data/formsDataApi.js

@@ -133,7 +133,9 @@ export default class FormsDataApi extends AsyncModules {
         const result = await this._fetchPost(``, { ...body, formData });
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('PostFormResponseSchema'));
-        return this._normalizeData(validated);
+        // The fields went in under `langCode`, so the response is unwrapped from the same
+        // locale; without it a call in another language returned `formData` still keyed by it
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Tells a file the SDK still has to upload from one already in storage.
@@ -214,23 +216,25 @@ export default class FormsDataApi extends AsyncModules {
      * @param {number} [body.parentId] - Identifier of the parent record, to fetch replies to one submission. Example: 10.
      * @param {string} [body.userIdentifier] - Text identifier of the sender. Example: "admin".
      * @param {FormDataStatus[]} [body.status] - Moderation statuses to keep: "sent", "moderation", "approved", "banned", "deleted". Must be an array; anything outside the set is rejected with `400 each value in status must be a valid enum value`. Example: ["approved"].
-     * @param {string} [body.dateFrom] - Lower bound of the submission date, `YYYY-MM-DD`. An empty string means "no bound" — the SDK removes it from the body, because the endpoint answers `400 dateFrom must be a valid date in format "YYYY-MM-DD"` to one. An unparsable non-empty value still fails the request. Example: "2025-01-01".
-     * @param {string} [body.dateTo] - Upper bound of the submission date, `YYYY-MM-DD`. An empty string means "no bound", handled like `dateFrom`. Example: "2025-12-31".
+     * @param {string} [body.dateFrom] - Lower bound of the submission date, `YYYY-MM-DD` or `YYYY-MM-DD HH:MM:SS`. An empty string means "no bound" — the SDK removes it from the body, because the endpoint answers `400 dateFrom must be a valid date in format "YYYY-MM-DD"` to one. An unparsable non-empty value still fails the request. Example: "2025-01-01".
+     * @param {string} [body.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".
      * @param {number} [isExtended] - Pass `1` to return additional fields for each record. Default: `0`. Example: 1.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Number of records to skip. Default: 0.
-     * @param {number} [limit] - Maximum number of records to return. Default: 30.
+     * @param {number} [offset] - Number of records to skip, `0` or more (a negative one answers `400 offset must not be less than 0`). Default: 0.
+     * @param {number} [limit] - Maximum number of records to return, `1` or more (`0` answers `400 limit must not be less than 1`). Default: 30.
      * @returns {Promise<IFormsByMarkerDataEntity | IError>} Returns an object containing the form data or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Each record's `formData` comes back **already unwrapped from its locale**. The API sends `formData: { "en_US": [ … ] }`; the SDK normalizes the response and hands over the array for `langCode`, so read `record.formData` — `record.formData[langCode]` is `undefined` and yields an empty list with no error. This holds for both values of `isExtended`.
      *
-     * The filter body is typed for a reason: the API silently ignores a field it does not know, so a misspelled `statuses` returns every record — unmoderated ones included — and the code looks like it works.
+     * The filter body is typed because the API refuses a field it does not know: a misspelled `statuses` answers `400 property statuses should not exist`.
+     *
+     * A marker or `formModuleConfigId` that matches nothing answers `200` with `{ items: [], total: 0 }`, not `404` — an empty list does not prove the form exists.
      *
      * Empty `dateFrom` / `dateTo` are stripped from the body before it is sent: the endpoint validates the pair as dates and rejects an empty string with a `400`, while every other field still treats "" as "no filter".
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByMarker getFormsDataByMarker} documentation.
      */
     async getFormsDataByMarker(marker, formModuleConfigId, body = {}, isExtended = 0, langCode = this.state.lang, offset = 0, limit = 30) {
-        const result = await this._fetchPost(`/marker/${marker}?formModuleConfigId=${formModuleConfigId}&isExtended=${isExtended}&langCode=${langCode}&offset=${offset}&limit=${limit}`, this._stripEmptyDates(body));
+        const result = await this._fetchPost(`/marker/${this._pathSegment(marker)}?formModuleConfigId=${formModuleConfigId}&isExtended=${isExtended}&langCode=${langCode}&offset=${offset}&limit=${limit}`, this._stripEmptyDates(body));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('FormsByMarkerDataResponseSchema'));
         return this._normalizeData(validated, langCode);
@@ -276,11 +280,11 @@ export default class FormsDataApi extends AsyncModules {
      * @handleName getFormsDataByVectorSearch
      * @param {IFormsDataVectorSearch} body - Vector search parameters. Example: `{ queryText: "order confirmation" }`.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {number} [offset] - Number of records to skip. Default: 0.
-     * @param {number} [limit] - Maximum number of records to return. Default: 30.
+     * @param {number} [offset] - Number of records to skip, `0` or more. Default: 0.
+     * @param {number} [limit] - Maximum number of records to return, `1` or more. Default: 30.
      * @returns {Promise<IVectorSearchResponse<IFormsDataSearchResponse> | IError>} Returns an object with an array of found form data records and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method performs a semantic (vector) search for form data.
+     * @description This method performs a semantic (vector) search for form data. The body is checked by the API: an empty `queryText` or one longer than 512 characters, a negative `vectorDistanceThreshold` and a `maxHits` below `1` each answer `400`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByVectorSearch getFormsDataByVectorSearch} documentation.
      */
     async getFormsDataByVectorSearch(body, langCode = this.state.lang, offset = 0, limit = 30) {

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);