oneentry 1.0.161 → 1.0.163

package/esm/base/attributes.js

@@ -0,0 +1,163 @@
+const _FILE_TYPES = ['image', 'file', 'groupOfImages'];
+/**
+ * Tests whether a value looks like a file object of an attribute.
+ *
+ * A file is identified by `downloadLink`: it is the one field every file of
+ * every attribute carries, while previews are only generated for images.
+ * @param {unknown} value - The value to test.
+ * @returns {boolean} True when the value is a file object.
+ */
+function _isFile(value) {
+    return (!!value &&
+        typeof value === 'object' &&
+        typeof value.downloadLink === 'string');
+}
+/**
+ * Narrows an attribute value to a file-bearing attribute.
+ *
+ * `IAttributeValue.value` is `unknown` — its shape depends on `type` — so this
+ * guard is what lets you reach the files without a cast. It accepts both shapes
+ * the SDK produces: a single file object for an `image`/`file` attribute holding
+ * exactly one file, an array for several and for every `groupOfImages`.
+ * @param {IAttributeValue | undefined} attr - The attribute value to test.
+ * @returns {boolean} True when the attribute is an `image`, `file` or `groupOfImages` carrying files (or nothing).
+ * @example
+ * ```ts
+ * const attr = page.attributeValues.cover;
+ * if (isFileAttribute(attr)) {
+ *     // attr.value is IAttributeFile | IAttributeFile[] | null — no cast
+ * }
+ * ```
+ */
+export function isFileAttribute(attr) {
+    if (!attr || !_FILE_TYPES.includes(attr.type))
+        return false;
+    if (attr.value === null || attr.value === undefined)
+        return true;
+    return Array.isArray(attr.value)
+        ? attr.value.every((item) => _isFile(item))
+        : _isFile(attr.value);
+}
+/**
+ * Reads every file of an attribute as an array.
+ *
+ * The one-call path for the common case. An `image`/`file` attribute holding a
+ * single file has it unwrapped to the object itself, while several files and
+ * every `groupOfImages` stay an array — a rule that is easy to get wrong in a
+ * way the compiler cannot catch, since `value` is `unknown`: reading `value[0]`
+ * off a single file yields `undefined` and nothing anywhere reports an error.
+ * This helper collapses both shapes to a list.
+ *
+ * Anything that is not a file-bearing attribute yields an empty array, so it is
+ * safe to call on an arbitrary attribute without checking `type` first.
+ * @param {IAttributeValue | undefined} attr - An attribute value, e.g. `page.attributeValues.cover`.
+ * @returns {IAttributeFile[]} The files, in the order the API returned them; empty when the attribute holds none or is not file-bearing.
+ * @example
+ * ```ts
+ * import { getAttributeFiles } from 'oneentry';
+ *
+ * // Works the same for one image and for a gallery.
+ * const images = getAttributeFiles(page.attributeValues.cover);
+ * images.map((file) => file.downloadLink);
+ * ```
+ */
+export function getAttributeFiles(attr) {
+    if (!attr)
+        return [];
+    const value = attr.value;
+    if (Array.isArray(value))
+        return value.filter((item) => _isFile(item));
+    return _isFile(value) ? [value] : [];
+}
+/**
+ * Reads the first file of an attribute.
+ *
+ * The single-image counterpart of {@link getAttributeFiles} — same shape
+ * handling, but returns the file itself instead of a list. For a gallery it
+ * returns the first entry, which is what a preview or a cover usually needs.
+ * @param {IAttributeValue | undefined} attr - An attribute value, e.g. `product.attributeValues.img`.
+ * @returns {IAttributeFile | null} The first file, or null when the attribute holds none.
+ * @example
+ * ```ts
+ * import { getAttributeFile } from 'oneentry';
+ *
+ * const cover = getAttributeFile(product.attributeValues.img);
+ * const blurDataURL = cover?.previewLink?.default?.[0];
+ * ```
+ */
+export function getAttributeFile(attr) {
+    var _a;
+    return (_a = getAttributeFiles(attr)[0]) !== null && _a !== void 0 ? _a : null;
+}
+/**
+ * Narrows an attribute value to a text attribute.
+ * @param {IAttributeValue | undefined} attr - The attribute value to test.
+ * @returns {boolean} True when the attribute is a `string`, `text` or `textEditor` carrying a string (or nothing).
+ */
+export function isStringAttribute(attr) {
+    return (!!attr &&
+        (attr.type === 'string' ||
+            attr.type === 'text' ||
+            attr.type === 'textEditor') &&
+        (attr.value === null || typeof attr.value === 'string'));
+}
+/**
+ * Narrows an attribute value to a numeric attribute.
+ *
+ * The SDK casts `integer`, `float` and `real` values to a JS number, so the
+ * guard checks for one — a value that failed to cast is `null`.
+ * @param {IAttributeValue | undefined} attr - The attribute value to test.
+ * @returns {boolean} True when the attribute is an `integer`, `float` or `real` carrying a number (or nothing).
+ */
+export function isNumberAttribute(attr) {
+    return (!!attr &&
+        (attr.type === 'integer' ||
+            attr.type === 'float' ||
+            attr.type === 'real') &&
+        (attr.value === null || typeof attr.value === 'number'));
+}
+/**
+ * Narrows an attribute value to a `list` attribute.
+ *
+ * The option shape is defined by the attribute set, so the entries stay
+ * `unknown` — the guard only promises the array container.
+ * @param {IAttributeValue | undefined} attr - The attribute value to test.
+ * @returns {boolean} True when the attribute is a `list` carrying an array.
+ */
+export function isListAttribute(attr) {
+    return !!attr && attr.type === 'list' && Array.isArray(attr.value);
+}
+/**
+ * Reads the nested fields of an attribute as a marker map.
+ *
+ * `additionalFields` is typed `Record<string, IAttributeValue> | unknown[]`
+ * because the API returns an empty **array** when an attribute has no nested
+ * fields — the union makes every read of a field a type error. This helper
+ * collapses that case to an empty map, so the result is always keyed by marker.
+ *
+ * With `rawData: true` in the config the SDK keeps the API's original array of
+ * fields; it is converted here by `marker` as well, so the helper returns the
+ * same map in both modes.
+ * @param {IAttributeValue | undefined} attr - An attribute value whose nested fields to read.
+ * @returns {Record<string, IAttributeValue>} Nested attribute values keyed by marker; empty when there are none.
+ * @example
+ * ```ts
+ * import { getAdditionalFields } from 'oneentry';
+ *
+ * const alt = getAdditionalFields(page.attributeValues.cover).alt?.value;
+ * ```
+ */
+export function getAdditionalFields(attr) {
+    const fields = attr === null || attr === void 0 ? void 0 : attr.additionalFields;
+    if (!fields || typeof fields !== 'object')
+        return {};
+    if (Array.isArray(fields)) {
+        // rawData mode: the API's own array of fields, each carrying its marker.
+        return Object.fromEntries(fields
+            .filter((field) => !!field &&
+            typeof field === 'object' &&
+            typeof field.marker === 'string')
+            .map((field) => [field.marker, field]));
+    }
+    return fields;
+}

