oneentry 1.0.175 → 1.0.176

package/changelog.md

@@ -1,5 +1,29 @@
 # SDK Change Log
 
+## v.1.0.176
+
+### What's Changed
+
+- **`FormDataType` describes `formData` as a read returns it** (CMS-1143). Checked on `getFormsDataByMarker` against every field type of a form:
+  - new branches `IBodyTypeEntity` (`entity`, `value: number[]`) and `IBodyTypeTimeInterval` (`timeInterval`, `value: string[][]` — `[start, end]` pairs); `IBodyTypeStringNumberFloat.type` takes `'integer'`;
+  - `list` and `radioButton` come back as the stored option values — `["1"]` and `"1"` — so `IBodyTypeRadioButtonList.value` is `IListOptionValue[] | string[] | string`;
+  - `text` and `textWithHeader` come back as a one-element array without `plainValue` and with `params.editorMode`: `value` takes an array too, `plainValue` and `isEditorDisabled` are optional, `editorMode` is added;
+  - the JSDoc no longer promises numbers and single-file objects on a read: numeric fields come back as strings (`3` → `"3"`), a single file as a one-element array.
+  Code that wrote these fields still compiles; code that read `value.plainValue` or `value[0].title` of a read now sees in the types what the API sends.
+
+### What's Fixed
+
+- **A marker is encoded before it goes into the request path** (CMS-1144). It was put into the URL as is in 59 places: `getFormsDataByMarker('..', 2)` resolved to `POST /api/content/form-data/` — the create endpoint — and `'test-form#'` cut the whole query off. Markers go through a new `AsyncModules._pathSegment` now: `?`, `#` and `/` are encoded, and a dot-only value reaches the API as an invalid marker (`400 marker must match …`) instead of another route. Valid markers are sent exactly as before. Page and product URLs (`getPageByUrl` and similar) are not changed.
+
+- **`FormData.postFormsData` unwraps the answer from the language it was sent in** (CMS-1125). A call with a `langCode` other than the client's returned `formData.formData` still keyed by the locale (`{ "ru_RU": [ … ] }`); the response is normalized with that `langCode` now, like the other methods of the module.
+
+- **JSDoc of the FormData module** (CMS-1145): `offset` from `0` and `limit` from `1`; `queryText` 1–512 characters, `vectorDistanceThreshold` from `0` and `maxHits` from `1` in vector search; `dateFrom` / `dateTo` take `YYYY-MM-DD HH:MM:SS` as well. The filter description said the API silently ignores an unknown field — it answers `400 property statuses should not exist`; a marker that matches nothing answers `200` with an empty list, not `404`.
+
+### Tests
+
+- **`callercontracts.spec.ts`**: `..` and `#` in a marker stay inside the path, a valid marker is sent unchanged; `postFormsData` in another language returns `formData` as an array; the field shapes of a `full_form` record compile as `FormDataType`.
+- **`formsdata.spec.ts`**: vector search no longer expects `ip` and `fingerprint` — the API does not send them.
+
 ## v.1.0.175
 
 ### What's Changed

package/dist/attribute-sets/attributeSetsApi.js

@@ -96,7 +96,7 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @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);
@@ -112,7 +112,7 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @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);
@@ -127,7 +127,7 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @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/dist/auth-provider/authProviderApi.js

@@ -126,7 +126,7 @@ class AuthProviderApi extends asyncModules_1.default {
     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);
@@ -147,7 +147,7 @@ class AuthProviderApi extends asyncModules_1.default {
             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;
     }
     /**
@@ -168,7 +168,7 @@ class AuthProviderApi extends asyncModules_1.default {
             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;
     }
     /**
@@ -187,7 +187,7 @@ class AuthProviderApi extends asyncModules_1.default {
             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;
     }
     /**
@@ -224,7 +224,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @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)) {
@@ -248,7 +248,7 @@ class AuthProviderApi extends asyncModules_1.default {
      */
     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;
@@ -273,7 +273,7 @@ class AuthProviderApi extends asyncModules_1.default {
         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;
@@ -294,7 +294,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @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;
@@ -328,7 +328,7 @@ class AuthProviderApi extends asyncModules_1.default {
             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;
     }
     /**
@@ -359,7 +359,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @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);
     }
     /**
@@ -372,7 +372,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @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);
     }
     /**
@@ -395,7 +395,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @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/dist/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/dist/base/asyncModules.js

@@ -117,6 +117,20 @@ class AsyncModules extends syncModules_1.default {
             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.

package/dist/blocks/blocksApi.js

@@ -100,7 +100,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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);
@@ -184,7 +184,8 @@ class BlocksApi extends asyncModules_1.default {
             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);
     }
     /**
@@ -207,7 +208,8 @@ class BlocksApi extends asyncModules_1.default {
             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)) {
@@ -234,7 +236,7 @@ class BlocksApi extends asyncModules_1.default {
             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);
     }
@@ -267,7 +269,8 @@ class BlocksApi extends asyncModules_1.default {
      */
     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);
     }
     /**
@@ -285,7 +288,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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);
     }
     /**
@@ -302,7 +305,8 @@ class BlocksApi extends asyncModules_1.default {
      */
     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);
     }
     /**
@@ -320,7 +324,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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);
     }
     /**
@@ -337,7 +341,8 @@ class BlocksApi extends asyncModules_1.default {
      */
     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);
     }
     /**
@@ -354,7 +359,8 @@ class BlocksApi extends asyncModules_1.default {
      */
     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);
     }
     /**
@@ -371,7 +377,8 @@ class BlocksApi extends asyncModules_1.default {
      */
     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);
     }
     /**
@@ -383,7 +390,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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);
     }
     /**
@@ -400,7 +407,8 @@ class BlocksApi extends asyncModules_1.default {
      */
     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);
     }
     /**
@@ -417,7 +425,8 @@ class BlocksApi extends asyncModules_1.default {
      */
     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);
     }
     /**
@@ -435,7 +444,7 @@ class BlocksApi extends asyncModules_1.default {
      * @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/dist/discounts/discountsApi.js

@@ -62,7 +62,8 @@ class DiscountsApi extends asyncModules_1.default {
             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/dist/events/eventsApi.js

@@ -62,7 +62,7 @@ class EventsApi extends asyncModules_1.default {
             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.
@@ -81,7 +81,7 @@ class EventsApi extends asyncModules_1.default {
             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.
@@ -107,7 +107,7 @@ class EventsApi extends asyncModules_1.default {
      * @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.
@@ -140,7 +140,7 @@ class EventsApi extends asyncModules_1.default {
      * @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));
     }
 }
 exports.default = EventsApi;

package/dist/filters/filtersApi.js

@@ -67,7 +67,7 @@ class FiltersApi extends asyncModules_1.default {
      * @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/dist/forms/formsApi.js

@@ -84,7 +84,7 @@ class FormsApi extends asyncModules_1.default {
      * @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/dist/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/dist/forms-data/formsDataApi.js

@@ -171,7 +171,9 @@ class FormsDataApi extends asyncModules_1.default {
         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.
@@ -252,23 +254,25 @@ class FormsDataApi extends asyncModules_1.default {
      * @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);
@@ -314,11 +318,11 @@ class FormsDataApi extends asyncModules_1.default {
      * @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) {