oneentry 1.0.152 → 1.0.154

package/changelog.md

@@ -1,5 +1,54 @@
 # SDK Change Log
 
+## v.1.0.154
+
+### What's New
+
+- Products > per-method query types — the single `IProductsQuery` is split into focused query types so each method only accepts the parameters it actually supports:
+  - `IProductsQueryBase` — base query (`offset`, `limit`, `sortOrder`, `sortKey`, `signPrice`) used by `getProducts`, `getProductsEmptyPage`, `getProductsByPageId`, `getProductsByPageUrl`.
+  - `IProductsRelatedQuery` — base query plus `statusMarker` and `templateMarker`, used by `getRelatedProductsById`.
+  - `IProductsPriceQuery` — base query without `sortKey`, plus `statusMarker`, used by `getProductsPriceByPageUrl`.
+  - `IProductsByIdsQuery` — only `signPrice` (`ids` is a dedicated method argument), used by `getProductsByIds`.
+  - All four types are now exported.
+
+- Orders > `IOrderProductData.signedPrice` — new optional `signedPrice` (`string`) field: the signed (fixed) product price obtained together with the product data when `signPrice` is set. Used to carry the fixed price into an order line item.
+
+- Products > `IProductInfo.signedPrice` — new optional `signedPrice` (`string`) field on the price-list items returned by `getProductsPriceByPageUrl`; populated with the signed (fixed) price when `signPrice` is set (mirrors `IProductsEntity.signedPrice`).
+
+### What's Changed
+
+- Products > `getProducts`, `getProductsEmptyPage`, `getProductsByPageId`, `getProductsByPageUrl`, `getProductsPriceByPageUrl`, `getRelatedProductsById`, `getProductsByIds` — `userQuery` is now typed with the corresponding per-method query type above instead of the broad `IProductsQuery`. `IProductsQuery` is retained as a **deprecated** alias of `IProductsQueryBase` for backward compatibility.
+
+- Products > `getProductsByIds` — now accepts only `signPrice` in `userQuery` (`IProductsByIdsQuery`); `limit`/`sort`/filter markers are no longer query parameters of this endpoint. As a result `searchProduct` (quick search) no longer forwards an explicit `limit` to the internal `/ids` request.
+
+- Products / Blocks / Orders — JSDoc for `signPrice` / `signedPrice` clarified ("Order storage marker for price fixing…") with links to the "Fixing the price" / "Fixed product price" documentation. Orders > `previewOrder` description cleaned up (removed the stray `???`). No structural change.
+
+- HTTP core — the legacy Node.js `< 18` request path was removed. The SDK previously detected old Node versions and routed requests through a dynamically imported `https` module (`_NO_FETCH` / `state._https`); that branch did **not** perform token refresh, response validation, `errorsFunctions` callbacks or `isShell` handling, so behavior silently degraded on old Node. All requests now go through the native `fetch` path (browser and Node 18+), which collapses four duplicated `_fetchGet` / `_fetchPost` / `_fetchPut` / `_fetchDelete` implementations into one and gives every environment the same auth/validation/error behavior. **The SDK now requires Node 18+** (declared via `engines.node >= 18`).
+
+### Bug Fixes
+
+- Query parameters and free-text search are now URL-encoded (`encodeURIComponent`). Previously values containing spaces, `&`, `=` or non-ASCII characters corrupted the query string — most visibly in the text search of `Products.searchProduct`, `Pages.searchPage` and `Blocks.searchBlock`.
+- `Pages.searchPage` — fixed the `url` query part: when no `url` was passed the request string previously contained stray output (`undefined` / a leading `&`). It is now built correctly and omitted when absent.
+- Auth — the `401 → refresh → retry` path now flows through the same response handling as the initial request. The retried response is checked for `ok`, tolerates an empty body, and runs `errorsFunctions` / honors `isShell`. Previously a failed retry returned the raw error body as if it were successful data, and an empty retry body could throw from `.json()`.
+
+- `defineOneEntry` — initializing the SDK without a project URL or app token no longer crashes with a cryptic `TypeError: Cannot read properties of undefined (reading 'endsWith')`. The function now validates its inputs up front and throws a clear, actionable error instead: a missing/empty `url` (PROJECT_URL) and a missing/empty `config.token` (APP_TOKEN) each produce a descriptive message with a correct usage example. Empty / whitespace-only values (e.g. an unfilled `.env` variable) are treated as missing.
+
+### What's Deleted
+
+- Removed the unused `src/base/result.ts` (dead `Result` class — never imported, and containing a misplaced `await` and unreachable branches).
+
+## v.1.0.153
+
+### What's New
+
+- Pages > `IPositionBlock` — new optional `similarProducts` (`IProductsResponse`) and `products` (`IProductsEntity[]`) fields, populated for `similar_products_block` / `product_block` page blocks (when traffic-saving mode is off).
+
+### Bug Fixes
+
+- Pages > `getBlocksByPageUrl` — related products are now actually loaded for `product_block` (`products`) and `similar_products_block` (`similarProducts`) blocks. The block-type check ran against the response array instead of each block, so product loading never executed; it now runs per block. `similarProducts` is returned as the full `{ total, items }` response, consistent with `Blocks` block enrichment.
+
+- Orders > `getRefunds`, `createRefundRequest`, `cancelRefundRequest` — the base URL is now restored even if the refund request throws (wrapped in `try/finally`). Previously an exception left `_url` switched to `/orders`, which could misroute subsequent calls on the same instance.
+
 ## v.1.0.152
 
 ### Bug Fixes

