awaitly 1.0.0

package/dist/circuit-breaker.d.cts

@@ -0,0 +1,208 @@
+import { R as Result, A as AsyncResult } from './core-BuTBsR0x.cjs';
+
+/**
+ * Circuit Breaker for Steps
+ *
+ * Prevents cascading failures by tracking step failure rates and
+ * short-circuiting calls when a threshold is exceeded.
+ *
+ * Uses the circuit breaker pattern with three states:
+ * - CLOSED: Normal operation (steps executing)
+ * - OPEN: Fast-fail mode (steps blocked)
+ * - HALF_OPEN: Testing if service recovered
+ *
+ * @example
+ * ```typescript
+ * import { createCircuitBreaker } from 'awaitly';
+ *
+ * const breaker = createCircuitBreaker({
+ *   failureThreshold: 5,
+ *   resetTimeout: 30000,
+ *   halfOpenMax: 3,
+ * });
+ *
+ * const result = await workflow(async (step) => {
+ *   const data = await breaker.execute(
+ *     () => step(() => callExternalApi()),
+ *     { name: 'external-api' }
+ *   );
+ *   return data;
+ * });
+ * ```
+ */
+
+/**
+ * Circuit breaker state.
+ */
+type CircuitState = "CLOSED" | "OPEN" | "HALF_OPEN";
+/**
+ * Configuration for circuit breaker behavior.
+ */
+interface CircuitBreakerConfig {
+    /**
+     * Number of failures within the window before opening the circuit.
+     * @default 5
+     */
+    failureThreshold: number;
+    /**
+     * Time in ms to wait before transitioning from OPEN to HALF_OPEN.
+     * @default 30000 (30 seconds)
+     */
+    resetTimeout: number;
+    /**
+     * Time window in ms for counting failures.
+     * Failures older than this are discarded.
+     * @default 60000 (1 minute)
+     */
+    windowSize: number;
+    /**
+     * Maximum number of test requests allowed in HALF_OPEN state.
+     * If all succeed, circuit closes. If any fail, circuit reopens.
+     * @default 3
+     */
+    halfOpenMax: number;
+    /**
+     * Optional callback when circuit state changes.
+     */
+    onStateChange?: (from: CircuitState, to: CircuitState, name?: string) => void;
+}
+/**
+ * Error thrown when the circuit is open and calls are blocked.
+ */
+declare class CircuitOpenError extends Error {
+    readonly type: "CIRCUIT_OPEN";
+    readonly circuitName: string;
+    readonly state: CircuitState;
+    readonly retryAfterMs: number;
+    constructor(options: {
+        circuitName: string;
+        state: CircuitState;
+        retryAfterMs: number;
+        message?: string;
+    });
+}
+/**
+ * Type guard for CircuitOpenError.
+ */
+declare function isCircuitOpenError(error: unknown): error is CircuitOpenError;
+/**
+ * Circuit breaker statistics.
+ */
+interface CircuitBreakerStats {
+    state: CircuitState;
+    failureCount: number;
+    successCount: number;
+    lastFailureTime: number | null;
+    lastSuccessTime: number | null;
+    halfOpenSuccesses: number;
+}
+/**
+ * Circuit breaker instance for protecting external calls.
+ */
+interface CircuitBreaker {
+    /**
+     * Execute an operation with circuit breaker protection.
+     * Throws CircuitOpenError if the circuit is open.
+     *
+     * @param operation - The operation to execute
+     * @param options - Optional name for logging/metrics
+     * @returns The operation result
+     * @throws CircuitOpenError if circuit is open
+     */
+    execute<T>(operation: () => T | Promise<T>, options?: {
+        name?: string;
+    }): Promise<T>;
+    /**
+     * Execute a Result-returning operation with circuit breaker protection.
+     * Returns a CircuitOpenError result instead of throwing.
+     *
+     * @param operation - The operation returning a Result
+     * @param options - Optional name for logging/metrics
+     * @returns Result with the value or CircuitOpenError
+     */
+    executeResult<T, E>(operation: () => Result<T, E> | AsyncResult<T, E>, options?: {
+        name?: string;
+    }): AsyncResult<T, E | CircuitOpenError>;
+    /**
+     * Get current circuit state.
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit breaker statistics.
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Manually reset the circuit breaker to CLOSED state.
+     */
+    reset(): void;
+    /**
+     * Manually open the circuit (for testing or manual intervention).
+     */
+    forceOpen(): void;
+    /**
+     * Record a manual success (useful for health checks).
+     */
+    recordSuccess(): void;
+    /**
+     * Record a manual failure (useful for health checks).
+     */
+    recordFailure(error?: unknown): void;
+}
+/**
+ * Create a circuit breaker instance.
+ *
+ * @param name - Name for this circuit breaker (used in errors and logging)
+ * @param config - Configuration options
+ * @returns A CircuitBreaker instance
+ *
+ * @example
+ * ```typescript
+ * const apiBreaker = createCircuitBreaker('external-api', {
+ *   failureThreshold: 5,
+ *   resetTimeout: 30000,
+ * });
+ *
+ * // In workflow
+ * const data = await apiBreaker.execute(() =>
+ *   step(() => fetchFromApi(id))
+ * );
+ * ```
+ */
+declare function createCircuitBreaker(name: string, config?: Partial<CircuitBreakerConfig>): CircuitBreaker;
+/**
+ * Preset configurations for common use cases.
+ */
+declare const circuitBreakerPresets: {
+    /**
+     * Aggressive circuit breaker for critical paths.
+     * Opens quickly (3 failures) and recovers slowly (60s).
+     */
+    readonly critical: {
+        failureThreshold: number;
+        resetTimeout: number;
+        windowSize: number;
+        halfOpenMax: number;
+    };
+    /**
+     * Standard circuit breaker for typical API calls.
+     * Balanced between stability and availability.
+     */
+    readonly standard: {
+        failureThreshold: number;
+        resetTimeout: number;
+        windowSize: number;
+        halfOpenMax: number;
+    };
+    /**
+     * Lenient circuit breaker for non-critical operations.
+     * Opens slowly (10 failures) and recovers quickly (15s).
+     */
+    readonly lenient: {
+        failureThreshold: number;
+        resetTimeout: number;
+        windowSize: number;
+        halfOpenMax: number;
+    };
+};
+
+export { type CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerStats, CircuitOpenError, type CircuitState, circuitBreakerPresets, createCircuitBreaker, isCircuitOpenError };

