@t4h.framework/core 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/.ai/skills/framework-core/SKILL.md +103 -287
  2. package/.ai/skills/framework-workflow-creation/SKILL.md +108 -60
  3. package/.ai/skills/framework-workflow-testing/SKILL.md +165 -111
  4. package/README.md +123 -37
  5. package/dist/models/ExecutionContext.d.ts +8 -0
  6. package/dist/models/ExecutionContext.d.ts.map +1 -0
  7. package/dist/models/ExecutionContext.js +22 -0
  8. package/dist/models/ExecutionContext.js.map +1 -0
  9. package/dist/testing/ActivityTesting.d.ts +25 -0
  10. package/dist/testing/ActivityTesting.d.ts.map +1 -0
  11. package/dist/testing/ActivityTesting.js +74 -0
  12. package/dist/testing/ActivityTesting.js.map +1 -0
  13. package/dist/testing/NonDeterministicWorkflowError.d.ts +4 -0
  14. package/dist/testing/NonDeterministicWorkflowError.d.ts.map +1 -0
  15. package/dist/testing/NonDeterministicWorkflowError.js +7 -0
  16. package/dist/testing/NonDeterministicWorkflowError.js.map +1 -0
  17. package/dist/testing/StrictGuard.d.ts +4 -0
  18. package/dist/testing/StrictGuard.d.ts.map +1 -0
  19. package/dist/testing/StrictGuard.js +26 -0
  20. package/dist/testing/StrictGuard.js.map +1 -0
  21. package/dist/testing/TestClock.d.ts +12 -0
  22. package/dist/testing/TestClock.d.ts.map +1 -0
  23. package/dist/testing/TestClock.js +64 -0
  24. package/dist/testing/TestClock.js.map +1 -0
  25. package/dist/testing/TestWorkflowEnvironment.d.ts +27 -0
  26. package/dist/testing/TestWorkflowEnvironment.d.ts.map +1 -0
  27. package/dist/testing/TestWorkflowEnvironment.js +62 -0
  28. package/dist/testing/TestWorkflowEnvironment.js.map +1 -0
  29. package/dist/testing/WorkflowTesting.d.ts +1 -1
  30. package/dist/testing/async-activity-results.d.ts +12 -0
  31. package/dist/testing/async-activity-results.d.ts.map +1 -0
  32. package/dist/testing/async-activity-results.js +10 -0
  33. package/dist/testing/async-activity-results.js.map +1 -0
  34. package/dist/testing/create-mock-claim.d.ts +11 -0
  35. package/dist/testing/create-mock-claim.d.ts.map +1 -0
  36. package/dist/testing/create-mock-claim.js +26 -0
  37. package/dist/testing/create-mock-claim.js.map +1 -0
  38. package/dist/testing/create-mock-claims.d.ts +13 -0
  39. package/dist/testing/create-mock-claims.d.ts.map +1 -0
  40. package/dist/testing/create-mock-claims.js +8 -0
  41. package/dist/testing/create-mock-claims.js.map +1 -0
  42. package/dist/testing/create-test-env.d.ts +10 -0
  43. package/dist/testing/create-test-env.d.ts.map +1 -0
  44. package/dist/testing/create-test-env.js +7 -0
  45. package/dist/testing/create-test-env.js.map +1 -0
  46. package/dist/testing/exceptions/NonDeterministicWorkflowError.d.ts +4 -0
  47. package/dist/testing/exceptions/NonDeterministicWorkflowError.d.ts.map +1 -0
  48. package/dist/testing/exceptions/NonDeterministicWorkflowError.js +7 -0
  49. package/dist/testing/exceptions/NonDeterministicWorkflowError.js.map +1 -0
  50. package/dist/testing/index.d.ts +8 -1
  51. package/dist/testing/index.d.ts.map +1 -1
  52. package/dist/testing/index.js +8 -1
  53. package/dist/testing/index.js.map +1 -1
  54. package/dist/testing/mock-async.d.ts +48 -0
  55. package/dist/testing/mock-async.d.ts.map +1 -0
  56. package/dist/testing/mock-async.js +58 -0
  57. package/dist/testing/mock-async.js.map +1 -0
  58. package/dist/testing/outcomes.d.ts +12 -0
  59. package/dist/testing/outcomes.d.ts.map +1 -0
  60. package/dist/testing/outcomes.js +10 -0
  61. package/dist/testing/outcomes.js.map +1 -0
  62. package/dist/testing/run-workflow.d.ts +22 -21
  63. package/dist/testing/run-workflow.d.ts.map +1 -1
  64. package/dist/testing/run-workflow.js +47 -23
  65. package/dist/testing/run-workflow.js.map +1 -1
  66. package/dist/testing/tools/create-mock-claim.d.ts +5 -0
  67. package/dist/testing/tools/create-mock-claim.d.ts.map +1 -0
  68. package/dist/testing/tools/create-mock-claim.js +26 -0
  69. package/dist/testing/tools/create-mock-claim.js.map +1 -0
  70. package/dist/testing/tools/create-mock-claims.d.ts +8 -0
  71. package/dist/testing/tools/create-mock-claims.d.ts.map +1 -0
  72. package/dist/testing/tools/create-mock-claims.js +5 -0
  73. package/dist/testing/tools/create-mock-claims.js.map +1 -0
  74. package/dist/testing/tools/create-test-env.d.ts +4 -0
  75. package/dist/testing/tools/create-test-env.d.ts.map +1 -0
  76. package/dist/testing/tools/create-test-env.js +7 -0
  77. package/dist/testing/tools/create-test-env.js.map +1 -0
  78. package/dist/testing/tools/mock-async.d.ts +20 -0
  79. package/dist/testing/tools/mock-async.d.ts.map +1 -0
  80. package/dist/testing/tools/mock-async.js +57 -0
  81. package/dist/testing/tools/mock-async.js.map +1 -0
  82. package/dist/testing/tools/resolve-activity.d.ts +11 -0
  83. package/dist/testing/tools/resolve-activity.d.ts.map +1 -0
  84. package/dist/testing/tools/resolve-activity.js +23 -0
  85. package/dist/testing/tools/resolve-activity.js.map +1 -0
  86. package/dist/testing/tools/resolve-async-activity.d.ts +15 -0
  87. package/dist/testing/tools/resolve-async-activity.d.ts.map +1 -0
  88. package/dist/testing/tools/resolve-async-activity.js +69 -0
  89. package/dist/testing/tools/resolve-async-activity.js.map +1 -0
  90. package/dist/testing/tools/run-with-clock.d.ts +3 -0
  91. package/dist/testing/tools/run-with-clock.d.ts.map +1 -0
  92. package/dist/testing/tools/run-with-clock.js +7 -0
  93. package/dist/testing/tools/run-with-clock.js.map +1 -0
  94. package/dist/testing/tools/run-workflow-ticks.d.ts +8 -0
  95. package/dist/testing/tools/run-workflow-ticks.d.ts.map +1 -0
  96. package/dist/testing/tools/run-workflow-ticks.js +26 -0
  97. package/dist/testing/tools/run-workflow-ticks.js.map +1 -0
  98. package/dist/testing/tools/run-workflow.d.ts +25 -0
  99. package/dist/testing/tools/run-workflow.d.ts.map +1 -0
  100. package/dist/testing/tools/run-workflow.js +25 -0
  101. package/dist/testing/tools/run-workflow.js.map +1 -0
  102. package/dist/testing/types.d.ts +19 -0
  103. package/dist/testing/types.d.ts.map +1 -0
  104. package/dist/testing/types.js +2 -0
  105. package/dist/testing/types.js.map +1 -0
  106. package/dist/testing/typings/AsyncActivityResult.d.ts +10 -0
  107. package/dist/testing/typings/AsyncActivityResult.d.ts.map +1 -0
  108. package/dist/testing/typings/AsyncActivityResult.js +2 -0
  109. package/dist/testing/typings/AsyncActivityResult.js.map +1 -0
  110. package/dist/testing/typings/ClaimConstructor.d.ts +2 -0
  111. package/dist/testing/typings/ClaimConstructor.d.ts.map +1 -0
  112. package/dist/testing/typings/ClaimConstructor.js +2 -0
  113. package/dist/testing/typings/ClaimConstructor.js.map +1 -0
  114. package/dist/testing/typings/MockAsyncActivity.d.ts +10 -0
  115. package/dist/testing/typings/MockAsyncActivity.d.ts.map +1 -0
  116. package/dist/testing/typings/MockAsyncActivity.js +2 -0
  117. package/dist/testing/typings/MockAsyncActivity.js.map +1 -0
  118. package/package.json +1 -1
