oneentry 1.0.175 → 1.0.177

package/esm/events/eventsApi.d.ts

@@ -39,7 +39,7 @@ export default class EventsApi extends AsyncModules implements IEvents {
      * @handleName subscribeByMarker
      * @param {string} marker - Marker of the event. Example: "product_price_change".
      * @param {number} productId - Product ID. Example: 12345.
-     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [langCode] - Language code. Default: the client's language.
      * @returns {Promise<boolean | IError>} Returns true if subscription was successful, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
@@ -52,7 +52,7 @@ export default class EventsApi extends AsyncModules implements IEvents {
      * @handleName unsubscribeByMarker
      * @param {string} marker - Marker of the event to unsubscribe from. Example: "product_price_change".
      * @param {number} productId - ID of the product to unsubscribe from. Example: 12345.
-     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [langCode] - Language code. Default: the client's language.
      * @returns {Promise<boolean | IError>} - Returns true if the unsubscription succeeded, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
@@ -65,7 +65,7 @@ export default class EventsApi extends AsyncModules implements IEvents {
      * @handleName getAllEvents
      * @returns {Promise<IContentApiEvent[] | IError>} Returns an array of available events.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method returns all available events.
+     * @description This method returns all available events. This method requires user authorization — without it the API answers `401 Unauthorized`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/events/getAllEvents getAllEvents} documentation.
      */
     getAllEvents(): Promise<IContentApiEvent[] | IError>;

package/esm/events/eventsApi.js

@@ -45,7 +45,7 @@ export default class EventsApi extends AsyncModules {
      * @handleName subscribeByMarker
      * @param {string} marker - Marker of the event. Example: "product_price_change".
      * @param {number} productId - Product ID. Example: 12345.
-     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [langCode] - Language code. Default: the client's language.
      * @returns {Promise<boolean | IError>} Returns true if subscription was successful, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
@@ -57,14 +57,14 @@ 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.
      * @handleName unsubscribeByMarker
      * @param {string} marker - Marker of the event to unsubscribe from. Example: "product_price_change".
      * @param {number} productId - ID of the product to unsubscribe from. Example: 12345.
-     * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [langCode] - Language code. Default: the client's language.
      * @returns {Promise<boolean | IError>} - Returns true if the unsubscription succeeded, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
@@ -76,14 +76,14 @@ 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.
      * @handleName getAllEvents
      * @returns {Promise<IContentApiEvent[] | IError>} Returns an array of available events.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method returns all available events.
+     * @description This method returns all available events. This method requires user authorization — without it the API answers `401 Unauthorized`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/events/getAllEvents getAllEvents} documentation.
      */
     async getAllEvents() {
@@ -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/events/eventsInterfaces.d.ts

@@ -20,7 +20,7 @@ interface IEvents {
      * @handleName subscribeByMarker
      * @param {string} marker - The marker identifying the event. Example: "product_price_change".
      * @param {number} productId - The ID of the product to subscribe to. Example: 12345.
-     * @param {string} [langCode] - Optional language code for localization. Default: "en_US".
+     * @param {string} [langCode] - Optional language code for localization. Default: the client's language.
      * @returns {Promise<boolean | IError>} A promise that resolves to any type or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method subscribes to an event on a product by its marker.
@@ -31,7 +31,7 @@ interface IEvents {
      * @handleName unsubscribeByMarker
      * @param {string} marker - The marker identifying the event. Example: "product_price_change".
      * @param {number} productId - ID of the product to unsubscribe from. Example: 12345.
-     * @param {string} [langCode] - Optional language code for localization. Default: "en_US".
+     * @param {string} [langCode] - Optional language code for localization. Default: the client's language.
      * @returns {Promise<boolean | IError>} A promise that resolves to any type or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method unsubscribes from an event on a product by its marker.
@@ -42,7 +42,7 @@ interface IEvents {
      * @handleName getAllEvents
      * @returns {Promise<IContentApiEvent[] | IError>} A promise that resolves to an array of events or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
-     * @description This method returns all available events.
+     * @description This method returns all available events. This method requires user authorization — without it the API answers `401 Unauthorized`.
      */
     getAllEvents(): Promise<IContentApiEvent[] | IError>;
     /**
@@ -85,16 +85,12 @@ interface IEvents {
  * @property {number} total - Total number of found records. Example: 100.
  * @property {ISubscriptionItem[]} items - Subscriptions, each with an event marker and a product ID.
  * @example
- [
-   {
-     eventMarker: 'product_price_change',
-     productId: 12345
-   },
-   {
-     eventMarker: 'product_stock_update',
-     productId: 67890
-   }
- ]
+ {
+   "total": 1,
+   "items": [
+     { "eventMarker": "lessPrice", "productId": 2954 }
+   ]
+ }
  * @property { string } items.eventMarker - Event marker.
  * @property { number } items.productId - Product ID.
  * @description Represents a response from the events API containing a total count and an array of subscription items.
@@ -173,4 +169,4 @@ interface ISubscribeFormEvent {
     formDataId: number;
     status?: string;
 }
-export type { IContentApiEvent, IEvents, IFormSubscriptionsResponse, IListFormSubscription, ISubscribeBody, ISubscribeFormEvent, ISubscriptions, };
+export type { IContentApiEvent, IEvents, IFormSubscriptionsResponse, IListFormSubscription, ISubscribeBody, ISubscribeFormEvent, ISubscriptionItem, ISubscriptions, };

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

@@ -99,6 +99,7 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
      * @param {string} filename - The name to give the created file.
      * @param {string} [mimeType] - Optional MIME type for the file.
      * @returns {Promise<File>} A promise that resolves to a File object.
+     * @throws {Error} When the URL answers with an error status — the body of the error page is not turned into a file.
      */
     createFileFromUrl(url: string, filename: string, mimeType?: string): Promise<File>;
     /**
@@ -108,10 +109,9 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
      * @param {string} type - Storage type; determines the folder the file is stored in, for example `"page"`. Example: "page".
      * @param {string} entity - Name of the entity the file belongs to; sets the folder name in the storage. Example: "editor".
      * @param {string} filename - File name. Example: "file.png".
-     * @param {string} [template] - Preview template: its numeric ID or its marker, for example `"preview"`. Without it, no preview is generated. Example: "preview_template".
-     * @returns {Promise<Response | IError>} Returns a promise that resolves to a Response object containing the file data or an error object if there was an issue.
-     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @param {string} [template] - Kept for compatibility: `GET /files` ignores it — the answer is the original file with any value, an unknown template included (CMS-1101, CMS-1128). Previews are made on `upload`.
+     * @returns {Promise<Response>} Resolves to the raw `Response` of the request — also on an error: check `response.ok`. A missing file answers `404` with a JSON body but a `content-type` taken from the requested file name (`image/png` …).
      * @see {@link https://js-sdk.oneentry.cloud/docs/file-uploading/getFile getFile} documentation.
      */
-    getFile(id: number, type: string, entity: string, filename: string, template?: string): Promise<Response | IError>;
+    getFile(id: number, type: string, entity: string, filename: string, template?: string): Promise<Response>;
 }

package/esm/file-uploading/fileUploadingApi.js

@@ -83,7 +83,10 @@ export default class FileUploadingApi extends AsyncModules {
         const query = { ...this._defaultQuery, ...fileQuery };
         // The endpoint answers 200 with an empty body, which _parseJson reads as `{}`;
         // _fetchBoolean turns that into the declared `true` (CMS-1072)
-        return this._fetchBoolean(() => this._fetchDelete(`?filename=${filename}&` + this._queryParamsToString(query)));
+        return this._fetchBoolean(() => this._fetchDelete(
+        // The name is encoded like the other parameters: `#` cut the query and dropped
+        // type/entity/id, `&id=` added parameters of its own
+        `?` + this._queryParamsToString({ filename, ...query })));
     }
     /**
      * Public search across the content of files attached to records.
@@ -133,10 +136,15 @@ export default class FileUploadingApi extends AsyncModules {
      * @param {string} filename - The name to give the created file.
      * @param {string} [mimeType] - Optional MIME type for the file.
      * @returns {Promise<File>} A promise that resolves to a File object.
+     * @throws {Error} When the URL answers with an error status — the body of the error page is not turned into a file.
      */
     async createFileFromUrl(url, filename, mimeType) {
         // eslint-disable-next-line no-undef
         const response = await fetch(url);
+        // A 404 page of the storage used to become the "file" and was then uploaded as is
+        if (!response.ok) {
+            throw new Error(`OneEntry SDK: createFileFromUrl got ${response.status} from ${url}`);
+        }
         const blob = await response.blob();
         const file = new File([blob], filename, { type: mimeType || blob.type });
         return file;
@@ -148,14 +156,14 @@ export default class FileUploadingApi extends AsyncModules {
      * @param {string} type - Storage type; determines the folder the file is stored in, for example `"page"`. Example: "page".
      * @param {string} entity - Name of the entity the file belongs to; sets the folder name in the storage. Example: "editor".
      * @param {string} filename - File name. Example: "file.png".
-     * @param {string} [template] - Preview template: its numeric ID or its marker, for example `"preview"`. Without it, no preview is generated. Example: "preview_template".
-     * @returns {Promise<Response | IError>} Returns a promise that resolves to a Response object containing the file data or an error object if there was an issue.
-     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @param {string} [template] - Kept for compatibility: `GET /files` ignores it — the answer is the original file with any value, an unknown template included (CMS-1101, CMS-1128). Previews are made on `upload`.
+     * @returns {Promise<Response>} Resolves to the raw `Response` of the request — also on an error: check `response.ok`. A missing file answers `404` with a JSON body but a `content-type` taken from the requested file name (`image/png` …).
      * @see {@link https://js-sdk.oneentry.cloud/docs/file-uploading/getFile getFile} documentation.
      */
     async getFile(id, type, entity, filename, template) {
         // eslint-disable-next-line no-undef
-        const response = await fetch(this._getFullPath(`?id=${id}&type=${type}&entity=${entity}${`&filename=${filename}`}${template ? `&template=${template}` : ''}`), {
+        const response = await fetch(this._getFullPath('?' +
+            this._queryParamsToString({ id, type, entity, filename, template })), {
             method: 'GET',
             headers: {
                 'Content-Type': 'application/json',

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

@@ -66,11 +66,10 @@ interface IFileUploading {
      * @param {string} type - Storage type; determines the folder the file is stored in, for example `"page"`. Example: "page".
      * @param {string} entity - Name of the entity the file belongs to; sets the folder name in the storage. Example: "editor".
      * @param {string} filename - File name. Example: "file.png".
-     * @param {string} [template] - Preview template: its numeric ID or its marker, for example `"preview"`. Without it, no preview is generated. Example: "1".
-     * @returns {Response | IError} Returns a promise that resolves to a Response object containing the file data or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @param {string} [template] - Kept for compatibility: `GET /files` ignores it — the answer is the original file with any value, an unknown template included (CMS-1101, CMS-1128). Previews are made on `upload`.
+     * @returns {Response} The raw `Response` of the request — also on an error: check `response.ok`. A missing file answers `404` with a JSON body but a `content-type` taken from the file name. No IError is returned and nothing is thrown on an HTTP error.
      */
-    getFile(id: number, type: string, entity: string, filename: string, template?: string): Promise<Response | IError>;
+    getFile(id: number, type: string, entity: string, filename: string, template?: string): Promise<Response>;
     /**
      * Public search across the content of files attached to records.
      * @handleName searchFileContent
@@ -186,7 +185,7 @@ interface IFileSearchItem {
  * The `IFileSearchQueryLanguage` interface describes how the query language was resolved.
  * @interface IFileSearchQueryLanguage
  * @property {string[]} resolved - Languages the query was actually run in. Example: ["english"].
- * @property {string} source - How they were chosen: "explicit" when taken from `langCode`, otherwise detected. Example: "explicit".
+ * @property {string} source - How they were chosen: `"explicit"` when taken from `langCode`; detected otherwise (seen: `"script"`). Detection runs only with `langCode: ""` — by default the client's language is sent. Example: "explicit".
  * @property {string[]} candidates - Languages that were considered. Example: ["english"].
  * @description How the query language was resolved for the search.
  */
@@ -202,7 +201,7 @@ interface IFileSearchQueryLanguage {
  * @property {number} offset - Number of records to skip. Example: 0.
  * @property {number} limit - Maximum number of records to return. Example: 10.
  * @property {IFileSearchQueryLanguage} queryLanguage - How the query language was resolved.
- * @property {string[]} warnings - Warnings about the search, empty when there are none.
+ * @property {string[]} warnings - Warning codes, empty when there are none. Seen: `processing_disabled` (content indexing is off — `items` is always empty), `query_language_capped`, `query_too_common`.
  * @property {IFileSearchItem[]} items - Files that match the query.
  * @description The result of a file content search.
  */

package/esm/filters/filtersApi.js

@@ -29,8 +29,8 @@ 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=${encodeURIComponent(langCode)}`);
         const validated = await this._validateResponse(data, schema('ContentFilterSchema'));
-        return this._normalizeData(validated);
+        return this._normalizeData(validated, langCode);
     }
 }

package/esm/forms/formsApi.js

@@ -31,7 +31,7 @@ export default class FormsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms/getAllForms getAllForms} documentation.
      */
     async getAllForms(langCode = this.state.lang, offset = 0, limit = 30) {
-        const result = await this._fetchGet(`?langCode=${langCode}&offset=${offset}&limit=${limit}`);
+        const result = await this._fetchGet(`?langCode=${encodeURIComponent(langCode)}&offset=${encodeURIComponent(String(offset))}&limit=${encodeURIComponent(String(limit))}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('FormsResponseSchema'));
         return this._normalizeData(validated, langCode);
@@ -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=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('FormEntitySchema'));
         return this._normalizeData(validated, langCode);

package/esm/forms/formsInterfaces.d.ts

@@ -69,10 +69,9 @@ interface IFromPages {
  * @property {number} version - Version number of the object; changes with each update. Example: 1.
  * @property {number} position - Position of the object, used for sorting. Example: 1.
  * @property {string} identifier - Text identifier (marker) of the object. Example: "form_contact_us".
- * @property {string} processingType - How form submissions are processed, for example `"email"` or `"url"`. Example: "async".
+ * @property {string} processingType - How form submissions are processed: the processing type chosen in the form settings. Example: "script".
  * @property {number | null} templateId - ID of the template used by the form, or `null` when the form has no template. Example: 6789.
  * @property {IFormAttribute[]} attributes - Form fields with their localization, validators and form-specific flags, sorted by `position`. The API returns an empty object for forms with no attributes — the SDK normalizes it to an empty array.
- * @property {number | string} [total] - Total count of related entries. Example: "1".
  * @property {IFormConfig[]} [moduleFormConfigs] - Form configurations of the module associated with the form.
  * @description This interface defines the structure of a form entity, including its identifiers, attributes, and processing data.
  */
@@ -87,7 +86,6 @@ interface IFormsEntity {
     processingType: string;
     templateId: number | null;
     attributes: IFormAttribute[];
-    total?: number | string;
     moduleFormConfigs?: IFormConfig[];
 }
 /**

package/esm/forms/formsSchemas.d.ts

@@ -13,8 +13,7 @@ export declare const FormEntitySchema: z.ZodObject<{
     type: z.ZodNullable<z.ZodString>;
     attributeSetId: z.ZodNullable<z.ZodNumber>;
     templateId: z.ZodNullable<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-    attributes: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+    attributes: z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
 }, z.core.$strip>;
 /**
@@ -32,8 +31,7 @@ export declare const FormsResponseSchema: z.ZodObject<{
         type: z.ZodNullable<z.ZodString>;
         attributeSetId: z.ZodNullable<z.ZodNumber>;
         templateId: z.ZodNullable<z.ZodNumber>;
-        total: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-        attributes: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+        attributes: z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>;
         moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -50,7 +48,6 @@ export declare const SingleFormSchema: z.ZodObject<{
     type: z.ZodNullable<z.ZodString>;
     attributeSetId: z.ZodNullable<z.ZodNumber>;
     templateId: z.ZodNullable<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-    attributes: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+    attributes: z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
 }, z.core.$strip>;

package/esm/forms/formsSchemas.js

@@ -13,10 +13,8 @@ export const FormEntitySchema = z.object({
     type: z.string().nullable(),
     attributeSetId: z.number().nullable(),
     templateId: z.number().nullable(),
-    total: z.union([z.number(), z.string()]).optional(),
-    attributes: z
-        .union([z.array(z.any()), z.record(z.string(), z.any())])
-        .optional(),
+    // Required as in IFormsEntity: a form without fields comes as `{}`
+    attributes: z.union([z.array(z.any()), z.record(z.string(), z.any())]),
     moduleFormConfigs: z.array(z.any()).optional(),
 });
 /**

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.
@@ -138,6 +140,22 @@ export default class FormsDataApi extends AsyncModules implements IFormsData {
      * Update one object of form data by id. Requires user authentication.
      * @handleName updateFormsDataByid
      * @param {number} id - Form data ID. Example: 1.
+     * @param {object} [body] - Form data to save: the same fields as in `postFormsData` (`formIdentifier`, `formModuleConfigId`, `moduleEntityIdentifier`, `replayTo`, `status`, `formData`). Default: `{}`.
+     * @example
+        {
+          "formIdentifier": "test-form",
+          "formModuleConfigId": 2,
+          "moduleEntityIdentifier": "blog",
+          "replayTo": null,
+          "status": "sent",
+          "formData": [
+            {
+              "marker": "name",
+              "type": "string",
+              "value": "Test"
+            }
+          ]
+        }
      * @returns {Promise<IUpdateFormsData | IError>} Returns an object containing the updated form data or an error object if there was an issue.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/updateFormsDataByid updateFormsDataByid} documentation.
      */
@@ -164,11 +182,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

@@ -128,12 +128,25 @@ export default class FormsDataApi extends AsyncModules {
                 return field;
             }));
         }
+        // A failed upload used to be sent to the platform as the field's value, and the caller
+        // got a success: the form is not sent, the upload's error is the answer
+        const uploadError = formData[langCode]
+            .flatMap((field) => Array.isArray(field === null || field === void 0 ? void 0 : field.value) ? field.value : [field === null || field === void 0 ? void 0 : field.value])
+            .find((value) => this._isErrorResponse(value));
+        if (uploadError) {
+            if (this.state.isShell) {
+                return uploadError;
+            }
+            throw uploadError;
+        }
         // The wrapped formData goes into a new body: written back into the caller's
         // object, a second call with it wrapped the wrapper and answered `400` (CMS-1071)
         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 +227,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=${encodeURIComponent(String(formModuleConfigId))}&isExtended=${encodeURIComponent(String(isExtended))}&langCode=${encodeURIComponent(langCode)}&offset=${encodeURIComponent(String(offset))}&limit=${encodeURIComponent(String(limit))}`, this._stripEmptyDates(body));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('FormsByMarkerDataResponseSchema'));
         return this._normalizeData(validated, langCode);
@@ -239,11 +254,27 @@ export default class FormsDataApi extends AsyncModules {
      * Update one object of form data by id. Requires user authentication.
      * @handleName updateFormsDataByid
      * @param {number} id - Form data ID. Example: 1.
+     * @param {object} [body] - Form data to save: the same fields as in `postFormsData` (`formIdentifier`, `formModuleConfigId`, `moduleEntityIdentifier`, `replayTo`, `status`, `formData`). Default: `{}`.
+     * @example
+        {
+          "formIdentifier": "test-form",
+          "formModuleConfigId": 2,
+          "moduleEntityIdentifier": "blog",
+          "replayTo": null,
+          "status": "sent",
+          "formData": [
+            {
+              "marker": "name",
+              "type": "string",
+              "value": "Test"
+            }
+          ]
+        }
      * @returns {Promise<IUpdateFormsData | IError>} Returns an object containing the updated form data or an error object if there was an issue.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/updateFormsDataByid updateFormsDataByid} documentation.
      */
     async updateFormsDataByid(id, body = {}) {
-        const result = await this._fetchPut(`/${id}`, body);
+        const result = await this._fetchPut(`/${this._pathSegment(String(id))}`, body);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('UpdateFormsDataSchema'));
         return validated;
@@ -257,7 +288,7 @@ export default class FormsDataApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/updateFormsDataStatusByid updateFormsDataStatusByid} documentation.
      */
     async updateFormsDataStatusByid(id, body = {}) {
-        const result = await this._fetchPut(`/${id}/update-status`, body);
+        const result = await this._fetchPut(`/${this._pathSegment(String(id))}/update-status`, body);
         return result;
     }
     /**
@@ -268,19 +299,19 @@ export default class FormsDataApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/deleteFormsDataByid deleteFormsDataByid} documentation.
      */
     async deleteFormsDataByid(id) {
-        const result = await this._fetchDelete(`/${id}`);
-        return result;
+        const result = await this._fetchDelete(`/${this._pathSegment(String(id))}`);
+        return this._asBoolean(result);
     }
     /**
      * Semantic (vector) search for form data.
      * @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) {