awaitly 1.34.0 → 2.0.0

package/dist/resolver.d.cts

@@ -1,68 +0,0 @@
-import { R as Result, c as AsyncResult } from './run-entry-D2MmJFj9.cjs';
-import { UnexpectedError } from './errors.cjs';
-import './tagged-error.cjs';
-import './slugs.cjs';
-
-/**
- * Configuration for createResolver.
- *
- * @typeParam T - The type of items returned by batchFn
- * @typeParam K - The type of keys used to identify items
- * @typeParam E - The error type from batchFn
- */
-interface ResolverConfig<T, K, E extends string> {
-    /** Human-readable name for this resolver (used in error messages) */
-    name: string;
-    /** Batch function that receives unique keys and returns all matching items */
-    batchFn: (keys: K[]) => AsyncResult<T[], E>;
-    /** Extract a dedup key from an input. Defaults to identity. */
-    key?: (input: K) => K;
-    /** Match a result item to a requested key */
-    find: (item: T, key: K) => boolean;
-    /** Enable per-key caching of ok results. No TTL in v1. */
-    cache?: boolean;
-}
-/** Error returned when batchFn succeeds but no item matches the requested key */
-type ResolverNotFoundError = "RESOLVER_NOT_FOUND";
-/**
- * A resolver instance created by createResolver.
- *
- * Resolvers should be created per-request/workflow, not as module-level singletons,
- * to avoid accidental cross-request batching.
- */
-interface Resolver<T, K, E extends string> {
-    /** Load a single item by key. Batches with other loads in the same microtask. */
-    load: (input: K) => Promise<Result<T, E | ResolverNotFoundError | UnexpectedError>>;
-    /** Load multiple items by key. Results array matches input order. */
-    loadMany: (inputs: K[]) => Promise<Result<T, E | ResolverNotFoundError | UnexpectedError>[]>;
-    /** Evict a single key from the cache */
-    clear: (input: K) => void;
-    /** Evict all cached entries */
-    clearAll: () => void;
-}
-/**
- * Create a DataLoader-style resolver that batches and deduplicates loads
- * within a single microtask tick.
- *
- * @example
- * ```typescript
- * const getUserById = createResolver({
- *   name: "getUserById",
- *   batchFn: async (keys: number[]): AsyncResult<User[], "QUERY_ERROR"> => {
- *     const users = await db.query("SELECT * FROM users WHERE id IN (?)", keys);
- *     return ok(users);
- *   },
- *   find: (user, key) => user.id === key,
- *   cache: true,
- * });
- *
- * // These batch into a single batchFn call
- * const [user1, user2] = await Promise.all([
- *   getUserById.load(1),
- *   getUserById.load(2),
- * ]);
- * ```
- */
-declare function createResolver<T, K, E extends string>(config: ResolverConfig<T, K, E>): Resolver<T, K, E>;
-
-export { type Resolver, type ResolverConfig, type ResolverNotFoundError, createResolver };

package/dist/resolver.d.ts

@@ -1,68 +0,0 @@
-import { R as Result, c as AsyncResult } from './run-entry-Dduz-is2.js';
-import { UnexpectedError } from './errors.js';
-import './tagged-error.js';
-import './slugs.js';
-
-/**
- * Configuration for createResolver.
- *
- * @typeParam T - The type of items returned by batchFn
- * @typeParam K - The type of keys used to identify items
- * @typeParam E - The error type from batchFn
- */
-interface ResolverConfig<T, K, E extends string> {
-    /** Human-readable name for this resolver (used in error messages) */
-    name: string;
-    /** Batch function that receives unique keys and returns all matching items */
-    batchFn: (keys: K[]) => AsyncResult<T[], E>;
-    /** Extract a dedup key from an input. Defaults to identity. */
-    key?: (input: K) => K;
-    /** Match a result item to a requested key */
-    find: (item: T, key: K) => boolean;
-    /** Enable per-key caching of ok results. No TTL in v1. */
-    cache?: boolean;
-}
-/** Error returned when batchFn succeeds but no item matches the requested key */
-type ResolverNotFoundError = "RESOLVER_NOT_FOUND";
-/**
- * A resolver instance created by createResolver.
- *
- * Resolvers should be created per-request/workflow, not as module-level singletons,
- * to avoid accidental cross-request batching.
- */
-interface Resolver<T, K, E extends string> {
-    /** Load a single item by key. Batches with other loads in the same microtask. */
-    load: (input: K) => Promise<Result<T, E | ResolverNotFoundError | UnexpectedError>>;
-    /** Load multiple items by key. Results array matches input order. */
-    loadMany: (inputs: K[]) => Promise<Result<T, E | ResolverNotFoundError | UnexpectedError>[]>;
-    /** Evict a single key from the cache */
-    clear: (input: K) => void;
-    /** Evict all cached entries */
-    clearAll: () => void;
-}
-/**
- * Create a DataLoader-style resolver that batches and deduplicates loads
- * within a single microtask tick.
- *
- * @example
- * ```typescript
- * const getUserById = createResolver({
- *   name: "getUserById",
- *   batchFn: async (keys: number[]): AsyncResult<User[], "QUERY_ERROR"> => {
- *     const users = await db.query("SELECT * FROM users WHERE id IN (?)", keys);
- *     return ok(users);
- *   },
- *   find: (user, key) => user.id === key,
- *   cache: true,
- * });
- *
- * // These batch into a single batchFn call
- * const [user1, user2] = await Promise.all([
- *   getUserById.load(1),
- *   getUserById.load(2),
- * ]);
- * ```
- */
-declare function createResolver<T, K, E extends string>(config: ResolverConfig<T, K, E>): Resolver<T, K, E>;
-
-export { type Resolver, type ResolverConfig, type ResolverNotFoundError, createResolver };