package/dist/circuit-breaker.d.ts

@@ -0,0 +1,208 @@
+import { R as Result, A as AsyncResult } from './core-BuTBsR0x.js';
+
+/**
+ * Circuit Breaker for Steps
+ *
+ * Prevents cascading failures by tracking step failure rates and
+ * short-circuiting calls when a threshold is exceeded.
+ *
+ * Uses the circuit breaker pattern with three states:
+ * - CLOSED: Normal operation (steps executing)
+ * - OPEN: Fast-fail mode (steps blocked)
+ * - HALF_OPEN: Testing if service recovered
+ *
+ * @example
+ * ```typescript
+ * import { createCircuitBreaker } from 'awaitly';
+ *
+ * const breaker = createCircuitBreaker({
+ *   failureThreshold: 5,
+ *   resetTimeout: 30000,
+ *   halfOpenMax: 3,
+ * });
+ *
+ * const result = await workflow(async (step) => {
+ *   const data = await breaker.execute(
+ *     () => step(() => callExternalApi()),
+ *     { name: 'external-api' }
+ *   );
+ *   return data;
+ * });
+ * ```
+ */
+
+/**
+ * Circuit breaker state.
+ */
+type CircuitState = "CLOSED" | "OPEN" | "HALF_OPEN";
+/**
+ * Configuration for circuit breaker behavior.
+ */
+interface CircuitBreakerConfig {
+    /**
+     * Number of failures within the window before opening the circuit.
+     * @default 5
+     */
+    failureThreshold: number;
+    /**
+     * Time in ms to wait before transitioning from OPEN to HALF_OPEN.
+     * @default 30000 (30 seconds)
+     */
+    resetTimeout: number;
+    /**
+     * Time window in ms for counting failures.
+     * Failures older than this are discarded.
+     * @default 60000 (1 minute)
+     */
+    windowSize: number;
+    /**
+     * Maximum number of test requests allowed in HALF_OPEN state.
+     * If all succeed, circuit closes. If any fail, circuit reopens.
+     * @default 3
+     */
+    halfOpenMax: number;
+    /**
+     * Optional callback when circuit state changes.
+     */
+    onStateChange?: (from: CircuitState, to: CircuitState, name?: string) => void;
+}
+/**
+ * Error thrown when the circuit is open and calls are blocked.
+ */
+declare class CircuitOpenError extends Error {
+    readonly type: "CIRCUIT_OPEN";
+    readonly circuitName: string;
+    readonly state: CircuitState;
+    readonly retryAfterMs: number;
+    constructor(options: {
+        circuitName: string;
+        state: CircuitState;
+        retryAfterMs: number;
+        message?: string;
+    });
+}
+/**
+ * Type guard for CircuitOpenError.
+ */
+declare function isCircuitOpenError(error: unknown): error is CircuitOpenError;
+/**
+ * Circuit breaker statistics.
+ */
+interface CircuitBreakerStats {
+    state: CircuitState;
+    failureCount: number;
+    successCount: number;
+    lastFailureTime: number | null;
+    lastSuccessTime: number | null;
+    halfOpenSuccesses: number;
+}
+/**
+ * Circuit breaker instance for protecting external calls.
+ */
+interface CircuitBreaker {
+    /**
+     * Execute an operation with circuit breaker protection.
+     * Throws CircuitOpenError if the circuit is open.
+     *
+     * @param operation - The operation to execute
+     * @param options - Optional name for logging/metrics
+     * @returns The operation result
+     * @throws CircuitOpenError if circuit is open
+     */
+    execute<T>(operation: () => T | Promise<T>, options?: {
+        name?: string;
+    }): Promise<T>;
+    /**
+     * Execute a Result-returning operation with circuit breaker protection.
+     * Returns a CircuitOpenError result instead of throwing.
+     *
+     * @param operation - The operation returning a Result
+     * @param options - Optional name for logging/metrics
+     * @returns Result with the value or CircuitOpenError
+     */
+    executeResult<T, E>(operation: () => Result<T, E> | AsyncResult<T, E>, options?: {
+        name?: string;
+    }): AsyncResult<T, E | CircuitOpenError>;
+    /**
+     * Get current circuit state.
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit breaker statistics.
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Manually reset the circuit breaker to CLOSED state.
+     */
+    reset(): void;
+    /**
+     * Manually open the circuit (for testing or manual intervention).
+     */
+    forceOpen(): void;
+    /**
+     * Record a manual success (useful for health checks).
+     */
+    recordSuccess(): void;
+    /**
+     * Record a manual failure (useful for health checks).
+     */
+    recordFailure(error?: unknown): void;
+}
+/**
+ * Create a circuit breaker instance.
+ *
+ * @param name - Name for this circuit breaker (used in errors and logging)
+ * @param config - Configuration options
+ * @returns A CircuitBreaker instance
+ *
+ * @example
+ * ```typescript
+ * const apiBreaker = createCircuitBreaker('external-api', {
+ *   failureThreshold: 5,
+ *   resetTimeout: 30000,
+ * });
+ *
+ * // In workflow
+ * const data = await apiBreaker.execute(() =>
+ *   step(() => fetchFromApi(id))
+ * );
+ * ```
+ */
+declare function createCircuitBreaker(name: string, config?: Partial<CircuitBreakerConfig>): CircuitBreaker;
+/**
+ * Preset configurations for common use cases.
+ */
+declare const circuitBreakerPresets: {
+    /**
+     * Aggressive circuit breaker for critical paths.
+     * Opens quickly (3 failures) and recovers slowly (60s).
+     */
+    readonly critical: {
+        failureThreshold: number;
+        resetTimeout: number;
+        windowSize: number;
+        halfOpenMax: number;
+    };
+    /**
+     * Standard circuit breaker for typical API calls.
+     * Balanced between stability and availability.
+     */
+    readonly standard: {
+        failureThreshold: number;
+        resetTimeout: number;
+        windowSize: number;
+        halfOpenMax: number;
+    };
+    /**
+     * Lenient circuit breaker for non-critical operations.
+     * Opens slowly (10 failures) and recovers quickly (15s).
+     */
+    readonly lenient: {
+        failureThreshold: number;
+        resetTimeout: number;
+        windowSize: number;
+        halfOpenMax: number;
+    };
+};
+
+export { type CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerStats, CircuitOpenError, type CircuitState, circuitBreakerPresets, createCircuitBreaker, isCircuitOpenError };

