awaitly 1.35.0 → 2.0.0

package/dist/di-By77n4Fa.d.ts

@@ -1,15 +0,0 @@
-import { UnexpectedError } from './errors.js';
-import { c as Workflow } from './persistence-entry-D8zRkLiT.js';
-
-/**
- * Pre-bind dependency overrides on a workflow.
- *
- * Returns another `Workflow` with the same shape — chain `.withDeps()`,
- * call `.run()` / `.runWithState()` exactly as before.
- *
- * Precedence (lowest → highest):
- *   createWorkflow deps  <  withDeps deps  <  run config deps
- */
-declare function withDeps<E, U = UnexpectedError, Deps = unknown, C = void>(workflow: Workflow<E, U, Deps, C>, overrides: Partial<Deps>): Workflow<E, U, Deps, C>;
-
-export { withDeps as w };

package/dist/di-OJfsohf-.d.cts

@@ -1,15 +0,0 @@
-import { UnexpectedError } from './errors.cjs';
-import { c as Workflow } from './persistence-entry-B-8PjnSR.cjs';
-
-/**
- * Pre-bind dependency overrides on a workflow.
- *
- * Returns another `Workflow` with the same shape — chain `.withDeps()`,
- * call `.run()` / `.runWithState()` exactly as before.
- *
- * Precedence (lowest → highest):
- *   createWorkflow deps  <  withDeps deps  <  run config deps
- */
-declare function withDeps<E, U = UnexpectedError, Deps = unknown, C = void>(workflow: Workflow<E, U, Deps, C>, overrides: Partial<Deps>): Workflow<E, U, Deps, C>;
-
-export { withDeps as w };

package/dist/diagnostics.cjs

