@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.
- package/.ai/skills/framework-core/SKILL.md +103 -287
- package/.ai/skills/framework-workflow-creation/SKILL.md +108 -60
- package/.ai/skills/framework-workflow-testing/SKILL.md +165 -111
- package/README.md +123 -37
- package/dist/models/ExecutionContext.d.ts +8 -0
- package/dist/models/ExecutionContext.d.ts.map +1 -0
- package/dist/models/ExecutionContext.js +22 -0
- package/dist/models/ExecutionContext.js.map +1 -0
- package/dist/testing/ActivityTesting.d.ts +25 -0
- package/dist/testing/ActivityTesting.d.ts.map +1 -0
- package/dist/testing/ActivityTesting.js +74 -0
- package/dist/testing/ActivityTesting.js.map +1 -0
- package/dist/testing/NonDeterministicWorkflowError.d.ts +4 -0
- package/dist/testing/NonDeterministicWorkflowError.d.ts.map +1 -0
- package/dist/testing/NonDeterministicWorkflowError.js +7 -0
- package/dist/testing/NonDeterministicWorkflowError.js.map +1 -0
- package/dist/testing/StrictGuard.d.ts +4 -0
- package/dist/testing/StrictGuard.d.ts.map +1 -0
- package/dist/testing/StrictGuard.js +26 -0
- package/dist/testing/StrictGuard.js.map +1 -0
- package/dist/testing/TestClock.d.ts +12 -0
- package/dist/testing/TestClock.d.ts.map +1 -0
- package/dist/testing/TestClock.js +64 -0
- package/dist/testing/TestClock.js.map +1 -0
- package/dist/testing/TestWorkflowEnvironment.d.ts +27 -0
- package/dist/testing/TestWorkflowEnvironment.d.ts.map +1 -0
- package/dist/testing/TestWorkflowEnvironment.js +62 -0
- package/dist/testing/TestWorkflowEnvironment.js.map +1 -0
- package/dist/testing/WorkflowTesting.d.ts +1 -1
- package/dist/testing/async-activity-results.d.ts +12 -0
- package/dist/testing/async-activity-results.d.ts.map +1 -0
- package/dist/testing/async-activity-results.js +10 -0
- package/dist/testing/async-activity-results.js.map +1 -0
- package/dist/testing/create-mock-claim.d.ts +11 -0
- package/dist/testing/create-mock-claim.d.ts.map +1 -0
- package/dist/testing/create-mock-claim.js +26 -0
- package/dist/testing/create-mock-claim.js.map +1 -0
- package/dist/testing/create-mock-claims.d.ts +13 -0
- package/dist/testing/create-mock-claims.d.ts.map +1 -0
- package/dist/testing/create-mock-claims.js +8 -0
- package/dist/testing/create-mock-claims.js.map +1 -0
- package/dist/testing/create-test-env.d.ts +10 -0
- package/dist/testing/create-test-env.d.ts.map +1 -0
- package/dist/testing/create-test-env.js +7 -0
- package/dist/testing/create-test-env.js.map +1 -0
- package/dist/testing/exceptions/NonDeterministicWorkflowError.d.ts +4 -0
- package/dist/testing/exceptions/NonDeterministicWorkflowError.d.ts.map +1 -0
- package/dist/testing/exceptions/NonDeterministicWorkflowError.js +7 -0
- package/dist/testing/exceptions/NonDeterministicWorkflowError.js.map +1 -0
- package/dist/testing/index.d.ts +8 -1
- package/dist/testing/index.d.ts.map +1 -1
- package/dist/testing/index.js +8 -1
- package/dist/testing/index.js.map +1 -1
- package/dist/testing/mock-async.d.ts +48 -0
- package/dist/testing/mock-async.d.ts.map +1 -0
- package/dist/testing/mock-async.js +58 -0
- package/dist/testing/mock-async.js.map +1 -0
- package/dist/testing/outcomes.d.ts +12 -0
- package/dist/testing/outcomes.d.ts.map +1 -0
- package/dist/testing/outcomes.js +10 -0
- package/dist/testing/outcomes.js.map +1 -0
- package/dist/testing/run-workflow.d.ts +22 -21
- package/dist/testing/run-workflow.d.ts.map +1 -1
- package/dist/testing/run-workflow.js +47 -23
- package/dist/testing/run-workflow.js.map +1 -1
- package/dist/testing/tools/create-mock-claim.d.ts +5 -0
- package/dist/testing/tools/create-mock-claim.d.ts.map +1 -0
- package/dist/testing/tools/create-mock-claim.js +26 -0
- package/dist/testing/tools/create-mock-claim.js.map +1 -0
- package/dist/testing/tools/create-mock-claims.d.ts +8 -0
- package/dist/testing/tools/create-mock-claims.d.ts.map +1 -0
- package/dist/testing/tools/create-mock-claims.js +5 -0
- package/dist/testing/tools/create-mock-claims.js.map +1 -0
- package/dist/testing/tools/create-test-env.d.ts +4 -0
- package/dist/testing/tools/create-test-env.d.ts.map +1 -0
- package/dist/testing/tools/create-test-env.js +7 -0
- package/dist/testing/tools/create-test-env.js.map +1 -0
- package/dist/testing/tools/mock-async.d.ts +20 -0
- package/dist/testing/tools/mock-async.d.ts.map +1 -0
- package/dist/testing/tools/mock-async.js +57 -0
- package/dist/testing/tools/mock-async.js.map +1 -0
- package/dist/testing/tools/resolve-activity.d.ts +11 -0
- package/dist/testing/tools/resolve-activity.d.ts.map +1 -0
- package/dist/testing/tools/resolve-activity.js +23 -0
- package/dist/testing/tools/resolve-activity.js.map +1 -0
- package/dist/testing/tools/resolve-async-activity.d.ts +15 -0
- package/dist/testing/tools/resolve-async-activity.d.ts.map +1 -0
- package/dist/testing/tools/resolve-async-activity.js +69 -0
- package/dist/testing/tools/resolve-async-activity.js.map +1 -0
- package/dist/testing/tools/run-with-clock.d.ts +3 -0
- package/dist/testing/tools/run-with-clock.d.ts.map +1 -0
- package/dist/testing/tools/run-with-clock.js +7 -0
- package/dist/testing/tools/run-with-clock.js.map +1 -0
- package/dist/testing/tools/run-workflow-ticks.d.ts +8 -0
- package/dist/testing/tools/run-workflow-ticks.d.ts.map +1 -0
- package/dist/testing/tools/run-workflow-ticks.js +26 -0
- package/dist/testing/tools/run-workflow-ticks.js.map +1 -0
- package/dist/testing/tools/run-workflow.d.ts +25 -0
- package/dist/testing/tools/run-workflow.d.ts.map +1 -0
- package/dist/testing/tools/run-workflow.js +25 -0
- package/dist/testing/tools/run-workflow.js.map +1 -0
- package/dist/testing/types.d.ts +19 -0
- package/dist/testing/types.d.ts.map +1 -0
- package/dist/testing/types.js +2 -0
- package/dist/testing/types.js.map +1 -0
- package/dist/testing/typings/AsyncActivityResult.d.ts +10 -0
- package/dist/testing/typings/AsyncActivityResult.d.ts.map +1 -0
- package/dist/testing/typings/AsyncActivityResult.js +2 -0
- package/dist/testing/typings/AsyncActivityResult.js.map +1 -0
- package/dist/testing/typings/ClaimConstructor.d.ts +2 -0
- package/dist/testing/typings/ClaimConstructor.d.ts.map +1 -0
- package/dist/testing/typings/ClaimConstructor.js +2 -0
- package/dist/testing/typings/ClaimConstructor.js.map +1 -0
- package/dist/testing/typings/MockAsyncActivity.d.ts +10 -0
- package/dist/testing/typings/MockAsyncActivity.d.ts.map +1 -0
- package/dist/testing/typings/MockAsyncActivity.js +2 -0
- package/dist/testing/typings/MockAsyncActivity.js.map +1 -0
- 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 {
|
|
359
|
+
import {
|
|
360
|
+
TestWorkflowEnvironment,
|
|
361
|
+
mockAsync,
|
|
362
|
+
fulfilled,
|
|
363
|
+
createMockClaims,
|
|
364
|
+
mockClaim,
|
|
365
|
+
} from '@t4h.framework/core/testing'
|
|
360
366
|
|
|
361
|
-
const
|
|
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
|
-
|
|
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`,
|
|
374
|
-
`
|
|
375
|
-
|
|
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
|
-
|
|
403
|
+
Use the `mockAsync()` builder to declare outcomes per activity type:
|
|
378
404
|
|
|
379
405
|
```typescript
|
|
380
|
-
|
|
381
|
-
|
|
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
|
-
|
|
384
|
-
mockAsyncActivity: () => ({ status: 'rejected', reason: 'denied' })
|
|
434
|
+
Outcome helpers:
|
|
385
435
|
|
|
386
|
-
|
|
387
|
-
|
|
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
|
-
|
|
391
|
-
|
|
442
|
+
### Mock claims
|
|
443
|
+
|
|
444
|
+
Use `mockClaim` and `createMockClaims` to build typed claim providers without
|
|
445
|
+
manual casts:
|
|
392
446
|
|
|
393
447
|
```typescript
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
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
|
-
|
|
402
|
-
|
|
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
|
-
|
|
406
|
-
|
|
407
|
-
|
|
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
|
-
|
|
473
|
+
For direct clock control outside an environment, use `TestClock`:
|
|
410
474
|
|
|
411
|
-
|
|
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
|
-
|
|
416
|
-
`resolveAsyncActivitiesInOrder([...])` from `@t4h.framework/core/testing`.
|
|
499
|
+
### Env helpers
|
|
417
500
|
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
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 @@
|
|
|
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 @@
|
|
|
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 @@
|
|
|
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<
|
|
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
|