awaitly 1.0.0

package/dist/testing.d.cts

@@ -0,0 +1,228 @@
+import { R as Result, A as AsyncResult, S as StepOptions, W as WorkflowEvent } from './core-BuTBsR0x.cjs';
+import { A as AnyResultFn, E as ErrorsOfDeps } from './workflow-entry-RRTlSg_4.cjs';
+
+/**
+ * awaitly/testing
+ *
+ * Deterministic Workflow Testing Harness.
+ * Provides tools for scripting step outcomes and asserting workflow behavior.
+ */
+
+/**
+ * A scripted outcome for a step.
+ */
+type ScriptedOutcome<T = unknown, E = unknown> = {
+    type: "ok";
+    value: T;
+} | {
+    type: "err";
+    error: E;
+} | {
+    type: "throw";
+    error: unknown;
+};
+/**
+ * Step invocation record.
+ */
+interface StepInvocation {
+    /** Step name */
+    name?: string;
+    /** Step key */
+    key?: string;
+    /** Invocation order (0-indexed) */
+    order: number;
+    /** Timestamp when step was invoked */
+    timestamp: number;
+    /** Duration in milliseconds */
+    durationMs?: number;
+    /** Result of the step */
+    result?: Result<unknown, unknown>;
+    /** Whether the step was from cache */
+    cached?: boolean;
+}
+/**
+ * Assertion result.
+ */
+interface AssertionResult {
+    passed: boolean;
+    message: string;
+    expected?: unknown;
+    actual?: unknown;
+}
+/**
+ * Test harness options.
+ */
+interface TestHarnessOptions {
+    /** Whether to record step invocations */
+    recordInvocations?: boolean;
+    /** Custom clock for deterministic timing */
+    clock?: () => number;
+}
+/**
+ * Mock step function that returns scripted outcomes.
+ */
+type MockStep<E> = {
+    /** Execute with a Result-returning operation */
+    <T, StepE extends E>(operation: () => Result<T, StepE> | AsyncResult<T, StepE>, options?: StepOptions | string): Promise<T>;
+    /** Execute with a direct Result */
+    <T, StepE extends E>(result: Result<T, StepE> | AsyncResult<T, StepE>, options?: StepOptions | string): Promise<T>;
+    /** step.try for catching throws */
+    try: <T, Err extends E>(operation: () => T | Promise<T>, options: {
+        error: Err;
+        name?: string;
+        key?: string;
+    } | {
+        onError: (cause: unknown) => Err;
+        name?: string;
+        key?: string;
+    }) => Promise<T>;
+};
+/**
+ * Workflow test harness interface.
+ */
+interface WorkflowHarness<E, Deps> {
+    /**
+     * Script step outcomes in order.
+     * Each outcome will be returned for the corresponding step invocation.
+     */
+    script(outcomes: ScriptedOutcome[]): void;
+    /**
+     * Script a specific step outcome by name or key.
+     */
+    scriptStep(nameOrKey: string, outcome: ScriptedOutcome): void;
+    /**
+     * Run the workflow with scripted outcomes.
+     */
+    run<T>(fn: (step: MockStep<E>, deps: Deps) => Promise<T>): Promise<Result<T, E | unknown>>;
+    /**
+     * Run the workflow with input.
+     */
+    runWithInput<T, TInput>(input: TInput, fn: (step: MockStep<E>, deps: Deps, input: TInput) => Promise<T>): Promise<Result<T, E | unknown>>;
+    /**
+     * Get recorded step invocations.
+     */
+    getInvocations(): StepInvocation[];
+    /**
+     * Assert that steps were invoked in order.
+     */
+    assertSteps(expectedNames: string[]): AssertionResult;
+    /**
+     * Assert that a step was invoked with specific options.
+     */
+    assertStepCalled(nameOrKey: string): AssertionResult;
+    /**
+     * Assert that a step was NOT invoked.
+     */
+    assertStepNotCalled(nameOrKey: string): AssertionResult;
+    /**
+     * Assert the workflow result.
+     */
+    assertResult<T>(result: Result<T, unknown>, expected: Result<T, unknown>): AssertionResult;
+    /**
+     * Clear all state for a new test.
+     */
+    reset(): void;
+}
+/**
+ * Create a test harness for a workflow.
+ *
+ * @example
+ * ```typescript
+ * const harness = createWorkflowHarness({ fetchUser, chargeCard });
+ *
+ * // Script step outcomes
+ * harness.script([
+ *   { type: 'ok', value: { id: '1', name: 'Alice' } },
+ *   { type: 'ok', value: { transactionId: 'tx_123' } },
+ * ]);
+ *
+ * // Run the workflow
+ * const result = await harness.run(async (step, { fetchUser, chargeCard }) => {
+ *   const user = await step(() => fetchUser('1'), 'fetch-user');
+ *   const charge = await step(() => chargeCard(100), 'charge-card');
+ *   return { user, charge };
+ * });
+ *
+ * // Assert
+ * expect(result.ok).toBe(true);
+ * harness.assertSteps(['fetch-user', 'charge-card']);
+ * ```
+ */
+declare function createWorkflowHarness<Deps extends Record<string, AnyResultFn>>(deps: Deps, options?: TestHarnessOptions): WorkflowHarness<ErrorsOfDeps<Deps>, Deps>;
+/**
+ * Create a mock Result-returning function.
+ *
+ * @example
+ * ```typescript
+ * const fetchUser = createMockFn<User, 'NOT_FOUND'>();
+ *
+ * fetchUser.returns(ok({ id: '1', name: 'Alice' }));
+ * // or
+ * fetchUser.returnsOnce(ok({ id: '1', name: 'Alice' }));
+ * fetchUser.returnsOnce(err('NOT_FOUND'));
+ * ```
+ */
+declare function createMockFn<T, E>(): MockFunction<T, E>;
+/**
+ * Mock function interface.
+ */
+interface MockFunction<T, E> {
+    (...args: unknown[]): AsyncResult<T, E>;
+    /** Set the default return value */
+    returns(result: Result<T, E>): MockFunction<T, E>;
+    /** Queue a return value for the next call */
+    returnsOnce(result: Result<T, E>): MockFunction<T, E>;
+    /** Get all call arguments */
+    getCalls(): unknown[][];
+    /** Get the number of times the function was called */
+    getCallCount(): number;
+    /** Reset the mock */
+    reset(): void;
+}
+/**
+ * Workflow snapshot for comparison.
+ */
+interface WorkflowSnapshot {
+    /** Step invocations */
+    invocations: StepInvocation[];
+    /** Final result */
+    result: Result<unknown, unknown>;
+    /** Events emitted */
+    events?: WorkflowEvent<unknown>[];
+    /** Total duration */
+    durationMs?: number;
+}
+/**
+ * Create a snapshot of a workflow execution.
+ */
+declare function createSnapshot(invocations: StepInvocation[], result: Result<unknown, unknown>, events?: WorkflowEvent<unknown>[]): WorkflowSnapshot;
+/**
+ * Compare two workflow snapshots.
+ */
+declare function compareSnapshots(snapshot1: WorkflowSnapshot, snapshot2: WorkflowSnapshot): {
+    equal: boolean;
+    differences: string[];
+};
+/**
+ * Create a deterministic clock for testing.
+ */
+declare function createTestClock(startTime?: number): {
+    now: () => number;
+    advance: (ms: number) => void;
+    set: (time: number) => void;
+    reset: () => void;
+};
+/**
+ * Helper to create ok outcomes.
+ */
+declare function okOutcome<T>(value: T): ScriptedOutcome<T, never>;
+/**
+ * Helper to create err outcomes.
+ */
+declare function errOutcome<E>(error: E): ScriptedOutcome<never, E>;
+/**
+ * Helper to create throw outcomes.
+ */
+declare function throwOutcome(error: unknown): ScriptedOutcome<never, never>;
+
+export { type AssertionResult, type MockFunction, type MockStep, type ScriptedOutcome, type StepInvocation, type TestHarnessOptions, type WorkflowHarness, type WorkflowSnapshot, compareSnapshots, createMockFn, createSnapshot, createTestClock, createWorkflowHarness, errOutcome, okOutcome, throwOutcome };

