awaitly 1.34.0 → 2.0.0

package/dist/flow.cjs

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