@t4h.framework/core 0.3.0 → 0.5.0

package/.ai/skills/framework-workflow-testing/SKILL.md

@@ -0,0 +1,172 @@
+---
+name: framework-workflow-testing
+description: >-
+  Build and maintain high-quality unit tests for T4H Framework workflows using
+  @t4h.framework/core/testing. Use this whenever the user asks to test a
+  workflow, add Vitest coverage for History.reconciler flows, mock claims,
+  validate logs, or simulate async activity outcomes (fulfilled/rejected/timeout),
+  even when they only mention "workflow test", "mock claim", or "run workflow in memory".
+---
+
+# Workflow unit testing with `@t4h.framework/core/testing`
+
+Use this skill to create or improve **workflow-focused unit tests** in T4H Framework projects.
+
+## What this skill optimizes
+
+- Fast in-memory workflow execution with `WorkflowTesting.run`.
+- Reliable claim mocking with real claim instances + `vi.spyOn`.
+- Clear assertions for behavior (calls, payload, order, and logs).
+- Predictable handling of async activities with `mockAsyncActivity`.
+
+## When to choose this skill
+
+Choose this skill when the user asks to:
+
+- test a `Workflow` end-to-end (without infra);
+- mock outbound dependencies used by activities (HTTP, DB, etc.);
+- assert emitted logs for workflow execution paths;
+- simulate async activity outcomes in tests;
+- add or fix `vitest` tests for workflow modules.
+
+If the request is specifically about testing `AsyncActivity.advance`, use `Internals.runActivity` directly instead of only `WorkflowTesting.run`.
+
+## Public API available
+
+```ts
+import { WorkflowTesting } from '@t4h.framework/core/testing'
+```
+
+`WorkflowTesting.run(workflow, input?, options?)`
+
+Supported options:
+
+- `claims`: claim providers used during execution.
+- `env`: environment entries for `Env.run`.
+- `mockAsyncActivity`: function or queue for pending async activities.
+- `logs`: capture runtime logs.
+- `maxTicks`: protect against infinite replay loops (default `10_000`).
+
+## Canonical workflow test pattern
+
+Follow this structure by default:
+
+1. Arrange claims and spies in helper functions.
+2. Initialize setup in `beforeEach`.
+3. Execute workflow with `WorkflowTesting.run`.
+4. Assert calls, payload structure, ordering, and logs.
+
+Base mock style on this pattern:
+
+```ts
+function createClaimsWithHttpSpy() {
+  const http = findClaimByConstructor(DevHttpClientRequestClaim)
+  const mockRequest = vi.spyOn(http, 'request').mockResolvedValue({
+    status: 200,
+    headers: { 'content-type': 'application/json' },
+    body: Readable.from(Buffer.from('{}')),
+  })
+  return { claims, mockRequest }
+}
+```
+
+Why this pattern: it keeps tests close to real wiring while still allowing strict call inspection.
+
+## Standard recipe for new tests
+
+### 1) Create setup helpers
+
+- Put claim setup and spies in dedicated functions (`createClaimsWith...`).
+- Return both `claims` and the spy object(s) for assertions.
+- Keep data decoders (e.g. request-body parser) as small utility functions.
+
+### 2) Execute workflow under test
+
+- Use `await WorkflowTesting.run(workflow, input, { claims, logs, ... })`.
+- Capture logs with `const logs: Log[] = []` when log behavior matters.
+
+### 3) Assert behavior and contract
+
+Prefer these assertions:
+
+- call count (`toHaveBeenCalledTimes`);
+- important call arguments (URL, method, payload);
+- ordering (`mock.calls[0]`, `mock.calls[1]`);
+- final workflow output;
+- log messages and sequence (`logs.map(entry => entry.args[0])`).
+
+### 4) Cover async outcomes when applicable
+
+If any async activity can return `pending`, provide `mockAsyncActivity`.
+
+Function strategy:
+
+```ts
+mockAsyncActivity: (activity, { index, pending }) => {
+  if (index === 0) return { status: 'fulfilled', output: true }
+  return { status: 'rejected', reason: 'denied' }
+}
+```
+
+Queue strategy:
+
+```ts
+mockAsyncActivity: [
+  { status: 'fulfilled', output: true },
+  { status: 'timeout' },
+]
+```
+
+Important behavior:
+
+- no resolver + pending async => throws;
+- timeout outcome runs real `onTimeout`;
+- exhausted queue => throws `No more async outcomes`.
+
+## Mocking guidelines (do this, avoid that)
+
+Do:
+
+- mock concrete claim instances used by runtime providers;
+- use `vi.spyOn` on dependency methods (e.g. `request`);
+- return realistic shapes (status/headers/body) for external call mocks;
+- isolate each test with `beforeEach`.
+
+Avoid:
+
+- over-mocking framework internals;
+- asserting implementation details unrelated to behavior;
+- using `WorkflowTesting.run` to validate real `advance` logic.
+
+## Minimal template to generate quickly
+
+```ts
+import { WorkflowTesting } from '@t4h.framework/core/testing'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+describe('my workflow', () => {
+  let claims: ReturnType<typeof createClaimsWithSpy>['claims']
+  let mockCall: ReturnType<typeof vi.spyOn>
+
+  beforeEach(() => {
+    const setup = createClaimsWithSpy()
+    claims = setup.claims
+    mockCall = setup.mockCall
+  })
+
+  it('runs to completion with expected side effects', async () => {
+    const logs = []
+    await WorkflowTesting.run(myWorkflow, undefined, { claims, logs })
+    expect(mockCall).toHaveBeenCalledTimes(1)
+  })
+})
+```
+
+## Completion checklist before finishing
+
+- Test imports `WorkflowTesting` from `@t4h.framework/core/testing`.
+- Claim providers are passed via `options.claims`.
+- Pending async paths have `mockAsyncActivity`.
+- Assertions cover side effects and expected ordering.
+- Logs are asserted when they are part of the workflow contract.
+- Test file uses Vitest idioms consistently.

