@sonamu-kit/tasks 0.2.0 → 0.3.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 (215) hide show
  1. package/.oxlintrc.json +3 -0
  2. package/AGENTS.md +21 -0
  3. package/dist/backend.d.ts +126 -107
  4. package/dist/backend.d.ts.map +1 -1
  5. package/dist/backend.js +4 -1
  6. package/dist/backend.js.map +1 -1
  7. package/dist/client.d.ts +145 -132
  8. package/dist/client.d.ts.map +1 -1
  9. package/dist/client.js +219 -213
  10. package/dist/client.js.map +1 -1
  11. package/dist/config.d.ts +15 -8
  12. package/dist/config.d.ts.map +1 -1
  13. package/dist/config.js +22 -17
  14. package/dist/config.js.map +1 -1
  15. package/dist/core/duration.d.ts +5 -4
  16. package/dist/core/duration.d.ts.map +1 -1
  17. package/dist/core/duration.js +54 -59
  18. package/dist/core/duration.js.map +1 -1
  19. package/dist/core/error.d.ts +10 -7
  20. package/dist/core/error.d.ts.map +1 -1
  21. package/dist/core/error.js +21 -21
  22. package/dist/core/error.js.map +1 -1
  23. package/dist/core/json.d.ts +8 -3
  24. package/dist/core/json.d.ts.map +1 -1
  25. package/dist/core/result.d.ts +10 -14
  26. package/dist/core/result.d.ts.map +1 -1
  27. package/dist/core/result.js +21 -16
  28. package/dist/core/result.js.map +1 -1
  29. package/dist/core/retry.d.ts +37 -31
  30. package/dist/core/retry.d.ts.map +1 -1
  31. package/dist/core/retry.js +44 -51
  32. package/dist/core/retry.js.map +1 -1
  33. package/dist/core/schema.d.ts +57 -53
  34. package/dist/core/schema.d.ts.map +1 -1
  35. package/dist/core/step.d.ts +28 -78
  36. package/dist/core/step.d.ts.map +1 -1
  37. package/dist/core/step.js +53 -63
  38. package/dist/core/step.js.map +1 -1
  39. package/dist/core/workflow.d.ts +33 -61
  40. package/dist/core/workflow.d.ts.map +1 -1
  41. package/dist/core/workflow.js +31 -41
  42. package/dist/core/workflow.js.map +1 -1
  43. package/dist/database/backend.d.ts +53 -46
  44. package/dist/database/backend.d.ts.map +1 -1
  45. package/dist/database/backend.js +544 -577
  46. package/dist/database/backend.js.map +1 -1
  47. package/dist/database/base.js +48 -25
  48. package/dist/database/base.js.map +1 -1
  49. package/dist/database/migrations/20251212000000_0_init.d.ts +10 -0
  50. package/dist/database/migrations/20251212000000_0_init.d.ts.map +1 -0
  51. package/dist/database/migrations/20251212000000_0_init.js +8 -4
  52. package/dist/database/migrations/20251212000000_0_init.js.map +1 -1
  53. package/dist/database/migrations/20251212000000_1_tables.d.ts +10 -0
  54. package/dist/database/migrations/20251212000000_1_tables.d.ts.map +1 -0
  55. package/dist/database/migrations/20251212000000_1_tables.js +81 -83
  56. package/dist/database/migrations/20251212000000_1_tables.js.map +1 -1
  57. package/dist/database/migrations/20251212000000_2_fk.d.ts +10 -0
  58. package/dist/database/migrations/20251212000000_2_fk.d.ts.map +1 -0
  59. package/dist/database/migrations/20251212000000_2_fk.js +20 -43
  60. package/dist/database/migrations/20251212000000_2_fk.js.map +1 -1
  61. package/dist/database/migrations/20251212000000_3_indexes.d.ts +10 -0
  62. package/dist/database/migrations/20251212000000_3_indexes.d.ts.map +1 -0
  63. package/dist/database/migrations/20251212000000_3_indexes.js +88 -102
  64. package/dist/database/migrations/20251212000000_3_indexes.js.map +1 -1
  65. package/dist/database/pubsub.d.ts +7 -16
  66. package/dist/database/pubsub.d.ts.map +1 -1
  67. package/dist/database/pubsub.js +75 -73
  68. package/dist/database/pubsub.js.map +1 -1
  69. package/dist/execution.d.ts +20 -59
  70. package/dist/execution.d.ts.map +1 -1
  71. package/dist/execution.js +175 -188
  72. package/dist/execution.js.map +1 -1
  73. package/dist/index.d.ts +5 -8
  74. package/dist/index.js +5 -5
  75. package/dist/internal.d.ts +12 -13
  76. package/dist/internal.js +4 -4
  77. package/dist/registry.d.ts +33 -27
  78. package/dist/registry.d.ts.map +1 -1
  79. package/dist/registry.js +58 -49
  80. package/dist/registry.js.map +1 -1
  81. package/dist/worker.d.ts +57 -50
  82. package/dist/worker.d.ts.map +1 -1
  83. package/dist/worker.js +194 -199
  84. package/dist/worker.js.map +1 -1
  85. package/dist/workflow.d.ts +26 -30
  86. package/dist/workflow.d.ts.map +1 -1
  87. package/dist/workflow.js +20 -15
  88. package/dist/workflow.js.map +1 -1
  89. package/nodemon.json +1 -1
  90. package/package.json +17 -19
  91. package/src/backend.ts +25 -9
  92. package/src/chaos.test.ts +3 -1
  93. package/src/client.test.ts +2 -0
  94. package/src/client.ts +30 -8
  95. package/src/config.test.ts +1 -0
  96. package/src/config.ts +3 -2
  97. package/src/core/duration.test.ts +2 -1
  98. package/src/core/duration.ts +1 -1
  99. package/src/core/error.test.ts +1 -0
  100. package/src/core/error.ts +1 -1
  101. package/src/core/result.test.ts +1 -0
  102. package/src/core/retry.test.ts +3 -2
  103. package/src/core/retry.ts +1 -1
  104. package/src/core/schema.ts +2 -2
  105. package/src/core/step.test.ts +2 -1
  106. package/src/core/step.ts +4 -3
  107. package/src/core/workflow.test.ts +2 -1
  108. package/src/core/workflow.ts +4 -3
  109. package/src/database/backend.test.ts +1 -0
  110. package/src/database/backend.testsuite.ts +44 -40
  111. package/src/database/backend.ts +207 -25
  112. package/src/database/base.test.ts +41 -0
  113. package/src/database/base.ts +51 -2
  114. package/src/database/migrations/20251212000000_0_init.ts +2 -1
  115. package/src/database/migrations/20251212000000_1_tables.ts +2 -1
  116. package/src/database/migrations/20251212000000_2_fk.ts +2 -1
  117. package/src/database/migrations/20251212000000_3_indexes.ts +2 -1
  118. package/src/database/pubsub.test.ts +6 -3
  119. package/src/database/pubsub.ts +55 -33
  120. package/src/execution.test.ts +2 -0
  121. package/src/execution.ts +49 -10
  122. package/src/internal.ts +15 -15
  123. package/src/practices/01-remote-workflow.ts +1 -0
  124. package/src/registry.test.ts +1 -0
  125. package/src/registry.ts +1 -1
  126. package/src/testing/connection.ts +3 -1
  127. package/src/worker.test.ts +2 -0
  128. package/src/worker.ts +30 -9
  129. package/src/workflow.test.ts +1 -0
  130. package/src/workflow.ts +3 -3
  131. package/templates/openworkflow.config.ts +2 -1
  132. package/tsdown.config.ts +31 -0
  133. package/.swcrc +0 -17
  134. package/dist/chaos.test.d.ts +0 -2
  135. package/dist/chaos.test.d.ts.map +0 -1
  136. package/dist/chaos.test.js +0 -92
  137. package/dist/chaos.test.js.map +0 -1
  138. package/dist/client.test.d.ts +0 -2
  139. package/dist/client.test.d.ts.map +0 -1
  140. package/dist/client.test.js +0 -340
  141. package/dist/client.test.js.map +0 -1
  142. package/dist/config.test.d.ts +0 -2
  143. package/dist/config.test.d.ts.map +0 -1
  144. package/dist/config.test.js +0 -24
  145. package/dist/config.test.js.map +0 -1
  146. package/dist/core/duration.test.d.ts +0 -2
  147. package/dist/core/duration.test.d.ts.map +0 -1
  148. package/dist/core/duration.test.js +0 -265
  149. package/dist/core/duration.test.js.map +0 -1
  150. package/dist/core/error.test.d.ts +0 -2
  151. package/dist/core/error.test.d.ts.map +0 -1
  152. package/dist/core/error.test.js +0 -63
  153. package/dist/core/error.test.js.map +0 -1
  154. package/dist/core/json.js +0 -3
  155. package/dist/core/json.js.map +0 -1
  156. package/dist/core/result.test.d.ts +0 -2
  157. package/dist/core/result.test.d.ts.map +0 -1
  158. package/dist/core/result.test.js +0 -19
  159. package/dist/core/result.test.js.map +0 -1
  160. package/dist/core/retry.test.d.ts +0 -2
  161. package/dist/core/retry.test.d.ts.map +0 -1
  162. package/dist/core/retry.test.js +0 -198
  163. package/dist/core/retry.test.js.map +0 -1
  164. package/dist/core/schema.js +0 -4
  165. package/dist/core/schema.js.map +0 -1
  166. package/dist/core/step.test.d.ts +0 -2
  167. package/dist/core/step.test.d.ts.map +0 -1
  168. package/dist/core/step.test.js +0 -356
  169. package/dist/core/step.test.js.map +0 -1
  170. package/dist/core/workflow.test.d.ts +0 -2
  171. package/dist/core/workflow.test.d.ts.map +0 -1
  172. package/dist/core/workflow.test.js +0 -172
  173. package/dist/core/workflow.test.js.map +0 -1
  174. package/dist/database/backend.test.d.ts +0 -2
  175. package/dist/database/backend.test.d.ts.map +0 -1
  176. package/dist/database/backend.test.js +0 -19
  177. package/dist/database/backend.test.js.map +0 -1
  178. package/dist/database/backend.testsuite.d.ts +0 -20
  179. package/dist/database/backend.testsuite.d.ts.map +0 -1
  180. package/dist/database/backend.testsuite.js +0 -1280
  181. package/dist/database/backend.testsuite.js.map +0 -1
  182. package/dist/database/base.d.ts +0 -12
  183. package/dist/database/base.d.ts.map +0 -1
  184. package/dist/database/pubsub.test.d.ts +0 -2
  185. package/dist/database/pubsub.test.d.ts.map +0 -1
  186. package/dist/database/pubsub.test.js +0 -86
  187. package/dist/database/pubsub.test.js.map +0 -1
  188. package/dist/execution.test.d.ts +0 -2
  189. package/dist/execution.test.d.ts.map +0 -1
  190. package/dist/execution.test.js +0 -662
  191. package/dist/execution.test.js.map +0 -1
  192. package/dist/index.d.ts.map +0 -1
  193. package/dist/index.js.map +0 -1
  194. package/dist/internal.d.ts.map +0 -1
  195. package/dist/internal.js.map +0 -1
  196. package/dist/practices/01-remote-workflow.d.ts +0 -2
  197. package/dist/practices/01-remote-workflow.d.ts.map +0 -1
  198. package/dist/practices/01-remote-workflow.js +0 -70
  199. package/dist/practices/01-remote-workflow.js.map +0 -1
  200. package/dist/registry.test.d.ts +0 -2
  201. package/dist/registry.test.d.ts.map +0 -1
  202. package/dist/registry.test.js +0 -95
  203. package/dist/registry.test.js.map +0 -1
  204. package/dist/testing/connection.d.ts +0 -7
  205. package/dist/testing/connection.d.ts.map +0 -1
  206. package/dist/testing/connection.js +0 -39
  207. package/dist/testing/connection.js.map +0 -1
  208. package/dist/worker.test.d.ts +0 -2
  209. package/dist/worker.test.d.ts.map +0 -1
  210. package/dist/worker.test.js +0 -1164
  211. package/dist/worker.test.js.map +0 -1
  212. package/dist/workflow.test.d.ts +0 -2
  213. package/dist/workflow.test.d.ts.map +0 -1
  214. package/dist/workflow.test.js +0 -73
  215. package/dist/workflow.test.js.map +0 -1