package/dist/admins/adminsApi.d.ts

@@ -40,12 +40,13 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
         ]
      * @param {string} [body.attributeMarker] - Text identifier (marker) of the attribute in the set. Example: "num".
      * @param {string} [body.conditionMarker] - Text identifier (marker) of the condition in the set. Example: "mth".
-     * @param {string} [body.conditionValue] - Value of the condition. Example: 1.
+     * @param {number | string | null} [body.conditionValue] - Value of the condition. Example: "new".
      * @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<IAdminEntity[] | IError>} Returns an array of admin objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsInfo getAdminsInfo} documentation.
      */
     getAdminsInfo(body?: IFilterParams[], langCode?: string, offset?: number, limit?: number): Promise<IAdminEntity[] | IError>;
 }

package/dist/admins/adminsApi.js

@@ -43,12 +43,13 @@ class AdminsApi extends asyncModules_1.default {
         ]
      * @param {string} [body.attributeMarker] - Text identifier (marker) of the attribute in the set. Example: "num".
      * @param {string} [body.conditionMarker] - Text identifier (marker) of the condition in the set. Example: "mth".
-     * @param {string} [body.conditionValue] - Value of the condition. Example: 1.
+     * @param {number | string | null} [body.conditionValue] - Value of the condition. Example: "new".
      * @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<IAdminEntity[] | IError>} Returns an array of admin objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsInfo getAdminsInfo} documentation.
      */
     async getAdminsInfo(body = [], langCode = this.state.lang, offset = 0, limit = 30) {
         const query = {

package/dist/admins/adminsInterfaces.d.ts

@@ -25,7 +25,7 @@ interface IAdmins {
         ]
      * @param {string} [body.attributeMarker] - Text identifier (marker) of the attribute in the set. Example: "num".
      * @param {string} [body.conditionMarker] - Text identifier (marker) of the condition in the set. Example: "mth".
-     * @param {string} [body.conditionValue] - Value of the condition. Example: 1.
+     * @param {number | string | null} [body.conditionValue] - Value of the condition. Example: "new".
      * @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/attribute-sets/attributeSetsApi.d.ts

@@ -30,6 +30,7 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @param {string} [sortBy] - identifier of the attribute set type. Default: "id".
      * @returns {Promise<IAttributesSetsResponse | IError>} Returns object with array of IAttributeSetsEntity and total items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributes getAttributes} documentation.
      */
     getAttributes(langCode?: string, offset?: number, limit?: number, typeId?: any, sortBy?: string): Promise<IAttributesSetsResponse | IError>;
     /**
@@ -39,6 +40,7 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IAttributeSetsEntity[] | IError>} Returns an array of Attributes objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributesByMarker getAttributesByMarker} documentation.
      */
     getAttributesByMarker(marker: string, langCode?: string): Promise<IAttributeSetsEntity[] | IError>;
     /**
@@ -49,6 +51,7 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IAttributesSetsEntity | IError>} Returns a single attribute object from the attribute set.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getSingleAttributeByMarkerSet getSingleAttributeByMarkerSet} documentation.
      */
     getSingleAttributeByMarkerSet(setMarker: string, attributeMarker: string, langCode?: string): Promise<IAttributesSetsEntity | IError>;
     /**
@@ -58,6 +61,7 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IAttributeSetsEntity | IError>} Returns one object of the attribute set.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributeSetByMarker getAttributeSetByMarker} documentation.
      */
     getAttributeSetByMarker(marker: string, langCode?: string): Promise<IAttributeSetsEntity | IError>;
 }

