awaitly 1.0.0

package/dist/ratelimit.d.cts

@@ -0,0 +1,279 @@
+import { R as Result, A as AsyncResult } from './core-BuTBsR0x.cjs';
+
+/**
+ * Rate Limiting / Concurrency Control
+ *
+ * Control throughput for steps that hit rate-limited APIs or shared resources.
+ *
+ * @example
+ * ```typescript
+ * import { createRateLimiter, createConcurrencyLimiter } from 'awaitly';
+ *
+ * // Rate limiting (requests per second)
+ * const rateLimiter = createRateLimiter({ maxPerSecond: 10 });
+ *
+ * // Concurrency limiting (max concurrent)
+ * const concurrencyLimiter = createConcurrencyLimiter({ maxConcurrent: 5 });
+ *
+ * const result = await workflow(async (step) => {
+ *   // Wrap operations with rate limiting
+ *   const data = await rateLimiter.execute(() =>
+ *     step(() => callRateLimitedApi())
+ *   );
+ *
+ *   // Wrap batch operations with concurrency control
+ *   const results = await concurrencyLimiter.executeAll(
+ *     ids.map(id => () => step(() => fetchItem(id)))
+ *   );
+ *
+ *   return { data, results };
+ * });
+ * ```
+ */
+
+/**
+ * Configuration for rate limiter.
+ */
+interface RateLimiterConfig {
+    /**
+     * Maximum operations per second.
+     */
+    maxPerSecond: number;
+    /**
+     * Burst capacity - allows brief spikes above the rate.
+     * @default maxPerSecond * 2
+     */
+    burstCapacity?: number;
+    /**
+     * Strategy when rate limit is exceeded.
+     * - 'wait': Wait until a slot is available (default)
+     * - 'reject': Reject immediately with error
+     * @default 'wait'
+     */
+    strategy?: "wait" | "reject";
+}
+/**
+ * Configuration for concurrency limiter.
+ */
+interface ConcurrencyLimiterConfig {
+    /**
+     * Maximum concurrent operations.
+     */
+    maxConcurrent: number;
+    /**
+     * Strategy when limit is reached.
+     * - 'queue': Queue and wait (default)
+     * - 'reject': Reject immediately
+     * @default 'queue'
+     */
+    strategy?: "queue" | "reject";
+    /**
+     * Maximum queue size (only for 'queue' strategy).
+     * @default Infinity
+     */
+    maxQueueSize?: number;
+}
+/**
+ * Error when rate/concurrency limit is exceeded and strategy is 'reject'.
+ */
+interface RateLimitExceededError {
+    type: "RATE_LIMIT_EXCEEDED";
+    limiterName: string;
+    retryAfterMs?: number;
+}
+/**
+ * Error when concurrency limit queue is full.
+ */
+interface QueueFullError {
+    type: "QUEUE_FULL";
+    limiterName: string;
+    queueSize: number;
+    maxQueueSize: number;
+}
+/**
+ * Type guard for RateLimitExceededError.
+ */
+declare function isRateLimitExceededError(error: unknown): error is RateLimitExceededError;
+/**
+ * Type guard for QueueFullError.
+ */
+declare function isQueueFullError(error: unknown): error is QueueFullError;
+/**
+ * Statistics for rate limiter.
+ */
+interface RateLimiterStats {
+    availableTokens: number;
+    maxTokens: number;
+    tokensPerSecond: number;
+    waitingCount: number;
+}
+/**
+ * Statistics for concurrency limiter.
+ */
+interface ConcurrencyLimiterStats {
+    activeCount: number;
+    maxConcurrent: number;
+    queueSize: number;
+    maxQueueSize: number;
+}
+/**
+ * Rate limiter interface.
+ */
+interface RateLimiter {
+    /**
+     * Execute an operation with rate limiting.
+     * @param operation - The operation to execute
+     * @returns The operation result
+     */
+    execute<T>(operation: () => T | Promise<T>): Promise<T>;
+    /**
+     * Execute a Result-returning operation with rate limiting.
+     */
+    executeResult<T, E>(operation: () => Result<T, E> | AsyncResult<T, E>): AsyncResult<T, E | RateLimitExceededError>;
+    /**
+     * Get current statistics.
+     */
+    getStats(): RateLimiterStats;
+    /**
+     * Reset the rate limiter.
+     */
+    reset(): void;
+}
+/**
+ * Create a token bucket rate limiter.
+ *
+ * @param name - Name for the limiter (used in errors)
+ * @param config - Rate limiter configuration
+ * @returns A RateLimiter instance
+ *
+ * @example
+ * ```typescript
+ * const limiter = createRateLimiter('api-calls', {
+ *   maxPerSecond: 10,
+ *   burstCapacity: 20,
+ * });
+ *
+ * // In workflow
+ * const data = await limiter.execute(() =>
+ *   step(() => callApi())
+ * );
+ * ```
+ */
+declare function createRateLimiter(name: string, config: RateLimiterConfig): RateLimiter;
+/**
+ * Concurrency limiter interface.
+ */
+interface ConcurrencyLimiter {
+    /**
+     * Execute an operation with concurrency limiting.
+     * @param operation - The operation to execute
+     * @returns The operation result
+     */
+    execute<T>(operation: () => T | Promise<T>): Promise<T>;
+    /**
+     * Execute multiple operations with concurrency control.
+     * @param operations - Array of operation factories
+     * @returns Array of results (in order)
+     */
+    executeAll<T>(operations: Array<() => T | Promise<T>>): Promise<T[]>;
+    /**
+     * Execute a Result-returning operation with concurrency limiting.
+     */
+    executeResult<T, E>(operation: () => Result<T, E> | AsyncResult<T, E>): AsyncResult<T, E | QueueFullError>;
+    /**
+     * Get current statistics.
+     */
+    getStats(): ConcurrencyLimiterStats;
+    /**
+     * Reset the concurrency limiter.
+     */
+    reset(): void;
+}
+/**
+ * Create a concurrency limiter.
+ *
+ * @param name - Name for the limiter (used in errors)
+ * @param config - Concurrency limiter configuration
+ * @returns A ConcurrencyLimiter instance
+ *
+ * @example
+ * ```typescript
+ * const limiter = createConcurrencyLimiter('db-pool', {
+ *   maxConcurrent: 10,
+ * });
+ *
+ * // Execute with concurrency control
+ * const results = await limiter.executeAll(
+ *   ids.map(id => () => fetchItem(id))
+ * );
+ * ```
+ */
+declare function createConcurrencyLimiter(name: string, config: ConcurrencyLimiterConfig): ConcurrencyLimiter;
+/**
+ * Configuration for combined rate + concurrency limiter.
+ */
+interface CombinedLimiterConfig {
+    /**
+     * Rate limiting configuration.
+     */
+    rate?: RateLimiterConfig;
+    /**
+     * Concurrency limiting configuration.
+     */
+    concurrency?: ConcurrencyLimiterConfig;
+}
+/**
+ * Create a combined rate + concurrency limiter.
+ *
+ * Operations are first rate-limited, then concurrency-limited.
+ *
+ * @param name - Name for the limiter
+ * @param config - Combined limiter configuration
+ * @returns An object with both limiters and a combined execute function
+ *
+ * @example
+ * ```typescript
+ * const limiter = createCombinedLimiter('api', {
+ *   rate: { maxPerSecond: 10 },
+ *   concurrency: { maxConcurrent: 5 },
+ * });
+ *
+ * const result = await limiter.execute(() => callApi());
+ * ```
+ */
+declare function createCombinedLimiter(name: string, config: CombinedLimiterConfig): {
+    rate?: RateLimiter;
+    concurrency?: ConcurrencyLimiter;
+    execute: <T>(operation: () => T | Promise<T>) => Promise<T>;
+};
+/**
+ * Preset configurations for common use cases.
+ */
+declare const rateLimiterPresets: {
+    /**
+     * Typical API rate limit (10 req/s).
+     */
+    readonly api: {
+        maxPerSecond: number;
+        burstCapacity: number;
+        strategy: "wait";
+    };
+    /**
+     * Database pool limit (concurrent connections).
+     */
+    readonly database: {
+        maxConcurrent: number;
+        strategy: "queue";
+        maxQueueSize: number;
+    };
+    /**
+     * Aggressive rate limit for external APIs (5 req/s).
+     */
+    readonly external: {
+        maxPerSecond: number;
+        burstCapacity: number;
+        strategy: "wait";
+    };
+};
+
+export { type CombinedLimiterConfig, type ConcurrencyLimiter, type ConcurrencyLimiterConfig, type ConcurrencyLimiterStats, type QueueFullError, type RateLimitExceededError, type RateLimiter, type RateLimiterConfig, type RateLimiterStats, createCombinedLimiter, createConcurrencyLimiter, createRateLimiter, isQueueFullError, isRateLimitExceededError, rateLimiterPresets };