package/README.md CHANGED
@@ -356,66 +356,152 @@ single process), use the dedicated `testing` entrypoint. It is meant for tests a
356
356
  local execution only and is not part of the runtime contract.
357
357
 
358
358
  ```typescript
359
- import { WorkflowTesting } from '@t4h.framework/core/testing'
359
+ import {
360
+ TestWorkflowEnvironment,
361
+ mockAsync,
362
+ fulfilled,
363
+ createMockClaims,
364
+ mockClaim,
365
+ } from '@t4h.framework/core/testing'
360
366
 
361
- const output = await WorkflowTesting.run<MyWorkflow>(myWorkflow, input, {
367
+ const env = TestWorkflowEnvironment.create({ now: 0 })
368
+
369
+ const output = await env.execute(myWorkflow, input, {
362
370
  env: { API_URL: 'https://api.example.com' },
363
- claims: [
364
- { provide: UserRepositoryClaim, value: new UserRepositoryClaimImpl() },
365
- ],
366
- mockAsyncActivity: () => ({ status: 'fulfilled', output: true }),
371
+ claims: [{ provide: UserRepositoryClaim, value: new UserRepositoryClaimImpl() }],
372
+ mockAsyncActivity: mockAsync().on(WaitForApprovalActivity, fulfilled(true)),
367
373
  })
368
374
  ```
369
375
 
376
+ `TestWorkflowEnvironment.create()` options:
377
+
378
+ | Option | Default | Purpose |
379
+ |--------|---------|---------|
380
+ | `now` | `0` | Pins `Date.now()` to this value at run start |
381
+ | `resolveActivityTimeouts` | `true` | Auto-advances clock to each activity's `timeoutAt` and resolves via `onTimeout` |
382
+
383
+ `execute()` options:
384
+
385
+ | Option | Type | Purpose |
386
+ |--------|------|---------|
387
+ | `claims` | `readonly ClaimProvider[]` | Claim implementations |
388
+ | `env` | `Env.Entries` | String env vars |
389
+ | `mockAsyncActivity` | `MockAsyncActivity` | Required when `bootstrap` returns `pending` and `resolveActivityTimeouts` doesn't cover it |
390
+
391
+ **Replay validation is automatic.** After each `execute()`, the environment
392
+ re-runs the workflow from the recorded history and from a fresh tick-by-tick
393
+ replay. A mismatch throws `NonDeterministicWorkflowError`.
394
+
370
395
  ### Driving async activities