package/dist/testing.d.ts

@@ -0,0 +1,228 @@
+import { R as Result, A as AsyncResult, S as StepOptions, W as WorkflowEvent } from './core-BuTBsR0x.js';
+import { A as AnyResultFn, E as ErrorsOfDeps } from './workflow-entry-C6nH8ByN.js';
+
+/**
+ * awaitly/testing
+ *
+ * Deterministic Workflow Testing Harness.
+ * Provides tools for scripting step outcomes and asserting workflow behavior.
+ */
+
+/**
+ * A scripted outcome for a step.
+ */
+type ScriptedOutcome<T = unknown, E = unknown> = {
+    type: "ok";
+    value: T;
+} | {
+    type: "err";
+    error: E;
+} | {
+    type: "throw";
+    error: unknown;
+};
+/**
+ * Step invocation record.
+ */
+interface StepInvocation {
+    /** Step name */
+    name?: string;
+    /** Step key */
+    key?: string;
+    /** Invocation order (0-indexed) */
+    order: number;
+    /** Timestamp when step was invoked */
+    timestamp: number;
+    /** Duration in milliseconds */
+    durationMs?: number;
+    /** Result of the step */
+    result?: Result<unknown, unknown>;
+    /** Whether the step was from cache */
+    cached?: boolean;
+}
+/**
+ * Assertion result.
+ */
+interface AssertionResult {
+    passed: boolean;
+    message: string;
+    expected?: unknown;
+    actual?: unknown;
+}
+/**
+ * Test harness options.
+ */
+interface TestHarnessOptions {
+    /** Whether to record step invocations */
+    recordInvocations?: boolean;
+    /** Custom clock for deterministic timing */
+    clock?: () => number;
+}
+/**
+ * Mock step function that returns scripted outcomes.
+ */
+type MockStep<E> = {
+    /** Execute with a Result-returning operation */
+    <T, StepE extends E>(operation: () => Result<T, StepE> | AsyncResult<T, StepE>, options?: StepOptions | string): Promise<T>;
+    /** Execute with a direct Result */
+    <T, StepE extends E>(result: Result<T, StepE> | AsyncResult<T, StepE>, options?: StepOptions | string): Promise<T>;
+    /** step.try for catching throws */
+    try: <T, Err extends E>(operation: () => T | Promise<T>, options: {
+        error: Err;
+        name?: string;
+        key?: string;
+    } | {
+        onError: (cause: unknown) => Err;
+        name?: string;
+        key?: string;
+    }) => Promise<T>;
+};
+/**
+ * Workflow test harness interface.
+ */
+interface WorkflowHarness<E, Deps> {
+    /**
+     * Script step outcomes in order.
+     * Each outcome will be returned for the corresponding step invocation.
+     */
+    script(outcomes: ScriptedOutcome[]): void;
+    /**
+     * Script a specific step outcome by name or key.
+     */
+    scriptStep(nameOrKey: string, outcome: ScriptedOutcome): void;
+    /**
+     * Run the workflow with scripted outcomes.
+     */
+    run<T>(fn: (step: MockStep<E>, deps: Deps) => Promise<T>): Promise<Result<T, E | unknown>>;
+    /**
+     * Run the workflow with input.
+     */
+    runWithInput<T, TInput>(input: TInput, fn: (step: MockStep<E>, deps: Deps, input: TInput) => Promise<T>): Promise<Result<T, E | unknown>>;
+    /**
+     * Get recorded step invocations.
+     */
+    getInvocations(): StepInvocation[];
+    /**
+     * Assert that steps were invoked in order.
+     */
+    assertSteps(expectedNames: string[]): AssertionResult;
+    /**
+     * Assert that a step was invoked with specific options.
+     */
+    assertStepCalled(nameOrKey: string): AssertionResult;
+    /**
+     * Assert that a step was NOT invoked.
+     */
+    assertStepNotCalled(nameOrKey: string): AssertionResult;
+    /**
+     * Assert the workflow result.
+     */
+    assertResult<T>(result: Result<T, unknown>, expected: Result<T, unknown>): AssertionResult;
+    /**
+     * Clear all state for a new test.
+     */
+    reset(): void;
+}
+/**
+ * Create a test harness for a workflow.
+ *
+ * @example
+ * ```typescript
+ * const harness = createWorkflowHarness({ fetchUser, chargeCard });
+ *
+ * // Script step outcomes
+ * harness.script([
+ *   { type: 'ok', value: { id: '1', name: 'Alice' } },
+ *   { type: 'ok', value: { transactionId: 'tx_123' } },
+ * ]);
+ *
+ * // Run the workflow
+ * const result = await harness.run(async (step, { fetchUser, chargeCard }) => {
+ *   const user = await step(() => fetchUser('1'), 'fetch-user');
+ *   const charge = await step(() => chargeCard(100), 'charge-card');
+ *   return { user, charge };
+ * });
+ *
+ * // Assert
+ * expect(result.ok).toBe(true);
+ * harness.assertSteps(['fetch-user', 'charge-card']);
+ * ```
+ */
+declare function createWorkflowHarness<Deps extends Record<string, AnyResultFn>>(deps: Deps, options?: TestHarnessOptions): WorkflowHarness<ErrorsOfDeps<Deps>, Deps>;
+/**
+ * Create a mock Result-returning function.
+ *
+ * @example
+ * ```typescript
+ * const fetchUser = createMockFn<User, 'NOT_FOUND'>();
+ *
+ * fetchUser.returns(ok({ id: '1', name: 'Alice' }));
+ * // or
+ * fetchUser.returnsOnce(ok({ id: '1', name: 'Alice' }));
+ * fetchUser.returnsOnce(err('NOT_FOUND'));
+ * ```
+ */
+declare function createMockFn<T, E>(): MockFunction<T, E>;
+/**
+ * Mock function interface.
+ */
+interface MockFunction<T, E> {
+    (...args: unknown[]): AsyncResult<T, E>;
+    /** Set the default return value */
+    returns(result: Result<T, E>): MockFunction<T, E>;
+    /** Queue a return value for the next call */
+    returnsOnce(result: Result<T, E>): MockFunction<T, E>;
+    /** Get all call arguments */
+    getCalls(): unknown[][];
+    /** Get the number of times the function was called */
+    getCallCount(): number;
+    /** Reset the mock */
+    reset(): void;
+}
+/**
+ * Workflow snapshot for comparison.
+ */
+interface WorkflowSnapshot {
+    /** Step invocations */
+    invocations: StepInvocation[];
+    /** Final result */
+    result: Result<unknown, unknown>;
+    /** Events emitted */
+    events?: WorkflowEvent<unknown>[];
+    /** Total duration */
+    durationMs?: number;
+}
+/**
+ * Create a snapshot of a workflow execution.
+ */
+declare function createSnapshot(invocations: StepInvocation[], result: Result<unknown, unknown>, events?: WorkflowEvent<unknown>[]): WorkflowSnapshot;
+/**
+ * Compare two workflow snapshots.
+ */
+declare function compareSnapshots(snapshot1: WorkflowSnapshot, snapshot2: WorkflowSnapshot): {
+    equal: boolean;
+    differences: string[];
+};
+/**
+ * Create a deterministic clock for testing.
+ */
+declare function createTestClock(startTime?: number): {
+    now: () => number;
+    advance: (ms: number) => void;
+    set: (time: number) => void;
+    reset: () => void;
+};
+/**
+ * Helper to create ok outcomes.
+ */
+declare function okOutcome<T>(value: T): ScriptedOutcome<T, never>;
+/**
+ * Helper to create err outcomes.
+ */
+declare function errOutcome<E>(error: E): ScriptedOutcome<never, E>;
+/**
+ * Helper to create throw outcomes.
+ */
+declare function throwOutcome(error: unknown): ScriptedOutcome<never, never>;
+
+export { type AssertionResult, type MockFunction, type MockStep, type ScriptedOutcome, type StepInvocation, type TestHarnessOptions, type WorkflowHarness, type WorkflowSnapshot, compareSnapshots, createMockFn, createSnapshot, createTestClock, createWorkflowHarness, errOutcome, okOutcome, throwOutcome };

