@corgelabs/corge 0.0.1 → 1.0.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.
Files changed (341) hide show
  1. package/dist/ai/index.d.ts +3 -0
  2. package/dist/ai/index.d.ts.map +1 -0
  3. package/dist/ai/index.js +3 -0
  4. package/dist/ai/index.js.map +1 -0
  5. package/dist/ai/schema.d.ts +83 -0
  6. package/dist/ai/schema.d.ts.map +1 -0
  7. package/dist/ai/schema.js +19 -0
  8. package/dist/ai/schema.js.map +1 -0
  9. package/dist/ai/service.d.ts +14 -0
  10. package/dist/ai/service.d.ts.map +1 -0
  11. package/dist/ai/service.js +266 -0
  12. package/dist/ai/service.js.map +1 -0
  13. package/dist/ai/utils.d.ts +10 -0
  14. package/dist/ai/utils.d.ts.map +1 -0
  15. package/dist/ai/utils.js +27 -0
  16. package/dist/ai/utils.js.map +1 -0
  17. package/dist/attachments/index.d.ts +4 -0
  18. package/dist/attachments/index.d.ts.map +1 -0
  19. package/dist/attachments/index.js +4 -0
  20. package/dist/attachments/index.js.map +1 -0
  21. package/dist/attachments/routes.d.ts +75 -0
  22. package/dist/attachments/routes.d.ts.map +1 -0
  23. package/dist/attachments/routes.js +18 -0
  24. package/dist/attachments/routes.js.map +1 -0
  25. package/dist/attachments/schema.d.ts +61 -0
  26. package/dist/attachments/schema.d.ts.map +1 -0
  27. package/dist/attachments/schema.js +30 -0
  28. package/dist/attachments/schema.js.map +1 -0
  29. package/dist/attachments/service.d.ts +27 -0
  30. package/dist/attachments/service.d.ts.map +1 -0
  31. package/dist/attachments/service.js +224 -0
  32. package/dist/attachments/service.js.map +1 -0
  33. package/dist/attachments/utils.d.ts +9 -0
  34. package/dist/attachments/utils.d.ts.map +1 -0
  35. package/dist/attachments/utils.js +80 -0
  36. package/dist/attachments/utils.js.map +1 -0
  37. package/dist/auth/index.d.ts +4 -0
  38. package/dist/auth/index.d.ts.map +1 -0
  39. package/dist/auth/index.js +4 -0
  40. package/dist/auth/index.js.map +1 -0
  41. package/dist/auth/oidc.d.ts +25 -0
  42. package/dist/auth/oidc.d.ts.map +1 -0
  43. package/dist/auth/oidc.js +298 -0
  44. package/dist/auth/oidc.js.map +1 -0
  45. package/dist/auth/recovery.d.ts +41 -0
  46. package/dist/auth/recovery.d.ts.map +1 -0
  47. package/dist/auth/recovery.js +250 -0
  48. package/dist/auth/recovery.js.map +1 -0
  49. package/dist/auth/routes.d.ts +226 -0
  50. package/dist/auth/routes.d.ts.map +1 -0
  51. package/dist/auth/routes.js +96 -0
  52. package/dist/auth/routes.js.map +1 -0
  53. package/dist/auth/schema.d.ts +158 -0
  54. package/dist/auth/schema.d.ts.map +1 -0
  55. package/dist/auth/schema.js +82 -0
  56. package/dist/auth/schema.js.map +1 -0
  57. package/dist/auth/service.d.ts +96 -0
  58. package/dist/auth/service.d.ts.map +1 -0
  59. package/dist/auth/service.js +129 -0
  60. package/dist/auth/service.js.map +1 -0
  61. package/dist/auth/session.d.ts +51 -0
  62. package/dist/auth/session.d.ts.map +1 -0
  63. package/dist/auth/session.js +344 -0
  64. package/dist/auth/session.js.map +1 -0
  65. package/dist/auth/utils.d.ts +17 -0
  66. package/dist/auth/utils.d.ts.map +1 -0
  67. package/dist/auth/utils.js +96 -0
  68. package/dist/auth/utils.js.map +1 -0
  69. package/dist/bin/corge.js +542 -0
  70. package/dist/chat/context.d.ts +10 -0
  71. package/dist/chat/context.d.ts.map +1 -0
  72. package/dist/chat/context.js +221 -0
  73. package/dist/chat/context.js.map +1 -0
  74. package/dist/chat/index.d.ts +4 -0
  75. package/dist/chat/index.d.ts.map +1 -0
  76. package/dist/chat/index.js +4 -0
  77. package/dist/chat/index.js.map +1 -0
  78. package/dist/chat/routes.d.ts +160 -0
  79. package/dist/chat/routes.d.ts.map +1 -0
  80. package/dist/chat/routes.js +210 -0
  81. package/dist/chat/routes.js.map +1 -0
  82. package/dist/chat/schema.d.ts +285 -0
  83. package/dist/chat/schema.d.ts.map +1 -0
  84. package/dist/chat/schema.js +74 -0
  85. package/dist/chat/schema.js.map +1 -0
  86. package/dist/chat/service.d.ts +64 -0
  87. package/dist/chat/service.d.ts.map +1 -0
  88. package/dist/chat/service.js +279 -0
  89. package/dist/chat/service.js.map +1 -0
  90. package/dist/chat/stream.d.ts +53 -0
  91. package/dist/chat/stream.d.ts.map +1 -0
  92. package/dist/chat/stream.js +339 -0
  93. package/dist/chat/stream.js.map +1 -0
  94. package/dist/chat/utils.d.ts +61 -0
  95. package/dist/chat/utils.d.ts.map +1 -0
  96. package/dist/chat/utils.js +285 -0
  97. package/dist/chat/utils.js.map +1 -0
  98. package/dist/cli/builder.d.ts +6 -0
  99. package/dist/cli/builder.d.ts.map +1 -0
  100. package/dist/cli/builder.js +91 -0
  101. package/dist/cli/builder.js.map +1 -0
  102. package/dist/cli/deployer.d.ts +2 -0
  103. package/dist/cli/deployer.d.ts.map +1 -0
  104. package/dist/cli/deployer.js +152 -0
  105. package/dist/cli/deployer.js.map +1 -0
  106. package/dist/cli/dev-server.d.ts +2 -0
  107. package/dist/cli/dev-server.d.ts.map +1 -0
  108. package/dist/cli/dev-server.js +70 -0
  109. package/dist/cli/dev-server.js.map +1 -0
  110. package/dist/cli/env.d.ts +4 -0
  111. package/dist/cli/env.d.ts.map +1 -0
  112. package/dist/cli/env.js +68 -0
  113. package/dist/cli/env.js.map +1 -0
  114. package/dist/cli/init.d.ts +6 -0
  115. package/dist/cli/init.d.ts.map +1 -0
  116. package/dist/cli/init.js +97 -0
  117. package/dist/cli/init.js.map +1 -0
  118. package/dist/config.d.ts +262 -0
  119. package/dist/config.d.ts.map +1 -0
  120. package/dist/config.js +212 -0
  121. package/dist/config.js.map +1 -0
  122. package/dist/db/index.d.ts +3 -0
  123. package/dist/db/index.d.ts.map +1 -0
  124. package/dist/db/index.js +3 -0
  125. package/dist/db/index.js.map +1 -0
  126. package/dist/db/schema.d.ts +410 -0
  127. package/dist/db/schema.d.ts.map +1 -0
  128. package/dist/db/schema.js +294 -0
  129. package/dist/db/schema.js.map +1 -0
  130. package/dist/db/service.d.ts +42 -0
  131. package/dist/db/service.d.ts.map +1 -0
  132. package/dist/db/service.js +372 -0
  133. package/dist/db/service.js.map +1 -0
  134. package/dist/db/utils.d.ts +25 -0
  135. package/dist/db/utils.d.ts.map +1 -0
  136. package/dist/db/utils.js +188 -0
  137. package/dist/db/utils.js.map +1 -0
  138. package/dist/emails/index.d.ts +4 -0
  139. package/dist/emails/index.d.ts.map +1 -0
  140. package/dist/emails/index.js +4 -0
  141. package/dist/emails/index.js.map +1 -0
  142. package/dist/emails/routes.d.ts +191 -0
  143. package/dist/emails/routes.d.ts.map +1 -0
  144. package/dist/emails/routes.js +39 -0
  145. package/dist/emails/routes.js.map +1 -0
  146. package/dist/emails/schema.d.ts +237 -0
  147. package/dist/emails/schema.d.ts.map +1 -0
  148. package/dist/emails/schema.js +98 -0
  149. package/dist/emails/schema.js.map +1 -0
  150. package/dist/emails/service.d.ts +22 -0
  151. package/dist/emails/service.d.ts.map +1 -0
  152. package/dist/emails/service.js +337 -0
  153. package/dist/emails/service.js.map +1 -0
  154. package/dist/emails/utils.d.ts +49 -0
  155. package/dist/emails/utils.d.ts.map +1 -0
  156. package/dist/emails/utils.js +341 -0
  157. package/dist/emails/utils.js.map +1 -0
  158. package/dist/files/index.d.ts +4 -0
  159. package/dist/files/index.d.ts.map +1 -0
  160. package/dist/files/index.js +4 -0
  161. package/dist/files/index.js.map +1 -0
  162. package/dist/files/routes.d.ts +72 -0
  163. package/dist/files/routes.d.ts.map +1 -0
  164. package/dist/files/routes.js +38 -0
  165. package/dist/files/routes.js.map +1 -0
  166. package/dist/files/schema.d.ts +57 -0
  167. package/dist/files/schema.d.ts.map +1 -0
  168. package/dist/files/schema.js +39 -0
  169. package/dist/files/schema.js.map +1 -0
  170. package/dist/files/service.d.ts +27 -0
  171. package/dist/files/service.d.ts.map +1 -0
  172. package/dist/files/service.js +175 -0
  173. package/dist/files/service.js.map +1 -0
  174. package/dist/files/utils.d.ts +3 -0
  175. package/dist/files/utils.d.ts.map +1 -0
  176. package/dist/files/utils.js +63 -0
  177. package/dist/files/utils.js.map +1 -0
  178. package/dist/index.d.ts +875 -0
  179. package/dist/index.d.ts.map +1 -0
  180. package/dist/index.js +9919 -0
  181. package/dist/index.js.map +7 -0
  182. package/dist/payments/billing.d.ts +29 -0
  183. package/dist/payments/billing.d.ts.map +1 -0
  184. package/dist/payments/billing.js +378 -0
  185. package/dist/payments/billing.js.map +1 -0
  186. package/dist/payments/index.d.ts +4 -0
  187. package/dist/payments/index.d.ts.map +1 -0
  188. package/dist/payments/index.js +4 -0
  189. package/dist/payments/index.js.map +1 -0
  190. package/dist/payments/routes.d.ts +340 -0
  191. package/dist/payments/routes.d.ts.map +1 -0
  192. package/dist/payments/routes.js +56 -0
  193. package/dist/payments/routes.js.map +1 -0
  194. package/dist/payments/schema.d.ts +412 -0
  195. package/dist/payments/schema.d.ts.map +1 -0
  196. package/dist/payments/schema.js +260 -0
  197. package/dist/payments/schema.js.map +1 -0
  198. package/dist/payments/service.d.ts +31 -0
  199. package/dist/payments/service.d.ts.map +1 -0
  200. package/dist/payments/service.js +322 -0
  201. package/dist/payments/service.js.map +1 -0
  202. package/dist/payments/utils.d.ts +61 -0
  203. package/dist/payments/utils.d.ts.map +1 -0
  204. package/dist/payments/utils.js +369 -0
  205. package/dist/payments/utils.js.map +1 -0
  206. package/dist/router/guard.d.ts +19 -0
  207. package/dist/router/guard.d.ts.map +1 -0
  208. package/dist/router/guard.js +243 -0
  209. package/dist/router/guard.js.map +1 -0
  210. package/dist/router/index.d.ts +3 -0
  211. package/dist/router/index.d.ts.map +1 -0
  212. package/dist/router/index.js +3 -0
  213. package/dist/router/index.js.map +1 -0
  214. package/dist/router/schema.d.ts +103 -0
  215. package/dist/router/schema.d.ts.map +1 -0
  216. package/dist/router/schema.js +282 -0
  217. package/dist/router/schema.js.map +1 -0
  218. package/dist/router/service.d.ts +25 -0
  219. package/dist/router/service.d.ts.map +1 -0
  220. package/dist/router/service.js +339 -0
  221. package/dist/router/service.js.map +1 -0
  222. package/dist/tasks/index.d.ts +4 -0
  223. package/dist/tasks/index.d.ts.map +1 -0
  224. package/dist/tasks/index.js +4 -0
  225. package/dist/tasks/index.js.map +1 -0
  226. package/dist/tasks/routes.d.ts +54 -0
  227. package/dist/tasks/routes.d.ts.map +1 -0
  228. package/dist/tasks/routes.js +195 -0
  229. package/dist/tasks/routes.js.map +1 -0
  230. package/dist/tasks/schema.d.ts +261 -0
  231. package/dist/tasks/schema.d.ts.map +1 -0
  232. package/dist/tasks/schema.js +35 -0
  233. package/dist/tasks/schema.js.map +1 -0
  234. package/dist/tasks/service.d.ts +32 -0
  235. package/dist/tasks/service.d.ts.map +1 -0
  236. package/dist/tasks/service.js +201 -0
  237. package/dist/tasks/service.js.map +1 -0
  238. package/dist/tasks/steps.d.ts +18 -0
  239. package/dist/tasks/steps.d.ts.map +1 -0
  240. package/dist/tasks/steps.js +365 -0
  241. package/dist/tasks/steps.js.map +1 -0
  242. package/dist/tasks/utils.d.ts +75 -0
  243. package/dist/tasks/utils.d.ts.map +1 -0
  244. package/dist/tasks/utils.js +311 -0
  245. package/dist/tasks/utils.js.map +1 -0
  246. package/dist/tasks/watcher.d.ts +13 -0
  247. package/dist/tasks/watcher.d.ts.map +1 -0
  248. package/dist/tasks/watcher.js +255 -0
  249. package/dist/tasks/watcher.js.map +1 -0
  250. package/dist/tasks/worker.d.ts +28 -0
  251. package/dist/tasks/worker.d.ts.map +1 -0
  252. package/dist/tasks/worker.js +326 -0
  253. package/dist/tasks/worker.js.map +1 -0
  254. package/dist/utils/index.d.ts +3 -0
  255. package/dist/utils/index.d.ts.map +1 -0
  256. package/dist/utils/index.js +3 -0
  257. package/dist/utils/index.js.map +1 -0
  258. package/dist/utils/schema.d.ts +79 -0
  259. package/dist/utils/schema.d.ts.map +1 -0
  260. package/dist/utils/schema.js +41 -0
  261. package/dist/utils/schema.js.map +1 -0
  262. package/dist/utils/service.d.ts +32 -0
  263. package/dist/utils/service.d.ts.map +1 -0
  264. package/dist/utils/service.js +384 -0
  265. package/dist/utils/service.js.map +1 -0
  266. package/docs/SDK_SPEC.md +1645 -0
  267. package/infra/firestore.base.indexes.json +138 -0
  268. package/infra/firestore.base.rules +152 -0
  269. package/infra/storage.base.rules +8 -0
  270. package/package.json +58 -13
  271. package/src/ai/index.ts +2 -0
  272. package/src/ai/schema.ts +64 -0
  273. package/src/ai/service.ts +317 -0
  274. package/src/ai/utils.ts +38 -0
  275. package/src/attachments/index.ts +3 -0
  276. package/src/attachments/routes.ts +28 -0
  277. package/src/attachments/schema.ts +45 -0
  278. package/src/attachments/service.ts +315 -0
  279. package/src/attachments/utils.ts +115 -0
  280. package/src/auth/index.ts +3 -0
  281. package/src/auth/oidc.ts +419 -0
  282. package/src/auth/recovery.ts +365 -0
  283. package/src/auth/routes.ts +142 -0
  284. package/src/auth/schema.ts +181 -0
  285. package/src/auth/service.ts +183 -0
  286. package/src/auth/session.ts +414 -0
  287. package/src/auth/utils.ts +106 -0
  288. package/src/chat/context.ts +310 -0
  289. package/src/chat/index.ts +3 -0
  290. package/src/chat/routes.ts +264 -0
  291. package/src/chat/schema.ts +295 -0
  292. package/src/chat/service.ts +360 -0
  293. package/src/chat/stream.ts +481 -0
  294. package/src/chat/utils.ts +370 -0
  295. package/src/cli/builder.ts +93 -0
  296. package/src/cli/deployer.ts +184 -0
  297. package/src/cli/dev-server.ts +77 -0
  298. package/src/cli/env.ts +89 -0
  299. package/src/cli/init.ts +121 -0
  300. package/src/config.ts +447 -0
  301. package/src/db/index.ts +2 -0
  302. package/src/db/schema.ts +409 -0
  303. package/src/db/service.ts +477 -0
  304. package/src/db/utils.ts +250 -0
  305. package/src/emails/index.ts +3 -0
  306. package/src/emails/routes.ts +64 -0
  307. package/src/emails/schema.ts +239 -0
  308. package/src/emails/service.ts +488 -0
  309. package/src/emails/utils.ts +449 -0
  310. package/src/files/index.ts +3 -0
  311. package/src/files/routes.ts +44 -0
  312. package/src/files/schema.ts +76 -0
  313. package/src/files/service.ts +238 -0
  314. package/src/files/utils.ts +77 -0
  315. package/src/index.ts +425 -0
  316. package/src/payments/billing.ts +488 -0
  317. package/src/payments/index.ts +3 -0
  318. package/src/payments/routes.ts +92 -0
  319. package/src/payments/schema.ts +401 -0
  320. package/src/payments/service.ts +445 -0
  321. package/src/payments/utils.ts +472 -0
  322. package/src/router/guard.ts +319 -0
  323. package/src/router/index.ts +2 -0
  324. package/src/router/schema.ts +458 -0
  325. package/src/router/service.ts +453 -0
  326. package/src/tasks/index.ts +11 -0
  327. package/src/tasks/routes.ts +230 -0
  328. package/src/tasks/schema.ts +310 -0
  329. package/src/tasks/service.ts +254 -0
  330. package/src/tasks/steps.ts +472 -0
  331. package/src/tasks/utils.ts +445 -0
  332. package/src/tasks/watcher.ts +307 -0
  333. package/src/tasks/worker.ts +461 -0
  334. package/src/utils/index.ts +2 -0
  335. package/src/utils/schema.ts +69 -0
  336. package/src/utils/service.ts +461 -0
  337. package/tests/e2e.test.ts +2531 -0
  338. package/tsconfig.base.json +12 -0
  339. package/README.md +0 -2
  340. package/index.d.ts +0 -1
  341. package/index.js +0 -1