@@ -1,662 +0,0 @@
1
- import { randomUUID } from "node:crypto";
2
- import { afterAll, beforeAll, describe, expect, test } from "vitest";
3
- import { BackendPostgres } from "./index.js";
4
- import { OpenWorkflow } from "./client.js";
5
- import { KNEX_GLOBAL_CONFIG } from "./testing/connection.js";
6
- describe("StepExecutor", ()=>{
7
- let backend;
8
- beforeAll(async ()=>{
9
- backend = new BackendPostgres(KNEX_GLOBAL_CONFIG, {
10
- namespaceId: randomUUID(),
11
- runMigrations: false
12
- });
13
- await backend.initialize();
14
- });
15
- afterAll(async ()=>{
16
- await backend.stop();
17
- });
18
- test("executes step and returns result", async ()=>{
19
- const client = new OpenWorkflow({
20
- backend
21
- });
22
- const workflow = client.defineWorkflow({
23
- name: "executor-basic"
24
- }, async ({ step })=>{
25
- const result = await step.run({
26
- name: "add"
27
- }, ()=>5 + 3);
28
- return result;
29
- });
30
- const worker = client.newWorker();
31
- const handle = await workflow.run();
32
- await worker.tick();
33
- const result = await handle.result();
34
- expect(result).toBe(8);
35
- });
36
- test("caches step results for same step name", async ()=>{
37
- const client = new OpenWorkflow({
38
- backend
39
- });
40
- let executionCount = 0;
41
- const workflow = client.defineWorkflow({
42
- name: "executor-cached"
43
- }, async ({ step })=>{
44
- const first = await step.run({
45
- name: "cached-step"
46
- }, ()=>{
47
- executionCount++;
48
- return "first-execution";
49
- });
50
- const second = await step.run({
51
- name: "cached-step"
52
- }, ()=>{
53
- executionCount++;
54
- return "second-execution";
55
- });
56
- return {
57
- first,
58
- second
59
- };
60
- });
61
- const worker = client.newWorker();
62
- const handle = await workflow.run();
63
- await worker.tick();
64
- const result = await handle.result();
65
- expect(result).toEqual({
66
- first: "first-execution",
67
- second: "first-execution"
68
- });
69
- expect(executionCount).toBe(1);
70
- });
71
- test("different step names execute independently", async ()=>{
72
- const client = new OpenWorkflow({
73
- backend
74
- });
75
- let executionCount = 0;
76
- const workflow = client.defineWorkflow({
77
- name: "executor-different-steps"
78
- }, async ({ step })=>{
79
- const first = await step.run({
80
- name: "step-1"
81
- }, ()=>{
82
- executionCount++;
83
- return "a";
84
- });
85
- const second = await step.run({
86
- name: "step-2"
87
- }, ()=>{
88
- executionCount++;
89
- return "b";
90
- });
91
- return {
92
- first,
93
- second
94
- };
95
- });
96
- const worker = client.newWorker();
97
- const handle = await workflow.run();
98
- await worker.tick();
99
- const result = await handle.result();
100
- expect(result).toEqual({
101
- first: "a",
102
- second: "b"
103
- });
104
- expect(executionCount).toBe(2);
105
- });
106
- test("propagates step errors with deadline exceeded", async ()=>{
107
- const client = new OpenWorkflow({
108
- backend
109
- });
110
- const workflow = client.defineWorkflow({
111
- name: "executor-error"
112
- }, async ({ step })=>{
113
- await step.run({
114
- name: "failing-step"
115
- }, ()=>{
116
- throw new Error("Step failed intentionally");
117
- });
118
- return "should not reach";
119
- });
120
- const worker = client.newWorker();
121
- // Use deadline to force immediate failure without retries
122
- const handle = await workflow.run({}, {
123
- deadlineAt: new Date()
124
- });
125
- await worker.tick();
126
- await sleep(100);
127
- await expect(handle.result()).rejects.toThrow(/deadline exceeded/);
128
- });
129
- test("sleep puts workflow in sleeping status", async ()=>{
130
- const client = new OpenWorkflow({
131
- backend
132
- });
133
- const workflow = client.defineWorkflow({
134
- name: "executor-sleep"
135
- }, async ({ step })=>{
136
- await step.sleep("sleep-1", "5s");
137
- return "after sleep";
138
- });
139
- const handle = await workflow.run();
140
- const worker = client.newWorker();
141
- await worker.tick();
142
- await sleep(50); // Wait for sleep step to complete
143
- const workflowRun = await backend.getWorkflowRun({
144
- workflowRunId: handle.workflowRun.id
145
- });
146
- expect(workflowRun?.status).toBe("sleeping");
147
- expect(workflowRun?.availableAt).not.toBeNull();
148
- });
149
- test("workflow resumes after sleep duration", async ()=>{
150
- const client = new OpenWorkflow({
151
- backend
152
- });
153
- const workflow = client.defineWorkflow({
154
- name: "resume-after-sleep"
155
- }, async ({ step })=>{
156
- const value = await step.run({
157
- name: "before"
158
- }, ()=>5);
159
- await step.sleep("wait", "10ms");
160
- return value + 10;
161
- });
162
- const handle = await workflow.run();
163
- const worker = client.newWorker();
164
- // First tick - hits sleep
165
- await worker.tick();
166
- await sleep(50); // Wait for tick to complete
167
- const sleeping = await backend.getWorkflowRun({
168
- workflowRunId: handle.workflowRun.id
169
- });
170
- expect(sleeping?.status).toBe("sleeping");
171
- // Wait for sleep to elapse
172
- await sleep(50);
173
- // Second tick - completes
174
- await worker.tick();
175
- const result = await handle.result();
176
- expect(result).toBe(15);
177
- });
178
- });
179
- describe("executeWorkflow", ()=>{
180
- let backend;
181
- beforeAll(async ()=>{
182
- backend = new BackendPostgres(KNEX_GLOBAL_CONFIG, {
183
- namespaceId: randomUUID(),
184
- runMigrations: false
185
- });
186
- await backend.initialize();
187
- });
188
- afterAll(async ()=>{
189
- await backend.stop();
190
- });
191
- describe("successful execution", ()=>{
192
- test("executes a simple workflow", async ()=>{
193
- const client = new OpenWorkflow({
194
- backend
195
- });
196
- const workflow = client.defineWorkflow({
197
- name: "simple-workflow"
198
- }, ({ input })=>{
199
- return input.a + input.b;
200
- });
201
- const worker = client.newWorker();
202
- const handle = await workflow.run({
203
- a: 10,
204
- b: 5
205
- });
206
- await worker.tick();
207
- const result = await handle.result();
208
- expect(result).toBe(15);
209
- });
210
- test("executes a multi-step workflow", async ()=>{
211
- const client = new OpenWorkflow({
212
- backend
213
- });
214
- const workflow = client.defineWorkflow({
215
- name: "multi-step-workflow"
216
- }, async ({ input, step })=>{
217
- const sum = await step.run({
218
- name: "add"
219
- }, ()=>input.value + 5);
220
- const product = await step.run({
221
- name: "multiply"
222
- }, ()=>sum * 2);
223
- return product;
224
- });
225
- const worker = client.newWorker();
226
- const handle = await workflow.run({
227
- value: 10
228
- });
229
- await worker.tick();
230
- const result = await handle.result();
231
- expect(result).toBe(30);
232
- });
233
- test("returns null for workflows without return", async ()=>{
234
- const client = new OpenWorkflow({
235
- backend
236
- });
237
- const workflow = client.defineWorkflow({
238
- name: "void-workflow"
239
- }, ()=>null);
240
- const worker = client.newWorker();
241
- const handle = await workflow.run();
242
- await worker.tick();
243
- const result = await handle.result();
244
- expect(result).toBeNull();
245
- });
246
- test("returns null from workflow", async ()=>{
247
- const client = new OpenWorkflow({
248
- backend
249
- });
250
- const workflow = client.defineWorkflow({
251
- name: "null-workflow"
252
- }, ()=>null);
253
- const worker = client.newWorker();
254
- const handle = await workflow.run();
255
- await worker.tick();
256
- const result = await handle.result();
257
- expect(result).toBeNull();
258
- });
259
- });
260
- describe("error handling", ()=>{
261
- test("handles workflow errors with deadline exceeded", async ()=>{
262
- const client = new OpenWorkflow({
263
- backend
264
- });
265
- const workflow = client.defineWorkflow({
266
- name: "failing-workflow"
267
- }, ()=>{
268
- throw new Error("Workflow error");
269
- });
270
- const worker = client.newWorker();
271
- // Use deadline to skip retries - fails with deadline exceeded
272
- const handle = await workflow.run({}, {
273
- deadlineAt: new Date()
274
- });
275
- await worker.tick();
276
- await sleep(100);
277
- await expect(handle.result()).rejects.toThrow(/deadline exceeded/);
278
- });
279
- test("handles step errors with deadline exceeded", async ()=>{
280
- const client = new OpenWorkflow({
281
- backend
282
- });
283
- const workflow = client.defineWorkflow({
284
- name: "step-error-workflow"
285
- }, async ({ step })=>{
286
- await step.run({
287
- name: "failing"
288
- }, ()=>{
289
- throw new Error("Step error");
290
- });
291
- return "unreachable";
292
- });
293
- const worker = client.newWorker();
294
- const handle = await workflow.run({}, {
295
- deadlineAt: new Date()
296
- });
297
- await worker.tick();
298
- await sleep(100);
299
- await expect(handle.result()).rejects.toThrow(/deadline exceeded/);
300
- });
301
- test("serializes non-Error exceptions", async ()=>{
302
- const client = new OpenWorkflow({
303
- backend
304
- });
305
- const workflow = client.defineWorkflow({
306
- name: "non-error-workflow"
307
- }, async ({ step })=>{
308
- await step.run({
309
- name: "throw-object"
310
- }, ()=>{
311
- // eslint-disable-next-line @typescript-eslint/only-throw-error
312
- throw {
313
- custom: "error",
314
- code: 500
315
- };
316
- });
317
- return "nope";
318
- });
319
- const worker = client.newWorker();
320
- const handle = await workflow.run({}, {
321
- deadlineAt: new Date()
322
- });
323
- await worker.tick();
324
- await sleep(100);
325
- await expect(handle.result()).rejects.toThrow();
326
- });
327
- });
328
- describe("sleep handling", ()=>{
329
- test("workflow enters sleeping status", async ()=>{
330
- const client = new OpenWorkflow({
331
- backend
332
- });
333
- const workflow = client.defineWorkflow({
334
- name: "sleep-workflow"
335
- }, async ({ step })=>{
336
- await step.sleep("wait", "5s");
337
- return "after sleep";
338
- });
339
- const handle = await workflow.run();
340
- const worker = client.newWorker();
341
- await worker.tick();
342
- await sleep(50); // Wait for sleep step to complete
343
- const workflowRun = await backend.getWorkflowRun({
344
- workflowRunId: handle.workflowRun.id
345
- });
346
- expect(workflowRun?.status).toBe("sleeping");
347
- });
348
- test("resumes workflow after sleep duration", async ()=>{
349
- const client = new OpenWorkflow({
350
- backend
351
- });
352
- const workflow = client.defineWorkflow({
353
- name: "resume-after-sleep"
354
- }, async ({ input, step })=>{
355
- const sum = await step.run({
356
- name: "add"
357
- }, ()=>input.value + 1);
358
- await step.sleep("wait", "10ms");
359
- return sum + 10;
360
- });
361
- const handle = await workflow.run({
362
- value: 5
363
- });
364
- const worker = client.newWorker();
365
- // first tick - hits sleep
366
- await worker.tick();
367
- await sleep(50);
368
- const sleeping = await backend.getWorkflowRun({
369
- workflowRunId: handle.workflowRun.id
370
- });
371
- expect(sleeping?.status).toBe("sleeping");
372
- // wait for sleep
373
- await sleep(50);
374
- await worker.tick();
375
- const result = await handle.result();
376
- expect(result).toBe(16);
377
- });
378
- });
379
- describe("workflow with complex data", ()=>{
380
- test("handles objects as input and output", async ()=>{
381
- const client = new OpenWorkflow({
382
- backend
383
- });
384
- const workflow = client.defineWorkflow({
385
- name: "user-workflow"
386
- }, ({ input })=>{
387
- return {
388
- greeting: `Hello, ${input.name}! You are ${String(input.age)} years old.`,
389
- processed: true
390
- };
391
- });
392
- const worker = client.newWorker();
393
- const handle = await workflow.run({
394
- name: "Alice",
395
- age: 30
396
- });
397
- await worker.tick();
398
- const result = await handle.result();
399
- expect(result).toEqual({
400
- greeting: "Hello, Alice! You are 30 years old.",
401
- processed: true
402
- });
403
- });
404
- test("handles arrays in workflow", async ()=>{
405
- const client = new OpenWorkflow({
406
- backend
407
- });
408
- const workflow = client.defineWorkflow({
409
- name: "array-workflow"
410
- }, ({ input })=>{
411
- return input.numbers.reduce((a, b)=>a + b, 0);
412
- });
413
- const worker = client.newWorker();
414
- const handle = await workflow.run({
415
- numbers: [
416
- 1,
417
- 2,
418
- 3,
419
- 4,
420
- 5
421
- ]
422
- });
423
- await worker.tick();
424
- const result = await handle.result();
425
- expect(result).toBe(15);
426
- });
427
- });
428
- describe("result type handling", ()=>{
429
- test("returns success with numeric result", async ()=>{
430
- const client = new OpenWorkflow({
431
- backend
432
- });
433
- const workflow = client.defineWorkflow({
434
- name: "numeric-result"
435
- }, async ({ step })=>{
436
- return await step.run({
437
- name: "compute"
438
- }, ()=>100 + 200);
439
- });
440
- const worker = client.newWorker();
441
- const handle = await workflow.run();
442
- await worker.tick();
443
- const result = await handle.result();
444
- expect(result).toBe(300);
445
- });
446
- test("returns success with string result", async ()=>{
447
- const client = new OpenWorkflow({
448
- backend
449
- });
450
- const workflow = client.defineWorkflow({
451
- name: "string-result"
452
- }, ({ input })=>{
453
- return input.text.toUpperCase();
454
- });
455
- const worker = client.newWorker();
456
- const handle = await workflow.run({
457
- text: "hello world"
458
- });
459
- await worker.tick();
460
- const result = await handle.result();
461
- expect(result).toBe("HELLO WORLD");
462
- });
463
- test("returns success with boolean result", async ()=>{
464
- const client = new OpenWorkflow({
465
- backend
466
- });
467
- const workflow = client.defineWorkflow({
468
- name: "bool-result"
469
- }, ({ input })=>{
470
- return input.value > 0;
471
- });
472
- const worker = client.newWorker();
473
- const handle = await workflow.run({
474
- value: 42
475
- });
476
- await worker.tick();
477
- const result = await handle.result();
478
- expect(result).toBe(true);
479
- });
480
- });
481
- describe("step execution order", ()=>{
482
- test("executes steps in sequence", async ()=>{
483
- const client = new OpenWorkflow({
484
- backend
485
- });
486
- const order = [];
487
- const workflow = client.defineWorkflow({
488
- name: "sequence-workflow"
489
- }, async ({ step })=>{
490
- await step.run({
491
- name: "first"
492
- }, ()=>order.push("first"));
493
- await step.run({
494
- name: "second"
495
- }, ()=>order.push("second"));
496
- await step.run({
497
- name: "third"
498
- }, ()=>order.push("third"));
499
- return order;
500
- });
501
- const worker = client.newWorker();
502
- const handle = await workflow.run();
503
- await worker.tick();
504
- const result = await handle.result();
505
- expect(result).toEqual([
506
- "first",
507
- "second",
508
- "third"
509
- ]);
510
- });
511
- });
512
- describe("version handling", ()=>{
513
- test("passes version to workflow function", async ()=>{
514
- const client = new OpenWorkflow({
515
- backend
516
- });
517
- const workflow = client.defineWorkflow({
518
- name: "version-workflow",
519
- version: "1.0.0"
520
- }, ({ version })=>{
521
- return {
522
- receivedVersion: version
523
- };
524
- });
525
- const worker = client.newWorker();
526
- const handle = await workflow.run();
527
- await worker.tick();
528
- const result = await handle.result();
529
- expect(result).toEqual({
530
- receivedVersion: "1.0.0"
531
- });
532
- });
533
- test("passes null version when not specified", async ()=>{
534
- const client = new OpenWorkflow({
535
- backend
536
- });
537
- const workflow = client.defineWorkflow({
538
- name: "no-version-workflow"
539
- }, ({ version })=>{
540
- return {
541
- receivedVersion: version
542
- };
543
- });
544
- const worker = client.newWorker();
545
- const handle = await workflow.run();
546
- await worker.tick();
547
- const result = await handle.result();
548
- expect(result).toEqual({
549
- receivedVersion: null
550
- });
551
- });
552
- });
553
- });
554
- describe("executeWorkflow with dynamic retryPolicy", ()=>{
555
- let backend;
556
- beforeAll(async ()=>{
557
- backend = new BackendPostgres(KNEX_GLOBAL_CONFIG, {
558
- namespaceId: randomUUID(),
559
- runMigrations: false
560
- });
561
- await backend.initialize();
562
- });
563
- afterAll(async ()=>{
564
- await backend.stop();
565
- });
566
- test("calls failWorkflowRun with forceComplete=true when shouldRetry returns false", async ()=>{
567
- const client = new OpenWorkflow({
568
- backend
569
- });
570
- // shouldRetry가 false를 반환하는 retryPolicy
571
- const workflow = client.defineWorkflow({
572
- name: "dynamic-retry-false",
573
- retryPolicy: {
574
- maxAttempts: 10,
575
- shouldRetry: ()=>({
576
- shouldRetry: false,
577
- delayMs: 0
578
- })
579
- }
580
- }, ()=>{
581
- throw new Error("Intentional failure");
582
- });
583
- const worker = client.newWorker();
584
- const handle = await workflow.run();
585
- await worker.tick();
586
- await sleep(100);
587
- // shouldRetry가 false를 반환했으므로 즉시 failed 상태가 되어야 합니다
588
- const workflowRun = await backend.getWorkflowRun({
589
- workflowRunId: handle.workflowRun.id
590
- });
591
- expect(workflowRun?.status).toBe("failed");
592
- expect(workflowRun?.attempts).toBe(1); // 한 번만 시도하고 종료
593
- });
594
- test("calls failWorkflowRun with forceComplete=false when shouldRetry returns true", async ()=>{
595
- const client = new OpenWorkflow({
596
- backend
597
- });
598
- // shouldRetry가 true를 반환하는 retryPolicy
599
- const workflow = client.defineWorkflow({
600
- name: "dynamic-retry-true",
601
- retryPolicy: {
602
- maxAttempts: 2,
603
- shouldRetry: ()=>({
604
- shouldRetry: true,
605
- delayMs: 1000
606
- })
607
- }
608
- }, ()=>{
609
- throw new Error("Intentional failure");
610
- });
611
- const worker = client.newWorker();
612
- const handle = await workflow.run();
613
- await worker.tick();
614
- await sleep(100);
615
- // shouldRetry가 true를 반환했으므로 pending 상태로 재시도 대기
616
- const workflowRun = await backend.getWorkflowRun({
617
- workflowRunId: handle.workflowRun.id
618
- });
619
- expect(workflowRun?.status).toBe("pending");
620
- expect(workflowRun?.attempts).toBe(1);
621
- });
622
- test("receives correct error and attempt number in shouldRetry function", async ()=>{
623
- const client = new OpenWorkflow({
624
- backend
625
- });
626
- let receivedError = null;
627
- let receivedAttempt = null;
628
- const workflow = client.defineWorkflow({
629
- name: "dynamic-retry-params",
630
- retryPolicy: {
631
- maxAttempts: 10,
632
- shouldRetry: (error, attempt)=>{
633
- receivedError = error;
634
- receivedAttempt = attempt;
635
- return {
636
- shouldRetry: false,
637
- delayMs: 0
638
- };
639
- }
640
- }
641
- }, ()=>{
642
- throw new Error("Test error message");
643
- });
644
- const worker = client.newWorker();
645
- const handle = await workflow.run();
646
- await worker.tick();
647
- await sleep(100);
648
- // shouldRetry 함수가 올바른 파라미터를 받았는지 확인
649
- expect(receivedError).not.toBeNull();
650
- expect(receivedError.message).toBe("Test error message");
651
- expect(receivedAttempt).toBe(1); // 첫 번째 시도 후이므로 1
652
- const workflowRun = await backend.getWorkflowRun({
653
- workflowRunId: handle.workflowRun.id
654
- });
655
- expect(workflowRun?.status).toBe("failed");
656
- });
657
- });
658
- function sleep(ms) {
659
- return new Promise((resolve)=>setTimeout(resolve, ms));
660
- }
661
-
662
- //# sourceMappingURL=execution.test.js.map