oneentry 1.0.152 → 1.0.153

package/changelog.md

@@ -1,5 +1,17 @@
 # SDK Change Log
 
+## 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

@@ -56,6 +56,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.

package/dist/base/asyncModules.js

@@ -281,6 +281,25 @@ class AsyncModules extends syncModules_1.default {
             });
         }
     }
+    /**
+     * 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.
+     */
+    async _fetchBoolean(request) {
+        try {
+            await request();
+            return true;
+        }
+        catch (e) {
+            return e;
+        }
+    }
     /**
      * Refreshes the authentication token (single-flight).
      * @returns {Promise<boolean>} A promise resolving to a boolean indicating success or failure.

package/dist/blocks/blocksApi.d.ts

@@ -27,6 +27,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {number} [limit] - Parameter for pagination. Default: 30.
      * @returns {Promise<IBlocksResponse | IError>} Returns BlocksEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getBlocks getBlocks} documentation.
      */
     getBlocks(type?: BlockType, langCode?: string, offset?: number, limit?: number): Promise<IBlocksResponse | IError>;
     /**
@@ -39,8 +40,25 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @returns {Promise<IBlockEntity | IError>} - Returns a BlockEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method retrieves a block by its marker and includes additional information such as similar products or products associated with the block.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getBlockByMarker getBlockByMarker} documentation.
      */
     getBlockByMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IBlockEntity | IError>;
+    /**
+     * Enrich a single block in place.
+     *
+     * Lifts product display settings from `customSettings.productConfig` to
+     * numeric top-level fields, strips internal-only fields, and — when
+     * `loadProducts` is true — fetches the related products for
+     * `similar_products_block` / `product_block` blocks. Shared by `getBlocks`
+     * (array) and `getBlockByMarker` (single block). Mutates `block` in place.
+     * @param {any} block - Normalized block to enrich (mutated in place).
+     * @param {string} langCode - Language code passed to product sub-requests.
+     * @param {number} offset - Pagination offset for product sub-requests.
+     * @param {number} limit - Pagination limit for product sub-requests.
+     * @param {boolean} loadProducts - Whether to fetch related products.
+     * @returns {Promise<void>} Resolves when enrichment (incl. sub-requests) is done.
+     */
+    private _enrichBlock;
     /**
      * Get similar products by block marker.
      * @handleName getSimilarProducts
@@ -50,8 +68,9 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {number} [limit] - Parameter for pagination. Default: 30.
      * @param {string} [signPrice] - Sign price.
      * @param {number} [productId] - Optional product id to find similar products for.
-     * @returns {Promise<IProductsResponse | IError>} - Returns the total count and an array of product items in object by specified block marker.
+     * @returns {Promise<IProductsResponse | IError>} Returns the total count and an array of product items in object by specified block marker.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getSimilarProducts getSimilarProducts} documentation.
      */
     private getSimilarProducts;
     /**
@@ -64,6 +83,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [signPrice] - Sign price.
      * @returns {Promise<IProductsEntity[] | IError>} Return array of BlocksEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getProductsByBlockMarker getProductsByBlockMarker} documentation.
      */
     private getProductsByBlockMarker;
     /**
@@ -75,6 +95,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [signPrice] - Sign price.
      * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getFrequentlyOrderedProducts getFrequentlyOrderedProducts} documentation.
      */
     getFrequentlyOrderedProducts(productId: number, marker: string, langCode?: string, signPrice?: string): Promise<IProductsResponse | IError>;
     /**
@@ -84,6 +105,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<ISearchBlock[] | IError>} Returns an array of ISearchBlock objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/searchBlock searchBlock} documentation.
      */
     searchBlock(name: string, langCode?: string): Promise<ISearchBlock[] | IError>;
     /**
@@ -94,6 +116,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [signPrice] - Sign price.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplement getCartComplement} documentation.
      */
     getCartComplement(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -108,6 +131,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
         }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplementByProductIds getCartComplementByProductIds} documentation.
      */
     getCartComplementByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
     /**
@@ -118,6 +142,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [signPrice] - Sign price.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilar getCartSimilar} documentation.
      */
     getCartSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -132,6 +157,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
         }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilarByProductIds getCartSimilarByProductIds} documentation.
      */
     getCartSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
     /**
@@ -142,6 +168,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [signPrice] - Sign price.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getPersonalRecommendations getPersonalRecommendations} documentation.
      */
     getPersonalRecommendations(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -152,6 +179,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [signPrice] - Sign price.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRecentlyViewed getRecentlyViewed} documentation.
      */
     getRecentlyViewed(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -162,6 +190,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [signPrice] - Sign price.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRepeatPurchase getRepeatPurchase} documentation.
      */
     getRepeatPurchase(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -170,6 +199,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} marker - Block marker. Example: "slider_block".
      * @returns {Promise<IBlockSlidesResponse | IError>} Returns the slides response.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getSlides getSlides} documentation.
      */
     getSlides(marker: string): Promise<IBlockSlidesResponse | IError>;
     /**
@@ -180,6 +210,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [signPrice] - Sign price.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getTrending getTrending} documentation.
      */
     getTrending(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -190,6 +221,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [signPrice] - Sign price.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilar getWishlistSimilar} documentation.
      */
     getWishlistSimilar(marker: string, langCode?: string, signPrice?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -204,6 +236,7 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
         }
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilarByProductIds getWishlistSimilarByProductIds} documentation.
      */
     getWishlistSimilarByProductIds(marker: string, body: IBlockProductsLookup): Promise<IProductsEntity[] | IError>;
 }