package/dist/ratelimit.d.ts

@@ -0,0 +1,279 @@
+import { R as Result, A as AsyncResult } from './core-BuTBsR0x.js';
+
+/**
+ * Rate Limiting / Concurrency Control
+ *
+ * Control throughput for steps that hit rate-limited APIs or shared resources.
+ *
+ * @example
+ * ```typescript
+ * import { createRateLimiter, createConcurrencyLimiter } from 'awaitly';
+ *
+ * // Rate limiting (requests per second)
+ * const rateLimiter = createRateLimiter({ maxPerSecond: 10 });
+ *
+ * // Concurrency limiting (max concurrent)
+ * const concurrencyLimiter = createConcurrencyLimiter({ maxConcurrent: 5 });
+ *
+ * const result = await workflow(async (step) => {
+ *   // Wrap operations with rate limiting
+ *   const data = await rateLimiter.execute(() =>
+ *     step(() => callRateLimitedApi())
+ *   );
+ *
+ *   // Wrap batch operations with concurrency control
+ *   const results = await concurrencyLimiter.executeAll(
+ *     ids.map(id => () => step(() => fetchItem(id)))
+ *   );
+ *
+ *   return { data, results };
+ * });
+ * ```
+ */
+
+/**
+ * Configuration for rate limiter.
+ */
+interface RateLimiterConfig {
+    /**
+     * Maximum operations per second.
+     */
+    maxPerSecond: number;
+    /**
+     * Burst capacity - allows brief spikes above the rate.
+     * @default maxPerSecond * 2
+     */
+    burstCapacity?: number;
+    /**
+     * Strategy when rate limit is exceeded.
+     * - 'wait': Wait until a slot is available (default)
+     * - 'reject': Reject immediately with error
+     * @default 'wait'
+     */
+    strategy?: "wait" | "reject";
+}
+/**
+ * Configuration for concurrency limiter.
+ */
+interface ConcurrencyLimiterConfig {
+    /**
+     * Maximum concurrent operations.
+     */
+    maxConcurrent: number;
+    /**
+     * Strategy when limit is reached.
+     * - 'queue': Queue and wait (default)
+     * - 'reject': Reject immediately
+     * @default 'queue'
+     */
+    strategy?: "queue" | "reject";
+    /**
+     * Maximum queue size (only for 'queue' strategy).
+     * @default Infinity
+     */
+    maxQueueSize?: number;
+}
+/**
+ * Error when rate/concurrency limit is exceeded and strategy is 'reject'.
+ */
+interface RateLimitExceededError {
+    type: "RATE_LIMIT_EXCEEDED";
+    limiterName: string;
+    retryAfterMs?: number;
+}
+/**
+ * Error when concurrency limit queue is full.
+ */
+interface QueueFullError {
+    type: "QUEUE_FULL";
+    limiterName: string;
+    queueSize: number;
+    maxQueueSize: number;
+}
+/**
+ * Type guard for RateLimitExceededError.
+ */
+declare function isRateLimitExceededError(error: unknown): error is RateLimitExceededError;
+/**
+ * Type guard for QueueFullError.
+ */
+declare function isQueueFullError(error: unknown): error is QueueFullError;
+/**
+ * Statistics for rate limiter.
+ */
+interface RateLimiterStats {
+    availableTokens: number;
+    maxTokens: number;
+    tokensPerSecond: number;
+    waitingCount: number;
+}
+/**
+ * Statistics for concurrency limiter.
+ */
+interface ConcurrencyLimiterStats {
+    activeCount: number;
+    maxConcurrent: number;
+    queueSize: number;
+    maxQueueSize: number;
+}
+/**
+ * Rate limiter interface.
+ */
+interface RateLimiter {
+    /**
+     * Execute an operation with rate limiting.
+     * @param operation - The operation to execute
+     * @returns The operation result
+     */
+    execute<T>(operation: () => T | Promise<T>): Promise<T>;
+    /**
+     * Execute a Result-returning operation with rate limiting.
+     */
+    executeResult<T, E>(operation: () => Result<T, E> | AsyncResult<T, E>): AsyncResult<T, E | RateLimitExceededError>;
+    /**
+     * Get current statistics.
+     */
+    getStats(): RateLimiterStats;
+    /**
+     * Reset the rate limiter.
+     */
+    reset(): void;
+}
+/**
+ * Create a token bucket rate limiter.
+ *
+ * @param name - Name for the limiter (used in errors)
+ * @param config - Rate limiter configuration
+ * @returns A RateLimiter instance
+ *
+ * @example
+ * ```typescript
+ * const limiter = createRateLimiter('api-calls', {
+ *   maxPerSecond: 10,
+ *   burstCapacity: 20,
+ * });
+ *
+ * // In workflow
+ * const data = await limiter.execute(() =>
+ *   step(() => callApi())
+ * );
+ * ```
+ */
+declare function createRateLimiter(name: string, config: RateLimiterConfig): RateLimiter;
+/**
+ * Concurrency limiter interface.
+ */
+interface ConcurrencyLimiter {
+    /**
+     * Execute an operation with concurrency limiting.
+     * @param operation - The operation to execute
+     * @returns The operation result
+     */
+    execute<T>(operation: () => T | Promise<T>): Promise<T>;
+    /**
+     * Execute multiple operations with concurrency control.
+     * @param operations - Array of operation factories
+     * @returns Array of results (in order)
+     */
+    executeAll<T>(operations: Array<() => T | Promise<T>>): Promise<T[]>;
+    /**
+     * Execute a Result-returning operation with concurrency limiting.
+     */
+    executeResult<T, E>(operation: () => Result<T, E> | AsyncResult<T, E>): AsyncResult<T, E | QueueFullError>;
+    /**
+     * Get current statistics.
+     */
+    getStats(): ConcurrencyLimiterStats;
+    /**
+     * Reset the concurrency limiter.
+     */
+    reset(): void;
+}
+/**
+ * Create a concurrency limiter.
+ *
+ * @param name - Name for the limiter (used in errors)
+ * @param config - Concurrency limiter configuration
+ * @returns A ConcurrencyLimiter instance
+ *
+ * @example
+ * ```typescript
+ * const limiter = createConcurrencyLimiter('db-pool', {
+ *   maxConcurrent: 10,
+ * });
+ *
+ * // Execute with concurrency control
+ * const results = await limiter.executeAll(
+ *   ids.map(id => () => fetchItem(id))
+ * );
+ * ```
+ */
+declare function createConcurrencyLimiter(name: string, config: ConcurrencyLimiterConfig): ConcurrencyLimiter;
+/**
+ * Configuration for combined rate + concurrency limiter.
+ */
+interface CombinedLimiterConfig {
+    /**
+     * Rate limiting configuration.
+     */
+    rate?: RateLimiterConfig;
+    /**
+     * Concurrency limiting configuration.
+     */
+    concurrency?: ConcurrencyLimiterConfig;
+}
+/**
+ * Create a combined rate + concurrency limiter.
+ *
+ * Operations are first rate-limited, then concurrency-limited.
+ *
+ * @param name - Name for the limiter
+ * @param config - Combined limiter configuration
+ * @returns An object with both limiters and a combined execute function
+ *
+ * @example
+ * ```typescript
+ * const limiter = createCombinedLimiter('api', {
+ *   rate: { maxPerSecond: 10 },
+ *   concurrency: { maxConcurrent: 5 },
+ * });
+ *
+ * const result = await limiter.execute(() => callApi());
+ * ```
+ */
+declare function createCombinedLimiter(name: string, config: CombinedLimiterConfig): {
+    rate?: RateLimiter;
+    concurrency?: ConcurrencyLimiter;
+    execute: <T>(operation: () => T | Promise<T>) => Promise<T>;
+};
+/**
+ * Preset configurations for common use cases.
+ */
+declare const rateLimiterPresets: {
+    /**
+     * Typical API rate limit (10 req/s).
+     */
+    readonly api: {
+        maxPerSecond: number;
+        burstCapacity: number;
+        strategy: "wait";
+    };
+    /**
+     * Database pool limit (concurrent connections).
+     */
+    readonly database: {
+        maxConcurrent: number;
+        strategy: "queue";
+        maxQueueSize: number;
+    };
+    /**
+     * Aggressive rate limit for external APIs (5 req/s).
+     */
+    readonly external: {
+        maxPerSecond: number;
+        burstCapacity: number;
+        strategy: "wait";
+    };
+};
+
+export { type CombinedLimiterConfig, type ConcurrencyLimiter, type ConcurrencyLimiterConfig, type ConcurrencyLimiterStats, type QueueFullError, type RateLimitExceededError, type RateLimiter, type RateLimiterConfig, type RateLimiterStats, createCombinedLimiter, createConcurrencyLimiter, createRateLimiter, isQueueFullError, isRateLimitExceededError, rateLimiterPresets };