371
396
 
372
397
  The harness runs the real `bootstrap`. If it already settles (`done`/`rejected`),
373
- that result is honored. If it returns `pending`, you **must** provide a
374
- `mockAsyncActivity` mock that declares the outcome for that activity — otherwise
375
- the run throws. This forces each test to consciously pick the scenario it covers.
398
+ that result is honored. If it returns `pending`, the `resolveActivityTimeouts`
399
+ option (default `true`) auto-advances the clock and resolves the activity via its
400
+ real `onTimeout` handler. When `resolveActivityTimeouts` is false or the activity
401
+ has no `timeoutAt`, you must provide `mockAsyncActivity`.
376
402
 
377
- The mock returns an outcome (not an `advance` payload):
403
+ Use the `mockAsync()` builder to declare outcomes per activity type:
378
404
 
379
405
  ```typescript
380
- // success
381
- mockAsyncActivity: () => ({ status: 'fulfilled', output: true })
406
+ import { mockAsync, fulfilled, rejected, timeout } from '@t4h.framework/core/testing'
407
+
408
+ // Static outcome per activity type
409
+ mockAsyncActivity: mockAsync()
410
+ .on(WaitForApprovalActivity, fulfilled(true))
411
+ .on(EmailActivity, fulfilled())
412
+
413
+ // Sequential outcomes per type (per-type call count)
414
+ mockAsyncActivity: mockAsync()
415
+ .on(WaitForApprovalActivity, [rejected(new Error('transient')), fulfilled(true)])
416
+
417
+ // Callback with per-type callCount
418
+ mockAsyncActivity: mockAsync()
419
+ .on(WaitForApprovalActivity, (activity, { callCount }) =>
420
+ callCount === 0 ? rejected() : fulfilled(true),
421
+ )
422
+
423
+ // Auto-resolve timeoutAt-based activities (e.g. SleepActivity)
424
+ mockAsyncActivity: mockAsync()
425
+ .on(WaitForApprovalActivity, fulfilled(true))
426
+ .timeout()
427
+
428
+ // Fallback for types not explicitly registered
429
+ mockAsyncActivity: mockAsync()
430
+ .on(WaitForApprovalActivity, fulfilled(true))
431
+ .fallback(() => timeout())
432
+ ```
382
433
 
383
- // rejection
384
- mockAsyncActivity: () => ({ status: 'rejected', reason: 'denied' })
434
+ Outcome helpers:
385
435
 
386
- // timeout — runs the activity's real onTimeout(pending) policy
387
- mockAsyncActivity: () => ({ status: 'timeout' })
436
+ ```typescript
437
+ fulfilled(output?) // { status: 'fulfilled', output }
438
+ rejected(reason?) // { status: 'rejected', reason }
439
+ timeout() // { status: 'timeout' } — runs the activity's real onTimeout()
388
440
  ```
389
441
 
390
- For workflows with several async activities in a fixed order, pass an array of
391
- outcomes — each pending async consumes the next entry (FIFO):
442
+ ### Mock claims
443
+
444
+ Use `mockClaim` and `createMockClaims` to build typed claim providers without
445
+ manual casts:
392
446
 
393
447
  ```typescript
394
- mockAsyncActivity: [
395
- { status: 'fulfilled', output: true },
396
- { status: 'rejected', reason: 'denied' },
397
- { status: 'timeout' },
398
- ]
448
+ import { createMockClaims, mockClaim } from '@t4h.framework/core/testing'
449
+ import { SftpClaim } from '@t4h.framework/sftp'
450
+
451
+ const list = vi.fn().mockResolvedValue([])
452
+ const claims = createMockClaims([mockClaim(SftpClaim, { list })])
399
453
  ```
400
454
 
401
- The mock receives the activity instance and `{ input, pending, index }`, so you
402
- can branch per activity or per resolution order:
455
+ Unimplemented claim methods throw with a clear error instead of returning
456
+ `undefined`.
457
+
458
+ For ready-made mocks, use each package's testing entrypoint — for example
459
+ `@t4h.framework/sftp/testing`, `@t4h.framework/http/testing`,
460
+ `@t4h.framework/orm/testing`.
461
+
462
+ ### Controlling test time
463
+
464
+ The environment exposes a clock that stays synchronized with the pinned
465
+ `Date.now()` across runs:
403
466
 
404
467
  ```typescript
405
- mockAsyncActivity: (activity, { index }) => {
406
- if (activity instanceof WaitForApprovalActivity)
407
- return { status: 'fulfilled', output: true }
468
+ env.clock.now() // current pinned timestamp (ms)
469
+ env.clock.advance(ms) // advance the pinned clock
470
+ env.clock.set(now) // set clock to a Date | number
471
+ ```
408
472
 
409
- if (index === 1) return { status: 'timeout' }
473
+ For direct clock control outside an environment, use `TestClock`:
410
474
 