package/dist/attribute-sets/attributeSetsApi.js

@@ -34,6 +34,7 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @param {string} [sortBy] - identifier of the attribute set type. Default: "id".
      * @returns {Promise<IAttributesSetsResponse | IError>} Returns object with array of IAttributeSetsEntity and total items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributes getAttributes} documentation.
      */
     async getAttributes(langCode = this.state.lang, offset = 0, limit = 30, 
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -58,6 +59,7 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IAttributeSetsEntity[] | IError>} Returns an array of Attributes objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributesByMarker getAttributesByMarker} documentation.
      */
     async getAttributesByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/${marker}/attributes?langCode=${langCode}`);
@@ -73,6 +75,7 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IAttributesSetsEntity | IError>} Returns a single attribute object from the attribute set.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getSingleAttributeByMarkerSet getSingleAttributeByMarkerSet} documentation.
      */
     async getSingleAttributeByMarkerSet(setMarker, attributeMarker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/${setMarker}/attributes/${attributeMarker}?langCode=${langCode}`);
@@ -87,6 +90,7 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IAttributeSetsEntity | IError>} Returns one object of the attribute set.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributeSetByMarker getAttributeSetByMarker} documentation.
      */
     async getAttributeSetByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);

package/dist/auth-provider/authProviderApi.d.ts

@@ -82,6 +82,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<ISignUpEntity | IError>} Returns a user object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User registration (❗️For a provider with user activation, the activation code is sent through the corresponding user notification method).
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/signUp signUp} documentation.
      */
     signUp(marker: string, body: ISignUpData, langCode?: string): Promise<ISignUpEntity | IError>;
     /**
@@ -93,6 +94,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<void | IError>} Returns void if the code is successfully generated, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Obtaining a code to activate the user.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/generateCode generateCode} documentation.
      */
     generateCode(marker: string, userIdentifier: string, eventIdentifier: string): Promise<void | IError>;
     /**
@@ -105,6 +107,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<boolean | IError>} Returns true if the code is correct, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Checking the user activation code
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/checkCode checkCode} documentation.
      */
     checkCode(marker: string, userIdentifier: string, eventIdentifier: string, code: string): Promise<boolean | IError>;
     /**
@@ -116,6 +119,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<boolean | IError>} Returns true if the user was successfully activated, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User activation.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/activateUser activateUser} documentation.
      */
     activateUser(marker: string, userIdentifier: string, code: string): Promise<boolean | IError>;
     /**
@@ -149,6 +153,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<IAuthEntity | IError>} Returns an auth entity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User authorization.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/auth auth} documentation.
      */
     auth(marker: string, body: IAuthPostBody): Promise<IAuthEntity | IError>;
     /**
@@ -159,6 +164,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<IAuthEntity | IError>} Returns an auth entity object with the following values: accessToken, refreshToken, user, and other auth-related data.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User token refresh.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/refresh refresh} documentation.
      */
     refresh(marker: string, token: string): Promise<IAuthEntity | IError>;
     /**
@@ -170,6 +176,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @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}.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/logout logout} documentation.
      */
     logout(marker: string, token: string): Promise<boolean | IError>;
     /**
@@ -180,6 +187,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @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}.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/logoutAll logoutAll} documentation.
      */
     logoutAll(marker: string): Promise<boolean | IError>;
     /**
@@ -188,13 +196,14 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} userIdentifier - The text identifier of the user's object (user login). Example: "example@oneentry.cloud".
      * @param {string} eventIdentifier - The text identifier of the event. Example: "reg".
-     * @param {string} type - Operation type (1 - for changing password, 2 - for recovery). Example: 1.
+     * @param {number} type - Operation type (1 - for changing password, 2 - for recovery). Example: 1.
      * @param {string} code - Service code. Example: "123456".
      * @param {string} newPassword - New password. Example: "newPassword123".
      * @param {string} [repeatPassword] - Optional variable contains repeat new password for validation. Example: "newPassword123".
      * @returns {Promise<boolean | IError>} Returns true if the password was successfully changed, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User password change (only for tariffs with account activation and the Activation feature enabled).
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/changePassword changePassword} documentation.
      */
     changePassword(marker: string, userIdentifier: string, eventIdentifier: string, type: number, code: string, newPassword: string, repeatPassword?: string): Promise<boolean | IError>;
     /**
@@ -206,6 +215,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<IAuthProvidersEntity[] | IError>} Returns an array of auth provider objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting all objects of authorization providers.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getAuthProviders getAuthProviders} documentation.
      */
     getAuthProviders(langCode?: string, offset?: number, limit?: number): Promise<IAuthProvidersEntity[] | IError>;
     /**
@@ -216,6 +226,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<IAuthProvidersEntity | IError>} Returns an auth provider object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a single authorization provider object by marker.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getAuthProviderByMarker getAuthProviderByMarker} documentation.
      */
     getAuthProviderByMarker(marker: string, langCode?: string): Promise<IAuthProvidersEntity | IError>;
     /**
@@ -225,6 +236,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<IActiveSession[] | IError>} Returns an auth provider object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a single authorization provider object by marker.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getActiveSessionsByMarker getActiveSessionsByMarker} documentation.
      */
     getActiveSessionsByMarker(marker: string): Promise<IActiveSession[] | IError>;
     /**
@@ -244,6 +256,7 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @returns {Promise<ISignUpEntity | IError>} Returns a user object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User registration (authorization) via OAUTH.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/oauth oauth} documentation.
      */
     oauth(marker: string, body: IOauthData, langCode?: string): Promise<IAuthEntity | IError>;
 }