package/README.md

@@ -190,10 +190,7 @@ For long-running operations that need a bootstrap/advance cycle (e.g. waiting fo
 
 ```typescript
 import Type from 'typebox'
-import {
-  AsyncActivity,
-  AsyncActivityResultPending,
-} from '@t4h.framework/core'
+import { AsyncActivity, AsyncActivityResultPending } from '@t4h.framework/core'
 
 const ApprovalSchema = Type.Object({
   approved: Type.Boolean(),
@@ -243,7 +240,10 @@ class WaitForApprovalActivity extends AsyncActivity<
   }
 
   public async onTimeout(
-    bootstrap: AsyncActivityResultPending<{ requestId: string; orderId: string }>,
+    bootstrap: AsyncActivityResultPending<{
+      requestId: string
+      orderId: string
+    }>,
   ) {
     return this.rejected({
       approved: false,
@@ -346,3 +346,76 @@ Env.run → Claim.run → fn(activity)
 ```
 
 **History** handles reconciliation: when an activity has been executed before, the previous result is returned directly (deterministic replay). When there is no history, the activity runs and the result is stored.
+
+---
+
+## Testing
+
+For running a workflow fully in-memory (driving its activities to completion in a
+single process), use the dedicated `testing` entrypoint. It is meant for tests and
+local execution only and is not part of the runtime contract.
+
+```typescript
+import { WorkflowTesting } from '@t4h.framework/core/testing'
+
+const output = await WorkflowTesting.run<MyWorkflow>(myWorkflow, input, {
+  env: { API_URL: 'https://api.example.com' },
+  claims: [
+    { provide: UserRepositoryClaim, value: new UserRepositoryClaimImpl() },
+  ],
+  mockAsyncActivity: () => ({ status: 'fulfilled', output: true }),
+})
+```
+
+### Driving async activities
+
+The harness runs the real `bootstrap`. If it already settles (`done`/`rejected`),
+that result is honored. If it returns `pending`, you **must** provide a
+`mockAsyncActivity` mock that declares the outcome for that activity — otherwise
+the run throws. This forces each test to consciously pick the scenario it covers.
+
+The mock returns an outcome (not an `advance` payload):
+
+```typescript
+// success
+mockAsyncActivity: () => ({ status: 'fulfilled', output: true })
+
+// rejection
+mockAsyncActivity: () => ({ status: 'rejected', reason: 'denied' })
+
+// timeout — runs the activity's real onTimeout(pending) policy
+mockAsyncActivity: () => ({ status: 'timeout' })
+```
+
+For workflows with several async activities in a fixed order, pass an array of
+outcomes — each pending async consumes the next entry (FIFO):
+
+```typescript
+mockAsyncActivity: [
+  { status: 'fulfilled', output: true },
+  { status: 'rejected', reason: 'denied' },
+  { status: 'timeout' },
+]
+```
+
+The mock receives the activity instance and `{ input, pending, index }`, so you
+can branch per activity or per resolution order:
+
+```typescript
+mockAsyncActivity: (activity, { index }) => {
+  if (activity instanceof WaitForApprovalActivity)
+    return { status: 'fulfilled', output: true }
+
+  if (index === 1) return { status: 'timeout' }
+
+  return { status: 'rejected', reason: 'denied' }
+}
+```
+
+You can also build the same FIFO behavior explicitly with
+`resolveAsyncActivitiesInOrder([...])` from `@t4h.framework/core/testing`.
+
+> The real `advance` logic is intentionally **not** exercised here — drive it in a
+> dedicated activity-level test via `Internals.runActivity`. The pending/resume
+> boundary (`PushWaitAsyncActivity`) is also not modeled: an async activity is a
+> single decision point per run.

package/dist/core.d.ts

@@ -12,6 +12,7 @@ export * from './models/Claim.js';
 export * from './models/Env.js';
 export * from './models/EnvDesign.js';
 export * from './models/History.js';
+export * from './models/Logger.js';
 export * from './models/PushActivity.js';
 export * from './models/PushWaitAsyncActivity.js';
 export * from './models/SerializableHelper.js';

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAE9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AAEvC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAE9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AAEvC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}

