actly 1.2.0 → 1.3.0

package/dist/errors.d.ts

@@ -1,51 +1,15 @@
-/**
- * Actly error taxonomy.
- *
- * Six classes (one abstract base + five concrete). Each carries a stable
- * `code` field so consumers can switch on strings instead of brittle
- * `instanceof` chains across realm boundaries (e.g. errors serialised
- * over IPC).
- *
- * # Why these six?
- *
- *  - `ActlyError`         — abstract base for `instanceof ActlyError` checks
- *  - `ActlyAbortError`    — caller / signal cancellation
- *  - `TimeoutError`       — per-attempt deadline
- *  - `TotalTimeoutError`  — operation-wide budget
- *  - `RetryExhaustedError`— last attempt's error wrapped with context
- *  - `ValidationError`    — programmer error (invalid options)
- *
- * NO circuit/bulkhead/rate-limit errors — those policies don't exist in
- * core. Adding orphan error classes violates the "every feature must map
- * to a real runtime failure mode" rule.
- *
- * # `code` field
- *
- * Stable string identifier. Use this for switch statements and telemetry
- * tags. The class name can change across versions; `code` won't.
- */
-/** Base class for all actly errors. Enables `instanceof ActlyError` checks. */
 export declare abstract class ActlyError extends Error {
-    /** Stable string identifier. Use for telemetry / switch statements. */
     abstract readonly code: string;
-    /** The key associated with the failure, if applicable. */
     readonly key?: string;
     constructor(message: string, options?: {
         key?: string;
         cause?: unknown;
     });
+    toJSON(opts?: {
+        redact?: boolean;
+    }): Record<string, unknown>;
 }
-/**
- * Thrown when the caller's signal, per-attempt timeout, or total timeout
- * aborts the operation.
- *
- * `cause` carries the original abort reason (e.g. user-supplied
- * `controller.abort(new Error('user-cancelled'))` → cause.message is
- * 'user-cancelled').
- *
- * Wraps the raw abort reason in a typed error so consumers can
- * `instanceof`-check it consistently across all abort sources.
- */
+export declare function isActlyError(e: unknown): e is ActlyError;
 export declare class ActlyAbortError extends ActlyError {
     readonly code: "ACTLY_ABORT";
     constructor(options?: {
@@ -53,56 +17,22 @@ export declare class ActlyAbortError extends ActlyError {
         cause?: unknown;
     });
 }
-/**
- * Thrown when a per-attempt `timeout` deadline fires.
- *
- * Carries the configured `ms` so callers can log/alert precisely:
- *
- * ```ts
- * if (!result.ok && result.error instanceof TimeoutError) {
- *   console.log(`attempt timed out after ${result.error.ms}ms`)
- * }
- * ```
- */
 export declare class TimeoutError extends ActlyError {
     readonly code: "ACTLY_TIMEOUT";
     readonly ms: number;
     constructor(ms: number, options?: {
         key?: string;
+        cause?: unknown;
     });
 }
-/**
- * Thrown when the operation-wide `totalTimeout` budget fires.
- *
- * Distinct from `TimeoutError` (per-attempt) so callers can `instanceof`-check
- * which deadline fired.
- */
 export declare class TotalTimeoutError extends ActlyError {
     readonly code: "ACTLY_TOTAL_TIMEOUT";
     readonly ms: number;
     constructor(ms: number, options?: {
         key?: string;
+        cause?: unknown;
     });
 }
-/**
- * Thrown when all retry attempts are exhausted. The `lastError` is the
- * final attempt's error; `errors` is the array of all attempt errors
- * (useful for debugging patterns across retries).
- *
- * Wraps retry exhaustion with context so consumers can distinguish "single
- * fn error" from "retry exhausted after N attempts".
- *
- * # When is this thrown vs the raw error?
- *
- * `retryPolicy` throws `RetryExhaustedError` when:
- *  - `attempts > 1` AND
- *  - all attempts failed AND
- *  - the default `shouldRetry` (or user-supplied predicate) returned `true`
- *    for at least one failure
- *
- * If the user's `shouldRetry` returns `false` on the first attempt, the
- * raw error is thrown (no retries happened — not "exhausted").
- */
 export declare class RetryExhaustedError extends ActlyError {
     readonly code: "ACTLY_RETRY_EXHAUSTED";
     readonly attempts: number;
@@ -115,37 +45,50 @@ export declare class RetryExhaustedError extends ActlyError {
         errors: readonly unknown[];
     });
 }
