convex-effect-workflows 0.1.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/README.md +107 -0
- package/dist/client/ConvexCtx.d.ts +12 -0
- package/dist/client/ConvexCtx.d.ts.map +1 -0
- package/dist/client/ConvexCtx.js +6 -0
- package/dist/client/ConvexCtx.js.map +1 -0
- package/dist/client/ConvexLogger.d.ts +7 -0
- package/dist/client/ConvexLogger.d.ts.map +1 -0
- package/dist/client/ConvexLogger.js +39 -0
- package/dist/client/ConvexLogger.js.map +1 -0
- package/dist/client/ConvexTracer.d.ts +7 -0
- package/dist/client/ConvexTracer.d.ts.map +1 -0
- package/dist/client/ConvexTracer.js +60 -0
- package/dist/client/ConvexTracer.js.map +1 -0
- package/dist/client/ConvexWorkflowEngine.d.ts +308 -0
- package/dist/client/ConvexWorkflowEngine.d.ts.map +1 -0
- package/dist/client/ConvexWorkflowEngine.js +88 -0
- package/dist/client/ConvexWorkflowEngine.js.map +1 -0
- package/dist/client/activityWorker.d.ts +23 -0
- package/dist/client/activityWorker.d.ts.map +1 -0
- package/dist/client/activityWorker.js +41 -0
- package/dist/client/activityWorker.js.map +1 -0
- package/dist/client/boundaries.d.ts +27 -0
- package/dist/client/boundaries.d.ts.map +1 -0
- package/dist/client/boundaries.js +17 -0
- package/dist/client/boundaries.js.map +1 -0
- package/dist/client/encoded.d.ts +22 -0
- package/dist/client/encoded.d.ts.map +1 -0
- package/dist/client/encoded.js +276 -0
- package/dist/client/encoded.js.map +1 -0
- package/dist/client/index.d.ts +13 -0
- package/dist/client/index.d.ts.map +1 -0
- package/dist/client/index.js +11 -0
- package/dist/client/index.js.map +1 -0
- package/dist/client/registry.d.ts +17 -0
- package/dist/client/registry.d.ts.map +1 -0
- package/dist/client/registry.js +21 -0
- package/dist/client/registry.js.map +1 -0
- package/dist/client/runner.d.ts +27 -0
- package/dist/client/runner.d.ts.map +1 -0
- package/dist/client/runner.js +90 -0
- package/dist/client/runner.js.map +1 -0
- package/dist/client/runtime.d.ts +10 -0
- package/dist/client/runtime.d.ts.map +1 -0
- package/dist/client/runtime.js +15 -0
- package/dist/client/runtime.js.map +1 -0
- package/dist/component/_generated/api.d.ts +148 -0
- package/dist/component/_generated/api.d.ts.map +1 -0
- package/dist/component/_generated/api.js +31 -0
- package/dist/component/_generated/api.js.map +1 -0
- package/dist/component/_generated/component.d.ts +921 -0
- package/dist/component/_generated/component.d.ts.map +1 -0
- package/dist/component/_generated/component.js +11 -0
- package/dist/component/_generated/component.js.map +1 -0
- package/dist/component/_generated/dataModel.d.ts +46 -0
- package/dist/component/_generated/dataModel.d.ts.map +1 -0
- package/dist/component/_generated/dataModel.js +11 -0
- package/dist/component/_generated/dataModel.js.map +1 -0
- package/dist/component/_generated/server.d.ts +121 -0
- package/dist/component/_generated/server.d.ts.map +1 -0
- package/dist/component/_generated/server.js +78 -0
- package/dist/component/_generated/server.js.map +1 -0
- package/dist/component/activityCompletions.d.ts +27 -0
- package/dist/component/activityCompletions.d.ts.map +1 -0
- package/dist/component/activityCompletions.js +70 -0
- package/dist/component/activityCompletions.js.map +1 -0
- package/dist/component/boundaries.d.ts +20 -0
- package/dist/component/boundaries.d.ts.map +1 -0
- package/dist/component/boundaries.js +17 -0
- package/dist/component/boundaries.js.map +1 -0
- package/dist/component/cleanup.d.ts +11 -0
- package/dist/component/cleanup.d.ts.map +1 -0
- package/dist/component/cleanup.js +163 -0
- package/dist/component/cleanup.js.map +1 -0
- package/dist/component/clocks.d.ts +12 -0
- package/dist/component/clocks.d.ts.map +1 -0
- package/dist/component/clocks.js +26 -0
- package/dist/component/clocks.js.map +1 -0
- package/dist/component/config.d.ts +25 -0
- package/dist/component/config.d.ts.map +1 -0
- package/dist/component/config.js +110 -0
- package/dist/component/config.js.map +1 -0
- package/dist/component/convex.config.d.ts +3 -0
- package/dist/component/convex.config.d.ts.map +1 -0
- package/dist/component/convex.config.js +6 -0
- package/dist/component/convex.config.js.map +1 -0
- package/dist/component/dashboard.d.ts +268 -0
- package/dist/component/dashboard.d.ts.map +1 -0
- package/dist/component/dashboard.js +622 -0
- package/dist/component/dashboard.js.map +1 -0
- package/dist/component/deferreds.d.ts +31 -0
- package/dist/component/deferreds.d.ts.map +1 -0
- package/dist/component/deferreds.js +138 -0
- package/dist/component/deferreds.js.map +1 -0
- package/dist/component/executions.d.ts +77 -0
- package/dist/component/executions.d.ts.map +1 -0
- package/dist/component/executions.js +186 -0
- package/dist/component/executions.js.map +1 -0
- package/dist/component/journalSteps.d.ts +261 -0
- package/dist/component/journalSteps.d.ts.map +1 -0
- package/dist/component/journalSteps.js +203 -0
- package/dist/component/journalSteps.js.map +1 -0
- package/dist/component/logs.d.ts +68 -0
- package/dist/component/logs.d.ts.map +1 -0
- package/dist/component/logs.js +123 -0
- package/dist/component/logs.js.map +1 -0
- package/dist/component/onComplete.d.ts +31 -0
- package/dist/component/onComplete.d.ts.map +1 -0
- package/dist/component/onComplete.js +146 -0
- package/dist/component/onComplete.js.map +1 -0
- package/dist/component/payloads.d.ts +26 -0
- package/dist/component/payloads.d.ts.map +1 -0
- package/dist/component/payloads.js +57 -0
- package/dist/component/payloads.js.map +1 -0
- package/dist/component/queries.d.ts +2 -0
- package/dist/component/queries.d.ts.map +1 -0
- package/dist/component/queries.js +2 -0
- package/dist/component/queries.js.map +1 -0
- package/dist/component/runner.d.ts +31 -0
- package/dist/component/runner.d.ts.map +1 -0
- package/dist/component/runner.js +87 -0
- package/dist/component/runner.js.map +1 -0
- package/dist/component/schema.d.ts +282 -0
- package/dist/component/schema.d.ts.map +1 -0
- package/dist/component/schema.js +119 -0
- package/dist/component/schema.js.map +1 -0
- package/dist/component/spans.d.ts +105 -0
- package/dist/component/spans.d.ts.map +1 -0
- package/dist/component/spans.js +190 -0
- package/dist/component/spans.js.map +1 -0
- package/dist/component/utils.d.ts +15 -0
- package/dist/component/utils.d.ts.map +1 -0
- package/dist/component/utils.js +53 -0
- package/dist/component/utils.js.map +1 -0
- package/dist/shared/constants.d.ts +12 -0
- package/dist/shared/constants.d.ts.map +1 -0
- package/dist/shared/constants.js +12 -0
- package/dist/shared/constants.js.map +1 -0
- package/dist/shared/validators.d.ts +69 -0
- package/dist/shared/validators.d.ts.map +1 -0
- package/dist/shared/validators.js +30 -0
- package/dist/shared/validators.js.map +1 -0
- package/package.json +74 -0
- package/src/client/ConvexCtx.ts +21 -0
- package/src/client/ConvexLogger.ts +52 -0
- package/src/client/ConvexTracer.ts +75 -0
- package/src/client/ConvexWorkflowEngine.test.ts +124 -0
- package/src/client/ConvexWorkflowEngine.ts +209 -0
- package/src/client/activityWorker.ts +62 -0
- package/src/client/boundaries.test.ts +83 -0
- package/src/client/boundaries.ts +79 -0
- package/src/client/encoded.lifecycle.test.ts +336 -0
- package/src/client/encoded.test.ts +153 -0
- package/src/client/encoded.ts +484 -0
- package/src/client/index.ts +47 -0
- package/src/client/registry.ts +35 -0
- package/src/client/runner.ts +165 -0
- package/src/client/runtime.ts +30 -0
- package/src/component/_generated/api.ts +179 -0
- package/src/component/_generated/component.ts +1216 -0
- package/src/component/_generated/dataModel.ts +60 -0
- package/src/component/_generated/server.ts +156 -0
- package/src/component/activityCompletions.ts +73 -0
- package/src/component/boundaries.ts +55 -0
- package/src/component/cleanup.test.ts +219 -0
- package/src/component/cleanup.ts +218 -0
- package/src/component/clocks.ts +26 -0
- package/src/component/config.test.ts +159 -0
- package/src/component/config.ts +145 -0
- package/src/component/convex.config.ts +7 -0
- package/src/component/core.test.ts +829 -0
- package/src/component/dashboard.scaling.test.ts +268 -0
- package/src/component/dashboard.ts +743 -0
- package/src/component/deferreds.ts +162 -0
- package/src/component/executions.ts +225 -0
- package/src/component/journalSteps.ts +252 -0
- package/src/component/logs.ts +152 -0
- package/src/component/onComplete.ts +170 -0
- package/src/component/payloads.ts +83 -0
- package/src/component/queries.ts +8 -0
- package/src/component/runner.ts +122 -0
- package/src/component/schema.ts +155 -0
- package/src/component/setup.test.ts +15 -0
- package/src/component/spans.ts +241 -0
- package/src/component/utils.test.ts +32 -0
- package/src/component/utils.ts +73 -0
- package/src/shared/constants.test.ts +14 -0
- package/src/shared/constants.ts +15 -0
- package/src/shared/validators.ts +98 -0
- package/src/test.d.ts +8 -0
- package/src/test.ts +17 -0
|
@@ -0,0 +1,268 @@
|
|
|
1
|
+
/// <reference types="vite/client" />
|
|
2
|
+
|
|
3
|
+
import { describe, expect, test } from "vitest";
|
|
4
|
+
import { api } from "./_generated/api.js";
|
|
5
|
+
import { initConvexTest } from "./setup.test.js";
|
|
6
|
+
|
|
7
|
+
async function createTerminalExecution(
|
|
8
|
+
t: ReturnType<typeof initConvexTest>,
|
|
9
|
+
args: {
|
|
10
|
+
executionId: string;
|
|
11
|
+
tenantId: string;
|
|
12
|
+
workflowName?: string;
|
|
13
|
+
status: "completed" | "failed";
|
|
14
|
+
startedAt?: number;
|
|
15
|
+
},
|
|
16
|
+
) {
|
|
17
|
+
await t.mutation(api.executions.createExecution, {
|
|
18
|
+
workflowName: args.workflowName ?? "scalingWorkflow",
|
|
19
|
+
executionId: args.executionId,
|
|
20
|
+
tenantId: args.tenantId,
|
|
21
|
+
payload: { id: args.executionId },
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
if (args.status === "completed") {
|
|
25
|
+
await t.mutation(api.executions.completeExecution, {
|
|
26
|
+
executionId: args.executionId,
|
|
27
|
+
generation: 0,
|
|
28
|
+
kind: "success",
|
|
29
|
+
result: { ok: true },
|
|
30
|
+
});
|
|
31
|
+
} else {
|
|
32
|
+
await t.mutation(api.executions.completeExecution, {
|
|
33
|
+
executionId: args.executionId,
|
|
34
|
+
generation: 0,
|
|
35
|
+
kind: "failure",
|
|
36
|
+
error: "failed",
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
if (args.startedAt !== undefined) {
|
|
41
|
+
await t.mutation(api.executions.internalPatchExecution, {
|
|
42
|
+
executionId: args.executionId,
|
|
43
|
+
startedAt: args.startedAt,
|
|
44
|
+
});
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
describe("dashboard query scaling", () => {
|
|
49
|
+
test("listExecutions applies tenant+status+time filters with stable cursoring", async () => {
|
|
50
|
+
const t = initConvexTest();
|
|
51
|
+
|
|
52
|
+
const windowStart = 1_800_000_000_000;
|
|
53
|
+
const inWindowTime = windowStart + 100;
|
|
54
|
+
|
|
55
|
+
await createTerminalExecution(t, {
|
|
56
|
+
executionId: "old-000",
|
|
57
|
+
tenantId: "tenant-a",
|
|
58
|
+
status: "completed",
|
|
59
|
+
startedAt: windowStart - 10_000,
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
await createTerminalExecution(t, {
|
|
63
|
+
executionId: "new-999",
|
|
64
|
+
tenantId: "tenant-a",
|
|
65
|
+
status: "completed",
|
|
66
|
+
startedAt: windowStart + 10_000,
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
await createTerminalExecution(t, {
|
|
70
|
+
executionId: "noise-tenant",
|
|
71
|
+
tenantId: "tenant-b",
|
|
72
|
+
status: "completed",
|
|
73
|
+
startedAt: inWindowTime,
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
await createTerminalExecution(t, {
|
|
77
|
+
executionId: "noise-status",
|
|
78
|
+
tenantId: "tenant-a",
|
|
79
|
+
status: "failed",
|
|
80
|
+
startedAt: inWindowTime,
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
const expected = ["match-001", "match-002", "match-003", "match-004"];
|
|
84
|
+
for (const executionId of expected) {
|
|
85
|
+
await createTerminalExecution(t, {
|
|
86
|
+
executionId,
|
|
87
|
+
tenantId: "tenant-a",
|
|
88
|
+
status: "completed",
|
|
89
|
+
startedAt: inWindowTime,
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
const firstPage = await t.query(api.dashboard.listExecutions, {
|
|
94
|
+
tenantId: "tenant-a",
|
|
95
|
+
status: "completed",
|
|
96
|
+
startedAfter: windowStart,
|
|
97
|
+
startedBefore: windowStart + 1_000,
|
|
98
|
+
order: "asc",
|
|
99
|
+
limit: 2,
|
|
100
|
+
});
|
|
101
|
+
|
|
102
|
+
expect(firstPage.page).toHaveLength(2);
|
|
103
|
+
expect(firstPage.page.map((row: any) => row.executionId)).toEqual(expected.slice(0, 2));
|
|
104
|
+
expect(firstPage.isDone).toBe(false);
|
|
105
|
+
expect(firstPage.cursor).toBeTruthy();
|
|
106
|
+
|
|
107
|
+
const secondPage = await t.query(api.dashboard.listExecutions, {
|
|
108
|
+
tenantId: "tenant-a",
|
|
109
|
+
status: "completed",
|
|
110
|
+
startedAfter: windowStart,
|
|
111
|
+
startedBefore: windowStart + 1_000,
|
|
112
|
+
order: "asc",
|
|
113
|
+
limit: 2,
|
|
114
|
+
cursorStartedAt: firstPage.cursor!.startedAt,
|
|
115
|
+
cursorExecutionId: firstPage.cursor!.executionId,
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
expect(secondPage.page).toHaveLength(2);
|
|
119
|
+
expect(secondPage.page.map((row: any) => row.executionId)).toEqual(expected.slice(2));
|
|
120
|
+
expect(secondPage.isDone).toBe(true);
|
|
121
|
+
});
|
|
122
|
+
|
|
123
|
+
test("listExecutions handles large filtered pages with cursor continuation", async () => {
|
|
124
|
+
const t = initConvexTest();
|
|
125
|
+
|
|
126
|
+
const time = 1_900_000_000_000;
|
|
127
|
+
|
|
128
|
+
for (let i = 0; i < 120; i++) {
|
|
129
|
+
await createTerminalExecution(t, {
|
|
130
|
+
executionId: `match-${String(i).padStart(3, "0")}`,
|
|
131
|
+
tenantId: "tenant-a",
|
|
132
|
+
status: "completed",
|
|
133
|
+
startedAt: time,
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
for (let i = 0; i < 20; i++) {
|
|
138
|
+
await createTerminalExecution(t, {
|
|
139
|
+
executionId: `noise-failed-${String(i).padStart(3, "0")}`,
|
|
140
|
+
tenantId: "tenant-a",
|
|
141
|
+
status: "failed",
|
|
142
|
+
startedAt: time,
|
|
143
|
+
});
|
|
144
|
+
await createTerminalExecution(t, {
|
|
145
|
+
executionId: `noise-tenant-${String(i).padStart(3, "0")}`,
|
|
146
|
+
tenantId: "tenant-b",
|
|
147
|
+
status: "completed",
|
|
148
|
+
startedAt: time,
|
|
149
|
+
});
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
const firstPage = await t.query(api.dashboard.listExecutions, {
|
|
153
|
+
tenantId: "tenant-a",
|
|
154
|
+
status: "completed",
|
|
155
|
+
startedAfter: time - 1,
|
|
156
|
+
startedBefore: time + 1,
|
|
157
|
+
order: "asc",
|
|
158
|
+
limit: 100,
|
|
159
|
+
});
|
|
160
|
+
|
|
161
|
+
expect(firstPage.page).toHaveLength(100);
|
|
162
|
+
expect(firstPage.isDone).toBe(false);
|
|
163
|
+
expect(firstPage.cursor).toBeTruthy();
|
|
164
|
+
expect(firstPage.page.every((row: any) => row.executionId.startsWith("match-"))).toBe(true);
|
|
165
|
+
|
|
166
|
+
const secondPage = await t.query(api.dashboard.listExecutions, {
|
|
167
|
+
tenantId: "tenant-a",
|
|
168
|
+
status: "completed",
|
|
169
|
+
startedAfter: time - 1,
|
|
170
|
+
startedBefore: time + 1,
|
|
171
|
+
order: "asc",
|
|
172
|
+
limit: 100,
|
|
173
|
+
cursorStartedAt: firstPage.cursor!.startedAt,
|
|
174
|
+
cursorExecutionId: firstPage.cursor!.executionId,
|
|
175
|
+
});
|
|
176
|
+
|
|
177
|
+
expect(secondPage.page).toHaveLength(20);
|
|
178
|
+
expect(secondPage.isDone).toBe(true);
|
|
179
|
+
expect(secondPage.page.every((row: any) => row.executionId.startsWith("match-"))).toBe(true);
|
|
180
|
+
});
|
|
181
|
+
|
|
182
|
+
test("listExecutionLogs paginates large equal-timestamp sets with stable tie-breakers", async () => {
|
|
183
|
+
const t = initConvexTest();
|
|
184
|
+
|
|
185
|
+
await t.mutation(api.executions.createExecution, {
|
|
186
|
+
workflowName: "logWorkflow",
|
|
187
|
+
executionId: "exec-logs-scale",
|
|
188
|
+
payload: { ok: true },
|
|
189
|
+
});
|
|
190
|
+
|
|
191
|
+
const timestamp = 2_000_000_000_000;
|
|
192
|
+
|
|
193
|
+
for (let i = 0; i < 120; i++) {
|
|
194
|
+
await t.mutation(api.logs.createLog, {
|
|
195
|
+
executionId: "exec-logs-scale",
|
|
196
|
+
traceId: "trace-scale",
|
|
197
|
+
spanId: "span-hot",
|
|
198
|
+
stepNumber: 0,
|
|
199
|
+
level: "info",
|
|
200
|
+
source: "activity",
|
|
201
|
+
message: `match-${String(i).padStart(3, "0")}`,
|
|
202
|
+
timestamp,
|
|
203
|
+
});
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
for (let i = 0; i < 25; i++) {
|
|
207
|
+
await t.mutation(api.logs.createLog, {
|
|
208
|
+
executionId: "exec-logs-scale",
|
|
209
|
+
traceId: "trace-scale",
|
|
210
|
+
spanId: "span-hot",
|
|
211
|
+
stepNumber: 0,
|
|
212
|
+
level: "error",
|
|
213
|
+
source: "activity",
|
|
214
|
+
message: `noise-level-${i}`,
|
|
215
|
+
timestamp,
|
|
216
|
+
});
|
|
217
|
+
await t.mutation(api.logs.createLog, {
|
|
218
|
+
executionId: "exec-logs-scale",
|
|
219
|
+
traceId: "trace-scale",
|
|
220
|
+
spanId: "span-other",
|
|
221
|
+
stepNumber: 0,
|
|
222
|
+
level: "info",
|
|
223
|
+
source: "activity",
|
|
224
|
+
message: `noise-span-${i}`,
|
|
225
|
+
timestamp,
|
|
226
|
+
});
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
const firstPage = await t.query(api.dashboard.listExecutionLogs, {
|
|
230
|
+
executionId: "exec-logs-scale",
|
|
231
|
+
level: "info",
|
|
232
|
+
source: "activity",
|
|
233
|
+
spanId: "span-hot",
|
|
234
|
+
order: "asc",
|
|
235
|
+
limit: 100,
|
|
236
|
+
});
|
|
237
|
+
|
|
238
|
+
expect(firstPage.page).toHaveLength(100);
|
|
239
|
+
expect(firstPage.isDone).toBe(false);
|
|
240
|
+
expect(firstPage.cursor).toBeTruthy();
|
|
241
|
+
expect(
|
|
242
|
+
firstPage.page.every((row: any) => row.message.startsWith("match-")),
|
|
243
|
+
).toBe(true);
|
|
244
|
+
|
|
245
|
+
const firstIds = new Set(firstPage.page.map((row: any) => row._id));
|
|
246
|
+
|
|
247
|
+
const secondPage = await t.query(api.dashboard.listExecutionLogs, {
|
|
248
|
+
executionId: "exec-logs-scale",
|
|
249
|
+
level: "info",
|
|
250
|
+
source: "activity",
|
|
251
|
+
spanId: "span-hot",
|
|
252
|
+
order: "asc",
|
|
253
|
+
limit: 100,
|
|
254
|
+
afterTimestamp: firstPage.cursor!.timestamp,
|
|
255
|
+
afterLogId: firstPage.cursor!.logId,
|
|
256
|
+
});
|
|
257
|
+
|
|
258
|
+
expect(secondPage.page).toHaveLength(20);
|
|
259
|
+
expect(secondPage.isDone).toBe(true);
|
|
260
|
+
expect(
|
|
261
|
+
secondPage.page.every((row: any) => row.message.startsWith("match-")),
|
|
262
|
+
).toBe(true);
|
|
263
|
+
|
|
264
|
+
for (const row of secondPage.page) {
|
|
265
|
+
expect(firstIds.has(row._id)).toBe(false);
|
|
266
|
+
}
|
|
267
|
+
});
|
|
268
|
+
});
|