@@ -1,8 +0,0 @@
-"use strict";var ye=Object.defineProperty;var He=Object.getOwnPropertyDescriptor;var $e=Object.getOwnPropertyNames;var qe=Object.prototype.hasOwnProperty;var Ye=(r,e)=>{for(var l in e)ye(r,l,{get:e[l],enumerable:!0})},ze=(r,e,l,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let C of $e(e))!qe.call(r,C)&&C!==l&&ye(r,C,{get:()=>e[C],enumerable:!(a=He(e,C))||a.enumerable});return r};var Je=r=>ze(ye({},"__esModule",{value:!0}),r);var pr={};Ye(pr,{createDiagnosticsCollector:()=>Be});module.exports=Je(pr);var Ge={"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 xe(r){return`https://jagreehal.github.io/awaitly/rules/#${r}`}var dr=Object.keys(Ge);var ce=class extends Error{_tag};function H(r,e){return class extends ce{_tag=r;constructor(l,a){let C=e?.message?e.message(l??{}):r;if(super(C),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:xe(e.slug),enumerable:!0,writable:!1,configurable:!1})}if(Object.setPrototypeOf(this,new.target.prototype),l&&typeof l=="object"){let m;if(e?.slug!==void 0){let{_tag:_,name:S,message:j,stack:s,code:W,hint:B,docsUrl:te,...$}=l;m=$}else{let{_tag:_,name:S,message:j,stack:s,...W}=l;m=W}let R=Object.prototype.hasOwnProperty.call(m,"cause"),p=R?m.cause:void 0;R&&delete m.cause;let M=a?.cause!==void 0;if(R&&M)throw new TypeError("TaggedError: cannot provide 'cause' in props when also setting ErrorOptions.cause");Object.assign(this,m),R&&(this.cause=p),M&&(this.cause=a?.cause)}else a?.cause!==void 0&&(this.cause=a.cause)}}}Object.defineProperty(H,Symbol.hasInstance,{value:r=>r instanceof ce});(C=>{function r(m){return m instanceof Error}C.isError=r;function e(m){return m instanceof ce}C.isTaggedError=e;function l(m,R){let p=m._tag,M=R[p];return M(m)}C.match=l;function a(m,R,p){let M=m._tag,_=R[M];return _?_(m):p(m)}C.matchPartial=a})(H||={});var Ce=class extends H("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`}){},he=class extends H("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`}){},be=class extends H("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`:""}`}){},Ae=class extends H("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`:""}`}){},Se=class extends H("ValidationError",{message:e=>`ValidationError: Invalid ${e.field} - ${e.reason}`}){},Pe=class extends H("NotFoundError",{message:e=>e.id?`NotFoundError: ${e.resource} with id ${e.id} not found`:`NotFoundError: ${e.resource} not found`}){},ve=class extends H("UnauthorizedError",{message:e=>e.reason?`UnauthorizedError: ${e.reason}`:e.action&&e.resource?`UnauthorizedError: Not authorized to ${e.action} ${e.resource}`:"UnauthorizedError: Access denied"}){},_e=class extends H("NetworkError",{message:e=>e.url?`NetworkError: ${e.reason} (${e.url})`:`NetworkError: ${e.reason}`}){},Oe=class extends H("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}`}){},le=class extends H("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 Me(r){return{ok:!0,value:r}}var Xe=r=>typeof r=="object"&&r!==null&&"ok"in r&&typeof r.ok=="boolean"&&(r.ok?"value"in r:"error"in r),Ie=(r,e)=>{let l={},a=new Map;for(let C of Object.keys(r)){let m=r[C];typeof m=="function"&&(l[C]=(...R)=>{let p=(a.get(C)??0)+1;a.set(C,p);let M=p===1?C:`${C}#${p}`;return e(M,async()=>{let _=await m(...R);return Xe(_)?_:Me(_)})})}return l};function Ze(r){let e=r.trim().match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)$/i);if(!e)return;let l=parseFloat(e[1]),a=e[2].toLowerCase();return{_tag:"Duration",millis:l*({ms:1,s:1e3,m:6e4,h:36e5,d:864e5}[a]??1)}}function Qe(r){return new le({cause:r})}function J(r){return{ok:!0,value:r}}function L(r,e){let l=e?.cause;return{ok:!1,error:r,...l!==void 0?{cause:l}:{}}}function Re(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 l=e._tag.trim();if(l)return l}if(typeof e.tag=="string"){let l=e.tag.trim();if(l)return l}if(typeof e.code=="string"){let l=e.code.trim();if(l)return l}else if(typeof e.code=="number")return String(e.code);if(r instanceof Error&&r.name){let l=r.name.trim();if(l)return l}}return"unknown"}function er(r,e){if(!(!e||!r))return e[r]}function rr(r){let{intent:e,domain:l,owner:a,tags:C,stateChanges:m,emits:R,calls:p}=r;if(!e&&!l&&!a&&!C?.length&&!m?.length&&!R?.length&&!p?.length)return;let M={};return e&&(M.intent=e),l&&(M.domain=l),a&&(M.owner=a),C?.length&&(M.tags=C),m?.length&&(M.stateChanges=m),R?.length&&(M.emits=R),p?.length&&(M.calls=p),M}function q(r,e,l,a,C){let m=Re(r),R=er(m,e),p={tag:m,origin:l};return R!==void 0&&(p.classification=R),a!==void 0&&(p.attempt=a),C!==void 0&&(p.cumulativeDurationMs=C),p}var ie=Symbol.for("step_timeout_marker");function De(r){return typeof r!="object"||r===null?!1:r.type==="STEP_TIMEOUT"?!0:ie in r}function tr(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(ie in r)return r[ie]}}var Ne=Symbol("early-exit");function nr(r,e){return{[Ne]:!0,error:r,meta:e}}function or(r){return typeof r=="object"&&r!==null&&r[Ne]===!0}var je=Symbol("mapper-exception");function se(r){return{[je]:!0,thrown:r}}function sr(r){return typeof r=="object"&&r!==null&&r[je]===!0}function ke(r,e){let{backoff:l,initialDelay:a,maxDelay:C,jitter:m}=e,R;switch(l){case"fixed":R=a;break;case"linear":R=a*r;break;case"exponential":R=a*Math.pow(2,r-1);break}if(R=Math.min(R,C),m){let p=R*.25*Math.random();R=R+p}return Math.floor(R)}function Te(r){return new Promise(e=>setTimeout(e,r))}var Ue=Symbol("timeout"),pe=Symbol("timeout-option");function ar(r){return typeof r=="object"&&r!==null&&r[pe]===!0}async function ir(r,e,l,a){let C=new AbortController,m=e.onTimeout??"error",R=()=>typeof m=="function"?m({name:l.name,key:l.key,ms:e.ms}):e.error??{type:"STEP_TIMEOUT",stepName:l.name,stepKey:l.key,timeoutMs:e.ms,attempt:l.attempt},p;a?.aborted&&C.abort(a.reason);let M;a&&!a.aborted&&(M=()=>C.abort(a.reason),a.addEventListener("abort",M,{once:!0}));let _=new Promise((j,s)=>{p=setTimeout(()=>{if(m!=="disconnect"&&C.abort(),m==="option"){s({[pe]:!0,ms:e.ms});return}s({[Ue]:!0,error:R()})},e.ms)}),S;e.signal?S=Promise.resolve(r(C.signal)):S=Promise.resolve(r());try{return await Promise.race([S,_])}catch(j){if(typeof j=="object"&&j!==null&&j[pe]===!0)throw{[pe]:!0,ms:e.ms};if(typeof j=="object"&&j!==null&&j[Ue]===!0){m==="disconnect"&&S.catch(()=>{});let s=j.error;if(typeof s=="object"&&s!==null&&s.type!=="STEP_TIMEOUT"){let W={timeoutMs:e.ms,stepName:l.name,stepKey:l.key,attempt:l.attempt};ie in s?s[ie]=W:Object.defineProperty(s,ie,{value:W,enumerable:!1,writable:!0,configurable:!1})}throw s}throw j}finally{clearTimeout(p),M&&a&&a.removeEventListener("abort",M)}}var ae={backoff:"exponential",initialDelay:100,maxDelay:3e4,jitter:!0,shouldRetry:()=>!0,onRetry:()=>{}};async function ge(r,e,l){if(typeof r!="function"){let E=r,K=e;if(typeof K!="function")throw new TypeError("[awaitly] run(deps, fn) requires a callback as the second argument. Example: run({ getUser }, async (s) => s.getUser(id))");return ge(({step:F})=>K(Ie(E,F),{step:F}),l)}let a=r,C=e,{onError:m,onEvent:R,catchUnexpected:p,workflowId:M,workflowName:_,context:S,_workflowSignal:j}=C&&typeof C=="object"?C:{},s=M??crypto.randomUUID(),W=p??Qe,B=[],te=0,$=E=>E??`step_${++te}`,i=E=>{let K=E.context!==void 0||S===void 0?E:{...E,context:S},N=_!==void 0&&K.workflowName===void 0?{...K,workflowName:_}:K;if(N.type==="step_success"){let F=N.stepId;for(let ee=B.length-1;ee>=0;ee--){let z=B[ee];if(z.type==="race"&&!z.winnerId){z.winnerId=F;break}}}R?.(N,S)},k=nr,D=E=>or(E),V=(E,K)=>E,Y=E=>typeof E=="function"?!1:!!(E&&typeof E=="object"&&"ok"in E||E&&typeof E=="object"&&"then"in E&&typeof E.then=="function");try{let K=function(u){let f={};for(let[n,o]of Object.entries(u))if(typeof o=="function")f[n]=o;else if(o&&typeof o=="object"&&"fn"in o)f[n]=o.fn;else throw new TypeError(`step.all: operation "${n}" must be a function or { fn, errors? } object`);return f},N=function(u,f){let n=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let o=performance.now(),t=!1;B.push({scopeId:n,type:"parallel"});let c=()=>{if(t)return;t=!0;let d=B.findIndex(w=>w.scopeId===n);d!==-1&&B.splice(d,1),i({type:"scope_end",workflowId:s,scopeId:n,ts:Date.now(),durationMs:performance.now()-o})};i({type:"scope_start",workflowId:s,scopeId:n,scopeType:"parallel",name:u,ts:Date.now()});try{let d=await f();if(c(),!d.ok)throw m?.(d.error,u,S),k(d.error,{origin:"result",resultCause:d.cause});return d.value}catch(d){throw c(),d}})()},F=function(u,f){let n=Object.keys(u),o=f.name??`Parallel(${n.join(", ")})`,t=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let c=performance.now(),d=!1;B.push({scopeId:t,type:"parallel"});let w=()=>{if(d)return;d=!0;let y=B.findIndex(T=>T.scopeId===t);y!==-1&&B.splice(y,1),i({type:"scope_end",workflowId:s,scopeId:t,ts:Date.now(),durationMs:performance.now()-c})};i({type:"scope_start",workflowId:s,scopeId:t,scopeType:"parallel",name:o,ts:Date.now()});try{let y=await new Promise(x=>{if(n.length===0){x([]);return}let v=!1,U=n.length,h=new Array(n.length);for(let I=0;I<n.length;I++){let b=n[I],P=I;Promise.resolve(u[b]()).catch(A=>L({type:"PROMISE_REJECTED",cause:A},{cause:{type:"PROMISE_REJECTION",reason:A}})).then(A=>{if(!v){if(!A.ok){v=!0,x([{key:b,result:A}]);return}h[P]={key:b,result:A},U--,U===0&&x(h)}})}});w();let T={};for(let{key:x,result:v}of y){if(!v.ok)throw m?.(v.error,x,S),k(v.error,{origin:"result",resultCause:v.cause});T[x]=v.value}return T}catch(y){throw w(),y}})()};var ne=K,oe=N,X=F;let E=(u,f,n)=>(async()=>{if(typeof u!="string"||u.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=rr(o),c=u,d=o.key??u,w=o.key??u,{description:y,retry:T,timeout:x}=o,v=$(d),U=R,h=U?performance.now():0,b=Y(f)?()=>f:f,A={attempts:Math.max(1,T?.attempts??1),backoff:T?.backoff??ae.backoff,initialDelay:T?.initialDelay??ae.initialDelay,maxDelay:T?.maxDelay??ae.maxDelay,jitter:T?.jitter??ae.jitter,shouldRetry:T?.shouldRetry??ae.shouldRetry,onRetry:T?.onRetry??ae.onRetry};R&&i({type:"step_start",workflowId:s,stepId:v,stepKey:d,name:c,description:y,ts:Date.now(),...t&&{metadata:t}});let re;for(let O=1;O<=A.attempts;O++){let Le=U?performance.now():0;try{let g;if(x?g=await ir(b,x,{name:c,key:d,attempt:O},j):g=await b(),g.ok){let Q=performance.now()-h;return i({type:"step_success",workflowId:s,stepId:v,stepKey:d,name:c,description:y,ts:Date.now(),durationMs:Q,...t&&{metadata:t}}),w&&i({type:"step_complete",workflowId:s,stepKey:w,name:c,description:y,ts:Date.now(),durationMs:Q,result:g,...t&&{metadata:t}}),g.value}if(re=g,O<A.attempts&&A.shouldRetry(g.error,O)){let Q=ke(O,A);i({type:"step_retry",workflowId:s,stepId:v,stepKey:d,name:c,ts:Date.now(),attempt:O+1,maxAttempts:A.attempts,delayMs:Q,error:g.error,...t&&{metadata:t},diagnostics:q(g.error,o.errorMeta,"result",O,performance.now()-h)}),A.onRetry(g.error,O,Q),await Te(Q);continue}A.attempts>1&&i({type:"step_retries_exhausted",workflowId:s,stepId:v,stepKey:d,name:c,ts:Date.now(),durationMs:performance.now()-h,attempts:O,lastError:g.error,...t&&{metadata:t},diagnostics:q(g.error,o.errorMeta,"result",O,performance.now()-h)});break}catch(g){let Q=performance.now()-Le;if(ar(g)){let G=g.ms;i({type:"step_timeout",workflowId:s,stepId:v,stepKey:d,name:c,ts:Date.now(),timeoutMs:G,attempt:O,...t&&{metadata:t},diagnostics:q(g,o.errorMeta,"timeout",O)}),i({type:"step_success",workflowId:s,stepId:v,stepKey:d,name:c,description:y,ts:Date.now(),durationMs:performance.now()-h,...t&&{metadata:t}}),w&&i({type:"step_complete",workflowId:s,stepKey:w,name:c,description:y,ts:Date.now(),durationMs:performance.now()-h,result:J(void 0),...t&&{metadata:t}});return}if(D(g))throw i({type:"step_aborted",workflowId:s,stepId:v,stepKey:d,name:c,description:y,ts:Date.now(),durationMs:Q,...t&&{metadata:t}}),g;if(De(g)){let G=tr(g),Ve=x?.ms??G?.timeoutMs??0;if(i({type:"step_timeout",workflowId:s,stepId:v,stepKey:d,name:c,ts:Date.now(),timeoutMs:Ve,attempt:O,...t&&{metadata:t},diagnostics:q(g,o.errorMeta,"timeout",O)}),O<A.attempts&&A.shouldRetry(g,O)){let we=ke(O,A);i({type:"step_retry",workflowId:s,stepId:v,stepKey:d,name:c,ts:Date.now(),attempt:O+1,maxAttempts:A.attempts,delayMs:we,error:g,...t&&{metadata:t},diagnostics:q(g,o.errorMeta,"timeout",O,performance.now()-h)}),A.onRetry(g,O,we),await Te(we);continue}A.attempts>1&&i({type:"step_retries_exhausted",workflowId:s,stepId:v,stepKey:d,name:c,ts:Date.now(),durationMs:performance.now()-h,attempts:O,lastError:g,...t&&{metadata:t},diagnostics:q(g,o.errorMeta,"timeout",O,performance.now()-h)});let fe=performance.now()-h;throw i({type:"step_error",workflowId:s,stepId:v,stepKey:d,name:c,description:y,ts:Date.now(),durationMs:fe,error:g,...t&&{metadata:t},diagnostics:q(g,o.errorMeta,"timeout",O,fe)}),w&&i({type:"step_complete",workflowId:s,stepKey:w,name:c,description:y,ts:Date.now(),durationMs:fe,result:L(g,{cause:g}),meta:{origin:"throw",thrown:g},...t&&{metadata:t}}),m?.(g,c,S),k(g,{origin:"throw",thrown:g})}if(O<A.attempts&&A.shouldRetry(g,O)){let G=ke(O,A);i({type:"step_retry",workflowId:s,stepId:v,stepKey:d,name:c,ts:Date.now(),attempt:O+1,maxAttempts:A.attempts,delayMs:G,error:g,...t&&{metadata:t},diagnostics:q(g,o.errorMeta,"throw",O,performance.now()-h)}),A.onRetry(g,O,G),await Te(G);continue}A.attempts>1&&!De(g)&&i({type:"step_retries_exhausted",workflowId:s,stepId:v,stepKey:d,name:c,ts:Date.now(),durationMs:performance.now()-h,attempts:O,lastError:g,...t&&{metadata:t},diagnostics:q(g,o.errorMeta,"throw",O,performance.now()-h)});let me=performance.now()-h,ue;try{ue=W(g)}catch(G){throw se(G)}throw i({type:"step_error",workflowId:s,stepId:v,stepKey:d,name:c,description:y,ts:Date.now(),durationMs:me,error:ue,...t&&{metadata:t},diagnostics:q(g,o.errorMeta,"throw",O,me)}),w&&i({type:"step_complete",workflowId:s,stepKey:w,name:c,description:y,ts:Date.now(),durationMs:me,result:L(ue,{cause:g}),meta:{origin:"throw",thrown:g},...t&&{metadata:t}}),m?.(ue,c,S),k(ue,{origin:"throw",thrown:g})}}let Z=re,Ee=performance.now()-h,de=V(Z.error,{origin:"result",resultCause:Z.cause});throw i({type:"step_error",workflowId:s,stepId:v,stepKey:d,name:c,description:y,ts:Date.now(),durationMs:Ee,error:de,...t&&{metadata:t},diagnostics:q(Z.error,o.errorMeta,"result",A.attempts,Ee)}),w&&i({type:"step_complete",workflowId:s,stepKey:w,name:c,description:y,ts:Date.now(),durationMs:Ee,result:Z,meta:{origin:"result",resultCause:Z.cause},...t&&{metadata:t}}),m?.(de,c,S),k(de,{origin:"result",resultCause:Z.cause})})();E.try=(u,f,n)=>{if(typeof u!="string"||u.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 E.retry(u,async()=>{try{return J(await f())}catch(y){return L(o(y),{cause:y})}},{attempts:n.retry?.attempts??1,...n.retry??{},key:n.key,timeout:n.timeout});let t=n.key??u,c=u,d=u,w=R;return(async()=>{let y=w?performance.now():0;R&&i({type:"step_start",workflowId:s,stepId:d,stepKey:t,name:c,ts:Date.now()});try{let T=await f(),x=performance.now()-y;return i({type:"step_success",workflowId:s,stepId:d,stepKey:t,name:c,ts:Date.now(),durationMs:x}),t&&i({type:"step_complete",workflowId:s,stepKey:t,name:c,ts:Date.now(),durationMs:x,result:J(T)}),T}catch(T){let x=o(T),v=performance.now()-y,U=V(x,{origin:"throw",thrown:T});throw i({type:"step_error",workflowId:s,stepId:d,stepKey:t,name:c,ts:Date.now(),durationMs:v,error:U}),t&&i({type:"step_complete",workflowId:s,stepKey:t,name:c,ts:Date.now(),durationMs:v,result:L(x,{cause:T}),meta:{origin:"throw",thrown:T}}),m?.(U,c,S),k(U,{origin:"throw",thrown:T})}})()},E.fromResult=(u,f,n)=>{if(typeof u!="string"||u.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??u,t=u,c=u,d="error"in n?()=>n.error:n.onError,w=R;return(async()=>{let y=w?performance.now():0;R&&i({type:"step_start",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now()});let T=await f();if(T.ok){let x=performance.now()-y;return i({type:"step_success",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:x}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:x,result:J(T.value)}),T.value}else{let x=d(T.error),v=performance.now()-y,U=V(x,{origin:"result",resultCause:T.error});throw i({type:"step_error",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:v,error:U}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:v,result:L(x,{cause:T.error}),meta:{origin:"result",resultCause:T.error}}),m?.(U,t,S),k(U,{origin:"result",resultCause:T.error})}})()},E.fromNullable=(u,f,n,o)=>{if(typeof u!="string"||u.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 E(u,async()=>{let t=await f();return t!=null?J(t):L(n())},o)},E.retry=(u,f,n)=>{if(typeof u!="string"||u.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 E(u,f,{key:n.key??u,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})},E.withTimeout=(u,f,n)=>{if(typeof u!="string"||u.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 E(u,f,{key:n.key??u,timeout:n})},E.sleep=(u,f,n)=>{if(typeof u!="string"||u.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 f=="string"?Ze(f):f;if(!o)throw new Error(`step.sleep: invalid duration '${f}'`);let t=o.millis,c=n?.signal;return E(u,async()=>{if(j?.aborted||c?.aborted){let d=new Error("Sleep aborted");throw d.name="AbortError",d}return new Promise((d,w)=>{let y={timeoutId:void 0},T=()=>{y.timeoutId&&clearTimeout(y.timeoutId);let x=new Error("Sleep aborted");x.name="AbortError",w(x)};j?.addEventListener("abort",T,{once:!0}),c?.addEventListener("abort",T,{once:!0}),y.timeoutId=setTimeout(()=>{j?.removeEventListener("abort",T),c?.removeEventListener("abort",T),d(J(void 0))},t)})},{key:n?.key??u,description:n?.description})},E.all=((...u)=>{if(typeof u[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 f=u[0],n=u[1];if(typeof n=="function")return N(f,n);if(n&&typeof n=="object"&&!Array.isArray(n)){let t=K(n);return F(t,{name:f})}throw new TypeError("step.all(name, ...): second argument must be a function (array form) or an object of operations (object form).")}),E.race=(u,f)=>{let n=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let o=performance.now(),t=!1,c={scopeId:n,type:"race",winnerId:void 0};B.push(c);let d=()=>{if(t)return;t=!0;let w=B.findIndex(y=>y.scopeId===n);w!==-1&&B.splice(w,1),i({type:"scope_end",workflowId:s,scopeId:n,ts:Date.now(),durationMs:performance.now()-o,winnerId:c.winnerId})};i({type:"scope_start",workflowId:s,scopeId:n,scopeType:"race",name:u,ts:Date.now()});try{let w=await f();if(d(),!w.ok)throw m?.(w.error,u,S),k(w.error,{origin:"result",resultCause:w.cause});return w.value}catch(w){throw d(),w}})()},E.if=(u,f,n)=>n(),E.label=E.if,E.branch=async(u,f)=>{let{condition:n,then:o,else:t}=f;if(n())return await o();if(t)return await t()},E.arm=(u,f)=>({fn:u,errors:f}),E.forEach=async(u,f,n)=>{let o=[],t=n.maxIterations,c=0,d="run"in n,w=Symbol.asyncIterator in f?f:(async function*(){yield*f})();for await(let y of w){if(t!==void 0&&c>=t)break;let T;d?T=await n.run(y,c):T=await n.item.handler(y,c,E),o.push(T),c++}return o},E.item=u=>({__forEachItemHandler:!0,handler:u}),E.dep=(u,f)=>f,E.workflow=(u,f,n)=>E(u,f,n),E.map=async(u,f,n,o)=>{let t=o?.concurrency??f.length;return E(u,()=>t>=f.length?Ke(f.map((c,d)=>n(c,d))):(async()=>{let c=[];for(let d=0;d<f.length;d+=t){let w=f.slice(d,d+t),y=await Ke(w.map((T,x)=>n(T,d+x)));if(!y.ok)return y;c.push(...y.value)}return J(c)})(),{key:o?.key})},E.withFallback=(u,f,n)=>{if(typeof u!="string"||u.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??u,t=u,c=$(o),d=R;return(async()=>{let w=d?performance.now():0;R&&i({type:"step_start",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now()});let y;try{y=await f()}catch(h){if(D(h))throw i({type:"step_aborted",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:performance.now()-w}),h;let I;try{I=W(h)}catch(P){throw se(P)}if(n.on!==void 0&&n.on!==I){let P=performance.now()-w;throw i({type:"step_error",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:P,error:I}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:P,result:L(I,{cause:h}),meta:{origin:"throw",thrown:h}}),m?.(I,t,S),k(I,{origin:"throw",thrown:h})}let b;try{b=await n.fallback()}catch(P){if(D(P))throw i({type:"step_aborted",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:performance.now()-w}),P;let A;try{A=W(P)}catch(Z){throw se(Z)}let re=performance.now()-w;throw i({type:"step_error",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:re,error:A}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:re,result:L(A,{cause:P}),meta:{origin:"throw",thrown:P}}),m?.(A,t,S),k(A,{origin:"throw",thrown:P})}if(b.ok){let P=performance.now()-w;return i({type:"step_success",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:P}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:P,result:b,meta:{origin:"fallback",fallbackUsed:!0,fallbackReason:String(I)}}),b.value}else{let P=performance.now()-w,A=V(b.error,{origin:"result",resultCause:b.cause});throw i({type:"step_error",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:P,error:A}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:P,result:b,meta:{origin:"result",resultCause:b.cause}}),m?.(A,t,S),k(A,{origin:"result",resultCause:b.cause})}}if(y.ok){let h=performance.now()-w;return i({type:"step_success",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:h}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:h,result:y}),y.value}let T=y.error;if(n.on!==void 0&&n.on!==T){let h=performance.now()-w,I=V(T,{origin:"result",resultCause:y.cause});throw i({type:"step_error",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:h,error:I}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:h,result:y,meta:{origin:"result",resultCause:y.cause}}),m?.(I,t,S),k(I,{origin:"result",resultCause:y.cause})}let x;try{x=await n.fallback()}catch(h){if(D(h))throw i({type:"step_aborted",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:performance.now()-w}),h;let I;try{I=W(h)}catch(P){throw se(P)}let b=performance.now()-w;throw i({type:"step_error",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:b,error:I}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:b,result:L(I,{cause:h}),meta:{origin:"throw",thrown:h}}),m?.(I,t,S),k(I,{origin:"throw",thrown:h})}if(x.ok){let h=performance.now()-w;return i({type:"step_success",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:h}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:h,result:x,meta:{origin:"fallback",fallbackUsed:!0,fallbackReason:String(T)}}),x.value}let v=performance.now()-w,U=V(x.error,{origin:"result",resultCause:x.cause});throw i({type:"step_error",workflowId:s,stepId:c,stepKey:o,name:t,ts:Date.now(),durationMs:v,error:U}),o&&i({type:"step_complete",workflowId:s,stepKey:o,name:t,ts:Date.now(),durationMs:v,result:x,meta:{origin:"result",resultCause:x.cause}}),m?.(U,t,S),k(U,{origin:"result",resultCause:x.cause})})()},E.withResource=(u,f)=>{if(typeof u!="string"||u.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=u,o=u,t=$(n),c=R;return(async()=>{let d=c?performance.now():0;R&&i({type:"step_start",workflowId:s,stepId:t,stepKey:n,name:o,ts:Date.now()});let w;try{w=await f.acquire()}catch(b){if(D(b))throw i({type:"step_aborted",workflowId:s,stepId:t,stepKey:n,name:o,ts:Date.now(),durationMs:performance.now()-d}),b;let P;try{P=W(b)}catch(re){throw se(re)}let A=performance.now()-d;throw i({type:"step_error",workflowId:s,stepId:t,stepKey:n,name:o,ts:Date.now(),durationMs:A,error:P}),n&&i({type:"step_complete",workflowId:s,stepKey:n,name:o,ts:Date.now(),durationMs:A,result:L(P,{cause:b}),meta:{origin:"throw",thrown:b}}),m?.(P,o,S),k(P,{origin:"throw",thrown:b})}if(!w.ok){let b=performance.now()-d,P=V(w.error,{origin:"result",resultCause:w.cause});throw i({type:"step_error",workflowId:s,stepId:t,stepKey:n,name:o,ts:Date.now(),durationMs:b,error:P}),n&&i({type:"step_complete",workflowId:s,stepKey:n,name:o,ts:Date.now(),durationMs:b,result:w,meta:{origin:"result",resultCause:w.cause}}),m?.(P,o,S),k(P,{origin:"result",resultCause:w.cause})}let y=w.value,T,x,v=!1;try{T=await f.use(y)}catch(b){if(D(b)){try{await f.release(y)}catch(P){console.warn(`[awaitly] step.withResource("${u}"): release threw after earlyExit:`,P)}throw b}x=b,v=!0}try{await f.release(y)}catch(b){console.warn(`[awaitly] step.withResource("${u}"): release threw:`,b)}if(v){let b;try{b=W(x)}catch(A){throw se(A)}let P=performance.now()-d;throw i({type:"step_error",workflowId:s,stepId:t,stepKey:n,name:o,ts:Date.now(),durationMs:P,error:b}),n&&i({type:"step_complete",workflowId:s,stepKey:n,name:o,ts:Date.now(),durationMs:P,result:L(b,{cause:x}),meta:{origin:"throw",thrown:x}}),m?.(b,o,S),k(b,{origin:"throw",thrown:x})}let U=T;if(U.ok){let b=performance.now()-d;return i({type:"step_success",workflowId:s,stepId:t,stepKey:n,name:o,ts:Date.now(),durationMs:b}),n&&i({type:"step_complete",workflowId:s,stepKey:n,name:o,ts:Date.now(),durationMs:b,result:U}),U.value}let h=performance.now()-d,I=V(U.error,{origin:"result",resultCause:U.cause});throw i({type:"step_error",workflowId:s,stepId:t,stepKey:n,name:o,ts:Date.now(),durationMs:h,error:I}),n&&i({type:"step_complete",workflowId:s,stepKey:n,name:o,ts:Date.now(),durationMs:h,result:U,meta:{origin:"result",resultCause:U.cause}}),m?.(I,o,S),k(I,{origin:"result",resultCause:U.cause})})()};let z=await a({step:E});if(process.env.NODE_ENV!=="production"&&z!==null&&typeof z=="object"&&"ok"in z&&typeof z.ok=="boolean"){let u=z;(u.ok===!0&&"value"in u||u.ok===!1&&"error"in u)&&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 J(z)}catch(E){if(sr(E))throw E.thrown;if(D(E)){let N=E.meta.origin==="throw"?E.meta.thrown:E.meta.origin==="result"?E.meta.resultCause:void 0;return L(E.error,{cause:N})}let K=W(E);return m?.(K,"unexpected",S),L(K,{cause:E})}}ge.strict=(r,e)=>ge(r,e);async function Ke(r){return r.length===0?J([]):new Promise(e=>{let l=!1,a=r.length,C=new Array(r.length);for(let m=0;m<r.length;m++){let R=m;Promise.resolve(r[R]).catch(p=>L({type:"PROMISE_REJECTED",cause:p},{cause:{type:"PROMISE_REJECTION",reason:p}})).then(p=>{if(!l){if(!p.ok){l=!0,e(p);return}C[R]=p.value,a--,a===0&&e(J(C))}})}})}function Fe(){return{terminalSeen:!1,steps:new Map,stepKeyToId:new Map,counters:{errors:0,retries:0,cacheHits:0,timeouts:0},integrityWarnings:[]}}function ur(r,e){let l=r.steps.get(e);return l||(l={events:[],terminalSeen:!1},r.steps.set(e,l)),l}function cr(r,e){if("stepId"in r&&typeof r.stepId=="string")return r.stepId;if("stepKey"in r&&typeof r.stepKey=="string"){let l=e.stepKeyToId.get(r.stepKey);return l?e.steps.get(l)?.terminalSeen?(e.stepKeyToId.delete(r.stepKey),r.stepKey):l:r.stepKey}}var lr=new Set(["step_success","step_error","step_cache_hit","step_skipped","step_aborted"]);function We(r,e,l){let C={tag:l?.tag??Re(r)};return l?.classification&&(C.classification=l.classification),l?.origin&&(C.origin=l.origin),e&&r instanceof Error&&r.stack&&(C.stack=r.stack.split(`
-`).map(m=>m.trim())),C}function Be(r){let e=r?.includeStacks??!1,l=r?.redact,a=Fe();function C(p){switch(p.type){case"workflow_start":a.workflowId=p.workflowId,a.workflowName=p.workflowName,a.startedAt=p.ts;break;case"workflow_success":a.terminalSeen&&a.integrityWarnings.push("Duplicate workflow terminal event: workflow_success"),a.status="success",a.endedAt=p.ts,a.terminalSeen=!0;break;case"workflow_error":a.terminalSeen&&a.integrityWarnings.push("Duplicate workflow terminal event: workflow_error"),a.status="error",a.endedAt=p.ts,a.workflowError=p.error,a.terminalSeen=!0;break;case"workflow_cancelled":a.terminalSeen&&a.integrityWarnings.push("Duplicate workflow terminal event: workflow_cancelled"),a.status="cancelled",a.endedAt=p.ts,a.terminalSeen=!0;break;default:{let M=cr(p,a);if(!M)break;let _=ur(a,M);switch(_.events.push(p),p.type){case"step_start":if(_.metadata=p.metadata,_.startTs=p.ts,_.name=p.name,_.key=p.stepKey,p.stepKey&&p.stepId!==p.stepKey){a.stepKeyToId.set(p.stepKey,M);let S=a.steps.get(p.stepKey);S&&S!==_&&S.startTs===void 0&&(_.events.unshift(...S.events),S.terminalSeen&&(_.terminalSeen=!0),a.steps.delete(p.stepKey))}break;case"step_success":case"step_error":case"step_cache_hit":case"step_skipped":case"step_aborted":_.terminalSeen&&a.integrityWarnings.push(`Duplicate step terminal event for step "${M}": ${p.type}`),_.terminalSeen=!0,p.type==="step_error"&&a.counters.errors++,p.type==="step_cache_hit"&&a.counters.cacheHits++,!_.name&&"name"in p&&p.name&&(_.name=p.name),!_.key&&"stepKey"in p&&p.stepKey&&(_.key=p.stepKey),!_.metadata&&"metadata"in p&&p.metadata&&(_.metadata=p.metadata);break;case"step_retry":a.counters.retries++;break;case"step_timeout":a.counters.timeouts++;break}break}}}function m(){let p=[...a.integrityWarnings];a.terminalSeen||p.push("wideEvent() called before workflow terminal event");let M=a.startedAt??0,_=a.endedAt??0,S=[],j=new Map,s=new Map,W=new Map;for(let[i,k]of a.steps){k.events.some(N=>N.type==="step_start")||p.push(`No step_start seen for step "${i}"`);let D="error",V,Y,ne,oe=[...k.events].reverse().find(N=>lr.has(N.type));if(oe){switch(oe.type){case"step_success":D="success";break;case"step_error":D="error";break;case"step_cache_hit":D="cached";break;case"step_skipped":D="skipped";break;case"step_aborted":D="aborted";break}"durationMs"in oe&&typeof oe.durationMs=="number"&&(V=oe.durationMs)}else k.events.some(F=>F.type==="step_timeout")&&(D="error",ne=!0);let X=[...k.events].reverse().find(N=>N.type==="step_error"||N.type==="step_retries_exhausted");if(X){let N="error"in X?X.error:"lastError"in X?X.lastError:void 0,F="diagnostics"in X?X.diagnostics:void 0;if(Y=We(N,e,F),Y?.tag&&W.set(Y.tag,(W.get(Y.tag)??0)+1),Y?.classification?.severity){let ee=Y.classification.severity;s.set(ee,(s.get(ee)??0)+1)}}ne===void 0&&k.events.some(F=>F.type==="step_timeout")&&(ne=!0);let E=k.events.filter(N=>N.type==="step_retry").length;if(k.metadata?.domain&&(D==="success"||D==="error")){let N=k.metadata.domain,F=j.get(N);F||(F={total:0,errors:0,totalDuration:0,counted:0},j.set(N,F)),F.total++,D==="error"&&F.errors++,V!==void 0&&(F.totalDuration+=V,F.counted++)}let K={stepId:i,name:k.name??i,status:D};k.key&&(K.key=k.key),V!==void 0&&(K.durationMs=V),k.metadata?.domain&&(K.domain=k.metadata.domain),k.metadata?.owner&&(K.owner=k.metadata.owner),k.metadata?.intent&&(K.intent=k.metadata.intent),k.metadata?.tags?.length&&(K.tags=k.metadata.tags),k.metadata?.calls?.length&&(K.calls=k.metadata.calls),Y&&(K.error=Y),E>0&&(K.retryCount=E),ne&&(K.timedOut=ne),S.push(K)}let B={totalSteps:S.length,errors:a.counters.errors,retries:a.counters.retries,cacheHits:a.counters.cacheHits,timeouts:a.counters.timeouts};if(j.size>0){let i={};for(let[k,D]of j)i[k]={total:D.total,errors:D.errors,avgDurationMs:D.counted>0?D.totalDuration/D.counted:0};B.byDomain=i}if(s.size>0){let i={};for(let[k,D]of s)i[k]=D;B.bySeverity=i}W.size>0&&(B.topFailingTags=[...W.entries()].map(([i,k])=>({tag:i,count:k})).sort((i,k)=>k.count-i.count));let te;a.status==="error"&&a.workflowError!==void 0&&(te=We(a.workflowError,e));let $={workflowId:a.workflowId??"unknown",startedAt:new Date(M).toISOString(),endedAt:new Date(_).toISOString(),durationMs:_-M,status:a.status??"error",steps:S,summary:B};return a.workflowName&&($.workflowName=a.workflowName),te&&($.error=te),p.length>0&&($.integrityWarnings=p),l&&($=l($)),$}function R(){a=Fe()}return{handleEvent:C,wideEvent:m,reset:R}}0&&(module.exports={createDiagnosticsCollector});
-//# sourceMappingURL=diagnostics.cjs.map