-/**
- * Thrown on invalid option shapes / keys / store contracts. Programmer
- * errors — these surface synchronously, NOT as `ActFailure`, because the
- * caller's code is broken.
- *
- * Wraps the underlying `TypeError` / `RangeError` so consumers catching
- * `ActlyError` get a consistent type for all actly-thrown errors.
- */
 export declare class ValidationError extends ActlyError {
     readonly code: "ACTLY_VALIDATION";
     constructor(message: string, options?: {
         field?: string;
+        cause?: unknown;
     });
     readonly field?: string;
 }
-/** Thrown when a circuit breaker is open and blocks the call. */
 export declare class CircuitBreakerOpenError extends ActlyError {
     readonly code: "ACTLY_CIRCUIT_OPEN";
     readonly key: string;
-    constructor(key: string, ms: number);
+    constructor(key: string, ms: number, options?: {
+        cause?: unknown;
+    });
 }
-/** Thrown when a bulkhead is full (maxConcurrent reached, queue timed out). */
 export declare class BulkheadOverflowError extends ActlyError {
     readonly code: "ACTLY_BULKHEAD_FULL";
     readonly key: string;
-    constructor(key: string, maxConcurrent: number);
+    constructor(key: string, maxConcurrent: number, options?: {
+        cause?: unknown;
+    });
 }