package/dist/auth-provider/authProviderApi.js

@@ -87,6 +87,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<ISignUpEntity | IError>} Returns a user object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User registration (❗️For a provider with user activation, the activation code is sent through the corresponding user notification method).
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/signUp signUp} documentation.
      */
     async signUp(marker, body, langCode = this.state.lang) {
         body['langCode'] = langCode;
@@ -104,6 +105,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<void | IError>} Returns void if the code is successfully generated, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Obtaining a code to activate the user.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/generateCode generateCode} documentation.
      */
     async generateCode(marker, userIdentifier, eventIdentifier) {
         const data = {
@@ -123,6 +125,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<boolean | IError>} Returns true if the code is correct, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Checking the user activation code
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/checkCode checkCode} documentation.
      */
     async checkCode(marker, userIdentifier, eventIdentifier, code) {
         const data = {
@@ -142,6 +145,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<boolean | IError>} Returns true if the user was successfully activated, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User activation.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/activateUser activateUser} documentation.
      */
     async activateUser(marker, userIdentifier, code) {
         const data = {
@@ -182,6 +186,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<IAuthEntity | IError>} Returns an auth entity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User authorization.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/auth auth} documentation.
      */
     async auth(marker, body) {
         const result = await this._fetchPost(`/marker/${marker}/users/auth`, body);
@@ -204,6 +209,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<IAuthEntity | IError>} Returns an auth entity object with the following values: accessToken, refreshToken, user, and other auth-related data.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User token refresh.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/refresh refresh} documentation.
      */
     async refresh(marker, token) {
         const data = { refreshToken: token };
@@ -226,6 +232,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @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}.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/logout logout} documentation.
      */
     async logout(marker, token) {
         const data = {
@@ -249,6 +256,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @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}.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/logoutAll logoutAll} documentation.
      */
     async logoutAll(marker) {
         const result = await this._fetchPost(`/marker/${marker}/users/logout-all`);
@@ -267,13 +275,14 @@ class AuthProviderApi extends asyncModules_1.default {
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} userIdentifier - The text identifier of the user's object (user login). Example: "example@oneentry.cloud".
      * @param {string} eventIdentifier - The text identifier of the event. Example: "reg".
-     * @param {string} type - Operation type (1 - for changing password, 2 - for recovery). Example: 1.
+     * @param {number} type - Operation type (1 - for changing password, 2 - for recovery). Example: 1.
      * @param {string} code - Service code. Example: "123456".
      * @param {string} newPassword - New password. Example: "newPassword123".
      * @param {string} [repeatPassword] - Optional variable contains repeat new password for validation. Example: "newPassword123".
      * @returns {Promise<boolean | IError>} Returns true if the password was successfully changed, or an error object if there was an issue.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User password change (only for tariffs with account activation and the Activation feature enabled).
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/changePassword changePassword} documentation.
      */
     async changePassword(marker, userIdentifier, eventIdentifier, type, code, newPassword, repeatPassword) {
         const data = {
@@ -296,6 +305,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<IAuthProvidersEntity[] | IError>} Returns an array of auth provider objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting all objects of authorization providers.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getAuthProviders getAuthProviders} documentation.
      */
     async getAuthProviders(langCode = this.state.lang, offset = 0, limit = 30) {
         const result = await this._fetchGet(`?langCode=${langCode}&offset=${offset}&limit=${limit}`);
@@ -311,6 +321,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<IAuthProvidersEntity | IError>} Returns an auth provider object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a single authorization provider object by marker.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getAuthProviderByMarker getAuthProviderByMarker} documentation.
      */
     async getAuthProviderByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