@@ -0,0 +1,365 @@
1
+ import { CORE_CONFIG } from '../config';
2
+ import { ReplayCompleteSignal, TaskYieldSignal } from './schema';
3
+ import { createStaleEpochError, executeCompensateState, isClaimCheckPointer, isFencedOut, resolveTargetName, runSerializedCompensation, runStepWithRetry } from './utils';
4
+ const CUMULATIVE_STEPS_THRESHOLD_BYTES = 150 * 1024;
5
+ export class TaskStepsEngine {
6
+ #core;
7
+ #invokeChildWorkflow;
8
+ constructor(coreClient, invokeChildWorkflow) {
9
+ this.#core = coreClient;
10
+ this.#invokeChildWorkflow = invokeChildWorkflow;
11
+ }
12
+ maybeOffloadStepValue = async (docRef, stepId, val, isDev = false, forceOffload = false) => {
13
+ if (!docRef || val === undefined || val === null || isClaimCheckPointer(val))
14
+ return val;
15
+ try {
16
+ const json = JSON.stringify(val);
17
+ if (!json)
18
+ return val;
19
+ if (!forceOffload && Buffer.byteLength(json, 'utf8') <= CORE_CONFIG.tasks.claimCheckThresholdBytes) {
20
+ return val;
21
+ }
22
+ const gcsPath = `_tasks/${docRef.id}/steps/${encodeURIComponent(stepId)}.json`;
23
+ await this.#core.db
24
+ .bucket(isDev)
25
+ .file(gcsPath)
26
+ .save(Buffer.from(json, 'utf8'), {
27
+ resumable: false,
28
+ validation: false,
29
+ contentType: 'application/json'
30
+ });
31
+ return { __claimCheck: gcsPath };
32
+ }
33
+ catch {
34
+ return val;
35
+ }
36
+ };
37
+ maybeHydrateStepValue = async (raw, isDev = false) => {
38
+ if (!isClaimCheckPointer(raw))
39
+ return raw;
40
+ const [buf] = await this.#core.db.bucket(isDev).file(raw.__claimCheck).download();
41
+ return JSON.parse(buf.toString('utf8'));
42
+ };
43
+ allWithRollback = async (legs) => {
44
+ const settled = await Promise.allSettled(legs.map((l) => l.fn()));
45
+ const failed = settled.find((s) => s.status === 'rejected');
46
+ if (failed) {
47
+ await Promise.allSettled(settled.map((s, i) => (s.status === 'fulfilled' && legs[i]?.rollback ? legs[i].rollback(s.value) : undefined)));
48
+ throw failed.reason;
49
+ }
50
+ return settled.map((s) => s.value);
51
+ };
52
+ #assertNotFenced = (s) => {
53
+ if (s.fencedError)
54
+ throw s.fencedError;
55
+ if (s.wfCtx?.signal?.aborted && this.#core.errors.isStaleWorkerEpochError(s.wfCtx.signal.reason)) {
56
+ s.fencedError = s.wfCtx.signal.reason;
57
+ throw s.fencedError;
58
+ }
59
+ };
60
+ #triggerFenceAbort = (s, actualEpoch, status) => {
61
+ if (!s.fencedError) {
62
+ s.fencedError = createStaleEpochError(s.docRef?.id, s.claimedEpoch, actualEpoch, status);
63
+ }
64
+ s.abortController?.abort(s.fencedError);
65
+ throw s.fencedError;
66
+ };
67
+ #runFencedPersistOnce = async (s) => {
68
+ if (!s.docRef)
69
+ return;
70
+ this.#assertNotFenced(s);
71
+ try {
72
+ if (Buffer.byteLength(JSON.stringify(s.steps), 'utf8') > CUMULATIVE_STEPS_THRESHOLD_BYTES) {
73
+ for (const [k, v] of Object.entries(s.steps)) {
74
+ if (v !== undefined && v !== null && typeof v === 'object' && !isClaimCheckPointer(v)) {
75
+ s.steps[k] = await this.maybeOffloadStepValue(s.docRef, k, v, s.isDev, true);
76
+ }
77
+ }
78
+ }
79
+ }
80
+ catch { }
81
+ const docRef = s.docRef;
82
+ await docRef.firestore.runTransaction(async (tx) => {
83
+ const snap = await tx.get(docRef);
84
+ const data = snap.data();
85
+ const docEpoch = typeof data?.epoch === 'number' ? data.epoch : undefined;
86
+ const docStatus = typeof data?.status === 'string' ? data.status : undefined;
87
+ if (s.claimedEpoch === undefined && docEpoch !== undefined)
88
+ s.claimedEpoch = docEpoch;
89
+ if (isFencedOut(s.claimedEpoch, docEpoch, docStatus)) {
90
+ this.#triggerFenceAbort(s, docEpoch, docStatus);
91
+ }
92
+ const patch = {
93
+ steps: { ...s.steps },
94
+ lastHeartbeatAt: Date.now(),
95
+ ...(s.expiresAt ? { expiresAt: s.expiresAt } : {})
96
+ };
97
+ tx.set(docRef, patch, { mergeFields: Object.keys(patch) });
98
+ });
99
+ };
100
+ #persistSteps = (s) => {
101
+ if (!s.docRef)
102
+ return Promise.resolve();
103
+ this.#assertNotFenced(s);
104
+ if (s.activePersistPromise) {
105
+ s.pendingPersist = true;
106
+ return s.activePersistPromise;
107
+ }
108
+ const loop = (async () => {
109
+ try {
110
+ do {
111
+ s.pendingPersist = false;
112
+ await this.#runFencedPersistOnce(s);
113
+ } while (s.pendingPersist && !s.fencedError);
114
+ }
115
+ finally {
116
+ s.activePersistPromise = null;
117
+ }
118
+ })();
119
+ s.activePersistPromise = loop;
120
+ s.writes.push(loop.catch(() => { }));
121
+ return loop;
122
+ };
123
+ #executeSingleStep = async (s, flushFn, stepId, fnOrSpec, options) => {
124
+ this.#assertNotFenced(s);
125
+ const fn = typeof fnOrSpec === 'function' ? fnOrSpec : fnOrSpec.fn;
126
+ const rollback = options?.rollback ?? (typeof fnOrSpec === 'function' ? undefined : fnOrSpec.rollback);
127
+ const retry = options?.retry ?? (typeof fnOrSpec === 'function' ? undefined : fnOrSpec.retry);
128
+ const timeout = options?.timeout ?? (typeof fnOrSpec === 'function' ? undefined : fnOrSpec.timeout);
129
+ const registerRollback = (val) => {
130
+ if (!rollback)
131
+ return;
132
+ const idx = s.rollbacks.findIndex((r) => r.name === stepId);
133
+ if (idx !== -1)
134
+ s.rollbacks.splice(idx, 1);
135
+ s.rollbacks.push({ name: stepId, run: () => rollback(val) });
136
+ };
137
+ if (stepId in s.steps) {
138
+ const cached = await this.maybeHydrateStepValue(s.steps[stepId], s.isDev);
139
+ registerRollback(cached);
140
+ return cached;
141
+ }
142
+ if (s.replayOnly)
143
+ throw new ReplayCompleteSignal();
144
+ if (s.canYield && s.wfCtx) {
145
+ const budgetMs = (s.wfCtx.deadlineMs - s.wfCtx.startedAt) * CORE_CONFIG.tasks.yieldBudgetRatio;
146
+ if (budgetMs > 0 && Date.now() - s.wfCtx.startedAt > budgetMs) {
147
+ await flushFn();
148
+ throw new TaskYieldSignal('yield', { delaySeconds: 0 });
149
+ }
150
+ }
151
+ this.#assertNotFenced(s);
152
+ const val = await (s.mode !== 'rest' || retry !== undefined || timeout !== undefined
153
+ ? runStepWithRetry(fn, retry ?? (s.mode !== 'rest' ? 2 : 0), 1000, stepId, timeout, s.wfCtx?.signal, this.#core.errors.parseDuration, this.#core.errors.isNonRetryableError)
154
+ : fn({ signal: s.wfCtx?.signal ?? new AbortController().signal, attempt: 1, stepId }));
155
+ this.#assertNotFenced(s);
156
+ s.steps[stepId] = await this.maybeOffloadStepValue(s.docRef, stepId, val, s.isDev);
157
+ if (s.docRef) {
158
+ try {
159
+ await this.#persistSteps(s);
160
+ }
161
+ catch (err) {
162
+ if (this.#core.errors.isStaleWorkerEpochError(err)) {
163
+ delete s.steps[stepId];
164
+ throw err;
165
+ }
166
+ }
167
+ }
168
+ registerRollback(val);
169
+ return val;
170
+ };
171
+ #mapStep = async (s, flushFn, stepId, items, fn, options) => {
172
+ if (items.length === 0)
173
+ return [];
174
+ if (stepId in s.steps)
175
+ return this.maybeHydrateStepValue(s.steps[stepId], s.isDev);
176
+ const results = new Array(items.length);
177
+ const pendingIndices = [];
178
+ if (options?.shortCircuit) {
179
+ const checks = await Promise.all(items.map((item, idx) => options.shortCircuit(item, idx)));
180
+ for (let i = 0; i < items.length; i++) {
181
+ if (checks[i] !== undefined)
182
+ results[i] = checks[i];
183
+ else
184
+ pendingIndices.push(i);
185
+ }
186
+ }
187
+ else {
188
+ for (let i = 0; i < items.length; i++)
189
+ pendingIndices.push(i);
190
+ }
191
+ if (pendingIndices.length > 0) {
192
+ const concurrency = Math.max(1, options?.concurrency ?? CORE_CONFIG.tasks.defaultShardsCount);
193
+ let cursor = 0;
194
+ const workers = Array.from({ length: Math.min(concurrency, pendingIndices.length) }, async () => {
195
+ while (cursor < pendingIndices.length) {
196
+ const idx = pendingIndices[cursor++];
197
+ results[idx] = await this.#executeSingleStep(s, flushFn, `${stepId}:${idx}`, (ctx) => fn(items[idx], idx, ctx), options);
198
+ }
199
+ });
200
+ await Promise.all(workers);
201
+ }
202
+ for (const idx of pendingIndices)
203
+ delete s.steps[`${stepId}:${idx}`];
204
+ s.steps[stepId] = await this.maybeOffloadStepValue(s.docRef, stepId, results, s.isDev, items.length > 25);
205
+ if (s.docRef)
206
+ await this.#persistSteps(s);
207
+ return results;
208
+ };
209
+ #waitForSignalStep = async (s, flushFn, stepId, signalName, options) => {
210
+ this.#assertNotFenced(s);
211
+ if (stepId in s.steps)
212
+ return this.maybeHydrateStepValue(s.steps[stepId], s.isDev);
213
+ if (s.replayOnly)
214
+ throw new ReplayCompleteSignal();
215
+ if (signalName in s.signals) {
216
+ const payload = s.signals[signalName];
217
+ s.steps[stepId] = await this.maybeOffloadStepValue(s.docRef, stepId, payload, s.isDev);
218
+ if (s.docRef)
219
+ await this.#persistSteps(s);
220
+ return payload;
221
+ }
222
+ if (s.docRef) {
223
+ const freshSnap = await s.docRef.get().catch(() => null);
224
+ const freshSignals = freshSnap?.data()?.signals ?? {};
225
+ if (signalName in freshSignals) {
226
+ const payload = freshSignals[signalName];
227
+ s.steps[stepId] = await this.maybeOffloadStepValue(s.docRef, stepId, payload, s.isDev);
228
+ await this.#persistSteps(s);
229
+ return payload;
230
+ }
231
+ const timeoutKey = `__signal_deadline:${stepId}`;
232
+ const timeoutMs = options?.timeout ? this.#core.errors.parseDuration(options.timeout, 0) : 0;
233
+ const now = Date.now();
234
+ const existingDeadline = typeof s.steps[timeoutKey] === 'number' ? s.steps[timeoutKey] : undefined;
235
+ if (existingDeadline && now >= existingDeadline) {
236
+ throw this.#core.errors.nonRetryableError(`Timed out waiting for signal "${signalName}"`, 'SIGNAL_TIMEOUT');
237
+ }
238
+ if (!existingDeadline && timeoutMs > 0) {
239
+ s.steps[timeoutKey] = now + timeoutMs;
240
+ await this.#persistSteps(s);
241
+ }
242
+ if (s.canYield) {
243
+ await flushFn();
244
+ throw new TaskYieldSignal('waiting_signal', {
245
+ signalName,
246
+ ...(timeoutMs > 0 ? { timeoutMs: existingDeadline ? Math.max(1000, existingDeadline - now) : timeoutMs } : {})
247
+ });
248
+ }
249
+ }
250
+ throw this.#core.errors.nonRetryableError(`Signal "${signalName}" not received`, 'SIGNAL_TIMEOUT');
251
+ };
252
+ #invokeChildStep = (s, flush, step, stepId, target, input, options, wait) => this.#executeSingleStep(s, flush, stepId, async () => {
253
+ if (wait && typeof target === 'object' && target.handler && !target.workflowName) {
254
+ return target.handler({ input, step });
255
+ }
256
+ const workflowName = resolveTargetName(target);
257
+ const timeout = options?.timeout ?? (typeof target === 'object' ? target.timeout : undefined);
258
+ return this.#invokeChildWorkflow(workflowName, input, {
259
+ ...(timeout !== undefined ? { timeout } : {}),
260
+ ...(options?.dedupeKey ? { dedupeKey: options.dedupeKey } : {}),
261
+ wait
262
+ });
263
+ });
264
+ #sleepStep = async (s, flush, stepId, duration) => {
265
+ this.#assertNotFenced(s);
266
+ if (s.steps[stepId] === true)
267
+ return;
268
+ if (s.replayOnly)
269
+ throw new ReplayCompleteSignal();
270
+ const ms = Math.max(0, this.#core.errors.parseDuration(duration, 0));
271
+ if (!s.canYield || ms <= 2_000) {
272
+ if (ms > 0)
273
+ await new Promise((r) => setTimeout(r, ms));
274
+ s.steps[stepId] = true;
275
+ if (s.docRef)
276
+ await this.#persistSteps(s);
277
+ return;
278
+ }
279
+ s.steps[stepId] = true;
280
+ await this.#persistSteps(s);
281
+ await flush();
282
+ throw new TaskYieldSignal('sleeping', { delaySeconds: Math.ceil(ms / 1000) });
283
+ };
284
+ #progressStep = async (s, update) => {
285
+ this.#assertNotFenced(s);
286
+ if (!s.docRef || !s.expiresAt)
287
+ return;
288
+ const ref = s.docRef;
289
+ const p = ref.firestore
290
+ .runTransaction(async (tx) => {
291
+ const data = (await tx.get(ref)).data();
292
+ const docEpoch = typeof data?.epoch === 'number' ? data.epoch : undefined;
293
+ const docStatus = typeof data?.status === 'string' ? data.status : undefined;
294
+ if (isFencedOut(s.claimedEpoch, docEpoch, docStatus))
295
+ this.#triggerFenceAbort(s, docEpoch, docStatus);
296
+ tx.set(ref, { progress: update, updatedAt: new Date().toISOString(), expiresAt: s.expiresAt }, { merge: true });
297
+ })
298
+ .catch((err) => {
299
+ if (this.#core.errors.isStaleWorkerEpochError(err))
300
+ throw err;
301
+ });
302
+ s.writes.push(p);
303
+ await p;
304
+ };
305
+ #flushSteps = async (s) => {
306
+ this.#assertNotFenced(s);
307
+ if (s.docRef && s.claimedEpoch !== undefined && s.writes.length === 0)
308
+ await this.#persistSteps(s);
309
+ const settled = await Promise.allSettled(s.writes);
310
+ for (const item of settled) {
311
+ if (item.status === 'rejected' && this.#core.errors.isStaleWorkerEpochError(item.reason))
312
+ throw item.reason;
313
+ }
314
+ this.#assertNotFenced(s);
315
+ return settled;
316
+ };
317
+ createStepRunner = (mode = 'workflow', docRef, steps = {}, expiresAt, runnerOpts) => {
318
+ const s = {
319
+ mode,
320
+ docRef,
321
+ steps,
322
+ expiresAt,
323
+ isDev: Boolean(runnerOpts?.isDev ?? this.#core.env.isDev),
324
+ signals: runnerOpts?.signals ?? {},
325
+ wfCtx: runnerOpts?.workflowContext,
326
+ canYield: Boolean(runnerOpts?.canYield && docRef && expiresAt && mode === 'workflow'),
327
+ compensatedSteps: runnerOpts?.compensatedSteps ?? {},
328
+ replayOnly: Boolean(runnerOpts?.replayOnly),
329
+ claimedEpoch: runnerOpts?.claimedEpoch,
330
+ fencedError: null,
331
+ activePersistPromise: null,
332
+ pendingPersist: false,
333
+ writes: [],
334
+ rollbacks: [],
335
+ callCounts: new Map(),
336
+ abortController: runnerOpts?.abortController
337
+ };
338
+ const nextStepKey = (baseName) => {
339
+ const count = (s.callCounts.get(baseName) ?? 0) + 1;
340
+ s.callCounts.set(baseName, count);
341
+ return count === 1 ? baseName : `${baseName}#${count}`;
342
+ };
343
+ const flush = () => this.#flushSteps(s);
344
+ const step = (name, fnOrSpec, options) => this.#executeSingleStep(s, flush, nextStepKey(name), fnOrSpec, options);
345
+ const compensate = () => s.docRef ? runSerializedCompensation(s.docRef.id, () => executeCompensateState(s)) : executeCompensateState(s);
346
+ return Object.assign(step, {
347
+ run: step,
348
+ map: (name, items, fn, options) => this.#mapStep(s, flush, nextStepKey(name), items, fn, options),
349
+ invoke: (name, target, input, options) => this.#invokeChildStep(s, flush, step, nextStepKey(name), target, input, options, true),
350
+ spawn: (name, target, input, options) => this.#invokeChildStep(s, flush, step, nextStepKey(name), target, input, options, false),
351
+ sleep: (name, duration) => this.#sleepStep(s, flush, nextStepKey(name), duration),
352
+ waitForSignal: (name, signalName, options) => this.#waitForSignalStep(s, flush, nextStepKey(name), signalName, options),
353
+ continueAsNew: async (newInput) => {
354
+ this.#assertNotFenced(s);
355
+ await flush();
356
+ throw new TaskYieldSignal('continue_as_new', { newInput });
357
+ },
358
+ progress: (update) => this.#progressStep(s, update),
359
+ flush,
360
+ compensate,
361
+ onError: compensate
362
+ });
363
+ };
364
+ }
365
+ //# sourceMappingURL=steps.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/tasks/steps.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ import { Timestamp, type DocumentReference, type Firestore } from 'firebase-admin/firestore';
2
+ import { z } from 'zod';
3
+ import { type DbRole } from '../config';
4
+ import type { EntryId } from '../db';
5
+ import type { RouteMode } from '../router';
6
+ import type { Duration } from '../utils';
7
+ import { StaleWorkerEpochError, TaskWaitDetachedSignal, TaskYieldSignal, type ClaimCheckPointer, type StepContext, type StepRetryPolicy, type TaskRecord, type WorkflowContext, type WorkflowTargetRef, type WorkflowTaskPayload } from './schema';
8
+ export interface StepRunnerState {
9
+ mode: RouteMode;
10
+ docRef?: DocumentReference;
11
+ steps: Record<string, unknown>;
12
+ expiresAt?: Timestamp;
13
+ isDev: boolean;
14
+ signals: Record<string, unknown>;
15
+ wfCtx?: WorkflowContext;
16
+ canYield: boolean;
17
+ compensatedSteps: Record<string, boolean>;
18
+ replayOnly: boolean;
19
+ claimedEpoch?: number;
20
+ fencedError: Error | null;
21
+ activePersistPromise: Promise<void> | null;
22
+ pendingPersist: boolean;
23
+ writes: Promise<unknown>[];
24
+ rollbacks: {
25
+ name: string;
26
+ run: () => Promise<unknown>;
27
+ }[];
28
+ callCounts: Map<string, number>;
29
+ abortController?: AbortController;
30
+ }
31
+ export declare const isTaskYieldSignal: (err: unknown) => err is TaskYieldSignal;
32
+ export declare const isClaimCheckPointer: (val: unknown) => val is ClaimCheckPointer;
33
+ export declare const isTaskWaitDetachedSignal: (err: unknown) => err is TaskWaitDetachedSignal;
34
+ export declare const zodToJsonSchemaSafe: (schema?: z.ZodType<any>) => Record<string, unknown> | null;
35
+ export declare const resolveTaskDeadline: (workflowName: string, deadlineSeconds?: number) => number;
36
+ export declare const getQueueLoc: () => string;
37
+ export declare const getQueueBase: (isDev?: boolean) => string;
38
+ export declare const getQueueParent: (idx: number, isDev?: boolean) => string;
39
+ export declare const getWorkerUri: (isDev?: boolean) => string;
40
+ export declare const isTerminalRecord: (d: TaskRecord<unknown> | undefined) => d is TaskRecord<unknown>;
41
+ export declare const setTaskDoc: (docRef: DocumentReference, patch: Record<string, unknown>) => Promise<void>;
42
+ export declare const resolveTargetName: (target: string | WorkflowTargetRef<any, any>) => string;
43
+ export declare const isFencedOut: (claimedEpoch: number | undefined, docEpoch: number | undefined, docStatus: string | undefined, requireRunning?: boolean) => boolean;
44
+ export declare const createStaleEpochError: (taskId: string | undefined, claimedEpoch: number | undefined, actualEpoch: number | undefined, status?: string) => StaleWorkerEpochError;
45
+ export declare const runSerializedCompensation: (taskId: string, fn: () => Promise<void>) => Promise<void>;
46
+ export declare const executeCompensateState: (s: StepRunnerState) => Promise<void>;
47
+ export declare const runStepWithRetry: <T>(fn: (ctx: StepContext) => Promise<T>, retryOrCount: number | StepRetryPolicy | undefined, delayMs: number | undefined, stepId: string | undefined, timeout: Duration | undefined, parentSignal: AbortSignal | undefined, parseDuration: (d: Duration | undefined, fallbackMs: number) => number, isNonRetryableError: (err: unknown) => boolean) => Promise<T>;
48
+ export declare const claimTaskEpochTx: (db: Firestore, docRef: DocumentReference, payload: WorkflowTaskPayload, attempt: number, resolveRole: (userId?: EntryId, explicitRole?: DbRole) => DbRole) => Promise<{
49
+ aborted: true;
50
+ claimedEpoch?: undefined;
51
+ startedAt?: undefined;
52
+ expiresAt?: undefined;
53
+ effectiveParams?: undefined;
54
+ userId?: undefined;
55
+ userRole?: undefined;
56
+ steps?: undefined;
57
+ signals?: undefined;
58
+ compensatedSteps?: undefined;
59
+ } | {
60
+ aborted: false;
61
+ claimedEpoch: number;
62
+ startedAt: number;
63
+ expiresAt: Timestamp;
64
+ effectiveParams: Record<string, unknown>;
65
+ userId: string;
66
+ userRole: DbRole;
67
+ steps: Record<string, unknown>;
68
+ signals: Record<string, unknown>;
69
+ compensatedSteps: Record<string, boolean>;
70
+ }>;
71
+ export declare const startTaskHeartbeatTimer: (db: Firestore, docRef: DocumentReference, taskId: string, claimedEpoch: number, expiresAt: Timestamp, controller: AbortController) => ReturnType<typeof setInterval>;
72
+ export declare const commitTaskCompletionTx: (db: Firestore, docRef: DocumentReference, baseMeta: Record<string, unknown>, taskId: string, claimedEpoch: number, storedResponse: unknown, steps: Record<string, unknown>, expiresAt: Timestamp) => Promise<void>;
73
+ export declare const commitTaskYieldTx: (db: Firestore, docRef: DocumentReference, baseMeta: Record<string, unknown>, taskId: string, claimedEpoch: number, err: TaskYieldSignal, nextEpoch: number, nextParams: Record<string, unknown>, nextSteps: Record<string, unknown>, nextStatus: string, expiresAt: Timestamp) => Promise<void>;
74
+ export declare const commitTaskCompensatingTx: (db: Firestore, docRef: DocumentReference, taskId: string, claimedEpoch: number, expiresAt: Timestamp) => Promise<void>;
75
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tasks/utils.ts"],"names":[],"mappings":"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"}