oneentry 1.0.170 → 1.0.172

package/changelog.md

@@ -1,5 +1,45 @@
 # SDK Change Log
 
+## v.1.0.172
+
+### What's Fixed
+
+- **`Orders.createOrder`, `Orders.updateOrderByMarkerAndId` and `FormData.postFormsData` no longer modify the body they are given.** All three wrapped `formData` into `{ [langCode]: [...] }` and wrote the result back into the caller's object (`body.formData = formData`) — the same class of defect 1.0.168 fixed in `_normalizePostBody`, in three methods that wrap on their own. A reused body (a retry, a shared template, form state passed by reference) was wrapped a second time: `createOrder` and `postFormsData` answered `400 formData's marker '#0' marker is required`, and `updateOrderByMarkerAndId` answered **`200` and stored the broken `formData` in the order**. The wrapped value now goes into a new body. `postFormsData` also processed file fields in place — it replaced the caller's `File` with the upload result, deleted `fileQuery` and stripped `contentType` from a descriptor passed through — and now works on copies of those fields too (CMS-1063, CMS-1071).
+
+- **`UserActivity.trackUserActivity` returned `true` for a refused event.** With `isShell` on — the default — the API error came back as a value nobody inspected, so a `400 type must be a valid enum value` read as "recorded"; with `isShell` off the thrown error was caught and returned, while the JSDoc promises a throw. The method now goes through `_fetchBoolean`: `true` on the `204`, the `IError` otherwise, thrown when `isShell` is off (CMS-1064).
+
+- **Methods built on `_fetchBoolean` threw nothing when `isShell` was off.** `Events.subscribeByMarker`, `unsubscribeByMarker`, `subscribeToForm`, `unsubscribeFromForm`, `Subscriptions.cancelSubscription` and `recoverSubscriptions` caught the error `browserResponse` throws in that mode and returned it, so a `try/catch` around them never fired and `if (result)` took the error object for success. The helper now rethrows when `isShell` is off, as every other method does. The JSDoc of `unsubscribeByMarker` said `Promise<any | IError>` and now matches the signature (CMS-1067).
+
+- **`Pages.searchPage` searched only the default language.** The method sent `lang=` where the endpoint reads `langCode`, and the endpoint treats an unknown parameter as no language at all. On a bilingual stand `searchPage('Блог', undefined, 'ru_RU')` came back empty, while `searchPage('Blog', undefined, 'ru_RU')` found the English titles and then loaded them in `ru_RU`: the pages missing in that locale answered `404`, and those errors were returned as elements of the `IPagesEntity[]` array. The parameter is `langCode` now, a found page that cannot be loaded is left out of the result, and the result keeps the order of the search instead of the order the requests finished in (CMS-1068).
+
+- **`FileUploading.delete` resolved to `{}` on success, not to the declared `boolean`.** The endpoint answers `200` with an empty body, which the parser reads as `{}`. The method now returns `true`, so `=== true` and `typeof result === 'boolean'` work as the type says (CMS-1072).
+
+### What's Changed
+
+- **`Products.getProductsEmptyPage` returns `IProductsResponse`.** It was declared as `IAggregatedProductGroup[]`, but the endpoint answers `{ items, total }` — the same container as `getProducts` — and the SDK never converted it, so `result.map(...)` compiled and failed at run time. The response is now validated with the same schema as `getProducts` when validation is on. `IAggregatedProductGroup` is kept for existing imports and marked deprecated: no method returns it (CMS-1065).
+
+- **`indexReady` is declared on all seven vector search responses.** The platform answers every `…/vector/search` with `indexReady`: `false` means the index for that entity and language is not built yet and empty `items` do not mean "nothing matched". The SDK passed the field through but no type declared it. The new `IVectorSearchResponse<T>` adds it to the module's own container, and `getUsersByVectorSearch`, `getProductsByVectorSearch`, `getPagesByVectorSearch`, `getOrdersByVectorSearch`, `getDiscountsByVectorSearch`, `getAdminsByVectorSearch` and `getFormsDataByVectorSearch` return it. It is assignable to the container they declared before, so existing code compiles unchanged (CMS-1074).
+
+- **Products query types follow what the endpoint accepts.** `IProductsQueryBase.sortKey` takes `'status'`, which the endpoint sorts by and the type refused; `IProductsRelatedQuery` declares `relationMode: 'global' | 'local'` of `GET /products/{id}/related`; the JSDoc example of `IFilterParams.conditionMarker` was `"equals"`, which answers `400 filter.0.conditionMarker must be a valid enum value`, and is `"eq"` now (CMS-1066).
+
+- **`BlockType` no longer includes `'none'`.** The platform has no such type — `GET /general-types` does not return it — and a filter by it answers `400 type must be a valid enum value`. The `general-types` response schema drops it as well. The JSDoc of `getBlocks` listed 12 of the types and lists all 22 now. `'service'` stays: it is the platform's own name for the type, and the `400` the `type` filter of `getBlocks` and `getTemplateByType` currently gives it is a platform defect, reported as CMS-1073 (CMS-1062).
+
+### Tests
+
+- **`src/base/tests/callercontracts.spec.ts` pins these contracts** with a stubbed `fetch`, no stand required: a reused order and form body sent identically twice and left untouched, a file descriptor passed through without losing `contentType` on the caller's side, `trackUserActivity` on `204` / `400` with `isShell` on and off, `subscribeByMarker` throwing when `isShell` is off, `searchPage` sending `langCode` and dropping a page it could not load, and `FileUploading.delete` returning `true`. Against 1.0.171 ten of its thirteen cases fail.
+
+## v.1.0.171
+
+### What's Fixed
+
+- **`postFormsData` threw `fd.value.map is not a function` on the value its own uploader returns.** For a `file`, `image` or `groupOfImages` field the method converted the value — an array was uploaded file by file, a lone `File`/`Blob` into a single object — and then called `fd.value.map(...)` **unconditionally**, to strip `contentType`. A value the package had not converted reached `.map` as a non-array and the call died inside the library, before any request was made. That value is not an exotic one: it is exactly what `FileUploading.upload` returns, the natural thing to pass when the file is already in storage. The other plausible reading — an array of those descriptors — was re-uploaded as if the descriptors were files, and the platform refused the result with `formData's marker 'resume' value[0].filename is required`, naming the field the SDK itself had replaced. It cost a shipped pilot its application form: every visitor who attached a document got a generic refusal while the submission counter stayed at 0, and the only trace was the `TypeError` in the site log. Now only a `File` or a `Blob` is uploaded, an entry already in storage is passed through untouched — the two may be mixed in one array — and `contentType` is stripped from an array of values and from a lone value object alike. A value of any other shape is sent as it came, so the endpoint names the field it cannot read instead of the library throwing (CMS-990).
+
+- **The accepted shapes of a file value were not declared.** `IBodyTypeFile.value` and `IBodyTypeImageGroupOfImages.value` described a hand-built `IFileValue` / `IImageValue` only — neither a raw `File`/`Blob`, which the SDK has always uploaded on the caller's behalf, nor the descriptor the uploader returns for a file already in storage. Both are in the types now, mixable in one array, and the JSDoc states what the endpoint does with them: a submission wants an **array**, so a lone descriptor or `IFileValue` answers `400 formData's marker '<marker>' value must be an array` while a lone `File`/`Blob` works because the upload result is already one. `fileQuery` is also declared where the SDK actually reads it — on the field; `IBodyPostFormData.fileQuery` is kept for compatibility, but setting it there changes nothing. Measured on js-sdk-tests.oneentry.cloud, 2026-10-08.
+
+### Tests
+
+- **`formsdata` pins the file already in storage.** The new case uploads a probe with `FileUploading.upload`, submits the descriptor it returns as a one-element array — which used to be re-uploaded and refused — and then submits the same descriptor alone, which must come back as the endpoint's own `400 … value must be an array`, not as a `TypeError` from inside the package.
+
 ## v.1.0.170
 
 ### What's Changed

package/dist/admins/adminsApi.d.ts

@@ -1,6 +1,6 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
-import type { IError } from '../base/utils';
+import type { IError, IVectorSearchResponse } from '../base/utils';
 import type { IFilterParams } from '../products/productsInterfaces';
 import type { IAdminEntity, IAdmins, IAdminsResponse, IAdminsVectorSearch } from './adminsInterfaces';
 /**
@@ -57,10 +57,10 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IAdminsResponse | IError>} Returns an object with an array of found admins and total count.
+     * @returns {Promise<IVectorSearchResponse<IAdminsResponse> | IError>} Returns an object with an array of found admins and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for admins.
      * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsByVectorSearch getAdminsByVectorSearch} documentation.
      */
-    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IAdminsResponse | IError>;
+    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IAdminsResponse> | IError>;
 }

package/dist/admins/adminsApi.js

@@ -104,7 +104,7 @@ class AdminsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IAdminsResponse | IError>} Returns an object with an array of found admins and total count.
+     * @returns {Promise<IVectorSearchResponse<IAdminsResponse> | IError>} Returns an object with an array of found admins and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for admins.
      * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsByVectorSearch getAdminsByVectorSearch} documentation.

package/dist/admins/adminsInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IAttributeValues, IError } from '../base/utils';
+import type { IAttributeValues, IError, IVectorSearchResponse } from '../base/utils';
 import type { IFormConfig } from '../forms/formsInterfaces';
 import type { IFilterParams } from '../products/productsInterfaces';
 /**
@@ -40,10 +40,10 @@ interface IAdmins {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IAdminsResponse} Returns an object with an array of found admins and total count.
+     * @returns {IVectorSearchResponse<IAdminsResponse>} Returns an object with an array of found admins, total count and indexReady.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IAdminsResponse | IError>;
+    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IAdminsResponse> | IError>;
 }
 /**
  * Body for semantic (vector) admin search.

package/dist/base/asyncModules.d.ts

@@ -79,8 +79,13 @@ export default abstract class AsyncModules extends SyncModules {
      * (the default) browserResponse returns the API error instead of throwing
      * it, so relying on the catch alone would report every failed call — a 404
      * from cancelSubscription, a 403 from recoverSubscriptions — as a success.
+     *
+     * With `isShell` disabled browserResponse throws, and the error is thrown on
+     * from here too: returning it would break the `@throws` contract every caller
+     * documents, and a `try/catch` around the call would never fire (CMS-1067).
      * @param {() => Promise<unknown>} request - Thunk performing the fetch call.
-     * @returns {Promise<boolean | IError>} `true` on success, IError on failure.
+     * @returns {Promise<boolean | IError>} `true` on success, IError on failure when isShell=true.
+     * @throws {IError} When isShell=false and the request fails.
      */
     protected _fetchBoolean(request: () => Promise<unknown>): Promise<boolean | IError>;
     /**

package/dist/base/asyncModules.js

@@ -168,8 +168,13 @@ class AsyncModules extends syncModules_1.default {
      * (the default) browserResponse returns the API error instead of throwing
      * it, so relying on the catch alone would report every failed call — a 404
      * from cancelSubscription, a 403 from recoverSubscriptions — as a success.
+     *
+     * With `isShell` disabled browserResponse throws, and the error is thrown on
+     * from here too: returning it would break the `@throws` contract every caller
+     * documents, and a `try/catch` around the call would never fire (CMS-1067).
      * @param {() => Promise<unknown>} request - Thunk performing the fetch call.
-     * @returns {Promise<boolean | IError>} `true` on success, IError on failure.
+     * @returns {Promise<boolean | IError>} `true` on success, IError on failure when isShell=true.
+     * @throws {IError} When isShell=false and the request fails.
      */
     async _fetchBoolean(request) {
         try {
@@ -180,6 +185,9 @@ class AsyncModules extends syncModules_1.default {
             return true;
         }
         catch (e) {
+            if (!this.state.isShell) {
+                throw e;
+            }
             return e;
         }
     }

package/dist/base/utils.d.ts

@@ -439,6 +439,16 @@ interface IHttpOptions {
     headers: IHttpHeaders;
     body?: string | FormData | Blob;
 }
+/**
+ * Response of a semantic (vector) search: the module's own list container plus `indexReady`.
+ * @typedef {object} IVectorSearchResponse
+ * @template T
+ * @property {boolean} indexReady - `false` when no vectors are built yet for this entity and language: the query was not embedded, and empty `items` do not mean "nothing matched". `true` — an honest search result.
+ * @description Every `…/vector/search` endpoint answers with `indexReady` next to its list (CMS-1074).
+ */
+type IVectorSearchResponse<T> = T & {
+    indexReady: boolean;
+};
 /**
  * LangType
  */
@@ -447,4 +457,4 @@ type LangType = string | Array<string>;
  * LocalizeType
  */
 type LocalizeType = ILocalizeInfo;
-export type { IAttributeFile, IAttributeLocalizeInfo, IAttributes, IAttributeValue, IAttributeValues, IConfig, IError, IFileAttributeValue, IHttpHeaders, IHttpOptions, IListAttributeValue, ILocalizeInfo, INumberAttributeValue, IRating, IStringAttributeValue, ITimeIntervalAttributeValue, ITimeIntervalEntitySchedule, ITimeIntervalGroup, ITimeIntervalPoint, ITimeIntervalRange, ITimeIntervalSchedule, ITimeIntervalWindow, ITypedAttributeValue, LangType, LocalizeType, TimeIntervalPair, };
+export type { IAttributeFile, IAttributeLocalizeInfo, IAttributes, IAttributeValue, IAttributeValues, IConfig, IError, IFileAttributeValue, IHttpHeaders, IHttpOptions, IListAttributeValue, ILocalizeInfo, INumberAttributeValue, IRating, IStringAttributeValue, ITimeIntervalAttributeValue, ITimeIntervalEntitySchedule, ITimeIntervalGroup, ITimeIntervalPoint, ITimeIntervalRange, ITimeIntervalSchedule, ITimeIntervalWindow, ITypedAttributeValue, IVectorSearchResponse, LangType, LocalizeType, TimeIntervalPair, };

package/dist/blocks/blocksApi.d.ts

@@ -21,7 +21,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
     /**
      * Get blocks by parameters.
      * @handleName getBlocks
-     * @param {BlockType} [type] - Optional block type to filter by. Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "form" | "common_page" | "common_block" | "order" | "service" | "none". When omitted, blocks of all types are returned. Example: 'product'.
+     * @param {BlockType} [type] - Optional block type to filter by. Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "frequently_ordered_block" | "trending_block" | "recently_viewed_block" | "repeat_purchase_block" | "slider_block" | "personal_recommendations_block" | "cart_complement_block" | "cart_similar_block" | "wishlist_similar_block" | "form" | "common_page" | "common_block" | "order" | "service" | "external_page" | "discount" (see BlockType). When omitted, blocks of all types are returned. Example: 'product'.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.

package/dist/blocks/blocksApi.js

@@ -60,7 +60,7 @@ class BlocksApi extends asyncModules_1.default {
     /**
      * Get blocks by parameters.
      * @handleName getBlocks
-     * @param {BlockType} [type] - Optional block type to filter by. Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "form" | "common_page" | "common_block" | "order" | "service" | "none". When omitted, blocks of all types are returned. Example: 'product'.
+     * @param {BlockType} [type] - Optional block type to filter by. Available values: "product" | "error_page" | "catalog_page" | "product_preview" | "similar_products_block" | "product_block" | "frequently_ordered_block" | "trending_block" | "recently_viewed_block" | "repeat_purchase_block" | "slider_block" | "personal_recommendations_block" | "cart_complement_block" | "cart_similar_block" | "wishlist_similar_block" | "form" | "common_page" | "common_block" | "order" | "service" | "external_page" | "discount" (see BlockType). When omitted, blocks of all types are returned. Example: 'product'.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.

package/dist/blocks/blocksInterfaces.d.ts

@@ -309,9 +309,11 @@ interface ISearchBlock {
 /**
  * BlockType
  * @type {BlockType}
- * @description This type defines the possible values for block types used in the system.
+ * @description This type defines the possible values for block types used in the system: the types `GET /api/content/general-types` returns.
+ * `'none'` was dropped — the platform has no such type and a filter by it answers `400 type must be a valid enum value` (CMS-1062).
+ * `'service'` is the platform's own name for the type, but the `type` filter of getBlocks and getTemplateByType currently refuses it with the same `400`; that is a platform defect (CMS-1073).
  */
-type BlockType = 'product' | 'error_page' | 'catalog_page' | 'product_preview' | 'similar_products_block' | 'product_block' | 'frequently_ordered_block' | 'trending_block' | 'recently_viewed_block' | 'repeat_purchase_block' | 'slider_block' | 'personal_recommendations_block' | 'cart_complement_block' | 'cart_similar_block' | 'wishlist_similar_block' | 'form' | 'common_page' | 'common_block' | 'order' | 'service' | 'external_page' | 'discount' | 'none';
+type BlockType = 'product' | 'error_page' | 'catalog_page' | 'product_preview' | 'similar_products_block' | 'product_block' | 'frequently_ordered_block' | 'trending_block' | 'recently_viewed_block' | 'repeat_purchase_block' | 'slider_block' | 'personal_recommendations_block' | 'cart_complement_block' | 'cart_similar_block' | 'wishlist_similar_block' | 'form' | 'common_page' | 'common_block' | 'order' | 'service' | 'external_page' | 'discount';
 /**
  * Lookup body for block product endpoints by explicit productIds.
  * @interface IBlockProductsLookup

package/dist/discounts/discountsApi.d.ts

@@ -1,6 +1,6 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
-import type { IError } from '../base/utils';
+import type { IError, IVectorSearchResponse } from '../base/utils';
 import type { IBonusBalanceEntity, IBonusHistoryResponse, IBonusTransactionType, ICouponValidationResult, IDiscountsApi, IDiscountsEntity, IDiscountsResponse, IDiscountsVectorSearch, IDiscountType } from './discountsInterfaces';
 /**
  * Controllers for working with events
@@ -85,10 +85,10 @@ export default class DiscountsApi extends AsyncModules implements IDiscountsApi
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IDiscountsResponse | IError>} Returns an object with an array of found discounts and total count.
+     * @returns {Promise<IVectorSearchResponse<IDiscountsResponse> | IError>} Returns an object with an array of found discounts and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for discounts.
      * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/getDiscountsByVectorSearch getDiscountsByVectorSearch} documentation.
      */
-    getDiscountsByVectorSearch(body: IDiscountsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IDiscountsResponse | IError>;
+    getDiscountsByVectorSearch(body: IDiscountsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IDiscountsResponse> | IError>;
 }

package/dist/discounts/discountsApi.js

@@ -124,7 +124,7 @@ class DiscountsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IDiscountsResponse | IError>} Returns an object with an array of found discounts and total count.
+     * @returns {Promise<IVectorSearchResponse<IDiscountsResponse> | IError>} Returns an object with an array of found discounts and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for discounts.
      * @see {@link https://js-sdk.oneentry.cloud/docs/discounts/getDiscountsByVectorSearch getDiscountsByVectorSearch} documentation.

package/dist/discounts/discountsInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IAttributeValues, IError, ILocalizeInfo } from '../base/utils';
+import type { IAttributeValues, IError, ILocalizeInfo, IVectorSearchResponse } from '../base/utils';
 /**
  * Discount type.
  */
@@ -66,10 +66,10 @@ interface IDiscountsApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IDiscountsResponse | IError>} Returns an object with an array of found discounts and total count.
+     * @returns {Promise<IVectorSearchResponse<IDiscountsResponse> | IError>} Returns an object with an array of found discounts and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
-    getDiscountsByVectorSearch(body: IDiscountsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IDiscountsResponse | IError>;
+    getDiscountsByVectorSearch(body: IDiscountsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IDiscountsResponse> | IError>;
 }
 /**
  * Body for semantic (vector) discount search.

package/dist/events/eventsApi.d.ts

@@ -53,7 +53,7 @@ export default class EventsApi extends AsyncModules implements IEvents {
      * @param {string} marker - The marker of the event to unsubscribe from. Example: "product_price_change".
      * @param {number} productId - The ID of the product to unsubscribe from. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<any | IError>} - Returns a promise that resolves to the result of the unsubscription operation or an error object if there was an issue.
+     * @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.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.

package/dist/events/eventsApi.js

@@ -3,7 +3,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-disable jsdoc/reject-any-type */
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
 /**
@@ -71,7 +70,7 @@ class EventsApi extends asyncModules_1.default {
      * @param {string} marker - The marker of the event to unsubscribe from. Example: "product_price_change".
      * @param {number} productId - The ID of the product to unsubscribe from. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<any | IError>} - Returns a promise that resolves to the result of the unsubscription operation or an error object if there was an issue.
+     * @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.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.

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

@@ -62,7 +62,7 @@ export default class FileUploadingApi extends AsyncModules implements IFileUploa
      * @param {string} [fileQuery.entity] - Entity name from which the file is uploaded, determines the folder name in the storage. Example: "editor".
      * @param {number} [fileQuery.id] - Identifier of the object from which the file is uploaded, determines the folder name in the storage. Example: 3787.
      * @param {number} [fileQuery.template] - preview template identifier. Example: 1.
-     * @returns {Promise<boolean | IError>} Returns a promise that resolves to the result of the deletion operation or an error object if there was an issue.
+     * @returns {Promise<boolean | IError>} Returns a promise that resolves to true when the file was deleted or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/file-uploading/delete delete} documentation.
      */

package/dist/file-uploading/fileUploadingApi.js

@@ -116,14 +116,15 @@ class FileUploadingApi extends asyncModules_1.default {
      * @param {string} [fileQuery.entity] - Entity name from which the file is uploaded, determines the folder name in the storage. Example: "editor".
      * @param {number} [fileQuery.id] - Identifier of the object from which the file is uploaded, determines the folder name in the storage. Example: 3787.
      * @param {number} [fileQuery.template] - preview template identifier. Example: 1.
-     * @returns {Promise<boolean | IError>} Returns a promise that resolves to the result of the deletion operation or an error object if there was an issue.
+     * @returns {Promise<boolean | IError>} Returns a promise that resolves to true when the file was deleted or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/file-uploading/delete delete} documentation.
      */
     async delete(filename, fileQuery) {
         const query = { ...this._defaultQuery, ...fileQuery };
-        const result = await this._fetchDelete(`?filename=${filename}&` + this._queryParamsToString(query));
-        return result;
+        // 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)));
     }
     /**
      * Public search across the content of files attached to records.

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

@@ -55,7 +55,7 @@ interface IFileUploading {
      * @param {string} [fileQuery.entity] - Entity name from which the file is uploaded, determines the folder name in the storage. Example: "editor".
      * @param {number} [fileQuery.id] - Identifier of the object from which the file is uploaded, determines the folder name in the storage. Example: 3787.
      * @param {number} [fileQuery.template] - preview template identifier. Example: 1.
-     * @returns {boolean | IError} Returns a promise that resolves to the result of the deletion operation or an error object if there was an issue.
+     * @returns {boolean | IError} Returns a promise that resolves to true when the file was deleted 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.
      */
     delete(filename: string, fileQuery?: IUploadingQuery): Promise<boolean | IError>;

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

@@ -1,6 +1,6 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
-import type { IError } from '../base/utils';
+import type { IError, IVectorSearchResponse } from '../base/utils';
 import type { IBodyPostFormData, IFormsByMarkerDataEntity, IFormsData, IFormsDataFilter, IFormsDataSearchResponse, IFormsDataVectorSearch, IPostFormResponse, IUpdateFormsData } from './formsDataInterfaces';
 /**
  * Controllers for working with form data
@@ -56,10 +56,34 @@ export default class FormsDataApi extends AsyncModules implements IFormsData {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IPostFormResponse | IError>} Returns an object containing the created form data entry and message.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Field values are typed per field type by {@link FormDataType}. For attached files see {@link IImageValue} (`image`, `groupOfImages`) and {@link IFileValue} (`file`) — the shape the endpoint expects, which is **not** what `FileUploading.upload` returns: that object carries `contentType`, which form data rejects. Passing a `File`/`FileList` as the value is also supported — the SDK uploads it first, then strips `contentType` from the resulting value.
+     * @description Field values are typed per field type by {@link FormDataType}. For attached files see {@link IImageValue} (`image`, `groupOfImages`) and {@link IFileValue} (`file`) — the shape the endpoint expects, which is **not** what `FileUploading.upload` returns: that object carries `contentType`, which form data rejects.
+     *
+     * A file value may be a `File`/`Blob` (a `FileList` too), which the SDK uploads first; the descriptor `FileUploading.upload` returns for a file **already in storage**, which the SDK passes through untouched; or a hand-built {@link IFileValue} / {@link IImageValue}. The three may be mixed in one array. `contentType` is stripped from all of them, and a value of none of these shapes is sent as it came — the endpoint then names the field it cannot read, instead of the SDK throwing before the request.
+     *
+     * The endpoint wants file values in an **array**: a lone descriptor or `IFileValue` answers `400 formData's marker '<marker>' value must be an array`, while a lone `File`/`Blob` works because the upload result is already one.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/postFormsData postFormsData} documentation.
      */
     postFormsData(body: IBodyPostFormData, langCode?: string): Promise<IPostFormResponse | IError>;