-/** Thrown when a rate limit is exceeded. */
 export declare class RateLimitError extends ActlyError {
     readonly code: "ACTLY_RATE_LIMIT";
     readonly key: string;
-    constructor(key: string, maxCalls: number, windowMs: number);
+    constructor(key: string, maxCalls: number, windowMs: number, options?: {
+        cause?: unknown;
+    });
+}
+export declare class ResourceExhaustedError extends ActlyError {
+    readonly code: "ACTLY_RESOURCE_EXHAUSTED";
+    readonly current: number;
+    readonly limit: number;
+    constructor(current: number, limit: number, options?: {
+        cause?: unknown;
+    });
+}
+export declare class HedgeTimeoutError extends ActlyError {
+    readonly code: "ACTLY_HEDGE_TIMEOUT";
+    readonly delayMs: number;
+    constructor(options?: {
+        key?: string;
+        delayMs?: number;
+        cause?: unknown;
+    });
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,+EAA+E;AAC/E,8BAAsB,UAAW,SAAQ,KAAK;IAC5C,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;gBAET,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUzE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAS;gBAE1B,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKxD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAS;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;gBAEP,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;CAInD;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAS;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;gBAEP,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;CAInD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAS;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;gBAEvB,OAAO,EAAE;QACnB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,OAAO,CAAA;QAClB,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;KAC3B;CAWF;AAED;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAS;gBAE/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAMzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAID,iEAAiE;AACjE,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAS;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAIpC;AAED,+EAA+E;AAC/E,qBAAa,qBAAsB,SAAQ,UAAU;IACnD,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAS;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAI/C;AAED,4CAA4C;AAC5C,qBAAa,cAAe,SAAQ,UAAU;IAC5C,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAS;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAI5D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/errors.js

@@ -1,32 +1,4 @@
-/**
- * Actly error taxonomy.
- *
- * Six classes (one abstract base + five concrete). Each carries a stable
- * `code` field so consumers can switch on strings instead of brittle
- * `instanceof` chains across realm boundaries (e.g. errors serialised
- * over IPC).
- *
- * # Why these six?
- *
- *  - `ActlyError`         — abstract base for `instanceof ActlyError` checks
- *  - `ActlyAbortError`    — caller / signal cancellation
- *  - `TimeoutError`       — per-attempt deadline
- *  - `TotalTimeoutError`  — operation-wide budget
- *  - `RetryExhaustedError`— last attempt's error wrapped with context
- *  - `ValidationError`    — programmer error (invalid options)
- *
- * NO circuit/bulkhead/rate-limit errors — those policies don't exist in
- * core. Adding orphan error classes violates the "every feature must map
- * to a real runtime failure mode" rule.
- *
- * # `code` field
- *
- * Stable string identifier. Use this for switch statements and telemetry
- * tags. The class name can change across versions; `code` won't.
- */
-/** Base class for all actly errors. Enables `instanceof ActlyError` checks. */
 export class ActlyError extends Error {
-    /** The key associated with the failure, if applicable. */
     key;
     constructor(message, options) {
         super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);
@@ -34,22 +6,48 @@ export class ActlyError extends Error {
         if (options?.key !== undefined) {
             Object.defineProperty(this, 'key', { value: options.key, enumerable: true });
         }
-        // Restore prototype chain after Error inheritance (TS es2022 target
-        // may strip it). This ensures `instanceof` works correctly.
         Object.setPrototypeOf(this, new.target.prototype);
     }
+    toJSON(opts) {
+        const obj = {
+            name: this.name,
+            code: this.code,
+            message: opts?.redact ? sanitizeErrorMessageForJSON(this.message) : this.message,
+        };
+        if (this.key !== undefined)
+            obj.key = this.key;
+        if (this.stack !== undefined)
+            obj.stack = this.stack;
+        for (const prop of Object.keys(this)) {
+            if (!(prop in obj)) {
+                try {
+                    obj[prop] = this[prop];
+                }
+                catch {
+                }
+            }
+        }
+        return obj;
+    }
+}
+export function isActlyError(e) {
+    return (e != null &&
+        typeof e === 'object' &&
+        typeof e.code === 'string' &&
+        String(e.code).startsWith('ACTLY_'));
+}
+function sanitizeErrorMessageForJSON(msg) {
+    let str;
+    if (msg instanceof Error) {
+        str = String(msg.message ?? '');
+    }
+    else {
+        str = String(msg ?? '');
+    }
+    if (str.length > 4096)
+        str = str.slice(0, 4096) + '…[truncated]';
+    return str.replace(/[<>]/g, (c) => (c === '<' ? '&lt;' : '&gt;'));
 }
-/**
- * Thrown when the caller's signal, per-attempt timeout, or total timeout
- * aborts the operation.
- *
- * `cause` carries the original abort reason (e.g. user-supplied
- * `controller.abort(new Error('user-cancelled'))` → cause.message is
- * 'user-cancelled').
- *
- * Wraps the raw abort reason in a typed error so consumers can
- * `instanceof`-check it consistently across all abort sources.
- */
 export class ActlyAbortError extends ActlyError {
     code = 'ACTLY_ABORT';
     constructor(options) {
@@ -57,17 +55,6 @@ export class ActlyAbortError extends ActlyError {
         super(`Actly operation aborted: ${causeMsg}`, options);
     }
 }
-/**
- * Thrown when a per-attempt `timeout` deadline fires.
- *
- * Carries the configured `ms` so callers can log/alert precisely:
- *
- * ```ts
- * if (!result.ok && result.error instanceof TimeoutError) {
- *   console.log(`attempt timed out after ${result.error.ms}ms`)
- * }
- * ```
- */
 export class TimeoutError extends ActlyError {
     code = 'ACTLY_TIMEOUT';
     ms;
@@ -76,12 +63,6 @@ export class TimeoutError extends ActlyError {
         this.ms = ms;
     }
 }
-/**
- * Thrown when the operation-wide `totalTimeout` budget fires.
- *
- * Distinct from `TimeoutError` (per-attempt) so callers can `instanceof`-check
- * which deadline fired.
- */
 export class TotalTimeoutError extends ActlyError {
     code = 'ACTLY_TOTAL_TIMEOUT';
     ms;
@@ -90,25 +71,6 @@ export class TotalTimeoutError extends ActlyError {
         this.ms = ms;
     }
 }
-/**
- * Thrown when all retry attempts are exhausted. The `lastError` is the
- * final attempt's error; `errors` is the array of all attempt errors
- * (useful for debugging patterns across retries).
- *
- * Wraps retry exhaustion with context so consumers can distinguish "single
- * fn error" from "retry exhausted after N attempts".
- *
- * # When is this thrown vs the raw error?
- *
- * `retryPolicy` throws `RetryExhaustedError` when:
- *  - `attempts > 1` AND
- *  - all attempts failed AND
- *  - the default `shouldRetry` (or user-supplied predicate) returned `true`
- *    for at least one failure
- *
- * If the user's `shouldRetry` returns `false` on the first attempt, the
- * raw error is thrown (no retries happened — not "exhausted").
- */
 export class RetryExhaustedError extends ActlyError {
     code = 'ACTLY_RETRY_EXHAUSTED';
     attempts;
@@ -122,50 +84,51 @@ export class RetryExhaustedError extends ActlyError {
         this.errors = options.errors;
     }
 }
-/**
- * Thrown on invalid option shapes / keys / store contracts. Programmer
- * errors — these surface synchronously, NOT as `ActFailure`, because the
- * caller's code is broken.
- *
- * Wraps the underlying `TypeError` / `RangeError` so consumers catching
- * `ActlyError` get a consistent type for all actly-thrown errors.
- */
 export class ValidationError extends ActlyError {
     code = 'ACTLY_VALIDATION';
     constructor(message, options) {
-        super(message);
+        super(message, options);
         if (options?.field !== undefined) {
             Object.defineProperty(this, 'field', { value: options.field, enumerable: true });
         }
     }
     field;
 }
-// ─── Hardening error classes ─────────────────────────────────────────────────
-/** Thrown when a circuit breaker is open and blocks the call. */
 export class CircuitBreakerOpenError extends ActlyError {
     code = 'ACTLY_CIRCUIT_OPEN';
-    key;
-    constructor(key, ms) {
-        super(`Circuit breaker open for key "${key}" — retry after ${ms}ms`);
-        this.key = key;
+    constructor(key, ms, options) {
+        super(`Circuit breaker open for key "${key}" — retry after ${ms}ms`, { key, cause: options?.cause });
     }
 }
-/** Thrown when a bulkhead is full (maxConcurrent reached, queue timed out). */
 export class BulkheadOverflowError extends ActlyError {
     code = 'ACTLY_BULKHEAD_FULL';
-    key;
-    constructor(key, maxConcurrent) {
-        super(`Bulkhead full for key "${key}" — maxConcurrent ${maxConcurrent} reached`);
-        this.key = key;
+    constructor(key, maxConcurrent, options) {
+        super(`Bulkhead full for key "${key}" — maxConcurrent ${maxConcurrent} reached`, { key, cause: options?.cause });
     }
 }
-/** Thrown when a rate limit is exceeded. */
 export class RateLimitError extends ActlyError {
     code = 'ACTLY_RATE_LIMIT';
-    key;
-    constructor(key, maxCalls, windowMs) {
-        super(`Rate limit exceeded for key "${key}" — ${maxCalls} calls per ${windowMs}ms`);
-        this.key = key;
+    constructor(key, maxCalls, windowMs, options) {
+        super(`Rate limit exceeded for key "${key}" — ${maxCalls} calls per ${windowMs}ms`, { key, cause: options?.cause });
+    }
+}
+export class ResourceExhaustedError extends ActlyError {
+    code = 'ACTLY_RESOURCE_EXHAUSTED';
+    current;
+    limit;
+    constructor(current, limit, options) {
+        super(`Actly: resource exhausted — ${current} in-flight calls exceed process limit ${limit}. ` +
+            `Set ACTLY_NO_INFLIGHT_LIMIT=1 to disable this guard (at your own risk).`, options);
+        this.current = current;
+        this.limit = limit;
+    }
+}
+export class HedgeTimeoutError extends ActlyError {
+    code = 'ACTLY_HEDGE_TIMEOUT';
+    delayMs;
+    constructor(options) {
+        const ms = options?.delayMs ?? 0;
+        super(`ACT hedge timed out after ${ms}ms`, options);
+        this.delayMs = ms;
     }
 }
-//# sourceMappingURL=errors.js.map

package/dist/index.cjs

@@ -1,30 +1,28 @@
 "use strict";
-// ─── Primary API ──────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.poolSize = exports.releaseController = exports.acquireController = exports.sanitizeError = exports.sanitizeErrorMessage = exports.createAsyncTenantStore = exports.createTenantStore = exports.drain = exports.createHealthCheck = exports.RateLimitError = exports.BulkheadOverflowError = exports.CircuitBreakerOpenError = exports.LIMITS = exports.computeDelay = exports.sanitizeKey = exports.isAbortError = exports.linkSignal = exports.sleep = exports.raceAbort = exports.anySignal = exports.ValidationError = exports.RetryExhaustedError = exports.TotalTimeoutError = exports.TimeoutError = exports.ActlyAbortError = exports.ActlyError = exports.isAsyncStore = exports.isSyncStore = exports.InMemoryStore = exports.REQUIRES_SYNC_STORE = exports.execute = exports.withStore = exports.invalidate = exports.act = void 0;
+exports.usePolicy = exports.noopPolicy = exports.poolSize = exports.releaseController = exports.acquireController = exports.sanitizeError = exports.sanitizeErrorMessage = exports.createAsyncTenantStore = exports.createTenantStore = exports.drainAll = exports.drain = exports.disableWatchdog = exports.unregisterWatchdogHooks = exports.registerWatchdogHooks = exports.enableWatchdog = exports.createHealthCheck = exports.ResourceExhaustedError = exports.RateLimitError = exports.BulkheadOverflowError = exports.CircuitBreakerOpenError = exports.LIMITS = exports.computeDelay = exports.sanitizeKey = exports.isAbortError = exports.linkSignal = exports.sleep = exports.raceAbort = exports.anySignal = exports.isActlyError = exports.ValidationError = exports.RetryExhaustedError = exports.TotalTimeoutError = exports.TimeoutError = exports.ActlyAbortError = exports.ActlyError = exports.isAsyncStore = exports.isSyncStore = exports.InMemoryStore = exports.REQUIRES_SYNC_STORE = exports.execute = exports.HedgeTimeoutError = exports.withStore = exports.invalidate = exports.act = void 0;
 var act_js_1 = require("./core/act.js");
 Object.defineProperty(exports, "act", { enumerable: true, get: function () { return act_js_1.act; } });
 Object.defineProperty(exports, "invalidate", { enumerable: true, get: function () { return act_js_1.invalidate; } });
 Object.defineProperty(exports, "withStore", { enumerable: true, get: function () { return act_js_1.withStore; } });
-// ─── Execution engine (for custom policy chains) ──────────────────────────────
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "HedgeTimeoutError", { enumerable: true, get: function () { return errors_js_1.HedgeTimeoutError; } });
 var executor_js_1 = require("./core/executor.js");
 Object.defineProperty(exports, "execute", { enumerable: true, get: function () { return executor_js_1.execute; } });
 Object.defineProperty(exports, "REQUIRES_SYNC_STORE", { enumerable: true, get: function () { return executor_js_1.REQUIRES_SYNC_STORE; } });
-// ─── Stores ───────────────────────────────────────────────────────────────────
 var memory_js_1 = require("./stores/memory.js");
 Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return memory_js_1.InMemoryStore; } });
 var base_js_1 = require("./stores/base.js");
 Object.defineProperty(exports, "isSyncStore", { enumerable: true, get: function () { return base_js_1.isSyncStore; } });
 Object.defineProperty(exports, "isAsyncStore", { enumerable: true, get: function () { return base_js_1.isAsyncStore; } });
-// ─── Error classes ────────────────────────────────────────────────────────────
-var errors_js_1 = require("./errors.js");
-Object.defineProperty(exports, "ActlyError", { enumerable: true, get: function () { return errors_js_1.ActlyError; } });
-Object.defineProperty(exports, "ActlyAbortError", { enumerable: true, get: function () { return errors_js_1.ActlyAbortError; } });
-Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_js_1.TimeoutError; } });
-Object.defineProperty(exports, "TotalTimeoutError", { enumerable: true, get: function () { return errors_js_1.TotalTimeoutError; } });
-Object.defineProperty(exports, "RetryExhaustedError", { enumerable: true, get: function () { return errors_js_1.RetryExhaustedError; } });
-Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_1.ValidationError; } });
-// ─── Utilities (for custom policy authors) ────────────────────────────────────
+var errors_js_2 = require("./errors.js");
+Object.defineProperty(exports, "ActlyError", { enumerable: true, get: function () { return errors_js_2.ActlyError; } });
+Object.defineProperty(exports, "ActlyAbortError", { enumerable: true, get: function () { return errors_js_2.ActlyAbortError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_js_2.TimeoutError; } });
+Object.defineProperty(exports, "TotalTimeoutError", { enumerable: true, get: function () { return errors_js_2.TotalTimeoutError; } });
+Object.defineProperty(exports, "RetryExhaustedError", { enumerable: true, get: function () { return errors_js_2.RetryExhaustedError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_2.ValidationError; } });
+Object.defineProperty(exports, "isActlyError", { enumerable: true, get: function () { return errors_js_2.isActlyError; } });
 var abort_js_1 = require("./utils/abort.js");
 Object.defineProperty(exports, "anySignal", { enumerable: true, get: function () { return abort_js_1.anySignal; } });
 Object.defineProperty(exports, "raceAbort", { enumerable: true, get: function () { return abort_js_1.raceAbort; } });
