awaitly 1.34.0 → 2.0.0

package/dist/di-COl5oFnR.d.cts

@@ -1,15 +0,0 @@
-import { UnexpectedError } from './errors.cjs';
-import { a as Workflow } from './persistence-entry-ymCA4iDu.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/di-CyDj_JyZ.d.ts

@@ -1,15 +0,0 @@
-import { UnexpectedError } from './errors.js';
-import { a as Workflow } from './persistence-entry-DOMx3woy.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/diagnostics.cjs

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