oneentry 1.0.157 → 1.0.159

package/README.md

@@ -175,12 +175,32 @@ const api = defineOneEntry('your-url', {
 })
 ```
 
+## TypeScript Types
+
+All public interfaces and types are re-exported from the package root, so deep paths are not needed:
+
+```ts
+import type { IAttributeSchemaItem, IAttributeSetsEntity } from 'oneentry'
+```
+
+The same set is also available from a types-only entry point, if you prefer to keep type imports separate from the runtime import:
+
+```ts
+import type { IProductsEntity, IUserEntity } from 'oneentry/types'
+```
+
+Deep imports such as `oneentry/dist/attribute-sets/attributeSetsInterfaces` still work and remain supported.
+
 ## Optional Features
 
 ### API Response Validation
 
 OneEntry SDK supports optional validation of API responses using Zod. This feature is disabled by default and can be enabled for development or critical operations.
 
+Zod and the response schemas are loaded on demand, the first time a response actually has to be validated. Leaving validation off — the default — keeps them out of the code your app loads. Socket.io is deferred the same way, until the first `WS.connect()`.
+
+Together that means a project calling a single SDK method loads about **43 kB minified (9.7 kB gzip)** instead of 536 kB, with Zod, the schemas and Socket.io landing in chunks that are never requested. The SDK is published as both CommonJS and ESM (`sideEffects: false`), so bundlers can tree-shake the rest.
+
 ### Time Intervals
 
 Attributes of type `timeInterval` return a compact recurrence rule (an anchor date, daily time ranges and repeat flags), not a ready list of slots. The SDK does not expand it eagerly — a single attribute can materialize into megabytes of slots — so resolve it on demand with `expandAttributeTimeIntervals`, passing the window you actually render:

package/changelog.md

@@ -1,5 +1,94 @@
 # SDK Change Log
 
+## v.1.0.159
+
+### What's New
+
+- All public types are now re-exported from the package root and from a new `oneentry/types` entry point, so deep paths are no longer required:
+
+  ```ts
+  // before
+  import type { IAttributeSchemaItem, IAttributeSetsEntity } from 'oneentry/dist/attribute-sets/attributeSetsInterfaces';
+
+  // now — either of these
+  import type { IAttributeSchemaItem, IAttributeSetsEntity } from 'oneentry';
+  import type { IAttributeSchemaItem, IAttributeSetsEntity } from 'oneentry/types';
+  ```
+
+  Every interface and type of every module (`base/utils` included) is available under both entry points. Old `oneentry/dist/<module>/<module>Interfaces` imports keep working — nothing is removed.
+
+- The package now ships an ESM build alongside the CommonJS one (`"module": "esm/index.js"`, `"sideEffects": false`), so bundlers can tree-shake the SDK. Node keeps resolving the CommonJS build through `"main"` — there is no `"exports"` map, so every existing deep import resolves exactly as before.
+
+### What's Changed
+
+- **Zod is no longer part of the import graph unless validation is enabled.** Response schemas used to be imported statically by every `*Api` module, which pulled Zod into every consumer's bundle even though `validation.enabled` defaults to `false`. Schemas and the validation helpers are now loaded on demand, the first time a response actually has to be validated.
+
+  For a project that calls a single method and leaves validation off, the code that actually loads drops from **536 kB to 83 kB** minified (110 kB → 22 kB gzip): Zod and the per-module schemas (341 kB) end up in chunks that are never requested. That figure assumes a bundler doing code splitting — the default in webpack, Vite and Rollup. A bundle forced into a single file still shrinks, but only to ~427 kB, since Zod is then inlined even though it never runs.
+
+  With `validation.enabled: true` the behaviour is unchanged; the schemas are simply fetched when first needed. In Node, `require('oneentry')` no longer loads Zod at startup either.
+
+  No public API changed. The internal `_validateResponse` helper became `async` — relevant only if you extended the SDK's base classes yourself.
+
+- **Socket.io is no longer bundled unless you open a socket.** `WS.connect()` keeps its synchronous signature and still returns a `Socket`, but `socket.io-client` (~41 kB) is now imported the first time `connect()` is called. Until the chunk resolves, the returned object queues whatever you do with it — `on`, `emit`, `disconnect` — and replays it onto the real socket in the same tick it is created, before the connection can deliver anything, so no event is lost.
+
+  Reading connection state early stays accurate, because a freshly created socket is not connected either: `id` is `undefined` and `connected` is `false` in both the old and the new behaviour. The one difference: a method that has to *return* something (e.g. `listeners()`) cannot answer before the chunk arrives, and nested objects such as `socket.io` are reachable only once loaded. Registering handlers and emitting — the normal use — is unaffected.
+
+  Together with the Zod change, a project that calls one method and never opens a socket now loads **43 kB minified (9.7 kB gzip), down from 536 kB (110 kB gzip)**.
+
+## v.1.0.158
+
+### What's New
+
+- Orders > `IOrderStatus` — four fields the API already returns on every status are now declared (all optional, like the rest of the interface): `axis` (status pipeline, e.g. `"payment"`), `isCancelFinal`, `isFinalSuccess`, `isMapped`.
+
+- Base > `ILocalizeInfo` — `plainContent?: string | null` is now declared: pages and menus return it as the plain-text counterpart of `htmlContent`.
+
+- Events > `IFormSubscriptionsResponse` — new exported type describing the container returned by `getFormSubscriptions`: `{ items: IListFormSubscription[]; total: number }`.
+
+- Products > `IProductsResponse` — `totalFound?: number` is now declared (and validated by `ProductsResponseSchema`): block product endpoints (`similarProducts` inside blocks, cart/wishlist recommendations, frequently ordered) return it alongside `items`/`total`; the `Products.getProducts*` endpoints do not, hence optional.
+
+- Products > `IProductBlockSimilarRule` — rewritten to match the real shape of `customSettings.similarProductRules[]` returned by `getProductBlockById`: `{ id, title, attributeMarker, conditionMarker, conditionValue, statusMarker, pageUrls }`. The previously declared fields (`property`, `includes`, `keywords`, `strict`) never occurred in real data.
+
+- AttributeSets > `IAttributeSchemaItem` — six fields the API already returns on schema items are now declared (all optional):
+  - `position` — sort position of the field inside the set;
+  - `listTitles` (`IListTitle[]`) — options for `list`/`radioButton`/`entity` fields, with extended data or linked-entity values;
+  - `listType` — for `entity` fields, how the option list is organized (e.g. `"nested"`);
+  - `moduleIdentifier` — for `entity` fields, the module the linked entities are taken from (e.g. `"catalog"`);
+  - `parentId` — parent field id, `null` for top-level;
+  - `splitParts` (`number[] | boolean`) — for split-price fields, ids of the schema fields the price is split into, `false` when the field does not split.
+
+### What's Changed
+
+- **Breaking** — Blocks > the ten recommendation methods (`getCartComplement`, `getCartComplementByProductIds`, `getCartSimilar`, `getCartSimilarByProductIds`, `getWishlistSimilar`, `getWishlistSimilarByProductIds`, `getTrending`, `getPersonalRecommendations`, `getRecentlyViewed`, `getRepeatPurchase`) — the declared return type is corrected from `IProductsEntity[]` to `IProductsResponse`: the endpoints actually return a container `{ items, total, totalFound? }`, and the SDK does not unwrap it. Type-level fix only; the response itself is unchanged — code that (incorrectly) called `res.map(...)` never worked on real data.
+
+- **Breaking** — Products > `getProductsByVectorSearch` — the declared return type is corrected from `IProductsEntity[]` to `IProductsResponse`: the endpoint returns `{ items, total }`. Type-level fix only.
+
+- **Breaking** — Events > `getFormSubscriptions` — the declared return type is corrected from `IListFormSubscription[]` to the new `IFormSubscriptionsResponse`: the endpoint returns `{ items, total }`. Type-level fix only.
+
+- Orders > `IBaseOrdersEntity.totalSum` — type corrected from `string` to `number`: `createOrder` and `updateOrderByMarkerAndId` return a number (e.g. `285`), which the Zod schemas (`CreateOrderResponseSchema` / `UpdateOrderResponseSchema`) already declared. `IOrderByMarkerEntity.totalSum` stays `string` — the by-marker endpoints really return `"300.00"`.
+
+- Forms > `IFormAttribute` — the seven auth/notification flags (`isLogin`, `isSignUp`, `isPassword`, `isSignUpRequired`, `isNotificationEmail`, `isNotificationPhonePush`, `isNotificationPhoneSMS`) are now optional: the API returns them only on attributes of sign-in/sign-up forms.
+
+- Forms > `IFormLocalizeInfo` — `title` is now optional: the API returns an empty `localizeInfos` object when the form has no localization for the requested language (all list responses on the test project). Same for attribute localization: Base > `IAttributeLocalizeInfo.title` is now optional too.
+
+- Forms > `IFormAttributeAdditionalField.marker` — now optional: entries of `additionalFields` arrive as `{ type, value }`, the marker is the map key.
+
+- Forms > a form with no attributes now returns `attributes: []`: the API sends an empty **object** (`{}`) in that case, and the SDK normalizes it to an empty array in `_normalizeAttr`, so `attributes` is always `IFormAttribute[]` and `form.attributes.map(...)` is safe on every form.
+
+- Events > `IContentApiEvent.module` — now optional: system events not bound to a module (e.g. `send_code`, `registration_event`) come without it.
+
+- Discounts > `IDiscountsEntity.attributeSetId` and `IDiscountValue.maxAmount` — type widened to `number | null`: both arrive as `null` when not configured.
+
+- Products > `IProductBlockProductConfig` — `quantity` and `countElementsPerRow` are now optional: `customSettings.productConfig` arrives as an empty object when the block is not configured.
+
+- Base > `ITimeIntervalRange.period` — type corrected to `number | null`: ranges that are not sliced into slots carry `period: null`. The runtime (`expandTimeIntervals`) already guarded against it; only the type (and the internal narrowing in `_addSlotsFromRanges`) changed.
+
+- AttributeSets > `getAttributesByMarker` — the declared return type is corrected from `IAttributeSetsEntity[]` (the attribute **set** entity: `id`, `schema`, `createdDate`, …) to `IAttributesSetsEntity[]` — the attribute entities the endpoint actually returns (`marker`, `type`, `value`, `listTitles`, `validators`, `localizeInfos`, `additionalFields`, …). Type-level fix only; runtime behavior and the response itself are unchanged.
+
+- AttributeSets > `IAttributeSchemaItem` — `initialValue` and `isPrice` are now optional: the API omits them on some fields (`isPrice` is returned only on product attribute sets).
+
+- Base > `ITimeIntervalSchedule` — `fullMonth` and `selectedYear` are now optional: the API returns them only when the schedule is pinned to a month/year rather than an explicit date `range`.
+
 ## v.1.0.157
 
 ### What's New

package/dist/admins/adminsApi.js

@@ -1,10 +1,44 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
-const adminsSchemas_1 = require("./adminsSchemas");
+const lazySchema_1 = __importDefault(require("../base/lazySchema"));
+const schema = (0, lazySchema_1.default)(() => Promise.resolve().then(() => __importStar(require('./adminsSchemas'))));
 /**
  * Controllers for working with users - admins.
  * @class AdminsApi
@@ -59,7 +93,7 @@ class AdminsApi extends asyncModules_1.default {
         };
         const response = await this._fetchPost(`?` + this._queryParamsToString(query), body);
         // Validate response if validation is enabled
-        const validated = this._validateResponse(response, adminsSchemas_1.AdminsResponseSchema);
+        const validated = await this._validateResponse(response, schema('AdminsResponseSchema'));
         return this._normalizeData(validated, langCode);
     }
 }

package/dist/attribute-sets/attributeSetsApi.d.ts

@@ -38,11 +38,11 @@ export default class AttributesSetsApi extends AsyncModules implements IAttribut
      * @handleName getAttributesByMarker
      * @param {string} marker - Attribute marker. Example: "productAttributes".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IAttributeSetsEntity[] | IError>} Returns an array of Attributes objects.
+     * @returns {Promise<IAttributesSetsEntity[] | IError>} Returns an array of Attributes objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributesByMarker getAttributesByMarker} documentation.
      */
-    getAttributesByMarker(marker: string, langCode?: string): Promise<IAttributeSetsEntity[] | IError>;
+    getAttributesByMarker(marker: string, langCode?: string): Promise<IAttributesSetsEntity[] | IError>;
     /**
      * Get a single attribute with data from the attribute sets.
      * @handleName getSingleAttributeByMarkerSet

package/dist/attribute-sets/attributeSetsApi.js

@@ -1,10 +1,44 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
-const attributeSetsSchemas_1 = require("./attributeSetsSchemas");
+const lazySchema_1 = __importDefault(require("../base/lazySchema"));
+const schema = (0, lazySchema_1.default)(() => Promise.resolve().then(() => __importStar(require('./attributeSetsSchemas'))));
 /**
  * Controllers for working with attributes - AttributesSetsApi.
  * @class AttributesSetsApi
@@ -49,7 +83,7 @@ class AttributesSetsApi extends asyncModules_1.default {
         };
         const result = await this._fetchGet(`?` + this._queryParamsToString(query));
         // Validate response if validation is enabled
-        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributeSetsResponseSchema);
+        const validated = await this._validateResponse(result, schema('AttributeSetsResponseSchema'));
         return this._normalizeData(validated, langCode);
     }
     /**
@@ -57,14 +91,14 @@ class AttributesSetsApi extends asyncModules_1.default {
      * @handleName getAttributesByMarker
      * @param {string} marker - Attribute marker. Example: "productAttributes".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IAttributeSetsEntity[] | IError>} Returns an array of Attributes objects.
+     * @returns {Promise<IAttributesSetsEntity[] | IError>} Returns an array of Attributes objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/attribute-sets/getAttributesByMarker getAttributesByMarker} documentation.
      */
     async getAttributesByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/${marker}/attributes?langCode=${langCode}`);
         // Validate response if validation is enabled