@@ -37,26 +35,31 @@ var backoff_js_1 = require("./utils/backoff.js");
 Object.defineProperty(exports, "computeDelay", { enumerable: true, get: function () { return backoff_js_1.computeDelay; } });
 var limits_js_1 = require("./utils/limits.js");
 Object.defineProperty(exports, "LIMITS", { enumerable: true, get: function () { return limits_js_1.LIMITS; } });
-// ─── Hardening: new error classes ────────────────────────────────────────────
-var errors_js_2 = require("./errors.js");
-Object.defineProperty(exports, "CircuitBreakerOpenError", { enumerable: true, get: function () { return errors_js_2.CircuitBreakerOpenError; } });
-Object.defineProperty(exports, "BulkheadOverflowError", { enumerable: true, get: function () { return errors_js_2.BulkheadOverflowError; } });
-Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_js_2.RateLimitError; } });
-// ─── Hardening: health check & graceful shutdown ─────────────────────────────
+var errors_js_3 = require("./errors.js");
+Object.defineProperty(exports, "CircuitBreakerOpenError", { enumerable: true, get: function () { return errors_js_3.CircuitBreakerOpenError; } });
+Object.defineProperty(exports, "BulkheadOverflowError", { enumerable: true, get: function () { return errors_js_3.BulkheadOverflowError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_js_3.RateLimitError; } });
+Object.defineProperty(exports, "ResourceExhaustedError", { enumerable: true, get: function () { return errors_js_3.ResourceExhaustedError; } });
 var health_js_1 = require("./core/health.js");
 Object.defineProperty(exports, "createHealthCheck", { enumerable: true, get: function () { return health_js_1.createHealthCheck; } });