package/dist/resolver.js

@@ -1,7 +0,0 @@
-var De={"step-require-id":"step-require-id","step-no-immediate-execution":"step-no-immediate-execution","step-require-thunk-for-key":"step-require-thunk-for-key","step-no-bare-await":"step-no-bare-await","step-no-try-catch-wrap":"step-no-try-catch-wrap","step-stable-cache-keys":"step-stable-cache-keys","workflow-no-floating":"workflow-no-floating","workflow-options-position":"workflow-options-position","workflow-callback-shape":"workflow-callback-shape","workflow-no-callable-form":"workflow-no-callable-form","workflow-no-dynamic-import":"workflow-no-dynamic-import","result-no-floating":"result-no-floating","result-require-handling":"result-require-handling","result-no-double-wrap":"result-no-double-wrap","result-no-manual-propagation":"result-no-manual-propagation","result-no-direct-ok-err":"result-no-direct-ok-err","error-check-unexpected-first":"error-check-unexpected-first","error-access-cause":"error-access-cause","error-normalize":"error-normalize","error-no-throw-in-deps":"error-no-throw-in-deps","concurrency-no-promise-all":"concurrency-no-promise-all","concurrency-no-promise-race":"concurrency-no-promise-race","concurrency-no-promise-allsettled":"concurrency-no-promise-allsettled","runtime-step-timeout":"runtime-step-timeout","runtime-step-aborted":"runtime-step-aborted","runtime-retry-exhausted":"runtime-retry-exhausted","runtime-rate-limit":"runtime-rate-limit","runtime-circuit-open":"runtime-circuit-open","runtime-unexpected":"runtime-unexpected","runtime-resolver-not-found":"runtime-resolver-not-found","runtime-saga-compensation":"runtime-saga-compensation"};function we(o){return`https://jagreehal.github.io/awaitly/rules/#${o}`}var Ye=Object.keys(De);var se=class extends Error{_tag};function j(o,t){return class extends se{_tag=o;constructor(c,g){let P=t?.message?t.message(c??{}):o;if(super(P),this.name=o,t?.slug!==void 0){if(!t.hint)throw new TypeError(`TaggedError: 'hint' is required when 'slug' is set (slug: "${t.slug}")`);Object.defineProperty(this,"code",{value:t.slug,enumerable:!0,writable:!1,configurable:!1}),Object.defineProperty(this,"hint",{value:t.hint,enumerable:!0,writable:!1,configurable:!1}),Object.defineProperty(this,"docsUrl",{value:we(t.slug),enumerable:!0,writable:!1,configurable:!1})}if(Object.setPrototypeOf(this,new.target.prototype),c&&typeof c=="object"){let x;if(t?.slug!==void 0){let{_tag:a,name:K,message:O,stack:D,code:U,hint:i,docsUrl:I,...F}=c;x=F}else{let{_tag:a,name:K,message:O,stack:D,...U}=c;x=U}let C=Object.prototype.hasOwnProperty.call(x,"cause"),y=C?x.cause:void 0;C&&delete x.cause;let _=g?.cause!==void 0;if(C&&_)throw new TypeError("TaggedError: cannot provide 'cause' in props when also setting ErrorOptions.cause");Object.assign(this,x),C&&(this.cause=y),_&&(this.cause=g?.cause)}else g?.cause!==void 0&&(this.cause=g.cause)}}}Object.defineProperty(j,Symbol.hasInstance,{value:o=>o instanceof se});(P=>{function o(x){return x instanceof Error}P.isError=o;function t(x){return x instanceof se}P.isTaggedError=t;function c(x,C){let y=x._tag,_=C[y];return _(x)}P.match=c;function g(x,C,y){let _=x._tag,a=C[_];return a?a(x):y(x)}P.matchPartial=g})(j||={});var fe=class extends j("TimeoutError",{slug:"runtime-step-timeout",hint:"Increase the step's timeout option, or check why the upstream operation is slow.",message:t=>t.operation?`TimeoutError: ${t.operation} timed out after ${t.ms}ms`:`TimeoutError: Operation timed out after ${t.ms}ms`}){},ge=class extends j("RetryExhaustedError",{slug:"runtime-retry-exhausted",hint:"All retry attempts failed. Inspect lastError and decide whether to surface it or compensate.",message:t=>t.operation?`RetryExhaustedError: ${t.operation} failed after ${t.attempts} attempts`:`RetryExhaustedError: Operation failed after ${t.attempts} attempts`}){},Te=class extends j("RateLimitError",{slug:"runtime-rate-limit",hint:"Wait retryAfterMs before retrying, or apply step.cache to deduplicate calls.",message:t=>t.limiterName?`RateLimitError: Rate limit exceeded for ${t.limiterName}${t.retryAfterMs?`, retry after ${t.retryAfterMs}ms`:""}`:`RateLimitError: Rate limit exceeded${t.retryAfterMs?`, retry after ${t.retryAfterMs}ms`:""}`}){},ke=class extends j("CircuitBreakerOpenError",{slug:"runtime-circuit-open",hint:"The circuit is open. Wait for it to half-open or fall back to a degraded path.",message:t=>`CircuitBreakerOpenError: Circuit ${t.circuitName} is ${t.state??"OPEN"}${t.retryAfterMs?`, retry after ${Math.ceil(t.retryAfterMs/1e3)}s`:""}`}){},Re=class extends j("ValidationError",{message:t=>`ValidationError: Invalid ${t.field} - ${t.reason}`}){},xe=class extends j("NotFoundError",{message:t=>t.id?`NotFoundError: ${t.resource} with id ${t.id} not found`:`NotFoundError: ${t.resource} not found`}){},he=class extends j("UnauthorizedError",{message:t=>t.reason?`UnauthorizedError: ${t.reason}`:t.action&&t.resource?`UnauthorizedError: Not authorized to ${t.action} ${t.resource}`:"UnauthorizedError: Access denied"}){},Ce=class extends j("NetworkError",{message:t=>t.url?`NetworkError: ${t.reason} (${t.url})`:`NetworkError: ${t.reason}`}){},be=class extends j("CompensationError",{slug:"runtime-saga-compensation",hint:"A saga compensation step failed. Inspect compensationError and ensure compensation is idempotent.",message:t=>`CompensationError: Failed to compensate step ${t.step}`}){},ee=class extends j("UnexpectedError",{slug:"runtime-unexpected",hint:"An unexpected exception escaped a step. Inspect cause; consider returning a typed Result instead of throwing.",message:t=>`UnexpectedError: ${t.cause instanceof Error?t.cause.message:String(t.cause??"unknown")}`}){};function Ue(o){let t=o.trim().match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)$/i);if(!t)return;let c=parseFloat(t[1]),g=t[2].toLowerCase();return{_tag:"Duration",millis:c*({ms:1,s:1e3,m:6e4,h:36e5,d:864e5}[g]??1)}}function Ne(o){return new ee({cause:o})}function B(o){return{ok:!0,value:o}}function N(o,t){let c=t?.cause;return{ok:!1,error:o,...c!==void 0?{cause:c}:{}}}function Ke(o){if(o==null)return"unknown";if(typeof o=="string")return o.trim()||"unknown";if(typeof o=="object"){let t=o;if(typeof t._tag=="string"){let c=t._tag.trim();if(c)return c}if(typeof t.tag=="string"){let c=t.tag.trim();if(c)return c}if(typeof t.code=="string"){let c=t.code.trim();if(c)return c}else if(typeof t.code=="number")return String(t.code);if(o instanceof Error&&o.name){let c=o.name.trim();if(c)return c}}return"unknown"}function Fe(o,t){if(!(!t||!o))return t[o]}function je(o){let{intent:t,domain:c,owner:g,tags:P,stateChanges:x,emits:C,calls:y}=o;if(!t&&!c&&!g&&!P?.length&&!x?.length&&!C?.length&&!y?.length)return;let _={};return t&&(_.intent=t),c&&(_.domain=c),g&&(_.owner=g),P?.length&&(_.tags=P),x?.length&&(_.stateChanges=x),C?.length&&(_.emits=C),y?.length&&(_.calls=y),_}function V(o,t,c,g,P){let x=Ke(o),C=Fe(x,t),y={tag:x,origin:c};return C!==void 0&&(y.classification=C),g!==void 0&&(y.attempt=g),P!==void 0&&(y.cumulativeDurationMs=P),y}var ne=Symbol.for("step_timeout_marker");function Se(o){return typeof o!="object"||o===null?!1:o.type==="STEP_TIMEOUT"?!0:ne in o}function Le(o){if(!(typeof o!="object"||o===null)){if(o.type==="STEP_TIMEOUT"){let t=o;return{timeoutMs:t.timeoutMs,stepName:t.stepName,stepKey:t.stepKey,attempt:t.attempt}}if(ne in o)return o[ne]}}var Pe=Symbol("early-exit");function Be(o,t){return{[Pe]:!0,error:o,meta:t}}function Ve(o){return typeof o=="object"&&o!==null&&o[Pe]===!0}var Oe=Symbol("mapper-exception");function te(o){return{[Oe]:!0,thrown:o}}function $e(o){return typeof o=="object"&&o!==null&&o[Oe]===!0}function Ee(o,t){let{backoff:c,initialDelay:g,maxDelay:P,jitter:x}=t,C;switch(c){case"fixed":C=g;break;case"linear":C=g*o;break;case"exponential":C=g*Math.pow(2,o-1);break}if(C=Math.min(C,P),x){let y=C*.25*Math.random();C=C+y}return Math.floor(C)}function ye(o){return new Promise(t=>setTimeout(t,o))}var Ae=Symbol("timeout"),ue=Symbol("timeout-option");function He(o){return typeof o=="object"&&o!==null&&o[ue]===!0}async function We(o,t,c,g){let P=new AbortController,x=t.onTimeout??"error",C=()=>typeof x=="function"?x({name:c.name,key:c.key,ms:t.ms}):t.error??{type:"STEP_TIMEOUT",stepName:c.name,stepKey:c.key,timeoutMs:t.ms,attempt:c.attempt},y;g?.aborted&&P.abort(g.reason);let _;g&&!g.aborted&&(_=()=>P.abort(g.reason),g.addEventListener("abort",_,{once:!0}));let a=new Promise((O,D)=>{y=setTimeout(()=>{if(x!=="disconnect"&&P.abort(),x==="option"){D({[ue]:!0,ms:t.ms});return}D({[Ae]:!0,error:C()})},t.ms)}),K;t.signal?K=Promise.resolve(o(P.signal)):K=Promise.resolve(o());try{return await Promise.race([K,a])}catch(O){if(typeof O=="object"&&O!==null&&O[ue]===!0)throw{[ue]:!0,ms:t.ms};if(typeof O=="object"&&O!==null&&O[Ae]===!0){x==="disconnect"&&K.catch(()=>{});let D=O.error;if(typeof D=="object"&&D!==null&&D.type!=="STEP_TIMEOUT"){let U={timeoutMs:t.ms,stepName:c.name,stepKey:c.key,attempt:c.attempt};ne in D?D[ne]=U:Object.defineProperty(D,ne,{value:U,enumerable:!1,writable:!0,configurable:!1})}throw D}throw O}finally{clearTimeout(y),_&&g&&g.removeEventListener("abort",_)}}var re={backoff:"exponential",initialDelay:100,maxDelay:3e4,jitter:!0,shouldRetry:()=>!0,onRetry:()=>{}};async function _e(o,t){let{onError:c,onEvent:g,catchUnexpected:P,workflowId:x,workflowName:C,context:y,_workflowSignal:_}=t&&typeof t=="object"?t:{},a=x??crypto.randomUUID(),K=P??Ne,O=[],D=0,U=p=>p??`step_${++D}`,i=p=>{let H=p.context!==void 0||y===void 0?p:{...p,context:y},z=C!==void 0&&H.workflowName===void 0?{...H,workflowName:C}:H;if(z.type==="step_success"){let ae=z.stepId;for(let ie=O.length-1;ie>=0;ie--){let W=O[ie];if(W.type==="race"&&!W.winnerId){W.winnerId=ae;break}}}g?.(z,y)},I=Be,F=p=>Ve(p),$=(p,H)=>p,L=p=>typeof p=="function"?!1:!!(p&&typeof p=="object"&&"ok"in p||p&&typeof p=="object"&&"then"in p&&typeof p.then=="function");try{let H=function(s){let d={};for(let[r,n]of Object.entries(s))if(typeof n=="function")d[r]=n;else if(n&&typeof n=="object"&&"fn"in n)d[r]=n.fn;else throw new TypeError(`step.all: operation "${r}" must be a function or { fn, errors? } object`);return d},z=function(s,d){let r=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let n=performance.now(),e=!1;O.push({scopeId:r,type:"parallel"});let u=()=>{if(e)return;e=!0;let l=O.findIndex(m=>m.scopeId===r);l!==-1&&O.splice(l,1),i({type:"scope_end",workflowId:a,scopeId:r,ts:Date.now(),durationMs:performance.now()-n})};i({type:"scope_start",workflowId:a,scopeId:r,scopeType:"parallel",name:s,ts:Date.now()});try{let l=await d();if(u(),!l.ok)throw c?.(l.error,s,y),I(l.error,{origin:"result",resultCause:l.cause});return l.value}catch(l){throw u(),l}})()},ae=function(s,d){let r=Object.keys(s),n=d.name??`Parallel(${r.join(", ")})`,e=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let u=performance.now(),l=!1;O.push({scopeId:e,type:"parallel"});let m=()=>{if(l)return;l=!0;let E=O.findIndex(w=>w.scopeId===e);E!==-1&&O.splice(E,1),i({type:"scope_end",workflowId:a,scopeId:e,ts:Date.now(),durationMs:performance.now()-u})};i({type:"scope_start",workflowId:a,scopeId:e,scopeType:"parallel",name:n,ts:Date.now()});try{let E=await new Promise(T=>{if(r.length===0){T([]);return}let S=!1,M=r.length,k=new Array(r.length);for(let v=0;v<r.length;v++){let R=r[v],b=v;Promise.resolve(s[R]()).catch(h=>N({type:"PROMISE_REJECTED",cause:h},{cause:{type:"PROMISE_REJECTION",reason:h}})).then(h=>{if(!S){if(!h.ok){S=!0,T([{key:R,result:h}]);return}k[b]={key:R,result:h},M--,M===0&&T(k)}})}});m();let w={};for(let{key:T,result:S}of E){if(!S.ok)throw c?.(S.error,T,y),I(S.error,{origin:"result",resultCause:S.cause});w[T]=S.value}return w}catch(E){throw m(),E}})()};var X=H,Y=z,Z=ae;let p=(s,d,r)=>(async()=>{if(typeof s!="string"||s.length===0)throw new Error('[awaitly] step() requires an explicit string ID as the first argument. Example: step("fetchUser", () => fetchUser(id))');let n=r??{},e=je(n),u=s,l=n.key??s,m=n.key??s,{description:E,retry:w,timeout:T}=n,S=U(l),M=g,k=M?performance.now():0,R=L(d)?()=>d:d,h={attempts:Math.max(1,w?.attempts??1),backoff:w?.backoff??re.backoff,initialDelay:w?.initialDelay??re.initialDelay,maxDelay:w?.maxDelay??re.maxDelay,jitter:w?.jitter??re.jitter,shouldRetry:w?.shouldRetry??re.shouldRetry,onRetry:w?.onRetry??re.onRetry};g&&i({type:"step_start",workflowId:a,stepId:S,stepKey:l,name:u,description:E,ts:Date.now(),...e&&{metadata:e}});let Q;for(let A=1;A<=h.attempts;A++){let Me=M?performance.now():0;try{let f;if(T?f=await We(R,T,{name:u,key:l,attempt:A},_):f=await R(),f.ok){let G=performance.now()-k;return i({type:"step_success",workflowId:a,stepId:S,stepKey:l,name:u,description:E,ts:Date.now(),durationMs:G,...e&&{metadata:e}}),m&&i({type:"step_complete",workflowId:a,stepKey:m,name:u,description:E,ts:Date.now(),durationMs:G,result:f,...e&&{metadata:e}}),f.value}if(Q=f,A<h.attempts&&h.shouldRetry(f.error,A)){let G=Ee(A,h);i({type:"step_retry",workflowId:a,stepId:S,stepKey:l,name:u,ts:Date.now(),attempt:A+1,maxAttempts:h.attempts,delayMs:G,error:f.error,...e&&{metadata:e},diagnostics:V(f.error,n.errorMeta,"result",A,performance.now()-k)}),h.onRetry(f.error,A,G),await ye(G);continue}h.attempts>1&&i({type:"step_retries_exhausted",workflowId:a,stepId:S,stepKey:l,name:u,ts:Date.now(),durationMs:performance.now()-k,attempts:A,lastError:f.error,...e&&{metadata:e},diagnostics:V(f.error,n.errorMeta,"result",A,performance.now()-k)});break}catch(f){let G=performance.now()-Me;if(He(f)){let q=f.ms;i({type:"step_timeout",workflowId:a,stepId:S,stepKey:l,name:u,ts:Date.now(),timeoutMs:q,attempt:A,...e&&{metadata:e},diagnostics:V(f,n.errorMeta,"timeout",A)}),i({type:"step_success",workflowId:a,stepId:S,stepKey:l,name:u,description:E,ts:Date.now(),durationMs:performance.now()-k,...e&&{metadata:e}}),m&&i({type:"step_complete",workflowId:a,stepKey:m,name:u,description:E,ts:Date.now(),durationMs:performance.now()-k,result:B(void 0),...e&&{metadata:e}});return}if(F(f))throw i({type:"step_aborted",workflowId:a,stepId:S,stepKey:l,name:u,description:E,ts:Date.now(),durationMs:G,...e&&{metadata:e}}),f;if(Se(f)){let q=Le(f),Ie=T?.ms??q?.timeoutMs??0;if(i({type:"step_timeout",workflowId:a,stepId:S,stepKey:l,name:u,ts:Date.now(),timeoutMs:Ie,attempt:A,...e&&{metadata:e},diagnostics:V(f,n.errorMeta,"timeout",A)}),A<h.attempts&&h.shouldRetry(f,A)){let me=Ee(A,h);i({type:"step_retry",workflowId:a,stepId:S,stepKey:l,name:u,ts:Date.now(),attempt:A+1,maxAttempts:h.attempts,delayMs:me,error:f,...e&&{metadata:e},diagnostics:V(f,n.errorMeta,"timeout",A,performance.now()-k)}),h.onRetry(f,A,me),await ye(me);continue}h.attempts>1&&i({type:"step_retries_exhausted",workflowId:a,stepId:S,stepKey:l,name:u,ts:Date.now(),durationMs:performance.now()-k,attempts:A,lastError:f,...e&&{metadata:e},diagnostics:V(f,n.errorMeta,"timeout",A,performance.now()-k)});let de=performance.now()-k;throw i({type:"step_error",workflowId:a,stepId:S,stepKey:l,name:u,description:E,ts:Date.now(),durationMs:de,error:f,...e&&{metadata:e},diagnostics:V(f,n.errorMeta,"timeout",A,de)}),m&&i({type:"step_complete",workflowId:a,stepKey:m,name:u,description:E,ts:Date.now(),durationMs:de,result:N(f,{cause:f}),meta:{origin:"throw",thrown:f},...e&&{metadata:e}}),c?.(f,u,y),I(f,{origin:"throw",thrown:f})}if(A<h.attempts&&h.shouldRetry(f,A)){let q=Ee(A,h);i({type:"step_retry",workflowId:a,stepId:S,stepKey:l,name:u,ts:Date.now(),attempt:A+1,maxAttempts:h.attempts,delayMs:q,error:f,...e&&{metadata:e},diagnostics:V(f,n.errorMeta,"throw",A,performance.now()-k)}),h.onRetry(f,A,q),await ye(q);continue}h.attempts>1&&!Se(f)&&i({type:"step_retries_exhausted",workflowId:a,stepId:S,stepKey:l,name:u,ts:Date.now(),durationMs:performance.now()-k,attempts:A,lastError:f,...e&&{metadata:e},diagnostics:V(f,n.errorMeta,"throw",A,performance.now()-k)});let pe=performance.now()-k,oe;try{oe=K(f)}catch(q){throw te(q)}throw i({type:"step_error",workflowId:a,stepId:S,stepKey:l,name:u,description:E,ts:Date.now(),durationMs:pe,error:oe,...e&&{metadata:e},diagnostics:V(f,n.errorMeta,"throw",A,pe)}),m&&i({type:"step_complete",workflowId:a,stepKey:m,name:u,description:E,ts:Date.now(),durationMs:pe,result:N(oe,{cause:f}),meta:{origin:"throw",thrown:f},...e&&{metadata:e}}),c?.(oe,u,y),I(oe,{origin:"throw",thrown:f})}}let J=Q,ce=performance.now()-k,le=$(J.error,{origin:"result",resultCause:J.cause});throw i({type:"step_error",workflowId:a,stepId:S,stepKey:l,name:u,description:E,ts:Date.now(),durationMs:ce,error:le,...e&&{metadata:e},diagnostics:V(J.error,n.errorMeta,"result",h.attempts,ce)}),m&&i({type:"step_complete",workflowId:a,stepKey:m,name:u,description:E,ts:Date.now(),durationMs:ce,result:J,meta:{origin:"result",resultCause:J.cause},...e&&{metadata:e}}),c?.(le,u,y),I(le,{origin:"result",resultCause:J.cause})})();p.try=(s,d,r)=>{if(typeof s!="string"||s.length===0)throw new Error('[awaitly] step.try() requires an explicit string ID as the first argument. Example: step.try("parse", () => JSON.parse(str), { error: "PARSE_ERROR" })');let n="error"in r?()=>r.error:r.onError;if(r.retry||r.timeout)return p.retry(s,async()=>{try{return B(await d())}catch(E){return N(n(E),{cause:E})}},{attempts:r.retry?.attempts??1,...r.retry??{},key:r.key,timeout:r.timeout});let e=r.key??s,u=s,l=s,m=g;return(async()=>{let E=m?performance.now():0;g&&i({type:"step_start",workflowId:a,stepId:l,stepKey:e,name:u,ts:Date.now()});try{let w=await d(),T=performance.now()-E;return i({type:"step_success",workflowId:a,stepId:l,stepKey:e,name:u,ts:Date.now(),durationMs:T}),e&&i({type:"step_complete",workflowId:a,stepKey:e,name:u,ts:Date.now(),durationMs:T,result:B(w)}),w}catch(w){let T=n(w),S=performance.now()-E,M=$(T,{origin:"throw",thrown:w});throw i({type:"step_error",workflowId:a,stepId:l,stepKey:e,name:u,ts:Date.now(),durationMs:S,error:M}),e&&i({type:"step_complete",workflowId:a,stepKey:e,name:u,ts:Date.now(),durationMs:S,result:N(T,{cause:w}),meta:{origin:"throw",thrown:w}}),c?.(M,u,y),I(M,{origin:"throw",thrown:w})}})()},p.fromResult=(s,d,r)=>{if(typeof s!="string"||s.length===0)throw new Error('[awaitly] step.fromResult() requires an explicit string ID as the first argument. Example: step.fromResult("callProvider", () => callProvider(input), { onError: (e) => ({ type: "FAILED" }) })');let n=r.key??s,e=s,u=s,l="error"in r?()=>r.error:r.onError,m=g;return(async()=>{let E=m?performance.now():0;g&&i({type:"step_start",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now()});let w=await d();if(w.ok){let T=performance.now()-E;return i({type:"step_success",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:T}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:T,result:B(w.value)}),w.value}else{let T=l(w.error),S=performance.now()-E,M=$(T,{origin:"result",resultCause:w.error});throw i({type:"step_error",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:S,error:M}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:S,result:N(T,{cause:w.error}),meta:{origin:"result",resultCause:w.error}}),c?.(M,e,y),I(M,{origin:"result",resultCause:w.error})}})()},p.fromNullable=(s,d,r,n)=>{if(typeof s!="string"||s.length===0)throw new Error('[awaitly] step.fromNullable() requires an explicit string ID as the first argument. Example: step.fromNullable("getUser", () => db.find(id), () => ({ type: "NOT_FOUND" }))');return p(s,async()=>{let e=await d();return e!=null?B(e):N(r())},n)},p.retry=(s,d,r)=>{if(typeof s!="string"||s.length===0)throw new Error('[awaitly] step.retry() requires an explicit string ID as the first argument. Example: step.retry("fetchData", () => fetchData(), { attempts: 3 })');return p(s,d,{key:r.key??s,retry:{attempts:r.attempts,backoff:r.backoff,initialDelay:r.initialDelay,maxDelay:r.maxDelay,jitter:r.jitter,shouldRetry:r.shouldRetry,onRetry:r.onRetry},timeout:r.timeout})},p.withTimeout=(s,d,r)=>{if(typeof s!="string"||s.length===0)throw new Error('[awaitly] step.withTimeout() requires an explicit string ID as the first argument. Example: step.withTimeout("slowOp", () => slowOp(), { ms: 5000 })');return p(s,d,{key:r.key??s,timeout:r})},p.sleep=(s,d,r)=>{if(typeof s!="string"||s.length===0)throw new Error('[awaitly] step.sleep() requires an explicit string ID as the first argument. Example: step.sleep("delay", "5s")');let n=typeof d=="string"?Ue(d):d;if(!n)throw new Error(`step.sleep: invalid duration '${d}'`);let e=n.millis,u=r?.signal;return p(s,async()=>{if(_?.aborted||u?.aborted){let l=new Error("Sleep aborted");throw l.name="AbortError",l}return new Promise((l,m)=>{let E={timeoutId:void 0},w=()=>{E.timeoutId&&clearTimeout(E.timeoutId);let T=new Error("Sleep aborted");T.name="AbortError",m(T)};_?.addEventListener("abort",w,{once:!0}),u?.addEventListener("abort",w,{once:!0}),E.timeoutId=setTimeout(()=>{_?.removeEventListener("abort",w),u?.removeEventListener("abort",w),l(B(void 0))},e)})},{key:r?.key??s,description:r?.description})},p.all=((...s)=>{if(typeof s[0]!="string")throw new TypeError("step.all(name, ...): first argument must be a string (step name). Example: step.all('Fetch data', { user: () => fetchUser(), posts: () => fetchPosts() })");let d=s[0],r=s[1];if(typeof r=="function")return z(d,r);if(r&&typeof r=="object"&&!Array.isArray(r)){let e=H(r);return ae(e,{name:d})}throw new TypeError("step.all(name, ...): second argument must be a function (array form) or an object of operations (object form).")}),p.race=(s,d)=>{let r=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let n=performance.now(),e=!1,u={scopeId:r,type:"race",winnerId:void 0};O.push(u);let l=()=>{if(e)return;e=!0;let m=O.findIndex(E=>E.scopeId===r);m!==-1&&O.splice(m,1),i({type:"scope_end",workflowId:a,scopeId:r,ts:Date.now(),durationMs:performance.now()-n,winnerId:u.winnerId})};i({type:"scope_start",workflowId:a,scopeId:r,scopeType:"race",name:s,ts:Date.now()});try{let m=await d();if(l(),!m.ok)throw c?.(m.error,s,y),I(m.error,{origin:"result",resultCause:m.cause});return m.value}catch(m){throw l(),m}})()},p.if=(s,d,r)=>r(),p.label=p.if,p.branch=async(s,d)=>{let{condition:r,then:n,else:e}=d;if(r())return await n();if(e)return await e()},p.arm=(s,d)=>({fn:s,errors:d}),p.forEach=async(s,d,r)=>{let n=[],e=r.maxIterations,u=0,l="run"in r,m=Symbol.asyncIterator in d?d:(async function*(){yield*d})();for await(let E of m){if(e!==void 0&&u>=e)break;let w;l?w=await r.run(E,u):w=await r.item.handler(E,u,p),n.push(w),u++}return n},p.item=s=>({__forEachItemHandler:!0,handler:s}),p.dep=(s,d)=>d,p.workflow=(s,d,r)=>p(s,d,r),p.map=async(s,d,r,n)=>{let e=n?.concurrency??d.length;return p(s,()=>e>=d.length?ve(d.map((u,l)=>r(u,l))):(async()=>{let u=[];for(let l=0;l<d.length;l+=e){let m=d.slice(l,l+e),E=await ve(m.map((w,T)=>r(w,l+T)));if(!E.ok)return E;u.push(...E.value)}return B(u)})(),{key:n?.key})},p.withFallback=(s,d,r)=>{if(typeof s!="string"||s.length===0)throw new Error('[awaitly] step.withFallback() requires an explicit string ID as the first argument. Example: step.withFallback("getUser", () => fetchUser(id), { fallback: () => fetchFromCache(id) })');let n=r.key??s,e=s,u=U(n),l=g;return(async()=>{let m=l?performance.now():0;g&&i({type:"step_start",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now()});let E;try{E=await d()}catch(k){if(F(k))throw i({type:"step_aborted",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:performance.now()-m}),k;let v;try{v=K(k)}catch(b){throw te(b)}if(r.on!==void 0&&r.on!==v){let b=performance.now()-m;throw i({type:"step_error",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:b,error:v}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:b,result:N(v,{cause:k}),meta:{origin:"throw",thrown:k}}),c?.(v,e,y),I(v,{origin:"throw",thrown:k})}let R;try{R=await r.fallback()}catch(b){if(F(b))throw i({type:"step_aborted",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:performance.now()-m}),b;let h;try{h=K(b)}catch(J){throw te(J)}let Q=performance.now()-m;throw i({type:"step_error",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:Q,error:h}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:Q,result:N(h,{cause:b}),meta:{origin:"throw",thrown:b}}),c?.(h,e,y),I(h,{origin:"throw",thrown:b})}if(R.ok){let b=performance.now()-m;return i({type:"step_success",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:b}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:b,result:R,meta:{origin:"fallback",fallbackUsed:!0,fallbackReason:String(v)}}),R.value}else{let b=performance.now()-m,h=$(R.error,{origin:"result",resultCause:R.cause});throw i({type:"step_error",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:b,error:h}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:b,result:R,meta:{origin:"result",resultCause:R.cause}}),c?.(h,e,y),I(h,{origin:"result",resultCause:R.cause})}}if(E.ok){let k=performance.now()-m;return i({type:"step_success",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:k}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:k,result:E}),E.value}let w=E.error;if(r.on!==void 0&&r.on!==w){let k=performance.now()-m,v=$(w,{origin:"result",resultCause:E.cause});throw i({type:"step_error",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:k,error:v}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:k,result:E,meta:{origin:"result",resultCause:E.cause}}),c?.(v,e,y),I(v,{origin:"result",resultCause:E.cause})}let T;try{T=await r.fallback()}catch(k){if(F(k))throw i({type:"step_aborted",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:performance.now()-m}),k;let v;try{v=K(k)}catch(b){throw te(b)}let R=performance.now()-m;throw i({type:"step_error",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:R,error:v}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:R,result:N(v,{cause:k}),meta:{origin:"throw",thrown:k}}),c?.(v,e,y),I(v,{origin:"throw",thrown:k})}if(T.ok){let k=performance.now()-m;return i({type:"step_success",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:k}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:k,result:T,meta:{origin:"fallback",fallbackUsed:!0,fallbackReason:String(w)}}),T.value}let S=performance.now()-m,M=$(T.error,{origin:"result",resultCause:T.cause});throw i({type:"step_error",workflowId:a,stepId:u,stepKey:n,name:e,ts:Date.now(),durationMs:S,error:M}),n&&i({type:"step_complete",workflowId:a,stepKey:n,name:e,ts:Date.now(),durationMs:S,result:T,meta:{origin:"result",resultCause:T.cause}}),c?.(M,e,y),I(M,{origin:"result",resultCause:T.cause})})()},p.withResource=(s,d)=>{if(typeof s!="string"||s.length===0)throw new Error('[awaitly] step.withResource() requires an explicit string ID as the first argument. Example: step.withResource("useDb", { acquire: () => connect(), use: (db) => query(db), release: (db) => db.close() })');let r=s,n=s,e=U(r),u=g;return(async()=>{let l=u?performance.now():0;g&&i({type:"step_start",workflowId:a,stepId:e,stepKey:r,name:n,ts:Date.now()});let m;try{m=await d.acquire()}catch(R){if(F(R))throw i({type:"step_aborted",workflowId:a,stepId:e,stepKey:r,name:n,ts:Date.now(),durationMs:performance.now()-l}),R;let b;try{b=K(R)}catch(Q){throw te(Q)}let h=performance.now()-l;throw i({type:"step_error",workflowId:a,stepId:e,stepKey:r,name:n,ts:Date.now(),durationMs:h,error:b}),r&&i({type:"step_complete",workflowId:a,stepKey:r,name:n,ts:Date.now(),durationMs:h,result:N(b,{cause:R}),meta:{origin:"throw",thrown:R}}),c?.(b,n,y),I(b,{origin:"throw",thrown:R})}if(!m.ok){let R=performance.now()-l,b=$(m.error,{origin:"result",resultCause:m.cause});throw i({type:"step_error",workflowId:a,stepId:e,stepKey:r,name:n,ts:Date.now(),durationMs:R,error:b}),r&&i({type:"step_complete",workflowId:a,stepKey:r,name:n,ts:Date.now(),durationMs:R,result:m,meta:{origin:"result",resultCause:m.cause}}),c?.(b,n,y),I(b,{origin:"result",resultCause:m.cause})}let E=m.value,w,T,S=!1;try{w=await d.use(E)}catch(R){if(F(R)){try{await d.release(E)}catch(b){console.warn(`[awaitly] step.withResource("${s}"): release threw after earlyExit:`,b)}throw R}T=R,S=!0}try{await d.release(E)}catch(R){console.warn(`[awaitly] step.withResource("${s}"): release threw:`,R)}if(S){let R;try{R=K(T)}catch(h){throw te(h)}let b=performance.now()-l;throw i({type:"step_error",workflowId:a,stepId:e,stepKey:r,name:n,ts:Date.now(),durationMs:b,error:R}),r&&i({type:"step_complete",workflowId:a,stepKey:r,name:n,ts:Date.now(),durationMs:b,result:N(R,{cause:T}),meta:{origin:"throw",thrown:T}}),c?.(R,n,y),I(R,{origin:"throw",thrown:T})}let M=w;if(M.ok){let R=performance.now()-l;return i({type:"step_success",workflowId:a,stepId:e,stepKey:r,name:n,ts:Date.now(),durationMs:R}),r&&i({type:"step_complete",workflowId:a,stepKey:r,name:n,ts:Date.now(),durationMs:R,result:M}),M.value}let k=performance.now()-l,v=$(M.error,{origin:"result",resultCause:M.cause});throw i({type:"step_error",workflowId:a,stepId:e,stepKey:r,name:n,ts:Date.now(),durationMs:k,error:v}),r&&i({type:"step_complete",workflowId:a,stepKey:r,name:n,ts:Date.now(),durationMs:k,result:M,meta:{origin:"result",resultCause:M.cause}}),c?.(v,n,y),I(v,{origin:"result",resultCause:M.cause})})()};let W=await o({step:p});if(process.env.NODE_ENV!=="production"&&W!==null&&typeof W=="object"&&"ok"in W&&typeof W.ok=="boolean"){let s=W;(s.ok===!0&&"value"in s||s.ok===!1&&"error"in s)&&console.warn(`awaitly: Workflow executor returned a Result-like object. Return raw values, not ok() or err().
-
-  Incorrect: return ok({ data });
-  Correct:   return { data };
-
-See: https://jagreehal.github.io/awaitly/guides/troubleshooting/#returning-ok-from-workflow-executor-double-wrapping`)}return B(W)}catch(p){if($e(p))throw p.thrown;if(F(p)){let z=p.meta.origin==="throw"?p.meta.thrown:p.meta.origin==="result"?p.meta.resultCause:void 0;return N(p.error,{cause:z})}let H=K(p);return c?.(H,"unexpected",y),N(H,{cause:p})}}_e.strict=(o,t)=>_e(o,t);async function ve(o){return o.length===0?B([]):new Promise(t=>{let c=!1,g=o.length,P=new Array(o.length);for(let x=0;x<o.length;x++){let C=x;Promise.resolve(o[C]).catch(y=>N({type:"PROMISE_REJECTED",cause:y},{cause:{type:"PROMISE_REJECTION",reason:y}})).then(y=>{if(!c){if(!y.ok){c=!0,t(y);return}P[C]=y.value,g--,g===0&&t(B(P))}})}})}function qe(o){let t=o.key??(D=>D),c=new Map,g=[],P=[],x=!1,C=new Map;async function y(){x=!1;let D=[...g],U=[...P];g.length=0,P.length=0;let i=new Set,I=[];for(let L of D)i.has(L)||(i.add(L),I.push(L));let F;try{F=await o.batchFn(I)}catch(L){let X=N(new ee({cause:L}));for(let{key:Y,resolve:Z}of U)Z(X),c.delete(Y);return}if(!F.ok){let L=N(F.error);for(let{key:X,resolve:Y}of U)Y(L),c.delete(X);return}let $=F.value;for(let{key:L,resolve:X}of U){let Y=$.find(Z=>o.find(Z,L));if(Y!==void 0){let Z=B(Y);o.cache&&C.set(L,Y),X(Z)}else X(N("RESOLVER_NOT_FOUND"));c.delete(L)}}function _(D){let U=t(D);if(o.cache&&C.has(U))return Promise.resolve(B(C.get(U)));let i=c.get(U);if(i)return i;let I=new Promise(F=>{g.push(U),P.push({key:U,resolve:F})});return c.set(U,I),x||(x=!0,queueMicrotask(y)),I}async function a(D){let U=D.map(i=>_(i));return Promise.all(U)}function K(D){let U=t(D);C.delete(U)}function O(){C.clear()}return{load:_,loadMany:a,clear:K,clearAll:O}}export{qe as createResolver};
-//# sourceMappingURL=resolver.js.map