package/dist/core.js

@@ -12,6 +12,7 @@ export * from './models/Claim.js';
 export * from './models/Env.js';
 export * from './models/EnvDesign.js';
 export * from './models/History.js';
+export * from './models/Logger.js';
 export * from './models/PushActivity.js';
 export * from './models/PushWaitAsyncActivity.js';
 export * from './models/SerializableHelper.js';

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAE9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AAEvC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAE9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AAEvC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}

package/dist/models/Logger.d.ts

@@ -0,0 +1,13 @@
+export type LogLevel = 'log' | 'debug' | 'info' | 'warn' | 'error';
+export interface Log {
+    level: LogLevel;
+    args: unknown[];
+    at: number;
+}
+export declare namespace Logger {
+    interface RunOptions {
+        logs: Log[];
+    }
+    function run<T>(logs: Log[], fn: () => T): T;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/models/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/models/Logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAElE,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,QAAQ,CAAA;IACf,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;CACX;AAOD,yBAAiB,MAAM,CAAC;IAetB,UAAiB,UAAU;QACzB,IAAI,EAAE,GAAG,EAAE,CAAA;KACZ;IAED,SAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,KAS9C;CAyBF"}

package/dist/models/Logger.js

@@ -0,0 +1,42 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+export var Logger;
+(function (Logger) {
+    const storage = new AsyncLocalStorage();
+    const levels = ['log', 'debug', 'info', 'warn', 'error'];
+    const original = {
+        log: console.log.bind(console),
+        debug: console.debug.bind(console),
+        info: console.info.bind(console),
+        warn: console.warn.bind(console),
+        error: console.error.bind(console),
+    };
+    let isIntercepted = false;
+    function run(logs, fn) {
+        interceptConsole();
+        const context = {
+            invocationIndex: 0,
+            logs,
+        };
+        return storage.run(context, fn);
+    }
+    Logger.run = run;
+    function interceptConsole() {
+        if (isIntercepted)
+            return;
+        isIntercepted = true;
+        for (const level of levels) {
+            console[level] = (...args) => record(level, args);
+        }
+    }
+    function record(level, args) {
+        const context = storage.getStore();
+        if (!context)
+            return original[level](...args);
+        const index = context.invocationIndex++;
+        if (index < context.logs.length)
+            return;
+        context.logs.push({ level, args, at: Date.now() });
+        original[level](...args);
+    }
+})(Logger || (Logger = {}));
+//# sourceMappingURL=Logger.js.map

package/dist/models/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/models/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAepD,MAAM,KAAW,MAAM,CAqDtB;AArDD,WAAiB,MAAM;IACrB,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAiB,CAAA;IAEtD,MAAM,MAAM,GAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IAE7E,MAAM,QAAQ,GAAmD;QAC/D,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;KACnC,CAAA;IAED,IAAI,aAAa,GAAG,KAAK,CAAA;IAMzB,SAAgB,GAAG,CAAI,IAAW,EAAE,EAAW;QAC7C,gBAAgB,EAAE,CAAA;QAElB,MAAM,OAAO,GAAkB;YAC7B,eAAe,EAAE,CAAC;YAClB,IAAI;SACL,CAAA;QAED,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACjC,CAAC;IATe,UAAG,MASlB,CAAA;IAED,SAAS,gBAAgB;QACvB,IAAI,aAAa;YAAE,OAAM;QAEzB,aAAa,GAAG,IAAI,CAAA;QAEpB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC9D,CAAC;IACH,CAAC;IAED,SAAS,MAAM,CAAC,KAAe,EAAE,IAAe;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;QAElC,IAAI,CAAC,OAAO;YAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;QAE7C,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAA;QAEvC,IAAI,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM;YAAE,OAAM;QAEvC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;QAElD,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC1B,CAAC;AACH,CAAC,EArDgB,MAAM,KAAN,MAAM,QAqDtB"}

package/dist/testing/WorkflowTesting.d.ts

@@ -0,0 +1,6 @@
+import { type RunWorkflowOptions } from './run-workflow.js';
+import type { Workflow, WorkflowInput } from '../models/Workflow.js';
+export declare class WorkflowTesting {
+    static run<T extends Workflow<any, any>>(workflow: T, input?: WorkflowInput<T>, options?: RunWorkflowOptions): Promise<any>;
+}
+//# sourceMappingURL=WorkflowTesting.d.ts.map

package/dist/testing/WorkflowTesting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowTesting.d.ts","sourceRoot":"","sources":["../../src/testing/WorkflowTesting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEpE,qBAAa,eAAe;WACN,GAAG,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EAClD,QAAQ,EAAE,CAAC,EACX,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,kBAAkB;CAI/B"}

package/dist/testing/WorkflowTesting.js

@@ -0,0 +1,7 @@
+import { runWorkflow } from './run-workflow.js';
+export class WorkflowTesting {
+    static async run(workflow, input, options) {
+        return runWorkflow(workflow, input, options);
+    }
+}
+//# sourceMappingURL=WorkflowTesting.js.map

package/dist/testing/WorkflowTesting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowTesting.js","sourceRoot":"","sources":["../../src/testing/WorkflowTesting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAA;AAGxE,MAAM,OAAO,eAAe;IACnB,MAAM,CAAC,KAAK,CAAC,GAAG,CACrB,QAAW,EACX,KAAwB,EACxB,OAA4B;QAE5B,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAyB,EAAE,OAAO,CAAC,CAAA;IAClE,CAAC;CACF"}

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+export * from './WorkflowTesting.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/dist/testing/index.js

@@ -0,0 +1,2 @@
+export * from './WorkflowTesting.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/dist/testing/run-workflow.d.ts

@@ -0,0 +1,31 @@
+import { type AnyAsyncActivity } from '../models/AsyncActivity.js';
+import { AsyncActivityResultPending } from '../models/AsyncActivityAdvanceResult.js';
+import type { ClaimProvider } from '../models/Claim.js';
+import { Env } from '../models/Env.js';
+import type { Log } from '../models/Logger.js';
+import type { Workflow, WorkflowInput } from '../models/Workflow.js';
+interface MockAsyncActivityContext {
+    input: unknown;
+    pending: AsyncActivityResultPending;
+    index: number;
+}
+export type AsyncActivityOutcome = {
+    status: 'fulfilled';
+    output?: unknown;
+} | {
+    status: 'rejected';
+    reason?: unknown;
+} | {
+    status: 'timeout';
+};
+type MockAsyncActivity = (activity: AnyAsyncActivity, context: MockAsyncActivityContext) => AsyncActivityOutcome | Promise<AsyncActivityOutcome>;
+export interface RunWorkflowOptions {
+    claims?: readonly ClaimProvider<any>[];
+    env?: Env.Entries;
+    mockAsyncActivity?: MockAsyncActivity | readonly AsyncActivityOutcome[];
+    maxTicks?: number;
+    logs?: Log[];
+}
+export declare function runWorkflow<T extends Workflow<any, any>>(workflow: T, input: WorkflowInput<T>, options?: RunWorkflowOptions): Promise<any>;
+export {};
+//# sourceMappingURL=run-workflow.d.ts.map

package/dist/testing/run-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-workflow.d.ts","sourceRoot":"","sources":["../../src/testing/run-workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAEL,0BAA0B,EAE3B,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAEtC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAG9C,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAGpE,UAAU,wBAAwB;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,0BAA0B,CAAA;IACnC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAA;AAEzB,KAAK,iBAAiB,GAAG,CACvB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,wBAAwB,KAC9B,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;AAEzD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;IACtC,GAAG,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACjB,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,SAAS,oBAAoB,EAAE,CAAA;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;CACb;AA6BD,wBAAsB,WAAW,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EAC5D,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,OAAO,GAAE,kBAAuB,gBAmCjC"}

package/dist/testing/run-workflow.js

@@ -0,0 +1,102 @@
+import { AsyncActivity, } from '../models/AsyncActivity.js';
+import { AsyncActivityResultFulfilled, AsyncActivityResultPending, AsyncActivityResultRejected, } from '../models/AsyncActivityAdvanceResult.js';
+import { Env } from '../models/Env.js';
+import { PushActivity } from '../models/PushActivity.js';
+import { SyncActivity } from '../models/SyncActivity.js';
+import { Internals } from '../tools/Internals.js';
+function mockAsyncActivities(outcomes) {
+    const queue = [...outcomes];
+    return (activity, context) => {
+        const next = queue.shift();
+        if (!next)
+            throw new Error(`No more async outcomes (activity: "${activity.constructor.name}", index: ${context.index}, input: ${JSON.stringify(context.input)})`);
+        return next;
+    };
+}
+function normalizeMockAsyncActivity(mock) {
+    if (!mock)
+        return undefined;
+    if (Array.isArray(mock))
+        return mockAsyncActivities(mock);
+    return mock;
+}
+export async function runWorkflow(workflow, input, options = {}) {
+    const claims = options.claims ?? [];
+    const env = options.env ?? {};
+    const maxTicks = options.maxTicks ?? 10_000;
+    const history = [];
+    const logs = options.logs ?? [];
+    const mocks = normalizeMockAsyncActivity(options.mockAsyncActivity);
+    const resolutionState = { index: 0 };
+    for (let tick = 0; tick < maxTicks; tick++) {
+        try {
+            return await Internals.runWorkflow(workflow, {
+                input,
+                claims,
+                env,
+                history,
+                logs,
+            });
+        }
+        catch (pushOrError) {
+            if (!(pushOrError instanceof PushActivity))
+                throw pushOrError;
+            const item = await resolveActivity(pushOrError, { claims, env }, mocks, resolutionState);
+            history.push(item);
+        }
+    }
+    throw new Error(`Workflow did not settle within ${maxTicks} ticks`);
+}
+async function resolveActivity(push, context, mockAsyncActivity, resolutionState) {
+    const activity = push.activity;
+    if (activity instanceof SyncActivity) {
+        const output = await Internals.runActivity(activity, context, instance => instance.run(push.input));
+        return { type: 'sync', output };
+    }
+    if (activity instanceof AsyncActivity) {
+        const bootstrap = await Internals.runActivity(activity, context, instance => instance.bootstrap(push.input));
+        return resolveAsyncActivity(activity, bootstrap, context, push.input, mockAsyncActivity, resolutionState);
+    }
+    throw new Error('Unknown activity type');
+}
+async function resolveAsyncActivity(activity, bootstrap, context, input, mockAsyncActivity, resolutionState) {
+    if (bootstrap instanceof AsyncActivityResultFulfilled)
+        return { type: 'async', status: 'fulfilled', output: bootstrap.payload };
+    if (bootstrap instanceof AsyncActivityResultRejected)
+        return { type: 'async', status: 'rejected', output: bootstrap.payload };
+    if (!(bootstrap instanceof AsyncActivityResultPending))
+        throw new Error('Unknown async activity result');
+    const name = activity.constructor.name;
+    if (!mockAsyncActivity)
+        throw new Error(`Async activity "${name}" is pending and no resolveAsyncActivity was provided`);
+    const outcome = await mockAsyncActivity(activity, {
+        input,
+        pending: bootstrap,
+        index: resolutionState?.index ?? 0,
+    });
+    if (resolutionState)
+        resolutionState.index++;
+    return outcomeToHistoryItem(activity, outcome, bootstrap, context, name);
+}
+async function outcomeToHistoryItem(activity, outcome, pending, context, name) {
+    switch (outcome.status) {
+        case 'fulfilled':
+            return { type: 'async', status: 'fulfilled', output: outcome.output };
+        case 'rejected':
+            return { type: 'async', status: 'rejected', output: outcome.reason };
+        case 'timeout': {
+            const onTimeout = activity.onTimeout?.bind(activity);
+            if (!onTimeout)
+                throw new Error(`Async activity "${name}" timed out but defines no onTimeout handler`);
+            const result = await Internals.runActivity(activity, context, () => onTimeout(pending));
+            if (result instanceof AsyncActivityResultFulfilled)
+                return { type: 'async', status: 'fulfilled', output: result.payload };
+            if (result instanceof AsyncActivityResultRejected)
+                return { type: 'async', status: 'rejected', output: result.payload };
+            throw new Error(`Async activity "${name}" stayed pending after onTimeout`);
+        }
+        default:
+            throw new Error(`Unknown async activity outcome for "${name}"`);
+    }
+}
+//# sourceMappingURL=run-workflow.js.map

package/dist/testing/run-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-workflow.js","sourceRoot":"","sources":["../../src/testing/run-workflow.ts"],"names":[],"mappings":"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"}

package/dist/tools/Internals.d.ts

@@ -2,6 +2,7 @@ import type { Activity, ActivityConstructor } from '../models/Activity.js';
 import { type ClaimProvider } from '../models/Claim.js';
 import { Env } from '../models/Env.js';
 import { type HistoryItem } from '../models/History.js';
+import { type Log } from '../models/Logger.js';
 import type { Workflow, WorkflowInput } from '../models/Workflow.js';
 export declare namespace Internals {
     interface WorkflowRunContext<TWorkflow extends Workflow<any, any>> {
@@ -9,6 +10,7 @@ export declare namespace Internals {
         history: readonly HistoryItem[];
         env: Env.Entries;
         input: WorkflowInput<TWorkflow>;
+        logs: Log[];
     }
     function runWorkflow<T extends Workflow<any, any>>(workflow: T, context: WorkflowRunContext<T>): any;
     interface ActivityRunContext {

package/dist/tools/Internals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Internals.d.ts","sourceRoot":"","sources":["../../src/tools/Internals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC1E,OAAO,EAAS,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEpE,yBAAiB,SAAS,CAAC;IACzB,UAAiB,kBAAkB,CAAC,SAAS,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;QACtE,MAAM,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;QACrC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;QAC/B,GAAG,EAAE,GAAG,CAAC,OAAO,CAAA;QAChB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;KAChC;IAED,SAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACtD,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,OAO/B;IAED,UAAiB,kBAAkB;QACjC,MAAM,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;QACrC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAA;KACjB;IAED,SAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,EAC/C,6BAA6B,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,EACzD,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,KAUvB;CACF"}
+{"version":3,"file":"Internals.d.ts","sourceRoot":"","sources":["../../src/tools/Internals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC1E,OAAO,EAAS,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAU,KAAK,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEpE,yBAAiB,SAAS,CAAC;IACzB,UAAiB,kBAAkB,CAAC,SAAS,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;QACtE,MAAM,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;QACrC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;QAC/B,GAAG,EAAE,GAAG,CAAC,OAAO,CAAA;QAChB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;QAC/B,IAAI,EAAE,GAAG,EAAE,CAAA;KACZ;IAED,SAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACtD,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,OAS/B;IAED,UAAiB,kBAAkB;QACjC,MAAM,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;QACrC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAA;KACjB;IAED,SAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,EAC/C,6BAA6B,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,EACzD,OAAO,EAAE,kBAAkB,EAC3B,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,KAUvB;CACF"}

package/dist/tools/Internals.js

@@ -1,10 +1,11 @@
 import { Claim } from '../models/Claim.js';
 import { Env } from '../models/Env.js';
 import { History } from '../models/History.js';
+import { Logger } from '../models/Logger.js';
 export var Internals;
 (function (Internals) {
     function runWorkflow(workflow, context) {
-        return Env.run(context.env, () => Claim.run(context.claims, () => History.run(context.history, () => workflow.fn(context.input))));
+        return Env.run(context.env, () => Claim.run(context.claims, () => History.run(context.history, () => Logger.run(context.logs, () => workflow.fn(context.input)))));
     }
     Internals.runWorkflow = runWorkflow;
     function runActivity(activityOrActivityConstructor, context, fn) {

package/dist/tools/Internals.js.map

@@ -1 +1 @@
-{"version":3,"file":"Internals.js","sourceRoot":"","sources":["../../src/tools/Internals.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAsB,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,EAAE,OAAO,EAAoB,MAAM,sBAAsB,CAAA;AAGhE,MAAM,KAAW,SAAS,CAsCzB;AAtCD,WAAiB,SAAS;IAQxB,SAAgB,WAAW,CACzB,QAAW,EACX,OAA8B;QAE9B,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAC/B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,CAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAC/D,CACF,CAAA;IACH,CAAC;IATe,qBAAW,cAS1B,CAAA;IAOD,SAAgB,WAAW,CACzB,6BAAyD,EACzD,OAA2B,EAC3B,EAAsB;QAEtB,MAAM,QAAQ,GACZ,OAAO,6BAA6B,KAAK,UAAU;YACjD,CAAC,CAAC,IAAI,6BAA6B,EAAE;YACrC,CAAC,CAAC,6BAA6B,CAAA;QAEnC,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAC/B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAC9C,CAAA;IACH,CAAC;IAbe,qBAAW,cAa1B,CAAA;AACH,CAAC,EAtCgB,SAAS,KAAT,SAAS,QAsCzB"}
+{"version":3,"file":"Internals.js","sourceRoot":"","sources":["../../src/tools/Internals.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAsB,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,EAAE,OAAO,EAAoB,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,MAAM,EAAY,MAAM,qBAAqB,CAAA;AAGtD,MAAM,KAAW,SAAS,CAyCzB;AAzCD,WAAiB,SAAS;IASxB,SAAgB,WAAW,CACzB,QAAW,EACX,OAA8B;QAE9B,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAC/B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,CAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,CAChC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAC3D,CACF,CACF,CAAA;IACH,CAAC;IAXe,qBAAW,cAW1B,CAAA;IAOD,SAAgB,WAAW,CACzB,6BAAyD,EACzD,OAA2B,EAC3B,EAAsB;QAEtB,MAAM,QAAQ,GACZ,OAAO,6BAA6B,KAAK,UAAU;YACjD,CAAC,CAAC,IAAI,6BAA6B,EAAE;YACrC,CAAC,CAAC,6BAA6B,CAAA;QAEnC,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,CAC/B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAC9C,CAAA;IACH,CAAC;IAbe,qBAAW,cAa1B,CAAA;AACH,CAAC,EAzCgB,SAAS,KAAT,SAAS,QAyCzB"}

package/dist/tools/runWorkflowToCompletion.d.ts

@@ -0,0 +1,15 @@
+import { AsyncActivity } from '../models/AsyncActivity.js';
+import type { ClaimProvider } from '../models/Claim.js';
+import { Env } from '../models/Env.js';
+import type { Log } from '../models/Logger.js';
+import type { Workflow, WorkflowInput } from '../models/Workflow.js';
+export type AsyncActivityResolver = (activity: AsyncActivity<any, any, any, any, any, any>, input: unknown) => unknown | Promise<unknown>;
+export interface RunWorkflowToCompletionOptions {
+    claims?: readonly ClaimProvider<any>[];
+    env?: Env.Entries;
+    resolveAsyncActivity?: AsyncActivityResolver;
+    maxTicks?: number;
+    logs?: Log[];
+}
+export declare function runWorkflowToCompletion<T extends Workflow<any, any>>(workflow: T, input: WorkflowInput<T>, options?: RunWorkflowToCompletionOptions): Promise<any>;
+//# sourceMappingURL=runWorkflowToCompletion.d.ts.map

package/dist/tools/runWorkflowToCompletion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runWorkflowToCompletion.d.ts","sourceRoot":"","sources":["../../src/tools/runWorkflowToCompletion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAM1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAEtC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAG9C,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAGpE,MAAM,MAAM,qBAAqB,GAAG,CAClC,QAAQ,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACrD,KAAK,EAAE,OAAO,KACX,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE/B,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;IACtC,GAAG,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACjB,oBAAoB,CAAC,EAAE,qBAAqB,CAAA;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;CACb;AAED,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACxE,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,OAAO,GAAE,8BAAmC,gBAgC7C"}