+Object.defineProperty(exports, "enableWatchdog", { enumerable: true, get: function () { return health_js_1.enableWatchdog; } });
+Object.defineProperty(exports, "registerWatchdogHooks", { enumerable: true, get: function () { return health_js_1.registerWatchdogHooks; } });
+Object.defineProperty(exports, "unregisterWatchdogHooks", { enumerable: true, get: function () { return health_js_1.unregisterWatchdogHooks; } });
+Object.defineProperty(exports, "disableWatchdog", { enumerable: true, get: function () { return health_js_1.disableWatchdog; } });
 var shutdown_js_1 = require("./core/shutdown.js");
 Object.defineProperty(exports, "drain", { enumerable: true, get: function () { return shutdown_js_1.drain; } });
-// ─── Hardening: tenant isolation ─────────────────────────────────────────────
+Object.defineProperty(exports, "drainAll", { enumerable: true, get: function () { return shutdown_js_1.drainAll; } });
 var tenant_js_1 = require("./core/tenant.js");
 Object.defineProperty(exports, "createTenantStore", { enumerable: true, get: function () { return tenant_js_1.createTenantStore; } });
 Object.defineProperty(exports, "createAsyncTenantStore", { enumerable: true, get: function () { return tenant_js_1.createAsyncTenantStore; } });