package/dist/ratelimit.js

@@ -0,0 +1,2 @@
+var Y=e=>({ok:!0,value:e}),M=(e,E)=>({ok:!1,error:e,...E?.cause!==void 0?{cause:E.cause}:{}});var ae=e=>typeof e=="object"&&e!==null&&e.type==="UNEXPECTED_ERROR",V=Symbol.for("step_timeout_marker");function G(e){return typeof e!="object"||e===null?!1:e.type==="STEP_TIMEOUT"?!0:V in e}function ie(e){if(!(typeof e!="object"||e===null)){if(e.type==="STEP_TIMEOUT"){let E=e;return{timeoutMs:E.timeoutMs,stepName:E.stepName,stepKey:E.stepKey,attempt:E.attempt}}if(V in e)return e[V]}}var ee=Symbol("early-exit");function ce(e,E){return{[ee]:!0,error:e,meta:E}}function pe(e){return typeof e=="object"&&e!==null&&e[ee]===!0}var te=Symbol("mapper-exception");function le(e){return{[te]:!0,thrown:e}}function Ee(e){return typeof e=="object"&&e!==null&&e[te]===!0}function ye(e){return typeof e=="string"?{name:e}:e??{}}function J(e,E){let{backoff:y,initialDelay:C,maxDelay:g,jitter:d}=E,u;switch(y){case"fixed":u=C;break;case"linear":u=C*e;break;case"exponential":u=C*Math.pow(2,e-1);break}if(u=Math.min(u,g),d){let n=u*.25*Math.random();u=u+n}return Math.floor(u)}function B(e){return new Promise(E=>setTimeout(E,e))}var H=Symbol("timeout");async function me(e,E,y){let C=new AbortController,g=E.error??{type:"STEP_TIMEOUT",stepName:y.name,stepKey:y.key,timeoutMs:E.ms,attempt:y.attempt},d,u=new Promise((A,c)=>{d=setTimeout(()=>{C.abort(),c({[H]:!0,error:g})},E.ms)}),n;E.signal?n=Promise.resolve(e(C.signal)):n=Promise.resolve(e());try{return await Promise.race([n,u])}catch(A){if(typeof A=="object"&&A!==null&&A[H]===!0){let c=A.error;if(typeof c=="object"&&c!==null&&c.type!=="STEP_TIMEOUT"){let h={timeoutMs:E.ms,stepName:y.name,stepKey:y.key,attempt:y.attempt};V in c?c[V]=h:Object.defineProperty(c,V,{value:h,enumerable:!1,writable:!0,configurable:!1})}throw c}throw A}finally{clearTimeout(d)}}var N={backoff:"exponential",initialDelay:100,maxDelay:3e4,jitter:!0,retryOn:()=>!0,onRetry:()=>{}};async function Z(e,E){let{onError:y,onEvent:C,catchUnexpected:g,workflowId:d,context:u}=E&&typeof E=="object"?E:{},n=d??crypto.randomUUID(),A=!y&&!g,c=[],h=0,U=o=>o??`step_${++h}`,t=o=>{let b=o.context!==void 0||u===void 0?o:{...o,context:u};if(b.type==="step_success"){let I=b.stepId;for(let F=c.length-1;F>=0;F--){let Q=c[F];if(Q.type==="race"&&!Q.winnerId){Q.winnerId=I;break}}}C?.(b,u)},x=ce,D=o=>pe(o),L=(o,b)=>A?b?.origin==="result"?{type:"UNEXPECTED_ERROR",cause:{type:"STEP_FAILURE",origin:"result",error:o,...b.resultCause!==void 0?{cause:b.resultCause}:{}}}:b?.origin==="throw"?{type:"UNEXPECTED_ERROR",cause:{type:"STEP_FAILURE",origin:"throw",error:o,thrown:b.thrown}}:{type:"UNEXPECTED_ERROR",cause:{type:"STEP_FAILURE",origin:"result",error:o}}:o,se=o=>({type:"UNEXPECTED_ERROR",cause:o.meta.origin==="result"?{type:"STEP_FAILURE",origin:"result",error:o.error,...o.meta.resultCause!==void 0?{cause:o.meta.resultCause}:{}}:{type:"STEP_FAILURE",origin:"throw",error:o.error,thrown:o.meta.thrown}});try{let b=function(T,i){let a=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let r=performance.now(),s=!1;c.push({scopeId:a,type:"parallel"});let R=()=>{if(s)return;s=!0;let l=c.findIndex(p=>p.scopeId===a);l!==-1&&c.splice(l,1),t({type:"scope_end",workflowId:n,scopeId:a,ts:Date.now(),durationMs:performance.now()-r})};t({type:"scope_start",workflowId:n,scopeId:a,scopeType:"parallel",name:T,ts:Date.now()});try{let l=await i();if(R(),!l.ok)throw y?.(l.error,T,u),x(l.error,{origin:"result",resultCause:l.cause});return l.value}catch(l){throw R(),l}})()},I=function(T,i){let a=Object.keys(T),r=i.name??`Parallel(${a.join(", ")})`,s=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let R=performance.now(),l=!1;c.push({scopeId:s,type:"parallel"});let p=()=>{if(l)return;l=!0;let w=c.findIndex(f=>f.scopeId===s);w!==-1&&c.splice(w,1),t({type:"scope_end",workflowId:n,scopeId:s,ts:Date.now(),durationMs:performance.now()-R})};t({type:"scope_start",workflowId:n,scopeId:s,scopeType:"parallel",name:r,ts:Date.now()});try{let w=await new Promise(v=>{if(a.length===0){v([]);return}let _=!1,S=a.length,X=new Array(a.length);for(let O=0;O<a.length;O++){let j=a[O],W=O;Promise.resolve(T[j]()).catch(k=>M({type:"PROMISE_REJECTED",cause:k},{cause:{type:"PROMISE_REJECTION",reason:k}})).then(k=>{if(!_){if(!k.ok){_=!0,v([{key:j,result:k}]);return}X[W]={key:j,result:k},S--,S===0&&v(X)}})}});p();let f={};for(let{key:v,result:_}of w){if(!_.ok)throw y?.(_.error,v,u),x(_.error,{origin:"result",resultCause:_.cause});f[v]=_.value}return f}catch(w){throw p(),w}})()};var de=b,fe=I;let o=(T,i)=>(async()=>{let a=ye(i),{name:r,key:s,retry:R,timeout:l}=a,p=U(s),w=C,f=w?performance.now():0;if(!(typeof T=="function")){if(R&&R.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(l)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 S={attempts:Math.max(1,R?.attempts??1),backoff:R?.backoff??N.backoff,initialDelay:R?.initialDelay??N.initialDelay,maxDelay:R?.maxDelay??N.maxDelay,jitter:R?.jitter??N.jitter,retryOn:R?.retryOn??N.retryOn,onRetry:R?.onRetry??N.onRetry};C&&t({type:"step_start",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now()});let X;for(let k=1;k<=S.attempts;k++){let ue=w?performance.now():0;try{let m;if(typeof T=="function"?l?m=await me(T,l,{name:r,key:s,attempt:k}):m=await T():m=await T,m.ok){let K=performance.now()-f;return t({type:"step_success",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),durationMs:K}),s&&t({type:"step_complete",workflowId:n,stepKey:s,name:r,ts:Date.now(),durationMs:K,result:m}),m.value}if(X=m,k<S.attempts&&S.retryOn(m.error,k)){let K=J(k,S);t({type:"step_retry",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),attempt:k+1,maxAttempts:S.attempts,delayMs:K,error:m.error}),S.onRetry(m.error,k,K),await B(K);continue}S.attempts>1&&t({type:"step_retries_exhausted",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),durationMs:performance.now()-f,attempts:k,lastError:m.error});break}catch(m){let K=performance.now()-ue;if(D(m))throw t({type:"step_aborted",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),durationMs:K}),m;if(G(m)){let P=ie(m),$=l?.ms??P?.timeoutMs??0;if(t({type:"step_timeout",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),timeoutMs:$,attempt:k}),k<S.attempts&&S.retryOn(m,k)){let z=J(k,S);t({type:"step_retry",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),attempt:k+1,maxAttempts:S.attempts,delayMs:z,error:m}),S.onRetry(m,k,z),await B(z);continue}S.attempts>1&&t({type:"step_retries_exhausted",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),durationMs:performance.now()-f,attempts:k,lastError:m})}if(k<S.attempts&&S.retryOn(m,k)){let P=J(k,S);t({type:"step_retry",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),attempt:k+1,maxAttempts:S.attempts,delayMs:P,error:m}),S.onRetry(m,k,P),await B(P);continue}S.attempts>1&&!G(m)&&t({type:"step_retries_exhausted",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),durationMs:performance.now()-f,attempts:k,lastError:m});let q=performance.now()-f;if(g){let P;try{P=g(m)}catch($){throw le($)}throw t({type:"step_error",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),durationMs:q,error:P}),s&&t({type:"step_complete",workflowId:n,stepKey:s,name:r,ts:Date.now(),durationMs:q,result:M(P,{cause:m}),meta:{origin:"throw",thrown:m}}),y?.(P,r,u),x(P,{origin:"throw",thrown:m})}else{let P={type:"UNEXPECTED_ERROR",cause:{type:"UNCAUGHT_EXCEPTION",thrown:m}};throw t({type:"step_error",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),durationMs:q,error:P}),s&&t({type:"step_complete",workflowId:n,stepKey:s,name:r,ts:Date.now(),durationMs:q,result:M(P,{cause:m}),meta:{origin:"throw",thrown:m}}),m}}}let O=X,j=performance.now()-f,W=L(O.error,{origin:"result",resultCause:O.cause});throw t({type:"step_error",workflowId:n,stepId:p,stepKey:s,name:r,ts:Date.now(),durationMs:j,error:W}),s&&t({type:"step_complete",workflowId:n,stepKey:s,name:r,ts:Date.now(),durationMs:j,result:O,meta:{origin:"result",resultCause:O.cause}}),y?.(O.error,r,u),x(O.error,{origin:"result",resultCause:O.cause})})();o.try=(T,i)=>{let a=i.name,r=i.key,s=U(r),R="error"in i?()=>i.error:i.onError,l=C;return(async()=>{let p=l?performance.now():0;C&&t({type:"step_start",workflowId:n,stepId:s,stepKey:r,name:a,ts:Date.now()});try{let w=await T(),f=performance.now()-p;return t({type:"step_success",workflowId:n,stepId:s,stepKey:r,name:a,ts:Date.now(),durationMs:f}),r&&t({type:"step_complete",workflowId:n,stepKey:r,name:a,ts:Date.now(),durationMs:f,result:Y(w)}),w}catch(w){let f=R(w),v=performance.now()-p,_=L(f,{origin:"throw",thrown:w});throw t({type:"step_error",workflowId:n,stepId:s,stepKey:r,name:a,ts:Date.now(),durationMs:v,error:_}),r&&t({type:"step_complete",workflowId:n,stepKey:r,name:a,ts:Date.now(),durationMs:v,result:M(f,{cause:w}),meta:{origin:"throw",thrown:w}}),y?.(f,a,u),x(f,{origin:"throw",thrown:w})}})()},o.fromResult=(T,i)=>{let a=i.name,r=i.key,s=U(r),R="error"in i?()=>i.error:i.onError,l=C;return(async()=>{let p=l?performance.now():0;C&&t({type:"step_start",workflowId:n,stepId:s,stepKey:r,name:a,ts:Date.now()});let w=await T();if(w.ok){let f=performance.now()-p;return t({type:"step_success",workflowId:n,stepId:s,stepKey:r,name:a,ts:Date.now(),durationMs:f}),r&&t({type:"step_complete",workflowId:n,stepKey:r,name:a,ts:Date.now(),durationMs:f,result:Y(w.value)}),w.value}else{let f=R(w.error),v=performance.now()-p,_=L(f,{origin:"result",resultCause:w.error});throw t({type:"step_error",workflowId:n,stepId:s,stepKey:r,name:a,ts:Date.now(),durationMs:v,error:_}),r&&t({type:"step_complete",workflowId:n,stepKey:r,name:a,ts:Date.now(),durationMs:v,result:M(f,{cause:w.error}),meta:{origin:"result",resultCause:w.error}}),y?.(f,a,u),x(f,{origin:"result",resultCause:w.error})}})()},o.retry=(T,i)=>o(T,{name:i.name,key:i.key,retry:{attempts:i.attempts,backoff:i.backoff,initialDelay:i.initialDelay,maxDelay:i.maxDelay,jitter:i.jitter,retryOn:i.retryOn,onRetry:i.onRetry},timeout:i.timeout}),o.withTimeout=(T,i)=>o(T,{name:i.name,key:i.key,timeout:i}),o.parallel=((...T)=>{if(typeof T[0]=="string"){let i=T[0],a=T[1];return b(i,a)}else{let i=T[0],a=T[1]??{};return I(i,a)}}),o.race=(T,i)=>{let a=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let r=performance.now(),s=!1,R={scopeId:a,type:"race",winnerId:void 0};c.push(R);let l=()=>{if(s)return;s=!0;let p=c.findIndex(w=>w.scopeId===a);p!==-1&&c.splice(p,1),t({type:"scope_end",workflowId:n,scopeId:a,ts:Date.now(),durationMs:performance.now()-r,winnerId:R.winnerId})};t({type:"scope_start",workflowId:n,scopeId:a,scopeType:"race",name:T,ts:Date.now()});try{let p=await i();if(l(),!p.ok)throw y?.(p.error,T,u),x(p.error,{origin:"result",resultCause:p.cause});return p.value}catch(p){throw l(),p}})()},o.allSettled=(T,i)=>{let a=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let r=performance.now(),s=!1;c.push({scopeId:a,type:"allSettled"});let R=()=>{if(s)return;s=!0;let l=c.findIndex(p=>p.scopeId===a);l!==-1&&c.splice(l,1),t({type:"scope_end",workflowId:n,scopeId:a,ts:Date.now(),durationMs:performance.now()-r})};t({type:"scope_start",workflowId:n,scopeId:a,scopeType:"allSettled",name:T,ts:Date.now()});try{let l=await i();if(R(),!l.ok)throw y?.(l.error,T,u),x(l.error,{origin:"result",resultCause:l.cause});return l.value}catch(l){throw R(),l}})()};let Q=await e(o);return Y(Q)}catch(o){if(Ee(o))throw o.thrown;if(D(o)){let I=o.meta.origin==="throw"?o.meta.thrown:o.meta.resultCause;if(g||y)return M(o.error,{cause:I});if(ae(o.error))return M(o.error,{cause:I});let F=se(o);return M(F,{cause:I})}if(g){let I=g(o);return y?.(I,"unexpected",u),M(I,{cause:o})}let b={type:"UNEXPECTED_ERROR",cause:{type:"UNCAUGHT_EXCEPTION",thrown:o}};return y?.(b,"unexpected",u),M(b,{cause:o})}}Z.strict=(e,E)=>Z(e,E);function Te(e){return typeof e=="object"&&e!==null&&e.type==="RATE_LIMIT_EXCEEDED"}function ne(e){return typeof e=="object"&&e!==null&&e.type==="QUEUE_FULL"}function re(e,E){let{maxPerSecond:y,strategy:C="wait"}=E,g=E.burstCapacity??y*2,d=g,u=Date.now(),n=y/1e3,A=[];function c(){let t=Date.now(),D=(t-u)*n;d=Math.min(g,d+D),u=t}function h(){if(c(),d>=1)return d-=1,0;let t=1-d;return Math.ceil(t/n)}async function U(){return new Promise(t=>{let x=()=>{let D=h();D===0?t():(A.push(x),setTimeout(()=>{let L=A.indexOf(x);L!==-1&&(A.splice(L,1),x())},D))};x()})}return{async execute(t){let x=h();if(x>0){if(C==="reject")throw{type:"RATE_LIMIT_EXCEEDED",limiterName:e,retryAfterMs:x};await U()}return t()},async executeResult(t){let x=h();if(x>0){if(C==="reject")return M({type:"RATE_LIMIT_EXCEEDED",limiterName:e,retryAfterMs:x});await U()}return t()},getStats(){return c(),{availableTokens:Math.floor(d),maxTokens:g,tokensPerSecond:y,waitingCount:A.length}},reset(){d=g,u=Date.now(),A.length=0}}}function oe(e,E){let{maxConcurrent:y,strategy:C="queue",maxQueueSize:g=1/0}=E,d=0,u=[];async function n(){if(d<y){d++;return}if(C==="reject")throw{type:"QUEUE_FULL",limiterName:e,queueSize:u.length,maxQueueSize:g};if(u.length>=g)throw{type:"QUEUE_FULL",limiterName:e,queueSize:u.length,maxQueueSize:g};return new Promise((c,h)=>{u.push({resolve:c,reject:h})})}function A(){d--,u.length>0&&d<y&&(d++,u.shift()?.resolve())}return{async execute(c){await n();try{return await c()}finally{A()}},async executeAll(c){let h=new Array(c.length),U=[];for(let t=0;t<c.length;t++){let x=t,D=this.execute(c[x]).then(L=>{h[x]=L});U.push(D)}return await Promise.all(U),h},async executeResult(c){try{await n()}catch(h){if(ne(h))return M(h);throw h}try{return await c()}finally{A()}},getStats(){return{activeCount:d,maxConcurrent:y,queueSize:u.length,maxQueueSize:g}},reset(){for(d=0;u.length>0;)u.shift()?.reject(new Error("Limiter reset"))}}}function we(e,E){let y=E.rate?re(`${e}-rate`,E.rate):void 0,C=E.concurrency?oe(`${e}-concurrency`,E.concurrency):void 0;return{rate:y,concurrency:C,async execute(g){let d=g;if(y){let u=d;d=()=>y.execute(u)}return C?C.execute(d):d()}}}var ke={api:{maxPerSecond:10,burstCapacity:20,strategy:"wait"},database:{maxConcurrent:10,strategy:"queue",maxQueueSize:100},external:{maxPerSecond:5,burstCapacity:10,strategy:"wait"}};export{we as createCombinedLimiter,oe as createConcurrencyLimiter,re as createRateLimiter,ne as isQueueFullError,Te as isRateLimitExceededError,ke as rateLimiterPresets};
+//# sourceMappingURL=ratelimit.js.map