@marianmeres/ecsuite 1.2.0 → 1.3.2

package/AGENTS.md

@@ -169,6 +169,19 @@ const suite = createECSuite({
 });
 ```
 
+### Selective Initialization
+
+```typescript
+// Skip auth-gated domains for guest users
+const suite = createECSuite({
+	adapters: { cart: myCartAdapter, order: myOrderAdapter },
+	initializeDomains: ["cart", "wishlist", "payment"],
+});
+
+// Later, when user authenticates
+await suite.initialize(["order", "customer"]);
+```
+
 ### Subscribing to Store (Svelte-compatible)
 
 ```typescript

package/dist/suite.d.ts

@@ -7,7 +7,7 @@
 import { type Subscriber, type Unsubscriber } from "@marianmeres/pubsub";
 import type { CartAdapter, CustomerAdapter, OrderAdapter, PaymentAdapter, ProductAdapter, WishlistAdapter } from "./types/adapter.js";
 import type { DomainContext, DomainError, DomainState } from "./types/state.js";
-import type { DomainName, ECSuiteEvent, ECSuiteEventType } from "./types/events.js";
+import type { DomainName, ECSuiteEvent, ECSuiteEventType, InitializableDomainName } from "./types/events.js";
 import { CartManager } from "./domains/cart.js";
 import { WishlistManager } from "./domains/wishlist.js";
 import { OrderManager } from "./domains/order.js";
@@ -41,6 +41,8 @@ export interface ECSuiteConfig {
     productCacheTtl?: number;
     /** Auto-initialize on creation (default: true) */
     autoInitialize?: boolean;
+    /** Domains to initialize (default: all). Used by both autoInitialize and manual initialize(). */
+    initializeDomains?: InitializableDomainName[];
 }
 /**
  * Main ECSuite class - orchestrates all e-commerce domain managers.
@@ -74,8 +76,24 @@ export declare class ECSuite {
     /** Product domain manager (read-only with caching) */
     readonly product: ProductManager;
     constructor(config?: ECSuiteConfig);
-    /** Initialize all domains */
-    initialize(): Promise<void>;
+    /** Initialize domains. When called without arguments, initializes all domains.
+     * Pass an array of domain names to selectively initialize specific domains.
+     *
+     * @param domains - Optional list of domains to initialize (default: all)
+     *
+     * @example
+     * ```typescript
+     * // Initialize all domains (default)
+     * await suite.initialize();
+     *
+     * // Initialize only cart and wishlist (skip auth-gated domains for guests)
+     * await suite.initialize(["cart", "wishlist"]);
+     *
+     * // Later, initialize order domain when user authenticates
+     * await suite.initialize(["order", "customer"]);
+     * ```
+     */
+    initialize(domains?: InitializableDomainName[]): Promise<void>;
     /** Update context across all domains */
     setContext(context: DomainContext): void;
     /** Get the current context */

package/dist/suite.js

@@ -91,21 +91,38 @@ export class ECSuite {
         });
         // Auto-initialize if configured
         if (config.autoInitialize !== false) {
-            this.initialize();
+            this.initialize(config.initializeDomains);
         }
     }
-    /** Initialize all domains */
-    async initialize() {
-        this.#clog.debug("initializing all domains");
-        await Promise.all([
-            this.cart.initialize(),
-            this.wishlist.initialize(),
-            this.order.initialize(),
-            this.customer.initialize(),
-            this.payment.initialize(),
-            // Note: ProductManager doesn't have initialize() - it's lazy-loaded
-        ]);
-        this.#clog.debug("all domains initialized");
+    /** Initialize domains. When called without arguments, initializes all domains.
+     * Pass an array of domain names to selectively initialize specific domains.
+     *
+     * @param domains - Optional list of domains to initialize (default: all)
+     *
+     * @example
+     * ```typescript
+     * // Initialize all domains (default)
+     * await suite.initialize();
+     *
+     * // Initialize only cart and wishlist (skip auth-gated domains for guests)
+     * await suite.initialize(["cart", "wishlist"]);
+     *
+     * // Later, initialize order domain when user authenticates
+     * await suite.initialize(["order", "customer"]);
+     * ```
+     */
+    async initialize(domains) {
+        const all = [
+            "cart",
+            "wishlist",
+            "order",
+            "customer",
+            "payment",
+        ];
+        const toInit = domains ?? all;
+        this.#clog.debug("initializing domains", toInit);
+        await Promise.all(toInit.map((name) => this[name].initialize()));
+        this.#clog.debug("domains initialized", toInit);
     }
     /** Update context across all domains */
     setContext(context) {

package/dist/types/events.d.ts

@@ -8,6 +8,8 @@ import type { UUID } from "@marianmeres/collection-types";
 import type { DomainError, DomainState } from "./state.js";
 /** Domain identifiers */
 export type DomainName = "cart" | "wishlist" | "order" | "customer" | "payment" | "product";
+/** Domain names that support initialize() (excludes product which is fully lazy) */
+export type InitializableDomainName = Exclude<DomainName, "product">;
 /** Event types emitted by the suite */
 export type ECSuiteEventType = "domain:state:changed" | "domain:error" | "domain:synced" | "cart:item:added" | "cart:item:updated" | "cart:item:removed" | "cart:cleared" | "wishlist:item:added" | "wishlist:item:removed" | "wishlist:cleared" | "order:created" | "order:fetched" | "customer:updated" | "customer:fetched" | "payment:fetched" | "payment:initiated" | "payment:captured" | "product:fetched";
 /** Base event data */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@marianmeres/ecsuite",
-	"version": "1.2.0",
+	"version": "1.3.2",
 	"type": "module",
 	"main": "dist/mod.js",
 	"types": "dist/mod.d.ts",