actly 1.1.0 → 1.2.0

package/dist/core/executor.cjs

@@ -3,22 +3,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.REQUIRES_SYNC_STORE = void 0;
 exports.execute = execute;
 const base_js_1 = require("../stores/base.js");
-// Symbol stamped onto PolicyApplier functions by dedupePolicy.
-// Lets execute() detect a dedupe policy without importing the policy module
-// (which would create a circular dep) or doing fragile name-sniffing.
+/**
+ * Symbol stamped onto `PolicyApplier` functions by `dedupePolicy`.
+ *
+ * Lets `execute()` detect a dedupe policy without importing the policy
+ * module (which would create a circular dep) or doing fragile name-sniffing.
+ */
 exports.REQUIRES_SYNC_STORE = Symbol('actly.requiresSyncStore');
 /**
  * Pure execution engine.
  *
- * This file imports nothing from /policies.
- * It operates on PolicyApplier<T> — a type alias defined in /types.
- * Policy implementations live in /policies and are wired in core/act.ts.
+ * This file imports nothing from `/policies`. It operates on `PolicyApplier<T>`
+ * — a type alias defined in `/types`. Policy implementations live in
+ * `/policies` and are wired in `core/act.ts`.
+ *
+ * # Public API
+ *
+ * Exported so consumers can build custom policy chains with explicit stores
+ * (e.g. for SSR request isolation or multi-tenant scenarios where the
+ * module-level default store is wrong).
  */
 async function execute(input) {
     // Guard: if any policy in the chain requires a sync store, the provided
     // store must be synchronous. An async store + dedupePolicy is a silent
-    // correctness failure, not just a performance issue — catch it here rather
-    // than letting it produce subtly wrong dedupe behaviour at runtime.
+    // correctness failure — catch it here rather than letting it produce
+    // subtly wrong dedupe behaviour at runtime.
     const needsSync = input.policies.some(p => p[exports.REQUIRES_SYNC_STORE]);
     if (needsSync && !(0, base_js_1.isSyncStore)(input.store)) {
         throw new Error('Actly: dedupePolicy requires a SyncStateStore (store._sync === true). ' +
@@ -29,9 +38,12 @@ async function execute(input) {
         key: input.key,
         store: input.store,
         meta: input.meta,
+        // Thread observability through. Policies read this lazily.
+        observability: input.observability,
     };
     // Build the call chain from inside out.
     // reduceRight ensures policies[0] becomes the outermost wrapper (runs first).
     const wrapped = input.policies.reduceRight((inner, applyPolicy) => applyPolicy(inner, ctx), input.fn);
-    return wrapped();
+    // Call the outermost wrapper with the root signal.
+    return wrapped(input.signal);
 }

package/dist/core/executor.d.ts

@@ -1,13 +1,19 @@
-import type { ActFn, PolicyApplier, AnyStateStore, RunMeta } from '../types/index.js';
+import type { ActFn, PolicyApplier, AnyStateStore, RunMeta, ObservabilityContext } from '../types/index.js';
+/**
+ * Symbol stamped onto `PolicyApplier` functions by `dedupePolicy`.
+ *
+ * Lets `execute()` detect a dedupe policy without importing the policy
+ * module (which would create a circular dep) or doing fragile name-sniffing.
+ */
 export declare const REQUIRES_SYNC_STORE: unique symbol;
 export interface ExecutorInput<T> {
     key: string;
     fn: ActFn<T>;
     /**
      * Policies ordered outermost -> innermost.
-     * policies[0] intercepts first; policies[last] is closest to fn.
+     * `policies[0]` intercepts first; `policies[last]` is closest to `fn`.
      *
-     * Canonical order: [totalTimeout, cache, dedupe, retry, timeout]
+     * Canonical order: `[totalTimeout, cache, dedupe, retry, timeout]`
      *   totalTimeout -> hard wall-clock budget over the entire operation
      *   cache        -> a hit skips everything below it
      *   dedupe       -> collapses concurrent callers before retry fires
@@ -17,13 +23,32 @@ export interface ExecutorInput<T> {
     policies: ReadonlyArray<PolicyApplier<T>>;
     store: AnyStateStore;
     meta: RunMeta;
+    /**
+     * Root AbortSignal for the operation. Propagated inward through the
+     * policy chain: each policy receives it as the `signal` argument to
+     * its wrapped `ActFn`. The outermost policy may layer its own signal
+     * (e.g. `totalTimeoutPolicy` arms a timer) and pass the composite
+     * inward.
+     */
+    signal: AbortSignal;
+    /**
+     * Observability context. When present, policies emit events
+     * via the hooks. When absent (the common case), zero overhead.
+     */
+    observability?: ObservabilityContext;
 }
 /**
  * Pure execution engine.
  *
- * This file imports nothing from /policies.
- * It operates on PolicyApplier<T> — a type alias defined in /types.
- * Policy implementations live in /policies and are wired in core/act.ts.
+ * This file imports nothing from `/policies`. It operates on `PolicyApplier<T>`
+ * — a type alias defined in `/types`. Policy implementations live in
+ * `/policies` and are wired in `core/act.ts`.
+ *
+ * # Public API
+ *
+ * Exported so consumers can build custom policy chains with explicit stores
+ * (e.g. for SSR request isolation or multi-tenant scenarios where the
+ * module-level default store is wrong).
  */
 export declare function execute<T>(input: ExecutorInput<T>): Promise<T>;
 //# sourceMappingURL=executor.d.ts.map

package/dist/core/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EAEb,aAAa,EACb,OAAO,EACR,MAAM,mBAAmB,CAAA;AAM1B,eAAO,MAAM,mBAAmB,eAAoC,CAAA;AAEpE,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,GAAG,EAAO,MAAM,CAAA;IAChB,EAAE,EAAQ,KAAK,CAAC,CAAC,CAAC,CAAA;IAClB;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,KAAK,EAAK,aAAa,CAAA;IACvB,IAAI,EAAM,OAAO,CAAA;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA8BpE"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EAEb,aAAa,EACb,OAAO,EACP,oBAAoB,EACrB,MAAM,mBAAmB,CAAA;AAG1B;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,eAAoC,CAAA;AAEpE,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,GAAG,EAAO,MAAM,CAAA;IAChB,EAAE,EAAQ,KAAK,CAAC,CAAC,CAAC,CAAA;IAClB;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,KAAK,EAAK,aAAa,CAAA;IACvB,IAAI,EAAM,OAAO,CAAA;IACjB;;;;;;OAMG;IACH,MAAM,EAAI,WAAW,CAAA;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAiCpE"}

package/dist/core/executor.js

@@ -1,20 +1,29 @@
 import { isSyncStore } from '../stores/base.js';
-// Symbol stamped onto PolicyApplier functions by dedupePolicy.
-// Lets execute() detect a dedupe policy without importing the policy module
-// (which would create a circular dep) or doing fragile name-sniffing.
+/**
+ * Symbol stamped onto `PolicyApplier` functions by `dedupePolicy`.
+ *
+ * Lets `execute()` detect a dedupe policy without importing the policy
+ * module (which would create a circular dep) or doing fragile name-sniffing.
+ */
 export const REQUIRES_SYNC_STORE = Symbol('actly.requiresSyncStore');
 /**
  * Pure execution engine.
  *
- * This file imports nothing from /policies.
- * It operates on PolicyApplier<T> — a type alias defined in /types.
- * Policy implementations live in /policies and are wired in core/act.ts.
+ * This file imports nothing from `/policies`. It operates on `PolicyApplier<T>`
+ * — a type alias defined in `/types`. Policy implementations live in
+ * `/policies` and are wired in `core/act.ts`.
+ *
+ * # Public API
+ *
+ * Exported so consumers can build custom policy chains with explicit stores
+ * (e.g. for SSR request isolation or multi-tenant scenarios where the
+ * module-level default store is wrong).
  */
 export async function execute(input) {
     // Guard: if any policy in the chain requires a sync store, the provided
     // store must be synchronous. An async store + dedupePolicy is a silent
-    // correctness failure, not just a performance issue — catch it here rather
-    // than letting it produce subtly wrong dedupe behaviour at runtime.
+    // correctness failure — catch it here rather than letting it produce
+    // subtly wrong dedupe behaviour at runtime.
     const needsSync = input.policies.some(p => p[REQUIRES_SYNC_STORE]);
     if (needsSync && !isSyncStore(input.store)) {
         throw new Error('Actly: dedupePolicy requires a SyncStateStore (store._sync === true). ' +
@@ -25,10 +34,13 @@ export async function execute(input) {
         key: input.key,
         store: input.store,
         meta: input.meta,
+        // Thread observability through. Policies read this lazily.
+        observability: input.observability,
     };
     // Build the call chain from inside out.
     // reduceRight ensures policies[0] becomes the outermost wrapper (runs first).
     const wrapped = input.policies.reduceRight((inner, applyPolicy) => applyPolicy(inner, ctx), input.fn);
-    return wrapped();
+    // Call the outermost wrapper with the root signal.
+    return wrapped(input.signal);
 }
 //# sourceMappingURL=executor.js.map

package/dist/core/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,+DAA+D;AAC/D,4EAA4E;AAC5E,sEAAsE;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAA;AAqBpE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,KAAuB;IACtD,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,oEAAoE;IACpE,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CACnC,CAAC,CAAC,EAAE,CAAE,CAA4D,CAAC,mBAAmB,CAAC,CACxF,CAAA;IACD,IAAI,SAAS,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,wEAAwE;YACxE,uDAAuD;YACvD,kEAAkE,CACnE,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAkB;QACzB,GAAG,EAAI,KAAK,CAAC,GAAG;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAG,KAAK,CAAC,IAAI;KAClB,CAAA;IAED,wCAAwC;IACxC,8EAA8E;IAC9E,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,CACxC,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,EAC/C,KAAK,CAAC,EAAE,CACT,CAAA;IAED,OAAO,OAAO,EAAE,CAAA;AAClB,CAAC"}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAA;AAkCpE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,KAAuB;IACtD,wEAAwE;IACxE,uEAAuE;IACvE,qEAAqE;IACrE,4CAA4C;IAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CACnC,CAAC,CAAC,EAAE,CAAE,CAA4D,CAAC,mBAAmB,CAAC,CACxF,CAAA;IACD,IAAI,SAAS,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,wEAAwE;YACxE,uDAAuD;YACvD,kEAAkE,CACnE,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAkB;QACzB,GAAG,EAAI,KAAK,CAAC,GAAG;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAG,KAAK,CAAC,IAAI;QACjB,2DAA2D;QAC3D,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAA;IAED,wCAAwC;IACxC,8EAA8E;IAC9E,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,CACxC,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,EAC/C,KAAK,CAAC,EAAE,CACT,CAAA;IAED,mDAAmD;IACnD,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC"}

package/dist/core/health.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInflight = registerInflight;
+exports.unregisterInflight = unregisterInflight;
+exports.recordError = recordError;
+exports.recordSuccess = recordSuccess;
+exports.createHealthCheck = createHealthCheck;
+let globalInflight = 0;
+let startTime = Date.now();
+let globalLastError;
+let globalLastSuccessAt;
+function registerInflight(_scope) {
+    globalInflight++;
+}
+function unregisterInflight(_scope) {
+    globalInflight = Math.max(0, globalInflight - 1);
+}
+function recordError(_scope, code, message) {
+    globalLastError = { code, message, timestamp: Date.now() };
+}
+function recordSuccess(_scope) {
+    globalLastSuccessAt = Date.now();
+}
+function createHealthCheck(store) {
+    return () => {
+        return {
+            storeSize: store.size(),
+            pendingInflight: globalInflight,
+            uptimeMs: Date.now() - startTime,
+            lastError: globalLastError,
+            lastSuccessAt: globalLastSuccessAt,
+        };
+    };
+}

package/dist/core/health.d.ts

@@ -0,0 +1,18 @@
+import type { InMemoryStore } from '../stores/memory.js';
+export interface HealthStatus {
+    storeSize: number;
+    pendingInflight: number;
+    uptimeMs: number;
+    lastError?: {
+        code: string;
+        message: string;
+        timestamp: number;
+    };
+    lastSuccessAt?: number;
+}
+export declare function registerInflight(_scope: string): void;
+export declare function unregisterInflight(_scope: string): void;
+export declare function recordError(_scope: string, code: string, message: string): void;
+export declare function recordSuccess(_scope: string): void;
+export declare function createHealthCheck(store: InMemoryStore): () => HealthStatus;
+//# sourceMappingURL=health.d.ts.map

package/dist/core/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/core/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAOD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,YAAY,CAU1E"}

package/dist/core/health.js

@@ -0,0 +1,28 @@
+let globalInflight = 0;
+let startTime = Date.now();
+let globalLastError;
+let globalLastSuccessAt;
+export function registerInflight(_scope) {
+    globalInflight++;
+}
+export function unregisterInflight(_scope) {
+    globalInflight = Math.max(0, globalInflight - 1);
+}
+export function recordError(_scope, code, message) {
+    globalLastError = { code, message, timestamp: Date.now() };
+}
+export function recordSuccess(_scope) {
+    globalLastSuccessAt = Date.now();
+}
+export function createHealthCheck(store) {
+    return () => {
+        return {
+            storeSize: store.size(),
+            pendingInflight: globalInflight,
+            uptimeMs: Date.now() - startTime,
+            lastError: globalLastError,
+            lastSuccessAt: globalLastSuccessAt,
+        };
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/core/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/core/health.ts"],"names":[],"mappings":"AAUA,IAAI,cAAc,GAAG,CAAC,CAAA;AACtB,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;AAC1B,IAAI,eAAiF,CAAA;AACrF,IAAI,mBAAuC,CAAA;AAE3C,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,cAAc,EAAE,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,GAAG,CAAC,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,IAAY,EAAE,OAAe;IACvE,eAAe,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,OAAO,GAAG,EAAE;QACV,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE;YACvB,eAAe,EAAE,cAAc;YAC/B,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAChC,SAAS,EAAE,eAAe;YAC1B,aAAa,EAAE,mBAAmB;SACnC,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/core/shutdown.cjs

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDrainable = registerDrainable;
+exports.unregisterDrainable = unregisterDrainable;
+exports.drain = drain;
+const drainStates = new Map();
+function getState(scope) {
+    let s = drainStates.get(scope);
+    if (!s) {
+        s = { inflight: 0, resolvers: [] };
+        drainStates.set(scope, s);
+    }
+    return s;
+}
+function registerDrainable(scope = 'default') {
+    getState(scope).inflight++;
+}
+function unregisterDrainable(scope = 'default') {
+    const s = getState(scope);
+    s.inflight = Math.max(0, s.inflight - 1);
+    if (s.inflight === 0) {
+        for (const r of s.resolvers)
+            r();
+        s.resolvers = [];
+    }
+}
+/**
+ * Wait for all in-flight act() calls in this scope to settle.
+ * Returns true if all settled within timeoutMs, false if timed out.
+ */
+async function drain(timeoutMs, scope = 'default') {
+    const s = getState(scope);
+    if (s.inflight === 0)
+        return true;
+    return new Promise((resolve) => {
+        let resolved = false;
+        const resolver = () => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timer);
+            // Remove this resolver from the array
+            const idx = s.resolvers.indexOf(resolver);
+            if (idx >= 0)
+                s.resolvers.splice(idx, 1);
+            resolve(true);
+        };
+        const timer = setTimeout(() => {
+            if (resolved)
+                return;
+            resolved = true;
+            // Remove this resolver from the array on timeout
+            const idx = s.resolvers.indexOf(resolver);
+            if (idx >= 0)
+                s.resolvers.splice(idx, 1);
+            resolve(false);
+        }, timeoutMs);
+        s.resolvers.push(resolver);
+    });
+}

package/dist/core/shutdown.d.ts

@@ -0,0 +1,8 @@
+export declare function registerDrainable(scope?: string): void;
+export declare function unregisterDrainable(scope?: string): void;
+/**
+ * Wait for all in-flight act() calls in this scope to settle.
+ * Returns true if all settled within timeoutMs, false if timed out.
+ */
+export declare function drain(timeoutMs: number, scope?: string): Promise<boolean>;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/core/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAaA,wBAAgB,iBAAiB,CAAC,KAAK,SAAY,GAAG,IAAI,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAY,GAAG,IAAI,CAO3D;AAED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BlF"}

package/dist/core/shutdown.js

@@ -0,0 +1,56 @@
+const drainStates = new Map();
+function getState(scope) {
+    let s = drainStates.get(scope);
+    if (!s) {
+        s = { inflight: 0, resolvers: [] };
+        drainStates.set(scope, s);
+    }
+    return s;
+}
+export function registerDrainable(scope = 'default') {
+    getState(scope).inflight++;
+}
+export function unregisterDrainable(scope = 'default') {
+    const s = getState(scope);
+    s.inflight = Math.max(0, s.inflight - 1);
+    if (s.inflight === 0) {
+        for (const r of s.resolvers)
+            r();
+        s.resolvers = [];
+    }
+}
+/**
+ * Wait for all in-flight act() calls in this scope to settle.
+ * Returns true if all settled within timeoutMs, false if timed out.
+ */
+export async function drain(timeoutMs, scope = 'default') {
+    const s = getState(scope);
+    if (s.inflight === 0)
+        return true;
+    return new Promise((resolve) => {
+        let resolved = false;
+        const resolver = () => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timer);
+            // Remove this resolver from the array
+            const idx = s.resolvers.indexOf(resolver);
+            if (idx >= 0)
+                s.resolvers.splice(idx, 1);
+            resolve(true);
+        };
+        const timer = setTimeout(() => {
+            if (resolved)
+                return;
+            resolved = true;
+            // Remove this resolver from the array on timeout
+            const idx = s.resolvers.indexOf(resolver);
+            if (idx >= 0)
+                s.resolvers.splice(idx, 1);
+            resolve(false);
+        }, timeoutMs);
+        s.resolvers.push(resolver);
+    });
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/core/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8D,CAAA;AAEzF,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;QAClC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAK,GAAG,SAAS;IACjD,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAK,GAAG,SAAS;IACnD,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAA;IACxC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS;YAAE,CAAC,EAAE,CAAA;QAChC,CAAC,CAAC,SAAS,GAAG,EAAE,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,SAAiB,EAAE,KAAK,GAAG,SAAS;IAC9D,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEjC,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,sCAAsC;YACtC,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACzC,IAAI,GAAG,IAAI,CAAC;gBAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;YACxC,OAAO,CAAC,IAAI,CAAC,CAAA;QACf,CAAC,CAAA;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,iDAAiD;YACjD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACzC,IAAI,GAAG,IAAI,CAAC;gBAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;YACxC,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC,EAAE,SAAS,CAAC,CAAA;QAEb,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/core/tenant.cjs

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTenantStore = createTenantStore;
+exports.createAsyncTenantStore = createAsyncTenantStore;
+const memory_js_1 = require("../stores/memory.js");
+const act_js_1 = require("./act.js");
+const limits_js_1 = require("../utils/limits.js");
+/**
+ * Manages per-tenant stores for multi-tenant isolation.
+ * Each tenant gets its own InMemoryStore — cache/dedupe entries
+ * cannot leak across tenants.
+ */
+function createTenantStore(options = {}) {
+    const maxSize = options.maxSize ?? limits_js_1.LIMITS.DEFAULT_STORE_MAX_SIZE;
+    const autoCleanup = options.autoCleanup ?? true;
+    const cleanupIntervalMs = options.cleanupIntervalMs ?? 60_000;
+    const tenants = new Map();
+    return {
+        get(tenantId) {
+            let entry = tenants.get(tenantId);
+            if (!entry) {
+                const store = new memory_js_1.InMemoryStore({ maxSize, autoCleanup, cleanupIntervalMs });
+                const scoped = (0, act_js_1.withStore)(store);
+                entry = { store, scoped };
+                tenants.set(tenantId, entry);
+            }
+            return entry.scoped;
+        },
+        evict(tenantId) {
+            const entry = tenants.get(tenantId);
+            if (entry) {
+                entry.store.destroy();
+                tenants.delete(tenantId);
+            }
+        },
+        size() {
+            return tenants.size;
+        },
+        destroy() {
+            for (const [, entry] of tenants) {
+                entry.store.destroy();
+            }
+            tenants.clear();
+        },
+    };
+}
+/**
+ * Async tenant manager for async stores (Redis, DynamoDB, etc).
+ * Each tenant gets its own store instance with prefixed keys.
+ */
+function createAsyncTenantStore(storeFactory) {
+    const tenants = new Map();
+    return {
+        get(tenantId) {
+            let entry = tenants.get(tenantId);
+            if (!entry) {
+                const store = storeFactory(tenantId);
+                const scoped = (0, act_js_1.withStore)(store);
+                entry = { store, scoped };
+                tenants.set(tenantId, entry);
+            }
+            return entry.scoped;
+        },
+        evict(tenantId) {
+            tenants.delete(tenantId);
+        },
+        size() {
+            return tenants.size;
+        },
+    };
+}

package/dist/core/tenant.d.ts

@@ -0,0 +1,29 @@
+import type { ScopedActSync, ScopedActAsync } from './act.js';
+import type { AsyncStateStore } from '../stores/base.js';
+export interface TenantStoreOptions {
+    maxSize?: number;
+    autoCleanup?: boolean;
+    cleanupIntervalMs?: number;
+}
+export interface TenantManager {
+    get(tenantId: string): ScopedActSync | ScopedActAsync;
+    evict(tenantId: string): void;
+    size(): number;
+    destroy(): void;
+}
+/**
+ * Manages per-tenant stores for multi-tenant isolation.
+ * Each tenant gets its own InMemoryStore — cache/dedupe entries
+ * cannot leak across tenants.
+ */
+export declare function createTenantStore(options?: TenantStoreOptions): TenantManager;
+/**
+ * Async tenant manager for async stores (Redis, DynamoDB, etc).
+ * Each tenant gets its own store instance with prefixed keys.
+ */
+export declare function createAsyncTenantStore(storeFactory: (tenantId: string) => AsyncStateStore): {
+    get: (tenantId: string) => ScopedActAsync;
+    evict: (tenantId: string) => void;
+    size: () => number;
+};
+//# sourceMappingURL=tenant.d.ts.map

package/dist/core/tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../../src/core/tenant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE7D,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGxE,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,CAAA;IACrD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,IAAI,IAAI,MAAM,CAAA;IACd,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa,CAsCjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,eAAe,GAClD;IACD,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAA;IACzC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,IAAI,EAAE,MAAM,MAAM,CAAA;CACnB,CAuBA"}

package/dist/core/tenant.js

@@ -0,0 +1,68 @@
+import { InMemoryStore } from '../stores/memory.js';
+import { withStore } from './act.js';
+import { LIMITS } from '../utils/limits.js';
+/**
+ * Manages per-tenant stores for multi-tenant isolation.
+ * Each tenant gets its own InMemoryStore — cache/dedupe entries
+ * cannot leak across tenants.
+ */
+export function createTenantStore(options = {}) {
+    const maxSize = options.maxSize ?? LIMITS.DEFAULT_STORE_MAX_SIZE;
+    const autoCleanup = options.autoCleanup ?? true;
+    const cleanupIntervalMs = options.cleanupIntervalMs ?? 60_000;
+    const tenants = new Map();
+    return {
+        get(tenantId) {
+            let entry = tenants.get(tenantId);
+            if (!entry) {
+                const store = new InMemoryStore({ maxSize, autoCleanup, cleanupIntervalMs });
+                const scoped = withStore(store);
+                entry = { store, scoped };
+                tenants.set(tenantId, entry);
+            }
+            return entry.scoped;
+        },
+        evict(tenantId) {
+            const entry = tenants.get(tenantId);
+            if (entry) {
+                entry.store.destroy();
+                tenants.delete(tenantId);
+            }
+        },
+        size() {
+            return tenants.size;
+        },
+        destroy() {
+            for (const [, entry] of tenants) {
+                entry.store.destroy();
+            }
+            tenants.clear();
+        },
+    };
+}
+/**
+ * Async tenant manager for async stores (Redis, DynamoDB, etc).
+ * Each tenant gets its own store instance with prefixed keys.
+ */
+export function createAsyncTenantStore(storeFactory) {
+    const tenants = new Map();
+    return {
+        get(tenantId) {
+            let entry = tenants.get(tenantId);
+            if (!entry) {
+                const store = storeFactory(tenantId);
+                const scoped = withStore(store);
+                entry = { store, scoped };
+                tenants.set(tenantId, entry);
+            }
+            return entry.scoped;
+        },
+        evict(tenantId) {
+            tenants.delete(tenantId);
+        },
+        size() {
+            return tenants.size;
+        },
+    };
+}
+//# sourceMappingURL=tenant.js.map

package/dist/core/tenant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.js","sourceRoot":"","sources":["../../src/core/tenant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAIpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAe3C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAE;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,sBAAsB,CAAA;IAChE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAA;IAC/C,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,MAAM,CAAA;IAE7D,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2D,CAAA;IAElF,OAAO;QACL,GAAG,CAAC,QAAgB;YAClB,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAA;gBAC5E,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAkB,CAAA;gBAChD,KAAK,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;gBACzB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC9B,CAAC;YACD,OAAO,KAAK,CAAC,MAAM,CAAA;QACrB,CAAC;QAED,KAAK,CAAC,QAAgB;YACpB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;gBACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC;QAED,IAAI;YACF,OAAO,OAAO,CAAC,IAAI,CAAA;QACrB,CAAC;QAED,OAAO;YACL,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;gBAChC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;YACvB,CAAC;YACD,OAAO,CAAC,KAAK,EAAE,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAAmD;IAMnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8D,CAAA;IAErF,OAAO;QACL,GAAG,CAAC,QAAgB;YAClB,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;gBACpC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAmB,CAAA;gBACjD,KAAK,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;gBACzB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC9B,CAAC;YACD,OAAO,KAAK,CAAC,MAAM,CAAA;QACrB,CAAC;QAED,KAAK,CAAC,QAAgB;YACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC1B,CAAC;QAED,IAAI;YACF,OAAO,OAAO,CAAC,IAAI,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC"}