oneentry 1.0.176 → 1.0.178

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;
 }
 /**

package/esm/payments/paymentsSchemas.d.ts

@@ -5,7 +5,7 @@ import { z } from 'zod';
  */
 export declare const PaymentSessionSchema: z.ZodObject<{
     id: z.ZodNumber;
-    orderId: z.ZodNumber;
+    orderId: z.ZodNullable<z.ZodNumber>;
     amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     status: z.ZodString;
     createdDate: z.ZodString;
@@ -22,7 +22,7 @@ export declare const PaymentSessionSchema: z.ZodObject<{
 export declare const PaymentSessionsResponseSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         id: z.ZodNumber;
-        orderId: z.ZodNumber;
+        orderId: z.ZodNullable<z.ZodNumber>;
         amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         status: z.ZodString;
         createdDate: z.ZodString;
@@ -35,12 +35,12 @@ export declare const PaymentSessionsResponseSchema: z.ZodObject<{
     total: z.ZodNumber;
 }, z.core.$strip>;
 /**
- * Single payment session response schema
- * @description Schema for a single payment session or array of sessions by order
+ * Sessions of one order
+ * @description The answer of `/sessions/order/{id}` is always an array (`[]` when there are none)
  */
-export declare const SinglePaymentSessionSchema: z.ZodUnion<readonly [z.ZodObject<{
+export declare const SinglePaymentSessionSchema: z.ZodArray<z.ZodObject<{
     id: z.ZodNumber;
-    orderId: z.ZodNumber;
+    orderId: z.ZodNullable<z.ZodNumber>;
     amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     status: z.ZodString;
     createdDate: z.ZodString;
@@ -49,18 +49,7 @@ export declare const SinglePaymentSessionSchema: z.ZodUnion<readonly [z.ZodObjec
     paymentAccountId: z.ZodNumber;
     paymentUrl: z.ZodNullable<z.ZodString>;
     clientSecret: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodArray<z.ZodObject<{
-    id: z.ZodNumber;
-    orderId: z.ZodNumber;
-    amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    status: z.ZodString;
-    createdDate: z.ZodString;
-    updatedDate: z.ZodString;
-    type: z.ZodString;
-    paymentAccountId: z.ZodNumber;
-    paymentUrl: z.ZodNullable<z.ZodString>;
-    clientSecret: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>>]>;
+}, z.core.$strip>>;
 /**
  * Payment account schema
  * @description Schema for a payment account
@@ -71,7 +60,13 @@ export declare const PaymentAccountSchema: z.ZodObject<{
     isVisible: z.ZodBoolean;
     isUsed: z.ZodBoolean;
     testMode: z.ZodBoolean;
-    type: z.ZodString;
+    type: z.ZodEnum<{
+        custom: "custom";
+        stripe: "stripe";
+        yookassa: "yookassa";
+        midtrans: "midtrans";
+        xendit: "xendit";
+    }>;
     settings: z.ZodRecord<z.ZodString, z.ZodAny>;
     testSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     localizeInfos: z.ZodRecord<z.ZodString, z.ZodAny>;
@@ -86,7 +81,13 @@ export declare const PaymentAccountsResponseSchema: z.ZodArray<z.ZodObject<{
     isVisible: z.ZodBoolean;
     isUsed: z.ZodBoolean;
     testMode: z.ZodBoolean;
-    type: z.ZodString;
+    type: z.ZodEnum<{
+        custom: "custom";
+        stripe: "stripe";
+        yookassa: "yookassa";
+        midtrans: "midtrans";
+        xendit: "xendit";
+    }>;
     settings: z.ZodRecord<z.ZodString, z.ZodAny>;
     testSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     localizeInfos: z.ZodRecord<z.ZodString, z.ZodAny>;

package/esm/payments/paymentsSchemas.js

@@ -5,7 +5,7 @@ import { z } from 'zod';
  */
 export const PaymentSessionSchema = z.object({
     id: z.number(),
-    orderId: z.number(),
+    orderId: z.number().nullable(),
     amount: z.number().nullable().optional(),
     status: z.string(),
     createdDate: z.string(),
@@ -24,13 +24,10 @@ export const PaymentSessionsResponseSchema = z.object({
     total: z.number(),
 });
 /**
- * Single payment session response schema
- * @description Schema for a single payment session or array of sessions by order
+ * Sessions of one order
+ * @description The answer of `/sessions/order/{id}` is always an array (`[]` when there are none)
  */
-export const SinglePaymentSessionSchema = z.union([
-    PaymentSessionSchema,
-    z.array(PaymentSessionSchema),
-]);
+export const SinglePaymentSessionSchema = z.array(PaymentSessionSchema);
 /**
  * Payment account schema
  * @description Schema for a payment account
@@ -41,7 +38,7 @@ export const PaymentAccountSchema = z.object({
     isVisible: z.boolean(),
     isUsed: z.boolean(),
     testMode: z.boolean(),
-    type: z.string(),
+    type: z.enum(['stripe', 'yookassa', 'midtrans', 'xendit', 'custom']),
     settings: z.record(z.string(), z.any()),
     testSettings: z.record(z.string(), z.any()).optional(),
     localizeInfos: z.record(z.string(), z.any()),

package/esm/product-statuses/productStatusesApi.d.ts

@@ -33,7 +33,7 @@ export default class ProductStatusesApi extends AsyncModules implements IProduct
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IProductStatusEntity | IError>} Returns a product status object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Search for a product status object by its textual identifier (marker).
+     * @description Search for a product status object by its textual identifier (marker). Despite the name it returns the status itself, not products — to list products with a status, filter `Products.getProducts` by `statusMarker`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/product-statuses/getProductsByStatusMarker getProductsByStatusMarker} documentation.
      */
     getProductsByStatusMarker(marker: string, langCode?: string): Promise<IProductStatusEntity | IError>;

package/esm/product-statuses/productStatusesApi.js

@@ -26,7 +26,7 @@ export default class ProductStatusesApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/product-statuses/getProductStatuses getProductStatuses} documentation.
      */
     async getProductStatuses(langCode = this.state.lang) {
-        const result = await this._fetchGet('');
+        const result = await this._fetchGet(`?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('ProductStatusesResponseSchema'));
         return this._normalizeData(validated, langCode);
@@ -38,11 +38,11 @@ export default class ProductStatusesApi extends AsyncModules {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IProductStatusEntity | IError>} Returns a product status object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Search for a product status object by its textual identifier (marker).
+     * @description Search for a product status object by its textual identifier (marker). Despite the name it returns the status itself, not products — to list products with a status, filter `Products.getProducts` by `statusMarker`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/product-statuses/getProductsByStatusMarker getProductsByStatusMarker} documentation.
      */
     async getProductsByStatusMarker(marker, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}`);
+        const result = await this._fetchGet(`/marker/${this._pathSegment(marker)}?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('ProductStatusEntitySchema'));
         return this._normalizeData(validated, langCode);

package/esm/product-statuses/productStatusesInterfaces.d.ts

@@ -41,10 +41,7 @@ interface IProductStatusesApi {
  * @property {ILocalizeInfo} localizeInfos - Localized name of the product status.
  * @example
     {
-      "title": "Catalog",
-      "plainContent": "Content for catalog",
-      "htmlContent": "<b>Content for catalog</b>",
-      "menuTitle": "Catalog"
+      "title": "Sold"
     }
  * @property {boolean} isDefault - Whether this is the default status. Example: true.
  * @property {number} version - Version number of the object; changes with each update. Example: 1.

package/esm/products/productsApi.d.ts

@@ -52,14 +52,14 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
-     * @param {string} [userQuery.signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time. Example: "orders_storage".
+     * @param {string} [userQuery.signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time. Must be an existing orders storage marker of the project, e.g. "my_order"; a marker with no such storage fails the whole request with `404 Specified orders storage for price signature not found`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {string} [userQuery.sortOrder] - Sorting order parameter.
      * @returns {Promise<IProductsResponse | IError>} Products response, or IError when isShell=true
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Fetch products with optional filters and pagination.
+     * @description Fetch products with optional filters and pagination. `limit` is an integer from `1` (`0` or `1.5` answer `400`). A `signPrice` naming no orders storage fails the whole request with `404 Specified orders storage for price signature not found`. Products without a translation in `langCode` are left out.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProducts getProducts} documentation.
      */
     getProducts(body?: IFilterParams[], langCode?: string, userQuery?: IProductsQueryBase): Promise<IProductsResponse | IError>;
@@ -75,7 +75,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
      * @returns {Promise<IProductsResponse | IError>} Products without a category: `{ items, total }`, the same container as getProducts.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -120,7 +120,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -139,7 +139,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
-          "signPrice": "orders",
+          "signPrice": "my_order",
           "statusMarker": "in_stock"
         }
      * @returns {Promise<IProductsInfo | IError>} Array with ProductInformation objects.
@@ -185,7 +185,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -205,7 +205,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
+          "signPrice": "my_order",
           "statusMarker": "in_stock",
           "templateMarker": "template_12345"
         }
@@ -223,18 +223,18 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
     /**
      * Find products by its ids.
      * @handleName getProductsByIds
-     * @param {string} ids - Comma-separated IDs of the product pages to fetch. Example: "12345,67890".
+     * @param {string} ids - Comma-separated product IDs. Unknown ids are dropped and repeated ones collapsed; a non-numeric one answers `400 Incorrect request`. Example: "12345,67890".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {IProductsByIdsQuery} [userQuery] - Optional query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
-          "signPrice": "orders"
+          "signPrice": "my_order"
         }
      * @param {number} [userQuery.limit] - Maximum number of records to return. Default: 30.
      * @param {number} [userQuery.offset] - Number of records to skip. Default: 0.
-     * @param {string} [userQuery.signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time.
+     * @param {string} [userQuery.signPrice] - Marker of the order storage to fix prices for. When set, each product comes with a `signedPrice` that holds the price for a limited time. Must be an existing orders storage marker of the project, e.g. "my_order"; a marker with no such storage fails the whole request with `404 Specified orders storage for price signature not found`.
      * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Find products by its ids.
@@ -246,104 +246,77 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @handleName getProductById
      * @param {number} id - Product ID. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {boolean} [isNormalized] - When `true`, the product is returned in normalized form.
+     * @param {boolean} [isNormalized] - Deprecated: the API no longer reads it, the answer is the same with `true`, `false` or without it. Kept for compatibility.
+     * @param {string} [signPrice] - Marker of an orders storage to fix the price for. When set, the product comes with a `signedPrice` holding the price for a limited time; an unknown marker fails the request with `404 Specified orders storage for price signature not found`.
      * @returns {Promise<IProductsEntity | IError>} ProductEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Retrieve one product object.
+     * @description Retrieve one product object. A product with no translation in `langCode` answers `404 Product not found` — there is no fallback to another language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductById getProductById} documentation.
      */
-    getProductById(id: number, langCode?: string, isNormalized?: boolean): Promise<IProductsEntity | IError>;
+    getProductById(id: number, langCode?: string, isNormalized?: boolean, signPrice?: string): Promise<IProductsEntity | IError>;
     /**
      * Getting a product block object by product id.
      * @handleName getProductBlockById
      * @param {number} id - Product ID. Example: 12345.
-     * @returns {Promise<IProductBlock | IError>} - Product block object.
+     * @param {string} [langCode] - Language code. Default: the client's language.
+     * @returns {Promise<IProductBlock[] | IError>} - Array of the product's block objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a product block object by product id.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductBlockById getProductBlockById} documentation.
      */
-    getProductBlockById(id: number): Promise<IProductBlock[] | IError>;
+    getProductBlockById(id: number, langCode?: string): Promise<IProductBlock[] | IError>;
     /**
      * Quick search for product page objects with limited output.
      * @handleName searchProduct
      * @param {string} name - Text to search for in product titles (`localizeInfos.title`) in the requested language. Example: "laminat".
      * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [url] - URL of a catalog page to search within that category. Default: the whole catalog.
+     * @param {boolean} [correct] - Correct typos by the project's search dictionary first. The API defaults to `true`; pass `false` to search the query as is.
      * @returns {Promise<IProductsEntity[] | IProductSearchResult[] | IError>} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Quick search for product page objects with limited output. The quick search endpoint returns short cards ({ id, title, pageId }); with traficLimit enabled they are returned as is, otherwise full product entities are fetched for the found ids.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/searchProduct searchProduct} documentation.
      */
-    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
+    searchProduct(name: string, langCode?: string, url?: string, correct?: boolean): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
     /**
      * Getting the number of products for the entire catalog.
      * @handleName getProductsCount
-     * @param {any[]} body - Filter objects with search conditions. Default: `[]`.
+     * @param {any[]} [body] - Filter objects with search conditions. Default: `[]`.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be one of the project's active languages — an inactive one answers `400 langCode must be one of the active languages`. The count reflects the products visible in that language.
      * @example
         [
           {
             "attributeMarker": "price",
-            "conditionMarker": "in",
-            "statusMarker": "status_1",
-            "conditionValue": {},
-            "pageUrls": [
-              "23-laminat-floorwood-maxima"
-            ],
-            "title": "Iphone 17 Pro"
+            "conditionMarker": "eq",
+            "conditionValue": 51
           }
         ]
      * @returns {Promise<IProductsCount | IError>} Object with product items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method calculates and returns the total number of products present across the entire catalog, optionally applying specified filters.
+     * @description This method calculates and returns the total number of products present across the entire catalog, optionally applying specified filters. The request carries `langCode`; it must be an active language of the project, otherwise the API answers `400`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCount getProductsCount} documentation.
      */
-    getProductsCount(body?: any[]): Promise<IProductsCount | IError>;
+    getProductsCount(body?: any[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Getting the number of products on a catalog page by page ID.
      * @handleName getProductsCountByPageId
      * @param {number | string} id - Page ID. Example: 12345.
      * @param {any[]} [body] - Filter objects with search conditions. Default: `[]`.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be one of the project's active languages — an inactive one answers `400 langCode must be one of the active languages`. The count reflects the products visible in that language.
      * @example
         [
           {
             "attributeMarker": "price",
-            "conditionMarker": "in",
-            "statusMarker": "status_1",
-            "conditionValue": {},
-            "pageUrls": [
-              "23-laminat-floorwood-maxima"
-            ],
-            "title": "Iphone 17 Pro"
+            "conditionMarker": "eq",
+            "conditionValue": 51
           }
         ]
      * @returns {Promise<IProductsCount | IError>} Object with product items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method calculates and returns the number of products available on a given catalog page, identified by its page ID, with optional filtering.
+     * @description This method calculates and returns the number of products available on a given catalog page, identified by its page ID, with optional filtering. The request carries `langCode`; it must be an active language of the project (an inactive one answers `400`), and the count reflects the products visible in that language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageId getProductsCountByPageId} documentation.
      */
-    getProductsCountByPageId(id: number | string, body?: any[]): Promise<IProductsCount | IError>;
-    /**
-     * Getting the number of products for the catalog page by page url.
-     * @handleName getProductsCountByPageUrl
-     * @param {string} url - Page URL.
-     * @param {any[]} body - Filter objects with search conditions. Default: `[]`.
-     * @example
-        [
-          {
-            "attributeMarker": "price",
-            "conditionMarker": "in",
-            "statusMarker": "status_1",
-            "conditionValue": {},
-            "pageUrls": [
-              "23-laminat-floorwood-maxima"
-            ],
-            "title": "Iphone 17 Pro"
-          }
-        ]
-     * @returns {Promise<IProductsCount | IError>} Object with product items count.
-     * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method calculates and returns the number of products available on a given catalog page, identified by its URL, with optional filtering.
-     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageUrl getProductsCountByPageUrl} documentation.
-     */
+    getProductsCountByPageId(id: number | string, body?: any[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Semantic (vector) search for products.
      * @handleName getProductsByVectorSearch
@@ -358,10 +331,23 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      */
     getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IProductsResponse> | IError>;
     /**
-     * Get products by page url.
-     * @param {string} url - Page URL.
-     * @param {any[]} body - Request body.
-     * @returns {IProductsEntity[] | IError} Returns an array of products or an error object.
+     * Getting the number of products for the catalog page by page url.
+     * @handleName getProductsCountByPageUrl
+     * @param {string} url - Page URL. Example: "catalog".
+     * @param {any[]} [body] - Filter objects with search conditions. Default: `[]`.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be one of the project's active languages — an inactive one answers `400 langCode must be one of the active languages`. The count reflects the products visible in that language.
+     * @example
+        [
+          {
+            "attributeMarker": "price",
+            "conditionMarker": "eq",
+            "conditionValue": 51
+          }
+        ]
+     * @returns {Promise<IProductsCount | IError>} Object with product items count.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description This method calculates and returns the number of products available on a given catalog page, identified by its URL, with optional filtering. The request carries `langCode`; it must be an active language of the project (an inactive one answers `400`), and the count reflects the products visible in that language.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageUrl getProductsCountByPageUrl} documentation.
      */
-    getProductsCountByPageUrl(url: string, body?: any[]): Promise<IProductsCount | IError>;
+    getProductsCountByPageUrl(url: string, body?: any[], langCode?: string): Promise<IProductsCount | IError>;
 }