411
- return { status: 'rejected', reason: 'denied' }
412
- }
475
+ ```typescript
476
+ import { TestClock } from '@t4h.framework/core/testing'
477
+
478
+ await TestClock.run({ now: 0 }, async () => {
479
+ TestClock.advance(86_400_000) // advance 1 day
480
+ // Date.now() returns the pinned value here
481
+ })
482
+ ```
483
+
484
+ ### Activity-level tests
485
+
486
+ The real `advance` logic is intentionally **not** exercised by `execute()`.
487
+ Test `advance` by calling it directly via `Internals.runActivity`:
488
+
489
+ ```typescript
490
+ import { Internals } from '@t4h.framework/core'
491
+
492
+ await Internals.runActivity(
493
+ WaitForApprovalActivity,
494
+ { env, claims },
495
+ activity => activity.advance({ approved: true }, pendingResult),
496
+ )
413
497
  ```
414
498
 
415
- You can also build the same FIFO behavior explicitly with
416
- `resolveAsyncActivitiesInOrder([...])` from `@t4h.framework/core/testing`.
499
+ ### Env helpers
417
500
 
418
- > The real `advance` logic is intentionally **not** exercised here — drive it in a
419
- > dedicated activity-level test via `Internals.runActivity`. The pending/resume
420
- > boundary (`PushWaitAsyncActivity`) is also not modeled: an async activity is a
421
- > single decision point per run.
501
+ Use `createTestEnv` to build env overrides:
502
+
503
+ ```typescript
504
+ import { createTestEnv } from '@t4h.framework/core/testing'
505
+
506
+ const envEntries = createTestEnv({ API_URL: 'https://example.com' })
507
+ ```
@@ -0,0 +1,8 @@
1
+ export type ExecutionLayer = 'workflow' | 'activity';
2
+ export declare namespace ExecutionContext {
3
+ function run<T>(layer: ExecutionLayer, fn: () => T): T;
4
+ function getLayer(): ExecutionLayer | undefined;
5
+ function isWorkflow(): boolean;
6
+ function isActivity(): boolean;
7
+ }
8
+ //# sourceMappingURL=ExecutionContext.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ExecutionContext.d.ts","sourceRoot":"","sources":["../../src/models/ExecutionContext.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,CAAA;AAQpD,yBAAiB,gBAAgB,CAAC;IAChC,SAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE5D;IAED,SAAgB,QAAQ,IAAI,cAAc,GAAG,SAAS,CAErD;IAED,SAAgB,UAAU,IAAI,OAAO,CAEpC;IAED,SAAgB,UAAU,IAAI,OAAO,CAEpC;CACF"}
@@ -0,0 +1,22 @@
1
+ import { AsyncLocalStorage } from 'node:async_hooks';
2
+ const storage = new AsyncLocalStorage();
3
+ export var ExecutionContext;
4
+ (function (ExecutionContext) {
5
+ function run(layer, fn) {
6
+ return storage.run({ layer }, fn);
7
+ }
8
+ ExecutionContext.run = run;
9
+ function getLayer() {
10
+ return storage.getStore()?.layer;
11
+ }
12
+ ExecutionContext.getLayer = getLayer;
13
+ function isWorkflow() {
14
+ return storage.getStore()?.layer === 'workflow';
15
+ }
16
+ ExecutionContext.isWorkflow = isWorkflow;
17
+ function isActivity() {
18
+ return storage.getStore()?.layer === 'activity';
19
+ }
20
+ ExecutionContext.isActivity = isActivity;
21
+ })(ExecutionContext || (ExecutionContext = {}));
22
+ //# sourceMappingURL=ExecutionContext.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ExecutionContext.js","sourceRoot":"","sources":["../../src/models/ExecutionContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAQpD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAyB,CAAA;AAE9D,MAAM,KAAW,gBAAgB,CAgBhC;AAhBD,WAAiB,gBAAgB;IAC/B,SAAgB,GAAG,CAAI,KAAqB,EAAE,EAAW;QACvD,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;IACnC,CAAC;IAFe,oBAAG,MAElB,CAAA;IAED,SAAgB,QAAQ;QACtB,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAA;IAClC,CAAC;IAFe,yBAAQ,WAEvB,CAAA;IAED,SAAgB,UAAU;QACxB,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,KAAK,UAAU,CAAA;IACjD,CAAC;IAFe,2BAAU,aAEzB,CAAA;IAED,SAAgB,UAAU;QACxB,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,KAAK,UAAU,CAAA;IACjD,CAAC;IAFe,2BAAU,aAEzB,CAAA;AACH,CAAC,EAhBgB,gBAAgB,KAAhB,gBAAgB,QAgBhC"}
@@ -0,0 +1,25 @@
1
+ import type { AsyncActivityOutcome } from './types.js';
2
+ import type { Activity } from '../models/Activity.js';
3
+ import type { ClaimProvider } from '../models/Claim.js';
4
+ import type { Env } from '../models/Env.js';
5
+ import type { Log } from '../models/Logger.js';
6
+ export interface ActivityTestingAsyncOptions {
7
+ /** Run the real advance handler when bootstrap returns pending. */
8
+ advance?: unknown;
9
+ /** Simulate runtime resolution without calling advance. */
10
+ outcome?: AsyncActivityOutcome;
11
+ }
12
+ export interface ActivityTestingOptions {
13
+ claims?: readonly ClaimProvider<any>[];
14
+ env?: Env.Entries;
15
+ logs?: Log[];
16
+ async?: ActivityTestingAsyncOptions;
17
+ }
18
+ export declare class ActivityTesting {
19
+ static run<T extends Activity>(ActivityClass: Activity.Constructor<T>, args?: Activity.Args<T>, options?: ActivityTestingOptions): Promise<Activity.Output<T>>;
20
+ }
21
+ export declare class AsyncActivityRejectedError extends Error {
22
+ readonly reason: unknown;
23
+ constructor(reason: unknown);
24
+ }
25
+ //# sourceMappingURL=ActivityTesting.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ActivityTesting.d.ts","sourceRoot":"","sources":["../../src/testing/ActivityTesting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAUrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAI9C,MAAM,WAAW,2BAA2B;IAC1C,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,oBAAoB,CAAA;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;IACtC,GAAG,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;IACZ,KAAK,CAAC,EAAE,2BAA2B,CAAA;CACpC;AAED,qBAAa,eAAe;WACN,GAAG,CAAC,CAAC,SAAS,QAAQ,EACxC,aAAa,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EACtC,IAAI,GAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAqC,EAC1D,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CA6B/B;AAyFD,qBAAa,0BAA2B,SAAQ,KAAK;aACvB,MAAM,EAAE,OAAO;gBAAf,MAAM,EAAE,OAAO;CAQ5C"}
@@ -0,0 +1,74 @@
1
+ import { AsyncActivity, } from '../models/AsyncActivity.js';
2
+ import { AsyncActivityResultFulfilled, AsyncActivityResultPending, AsyncActivityResultRejected, } from '../models/AsyncActivityAdvanceResult.js';
3
+ import { SyncActivity } from '../models/SyncActivity.js';
4
+ import { Internals } from '../tools/Internals.js';
5
+ export class ActivityTesting {
6
+ static async run(ActivityClass, args = [], options = {}) {
7
+ const activity = new ActivityClass();
8
+ const context = {
9
+ claims: options.claims ?? [],
10
+ env: options.env ?? {},
11
+ };
12
+ const input = await activity.toInput(...args);
13
+ if (activity instanceof SyncActivity) {
14
+ const output = await Internals.runActivity(activity, context, instance => instance.run(input));
15
+ return activity.toOutput(output, ...args);
16
+ }
17
+ if (activity instanceof AsyncActivity) {
18
+ return resolveAsyncActivity(activity, input, args, context, options);
19
+ }
20
+ throw new Error(`Unknown activity type: ${ActivityClass.name}`);
21
+ }
22
+ }
23
+ async function resolveAsyncActivity(activity, input, args, context, options) {
24
+ const bootstrap = await Internals.runActivity(activity, context, instance => instance.bootstrap(input));
25
+ if (bootstrap instanceof AsyncActivityResultFulfilled)
26
+ return activity.toOutput(bootstrap.payload, ...args);
27
+ if (bootstrap instanceof AsyncActivityResultRejected)
28
+ throw new AsyncActivityRejectedError(bootstrap.payload);
29
+ if (!(bootstrap instanceof AsyncActivityResultPending))
30
+ throw new Error(`Unknown async bootstrap result for "${activity.constructor.name}"`);
31
+ const asyncOptions = options.async;
32
+ if (asyncOptions && 'advance' in asyncOptions) {
33
+ const result = await Internals.runActivity(activity, context, instance => instance.advance(asyncOptions.advance, bootstrap));
34
+ if (result instanceof AsyncActivityResultFulfilled)
35
+ return activity.toOutput(result.payload, ...args);
36
+ if (result instanceof AsyncActivityResultRejected)
37
+ throw new AsyncActivityRejectedError(result.payload);
38
+ throw new Error(`Async activity "${activity.constructor.name}" stayed pending after advance`);
39
+ }
40
+ if (asyncOptions?.outcome) {
41
+ switch (asyncOptions.outcome.status) {
42
+ case 'fulfilled':
43
+ return activity.toOutput(asyncOptions.outcome.output, ...args);
44
+ case 'rejected':
45
+ throw new AsyncActivityRejectedError(asyncOptions.outcome.reason);
46
+ case 'timeout': {
47
+ const onTimeout = activity.onTimeout?.bind(activity);
48
+ if (!onTimeout)
49
+ throw new Error(`Async activity "${activity.constructor.name}" timed out but defines no onTimeout handler`);
50
+ const result = await Internals.runActivity(activity, context, () => onTimeout(bootstrap));
51
+ if (result instanceof AsyncActivityResultFulfilled)
52
+ return activity.toOutput(result.payload, ...args);
53
+ if (result instanceof AsyncActivityResultRejected)
54
+ throw new AsyncActivityRejectedError(result.payload);
55
+ throw new Error(`Async activity "${activity.constructor.name}" stayed pending after onTimeout`);
56
+ }
57
+ default:
58
+ throw new Error(`Unknown async activity outcome for "${activity.constructor.name}"`);
59
+ }
60
+ }
61
+ throw new Error(`Async activity "${activity.constructor.name}" is pending. ` +
62
+ `Provide options.async.advance or options.async.outcome in ActivityTesting.run().`);
63
+ }
64
+ export class AsyncActivityRejectedError extends Error {
65
+ reason;
66
+ constructor(reason) {
67
+ super(reason instanceof Error
68
+ ? reason.message
69
+ : `Async activity rejected: ${JSON.stringify(reason)}`);
70
+ this.reason = reason;
71
+ this.name = 'AsyncActivityRejectedError';
72
+ }
73
+ }
74
+ //# sourceMappingURL=ActivityTesting.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ActivityTesting.js","sourceRoot":"","sources":["../../src/testing/ActivityTesting.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export declare class NonDeterministicWorkflowError extends Error {
2
+ constructor(message: string);
3
+ }
4
+ //# sourceMappingURL=NonDeterministicWorkflowError.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NonDeterministicWorkflowError.d.ts","sourceRoot":"","sources":["../../src/testing/NonDeterministicWorkflowError.ts"],"names":[],"mappings":"AAAA,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,OAAO,EAAE,MAAM;CAI5B"}
@@ -0,0 +1,7 @@
1
+ export class NonDeterministicWorkflowError extends Error {
2
+ constructor(message) {
3
+ super(message);
4
+ this.name = 'NonDeterministicWorkflowError';
5
+ }
6
+ }
7
+ //# sourceMappingURL=NonDeterministicWorkflowError.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NonDeterministicWorkflowError.js","sourceRoot":"","sources":["../../src/testing/NonDeterministicWorkflowError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAA;IAC7C,CAAC;CACF"}
@@ -0,0 +1,4 @@
1
+ export declare class StrictGuard {
2
+ static install(): () => void;
3
+ }
4
+ //# sourceMappingURL=StrictGuard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StrictGuard.d.ts","sourceRoot":"","sources":["../../src/testing/StrictGuard.ts"],"names":[],"mappings":"AAMA,qBAAa,WAAW;WACR,OAAO,IAAI,MAAM,IAAI;CA6BpC"}
@@ -0,0 +1,26 @@
1
+ import { ExecutionContext } from '../models/ExecutionContext.js';
2
+ import { NonDeterministicWorkflowError } from './NonDeterministicWorkflowError.js';
3
+ const WORKFLOW_SIDE_EFFECT_MESSAGE = 'Side effects must go through History.reconciler and activities — not directly from workflow code.';
4
+ export class StrictGuard {
5
+ static install() {
6
+ const originalRandom = Math.random;
7
+ const originalFetch = globalThis.fetch;
8
+ Math.random = () => {
9
+ if (ExecutionContext.isWorkflow())
10
+ throw new NonDeterministicWorkflowError(`Math.random() is not allowed in workflow code. ${WORKFLOW_SIDE_EFFECT_MESSAGE}`);
11
+ return originalRandom.call(Math);
12
+ };
13
+ if (originalFetch)
14
+ globalThis.fetch = ((...args) => {
15
+ if (ExecutionContext.isWorkflow())
16
+ throw new NonDeterministicWorkflowError(`fetch() is not allowed in workflow code. ${WORKFLOW_SIDE_EFFECT_MESSAGE}`);
17
+ return originalFetch(...args);
18
+ });
19
+ return () => {
20
+ Math.random = originalRandom;
21
+ if (originalFetch)
22
+ globalThis.fetch = originalFetch;
23
+ };
24
+ }
25
+ }
26
+ //# sourceMappingURL=StrictGuard.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StrictGuard.js","sourceRoot":"","sources":["../../src/testing/StrictGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAA;AAElF,MAAM,4BAA4B,GAChC,mGAAmG,CAAA;AAErG,MAAM,OAAO,WAAW;IACf,MAAM,CAAC,OAAO;QACnB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAA;QAClC,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAA;QAEtC,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE;YACjB,IAAI,gBAAgB,CAAC,UAAU,EAAE;gBAC/B,MAAM,IAAI,6BAA6B,CACrC,kDAAkD,4BAA4B,EAAE,CACjF,CAAA;YAEH,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC,CAAA;QAED,IAAI,aAAa;YACf,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAA8B,EAAE,EAAE;gBACxD,IAAI,gBAAgB,CAAC,UAAU,EAAE;oBAC/B,MAAM,IAAI,6BAA6B,CACrC,4CAA4C,4BAA4B,EAAE,CAC3E,CAAA;gBAEH,OAAO,aAAa,CAAC,GAAG,IAAI,CAAC,CAAA;YAC/B,CAAC,CAAiB,CAAA;QAEpB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,MAAM,GAAG,cAAc,CAAA;YAE5B,IAAI,aAAa;gBAAE,UAAU,CAAC,KAAK,GAAG,aAAa,CAAA;QACrD,CAAC,CAAA;IACH,CAAC;CACF"}
@@ -0,0 +1,12 @@
1
+ export interface TestClockRunOptions {
2
+ now?: Date | number;
3
+ }
4
+ export declare class TestClock {
5
+ static run<T>(options: TestClockRunOptions, fn: () => T): T;
6
+ static isActive(): boolean;
7
+ static now(): number;
8
+ static advance(ms: number): void;
9
+ static set(now: Date | number): void;
10
+ static sleep(ms: number): void;
11
+ }
12
+ //# sourceMappingURL=TestClock.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TestClock.d.ts","sourceRoot":"","sources":["../../src/testing/TestClock.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CACpB;AAwBD,qBAAa,SAAS;WACN,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;WA+BpD,QAAQ,IAAI,OAAO;WAInB,GAAG,IAAI,MAAM;WAIb,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;WAWzB,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI;WAW7B,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGtC"}
@@ -0,0 +1,64 @@
1
+ import { AsyncLocalStorage } from 'node:async_hooks';
2
+ const storage = new AsyncLocalStorage();
3
+ const OriginalDate = globalThis.Date;
4
+ function createPatchedDateConstructor() {
5
+ return class extends OriginalDate {
6
+ constructor(...args) {
7
+ if (args.length === 0) {
8
+ super(TestClock.now());
9
+ return;
10
+ }
11
+ super(...args);
12
+ }
13
+ static now() {
14
+ return TestClock.now();
15
+ }
16
+ };
17
+ }
18
+ export class TestClock {
19
+ static run(options, fn) {
20
+ const now = options.now instanceof Date
21
+ ? options.now.getTime()
22
+ : (options.now ?? OriginalDate.now());
23
+ return storage.run({ now }, () => {
24
+ const PatchedDate = createPatchedDateConstructor();
25
+ globalThis.Date = PatchedDate;
26
+ const finish = () => {
27
+ globalThis.Date = OriginalDate;
28
+ };
29
+ try {
30
+ const result = fn();
31
+ if (result instanceof Promise)
32
+ return result.finally(finish);
33
+ finish();
34
+ return result;
35
+ }
36
+ catch (error) {
37
+ finish();
38
+ throw error;
39
+ }
40
+ });
41
+ }
42
+ static isActive() {
43
+ return storage.getStore() !== undefined;
44
+ }
45
+ static now() {
46
+ return storage.getStore()?.now ?? OriginalDate.now();
47
+ }
48
+ static advance(ms) {
49
+ const state = storage.getStore();
50
+ if (!state)
51
+ throw new Error('TestClock.advance() must be called inside TestClock.run() or WorkflowTesting.run({ clock: ... })');
52
+ state.now += ms;
53
+ }
54
+ static set(now) {
55
+ const state = storage.getStore();
56
+ if (!state)
57
+ throw new Error('TestClock.set() must be called inside TestClock.run() or WorkflowTesting.run({ clock: ... })');
58
+ state.now = now instanceof Date ? now.getTime() : now;
59
+ }
60
+ static sleep(ms) {
61
+ TestClock.advance(ms);
62
+ }
63
+ }
64
+ //# sourceMappingURL=TestClock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TestClock.js","sourceRoot":"","sources":["../../src/testing/TestClock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAUpD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAkB,CAAA;AAEvD,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAA;AAEpC,SAAS,4BAA4B;IACnC,OAAO,KAAM,SAAQ,YAAY;QAC/B,YAAY,GAAG,IAAmC;YAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAA;gBAEtB,OAAM;YACR,CAAC;YAED,KAAK,CAAC,GAAI,IAAmD,CAAC,CAAA;QAChE,CAAC;QAEM,MAAM,CAAC,GAAG;YACf,OAAO,SAAS,CAAC,GAAG,EAAE,CAAA;QACxB,CAAC;KACiB,CAAA;AACtB,CAAC;AAED,MAAM,OAAO,SAAS;IACb,MAAM,CAAC,GAAG,CAAI,OAA4B,EAAE,EAAW;QAC5D,MAAM,GAAG,GACP,OAAO,CAAC,GAAG,YAAY,IAAI;YACzB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE;YACvB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,CAAC,CAAA;QAEzC,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE;YAC/B,MAAM,WAAW,GAAG,4BAA4B,EAAE,CAAA;YAElD,UAAU,CAAC,IAAI,GAAG,WAAW,CAAA;YAE7B,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,UAAU,CAAC,IAAI,GAAG,YAAY,CAAA;YAChC,CAAC,CAAA;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,EAAE,EAAE,CAAA;gBAEnB,IAAI,MAAM,YAAY,OAAO;oBAAE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAM,CAAA;gBAEjE,MAAM,EAAE,CAAA;gBAER,OAAO,MAAM,CAAA;YACf,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,EAAE,CAAA;gBAER,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAEM,MAAM,CAAC,QAAQ;QACpB,OAAO,OAAO,CAAC,QAAQ,EAAE,KAAK,SAAS,CAAA;IACzC,CAAC;IAEM,MAAM,CAAC,GAAG;QACf,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,CAAA;IACtD,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,EAAU;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;QAEhC,IAAI,CAAC,KAAK;YACR,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAA;QAEH,KAAK,CAAC,GAAG,IAAI,EAAE,CAAA;IACjB,CAAC;IAEM,MAAM,CAAC,GAAG,CAAC,GAAkB;QAClC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;QAEhC,IAAI,CAAC,KAAK;YACR,MAAM,IAAI,KAAK,CACb,8FAA8F,CAC/F,CAAA;QAEH,KAAK,CAAC,GAAG,GAAG,GAAG,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;IACvD,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,EAAU;QAC5B,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACvB,CAAC;CACF"}
@@ -0,0 +1,27 @@
1
+ import type { ClaimProvider } from '../models/Claim.js';
2
+ import type { Env } from '../models/Env.js';
3
+ import type { Workflow, WorkflowInput } from '../models/Workflow.js';
4
+ import type { MockAsyncActivity } from './typings/MockAsyncActivity.js';
5
+ export interface TestWorkflowEnvironmentOptions {
6
+ now?: Date | number;
7
+ resolveActivityTimeouts?: boolean;
8
+ }
9
+ export interface TestWorkflowEnvironmentExecuteOptions {
10
+ claims?: readonly ClaimProvider<any>[];
11
+ env?: Env.Entries;
12
+ mockAsyncActivity?: MockAsyncActivity;
13
+ }
14
+ export declare class TestWorkflowEnvironment {
15
+ private resolveActivityTimeouts;
16
+ private now;
17
+ private constructor();
18
+ static create(options?: TestWorkflowEnvironmentOptions): TestWorkflowEnvironment;
19
+ readonly clock: {
20
+ now: () => number;
21
+ advance: (ms: number) => void;
22
+ set: (now: Date | number) => void;
23
+ };
24
+ execute<T extends Workflow<any, any>>(workflow: T, input?: WorkflowInput<T>, options?: TestWorkflowEnvironmentExecuteOptions): Promise<unknown>;
25
+ private assertWorkflowReplays;
26
+ }
27
+ //# sourceMappingURL=TestWorkflowEnvironment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TestWorkflowEnvironment.d.ts","sourceRoot":"","sources":["../../src/testing/TestWorkflowEnvironment.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAEvE,MAAM,WAAW,8BAA8B;IAC7C,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,qCAAqC;IACpD,MAAM,CAAC,EAAE,SAAS,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;IACtC,GAAG,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACjB,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACtC;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,uBAAuB,CAAgB;IAE/C,OAAO,CAAC,GAAG,CAAY;IAEvB,OAAO;WASO,MAAM,CAClB,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB;IAI1B,SAAgB,KAAK;;sBAGL,MAAM;mBAMT,IAAI,GAAG,MAAM;MAKzB;IAEY,OAAO,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EAC/C,QAAQ,EAAE,CAAC,EACX,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,OAAO,GAAE,qCAA0C;YAgCvC,qBAAqB;CAsBpC"}
@@ -0,0 +1,62 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { NonDeterministicWorkflowError } from './exceptions/NonDeterministicWorkflowError.js';
3
+ import { TestClock } from './TestClock.js';
4
+ import { runWorkflow } from './tools/run-workflow.js';
5
+ import { Internals } from '../tools/Internals.js';
6
+ export class TestWorkflowEnvironment {
7
+ resolveActivityTimeouts = true;
8
+ now = 0;
9
+ constructor(options) {
10
+ if (options.now)
11
+ this.now =
12
+ options.now instanceof Date ? options.now.getTime() : options.now;
13
+ if (typeof options.resolveActivityTimeouts === 'boolean')
14
+ this.resolveActivityTimeouts = options.resolveActivityTimeouts;
15
+ }
16
+ static create(options = {}) {
17
+ return new TestWorkflowEnvironment(options);
18
+ }
19
+ clock = {
20
+ now: () => this.now,
21
+ advance: (ms) => {
22
+ this.now += ms;
23
+ if (TestClock.isActive())
24
+ TestClock.advance(ms);
25
+ },
26
+ set: (now) => {
27
+ this.now = now instanceof Date ? now.getTime() : now;
28
+ if (TestClock.isActive())
29
+ TestClock.set(now);
30
+ },
31
+ };
32
+ async execute(workflow, input, options = {}) {
33
+ const runWorkflowOptions = {
34
+ claims: options.claims ?? [],
35
+ env: options.env ?? {},
36
+ history: [],
37
+ logs: [],
38
+ clock: { now: this.now },
39
+ resolveActivityTimeouts: this.resolveActivityTimeouts,
40
+ };
41
+ if (options.mockAsyncActivity !== undefined)
42
+ runWorkflowOptions.mockAsyncActivity = options.mockAsyncActivity;
43
+ const result = await runWorkflow(workflow, input, runWorkflowOptions);
44
+ if (result.clockNow !== undefined)
45
+ this.now = result.clockNow;
46
+ await this.assertWorkflowReplays(workflow, input, result.output, runWorkflowOptions);
47
+ return result.output;
48
+ }
49
+ async assertWorkflowReplays(workflow, input, output, context) {
50
+ const replay = await TestClock.run({ now: this.now }, () => Internals.runWorkflow(workflow, {
51
+ input,
52
+ claims: context.claims,
53
+ env: context.env,
54
+ history: structuredClone(context.history),
55
+ logs: [],
56
+ }));
57
+ if (isDeepStrictEqual(output, replay))
58
+ return;
59
+ throw new NonDeterministicWorkflowError('Replay from recorded history produced a different workflow output.');
60
+ }
61
+ }
62
+ //# sourceMappingURL=TestWorkflowEnvironment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TestWorkflowEnvironment.js","sourceRoot":"","sources":["../../src/testing/TestWorkflowEnvironment.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  import { type RunWorkflowOptions } from './run-workflow.js';
2
2
  import type { Workflow, WorkflowInput } from '../models/Workflow.js';