-// ─── Hardening: error sanitization ───────────────────────────────────────────
 var sanitize_js_1 = require("./utils/sanitize.js");
 Object.defineProperty(exports, "sanitizeErrorMessage", { enumerable: true, get: function () { return sanitize_js_1.sanitizeErrorMessage; } });
 Object.defineProperty(exports, "sanitizeError", { enumerable: true, get: function () { return sanitize_js_1.sanitizeError; } });
-// ─── Hardening: AbortController pool ─────────────────────────────────────────
 var abortPool_js_1 = require("./utils/abortPool.js");
 Object.defineProperty(exports, "acquireController", { enumerable: true, get: function () { return abortPool_js_1.acquireController; } });
 Object.defineProperty(exports, "releaseController", { enumerable: true, get: function () { return abortPool_js_1.releaseController; } });
 Object.defineProperty(exports, "poolSize", { enumerable: true, get: function () { return abortPool_js_1.poolSize; } });
+var noop_js_1 = require("./policies/noop.js");
+Object.defineProperty(exports, "noopPolicy", { enumerable: true, get: function () { return noop_js_1.noopPolicy; } });
+var decorator_js_1 = require("./utils/decorator.js");
+Object.defineProperty(exports, "usePolicy", { enumerable: true, get: function () { return decorator_js_1.usePolicy; } });

package/dist/index.d.ts

@@ -1,25 +1,29 @@
 export { act, invalidate, withStore, } from './core/act.js';
 export type { ScopedActSync, ScopedActAsync, } from './core/act.js';
+export { HedgeTimeoutError, } from './errors.js';
 export { execute, REQUIRES_SYNC_STORE, } from './core/executor.js';
+export type { ExecutorInput, } from './core/executor.js';
+export type { ObservabilityContext, } from './observability.js';
 export { InMemoryStore } from './stores/memory.js';
 export type { InMemoryStoreOptions } from './stores/memory.js';
 export { isSyncStore, isAsyncStore, } from './stores/base.js';