@@ -323,6 +334,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<IActiveSession[] | IError>} Returns an auth provider object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a single authorization provider object by marker.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getActiveSessionsByMarker getActiveSessionsByMarker} documentation.
      */
     async getActiveSessionsByMarker(marker) {
         const result = await this._fetchGet(`/marker/${marker}/users/sessions`);
@@ -345,6 +357,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @returns {Promise<ISignUpEntity | IError>} Returns a user object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User registration (authorization) via OAUTH.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/oauth oauth} documentation.
      */
     async oauth(marker, body, langCode = this.state.lang) {
         const result = await this._fetchPost(`/marker/${marker}/oauth`, this._normalizePostBody(body, langCode));

package/dist/base/asyncModules.d.ts

@@ -8,8 +8,6 @@ import type { IError } from './utils';
  */
 export default abstract class AsyncModules extends SyncModules {
     protected state: StateModule;
-    protected _NO_FETCH: boolean;
-    protected _https: any;
     protected _url: string;
     /**
      * Constructor initializes the AsyncModules with a given state.
@@ -56,6 +54,17 @@ export default abstract class AsyncModules extends SyncModules {
      * @description Define a protected asynchronous method '_fetchDelete' that performs a DELETE request
      */
     protected _fetchDelete<T = unknown>(path: string, body?: unknown): Promise<T>;
+    /**
+     * Wraps a fetch call whose only meaningful outcome is success or failure.
+     *
+     * Several endpoints (cancel/recover subscription, subscribe/unsubscribe to
+     * events) return no useful body — callers only care whether the request
+     * succeeded. This helper resolves to `true` on success and to the caught
+     * error (as IError) on failure, centralizing the repeated try/catch.
+     * @param {() => Promise<unknown>} request - Thunk performing the fetch call.
+     * @returns {Promise<boolean | IError>} `true` on success, IError on failure.
+     */
+    protected _fetchBoolean(request: () => Promise<unknown>): Promise<boolean | IError>;
     /**
      * Refreshes the authentication token (single-flight).
      * @returns {Promise<boolean>} A promise resolving to a boolean indicating success or failure.
@@ -75,6 +84,16 @@ export default abstract class AsyncModules extends SyncModules {
      * @returns {IHttpOptions} An object representing the request options.
      */
     private makeOptions;
+    /**
+     * Reads a response body as JSON, tolerating an empty body.
+     *
+     * `Response.json()` throws on an empty body (e.g. 204 or an empty error
+     * payload); this helper mirrors the OK-path guard (`text ? JSON.parse : {}`)
+     * so both the success and the error branches handle empty bodies the same way.
+     * @param {Response} response - The fetch Response to read.
+     * @returns {Promise<unknown>} Parsed JSON, or an empty object when the body is empty/unparsable.
+     */
+    private _parseJson;
     /**
      * Handles responses from the browser's fetch API.
      * @param {string} path - The path to append to the base URL.