-        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributesArrayResponseSchema);
+        const validated = await this._validateResponse(result, schema('AttributesArrayResponseSchema'));
         return this._normalizeData(validated, langCode);
     }
     /**
@@ -80,7 +114,7 @@ class AttributesSetsApi extends asyncModules_1.default {
     async getSingleAttributeByMarkerSet(setMarker, attributeMarker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/${setMarker}/attributes/${attributeMarker}?langCode=${langCode}`);
         // Validate response if validation is enabled
-        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributeEntitySchema);
+        const validated = await this._validateResponse(result, schema('AttributeEntitySchema'));
         return this._normalizeData(validated, langCode);
     }
     /**
@@ -95,7 +129,7 @@ class AttributesSetsApi extends asyncModules_1.default {
     async getAttributeSetByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
         // Validate response if validation is enabled
-        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributeSetEntitySchema);
+        const validated = await this._validateResponse(result, schema('AttributeSetEntitySchema'));
         return this._normalizeData(validated, langCode);
     }
 }

package/dist/attribute-sets/attributeSetsInterfaces.d.ts

@@ -10,11 +10,11 @@ interface IAttributesSets {
      * @handleName getAttributesByMarker
      * @param {string} marker - The marker used to identify the attribute set. Example: "productAttributes".
      * @param {string} [langCode] - The language code for localization purposes. Default: 'en_US'.
-     * @returns {IAttributeSetsEntity[]} A promise that resolves to an array of attribute set entities or an error.
+     * @returns {IAttributesSetsEntity[]} A promise that resolves to an array of attribute entities or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method fetches attributes by a specific marker.
      */