-export { ActlyError, ActlyAbortError, TimeoutError, TotalTimeoutError, RetryExhaustedError, ValidationError, } from './errors.js';
-export type { ActlyEventType, ActlyEventBase, AttemptEvent, RetryEvent, CacheHitEvent, CacheMissEvent, DedupeJoinEvent, TimeoutEvent, FinalSuccessEvent, FinalFailureEvent, ActlyEvent, ObservabilityHooks, } from './observability.js';
-export type { ActFn, ActResult, ActSuccess, ActFailure, ActSource, ActOptions, RetryOptions, TimeoutOptions, DedupeOptions, CacheOptions, PolicyApplier, PolicyContext, RunMeta, StateStore, // alias for SyncStateStore (backwards compat)
-SyncStateStore, AsyncStateStore, AnyStateStore, } from './types/index.js';
+export { ActlyError, ActlyAbortError, TimeoutError, TotalTimeoutError, RetryExhaustedError, ValidationError, isActlyError, } from './errors.js';
+export type { ActlyEventType, ActlyEventBase, AttemptEvent, RetryEvent, CacheHitEvent, CacheMissEvent, DedupeJoinEvent, TimeoutEvent, FinalSuccessEvent, FinalFailureEvent, BackpressureEvent, WatchdogEvent, ActlyEvent, ObservabilityHooks, } from './observability.js';
+export type { ActFn, ActResult, ActSuccess, ActFailure, ActSource, ActOptions, RetryOptions, TimeoutOptions, DedupeOptions, CacheOptions, PolicyApplier, PolicyContext, RunMeta, StateStore, SyncStateStore, AsyncStateStore, AnyStateStore, } from './types/index.js';
 export { anySignal, raceAbort, sleep, linkSignal, isAbortError, } from './utils/abort.js';
 export { sanitizeKey, } from './utils/key.js';
 export { computeDelay, } from './utils/backoff.js';
 export { LIMITS, } from './utils/limits.js';
 export type { Limits } from './utils/limits.js';
-export { CircuitBreakerOpenError, BulkheadOverflowError, RateLimitError, } from './errors.js';
-export { createHealthCheck, } from './core/health.js';
-export type { HealthStatus } from './core/health.js';
-export { drain, } from './core/shutdown.js';
+export { CircuitBreakerOpenError, BulkheadOverflowError, RateLimitError, ResourceExhaustedError, } from './errors.js';
+export { createHealthCheck, enableWatchdog, registerWatchdogHooks, unregisterWatchdogHooks, disableWatchdog, } from './core/health.js';
+export type { HealthStatus, HealthCheckFn } from './core/health.js';
+export { drain, drainAll, } from './core/shutdown.js';
 export { createTenantStore, createAsyncTenantStore, } from './core/tenant.js';
 export type { TenantStoreOptions, TenantManager } from './core/tenant.js';
 export { sanitizeErrorMessage, sanitizeError, } from './utils/sanitize.js';
 export { acquireController, releaseController, poolSize, } from './utils/abortPool.js';
 export type { CircuitBreakerOptions, BulkheadOptions, RateLimitOptions, HedgeOptions, FallbackOptions, AuditOptions, AuditEntry, } from './types/index.js';
+export { noopPolicy, } from './policies/noop.js';
+export { usePolicy, } from './utils/decorator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,GAAG,EACH,UAAU,EACV,SAAS,GACV,MAAM,eAAe,CAAA;AAEtB,YAAY,EACV,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAA;AAItB,OAAO,EACL,OAAO,EACP,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAI3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,OAAO,EACL,WAAW,EACX,YAAY,GACb,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EACL,UAAU,EACV,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,aAAa,CAAA;AAIpB,YAAY,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAI3B,YAAY,EAEV,KAAK,EACL,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EAGV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EAGZ,aAAa,EACb,aAAa,EACb,OAAO,EAGP,UAAU,EAAS,8CAA8C;AACjE,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EACL,SAAS,EACT,SAAS,EACT,KAAK,EACL,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,WAAW,GACZ,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,YAAY,GACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,MAAM,GACP,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAI/C,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,GACf,MAAM,aAAa,CAAA;AAIpB,OAAO,EACL,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,EACL,KAAK,GACN,MAAM,oBAAoB,CAAA;AAI3B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAIzE,OAAO,EACL,oBAAoB,EACpB,aAAa,GACd,MAAM,qBAAqB,CAAA;AAI5B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,GACT,MAAM,sBAAsB,CAAA;AAI7B,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,UAAU,GACX,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,GAAG,EACH,UAAU,EACV,SAAS,GACV,MAAM,eAAe,CAAA;AAEtB,YAAY,EACV,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAA;AAItB,OAAO,EACL,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAIpB,OAAO,EACL,OAAO,EACP,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAI3B,YAAY,EACV,aAAa,GACd,MAAM,oBAAoB,CAAA;AAI3B,YAAY,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAI3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,OAAO,EACL,WAAW,EACX,YAAY,GACb,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EACL,UAAU,EACV,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAA;AAIpB,YAAY,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAI3B,YAAY,EAEV,KAAK,EACL,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EAGV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EAGZ,aAAa,EACb,aAAa,EACb,OAAO,EAGP,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EACL,SAAS,EACT,SAAS,EACT,KAAK,EACL,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,WAAW,GACZ,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,YAAY,GACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,MAAM,GACP,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAI/C,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEnE,OAAO,EACL,KAAK,EACL,QAAQ,GACT,MAAM,oBAAoB,CAAA;AAI3B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAIzE,OAAO,EACL,oBAAoB,EACpB,aAAa,GACd,MAAM,qBAAqB,CAAA;AAI5B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,GACT,MAAM,sBAAsB,CAAA;AAI7B,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,UAAU,GACX,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EACL,UAAU,GACX,MAAM,oBAAoB,CAAA;AAI3B,OAAO,EACL,SAAS,GACV,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -1,26 +1,18 @@
-// ─── Primary API ──────────────────────────────────────────────────────────────
 export { act, invalidate, withStore, } from './core/act.js';