+    /**
+     * Tells a file the SDK still has to upload from one already in storage.
+     * @param {unknown} value - One value of a `file` / `image` / `groupOfImages` field.
+     * @returns {boolean} True when the value is a `File` or a `Blob`, which has to be uploaded first.
+     * @description Only a `File` or a `Blob` is uploaded. Anything else — above all the
+     * descriptor `FileUploading.upload` returns for a file already in storage — is sent
+     * as it came: re-uploading it would send the descriptor as the file itself.
+     */
+    private _isUploadable;
+    /**
+     * Removes `contentType` from a file value, which the endpoint does not accept.
+     * @param {T} value - Value of a `file` / `image` / `groupOfImages` field, after the uploads.
+     * @returns {T} The value without `contentType`; entries that carried it are copies, the caller's objects are not modified.
+     * @description `FileUploading.upload` returns `contentType` and form data rejects it,
+     * so it is stripped from an array of values and from a lone value object alike. A value
+     * of any other shape is returned untouched and the endpoint names the field it cannot
+     * read — instead of the library dying on `value.map is not a function` before the
+     * request is made (CMS-990).
+     */
+    private _stripContentType;
     /**
      * Drops the date bounds the endpoint refuses to parse.
      *
@@ -142,10 +166,10 @@ export default class FormsDataApi extends AsyncModules implements IFormsData {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IFormsDataSearchResponse | IError>} Returns an object with an array of found form data records and total count.
+     * @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.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByVectorSearch getFormsDataByVectorSearch} documentation.
      */