package/esm/base/utils.d.ts

@@ -266,10 +266,19 @@ interface ITimeIntervalRange {
  * @property {string} type - Attribute data type (e.g. "string", "integer", "list", "file", "image").
  * @property {unknown} value - Attribute value — actual TS type depends on `type`, and the SDK normalizes it to the same shape in every module: `string` for "string"/"text"; `number | null` for "integer"/"float"/"real"; the file object itself for a single-file "image"/"file" and an array of them for several; an array for "list" and "groupOfImages". An attribute with no value is always `null`. Example: "Admins text".
  * @property {number} [position] - Sort position of the value inside its set; the containing collection is returned sorted by it. Example: 0.
- * @property {Record<string, IAttributeValue> | unknown[]} [additionalFields] - Nested attribute values keyed by marker; the API may also return an empty array when none are configured. Optional.
+ * @property {Record<string, IAttributeValue> | unknown[]} [additionalFields] - Nested attribute values keyed by marker; the API may also return an empty array when none are configured. Read it through `getAdditionalFields`, which collapses that array to an empty map. Optional.
  * @property {boolean} [isIcon] - Block/preview attribute flag — whether the field is treated as an icon. Optional.
  * @property {boolean} [isProductPreview] - Block/preview attribute flag — whether the field is shown in product preview. Optional.
  * @description A single attribute value attached to an entity (admin, user, page, product, …).
+ *
+ * `value` is `unknown` because its shape is decided by `type` at runtime, which
+ * a single interface cannot express. Do not read it by assumption — the type
+ * checker cannot catch a wrong guess (an array read on a single file yields
+ * `undefined`, silently, with no error anywhere). Reach it through the guards
+ * and helpers instead: `isFileAttribute` / `getAttributeFiles`,
+ * `isStringAttribute`, `isNumberAttribute`, `isListAttribute`,
+ * `isTimeIntervalAttribute`; or annotate with {@link ITypedAttributeValue} to
+ * have the compiler enforce the rule.
  */
 interface IAttributeValue {
     type: string;
@@ -286,6 +295,90 @@ interface IAttributeValue {
 interface IAttributeValues {
     [key: string]: IAttributeValue;
 }
+/**
+ * @interface IAttributeFile
+ * @property {string} filename - Storage-relative path of the file. Example: "files/project/product/2954/image/48853cbf-4462-42c6-8b99-d14f721c21a2.jpeg".
+ * @property {string} downloadLink - Public URL of the original file. Example: "https://my-project.oneentry.cloud/cloud-static/files/project/product/2954/image/48853cbf.jpeg".
+ * @property {number} size - File size in bytes. Example: 742690.
+ * @property {string} contentType - MIME type of the file. Example: "image/jpeg".
+ * @property {Record<string, string[]>} [previewLink] - Generated previews keyed by preview template. Each entry is a `[placeholder, url]` pair: the first item is an inline base64 thumbnail (usable as a `blurDataURL`), the second the preview URL. Optional — previews are generated for images; a non-image `file` may arrive without them. Example: { "default": ["data:image/webp;base64,UklGRmwA…", "https://…48853cbf.preview.default.jpeg"] }.
+ * @property {string} [defaultPreview] - Key of `previewLink` to use by default. Optional — present alongside `previewLink`. Example: "default".
+ * @description One file of an `image`, `file` or `groupOfImages` attribute value. Reach it through {@link IFileAttributeValue} — or, without caring whether the attribute holds one file or many, through `getAttributeFiles`.
+ */
+interface IAttributeFile {
+    filename: string;
+    downloadLink: string;
+    size: number;
+    contentType: string;
+    previewLink?: Record<string, string[]>;
+    defaultPreview?: string;
+}
+/**
+ * @interface IFileAttributeValue
+ * @property {'image' | 'file' | 'groupOfImages'} type - Discriminant identifying the attribute as file-bearing.
+ * @property {IAttributeFile | IAttributeFile[] | null} value - The file itself when an `image`/`file` attribute holds exactly one, an array when it holds several, always an array for `groupOfImages`, `null` when nothing is set.
+ * @description {@link IAttributeValue} narrowed to attributes that carry files, whose generic `value: unknown` resolves to {@link IAttributeFile}. The single/array split is what the SDK's normalization produces, so it has to be handled: narrow with `isFileAttribute`, or skip the branch entirely with `getAttributeFiles` / `getAttributeFile`.
+ */
+interface IFileAttributeValue extends IAttributeValue {
+    type: 'image' | 'file' | 'groupOfImages';
+    value: IAttributeFile | IAttributeFile[] | null;
+}
+/**
+ * @interface IStringAttributeValue
+ * @property {'string' | 'text' | 'textEditor'} type - Discriminant identifying the attribute as text-bearing.
+ * @property {string | null} value - The text; `null` when no value is set.
+ * @description {@link IAttributeValue} narrowed to text attributes. Narrow to it with `isStringAttribute`.
+ */
+interface IStringAttributeValue extends IAttributeValue {
+    type: 'string' | 'text' | 'textEditor';
+    value: string | null;
+}
+/**
+ * @interface INumberAttributeValue
+ * @property {'integer' | 'float' | 'real'} type - Discriminant identifying the attribute as numeric.
+ * @property {number | null} value - The number, cast by the SDK from the API's string form; `null` when no value is set.
+ * @description {@link IAttributeValue} narrowed to numeric attributes. Narrow to it with `isNumberAttribute`.
+ */
+interface INumberAttributeValue extends IAttributeValue {
+    type: 'integer' | 'float' | 'real';
+    value: number | null;
+}
+/**
+ * @interface IListAttributeValue
+ * @property {'list'} type - Discriminant identifying the attribute as a list.
+ * @property {unknown[]} value - The selected options. The option shape is defined by the attribute set, so the entries stay `unknown` — only the array container is guaranteed.
+ * @description {@link IAttributeValue} narrowed to `list` attributes. Narrow to it with `isListAttribute`.
+ */
+interface IListAttributeValue extends IAttributeValue {
+    type: 'list';
+    value: unknown[];
+}
+/**
+ * ITypedAttributeValue — {@link IAttributeValue} as a discriminated union over `type`.
+ *
+ * Opt-in, and deliberately closed: it lists only the types whose `value` shape
+ * the SDK guarantees, so `switch (attr.type)` narrows `value` for you. A loose
+ * member (`type: string`) would be assignable to every case and collapse the
+ * narrowing back to `unknown`, which is exactly what this type exists to avoid.
+ *
+ * `IAttributeValues` keeps the loose `IAttributeValue`, so nothing existing
+ * changes: narrow into this union with the guards (`isFileAttribute` and the
+ * rest), or annotate a value you control. Attribute types the SDK does not
+ * model (`entity`, `date`, custom ones) stay on `IAttributeValue`.
+ * @example
+ * ```ts
+ * function render(attr: ITypedAttributeValue) {
+ *     switch (attr.type) {
+ *         case 'image':
+ *         case 'file':
+ *             return attr.value; // IAttributeFile | IAttributeFile[] | null
+ *         case 'integer':
+ *             return attr.value; // number | null
+ *     }
+ * }
+ * ```
+ */
+type ITypedAttributeValue = IFileAttributeValue | IStringAttributeValue | INumberAttributeValue | IListAttributeValue | ITimeIntervalAttributeValue;
 /**
  * @interface IRating
  * @property {number} [value] - Average rating value. Example: 4.5.
@@ -351,4 +444,4 @@ type LangType = string | Array<string>;
  * LocalizeType
  */
 type LocalizeType = ILocalizeInfo;
-export type { IAttributeLocalizeInfo, IAttributes, IAttributeValue, IAttributeValues, IConfig, IError, IHttpHeaders, IHttpOptions, ILocalizeInfo, IRating, ITimeIntervalAttributeValue, ITimeIntervalEntitySchedule, ITimeIntervalGroup, ITimeIntervalPoint, ITimeIntervalRange, ITimeIntervalSchedule, ITimeIntervalWindow, LangType, LocalizeType, TimeIntervalPair, };
+export type { IAttributeFile, IAttributeLocalizeInfo, IAttributes, IAttributeValue, IAttributeValues, IConfig, IError, IFileAttributeValue, IHttpHeaders, IHttpOptions, IListAttributeValue, ILocalizeInfo, INumberAttributeValue, IRating, IStringAttributeValue, ITimeIntervalAttributeValue, ITimeIntervalEntitySchedule, ITimeIntervalGroup, ITimeIntervalPoint, ITimeIntervalRange, ITimeIntervalSchedule, ITimeIntervalWindow, ITypedAttributeValue, LangType, LocalizeType, TimeIntervalPair, };

package/esm/base/validation.d.ts

@@ -36,6 +36,35 @@ export declare const AttributeSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     value: z.ZodOptional<z.ZodAny>;
 }, z.core.$strip>;
+/**
+ * Attribute file schema
+ *
+ * One file of an `image`, `file` or `groupOfImages` attribute value, as the API
+ * returns it — mirrors `IAttributeFile`. Loose: the API may add fields, and a
+ * new one is not a reason to report a broken response.
+ */
+export declare const AttributeFileSchema: z.ZodObject<{
+    filename: z.ZodString;
+    downloadLink: z.ZodString;
+    size: z.ZodNumber;
+    contentType: z.ZodString;
+    previewLink: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    defaultPreview: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * Attribute values schema
+ *
+ * The container the API returns under `attributeValues`. Both nestings are
+ * accepted, since the raw response wraps the marker map in a locale
+ * (`{ en_US: { marker: attr } }`) while some endpoints return it flat.
+ *
+ * Attribute values are open by design — what `value` holds is decided by the
+ * project's attribute set — so the schema validates the one part the API fixes
+ * and the SDK relies on: the shape of files. If a future API release renames or
+ * drops a file field, `getAttributeFiles` would silently return nothing;
+ * validation (`config.validation.enabled`) reports it instead.
+ */
+export declare const AttributeValuesSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 /**
  * User entity schema
  */
@@ -50,6 +79,7 @@ export declare const UserEntitySchema: z.ZodObject<{
     state: z.ZodRecord<z.ZodString, z.ZodAny>;
     moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
     rating: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /**
  * Auth entity schema

package/esm/base/validation.js

@@ -33,6 +33,98 @@ export const AttributeSchema = z.object({
     localizeInfos: z.record(z.string(), LocalizeInfoSchema).optional(),
     value: z.any().optional(),
 });
+/**
+ * Attribute file schema
+ *
+ * One file of an `image`, `file` or `groupOfImages` attribute value, as the API
+ * returns it — mirrors `IAttributeFile`. Loose: the API may add fields, and a
+ * new one is not a reason to report a broken response.
+ */
+export const AttributeFileSchema = z.looseObject({
+    filename: z.string(),
+    downloadLink: z.string(),
+    size: z.number(),
+    contentType: z.string(),
+    previewLink: z.record(z.string(), z.array(z.string())).optional(),
+    defaultPreview: z.string().optional(),
+});
+/**
+ * Attribute types whose value carries files.
+ */
+const FILE_ATTRIBUTE_TYPES = ['image', 'file', 'groupOfImages'];
+/**
+ * Reports whether a value is the empty localization map the API sends for an
+ * attribute with no value set.
+ * @param {unknown} value - The value to test.
+ * @returns {boolean} True when the value carries nothing.
+ */
+function isEmptyValue(value) {
+    if (value === null || value === undefined)
+        return true;
+    return (typeof value === 'object' &&
+        !Array.isArray(value) &&
+        Object.keys(value).length === 0);
+}
+/**
+ * Validates the files of one attribute value, recursing into nested fields.
+ *
+ * Only file-bearing attributes are inspected. Everything else is left alone:
+ * the shape of `value` is defined per attribute type by the project's own
+ * attribute set, so a schema cannot describe it — but the file shape is fixed
+ * by the API, and the SDK's own helpers (`getAttributeFiles`) depend on it.
+ * @param {unknown} node - An attribute value, or a container of them.
+ * @param {string[]} path - Path to the node, for issue reporting.
+ * @param {z.RefinementCtx} ctx - Zod refinement context issues are added to.
+ */
+function validateAttributeFiles(node, path, ctx) {
+    if (!node || typeof node !== 'object')
+        return;
+    if (Array.isArray(node)) {
+        node.forEach((item, index) => validateAttributeFiles(item, [...path, String(index)], ctx));
+        return;
+    }
+    const attr = node;
+    const isAttribute = typeof attr.type === 'string' && 'value' in attr;
+    if (isAttribute && FILE_ATTRIBUTE_TYPES.includes(attr.type)) {
+        if (!isEmptyValue(attr.value)) {
+            // The API always sends files as an array; the SDK unwraps a single one
+            // afterwards, so both shapes are accepted here.
+            const files = Array.isArray(attr.value) ? attr.value : [attr.value];
+            files.forEach((file, index) => {
+                const result = AttributeFileSchema.safeParse(file);
+                if (result.success)
+                    return;
+                result.error.issues.forEach((issue) => ctx.addIssue({
+                    code: 'custom',
+                    path: [...path, 'value', index, ...issue.path],
+                    message: `Attribute of type "${attr.type}" carries an unexpected file shape: ${issue.message}`,
+                }));
+            });
+        }
+    }
+    // Nested fields carry attribute values of their own, files included.
+    if (isAttribute) {
+        validateAttributeFiles(attr.additionalFields, [...path, 'additionalFields'], ctx);
+        return;
+    }
+    Object.entries(attr).forEach(([key, value]) => validateAttributeFiles(value, [...path, key], ctx));
+}
+/**
+ * Attribute values schema
+ *
+ * The container the API returns under `attributeValues`. Both nestings are
+ * accepted, since the raw response wraps the marker map in a locale
+ * (`{ en_US: { marker: attr } }`) while some endpoints return it flat.
+ *
+ * Attribute values are open by design — what `value` holds is decided by the
+ * project's attribute set — so the schema validates the one part the API fixes
+ * and the SDK relies on: the shape of files. If a future API release renames or
+ * drops a file field, `getAttributeFiles` would silently return nothing;
+ * validation (`config.validation.enabled`) reports it instead.
+ */
+export const AttributeValuesSchema = z
+    .record(z.string(), z.unknown())
+    .superRefine((values, ctx) => validateAttributeFiles(values, [], ctx));
 /**
  * User entity schema
  */
@@ -47,6 +139,7 @@ export const UserEntitySchema = z.object({
     state: z.record(z.string(), z.any()),
     moduleFormConfigs: z.array(z.any()).optional(),
     rating: z.record(z.string(), z.unknown()).optional(),
+    distance: z.number().optional(),
 });
 /**
  * Auth entity schema

package/esm/blocks/blocksApi.d.ts

@@ -96,11 +96,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @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>;
+    getFrequentlyOrderedProducts(productId: number, marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Quick search for block objects with limited output.
      * @handleName searchBlock
@@ -118,11 +119,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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<IProductsResponse | IError>;
+    getCartComplement(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get "complete your cart" products by an explicit list of productIds (POST body).
      * @handleName getCartComplementByProductIds
@@ -145,11 +147,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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<IProductsResponse | IError>;
+    getCartSimilar(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to cart" products by an explicit list of productIds (POST body).
      * @handleName getCartSimilarByProductIds
@@ -172,11 +175,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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<IProductsResponse | IError>;
+    getPersonalRecommendations(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get recently viewed products.
      * @handleName getRecentlyViewed
@@ -184,11 +188,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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<IProductsResponse | IError>;
+    getRecentlyViewed(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get products for repeat purchase.
      * @handleName getRepeatPurchase
@@ -196,11 +201,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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<IProductsResponse | IError>;
+    getRepeatPurchase(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get the block's slides tree as a flat pre-order array (slider_block only).
      * @handleName getSlides
@@ -217,11 +223,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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<IProductsResponse | IError>;
+    getTrending(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to wishlist" products by the wishlist from context (auth user or guest).
      * @handleName getWishlistSimilar
@@ -229,11 +236,12 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
+     * @param {number} [limit] - Maximum number of products to return. When omitted, the block's own quantity setting applies. Example: 10.
      * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of products, total count and totalFound.
      * @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<IProductsResponse | IError>;
+    getWishlistSimilar(marker: string, langCode?: string, signPrice?: string, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get "similar to wishlist" products by an explicit list of productIds (POST body).
      * @handleName getWishlistSimilarByProductIds