package/dist/testing.js

@@ -0,0 +1,2 @@
+var D=e=>({ok:!0,value:e}),b=(e,i)=>({ok:!1,error:e,...i?.cause!==void 0?{cause:i.cause}:{}});var ae=e=>typeof e=="object"&&e!==null&&e.type==="UNEXPECTED_ERROR",W=Symbol.for("step_timeout_marker");function ee(e){return typeof e!="object"||e===null?!1:e.type==="STEP_TIMEOUT"?!0:W in e}function ie(e){if(!(typeof e!="object"||e===null)){if(e.type==="STEP_TIMEOUT"){let i=e;return{timeoutMs:i.timeoutMs,stepName:i.stepName,stepKey:i.stepKey,attempt:i.attempt}}if(W in e)return e[W]}}var re=Symbol("early-exit");function pe(e,i){return{[re]:!0,error:e,meta:i}}function ce(e){return typeof e=="object"&&e!==null&&e[re]===!0}var oe=Symbol("mapper-exception");function le(e){return{[oe]:!0,thrown:e}}function Ee(e){return typeof e=="object"&&e!==null&&e[oe]===!0}function ye(e){return typeof e=="string"?{name:e}:e??{}}function G(e,i){let{backoff:p,initialDelay:d,maxDelay:m,jitter:v}=i,l;switch(p){case"fixed":l=d;break;case"linear":l=d*e;break;case"exponential":l=d*Math.pow(2,e-1);break}if(l=Math.min(l,m),v){let u=l*.25*Math.random();l=l+u}return Math.floor(l)}function z(e){return new Promise(i=>setTimeout(i,e))}var te=Symbol("timeout");async function me(e,i,p){let d=new AbortController,m=i.error??{type:"STEP_TIMEOUT",stepName:p.name,stepKey:p.key,timeoutMs:i.ms,attempt:p.attempt},v,l=new Promise((I,S)=>{v=setTimeout(()=>{d.abort(),S({[te]:!0,error:m})},i.ms)}),u;i.signal?u=Promise.resolve(e(d.signal)):u=Promise.resolve(e());try{return await Promise.race([u,l])}catch(I){if(typeof I=="object"&&I!==null&&I[te]===!0){let S=I.error;if(typeof S=="object"&&S!==null&&S.type!=="STEP_TIMEOUT"){let F={timeoutMs:i.ms,stepName:p.name,stepKey:p.key,attempt:p.attempt};W in S?S[W]=F:Object.defineProperty(S,W,{value:F,enumerable:!1,writable:!0,configurable:!1})}throw S}throw I}finally{clearTimeout(v)}}var V={backoff:"exponential",initialDelay:100,maxDelay:3e4,jitter:!0,retryOn:()=>!0,onRetry:()=>{}};async function ne(e,i){let{onError:p,onEvent:d,catchUnexpected:m,workflowId:v,context:l}=i&&typeof i=="object"?i:{},u=v??crypto.randomUUID(),I=!p&&!m,S=[],F=0,N=a=>a??`step_${++F}`,k=a=>{let s=a.context!==void 0||l===void 0?a:{...a,context:l};if(s.type==="step_success"){let c=s.stepId;for(let E=S.length-1;E>=0;E--){let h=S[E];if(h.type==="race"&&!h.winnerId){h.winnerId=c;break}}}d?.(s,l)},U=pe,X=a=>ce(a),$=(a,s)=>I?s?.origin==="result"?{type:"UNEXPECTED_ERROR",cause:{type:"STEP_FAILURE",origin:"result",error:a,...s.resultCause!==void 0?{cause:s.resultCause}:{}}}:s?.origin==="throw"?{type:"UNEXPECTED_ERROR",cause:{type:"STEP_FAILURE",origin:"throw",error:a,thrown:s.thrown}}:{type:"UNEXPECTED_ERROR",cause:{type:"STEP_FAILURE",origin:"result",error:a}}:a,H=a=>({type:"UNEXPECTED_ERROR",cause:a.meta.origin==="result"?{type:"STEP_FAILURE",origin:"result",error:a.error,...a.meta.resultCause!==void 0?{cause:a.meta.resultCause}:{}}:{type:"STEP_FAILURE",origin:"throw",error:a.error,thrown:a.meta.thrown}});try{let s=function(y,r){let n=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let t=performance.now(),o=!1;S.push({scopeId:n,type:"parallel"});let g=()=>{if(o)return;o=!0;let T=S.findIndex(w=>w.scopeId===n);T!==-1&&S.splice(T,1),k({type:"scope_end",workflowId:u,scopeId:n,ts:Date.now(),durationMs:performance.now()-t})};k({type:"scope_start",workflowId:u,scopeId:n,scopeType:"parallel",name:y,ts:Date.now()});try{let T=await r();if(g(),!T.ok)throw p?.(T.error,y,l),U(T.error,{origin:"result",resultCause:T.cause});return T.value}catch(T){throw g(),T}})()},c=function(y,r){let n=Object.keys(y),t=r.name??`Parallel(${n.join(", ")})`,o=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let g=performance.now(),T=!1;S.push({scopeId:o,type:"parallel"});let w=()=>{if(T)return;T=!0;let R=S.findIndex(x=>x.scopeId===o);R!==-1&&S.splice(R,1),k({type:"scope_end",workflowId:u,scopeId:o,ts:Date.now(),durationMs:performance.now()-g})};k({type:"scope_start",workflowId:u,scopeId:o,scopeType:"parallel",name:t,ts:Date.now()});try{let R=await new Promise(O=>{if(n.length===0){O([]);return}let M=!1,A=n.length,L=new Array(n.length);for(let _=0;_<n.length;_++){let j=n[_],Y=_;Promise.resolve(y[j]()).catch(C=>b({type:"PROMISE_REJECTED",cause:C},{cause:{type:"PROMISE_REJECTION",reason:C}})).then(C=>{if(!M){if(!C.ok){M=!0,O([{key:j,result:C}]);return}L[Y]={key:j,result:C},A--,A===0&&O(L)}})}});w();let x={};for(let{key:O,result:M}of R){if(!M.ok)throw p?.(M.error,O,l),U(M.error,{origin:"result",resultCause:M.cause});x[O]=M.value}return x}catch(R){throw w(),R}})()};var Q=s,Z=c;let a=(y,r)=>(async()=>{let n=ye(r),{name:t,key:o,retry:g,timeout:T}=n,w=N(o),R=d,x=R?performance.now():0;if(!(typeof y=="function")){if(g&&g.attempts>1)throw new Error("step: retry options require a function operation. Direct Promise/Result values cannot be re-executed on retry. Wrap your operation in a function: step(() => yourOperation, { retry: {...} })");if(T)throw new Error("step: timeout options require a function operation. Direct Promise/Result values cannot be wrapped with timeout after they've started. Wrap your operation in a function: step(() => yourOperation, { timeout: {...} })")}let A={attempts:Math.max(1,g?.attempts??1),backoff:g?.backoff??V.backoff,initialDelay:g?.initialDelay??V.initialDelay,maxDelay:g?.maxDelay??V.maxDelay,jitter:g?.jitter??V.jitter,retryOn:g?.retryOn??V.retryOn,onRetry:g?.onRetry??V.onRetry};d&&k({type:"step_start",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now()});let L;for(let C=1;C<=A.attempts;C++){let ue=R?performance.now():0;try{let f;if(typeof y=="function"?T?f=await me(y,T,{name:t,key:o,attempt:C}):f=await y():f=await y,f.ok){let K=performance.now()-x;return k({type:"step_success",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),durationMs:K}),o&&k({type:"step_complete",workflowId:u,stepKey:o,name:t,ts:Date.now(),durationMs:K,result:f}),f.value}if(L=f,C<A.attempts&&A.retryOn(f.error,C)){let K=G(C,A);k({type:"step_retry",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),attempt:C+1,maxAttempts:A.attempts,delayMs:K,error:f.error}),A.onRetry(f.error,C,K),await z(K);continue}A.attempts>1&&k({type:"step_retries_exhausted",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),durationMs:performance.now()-x,attempts:C,lastError:f.error});break}catch(f){let K=performance.now()-ue;if(X(f))throw k({type:"step_aborted",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),durationMs:K}),f;if(ee(f)){let P=ie(f),q=T?.ms??P?.timeoutMs??0;if(k({type:"step_timeout",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),timeoutMs:q,attempt:C}),C<A.attempts&&A.retryOn(f,C)){let B=G(C,A);k({type:"step_retry",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),attempt:C+1,maxAttempts:A.attempts,delayMs:B,error:f}),A.onRetry(f,C,B),await z(B);continue}A.attempts>1&&k({type:"step_retries_exhausted",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),durationMs:performance.now()-x,attempts:C,lastError:f})}if(C<A.attempts&&A.retryOn(f,C)){let P=G(C,A);k({type:"step_retry",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),attempt:C+1,maxAttempts:A.attempts,delayMs:P,error:f}),A.onRetry(f,C,P),await z(P);continue}A.attempts>1&&!ee(f)&&k({type:"step_retries_exhausted",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),durationMs:performance.now()-x,attempts:C,lastError:f});let J=performance.now()-x;if(m){let P;try{P=m(f)}catch(q){throw le(q)}throw k({type:"step_error",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),durationMs:J,error:P}),o&&k({type:"step_complete",workflowId:u,stepKey:o,name:t,ts:Date.now(),durationMs:J,result:b(P,{cause:f}),meta:{origin:"throw",thrown:f}}),p?.(P,t,l),U(P,{origin:"throw",thrown:f})}else{let P={type:"UNEXPECTED_ERROR",cause:{type:"UNCAUGHT_EXCEPTION",thrown:f}};throw k({type:"step_error",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),durationMs:J,error:P}),o&&k({type:"step_complete",workflowId:u,stepKey:o,name:t,ts:Date.now(),durationMs:J,result:b(P,{cause:f}),meta:{origin:"throw",thrown:f}}),f}}}let _=L,j=performance.now()-x,Y=$(_.error,{origin:"result",resultCause:_.cause});throw k({type:"step_error",workflowId:u,stepId:w,stepKey:o,name:t,ts:Date.now(),durationMs:j,error:Y}),o&&k({type:"step_complete",workflowId:u,stepKey:o,name:t,ts:Date.now(),durationMs:j,result:_,meta:{origin:"result",resultCause:_.cause}}),p?.(_.error,t,l),U(_.error,{origin:"result",resultCause:_.cause})})();a.try=(y,r)=>{let n=r.name,t=r.key,o=N(t),g="error"in r?()=>r.error:r.onError,T=d;return(async()=>{let w=T?performance.now():0;d&&k({type:"step_start",workflowId:u,stepId:o,stepKey:t,name:n,ts:Date.now()});try{let R=await y(),x=performance.now()-w;return k({type:"step_success",workflowId:u,stepId:o,stepKey:t,name:n,ts:Date.now(),durationMs:x}),t&&k({type:"step_complete",workflowId:u,stepKey:t,name:n,ts:Date.now(),durationMs:x,result:D(R)}),R}catch(R){let x=g(R),O=performance.now()-w,M=$(x,{origin:"throw",thrown:R});throw k({type:"step_error",workflowId:u,stepId:o,stepKey:t,name:n,ts:Date.now(),durationMs:O,error:M}),t&&k({type:"step_complete",workflowId:u,stepKey:t,name:n,ts:Date.now(),durationMs:O,result:b(x,{cause:R}),meta:{origin:"throw",thrown:R}}),p?.(x,n,l),U(x,{origin:"throw",thrown:R})}})()},a.fromResult=(y,r)=>{let n=r.name,t=r.key,o=N(t),g="error"in r?()=>r.error:r.onError,T=d;return(async()=>{let w=T?performance.now():0;d&&k({type:"step_start",workflowId:u,stepId:o,stepKey:t,name:n,ts:Date.now()});let R=await y();if(R.ok){let x=performance.now()-w;return k({type:"step_success",workflowId:u,stepId:o,stepKey:t,name:n,ts:Date.now(),durationMs:x}),t&&k({type:"step_complete",workflowId:u,stepKey:t,name:n,ts:Date.now(),durationMs:x,result:D(R.value)}),R.value}else{let x=g(R.error),O=performance.now()-w,M=$(x,{origin:"result",resultCause:R.error});throw k({type:"step_error",workflowId:u,stepId:o,stepKey:t,name:n,ts:Date.now(),durationMs:O,error:M}),t&&k({type:"step_complete",workflowId:u,stepKey:t,name:n,ts:Date.now(),durationMs:O,result:b(x,{cause:R.error}),meta:{origin:"result",resultCause:R.error}}),p?.(x,n,l),U(x,{origin:"result",resultCause:R.error})}})()},a.retry=(y,r)=>a(y,{name:r.name,key:r.key,retry:{attempts:r.attempts,backoff:r.backoff,initialDelay:r.initialDelay,maxDelay:r.maxDelay,jitter:r.jitter,retryOn:r.retryOn,onRetry:r.onRetry},timeout:r.timeout}),a.withTimeout=(y,r)=>a(y,{name:r.name,key:r.key,timeout:r}),a.parallel=((...y)=>{if(typeof y[0]=="string"){let r=y[0],n=y[1];return s(r,n)}else{let r=y[0],n=y[1]??{};return c(r,n)}}),a.race=(y,r)=>{let n=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let t=performance.now(),o=!1,g={scopeId:n,type:"race",winnerId:void 0};S.push(g);let T=()=>{if(o)return;o=!0;let w=S.findIndex(R=>R.scopeId===n);w!==-1&&S.splice(w,1),k({type:"scope_end",workflowId:u,scopeId:n,ts:Date.now(),durationMs:performance.now()-t,winnerId:g.winnerId})};k({type:"scope_start",workflowId:u,scopeId:n,scopeType:"race",name:y,ts:Date.now()});try{let w=await r();if(T(),!w.ok)throw p?.(w.error,y,l),U(w.error,{origin:"result",resultCause:w.cause});return w.value}catch(w){throw T(),w}})()},a.allSettled=(y,r)=>{let n=`scope_${Date.now()}_${Math.random().toString(36).slice(2,8)}`;return(async()=>{let t=performance.now(),o=!1;S.push({scopeId:n,type:"allSettled"});let g=()=>{if(o)return;o=!0;let T=S.findIndex(w=>w.scopeId===n);T!==-1&&S.splice(T,1),k({type:"scope_end",workflowId:u,scopeId:n,ts:Date.now(),durationMs:performance.now()-t})};k({type:"scope_start",workflowId:u,scopeId:n,scopeType:"allSettled",name:y,ts:Date.now()});try{let T=await r();if(g(),!T.ok)throw p?.(T.error,y,l),U(T.error,{origin:"result",resultCause:T.cause});return T.value}catch(T){throw g(),T}})()};let h=await e(a);return D(h)}catch(a){if(Ee(a))throw a.thrown;if(X(a)){let c=a.meta.origin==="throw"?a.meta.thrown:a.meta.resultCause;if(m||p)return b(a.error,{cause:c});if(ae(a.error))return b(a.error,{cause:c});let E=H(a);return b(E,{cause:c})}if(m){let c=m(a);return p?.(c,"unexpected",l),b(c,{cause:a})}let s={type:"UNEXPECTED_ERROR",cause:{type:"UNCAUGHT_EXCEPTION",thrown:a}};return p?.(s,"unexpected",l),b(s,{cause:a})}}ne.strict=(e,i)=>ne(e,i);function se(e){return typeof e=="object"&&e!==null&&"__earlyExit"in e&&e.__earlyExit===!0}function ke(e,i={}){let{recordInvocations:p=!0,clock:d=Date.now}=i,m=[],v=new Map,l=0,u=[];function I(s){m=[...s],l=0,v.clear()}function S(s,c){v.set(s,c)}function F(s){if(s&&v.has(s))return v.get(s);if(l<m.length)return m[l++]}function N(){let s=async(c,E)=>{let h=typeof E=="string"?{name:E}:E??{},y=h.name??h.key,r=d(),n={name:h.name,key:h.key,order:u.length,timestamp:r};p&&u.push(n);let t=F(y);if(t)switch(n.durationMs=d()-r,t.type){case"ok":return n.result=D(t.value),t.value;case"err":throw n.result=b(t.error),{__earlyExit:!0,error:t.error};case"throw":throw t.error}let o=typeof c=="function"?await c():await c;if(n.durationMs=d()-r,n.result=o,!o.ok)throw{__earlyExit:!0,error:o.error};return o.value};return s.try=async(c,E)=>{let h=E.name??E.key,y=d(),r={name:E.name,key:E.key,order:u.length,timestamp:y};p&&u.push(r);let n=F(h);if(n)switch(r.durationMs=d()-y,n.type){case"ok":return r.result=D(n.value),n.value;case"err":throw r.result=b(n.error),{__earlyExit:!0,error:n.error};case"throw":throw n.error}try{let t=await c();return r.durationMs=d()-y,r.result=D(t),t}catch(t){r.durationMs=d()-y;let o="error"in E?E.error:E.onError(t);throw r.result=b(o),{__earlyExit:!0,error:o}}},s}async function k(s){let c=N();try{let E=await s(c,e);return D(E)}catch(E){return se(E)?b(E.error):b({type:"UNEXPECTED_ERROR",cause:E})}}async function U(s,c){let E=N();try{let h=await c(E,e,s);return D(h)}catch(h){return se(h)?b(h.error):b({type:"UNEXPECTED_ERROR",cause:h})}}function X(){return[...u]}function $(s){let c=u.map(h=>h.name??h.key??"unnamed").filter(h=>h!=="unnamed"),E=JSON.stringify(c)===JSON.stringify(s);return{passed:E,message:E?`Steps invoked in order: ${s.join(", ")}`:`Expected steps [${s.join(", ")}] but got [${c.join(", ")}]`,expected:s,actual:c}}function H(s){let c=u.some(E=>E.name===s||E.key===s);return{passed:c,message:c?`Step "${s}" was invoked`:`Step "${s}" was NOT invoked`,expected:s,actual:c}}function Q(s){let c=u.some(E=>E.name===s||E.key===s);return{passed:!c,message:c?`Step "${s}" was invoked but should not have been`:`Step "${s}" was correctly NOT invoked`,expected:"not called",actual:c?"called":"not called"}}function Z(s,c){let E=s.ok===c.ok&&(s.ok?JSON.stringify(s.value)===JSON.stringify(c.value):JSON.stringify(s.error)===JSON.stringify(c.error));return{passed:E,message:E?"Result matches expected":"Result does not match expected",expected:c,actual:s}}function a(){m=[],v.clear(),l=0,u=[]}return{script:I,scriptStep:S,run:k,runWithInput:U,getInvocations:X,assertSteps:$,assertStepCalled:H,assertStepNotCalled:Q,assertResult:Z,reset:a}}function we(){let e,i=[],p=[],d=((...m)=>{if(p.push(m),i.length>0)return Promise.resolve(i.shift());if(e)return Promise.resolve(e);throw new Error("Mock function called without configured return value")});return d.returns=m=>(e=m,d),d.returnsOnce=m=>(i.push(m),d),d.getCalls=()=>[...p],d.getCallCount=()=>p.length,d.reset=()=>{e=void 0,i.length=0,p.length=0},d}function Te(e,i,p){let d=e.reduce((m,v)=>m+(v.durationMs??0),0);return{invocations:e.map(m=>({...m,timestamp:0})),result:i,events:p?.map(m=>({...m,ts:0})),durationMs:d}}function de(e,i){let p=[];e.invocations.length!==i.invocations.length&&p.push(`Invocation count: ${e.invocations.length} vs ${i.invocations.length}`);let d=Math.max(e.invocations.length,i.invocations.length);for(let m=0;m<d;m++){let v=e.invocations[m],l=i.invocations[m];if(!v){p.push(`Step ${m}: missing in first snapshot`);continue}if(!l){p.push(`Step ${m}: missing in second snapshot`);continue}v.name!==l.name&&p.push(`Step ${m} name: "${v.name}" vs "${l.name}"`),v.key!==l.key&&p.push(`Step ${m} key: "${v.key}" vs "${l.key}"`),v.result?.ok!==l.result?.ok&&p.push(`Step ${m} result: ${v.result?.ok?"ok":"err"} vs ${l.result?.ok?"ok":"err"}`)}return e.result.ok!==i.result.ok&&p.push(`Final result: ${e.result.ok?"ok":"err"} vs ${i.result.ok?"ok":"err"}`),{equal:p.length===0,differences:p}}function fe(e=0){let i=e;return{now:()=>i,advance:p=>{i+=p},set:p=>{i=p},reset:()=>{i=e}}}function Re(e){return{type:"ok",value:e}}function Ce(e){return{type:"err",error:e}}function xe(e){return{type:"throw",error:e}}export{de as compareSnapshots,we as createMockFn,Te as createSnapshot,fe as createTestClock,ke as createWorkflowHarness,Ce as errOutcome,Re as okOutcome,xe as throwOutcome};
+//# sourceMappingURL=testing.js.map