-    getFormsDataByVectorSearch(body: IFormsDataVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IFormsDataSearchResponse | IError>;
+    getFormsDataByVectorSearch(body: IFormsDataVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IFormsDataSearchResponse> | IError>;
 }

package/dist/forms-data/formsDataApi.js

@@ -96,7 +96,11 @@ class FormsDataApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IPostFormResponse | IError>} Returns an object containing the created form data entry and message.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Field values are typed per field type by {@link FormDataType}. For attached files see {@link IImageValue} (`image`, `groupOfImages`) and {@link IFileValue} (`file`) — the shape the endpoint expects, which is **not** what `FileUploading.upload` returns: that object carries `contentType`, which form data rejects. Passing a `File`/`FileList` as the value is also supported — the SDK uploads it first, then strips `contentType` from the resulting value.
+     * @description Field values are typed per field type by {@link FormDataType}. For attached files see {@link IImageValue} (`image`, `groupOfImages`) and {@link IFileValue} (`file`) — the shape the endpoint expects, which is **not** what `FileUploading.upload` returns: that object carries `contentType`, which form data rejects.
+     *
+     * A file value may be a `File`/`Blob` (a `FileList` too), which the SDK uploads first; the descriptor `FileUploading.upload` returns for a file **already in storage**, which the SDK passes through untouched; or a hand-built {@link IFileValue} / {@link IImageValue}. The three may be mixed in one array. `contentType` is stripped from all of them, and a value of none of these shapes is sent as it came — the endpoint then names the field it cannot read, instead of the SDK throwing before the request.
+     *
+     * The endpoint wants file values in an **array**: a lone descriptor or `IFileValue` answers `400 formData's marker '<marker>' value must be an array`, while a lone `File`/`Blob` works because the upload result is already one.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/postFormsData postFormsData} documentation.
      */
     async postFormsData(body, langCode = this.state.lang) {
@@ -113,9 +117,12 @@ class FormsDataApi extends asyncModules_1.default {
             // Create an instance of FileUploadingApi with the current state
             const fileUploader = new fileUploadingApi_1.default(this.state);
             // Process each element in formData[langCode] asynchronously
-            formData[langCode] = await Promise.all(formData[langCode].map(async (fd) => {
+            formData[langCode] = await Promise.all(formData[langCode].map(async (field) => {
                 // Check if the type is one of the specified types
-                if (['file', 'image', 'groupOfImages'].includes(fd.type)) {
+                if (['file', 'image', 'groupOfImages'].includes(field.type)) {
+                    // Work on a copy: the caller's field keeps its File and its fileQuery,
+                    // so a reused body sends the same form again (CMS-1071)
+                    const fd = { ...field };
                     // If fileQuery does not exist, we create it and assign it to an object with the following properties:
                     if (!fd.fileQuery) {
                         const fileQuery = {
@@ -132,34 +139,78 @@ class FormsDataApi extends asyncModules_1.default {
                     const filesArray = typeof FileList !== 'undefined' && fd.value instanceof FileList
                         ? Array.from(fd.value)
                         : fd.value;
-                    // If filesArray is an array, upload each file asynchronously
+                    // If filesArray is an array, upload the files it holds asynchronously
                     if (Array.isArray(filesArray)) {
-                        const uploadPromises = filesArray.map((file) => fileUploader.upload(file, fd.fileQuery).catch((e) => e));
+                        const uploadPromises = filesArray.map((file) => 
+                        // An entry that is already in storage is passed through: a
+                        // second upload would send the descriptor itself as the file
+                        // and the endpoint answers `value[0].filename is required`.
+                        this._isUploadable(file)
+                            ? fileUploader.upload(file, fd.fileQuery).catch((e) => e)
+                            : file);
                         fd.value = (await Promise.all(uploadPromises)).flat();
                     }
                     // If fd.value is a single File or Blob, upload it
-                    else if (fd.value instanceof File || fd.value instanceof Blob) {
+                    else if (this._isUploadable(fd.value)) {
                         fd.value = await fileUploader
                             .upload(fd.value, fd.fileQuery)
                             .catch((e) => e); // Catch any errors during upload
                     }
                     // Remove the 'fileQuery' property from the object after processing
                     delete fd.fileQuery;
-                    // Remove  the 'contentType' property from the file object because it is not needed and not valid
-                    fd.value.map((file) => {
-                        delete file.contentType;
-                    });
+                    // Remove the 'contentType' property from the file object because it is not needed and not valid
+                    fd.value = this._stripContentType(fd.value);
+                    return fd;
                 }
-                // Return the processed form data element
-                return fd;
+                // Return the form data element untouched
+                return field;
             }));
         }
-        body.formData = formData;
-        const result = await this._fetchPost(``, body);
+        // 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);
     }
+    /**
+     * Tells a file the SDK still has to upload from one already in storage.
+     * @param {unknown} value - One value of a `file` / `image` / `groupOfImages` field.
+     * @returns {boolean} True when the value is a `File` or a `Blob`, which has to be uploaded first.
+     * @description Only a `File` or a `Blob` is uploaded. Anything else — above all the
+     * descriptor `FileUploading.upload` returns for a file already in storage — is sent
+     * as it came: re-uploading it would send the descriptor as the file itself.
+     */
+    _isUploadable(value) {
+        return ((typeof File !== 'undefined' && value instanceof File) ||
+            (typeof Blob !== 'undefined' && value instanceof Blob));
+    }
+    /**
+     * Removes `contentType` from a file value, which the endpoint does not accept.
+     * @param {T} value - Value of a `file` / `image` / `groupOfImages` field, after the uploads.
+     * @returns {T} The value without `contentType`; entries that carried it are copies, the caller's objects are not modified.
+     * @description `FileUploading.upload` returns `contentType` and form data rejects it,
+     * so it is stripped from an array of values and from a lone value object alike. A value
+     * of any other shape is returned untouched and the endpoint names the field it cannot
+     * read — instead of the library dying on `value.map is not a function` before the
+     * request is made (CMS-990).
+     */
+    _stripContentType(value) {
+        // An entry carrying `contentType` is copied without it rather than edited:
+        // a descriptor passed through untouched belongs to the caller (CMS-1071)
+        const strip = (item) => {
+            if (item &&
+                typeof item === 'object' &&
+                !Array.isArray(item) &&
+                'contentType' in item) {
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                const { contentType, ...rest } = item;
+                return rest;
+            }
+            return item;
+        };
+        return (Array.isArray(value) ? value.map(strip) : strip(value));
+    }
     /**
      * Drops the date bounds the endpoint refuses to parse.
      *
@@ -265,7 +316,7 @@ class FormsDataApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IFormsDataSearchResponse | IError>} Returns an object with an array of found form data records and total count.
+     * @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.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByVectorSearch getFormsDataByVectorSearch} documentation.

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

@@ -1,5 +1,5 @@
-import type { IError } from '../base/utils';
-import type { IUploadingQuery } from '../file-uploading/fileUploadingInterfaces';
+import type { IError, IVectorSearchResponse } from '../base/utils';
+import type { IUploadingQuery, IUploadingReturn } from '../file-uploading/fileUploadingInterfaces';
 /**
  * Interface for retrieving and posting form data in the system.
  * @interface IFormsData
@@ -77,10 +77,10 @@ interface IFormsData {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IFormsDataSearchResponse | IError>} Returns an object with an array of found form data records and total count.
+     * @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
      */
-    getFormsDataByVectorSearch(body: IFormsDataVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IFormsDataSearchResponse | IError>;
+    getFormsDataByVectorSearch(body: IFormsDataVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IFormsDataSearchResponse> | IError>;
 }
 /**
  * Body for semantic (vector) form data search.
@@ -567,7 +567,7 @@ interface ICaptchaValue {
  * @property {string} formData[].marker - The marker identifying the form field. Example: "name".
  * @property {string} formData[].type - The type of the form field. Example: "string".
  * @property {string} formData[].value - The value of the form field. Example: "name".
- * @property {IUploadingQuery} [fileQuery] - Optional file query for uploading files.
+ * @property {IUploadingQuery} [fileQuery] - Optional file query for uploading files. Kept for compatibility: the SDK reads `fileQuery` from the **file field itself** (see IBodyTypeFile), not from the body, so one set here does not change where a file is uploaded.
  * @example
     {
       "type": "page",
@@ -715,7 +715,7 @@ interface ITextWithHeaderValue {
  * @interface IBodyTypeImageGroupOfImages
  * @property {string} marker - marker name. Example: "avatar".
  * @property {'image' | 'groupOfImages'} type - Type value — must match the attribute type in the set, note the plural in "groupOfImages". Example: "image".
- * @property {object} value - Image Object. Contains image information.
+ * @property {object} value - The attached image. The same three shapes as a `file` field accepts, mixable in one array: a `File`/`Blob` (also a `FileList`), which the SDK uploads first; the descriptor `FileUploading.upload` returns for an image **already in storage**, passed through as it is; or a hand-built {@link IImageValue}. In a SUBMISSION the value must be an **array**, as for `file` — a lone object answers `400 formData's marker '<marker>' value must be an array`. Measured on js-sdk-tests.oneentry.cloud, 2026-10-08 (CMS-990).
  * @example
     [
       {
@@ -728,12 +728,14 @@ interface ITextWithHeaderValue {
         }
       }
     ]
+ * @property {IUploadingQuery} [fileQuery] - Where the SDK uploads a `File`/`Blob` value to. Read **per field**, not from the body; omitted, the SDK uploads to `page`/`editor` under a random id. Ignored for an image already in storage. Example: `{ "type": "page", "entity": "editor", "id": 3787 }`.
  * @description Represents an image or a group of images with their details, including filename, download link, size, preview link, and parameters for image compression.
  */
 interface IBodyTypeImageGroupOfImages {
     marker: string;
     type: 'image' | 'groupOfImages';
-    value: IImageValue | IImageValue[];
+    value: IImageValue | IUploadingReturn | File | Blob | (IImageValue | IUploadingReturn | File | Blob)[];
+    fileQuery?: IUploadingQuery;
 }
 /**
  * @interface IImageValueParams
@@ -764,7 +766,7 @@ interface IImageValue {
  * @interface IBodyTypeFile
  * @property {string} marker - marker name. Example: "picture".
  * @property {'file'} type - Type value. Example: "file".
- * @property {object} value - File Object. Contains file information. A single attached file is returned as the object itself, several files as an array.
+ * @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. Measured on js-sdk-tests.oneentry.cloud, 2026-10-08 (CMS-990).
  * @example
     [
       {
@@ -773,12 +775,14 @@ interface IImageValue {
         "size": 392585
       }
     ]
+ * @property {IUploadingQuery} [fileQuery] - Where the SDK uploads a `File`/`Blob` value to. Read **per field**, not from the body; omitted, the SDK uploads to `page`/`editor` under a random id. Ignored for a file already in storage. Example: `{ "type": "page", "entity": "editor", "id": 3787 }`.
  * @description Represents a file with its details, including filename, download link, and size.
  */
 interface IBodyTypeFile {
     marker: string;
     type: 'file';
-    value: IFileValue | IFileValue[];
+    value: IFileValue | IUploadingReturn | File | Blob | (IFileValue | IUploadingReturn | File | Blob)[];
+    fileQuery?: IUploadingQuery;
 }
 /**
  * @interface IFileValue