-// ─── Execution engine (for custom policy chains) ──────────────────────────────
+export { HedgeTimeoutError, } from './errors.js';
 export { execute, REQUIRES_SYNC_STORE, } from './core/executor.js';
-// ─── Stores ───────────────────────────────────────────────────────────────────
 export { InMemoryStore } from './stores/memory.js';
 export { isSyncStore, isAsyncStore, } from './stores/base.js';
-// ─── Error classes ────────────────────────────────────────────────────────────
-export { ActlyError, ActlyAbortError, TimeoutError, TotalTimeoutError, RetryExhaustedError, ValidationError, } from './errors.js';
-// ─── Utilities (for custom policy authors) ────────────────────────────────────
+export { ActlyError, ActlyAbortError, TimeoutError, TotalTimeoutError, RetryExhaustedError, ValidationError, isActlyError, } from './errors.js';
 export { anySignal, raceAbort, sleep, linkSignal, isAbortError, } from './utils/abort.js';
 export { sanitizeKey, } from './utils/key.js';
 export { computeDelay, } from './utils/backoff.js';
 export { LIMITS, } from './utils/limits.js';
-// ─── Hardening: new error classes ────────────────────────────────────────────
-export { CircuitBreakerOpenError, BulkheadOverflowError, RateLimitError, } from './errors.js';
-// ─── Hardening: health check & graceful shutdown ─────────────────────────────
-export { createHealthCheck, } from './core/health.js';
-export { drain, } from './core/shutdown.js';
-// ─── Hardening: tenant isolation ─────────────────────────────────────────────
+export { CircuitBreakerOpenError, BulkheadOverflowError, RateLimitError, ResourceExhaustedError, } from './errors.js';
+export { createHealthCheck, enableWatchdog, registerWatchdogHooks, unregisterWatchdogHooks, disableWatchdog, } from './core/health.js';
+export { drain, drainAll, } from './core/shutdown.js';
 export { createTenantStore, createAsyncTenantStore, } from './core/tenant.js';
-// ─── Hardening: error sanitization ───────────────────────────────────────────
 export { sanitizeErrorMessage, sanitizeError, } from './utils/sanitize.js';
-// ─── Hardening: AbortController pool ─────────────────────────────────────────
 export { acquireController, releaseController, poolSize, } from './utils/abortPool.js';
-//# sourceMappingURL=index.js.map
+export { noopPolicy, } from './policies/noop.js';
+export { usePolicy, } from './utils/decorator.js';

package/dist/observability.cjs

@@ -1,45 +1,6 @@
 "use strict";
-/**
- * Observability hooks.
- *
- * Eight event types covering the entire lifecycle of an `act()` call.
- *
- * # Contract
- *
- * When `options.observability` is `null`/`undefined` (the common case),
- * no event objects are allocated and no function calls are made. The
- * hot path is a single null-check per policy decision.
- *
- * When hooks ARE registered, events are allocated lazily — only when the
- * corresponding event actually fires. A cache hit doesn't allocate an
- * `onRetry` event, for example.
- *
- * # Event shape
- *
- * Every event carries `key`, `traceId`, and `timestamp` for correlation.
- * Event-specific fields are on the same object (no nesting) for flat
- * destructuring in user code.
- *
- * # Ordering
- *
- * For a successful fresh call with retries:
- *   onAttempt (1) → onAttempt (2) → onRetry (1→2) → onAttempt (3) → onFinalSuccess
- *
- * For a cache hit:
- *   onCacheHit → onFinalSuccess
- *
- * For a dedupe joiner:
- *   onDedupeJoin → onFinalSuccess (or onFinalFailure)
- *
- * For a timeout:
- *   onAttempt → onTimeout → onFinalFailure
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasObservers = hasObservers;
-/**
- * Quick null-check helper. Policies call this once at decision points; if
- * it returns false, no further observability work is done.
- */
 function hasObservers(ctx) {
     return ctx.observability != null;
 }