3
3
  export declare class WorkflowTesting {
4
- static run<T extends Workflow<any, any>>(workflow: T, input?: WorkflowInput<T>, options?: RunWorkflowOptions): Promise<any>;
4
+ static run<T extends Workflow<any, any>>(workflow: T, input?: WorkflowInput<T>, options?: RunWorkflowOptions): Promise<unknown>;
5
5
  }
6
6
  //# sourceMappingURL=WorkflowTesting.d.ts.map
@@ -0,0 +1,12 @@
1
+ export declare function fulfilled<T>(output?: T): {
2
+ status: 'fulfilled';
3
+ output?: T;
4
+ };
5
+ export declare function rejected(reason?: unknown): {
6
+ status: 'rejected';
7
+ reason?: unknown;
8
+ };
9
+ export declare function timeout(): {
10
+ status: 'timeout';
11
+ };
12
+ //# sourceMappingURL=async-activity-results.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"async-activity-results.d.ts","sourceRoot":"","sources":["../../src/testing/async-activity-results.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,CAE5E;AAED,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG;IAC1C,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAEA;AAED,wBAAgB,OAAO,IAAI;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAE/C"}
@@ -0,0 +1,10 @@
1
+ export function fulfilled(output) {
2
+ return { status: 'fulfilled', output };
3
+ }
4
+ export function rejected(reason) {
5
+ return { status: 'rejected', reason };
6
+ }
7
+ export function timeout() {
8
+ return { status: 'timeout' };
9
+ }
10
+ //# sourceMappingURL=async-activity-results.js.map