package/dist/circuit-breaker.js

@@ -0,0 +1,2 @@
+var Q=e=>({ok:!0,value:e}),U=(e,p)=>({ok:!1,error:e,...p?.cause!==void 0?{cause:p.cause}:{}});var ae=e=>typeof e=="object"&&e!==null&&e.type==="UNEXPECTED_ERROR",W=Symbol.for("step_timeout_marker");function te(e){return typeof e!="object"||e===null?!1:e.type==="STEP_TIMEOUT"?!0:W in e}function ie(e){if(!(typeof e!="object"||e===null)){if(e.type==="STEP_TIMEOUT"){let p=e;return{timeoutMs:p.timeoutMs,stepName:p.stepName,stepKey:p.stepKey,attempt:p.attempt}}if(W in e)return e[W]}}var oe=Symbol("early-exit");function ce(e,p){return{[oe]:!0,error:e,meta:p}}function pe(e){return typeof e=="object"&&e!==null&&e[oe]===!0}var se=Symbol("mapper-exception");function le(e){return{[se]:!0,thrown:e}}function Ee(e){return typeof e=="object"&&e!==null&&e[se]===!0}function ye(e){return typeof e=="string"?{name:e}:e??{}}function Z(e,p){let{backoff:w,initialDelay:T,maxDelay:S,jitter:A}=p,k;switch(w){case"fixed":k=T;break;case"linear":k=T*e;break;case"exponential":k=T*Math.pow(2,e-1);break}if(k=Math.min(k,S),A){let o=k*.25*Math.random();k=k+o}return Math.floor(k)}function ee(e){return new Promise(p=>setTimeout(p,e))}var ne=Symbol("timeout");async function me(e,p,w){let T=new AbortController,S=p.error??{type:"STEP_TIMEOUT",stepName:w.name,stepKey:w.key,timeoutMs:p.ms,attempt:w.attempt},A,k=new Promise((g,f)=>{A=setTimeout(()=>{T.abort(),f({[ne]:!0,error:S})},p.ms)}),o;p.signal?o=Promise.resolve(e(T.signal)):o=Promise.resolve(e());try{return await Promise.race([o,k])}catch(g){if(typeof g=="object"&&g!==null&&g[ne]===!0){let f=g.error;if(typeof f=="object"&&f!==null&&f.type!=="STEP_TIMEOUT"){let D={timeoutMs:p.ms,stepName:w.name,stepKey:w.key,attempt:w.attempt};W in f?f[W]=D:Object.defineProperty(f,W,{value:D,enumerable:!1,writable:!0,configurable:!1})}throw f}throw g}finally{clearTimeout(A)}}var B={backoff:"exponential",initialDelay:100,maxDelay:3e4,jitter:!0,retryOn:()=>!0,onRetry:()=>{}};async function re(e,p){let{onError:w,onEvent:T,catchUnexpected:S,workflowId:A,context:k}=p&&typeof p=="object"?p:{},o=A??crypto.randomUUID(),g=!w&&!S,f=[],D=0,N=n=>n??`step_${++D}`,a=n=>{let h=n.context!==void 0||k===void 0?n:{...n,context:k};if(h.type==="step_success"){let K=h.stepId;for(let V=f.length-1;V>=0;V--){let $=f[V];if($.type==="race"&&!$.winnerId){$.winnerId=K;break}}}T?.(h,k)},b=ce,X=n=>pe(n),x=(n,h)=>g?h?.origin==="result"?{type:"UNEXPECTED_ERROR",cause:{type:"STEP_FAILURE",origin:"result",error:n,...h.resultCause!==void 0?{cause:h.resultCause}:{}}}:h?.origin==="throw"?{type:"UNEXPECTED_ERROR",cause:{type:"STEP_FAILURE",origin:"throw",error:n,thrown:h.thrown}}:{type:"UNEXPECTED_ERROR",cause:{type:"STEP_FAILURE",origin:"result",error:n}}:n,v=n=>({type:"UNEXPECTED_ERROR",cause:n.meta.origin==="result"?{type:"STEP_FAILURE",origin:"result",error:n.error,...n.meta.resultCause!==void 0?{cause:n.meta.resultCause}:{}}:{type:"STEP_FAILURE",origin:"throw",error:n.error,thrown:n.meta.thrown}});try{let h=function(E,u){let s=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let t=performance.now(),r=!1;f.push({scopeId:s,type:"parallel"});let C=()=>{if(r)return;r=!0;let c=f.findIndex(i=>i.scopeId===s);c!==-1&&f.splice(c,1),a({type:"scope_end",workflowId:o,scopeId:s,ts:Date.now(),durationMs:performance.now()-t})};a({type:"scope_start",workflowId:o,scopeId:s,scopeType:"parallel",name:E,ts:Date.now()});try{let c=await u();if(C(),!c.ok)throw w?.(c.error,E,k),b(c.error,{origin:"result",resultCause:c.cause});return c.value}catch(c){throw C(),c}})()},K=function(E,u){let s=Object.keys(E),t=u.name??`Parallel(${s.join(", ")})`,r=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let C=performance.now(),c=!1;f.push({scopeId:r,type:"parallel"});let i=()=>{if(c)return;c=!0;let y=f.findIndex(d=>d.scopeId===r);y!==-1&&f.splice(y,1),a({type:"scope_end",workflowId:o,scopeId:r,ts:Date.now(),durationMs:performance.now()-C})};a({type:"scope_start",workflowId:o,scopeId:r,scopeType:"parallel",name:t,ts:Date.now()});try{let y=await new Promise(O=>{if(s.length===0){O([]);return}let _=!1,R=s.length,Y=new Array(s.length);for(let I=0;I<s.length;I++){let L=s[I],q=I;Promise.resolve(E[L]()).catch(m=>U({type:"PROMISE_REJECTED",cause:m},{cause:{type:"PROMISE_REJECTION",reason:m}})).then(m=>{if(!_){if(!m.ok){_=!0,O([{key:L,result:m}]);return}Y[q]={key:L,result:m},R--,R===0&&O(Y)}})}});i();let d={};for(let{key:O,result:_}of y){if(!_.ok)throw w?.(_.error,O,k),b(_.error,{origin:"result",resultCause:_.cause});d[O]=_.value}return d}catch(y){throw i(),y}})()};var j=h,M=K;let n=(E,u)=>(async()=>{let s=ye(u),{name:t,key:r,retry:C,timeout:c}=s,i=N(r),y=T,d=y?performance.now():0;if(!(typeof E=="function")){if(C&&C.attempts>1)throw new Error("step: retry options require a function operation. Direct Promise/Result values cannot be re-executed on retry. Wrap your operation in a function: step(() => yourOperation, { retry: {...} })");if(c)throw new Error("step: timeout options require a function operation. Direct Promise/Result values cannot be wrapped with timeout after they've started. Wrap your operation in a function: step(() => yourOperation, { timeout: {...} })")}let R={attempts:Math.max(1,C?.attempts??1),backoff:C?.backoff??B.backoff,initialDelay:C?.initialDelay??B.initialDelay,maxDelay:C?.maxDelay??B.maxDelay,jitter:C?.jitter??B.jitter,retryOn:C?.retryOn??B.retryOn,onRetry:C?.onRetry??B.onRetry};T&&a({type:"step_start",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now()});let Y;for(let m=1;m<=R.attempts;m++){let ue=y?performance.now():0;try{let l;if(typeof E=="function"?c?l=await me(E,c,{name:t,key:r,attempt:m}):l=await E():l=await E,l.ok){let F=performance.now()-d;return a({type:"step_success",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),durationMs:F}),r&&a({type:"step_complete",workflowId:o,stepKey:r,name:t,ts:Date.now(),durationMs:F,result:l}),l.value}if(Y=l,m<R.attempts&&R.retryOn(l.error,m)){let F=Z(m,R);a({type:"step_retry",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),attempt:m+1,maxAttempts:R.attempts,delayMs:F,error:l.error}),R.onRetry(l.error,m,F),await ee(F);continue}R.attempts>1&&a({type:"step_retries_exhausted",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),durationMs:performance.now()-d,attempts:m,lastError:l.error});break}catch(l){let F=performance.now()-ue;if(X(l))throw a({type:"step_aborted",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),durationMs:F}),l;if(te(l)){let P=ie(l),G=c?.ms??P?.timeoutMs??0;if(a({type:"step_timeout",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),timeoutMs:G,attempt:m}),m<R.attempts&&R.retryOn(l,m)){let z=Z(m,R);a({type:"step_retry",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),attempt:m+1,maxAttempts:R.attempts,delayMs:z,error:l}),R.onRetry(l,m,z),await ee(z);continue}R.attempts>1&&a({type:"step_retries_exhausted",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),durationMs:performance.now()-d,attempts:m,lastError:l})}if(m<R.attempts&&R.retryOn(l,m)){let P=Z(m,R);a({type:"step_retry",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),attempt:m+1,maxAttempts:R.attempts,delayMs:P,error:l}),R.onRetry(l,m,P),await ee(P);continue}R.attempts>1&&!te(l)&&a({type:"step_retries_exhausted",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),durationMs:performance.now()-d,attempts:m,lastError:l});let H=performance.now()-d;if(S){let P;try{P=S(l)}catch(G){throw le(G)}throw a({type:"step_error",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),durationMs:H,error:P}),r&&a({type:"step_complete",workflowId:o,stepKey:r,name:t,ts:Date.now(),durationMs:H,result:U(P,{cause:l}),meta:{origin:"throw",thrown:l}}),w?.(P,t,k),b(P,{origin:"throw",thrown:l})}else{let P={type:"UNEXPECTED_ERROR",cause:{type:"UNCAUGHT_EXCEPTION",thrown:l}};throw a({type:"step_error",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),durationMs:H,error:P}),r&&a({type:"step_complete",workflowId:o,stepKey:r,name:t,ts:Date.now(),durationMs:H,result:U(P,{cause:l}),meta:{origin:"throw",thrown:l}}),l}}}let I=Y,L=performance.now()-d,q=x(I.error,{origin:"result",resultCause:I.cause});throw a({type:"step_error",workflowId:o,stepId:i,stepKey:r,name:t,ts:Date.now(),durationMs:L,error:q}),r&&a({type:"step_complete",workflowId:o,stepKey:r,name:t,ts:Date.now(),durationMs:L,result:I,meta:{origin:"result",resultCause:I.cause}}),w?.(I.error,t,k),b(I.error,{origin:"result",resultCause:I.cause})})();n.try=(E,u)=>{let s=u.name,t=u.key,r=N(t),C="error"in u?()=>u.error:u.onError,c=T;return(async()=>{let i=c?performance.now():0;T&&a({type:"step_start",workflowId:o,stepId:r,stepKey:t,name:s,ts:Date.now()});try{let y=await E(),d=performance.now()-i;return a({type:"step_success",workflowId:o,stepId:r,stepKey:t,name:s,ts:Date.now(),durationMs:d}),t&&a({type:"step_complete",workflowId:o,stepKey:t,name:s,ts:Date.now(),durationMs:d,result:Q(y)}),y}catch(y){let d=C(y),O=performance.now()-i,_=x(d,{origin:"throw",thrown:y});throw a({type:"step_error",workflowId:o,stepId:r,stepKey:t,name:s,ts:Date.now(),durationMs:O,error:_}),t&&a({type:"step_complete",workflowId:o,stepKey:t,name:s,ts:Date.now(),durationMs:O,result:U(d,{cause:y}),meta:{origin:"throw",thrown:y}}),w?.(d,s,k),b(d,{origin:"throw",thrown:y})}})()},n.fromResult=(E,u)=>{let s=u.name,t=u.key,r=N(t),C="error"in u?()=>u.error:u.onError,c=T;return(async()=>{let i=c?performance.now():0;T&&a({type:"step_start",workflowId:o,stepId:r,stepKey:t,name:s,ts:Date.now()});let y=await E();if(y.ok){let d=performance.now()-i;return a({type:"step_success",workflowId:o,stepId:r,stepKey:t,name:s,ts:Date.now(),durationMs:d}),t&&a({type:"step_complete",workflowId:o,stepKey:t,name:s,ts:Date.now(),durationMs:d,result:Q(y.value)}),y.value}else{let d=C(y.error),O=performance.now()-i,_=x(d,{origin:"result",resultCause:y.error});throw a({type:"step_error",workflowId:o,stepId:r,stepKey:t,name:s,ts:Date.now(),durationMs:O,error:_}),t&&a({type:"step_complete",workflowId:o,stepKey:t,name:s,ts:Date.now(),durationMs:O,result:U(d,{cause:y.error}),meta:{origin:"result",resultCause:y.error}}),w?.(d,s,k),b(d,{origin:"result",resultCause:y.error})}})()},n.retry=(E,u)=>n(E,{name:u.name,key:u.key,retry:{attempts:u.attempts,backoff:u.backoff,initialDelay:u.initialDelay,maxDelay:u.maxDelay,jitter:u.jitter,retryOn:u.retryOn,onRetry:u.onRetry},timeout:u.timeout}),n.withTimeout=(E,u)=>n(E,{name:u.name,key:u.key,timeout:u}),n.parallel=((...E)=>{if(typeof E[0]=="string"){let u=E[0],s=E[1];return h(u,s)}else{let u=E[0],s=E[1]??{};return K(u,s)}}),n.race=(E,u)=>{let s=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let t=performance.now(),r=!1,C={scopeId:s,type:"race",winnerId:void 0};f.push(C);let c=()=>{if(r)return;r=!0;let i=f.findIndex(y=>y.scopeId===s);i!==-1&&f.splice(i,1),a({type:"scope_end",workflowId:o,scopeId:s,ts:Date.now(),durationMs:performance.now()-t,winnerId:C.winnerId})};a({type:"scope_start",workflowId:o,scopeId:s,scopeType:"race",name:E,ts:Date.now()});try{let i=await u();if(c(),!i.ok)throw w?.(i.error,E,k),b(i.error,{origin:"result",resultCause:i.cause});return i.value}catch(i){throw c(),i}})()},n.allSettled=(E,u)=>{let s=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let t=performance.now(),r=!1;f.push({scopeId:s,type:"allSettled"});let C=()=>{if(r)return;r=!0;let c=f.findIndex(i=>i.scopeId===s);c!==-1&&f.splice(c,1),a({type:"scope_end",workflowId:o,scopeId:s,ts:Date.now(),durationMs:performance.now()-t})};a({type:"scope_start",workflowId:o,scopeId:s,scopeType:"allSettled",name:E,ts:Date.now()});try{let c=await u();if(C(),!c.ok)throw w?.(c.error,E,k),b(c.error,{origin:"result",resultCause:c.cause});return c.value}catch(c){throw C(),c}})()};let $=await e(n);return Q($)}catch(n){if(Ee(n))throw n.thrown;if(X(n)){let K=n.meta.origin==="throw"?n.meta.thrown:n.meta.resultCause;if(S||w)return U(n.error,{cause:K});if(ae(n.error))return U(n.error,{cause:K});let V=v(n);return U(V,{cause:K})}if(S){let K=S(n);return w?.(K,"unexpected",k),U(K,{cause:n})}let h={type:"UNEXPECTED_ERROR",cause:{type:"UNCAUGHT_EXCEPTION",thrown:n}};return w?.(h,"unexpected",k),U(h,{cause:n})}}re.strict=(e,p)=>re(e,p);var J=class extends Error{type="CIRCUIT_OPEN";circuitName;state;retryAfterMs;constructor(p){super(p.message??`Circuit breaker "${p.circuitName}" is ${p.state}. Retry after ${Math.ceil(p.retryAfterMs/1e3)}s`),this.name="CircuitOpenError",this.circuitName=p.circuitName,this.state=p.state,this.retryAfterMs=p.retryAfterMs}};function we(e){return typeof e=="object"&&e!==null&&e.type==="CIRCUIT_OPEN"}var Te={failureThreshold:5,resetTimeout:3e4,windowSize:6e4,halfOpenMax:3};function ke(e,p){let w={...Te,...p},T="CLOSED",S=[],A=null,k=null,o=0,g=0;function f(){let x=Date.now();S=S.filter(v=>x-v.timestamp<w.windowSize)}function D(x){if(T!==x){let v=T;T=x,x==="HALF_OPEN"&&(g=0),w.onStateChange?.(v,x,e)}}function N(){return T!=="OPEN"||A===null?!1:Date.now()-A>=w.resetTimeout?(D("HALF_OPEN"),!0):!1}function a(){k=Date.now(),o++,T==="HALF_OPEN"&&(g++,g>=w.halfOpenMax&&(D("CLOSED"),S=[]))}function b(x){let v=Date.now();A=v,f(),S.push({timestamp:v,error:x}),(T==="HALF_OPEN"||T==="CLOSED"&&S.length>=w.failureThreshold)&&D("OPEN")}function X(){if(T==="CLOSED")return 0;if(T==="OPEN"){if(N())return 0;let x=Date.now(),v=A?x-A:0;return Math.max(0,w.resetTimeout-v)}return 0}return{async execute(x,v){let j=X();if(j>0)throw new J({circuitName:e,state:T,retryAfterMs:j});try{let M=await x();return a(),M}catch(M){throw b(M),M}},async executeResult(x,v){let j=X();if(j>0)return U(new J({circuitName:e,state:T,retryAfterMs:j}));try{let M=await x();return M.ok?a():b(M.error),M}catch(M){throw b(M),M}},getState(){return T==="OPEN"&&N(),T},getStats(){return f(),{state:this.getState(),failureCount:S.length,successCount:o,lastFailureTime:A,lastSuccessTime:k,halfOpenSuccesses:g}},reset(){D("CLOSED"),S=[],g=0},forceOpen(){A=Date.now(),D("OPEN")},recordSuccess(){a()},recordFailure(x){b(x??new Error("Manual failure"))}}}var fe={critical:{failureThreshold:3,resetTimeout:6e4,windowSize:3e4,halfOpenMax:1},standard:{failureThreshold:5,resetTimeout:3e4,windowSize:6e4,halfOpenMax:3},lenient:{failureThreshold:10,resetTimeout:15e3,windowSize:12e4,halfOpenMax:5}};export{J as CircuitOpenError,fe as circuitBreakerPresets,ke as createCircuitBreaker,we as isCircuitOpenError};
+//# sourceMappingURL=circuit-breaker.js.map