quantam-async 0.1.0 → 0.1.1
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/.github/workflows/npm-publish.yml +29 -0
- package/LICENSE +22 -22
- package/README.md +16 -0
- package/dist/core.d.ts +1 -0
- package/dist/core.d.ts.map +1 -1
- package/dist/core.js +21 -1
- package/dist/core.js.map +1 -1
- package/dist/tests/quantam.test.js +27 -0
- package/dist/tests/quantam.test.js.map +1 -1
- package/dist/types.d.ts +2 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/core.ts +26 -1
- package/src/tests/quantam.test.ts +104 -74
- package/src/types.ts +2 -0
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# This workflow will run tests and publish a package to npm when a release is created
|
|
2
|
+
# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
|
|
3
|
+
|
|
4
|
+
name: Node.js Package
|
|
5
|
+
|
|
6
|
+
on:
|
|
7
|
+
release:
|
|
8
|
+
types: [created]
|
|
9
|
+
push:
|
|
10
|
+
branches: [main, master]
|
|
11
|
+
|
|
12
|
+
jobs:
|
|
13
|
+
build-and-publish:
|
|
14
|
+
runs-on: ubuntu-latest
|
|
15
|
+
environment: NPM
|
|
16
|
+
steps:
|
|
17
|
+
- uses: actions/checkout@v4
|
|
18
|
+
- uses: actions/setup-node@v4
|
|
19
|
+
with:
|
|
20
|
+
node-version: 20
|
|
21
|
+
registry-url: https://registry.npmjs.org/
|
|
22
|
+
cache: npm
|
|
23
|
+
|
|
24
|
+
- run: npm ci
|
|
25
|
+
- run: npm run build
|
|
26
|
+
- run: npm test
|
|
27
|
+
- run: npm publish
|
|
28
|
+
env:
|
|
29
|
+
NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
|
package/LICENSE
CHANGED
|
@@ -1,22 +1,22 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 Quantam contributors
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
22
|
-
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Quantam contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
22
|
+
|
package/README.md
CHANGED
|
@@ -131,6 +131,21 @@ flow
|
|
|
131
131
|
.stepTimeout(200); // only this step is limited to 200ms
|
|
132
132
|
```
|
|
133
133
|
|
|
134
|
+
### `.name(label)`
|
|
135
|
+
|
|
136
|
+
Assign a name to the most recent step for better error messages and debugging.
|
|
137
|
+
|
|
138
|
+
```typescript
|
|
139
|
+
flow
|
|
140
|
+
.step(validateInput)
|
|
141
|
+
.name('validateInput')
|
|
142
|
+
.step(processData)
|
|
143
|
+
.name('processData');
|
|
144
|
+
|
|
145
|
+
// If validateInput fails, error will include "(at step 'validateInput')"
|
|
146
|
+
// The step name is also available in the context: context.stepName
|
|
147
|
+
```
|
|
148
|
+
|
|
134
149
|
### `.withSignal(signal)`
|
|
135
150
|
|
|
136
151
|
Bind an AbortSignal to the flow for reuse.
|
|
@@ -191,6 +206,7 @@ controller.abort();
|
|
|
191
206
|
|
|
192
207
|
## Version
|
|
193
208
|
|
|
209
|
+
**v0.1.1** — Added step naming for better error messages and debugging.
|
|
194
210
|
**v0.1.0** — Core features only. API subject to change.
|
|
195
211
|
|
|
196
212
|
## License
|
package/dist/core.d.ts
CHANGED
|
@@ -9,6 +9,7 @@ export declare class Quantam<T = any> implements Flow<T> {
|
|
|
9
9
|
private abortSignal?;
|
|
10
10
|
step<R>(fn: AsyncFn<T, R>): Quantam<R>;
|
|
11
11
|
parallel<R>(fns: AsyncFn<T, any>[]): Quantam<R[]>;
|
|
12
|
+
name(label: string): Quantam<T>;
|
|
12
13
|
retry(count: number, delayMs?: number): Quantam<T>;
|
|
13
14
|
stepTimeout(ms: number): Quantam<T>;
|
|
14
15
|
withSignal(signal: AbortSignal): Quantam<T>;
|
package/dist/core.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAoB,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAoB,MAAM,SAAS,CAAC;AAYvE,qBAAa,OAAO,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,IAAI,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAc;IAElC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAStC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IASjD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAc/B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,CAAC,CAAC;IAevD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAcnC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ3C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQzB,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAiCpF,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;YAyCxC,iBAAiB;YA+CjB,oBAAoB;IAelC,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,KAAK;CAiBd;AAED,wBAAgB,OAAO,CAAC,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAE7C"}
|
package/dist/core.js
CHANGED
|
@@ -26,6 +26,17 @@ class Quantam {
|
|
|
26
26
|
newFlow.steps.push({ type: 'parallel', fns });
|
|
27
27
|
return newFlow;
|
|
28
28
|
}
|
|
29
|
+
name(label) {
|
|
30
|
+
const newFlow = new Quantam();
|
|
31
|
+
newFlow.steps = [...this.steps];
|
|
32
|
+
newFlow.timeoutMs = this.timeoutMs;
|
|
33
|
+
newFlow.abortSignal = this.abortSignal;
|
|
34
|
+
if (newFlow.steps.length > 0) {
|
|
35
|
+
const lastStep = newFlow.steps[newFlow.steps.length - 1];
|
|
36
|
+
lastStep.name = label;
|
|
37
|
+
}
|
|
38
|
+
return newFlow;
|
|
39
|
+
}
|
|
29
40
|
retry(count, delayMs = 100) {
|
|
30
41
|
const newFlow = new Quantam();
|
|
31
42
|
newFlow.steps = [...this.steps];
|
|
@@ -103,6 +114,7 @@ class Quantam {
|
|
|
103
114
|
this.checkAborted(signal);
|
|
104
115
|
const step = this.steps[i];
|
|
105
116
|
context.stepIndex = i;
|
|
117
|
+
context.stepName = step.name;
|
|
106
118
|
context.retryCount = 0;
|
|
107
119
|
if (step.type === 'single' && step.fn) {
|
|
108
120
|
result = await this.executeSingleStep(step.fn, result, context, step.retries || 0, step.retryDelay || 100, step.timeout);
|
|
@@ -137,7 +149,15 @@ class Quantam {
|
|
|
137
149
|
}
|
|
138
150
|
}
|
|
139
151
|
}
|
|
140
|
-
|
|
152
|
+
if (lastError) {
|
|
153
|
+
const stepLabel = context.stepName ? ` '${context.stepName}'` : '';
|
|
154
|
+
if (stepLabel && !lastError.message.includes(stepLabel)) {
|
|
155
|
+
lastError.message = `${lastError.message} (at step${stepLabel})`;
|
|
156
|
+
}
|
|
157
|
+
throw lastError;
|
|
158
|
+
}
|
|
159
|
+
const stepLabel = context.stepName ? ` '${context.stepName}'` : '';
|
|
160
|
+
throw new Error(`Step${stepLabel} execution failed`);
|
|
141
161
|
}
|
|
142
162
|
async executeParallelSteps(fns, input, context, retries, retryDelay, stepTimeout) {
|
|
143
163
|
const promises = fns.map((fn) => this.executeSingleStep(fn, input, context, retries, retryDelay, stepTimeout));
|
package/dist/core.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;
|
|
1
|
+
{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}
|
|
@@ -63,4 +63,31 @@ const index_1 = require("../index");
|
|
|
63
63
|
strict_1.default.deepEqual(results, inputs.map((n) => n + 1));
|
|
64
64
|
strict_1.default.ok(maxInFlight <= concurrencyLimit);
|
|
65
65
|
});
|
|
66
|
+
(0, node_test_1.default)('step names appear in error messages', async () => {
|
|
67
|
+
const flow = (0, index_1.quantam)().step(async (n) => {
|
|
68
|
+
if (true)
|
|
69
|
+
throw new Error('validation failed');
|
|
70
|
+
return n;
|
|
71
|
+
}).name('validateInput');
|
|
72
|
+
let threw = false;
|
|
73
|
+
let errorMessage = '';
|
|
74
|
+
try {
|
|
75
|
+
await flow.run(1);
|
|
76
|
+
}
|
|
77
|
+
catch (err) {
|
|
78
|
+
threw = true;
|
|
79
|
+
errorMessage = err.message;
|
|
80
|
+
}
|
|
81
|
+
strict_1.default.equal(threw, true);
|
|
82
|
+
strict_1.default.match(errorMessage, /validateInput/);
|
|
83
|
+
});
|
|
84
|
+
(0, node_test_1.default)('step name passed in context', async () => {
|
|
85
|
+
let capturedName = '';
|
|
86
|
+
const flow = (0, index_1.quantam)().step(async (n, ctx) => {
|
|
87
|
+
capturedName = ctx?.stepName ?? '';
|
|
88
|
+
return n + 1;
|
|
89
|
+
}).name('processData');
|
|
90
|
+
await flow.run(1);
|
|
91
|
+
strict_1.default.equal(capturedName, 'processData');
|
|
92
|
+
});
|
|
66
93
|
//# sourceMappingURL=quantam.test.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"quantam.test.js","sourceRoot":"","sources":["../../src/tests/quantam.test.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"quantam.test.js","sourceRoot":"","sources":["../../src/tests/quantam.test.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -6,6 +6,7 @@ export interface ExecutionContext {
|
|
|
6
6
|
signal?: AbortSignal;
|
|
7
7
|
retryCount?: number;
|
|
8
8
|
stepIndex?: number;
|
|
9
|
+
stepName?: string;
|
|
9
10
|
}
|
|
10
11
|
export interface FlowOptions {
|
|
11
12
|
signal?: AbortSignal;
|
|
@@ -16,6 +17,7 @@ export interface RunManyOptions extends FlowOptions {
|
|
|
16
17
|
export interface Flow<T = any> {
|
|
17
18
|
step<R>(fn: AsyncFn<T, R>): Flow<R>;
|
|
18
19
|
parallel<R>(fns: AsyncFn<T, any>[]): Flow<R[]>;
|
|
20
|
+
name(label: string): Flow<T>;
|
|
19
21
|
retry(count: number, delayMs?: number): Flow<T>;
|
|
20
22
|
timeout(ms: number): Flow<T>;
|
|
21
23
|
stepTimeout(ms: number): Flow<T>;
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7F,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7F,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,GAAG;IAC3B,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "quantam-async",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "A lightweight async workflow engine for composing, running, and controlling complex task pipelines with retries, parallelism, timeouts, and cancellation.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
package/src/core.ts
CHANGED
|
@@ -12,6 +12,7 @@ interface Step {
|
|
|
12
12
|
retries?: number;
|
|
13
13
|
retryDelay?: number;
|
|
14
14
|
timeout?: number;
|
|
15
|
+
name?: string;
|
|
15
16
|
}
|
|
16
17
|
|
|
17
18
|
export class Quantam<T = any> implements Flow<T> {
|
|
@@ -37,6 +38,20 @@ export class Quantam<T = any> implements Flow<T> {
|
|
|
37
38
|
return newFlow;
|
|
38
39
|
}
|
|
39
40
|
|
|
41
|
+
name(label: string): Quantam<T> {
|
|
42
|
+
const newFlow = new Quantam<T>();
|
|
43
|
+
newFlow.steps = [...this.steps];
|
|
44
|
+
newFlow.timeoutMs = this.timeoutMs;
|
|
45
|
+
newFlow.abortSignal = this.abortSignal;
|
|
46
|
+
|
|
47
|
+
if (newFlow.steps.length > 0) {
|
|
48
|
+
const lastStep = newFlow.steps[newFlow.steps.length - 1];
|
|
49
|
+
lastStep.name = label;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
return newFlow;
|
|
53
|
+
}
|
|
54
|
+
|
|
40
55
|
retry(count: number, delayMs: number = 100): Quantam<T> {
|
|
41
56
|
const newFlow = new Quantam<T>();
|
|
42
57
|
newFlow.steps = [...this.steps];
|
|
@@ -129,6 +144,7 @@ export class Quantam<T = any> implements Flow<T> {
|
|
|
129
144
|
|
|
130
145
|
const step = this.steps[i];
|
|
131
146
|
context.stepIndex = i;
|
|
147
|
+
context.stepName = step.name;
|
|
132
148
|
context.retryCount = 0;
|
|
133
149
|
|
|
134
150
|
if (step.type === 'single' && step.fn) {
|
|
@@ -190,7 +206,16 @@ export class Quantam<T = any> implements Flow<T> {
|
|
|
190
206
|
}
|
|
191
207
|
}
|
|
192
208
|
|
|
193
|
-
|
|
209
|
+
if (lastError) {
|
|
210
|
+
const stepLabel = context.stepName ? ` '${context.stepName}'` : '';
|
|
211
|
+
if (stepLabel && !lastError.message.includes(stepLabel)) {
|
|
212
|
+
lastError.message = `${lastError.message} (at step${stepLabel})`;
|
|
213
|
+
}
|
|
214
|
+
throw lastError;
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
const stepLabel = context.stepName ? ` '${context.stepName}'` : '';
|
|
218
|
+
throw new Error(`Step${stepLabel} execution failed`);
|
|
194
219
|
}
|
|
195
220
|
|
|
196
221
|
private async executeParallelSteps(
|
|
@@ -1,74 +1,104 @@
|
|
|
1
|
-
import test from 'node:test';
|
|
2
|
-
import assert from 'node:assert/strict';
|
|
3
|
-
import { quantam } from '../index';
|
|
4
|
-
|
|
5
|
-
test('runs basic sequential pipeline', async () => {
|
|
6
|
-
const flow = quantam<number>()
|
|
7
|
-
.step(async (n) => n + 1)
|
|
8
|
-
.step(async (n) => n * 2);
|
|
9
|
-
|
|
10
|
-
const result = await flow.run(1);
|
|
11
|
-
assert.equal(result, 4);
|
|
12
|
-
});
|
|
13
|
-
|
|
14
|
-
test('retries and exposes retryCount', async () => {
|
|
15
|
-
let attempts = 0;
|
|
16
|
-
|
|
17
|
-
const flow = quantam<number>()
|
|
18
|
-
.step(async (n, ctx) => {
|
|
19
|
-
attempts++;
|
|
20
|
-
if ((ctx?.retryCount ?? 0) < 2) {
|
|
21
|
-
throw new Error('transient');
|
|
22
|
-
}
|
|
23
|
-
return n + (ctx?.retryCount ?? 0);
|
|
24
|
-
})
|
|
25
|
-
.retry(3, 1);
|
|
26
|
-
|
|
27
|
-
const result = await flow.run(1);
|
|
28
|
-
assert.equal(result, 3);
|
|
29
|
-
assert.equal(attempts, 3);
|
|
30
|
-
});
|
|
31
|
-
|
|
32
|
-
test('stepTimeout rejects slow step', async () => {
|
|
33
|
-
const flow = quantam<number>()
|
|
34
|
-
.step(async (n) => {
|
|
35
|
-
await new Promise((resolve) => setTimeout(resolve, 20));
|
|
36
|
-
return n + 1;
|
|
37
|
-
})
|
|
38
|
-
.stepTimeout(5);
|
|
39
|
-
|
|
40
|
-
let threw = false;
|
|
41
|
-
try {
|
|
42
|
-
await flow.run(1);
|
|
43
|
-
} catch (err) {
|
|
44
|
-
threw = true;
|
|
45
|
-
assert.match((err as Error).message, /Timeout/);
|
|
46
|
-
}
|
|
47
|
-
assert.equal(threw, true);
|
|
48
|
-
});
|
|
49
|
-
|
|
50
|
-
test('runMany respects concurrency limit', async () => {
|
|
51
|
-
const concurrencyLimit = 4;
|
|
52
|
-
let inFlight = 0;
|
|
53
|
-
let maxInFlight = 0;
|
|
54
|
-
|
|
55
|
-
const flow = quantam<number>().step(async (n) => {
|
|
56
|
-
inFlight++;
|
|
57
|
-
if (inFlight > maxInFlight) {
|
|
58
|
-
maxInFlight = inFlight;
|
|
59
|
-
}
|
|
60
|
-
await new Promise((resolve) => setTimeout(resolve, 5));
|
|
61
|
-
inFlight--;
|
|
62
|
-
return n + 1;
|
|
63
|
-
});
|
|
64
|
-
|
|
65
|
-
const inputs = Array.from({ length: 16 }, (_, i) => i);
|
|
66
|
-
const results = await flow.runMany(inputs, { concurrency: concurrencyLimit });
|
|
67
|
-
|
|
68
|
-
assert.deepEqual(
|
|
69
|
-
results,
|
|
70
|
-
inputs.map((n) => n + 1),
|
|
71
|
-
);
|
|
72
|
-
assert.ok(maxInFlight <= concurrencyLimit);
|
|
73
|
-
});
|
|
74
|
-
|
|
1
|
+
import test from 'node:test';
|
|
2
|
+
import assert from 'node:assert/strict';
|
|
3
|
+
import { quantam } from '../index';
|
|
4
|
+
|
|
5
|
+
test('runs basic sequential pipeline', async () => {
|
|
6
|
+
const flow = quantam<number>()
|
|
7
|
+
.step(async (n) => n + 1)
|
|
8
|
+
.step(async (n) => n * 2);
|
|
9
|
+
|
|
10
|
+
const result = await flow.run(1);
|
|
11
|
+
assert.equal(result, 4);
|
|
12
|
+
});
|
|
13
|
+
|
|
14
|
+
test('retries and exposes retryCount', async () => {
|
|
15
|
+
let attempts = 0;
|
|
16
|
+
|
|
17
|
+
const flow = quantam<number>()
|
|
18
|
+
.step(async (n, ctx) => {
|
|
19
|
+
attempts++;
|
|
20
|
+
if ((ctx?.retryCount ?? 0) < 2) {
|
|
21
|
+
throw new Error('transient');
|
|
22
|
+
}
|
|
23
|
+
return n + (ctx?.retryCount ?? 0);
|
|
24
|
+
})
|
|
25
|
+
.retry(3, 1);
|
|
26
|
+
|
|
27
|
+
const result = await flow.run(1);
|
|
28
|
+
assert.equal(result, 3);
|
|
29
|
+
assert.equal(attempts, 3);
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
test('stepTimeout rejects slow step', async () => {
|
|
33
|
+
const flow = quantam<number>()
|
|
34
|
+
.step(async (n) => {
|
|
35
|
+
await new Promise((resolve) => setTimeout(resolve, 20));
|
|
36
|
+
return n + 1;
|
|
37
|
+
})
|
|
38
|
+
.stepTimeout(5);
|
|
39
|
+
|
|
40
|
+
let threw = false;
|
|
41
|
+
try {
|
|
42
|
+
await flow.run(1);
|
|
43
|
+
} catch (err) {
|
|
44
|
+
threw = true;
|
|
45
|
+
assert.match((err as Error).message, /Timeout/);
|
|
46
|
+
}
|
|
47
|
+
assert.equal(threw, true);
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
test('runMany respects concurrency limit', async () => {
|
|
51
|
+
const concurrencyLimit = 4;
|
|
52
|
+
let inFlight = 0;
|
|
53
|
+
let maxInFlight = 0;
|
|
54
|
+
|
|
55
|
+
const flow = quantam<number>().step(async (n) => {
|
|
56
|
+
inFlight++;
|
|
57
|
+
if (inFlight > maxInFlight) {
|
|
58
|
+
maxInFlight = inFlight;
|
|
59
|
+
}
|
|
60
|
+
await new Promise((resolve) => setTimeout(resolve, 5));
|
|
61
|
+
inFlight--;
|
|
62
|
+
return n + 1;
|
|
63
|
+
});
|
|
64
|
+
|
|
65
|
+
const inputs = Array.from({ length: 16 }, (_, i) => i);
|
|
66
|
+
const results = await flow.runMany(inputs, { concurrency: concurrencyLimit });
|
|
67
|
+
|
|
68
|
+
assert.deepEqual(
|
|
69
|
+
results,
|
|
70
|
+
inputs.map((n) => n + 1),
|
|
71
|
+
);
|
|
72
|
+
assert.ok(maxInFlight <= concurrencyLimit);
|
|
73
|
+
});
|
|
74
|
+
|
|
75
|
+
test('step names appear in error messages', async () => {
|
|
76
|
+
const flow = quantam<number>().step(async (n: number) => {
|
|
77
|
+
if (true) throw new Error('validation failed');
|
|
78
|
+
return n;
|
|
79
|
+
}).name('validateInput');
|
|
80
|
+
|
|
81
|
+
let threw = false;
|
|
82
|
+
let errorMessage = '';
|
|
83
|
+
try {
|
|
84
|
+
await flow.run(1);
|
|
85
|
+
} catch (err) {
|
|
86
|
+
threw = true;
|
|
87
|
+
errorMessage = (err as Error).message;
|
|
88
|
+
}
|
|
89
|
+
assert.equal(threw, true);
|
|
90
|
+
assert.match(errorMessage, /validateInput/);
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
test('step name passed in context', async () => {
|
|
94
|
+
let capturedName = '';
|
|
95
|
+
|
|
96
|
+
const flow = quantam<number>().step(async (n, ctx) => {
|
|
97
|
+
capturedName = ctx?.stepName ?? '';
|
|
98
|
+
return n + 1;
|
|
99
|
+
}).name('processData');
|
|
100
|
+
|
|
101
|
+
await flow.run(1);
|
|
102
|
+
assert.equal(capturedName, 'processData');
|
|
103
|
+
});
|
|
104
|
+
|
package/src/types.ts
CHANGED
|
@@ -8,6 +8,7 @@ export interface ExecutionContext {
|
|
|
8
8
|
signal?: AbortSignal;
|
|
9
9
|
retryCount?: number;
|
|
10
10
|
stepIndex?: number;
|
|
11
|
+
stepName?: string;
|
|
11
12
|
}
|
|
12
13
|
|
|
13
14
|
export interface FlowOptions {
|
|
@@ -21,6 +22,7 @@ export interface RunManyOptions extends FlowOptions {
|
|
|
21
22
|
export interface Flow<T = any> {
|
|
22
23
|
step<R>(fn: AsyncFn<T, R>): Flow<R>;
|
|
23
24
|
parallel<R>(fns: AsyncFn<T, any>[]): Flow<R[]>;
|
|
25
|
+
name(label: string): Flow<T>;
|
|
24
26
|
retry(count: number, delayMs?: number): Flow<T>;
|
|
25
27
|
timeout(ms: number): Flow<T>;
|
|
26
28
|
stepTimeout(ms: number): Flow<T>;
|