-    getAttributesByMarker(marker: string, langCode: string): Promise<IAttributeSetsEntity[] | IError>;
+    getAttributesByMarker(marker: string, langCode: string): Promise<IAttributesSetsEntity[] | IError>;
     /**
      * Fetches a single attribute by its marker and the set marker.
      * @handleName getSingleAttributeByMarkerSet
@@ -137,35 +137,47 @@ interface IAttributesSetsEntity {
  * @interface IAttributeSchemaItem
  * @property {number} id - Unique identifier of the schema item. Example: 1.
  * @property {string} identifier - Field marker (machine name) within the schema. Example: "name".
- * @property {unknown} initialValue - Default value applied when the field is not filled.
- * @property {boolean} isPrice - Whether the field's numeric value is treated as the price for product entities. Example: false.
+ * @property {unknown} [initialValue] - Default value applied when the field is not filled. Optional — absent on some fields.
+ * @property {boolean} [isPrice] - Whether the field's numeric value is treated as the price for product entities. Optional — present on product (`forProducts`) attribute sets. Example: false.
  * @property {boolean} isVisible - Whether the field is exposed in the public API/UI. Example: true.
  * @property {IAttributeLocalizeInfo} localizeInfos - Localized labels for the field.
  * @property {boolean} original - Whether the field is part of the original (system) schema, not a user extension. Example: true.
  * @property {AttributeType} type - Attribute data type (e.g. "string", "file").
+ * @property {number} [position] - Sort position of the field inside the set. Optional. Example: 1.
+ * @property {IListTitle[]} [listTitles] - Options for `list`/`radioButton`/`entity` fields (with extended data or linked-entity values). Optional.
+ * @property {string} [listType] - For `entity` fields — how the option list is organized. Optional. Example: "nested".
+ * @property {string} [moduleIdentifier] - For `entity` fields — identifier of the module the linked entities are taken from. Optional. Example: "catalog".
+ * @property {number | null} [parentId] - Identifier of the parent field, `null` for top-level. Optional, seen on `groupOfImages` fields.
  * @property {Record<string, IAttributeSchemaItem>} [additionalFields] - Nested sub-fields keyed by marker. Optional.
  * @property {IAttributeValidators} [validators] - Validation rules for the field. Optional.
  * @property {boolean | string} [splitUnit] - Splitting unit configuration; `false` when disabled, otherwise the unit name (e.g. "percent"). Optional, used by numeric fields.
+ * @property {number[] | boolean} [splitParts] - For split-price fields — ids of the schema fields the price is split into (e.g. [2, 3]); `false` when the field does not split. Optional.
  * @property {boolean} [isCurrency] - Whether the field stores currency values. Optional.
  * @property {boolean} [splitPrice] - Whether the price is split between several fields. Optional.
  * @property {boolean} [isCompress] - Whether uploaded images are compressed. Optional, used by `image`/`groupOfImages` fields.
  * @property {boolean} [receiveValues] - For `timeInterval` fields — whether the field receives precomputed values. Optional.
  * @property {ITimeIntervalSchedule[]} [intervals] - For `timeInterval` fields — top-level schedule definition (separate from `localizeInfos.intervals`). Optional.
- * @property {unknown} [value] - For `timeInterval` fields — current value/state of the schedule. Optional.
+ * @property {unknown} [value] - Current value of the field: `null` on numeric fields without a value, an array of schedule groups on `timeInterval` fields. Optional.
  * @description Definition of a single field inside an attribute set's schema.
  */
 interface IAttributeSchemaItem {
     id: number;
     identifier: string;
-    initialValue: unknown;
-    isPrice: boolean;
+    initialValue?: unknown;
+    isPrice?: boolean;
     isVisible: boolean;
     localizeInfos: IAttributeLocalizeInfo;
     original: boolean;
     type: AttributeType;
+    position?: number;
+    listTitles?: IListTitle[];
+    listType?: string;
+    moduleIdentifier?: string;
+    parentId?: number | null;
     additionalFields?: Record<string, IAttributeSchemaItem>;
     validators?: IAttributeValidators;
     splitUnit?: boolean | string;
+    splitParts?: number[] | boolean;
     isCurrency?: boolean;
     splitPrice?: boolean;
     isCompress?: boolean;

package/dist/auth-provider/authProviderApi.js

@@ -1,11 +1,45 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 /* eslint-disable jsdoc/no-undefined-types */
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
-const authProviderSchemas_1 = require("./authProviderSchemas");
+const lazySchema_1 = __importDefault(require("../base/lazySchema"));
+const schema = (0, lazySchema_1.default)(() => Promise.resolve().then(() => __importStar(require('./authProviderSchemas'))));
 /**
  * Controllers for working with auth services.
  * @handle /api/content/users-auth-providers
@@ -93,7 +127,7 @@ class AuthProviderApi extends asyncModules_1.default {
         body['langCode'] = langCode;
         const result = await this._fetchPost(`/marker/${marker}/users/sign-up`, this._normalizePostBody(body, langCode));
         // Validate response if validation is enabled
-        const validated = this._validateResponse(result, authProviderSchemas_1.SignUpResponseSchema);
+        const validated = await this._validateResponse(result, schema('SignUpResponseSchema'));
         return this._normalizeData(validated);
     }
     /**
@@ -191,7 +225,7 @@ class AuthProviderApi extends asyncModules_1.default {
     async auth(marker, body) {
         const result = await this._fetchPost(`/marker/${marker}/users/auth`, body);
         // Validate response if validation is enabled
-        const validated = this._validateResponse(result, authProviderSchemas_1.AuthResponseSchema);
+        const validated = await this._validateResponse(result, schema('AuthResponseSchema'));
         if (!('statusCode' in validated)) {
             this.state.accessToken = validated.accessToken;
             this.state.refreshToken = validated.refreshToken;
@@ -310,7 +344,7 @@ class AuthProviderApi extends asyncModules_1.default {
     async getAuthProviders(langCode = this.state.lang, offset = 0, limit = 30) {
         const result = await this._fetchGet(`?langCode=${langCode}&offset=${offset}&limit=${limit}`);
         // Validate response if validation is enabled
-        const validated = this._validateResponse(result, authProviderSchemas_1.AuthProvidersResponseSchema);
+        const validated = await this._validateResponse(result, schema('AuthProvidersResponseSchema'));
         return this._normalizeData(validated);
     }
     /**

package/dist/base/asyncModules.d.ts

@@ -29,11 +29,13 @@ export default abstract class AsyncModules extends SyncModules {
     /**
      * Validates API response against a Zod schema (optional)
      * @param {unknown} data - The data to validate
-     * @param {z.ZodSchema<T>} [schema] - Optional Zod schema for validation
-     * @returns {T | IError} Validated data or error object
-     * @description Validates response data if validation is enabled in config
+     * @param {() => Promise<z.ZodSchema<T>>} [loadSchema] - Optional loader resolving to the Zod schema for validation
+     * @returns {Promise<T | IError>} Validated data or error object
+     * @description Validates response data if validation is enabled in config.
+     * The schema — and Zod itself — are imported on demand, so a project that leaves
+     * validation disabled (the default) never pulls Zod into its bundle.
      */
-    protected _validateResponse<T>(data: unknown, schema?: z.ZodSchema<T>): T | IError;
+    protected _validateResponse<T>(data: unknown, loadSchema?: () => Promise<z.ZodSchema<T>>): Promise<T | IError>;
     /**
      * Performs an HTTP GET request.
      * @param {string} path - The path to append to the base URL.

package/dist/base/asyncModules.js

@@ -1,10 +1,42 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const syncModules_1 = __importDefault(require("./syncModules"));
-const validation_1 = require("./validation");
 /**
  * Abstract class AsyncModules extends SyncModules to provide asynchronous HTTP request functionalities.
  * @description Abstract class AsyncModules extends SyncModules to provide asynchronous HTTP request functionalities.
@@ -43,22 +75,26 @@ class AsyncModules extends syncModules_1.default {
     /**
      * Validates API response against a Zod schema (optional)
      * @param {unknown} data - The data to validate
-     * @param {z.ZodSchema<T>} [schema] - Optional Zod schema for validation
-     * @returns {T | IError} Validated data or error object
-     * @description Validates response data if validation is enabled in config
+     * @param {() => Promise<z.ZodSchema<T>>} [loadSchema] - Optional loader resolving to the Zod schema for validation
+     * @returns {Promise<T | IError>} Validated data or error object
+     * @description Validates response data if validation is enabled in config.
+     * The schema — and Zod itself — are imported on demand, so a project that leaves
+     * validation disabled (the default) never pulls Zod into its bundle.
      */
-    _validateResponse(data, schema) {
+    async _validateResponse(data, loadSchema) {
         // Skip validation if not enabled or no schema provided
-        if (!this.state.validationEnabled || !schema) {
+        if (!this.state.validationEnabled || !loadSchema) {
             return data;
         }
         // Skip validation for error responses (statusCode indicates API error)
         if (this._isErrorResponse(data)) {
             return data;
         }
+        // Pull the schema and the Zod-backed validators only now that they are needed
+        const [schema, { validateResponse, validateResponseSafe }] = await Promise.all([loadSchema(), Promise.resolve().then(() => __importStar(require('./validation')))]);
         // Use strict or safe validation based on config
         if (this.state.validationStrictMode) {
-            const result = (0, validation_1.validateResponse)(schema, data, {
+            const result = validateResponse(schema, data, {
                 logErrors: this.state.validationLogErrors,
             });
             if (!result.success) {
@@ -78,7 +114,7 @@ class AsyncModules extends syncModules_1.default {
         }
         else {
             // Non-strict mode: log errors but return original data
-            return (0, validation_1.validateResponseSafe)(schema, data, this.state.validationLogErrors);
+            return validateResponseSafe(schema, data, this.state.validationLogErrors);
         }
     }
     /**

package/dist/base/syncModules.d.ts

@@ -145,7 +145,8 @@ export default abstract class SyncModules {
      *
      * **2. `attributes`** — form attributes, an array (or a marker map on some
      * endpoints); form-only boolean flags (`isLogin`, `isSignUp`, notifications)
-     * are additionally coerced from `null` to `false`.
+     * are additionally coerced from `null` to `false`. A form with no attributes
+     * arrives as an empty object `{}` — it is normalized to an empty array.
      *
      * **3. `type`** — a standalone attribute: an attribute-set entry, a form-data
      * field or a nested `additionalFields` entry. Same transformations, but there

package/dist/base/syncModules.js

@@ -313,7 +313,8 @@ class SyncModules {
      *
      * **2. `attributes`** — form attributes, an array (or a marker map on some
      * endpoints); form-only boolean flags (`isLogin`, `isSignUp`, notifications)
-     * are additionally coerced from `null` to `false`.
+     * are additionally coerced from `null` to `false`. A form with no attributes
+     * arrives as an empty object `{}` — it is normalized to an empty array.
      *
      * **3. `type`** — a standalone attribute: an attribute-set entry, a form-data
      * field or a nested `additionalFields` entry. Same transformations, but there
@@ -351,6 +352,14 @@ class SyncModules {
         // for forms attributes - forms attributes collections
         if ('attributes' in data) {
             const d = data.attributes;
+            // A form with no attributes arrives as an empty object `{}` — normalize
+            // it to an empty array, the container every non-empty form uses.
+            if (d &&
+                typeof d === 'object' &&
+                !Array.isArray(d) &&
+                Object.keys(d).length === 0) {
+                return { ...data, attributes: [] };
+            }
             Object.keys(d).forEach((attr) => {
                 this._normalizeAdditionalFields(d[attr]);
                 this._normalizeAttrValue(d[attr]);

package/dist/base/timeIntervals.js

@@ -136,13 +136,14 @@ function _addSlotsFromRanges(day, ranges, out) {
         const endMinutes = _toMinutes(range === null || range === void 0 ? void 0 : range.end);
         if (startMinutes === null || endMinutes === null)
             return;
-        // A non-positive period would never advance the cursor; a non-numeric one
-        // would concatenate into it.
-        if (!Number.isFinite(range.period) || range.period <= 0)
+        // A non-positive period would never advance the cursor; a null or
+        // non-numeric one would concatenate into it.
+        const period = range === null || range === void 0 ? void 0 : range.period;
+        if (typeof period !== 'number' || !Number.isFinite(period) || period <= 0)
             return;
-        for (let minutes = startMinutes; minutes + range.period <= endMinutes; minutes += range.period) {
+        for (let minutes = startMinutes; minutes + period <= endMinutes; minutes += period) {
             const from = day + minutes * _MS_PER_MINUTE;
-            const to = day + (minutes + range.period) * _MS_PER_MINUTE;
+            const to = day + (minutes + period) * _MS_PER_MINUTE;
             out.push([new Date(from).toISOString(), new Date(to).toISOString()]);
         }
     });