oneentry 1.0.176 → 1.0.177

package/esm/pages/pagesApi.js

@@ -30,11 +30,11 @@ export default class PagesApi extends AsyncModules {
      */
     async getRootPages(langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve root pages for the specified language code
-        const data = await this._fetchGet(`/root?langCode=${langCode}`);
+        const data = await this._fetchGet(`/root?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PagesResponseSchema'));
         // Add template information to each page in the fetched root pages data
-        const withTemplate = await this.addTemplateToPages(validated);
+        const withTemplate = await this.addTemplateToPages(validated, langCode);
         // Normalize the data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
@@ -49,11 +49,11 @@ export default class PagesApi extends AsyncModules {
      */
     async getPages(langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve all pages for the specified language code
-        const data = await this._fetchGet(`?langCode=${langCode}`);
+        const data = await this._fetchGet(`?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PagesResponseSchema'));
         // Add template information to each page in the fetched data
-        const withTemplate = await this.addTemplateToPages(validated);
+        const withTemplate = await this.addTemplateToPages(validated, langCode);
         // Normalize the data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
@@ -69,11 +69,11 @@ export default class PagesApi extends AsyncModules {
      */
     async getPageById(id, langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve page details by ID and language code
-        const data = await this._fetchGet(`/${id}?langCode=${langCode}`);
+        const data = await this._fetchGet(`/${this._pathSegment(String(id))}?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PageEntitySchema'));
         // Add template information to the fetched page data
-        const withTemplate = await this.addTemplateToPage(validated);
+        const withTemplate = await this.addTemplateToPage(validated, langCode);
         // Normalize the data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
@@ -89,31 +89,31 @@ export default class PagesApi extends AsyncModules {
      */
     async getPageByUrl(url, langCode = this.state.lang) {
         // Fetch data from the server using a GET request with the specified URL and language code
-        const data = await this._fetchGet(`/url/${url}?langCode=${langCode}`);
+        const data = await this._fetchGet(`/url/${this._pathSegments(url)}?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PageEntitySchema'));
         // Add template information to the fetched page data
-        const withTemplate = await this.addTemplateToPage(validated);
+        const withTemplate = await this.addTemplateToPage(validated, langCode);
         // Normalize the result data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
     /**
      * Get child pages object with information as an array.
      * @handleName getChildPagesByParentUrl
-     * @param {string} url - URL of the parent page whose child pages to fetch. Example: "about/our-team".
+     * @param {string} url - URL of the parent page whose child pages to fetch — the page's own `pageUrl`, not a nested path: `blog/blog1` answers `404`. Example: "blog".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IPagesEntity | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data) for the selected parent
+     * @returns {Promise<IPagesEntity[] | IError>} Returns an array of PageEntity objects for the selected parent, or an empty array [] when it has no child pages. A parent page that does not exist answers `404 Parent page not found` (IError).
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get child pages object with information as an array.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getChildPagesByParentUrl getChildPagesByParentUrl} documentation.
      */
     async getChildPagesByParentUrl(url, langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve child pages for the specified parent URL and language code
-        const data = await this._fetchGet(`/${url}/children?langCode=${langCode}`);
+        const data = await this._fetchGet(`/${this._pathSegments(url)}/children?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PagesResponseSchema'));
         // Add template information to each of the fetched child pages
-        const withTemplate = await this.addTemplateToPages(validated);
+        const withTemplate = await this.addTemplateToPages(validated, langCode);
         // Normalize the result data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
@@ -128,9 +128,9 @@ export default class PagesApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getBlocksByPageUrl getBlocksByPageUrl} documentation.
      */
     async getBlocksByPageUrl(url, langCode = this.state.lang) {
-        const response = await this._fetchGet(`/${url}/blocks?langCode=${langCode}`);
-        // Normalize the fetched response data
-        const normalizeResponse = this._normalizeData(response);
+        const response = await this._fetchGet(`/${this._pathSegments(url)}/blocks?langCode=${encodeURIComponent(langCode)}`);
+        // Normalize by the language of the call, not by the client's one
+        const normalizeResponse = this._normalizeData(response, langCode);
         if (!Array.isArray(normalizeResponse)) {
             return normalizeResponse;
         }
@@ -150,22 +150,27 @@ export default class PagesApi extends AsyncModules {
             }
             // Remove internal-only properties from the result.
             delete item.customSettings;
-            delete item.attributesSetIdentifier;
             // In traffic-saving mode skip the extra product requests.
             if (this.state.traficLimit)
                 return;
             // Attach related products by block type. StaffModule already normalizes its results.
+            // A failed sub-request leaves an empty value of the declared type: with isShell the
+            // error comes back as a value, and it used to land in `products`/`similarProducts`
             if (item.type === 'similar_products_block') {
                 try {
-                    item.similarProducts = await staffModule.getSimilarProducts(item.identifier, langCode);
+                    const similar = await AsyncModules._subRequestOf(staffModule).getSimilarProducts(item.identifier, langCode);
+                    item.similarProducts = this._isErrorResponse(similar)
+                        ? { items: [], total: 0 }
+                        : similar;
                 }
                 catch {
-                    item.similarProducts = [];
+                    item.similarProducts = { items: [], total: 0 };
                 }
             }
             else if (item.type === 'product_block') {
                 try {
-                    item.products = await staffModule.getProductsByBlockMarker(item.identifier, langCode);
+                    const products = await AsyncModules._subRequestOf(staffModule).getProductsByBlockMarker(item.identifier, langCode);
+                    item.products = this._isErrorResponse(products) ? [] : products;
                 }
                 catch {
                     item.products = [];
@@ -200,7 +205,7 @@ export default class PagesApi extends AsyncModules {
             // and broke `page.localizeInfos.title` on the caller's side (CMS-1068)
             const pageList = fetched.filter((page) => !this._isErrorResponse(page));
             // Add templates to the fetched pages
-            const withTemplate = await this.addTemplateToPages(pageList);
+            const withTemplate = await this.addTemplateToPages(pageList, langCode);
             // Normalize the data and return it; ensures consistent structure or handles errors
             return this._normalizeData(withTemplate, langCode);
         }
@@ -233,6 +238,7 @@ export default class PagesApi extends AsyncModules {
      * Add template data to pages
      * @handleName addTemplateToPages
      * @param {IPagesEntity[]} data - An array of page objects (IPagesEntity[]) to which template data will be added.
+     * @param {string} [langCode] - Language the templates are fetched and unwrapped in. Default: the client's language.
      * @example
         [
           {
@@ -273,7 +279,7 @@ export default class PagesApi extends AsyncModules {
      * @description Add template data to pages. Optimized to avoid N+1 query problem by fetching only unique templates in parallel.
      * For example, if 100 pages use 3 different templates, this method makes 3 requests instead of 100.
      */
-    async addTemplateToPages(data) {
+    async addTemplateToPages(data, langCode = this.state.lang) {
         // On API error responses (e.g. 403 without list permission, 422) the value
         // is an IError, not an array — return it as-is instead of calling array
         // methods (.filter/.map) on it and throwing a TypeError.
@@ -294,7 +300,9 @@ export default class PagesApi extends AsyncModules {
         }
         // Step 3: Fetch unique templates in parallel (not N queries, but unique count queries)
         const Templates = new templatesApi(this.state);
-        const templatePromises = uniqueIdentifiers.map((identifier) => Templates.getTemplateByMarker(identifier).catch((error) => {
+        const templatePromises = uniqueIdentifiers.map((identifier) => AsyncModules._subRequestOf(Templates)
+            .getTemplateByMarker(identifier, langCode)
+            .catch((error) => {
             // eslint-disable-next-line no-undef, no-console
             console.error(`Template fetch error for ${identifier}: `, error);
             return null; // Return null for failed templates
@@ -303,7 +311,8 @@ export default class PagesApi extends AsyncModules {
         // Step 4: Create a Map for O(1) template lookup
         const templateMap = new Map();
         templates.forEach((template, index) => {
-            if (template !== null) {
+            // An error comes back as a value with isShell: it is not a template
+            if (template !== null && !this._isErrorResponse(template)) {
                 templateMap.set(uniqueIdentifiers[index], template);
             }
         });
@@ -328,12 +337,12 @@ export default class PagesApi extends AsyncModules {
      * Add template data to page by page templateIdentifier
      * @handleName addTemplateToPage
      * @param {IPagesEntity} data - Page object (IPagesEntity) to which template data will be added.
+     * @param {string} [langCode] - Language the templates are fetched and unwrapped in. Default: the client's language.
      * @returns {Promise<any | IError>} An array of page objects with template data added
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Add template data to page by page templateIdentifier
-     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/addTemplateToPage addTemplateToPage} documentation.
      */
-    async addTemplateToPage(data) {
+    async addTemplateToPage(data, langCode = this.state.lang) {
         // Check if 'templateIdentifier' exists in 'data' and is not null or an empty string
         if ('templateIdentifier' in data &&
             data.templateIdentifier !== null &&
@@ -344,7 +353,11 @@ export default class PagesApi extends AsyncModules {
                 // Create a new instance of templatesApi with the current state
                 const Templates = new templatesApi(this.state);
                 // Fetch the template using the 'templateIdentifier'
-                const result = await Templates.getTemplateByMarker(templateIdentifier);
+                const result = await AsyncModules._subRequestOf(Templates).getTemplateByMarker(templateIdentifier, langCode);
+                // An error comes back as a value with isShell: leave the page without a template
+                if (this._isErrorResponse(result)) {
+                    return data;
+                }
                 // Return the original data object with the fetched template added
                 return {
                     ...data,
@@ -376,18 +389,18 @@ class StaffModule extends AsyncModules {
     // ({ total, items }) to match BlocksApi's similarProducts contract.
     async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         // Fetch similar products from the server
-        const result = await this._fetchGet(`/${this._pathSegment(marker)}/similar-products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
-        return this._normalizeData(result);
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/similar-products?langCode=${encodeURIComponent(langCode)}&offset=${encodeURIComponent(String(offset))}&limit=${encodeURIComponent(String(limit))}`);
+        return this._normalizeData(result, langCode);
     }
     // Method to fetch products by block marker
     async getProductsByBlockMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         // Fetch products from the server
-        const result = await this._fetchGet(`/${this._pathSegment(marker)}/products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/products?langCode=${encodeURIComponent(langCode)}&offset=${encodeURIComponent(String(offset))}&limit=${encodeURIComponent(String(limit))}`);
         // On API error responses there is no `items` array — return the (normalized)
         // error as-is instead of producing `undefined` from `result.items`.
         if (!Array.isArray(result === null || result === void 0 ? void 0 : result.items)) {
-            return this._normalizeData(result);
+            return this._normalizeData(result, langCode);
         }
-        return this._normalizeData(result.items);
+        return this._normalizeData(result.items, langCode);
     }
 }

package/esm/pages/pagesInterfaces.d.ts

@@ -49,9 +49,9 @@ interface IPagesApi {
     /**
      * Get child pages object with information as an array.
      * @handleName getChildPagesByParentUrl
-     * @param {string} url - URL of the parent page whose child pages to fetch. Example: "about".
+     * @param {string} url - URL of the parent page whose child pages to fetch — the page's own `pageUrl`, not a nested path: `blog/blog1` answers `404`. Example: "blog".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {IPagesEntity} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data) for the selected parent
+     * @returns {IPagesEntity[]} Returns an array of PageEntity objects for the selected parent, or an empty array [] when it has no child pages. A parent page that does not exist answers `404 Parent page not found` (IError).
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets child pages object with information as an array.
      */
@@ -121,7 +121,7 @@ interface IPagesResponse {
  * @property {number} version - Version number of the object; changes with each update. Example: 10.
  * @property {string} identifier - Text identifier (marker) of the object. Example: "catalog".
  * @property {number} attributeSetId - ID of the attribute set in use. Example: 0.
- * @property {string} processingType - How form submissions are processed, for example `"email"` or `"url"`. Example: "email".
+ * @property {string} processingType - How form submissions are processed: the processing type chosen in the form settings. Example: "script".
  * @property {ILocalizeInfo} localizeInfos - Localized name and content of the page.
  * @example
     {
@@ -142,22 +142,27 @@ interface IPagesResponse {
         "listTitles": [
           {
             "title": "red",
-            "value": 1,
-            "position": 1,
-            "extendedValue": null,
-            "extendedValueType": null
+            "value": "1",
+            "extended": {
+              "type": null,
+              "value": null
+            },
+            "position": 1
           },
           {
             "title": "yellow",
-            "value": 2,
-            "position": 2,
-            "extendedValue": null,
-            "extendedValueType": null
+            "value": "2",
+            "extended": {
+              "type": null,
+              "value": null
+            },
+            "position": 2
           }
         ],
         "validators": {},
         "localizeInfos": {
-        "title": "l1"
+          "title": "l1"
+        }
       }
     ]
  * @description This interface defines the structure of a position form entity, including its identifiers, attributes, and processing data.
@@ -188,7 +193,7 @@ interface IPositionForm {
  * @property {number} version - Version number of the object; changes with each update. Example: 0.
  * @property {number} position - Position of the object, used for sorting. Example: 1.
  * @property {string} identifier - Text identifier (marker) of the object. Example: "product_block".
- * @property {BlockType} type - Block type. Example: "product".
+ * @property {BlockType} type - Block type. Example: "product_block".
  * @property {string | null} templateIdentifier - Marker of the linked template, or `null` when none is linked. Example: null.
  * @property {boolean} isVisible - Whether the page is visible. Example: true.
  * @property {boolean} isSync - Whether the page is indexed. Example: false.
@@ -285,7 +290,6 @@ type PageType = 'catalog_page' | 'common_page' | 'error_page' | 'external_page';
     }
  * @property {Array<IFormConfig>} [moduleFormConfigs] - Form configurations of the module linked to the page.
  * @property {IRating} [rating] - Rating data: average value, likes and dislikes, and the calculation method.
- * @property {string} [total] - Total number of products linked to the page. Example: "10".
  * @property {string | null} [categoryPath] - Category path; `null` for nested pages that have no category path of their own. Example: "catalog".
  * @property {number} [distance] - Cosine distance to the query. Returned only by the semantic (vector) search endpoint when `debug: true` is passed in the search body. Example: 0.12.
  * @description This interface defines the structure of a page entity, including its identifiers, attributes, and hierarchical relationships.
@@ -310,7 +314,6 @@ interface IPagesEntity {
     config?: Record<string, number>;
     products?: number;
     childrenCount?: number;
-    total?: string;
     categoryPath?: string | null;
     distance?: number;
 }

package/esm/pages/pagesSchemas.d.ts

@@ -32,7 +32,6 @@ export declare const PageEntitySchema: z.ZodObject<{
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     products: z.ZodOptional<z.ZodNumber>;
     childrenCount: z.ZodOptional<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodString>;
     categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -64,7 +63,6 @@ export declare const PagesResponseSchema: z.ZodArray<z.ZodObject<{
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     products: z.ZodOptional<z.ZodNumber>;
     childrenCount: z.ZodOptional<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodString>;
     categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
@@ -111,7 +109,6 @@ export declare const SinglePageSchema: z.ZodObject<{
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     products: z.ZodOptional<z.ZodNumber>;
     childrenCount: z.ZodOptional<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodString>;
     categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;

package/esm/pages/pagesSchemas.js

@@ -29,7 +29,6 @@ export const PageEntitySchema = z.object({
     config: z.record(z.string(), z.number()).optional(),
     products: z.number().optional(),
     childrenCount: z.number().optional(),
-    total: z.string().optional(),
     categoryPath: z.string().nullable().optional(),
     distance: z.number().optional(),
 });

package/esm/payments/paymentsApi.d.ts

@@ -43,13 +43,13 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
      * Get one payment session object by order identifier
      * @handleName getSessionByOrderId
      * @param {number} id - Order ID. Example: 12345.
-     * @returns {Promise<IAccountsEntity | IError>} Returns a single payment account object.
+     * @returns {Promise<ISessionEntity[] | IError>} Returns the payment sessions of the order — an **array**, `[]` (with `200`) for an order without sessions, an order that does not exist or an order of another user.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method gets one payment session object by order identifier. This method requires user authorization.
+     * @description This method gets the payment sessions of an order by its identifier. The answer is an array even for one session. 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/payments/getSessionByOrderId getSessionByOrderId} documentation.
      */
-    getSessionByOrderId(id: number): Promise<ISessionEntity | ISessionEntity[] | IError>;
+    getSessionByOrderId(id: number): Promise<ISessionEntity[] | IError>;
     /**
      * Creation of payment session.
      * @handleName createSession
@@ -66,25 +66,24 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
     /**
      * Get all payment accounts as an array.
      * @handleName getAccounts
-     * @returns {Promise<IAccountsEntity | IError>} Returns all created payment accounts as an array of PaymentAccountEntity objects.
+     * @param {string} [langCode] - Language code. Default: the client's language.
+     * @returns {Promise<IAccountsEntity[] | IError>} Returns all created payment accounts as an array of PaymentAccountEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method gets all payment accounts as an array. 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}.
+     * @description This method gets all payment accounts as an array. It does not require user authorization: a guest gets the accounts too.
      * @see {@link https://js-sdk.oneentry.cloud/docs/payments/getAccounts getAccounts} documentation.
      */
-    getAccounts(): Promise<IAccountsEntity[] | IError>;
+    getAccounts(langCode?: string): Promise<IAccountsEntity[] | IError>;
     /**
      * Get a single payment account object by its identifier.
      * @handleName getAccountById
      * @param {number} id - Payment account ID. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: the client's language.
      * @returns {Promise<IAccountsEntity | IError>} Returns a single payment account object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Get a single payment account object by its identifier.
-     * @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}.
+     * @description Get a single payment account object by its identifier. It does not require user authorization: a guest gets the account too.
      * @see {@link https://js-sdk.oneentry.cloud/docs/payments/getAccountById getAccountById} documentation.
      */
-    getAccountById(id: number): Promise<IAccountsEntity | IError>;
+    getAccountById(id: number, langCode?: string): Promise<IAccountsEntity | IError>;
     /**
      * Get the payment progress of an order: its stages and whether they are paid.
      * @handleName getPaymentStagesByOrderId

package/esm/payments/paymentsApi.js

@@ -48,21 +48,23 @@ export default class PaymentsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/payments/getSessionById getSessionById} documentation.
      */
     async getSessionById(id) {
-        const result = await this._fetchGet(`/sessions/${id}`);
-        return result;
+        const result = await this._fetchGet(`/sessions/${this._pathSegment(String(id))}`);
+        // Validate response if validation is enabled
+        const validated = await this._validateResponse(result, schema('PaymentSessionSchema'));
+        return validated;
     }
     /**
      * Get one payment session object by order identifier
      * @handleName getSessionByOrderId
      * @param {number} id - Order ID. Example: 12345.
-     * @returns {Promise<IAccountsEntity | IError>} Returns a single payment account object.
+     * @returns {Promise<ISessionEntity[] | IError>} Returns the payment sessions of the order — an **array**, `[]` (with `200`) for an order without sessions, an order that does not exist or an order of another user.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method gets one payment session object by order identifier. This method requires user authorization.
+     * @description This method gets the payment sessions of an order by its identifier. The answer is an array even for one session. 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/payments/getSessionByOrderId getSessionByOrderId} documentation.
      */
     async getSessionByOrderId(id) {
-        const result = await this._fetchGet(`/sessions/order/${id}`);
+        const result = await this._fetchGet(`/sessions/order/${this._pathSegment(String(id))}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('SinglePaymentSessionSchema'));
         return validated;
@@ -92,32 +94,34 @@ export default class PaymentsApi extends AsyncModules {
     /**
      * Get all payment accounts as an array.
      * @handleName getAccounts
-     * @returns {Promise<IAccountsEntity | IError>} Returns all created payment accounts as an array of PaymentAccountEntity objects.
+     * @param {string} [langCode] - Language code. Default: the client's language.
+     * @returns {Promise<IAccountsEntity[] | IError>} Returns all created payment accounts as an array of PaymentAccountEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method gets all payment accounts as an array. 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}.
+     * @description This method gets all payment accounts as an array. It does not require user authorization: a guest gets the accounts too.
      * @see {@link https://js-sdk.oneentry.cloud/docs/payments/getAccounts getAccounts} documentation.
      */
-    async getAccounts() {
-        const result = await this._fetchGet('/accounts');
+    async getAccounts(langCode = this.state.lang) {
+        const result = await this._fetchGet('/accounts?' + this._queryParamsToString({ langCode }));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('PaymentAccountsResponseSchema'));
-        return this._normalizeData(validated);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Get a single payment account object by its identifier.
      * @handleName getAccountById
      * @param {number} id - Payment account ID. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: the client's language.
      * @returns {Promise<IAccountsEntity | IError>} Returns a single payment account object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Get a single payment account object by its identifier.
-     * @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}.
+     * @description Get a single payment account object by its identifier. It does not require user authorization: a guest gets the account too.
      * @see {@link https://js-sdk.oneentry.cloud/docs/payments/getAccountById getAccountById} documentation.
      */
-    async getAccountById(id) {
-        const result = await this._fetchGet(`/accounts/${id}`);
-        return this._normalizeData(result);
+    async getAccountById(id, langCode = this.state.lang) {
+        const result = await this._fetchGet(`/accounts/${this._pathSegment(String(id))}?` +
+            this._queryParamsToString({ langCode }));
+        // Validate response if validation is enabled
+        const validated = await this._validateResponse(result, schema('PaymentAccountSchema'));
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Get the payment progress of an order: its stages and whether they are paid.
@@ -132,7 +136,7 @@ export default class PaymentsApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/payments/getPaymentStagesByOrderId getPaymentStagesByOrderId} documentation.
      */
     async getPaymentStagesByOrderId(id) {
-        const result = await this._fetchGet(`/stages/order/${id}`);
+        const result = await this._fetchGet(`/stages/order/${this._pathSegment(String(id))}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('PaymentProgressSchema'));
         return this._normalizeData(validated);

package/esm/payments/paymentsInterfaces.d.ts

@@ -29,12 +29,12 @@ interface IPaymentsApi {
      * Get one payment session object by order identifier 🔐
      * @handleName getSessionByOrderId
      * @param {number} id - Order ID. Example: 12345.
-     * @returns {ISessionEntity} Returns a single payment session object.
+     * @returns {ISessionEntity[]} The payment sessions of the order — an **array**, `[]` (with `200`) for an order without sessions or one that does not exist.
      * @throws {IError} If there is an error during the fetch operation, it will return an error object.
-     * @description This method gets one payment session object by order identifier. This method requires user authorization.
+     * @description This method gets the payment sessions of an order by its identifier. The answer is an array even for one session. 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}.
      */
-    getSessionByOrderId(id: number): Promise<ISessionEntity | ISessionEntity[] | IError>;
+    getSessionByOrderId(id: number): Promise<ISessionEntity[] | IError>;
     /**
      * Creation of payment session.
      * @handleName createSession
@@ -50,22 +50,22 @@ interface IPaymentsApi {
     /**
      * Get all payment accounts as an array.
      * @handleName getAccounts
-     * @returns {IAccountsEntity} Returns all created payment accounts as an array of PaymentAccountEntity objects.
+     * @param {string} [langCode] - Language code. Default: the client's language.
+     * @returns {IAccountsEntity[]} Returns all created payment accounts as an array of PaymentAccountEntity objects.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
-     * @description This method gets all payment accounts as an array. 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}.
+     * @description This method gets all payment accounts as an array. It does not require user authorization: a guest gets the accounts too.
      */
-    getAccounts(): Promise<IAccountsEntity[] | IError>;
+    getAccounts(langCode?: string): Promise<IAccountsEntity[] | IError>;
     /**
      * Get a single payment account object by its identifier.
      * @handleName getAccountById
      * @param {number} id - Payment account ID. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: the client's language.
      * @returns {IAccountsEntity} Returns a single payment account object.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
-     * @description This method gets a single payment account object by its identifier. 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}.
+     * @description This method gets a single payment account object by its identifier. It does not require user authorization: a guest gets the account too.
      */
-    getAccountById(id: number): Promise<IAccountsEntity | IError>;
+    getAccountById(id: number, langCode?: string): Promise<IAccountsEntity | IError>;
     /**
      * Get the payment progress of an order: its stages and whether they are paid.
      * @handleName getPaymentStagesByOrderId
@@ -108,7 +108,7 @@ interface ISessionsEntity {
  * @property {'session' | 'intent'} type - Session type: "session" or "intent". Example: "session".
  * @property {string} status - Payment status. Example: "completed".
  * @property {number} paymentAccountId - ID of the payment account. Example: 1.
- * @property {number} orderId - ID of the order. Example: 1.
+ * @property {number | null} orderId - ID of the order; `null` for the session of a subscription, which has no order. Example: 1.
  * @property {string | null} paymentUrl - Payment page URL. Example: " https://www.sandbox.paypal.com/checkoutnow?token=9BE88048TU058770M".
  * @property {number | null} [amount] - Payment session amount. Example: 100.
  * @property {string} [clientSecret] - Client secret returned by the payment provider (for example, Stripe) when the session is created. Example: "pi_3MtwBwLkdIwHu7ix28a3tqPa_secret_YrKJUKribcBjcG8HVhfZluoGH".
@@ -121,7 +121,7 @@ interface ISessionEntity {
     type: 'session' | 'intent';
     status: string;
     paymentAccountId: number;
-    orderId: number;
+    orderId: number | null;
     paymentUrl: string | null;
     amount?: number | null;
     clientSecret?: string;
@@ -180,7 +180,6 @@ interface IPaymentAccountSettings {
  * @property {string} [stripeRedirectUrl] - Stripe onboarding redirect URL.
  * @property {boolean} [stripeOnboardingComplete] - Whether Stripe onboarding finished. Example: true.
  * @property {string} [stripePublishableKey] - Stripe publishable key.
- * @property {string} [signingSecretKey] - Stripe webhook signing secret. Example: "whsec_...".
  * @property {boolean} [useWebHookValidation] - Whether incoming webhooks must be signature-validated. Example: true.
  * @description Test-mode configuration of a payment account; field set depends on the provider (Stripe-specific fields are optional).
  */
@@ -193,7 +192,6 @@ interface IPaymentAccountTestSettings {
     stripeRedirectUrl?: string;
     stripeOnboardingComplete?: boolean;
     stripePublishableKey?: string;
-    signingSecretKey?: string;
     useWebHookValidation?: boolean;
 }
 /**