@workflow/core 5.0.0-beta.4 → 5.0.0-beta.40

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 (325) hide show
  1. package/dist/attribute-changes.d.ts +7 -0
  2. package/dist/attribute-changes.d.ts.map +1 -0
  3. package/dist/attribute-changes.js +25 -0
  4. package/dist/capabilities.d.ts +33 -1
  5. package/dist/capabilities.d.ts.map +1 -1
  6. package/dist/capabilities.js +71 -4
  7. package/dist/capture-stack.d.ts +16 -0
  8. package/dist/capture-stack.d.ts.map +1 -0
  9. package/dist/capture-stack.js +21 -0
  10. package/dist/class-serialization.d.ts +32 -0
  11. package/dist/class-serialization.d.ts.map +1 -1
  12. package/dist/class-serialization.js +37 -1
  13. package/dist/classify-error.d.ts +26 -3
  14. package/dist/classify-error.d.ts.map +1 -1
  15. package/dist/classify-error.js +109 -6
  16. package/dist/context-errors.d.ts +27 -0
  17. package/dist/context-errors.d.ts.map +1 -0
  18. package/dist/context-errors.js +101 -0
  19. package/dist/context-violation-error.d.ts +97 -0
  20. package/dist/context-violation-error.d.ts.map +1 -0
  21. package/dist/context-violation-error.js +149 -0
  22. package/dist/correlation-id.d.ts +109 -0
  23. package/dist/correlation-id.d.ts.map +1 -0
  24. package/dist/correlation-id.js +139 -0
  25. package/dist/create-hook.d.ts +62 -4
  26. package/dist/create-hook.d.ts.map +1 -1
  27. package/dist/create-hook.js +4 -3
  28. package/dist/define-hook.d.ts.map +1 -1
  29. package/dist/define-hook.js +20 -5
  30. package/dist/describe-error.d.ts +70 -0
  31. package/dist/describe-error.d.ts.map +1 -0
  32. package/dist/describe-error.js +189 -0
  33. package/dist/encryption.d.ts +37 -3
  34. package/dist/encryption.d.ts.map +1 -1
  35. package/dist/encryption.js +97 -31
  36. package/dist/events-consumer.d.ts +26 -1
  37. package/dist/events-consumer.d.ts.map +1 -1
  38. package/dist/events-consumer.js +105 -18
  39. package/dist/flushable-stream.d.ts +65 -10
  40. package/dist/flushable-stream.d.ts.map +1 -1
  41. package/dist/flushable-stream.js +131 -18
  42. package/dist/global.d.ts +37 -1
  43. package/dist/global.d.ts.map +1 -1
  44. package/dist/global.js +21 -3
  45. package/dist/index.d.ts +1 -0
  46. package/dist/index.d.ts.map +1 -1
  47. package/dist/index.js +2 -1
  48. package/dist/log-format.d.ts +25 -0
  49. package/dist/log-format.d.ts.map +1 -0
  50. package/dist/log-format.js +250 -0
  51. package/dist/logger.d.ts +29 -30
  52. package/dist/logger.d.ts.map +1 -1
  53. package/dist/logger.js +82 -32
  54. package/dist/private.d.ts +178 -9
  55. package/dist/private.d.ts.map +1 -1
  56. package/dist/private.js +273 -9
  57. package/dist/replay-payload-cache.d.ts +68 -0
  58. package/dist/replay-payload-cache.d.ts.map +1 -0
  59. package/dist/replay-payload-cache.js +160 -0
  60. package/dist/runtime/compute-instance.d.ts +12 -0
  61. package/dist/runtime/compute-instance.d.ts.map +1 -0
  62. package/dist/runtime/compute-instance.js +13 -0
  63. package/dist/runtime/constants.d.ts +237 -0
  64. package/dist/runtime/constants.d.ts.map +1 -1
  65. package/dist/runtime/constants.js +405 -15
  66. package/dist/runtime/count-step-started-events.d.ts +52 -0
  67. package/dist/runtime/count-step-started-events.d.ts.map +1 -0
  68. package/dist/runtime/count-step-started-events.js +72 -0
  69. package/dist/runtime/deployment-guard.d.ts +99 -0
  70. package/dist/runtime/deployment-guard.d.ts.map +1 -0
  71. package/dist/runtime/deployment-guard.js +154 -0
  72. package/dist/runtime/get-port-lazy.d.ts +25 -0
  73. package/dist/runtime/get-port-lazy.d.ts.map +1 -0
  74. package/dist/runtime/get-port-lazy.js +92 -0
  75. package/dist/runtime/get-world-lazy.d.ts +23 -0
  76. package/dist/runtime/get-world-lazy.d.ts.map +1 -0
  77. package/dist/runtime/get-world-lazy.js +46 -0
  78. package/dist/runtime/helpers.d.ts +219 -10
  79. package/dist/runtime/helpers.d.ts.map +1 -1
  80. package/dist/runtime/helpers.js +414 -40
  81. package/dist/runtime/quickjs-assets.generated.d.ts +14 -0
  82. package/dist/runtime/quickjs-assets.generated.d.ts.map +1 -0
  83. package/dist/runtime/quickjs-assets.generated.js +30 -0
  84. package/dist/runtime/quickjs-entrypoint.d.ts +124 -0
  85. package/dist/runtime/quickjs-entrypoint.d.ts.map +1 -0
  86. package/dist/runtime/quickjs-entrypoint.js +1429 -0
  87. package/dist/runtime/quickjs-runtime.d.ts +193 -0
  88. package/dist/runtime/quickjs-runtime.d.ts.map +1 -0
  89. package/dist/runtime/quickjs-runtime.js +1944 -0
  90. package/dist/runtime/replay-budget.d.ts +98 -0
  91. package/dist/runtime/replay-budget.d.ts.map +1 -0
  92. package/dist/runtime/replay-budget.js +192 -0
  93. package/dist/runtime/replay-recovery-reporter.d.ts +36 -0
  94. package/dist/runtime/replay-recovery-reporter.d.ts.map +1 -0
  95. package/dist/runtime/replay-recovery-reporter.js +64 -0
  96. package/dist/runtime/resume-hook.d.ts +27 -4
  97. package/dist/runtime/resume-hook.d.ts.map +1 -1
  98. package/dist/runtime/resume-hook.js +448 -76
  99. package/dist/runtime/run-id-time.d.ts +19 -0
  100. package/dist/runtime/run-id-time.d.ts.map +1 -0
  101. package/dist/runtime/run-id-time.js +42 -0
  102. package/dist/runtime/run.d.ts +8 -2
  103. package/dist/runtime/run.d.ts.map +1 -1
  104. package/dist/runtime/run.js +62 -15
  105. package/dist/runtime/runs.d.ts +54 -3
  106. package/dist/runtime/runs.d.ts.map +1 -1
  107. package/dist/runtime/runs.js +117 -10
  108. package/dist/runtime/start.d.ts +70 -1
  109. package/dist/runtime/start.d.ts.map +1 -1
  110. package/dist/runtime/start.js +312 -54
  111. package/dist/runtime/step-executor.d.ts +177 -0
  112. package/dist/runtime/step-executor.d.ts.map +1 -0
  113. package/dist/runtime/step-executor.js +949 -0
  114. package/dist/runtime/step-latency.d.ts +197 -0
  115. package/dist/runtime/step-latency.d.ts.map +1 -0
  116. package/dist/runtime/step-latency.js +207 -0
  117. package/dist/runtime/step-ownership.d.ts +72 -0
  118. package/dist/runtime/step-ownership.d.ts.map +1 -0
  119. package/dist/runtime/step-ownership.js +114 -0
  120. package/dist/runtime/step-single-flight.d.ts +12 -0
  121. package/dist/runtime/step-single-flight.d.ts.map +1 -0
  122. package/dist/runtime/step-single-flight.js +69 -0
  123. package/dist/runtime/suspension-handler.d.ts +102 -7
  124. package/dist/runtime/suspension-handler.d.ts.map +1 -1
  125. package/dist/runtime/suspension-handler.js +439 -140
  126. package/dist/runtime/vm-mode.d.ts +44 -0
  127. package/dist/runtime/vm-mode.d.ts.map +1 -0
  128. package/dist/runtime/vm-mode.js +62 -0
  129. package/dist/runtime/vm-serde-bundle.generated.d.ts +14 -0
  130. package/dist/runtime/vm-serde-bundle.generated.d.ts.map +1 -0
  131. package/dist/runtime/vm-serde-bundle.generated.js +16 -0
  132. package/dist/runtime/wait-continuation.d.ts +84 -0
  133. package/dist/runtime/wait-continuation.d.ts.map +1 -0
  134. package/dist/runtime/wait-continuation.js +105 -0
  135. package/dist/runtime/wait-until.d.ts +18 -0
  136. package/dist/runtime/wait-until.d.ts.map +1 -0
  137. package/dist/runtime/wait-until.js +42 -0
  138. package/dist/runtime/world-compatibility.d.ts +5 -0
  139. package/dist/runtime/world-compatibility.d.ts.map +1 -0
  140. package/dist/runtime/world-compatibility.js +12 -0
  141. package/dist/runtime/world-init.d.ts +50 -0
  142. package/dist/runtime/world-init.d.ts.map +1 -0
  143. package/dist/runtime/world-init.js +50 -0
  144. package/dist/runtime/world.d.ts +14 -2
  145. package/dist/runtime/world.d.ts.map +1 -1
  146. package/dist/runtime/world.js +101 -26
  147. package/dist/runtime.d.ts +17 -12
  148. package/dist/runtime.d.ts.map +1 -1
  149. package/dist/runtime.js +3078 -327
  150. package/dist/schemas.d.ts +1 -1
  151. package/dist/schemas.d.ts.map +1 -1
  152. package/dist/schemas.js +1 -1
  153. package/dist/sealed-box.d.ts +167 -0
  154. package/dist/sealed-box.d.ts.map +1 -0
  155. package/dist/sealed-box.js +571 -0
  156. package/dist/serialization/client.d.ts +17 -0
  157. package/dist/serialization/client.d.ts.map +1 -0
  158. package/dist/serialization/client.js +48 -0
  159. package/dist/serialization/codec-devalue-vm.d.ts +9 -0
  160. package/dist/serialization/codec-devalue-vm.d.ts.map +1 -0
  161. package/dist/serialization/codec-devalue-vm.js +137 -0
  162. package/dist/serialization/codec-devalue.d.ts +14 -0
  163. package/dist/serialization/codec-devalue.d.ts.map +1 -0
  164. package/dist/serialization/codec-devalue.js +105 -0
  165. package/dist/serialization/codec.d.ts +125 -0
  166. package/dist/serialization/codec.d.ts.map +1 -0
  167. package/dist/serialization/codec.js +17 -0
  168. package/dist/serialization/compression.d.ts +104 -0
  169. package/dist/serialization/compression.d.ts.map +1 -0
  170. package/dist/serialization/compression.js +260 -0
  171. package/dist/serialization/encryption.d.ts +134 -0
  172. package/dist/serialization/encryption.d.ts.map +1 -0
  173. package/dist/serialization/encryption.js +186 -0
  174. package/dist/serialization/errors.d.ts +34 -0
  175. package/dist/serialization/errors.d.ts.map +1 -0
  176. package/dist/serialization/errors.js +59 -0
  177. package/dist/serialization/format.d.ts +60 -0
  178. package/dist/serialization/format.d.ts.map +1 -0
  179. package/dist/serialization/format.js +97 -0
  180. package/dist/serialization/hardened.d.ts +155 -0
  181. package/dist/serialization/hardened.d.ts.map +1 -0
  182. package/dist/serialization/hardened.js +523 -0
  183. package/dist/serialization/index.d.ts +20 -0
  184. package/dist/serialization/index.d.ts.map +1 -0
  185. package/dist/serialization/index.js +22 -0
  186. package/dist/serialization/reducers/class-vm.d.ts +20 -0
  187. package/dist/serialization/reducers/class-vm.d.ts.map +1 -0
  188. package/dist/serialization/reducers/class-vm.js +77 -0
  189. package/dist/serialization/reducers/class.d.ts +11 -0
  190. package/dist/serialization/reducers/class.d.ts.map +1 -0
  191. package/dist/serialization/reducers/class.js +73 -0
  192. package/dist/serialization/reducers/common-vm.d.ts +15 -0
  193. package/dist/serialization/reducers/common-vm.d.ts.map +1 -0
  194. package/dist/serialization/reducers/common-vm.js +579 -0
  195. package/dist/serialization/reducers/common.d.ts +16 -0
  196. package/dist/serialization/reducers/common.d.ts.map +1 -0
  197. package/dist/serialization/reducers/common.js +478 -0
  198. package/dist/serialization/reducers/step-function-vm.d.ts +44 -0
  199. package/dist/serialization/reducers/step-function-vm.d.ts.map +1 -0
  200. package/dist/serialization/reducers/step-function-vm.js +97 -0
  201. package/dist/serialization/reducers/step-function.d.ts +35 -0
  202. package/dist/serialization/reducers/step-function.d.ts.map +1 -0
  203. package/dist/serialization/reducers/step-function.js +104 -0
  204. package/dist/serialization/step.d.ts +17 -0
  205. package/dist/serialization/step.d.ts.map +1 -0
  206. package/dist/serialization/step.js +48 -0
  207. package/dist/serialization/types.d.ts +273 -0
  208. package/dist/serialization/types.d.ts.map +1 -0
  209. package/dist/serialization/types.js +35 -0
  210. package/dist/serialization/vm-bundle-entry.d.ts +12 -0
  211. package/dist/serialization/vm-bundle-entry.d.ts.map +1 -0
  212. package/dist/serialization/vm-bundle-entry.js +58 -0
  213. package/dist/serialization/workflow-vm.d.ts +24 -0
  214. package/dist/serialization/workflow-vm.d.ts.map +1 -0
  215. package/dist/serialization/workflow-vm.js +66 -0
  216. package/dist/serialization/workflow.d.ts +29 -0
  217. package/dist/serialization/workflow.d.ts.map +1 -0
  218. package/dist/serialization/workflow.js +54 -0
  219. package/dist/serialization-format.d.ts +60 -4
  220. package/dist/serialization-format.d.ts.map +1 -1
  221. package/dist/serialization-format.js +276 -56
  222. package/dist/serialization.d.ts +374 -221
  223. package/dist/serialization.d.ts.map +1 -1
  224. package/dist/serialization.js +2300 -783
  225. package/dist/set-attributes.d.ts +13 -0
  226. package/dist/set-attributes.d.ts.map +1 -0
  227. package/dist/set-attributes.js +60 -0
  228. package/dist/sleep.d.ts.map +1 -1
  229. package/dist/sleep.js +3 -2
  230. package/dist/source-map.d.ts +25 -0
  231. package/dist/source-map.d.ts.map +1 -1
  232. package/dist/source-map.js +148 -10
  233. package/dist/step/context-storage.d.ts +61 -2
  234. package/dist/step/context-storage.d.ts.map +1 -1
  235. package/dist/step/context-storage.js +7 -5
  236. package/dist/step/get-closure-vars.d.ts.map +1 -1
  237. package/dist/step/get-closure-vars.js +3 -2
  238. package/dist/step/get-step-metadata.d.ts.map +1 -1
  239. package/dist/step/get-step-metadata.js +3 -2
  240. package/dist/step/get-workflow-metadata.d.ts.map +1 -1
  241. package/dist/step/get-workflow-metadata.js +3 -2
  242. package/dist/step/writable-stream.d.ts.map +1 -1
  243. package/dist/step/writable-stream.js +71 -7
  244. package/dist/step.d.ts.map +1 -1
  245. package/dist/step.js +226 -30
  246. package/dist/symbols.d.ts +54 -0
  247. package/dist/symbols.d.ts.map +1 -1
  248. package/dist/symbols.js +55 -1
  249. package/dist/telemetry/semantic-conventions.d.ts +242 -2
  250. package/dist/telemetry/semantic-conventions.d.ts.map +1 -1
  251. package/dist/telemetry/semantic-conventions.js +173 -1
  252. package/dist/telemetry.d.ts +73 -0
  253. package/dist/telemetry.d.ts.map +1 -1
  254. package/dist/telemetry.js +153 -16
  255. package/dist/types.d.ts +6 -0
  256. package/dist/types.d.ts.map +1 -1
  257. package/dist/types.js +23 -1
  258. package/dist/util.d.ts +16 -6
  259. package/dist/util.d.ts.map +1 -1
  260. package/dist/util.js +25 -16
  261. package/dist/version.d.ts +1 -1
  262. package/dist/version.d.ts.map +1 -1
  263. package/dist/version.js +2 -2
  264. package/dist/vm/index.d.ts.map +1 -1
  265. package/dist/vm/index.js +77 -9
  266. package/dist/vm/script-cache.d.ts +28 -0
  267. package/dist/vm/script-cache.d.ts.map +1 -0
  268. package/dist/vm/script-cache.js +140 -0
  269. package/dist/workflow/abort-controller.d.ts +65 -0
  270. package/dist/workflow/abort-controller.d.ts.map +1 -0
  271. package/dist/workflow/abort-controller.js +314 -0
  272. package/dist/workflow/attribute-dispatcher.d.ts +6 -0
  273. package/dist/workflow/attribute-dispatcher.d.ts.map +1 -0
  274. package/dist/workflow/attribute-dispatcher.js +48 -0
  275. package/dist/workflow/create-hook.d.ts.map +1 -1
  276. package/dist/workflow/create-hook.js +25 -3
  277. package/dist/workflow/define-hook.d.ts +1 -1
  278. package/dist/workflow/define-hook.d.ts.map +1 -1
  279. package/dist/workflow/define-hook.js +8 -4
  280. package/dist/workflow/get-workflow-metadata.d.ts.map +1 -1
  281. package/dist/workflow/get-workflow-metadata.js +14 -3
  282. package/dist/workflow/hook.d.ts.map +1 -1
  283. package/dist/workflow/hook.js +303 -37
  284. package/dist/workflow/index.d.ts +1 -0
  285. package/dist/workflow/index.d.ts.map +1 -1
  286. package/dist/workflow/index.js +5 -3
  287. package/dist/workflow/set-attributes.d.ts +68 -0
  288. package/dist/workflow/set-attributes.d.ts.map +1 -0
  289. package/dist/workflow/set-attributes.js +60 -0
  290. package/dist/workflow/sleep.d.ts.map +1 -1
  291. package/dist/workflow/sleep.js +58 -9
  292. package/dist/workflow/world-init-stub.d.ts +15 -0
  293. package/dist/workflow/world-init-stub.d.ts.map +1 -0
  294. package/dist/workflow/world-init-stub.js +15 -0
  295. package/dist/workflow.d.ts +69 -3
  296. package/dist/workflow.d.ts.map +1 -1
  297. package/dist/workflow.js +791 -554
  298. package/docs/api-reference/create-hook.mdx +79 -0
  299. package/docs/api-reference/create-webhook.mdx +1 -0
  300. package/docs/api-reference/define-hook.mdx +26 -24
  301. package/docs/api-reference/fatal-error.mdx +29 -7
  302. package/docs/api-reference/fetch.mdx +8 -4
  303. package/docs/api-reference/index.mdx +3 -0
  304. package/docs/api-reference/set-attributes.mdx +61 -0
  305. package/docs/api-reference/sleep.mdx +1 -1
  306. package/docs/foundations/cancellation.mdx +459 -0
  307. package/docs/foundations/errors-and-retries.mdx +7 -3
  308. package/docs/foundations/hooks.mdx +29 -0
  309. package/docs/foundations/idempotency.mdx +243 -11
  310. package/docs/foundations/index.mdx +1 -23
  311. package/docs/foundations/meta.json +3 -1
  312. package/docs/foundations/serialization.mdx +77 -41
  313. package/docs/foundations/starting-workflows.mdx +79 -2
  314. package/docs/foundations/streaming.mdx +14 -23
  315. package/docs/foundations/versioning.mdx +263 -0
  316. package/docs/how-it-works/cancellation.mdx +287 -0
  317. package/docs/how-it-works/code-transform.mdx +21 -17
  318. package/docs/how-it-works/encryption.mdx +5 -5
  319. package/docs/how-it-works/event-sourcing.mdx +6 -6
  320. package/docs/how-it-works/framework-integrations.mdx +96 -337
  321. package/docs/how-it-works/meta.json +2 -1
  322. package/package.json +31 -13
  323. package/dist/runtime/step-handler.d.ts +0 -2
  324. package/dist/runtime/step-handler.d.ts.map +0 -1
  325. package/dist/runtime/step-handler.js +0 -678
@@ -0,0 +1,44 @@
1
+ /**
2
+ * VM-compatible copy: identical semantics to step-function.ts before the host-side
3
+ * hardening (#3257) made that module depend on `serialization/hardened.ts`
4
+ * (which imports `node:util` and captures host intrinsics — meaningless
5
+ * and unbundleable inside the QuickJS VM, where the codec already runs in
6
+ * the guest realm). The host/guest boundary hardening for the QuickJS
7
+ * engine lands with the host-side serde (#3263), which retires this
8
+ * bundle entirely. Wire format is identical to the hardened host version.
9
+ */
10
+ /**
11
+ * Reducer and reviver for step function references.
12
+ *
13
+ * In workflow mode, step functions are replaced by the SWC plugin with
14
+ * proxies created by `globalThis[Symbol.for("WORKFLOW_USE_STEP")]("stepId")`.
15
+ * These proxies have a `.stepId` property and optionally a `.__closureVarsFn`
16
+ * for captured closure variables. They may additionally have `.__boundThis`
17
+ * (and rarely `.__boundArgs`) when the SWC plugin emitted
18
+ * `useStep(...).bind(this)` for a nested arrow step that lexically
19
+ * captured `this` (see `packages/swc-plugin-workflow/spec.md` → "Lexical
20
+ * `this` Capture in Nested Arrow Steps").
21
+ *
22
+ * The reducer serializes them as
23
+ * `{ stepId, closureVars?, boundThis?, boundArgs? }`.
24
+ * The reviver reconstructs them by calling WORKFLOW_USE_STEP and, when
25
+ * `boundThis` (or `boundArgs`) is present, re-binding the resulting
26
+ * proxy so the caller's captured `this` (and prefilled args) survive the
27
+ * round trip.
28
+ */
29
+ import type { Reducers, Revivers } from '../types.js';
30
+ export declare function getStepFunctionReducer(): Partial<Reducers>;
31
+ /**
32
+ * Create the StepFunction reviver for workflow context.
33
+ *
34
+ * The reviver calls WORKFLOW_USE_STEP to create the step proxy,
35
+ * restoring the ability to call the step from workflow code. If the
36
+ * serialized payload includes `boundThis` (and optionally `boundArgs`),
37
+ * the reviver also re-binds the freshly-created proxy so a step proxy
38
+ * that was constructed with `.bind(this, …)` in the workflow bundle
39
+ * continues to carry that receiver and any prefilled arguments after
40
+ * being deserialized in another bundle (e.g. when passed as a step
41
+ * argument).
42
+ */
43
+ export declare function getStepFunctionReviver(global?: Record<string, any>): Partial<Revivers>;
44
+ //# sourceMappingURL=step-function-vm.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"step-function-vm.d.ts","sourceRoot":"","sources":["../../../src/serialization/reducers/step-function-vm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAItD,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAuC1D;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAc,GACvC,OAAO,CAAC,QAAQ,CAAC,CA8BnB"}
@@ -0,0 +1,97 @@
1
+ /**
2
+ * VM-compatible copy: identical semantics to step-function.ts before the host-side
3
+ * hardening (#3257) made that module depend on `serialization/hardened.ts`
4
+ * (which imports `node:util` and captures host intrinsics — meaningless
5
+ * and unbundleable inside the QuickJS VM, where the codec already runs in
6
+ * the guest realm). The host/guest boundary hardening for the QuickJS
7
+ * engine lands with the host-side serde (#3263), which retires this
8
+ * bundle entirely. Wire format is identical to the hardened host version.
9
+ */
10
+ /**
11
+ * Reducer and reviver for step function references.
12
+ *
13
+ * In workflow mode, step functions are replaced by the SWC plugin with
14
+ * proxies created by `globalThis[Symbol.for("WORKFLOW_USE_STEP")]("stepId")`.
15
+ * These proxies have a `.stepId` property and optionally a `.__closureVarsFn`
16
+ * for captured closure variables. They may additionally have `.__boundThis`
17
+ * (and rarely `.__boundArgs`) when the SWC plugin emitted
18
+ * `useStep(...).bind(this)` for a nested arrow step that lexically
19
+ * captured `this` (see `packages/swc-plugin-workflow/spec.md` → "Lexical
20
+ * `this` Capture in Nested Arrow Steps").
21
+ *
22
+ * The reducer serializes them as
23
+ * `{ stepId, closureVars?, boundThis?, boundArgs? }`.
24
+ * The reviver reconstructs them by calling WORKFLOW_USE_STEP and, when
25
+ * `boundThis` (or `boundArgs`) is present, re-binding the resulting
26
+ * proxy so the caller's captured `this` (and prefilled args) survive the
27
+ * round trip.
28
+ */
29
+ // ---- Reducer ----
30
+ export function getStepFunctionReducer() {
31
+ return {
32
+ StepFunction: (value) => {
33
+ if (typeof value !== 'function')
34
+ return false;
35
+ const stepId = value.stepId;
36
+ if (typeof stepId !== 'string')
37
+ return false;
38
+ const closureVarsFn = value.__closureVarsFn;
39
+ const closureVars = closureVarsFn && typeof closureVarsFn === 'function'
40
+ ? closureVarsFn()
41
+ : undefined;
42
+ // `__boundThis` / `__boundArgs` are marker properties added by the
43
+ // step proxy's overridden `.bind` (see step.ts) to record the
44
+ // bound receiver and any prefilled arguments. Use `in` for
45
+ // `__boundThis` so we round-trip even when the bound `this` is
46
+ // `undefined`/`null`. `__boundArgs` is only set when the user
47
+ // actually supplied prefilled args, so a missing property means
48
+ // "no prefilled args".
49
+ const hasBoundThis = '__boundThis' in value;
50
+ const boundThis = hasBoundThis ? value.__boundThis : undefined;
51
+ const boundArgs = value.__boundArgs;
52
+ const payload = { stepId };
53
+ if (closureVars !== undefined)
54
+ payload.closureVars = closureVars;
55
+ if (hasBoundThis)
56
+ payload.boundThis = boundThis;
57
+ if (Array.isArray(boundArgs) && boundArgs.length > 0) {
58
+ payload.boundArgs = boundArgs;
59
+ }
60
+ return payload;
61
+ },
62
+ };
63
+ }
64
+ // ---- Reviver ----
65
+ /**
66
+ * Create the StepFunction reviver for workflow context.
67
+ *
68
+ * The reviver calls WORKFLOW_USE_STEP to create the step proxy,
69
+ * restoring the ability to call the step from workflow code. If the
70
+ * serialized payload includes `boundThis` (and optionally `boundArgs`),
71
+ * the reviver also re-binds the freshly-created proxy so a step proxy
72
+ * that was constructed with `.bind(this, …)` in the workflow bundle
73
+ * continues to carry that receiver and any prefilled arguments after
74
+ * being deserialized in another bundle (e.g. when passed as a step
75
+ * argument).
76
+ */
77
+ export function getStepFunctionReviver(global = globalThis) {
78
+ const useStep = global[Symbol.for('WORKFLOW_USE_STEP')];
79
+ return {
80
+ StepFunction: (value) => {
81
+ const stepId = value.stepId;
82
+ const closureVars = value.closureVars;
83
+ if (!useStep) {
84
+ throw new Error('WORKFLOW_USE_STEP not found on global object. Step functions cannot be deserialized outside workflow context.');
85
+ }
86
+ const proxy = closureVars
87
+ ? useStep(stepId, () => closureVars)
88
+ : useStep(stepId);
89
+ if ('boundThis' in value) {
90
+ const boundArgs = Array.isArray(value.boundArgs) ? value.boundArgs : [];
91
+ return proxy.bind(value.boundThis, ...boundArgs);
92
+ }
93
+ return proxy;
94
+ },
95
+ };
96
+ }
97
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RlcC1mdW5jdGlvbi12bS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zZXJpYWxpemF0aW9uL3JlZHVjZXJzL3N0ZXAtZnVuY3Rpb24tdm0udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7O0dBUUc7QUFDSDs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBa0JHO0FBSUgsb0JBQW9CO0FBRXBCLE1BQU0sVUFBVSxzQkFBc0I7SUFDcEMsT0FBTztRQUNMLFlBQVksRUFBRSxDQUFDLEtBQUssRUFBRSxFQUFFO1lBQ3RCLElBQUksT0FBTyxLQUFLLEtBQUssVUFBVTtnQkFBRSxPQUFPLEtBQUssQ0FBQztZQUM5QyxNQUFNLE1BQU0sR0FBSSxLQUFhLENBQUMsTUFBTSxDQUFDO1lBQ3JDLElBQUksT0FBTyxNQUFNLEtBQUssUUFBUTtnQkFBRSxPQUFPLEtBQUssQ0FBQztZQUU3QyxNQUFNLGFBQWEsR0FBSSxLQUFhLENBQUMsZUFBZSxDQUFDO1lBQ3JELE1BQU0sV0FBVyxHQUNmLGFBQWEsSUFBSSxPQUFPLGFBQWEsS0FBSyxVQUFVO2dCQUNsRCxDQUFDLENBQUMsYUFBYSxFQUFFO2dCQUNqQixDQUFDLENBQUMsU0FBUyxDQUFDO1lBRWhCLG1FQUFtRTtZQUNuRSw4REFBOEQ7WUFDOUQsMkRBQTJEO1lBQzNELCtEQUErRDtZQUMvRCw4REFBOEQ7WUFDOUQsZ0VBQWdFO1lBQ2hFLHVCQUF1QjtZQUN2QixNQUFNLFlBQVksR0FBRyxhQUFhLElBQUssS0FBYSxDQUFDO1lBQ3JELE1BQU0sU0FBUyxHQUFHLFlBQVksQ0FBQyxDQUFDLENBQUUsS0FBYSxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO1lBQ3hFLE1BQU0sU0FBUyxHQUFJLEtBQWEsQ0FBQyxXQUFvQyxDQUFDO1lBRXRFLE1BQU0sT0FBTyxHQUtULEVBQUUsTUFBTSxFQUFFLENBQUM7WUFDZixJQUFJLFdBQVcsS0FBSyxTQUFTO2dCQUFFLE9BQU8sQ0FBQyxXQUFXLEdBQUcsV0FBVyxDQUFDO1lBQ2pFLElBQUksWUFBWTtnQkFBRSxPQUFPLENBQUMsU0FBUyxHQUFHLFNBQVMsQ0FBQztZQUNoRCxJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsU0FBUyxDQUFDLElBQUksU0FBUyxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztnQkFDckQsT0FBTyxDQUFDLFNBQVMsR0FBRyxTQUFTLENBQUM7WUFDaEMsQ0FBQztZQUVELE9BQU8sT0FBTyxDQUFDO1FBQ2pCLENBQUM7S0FDRixDQUFDO0FBQ0osQ0FBQztBQUVELG9CQUFvQjtBQUVwQjs7Ozs7Ozs7Ozs7R0FXRztBQUNILE1BQU0sVUFBVSxzQkFBc0IsQ0FDcEMsU0FBOEIsVUFBVTtJQUV4QyxNQUFNLE9BQU8sR0FBSSxNQUFjLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxtQkFBbUIsQ0FBQyxDQUtsRCxDQUFDO0lBRWQsT0FBTztRQUNMLFlBQVksRUFBRSxDQUFDLEtBQUssRUFBRSxFQUFFO1lBQ3RCLE1BQU0sTUFBTSxHQUFHLEtBQUssQ0FBQyxNQUFNLENBQUM7WUFDNUIsTUFBTSxXQUFXLEdBQUcsS0FBSyxDQUFDLFdBQVcsQ0FBQztZQUV0QyxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7Z0JBQ2IsTUFBTSxJQUFJLEtBQUssQ0FDYiwrR0FBK0csQ0FDaEgsQ0FBQztZQUNKLENBQUM7WUFFRCxNQUFNLEtBQUssR0FBRyxXQUFXO2dCQUN2QixDQUFDLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxHQUFHLEVBQUUsQ0FBQyxXQUFXLENBQUM7Z0JBQ3BDLENBQUMsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUM7WUFFcEIsSUFBSSxXQUFXLElBQUksS0FBSyxFQUFFLENBQUM7Z0JBQ3pCLE1BQU0sU0FBUyxHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7Z0JBQ3hFLE9BQVEsS0FBYSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsU0FBUyxFQUFFLEdBQUcsU0FBUyxDQUFDLENBQUM7WUFDNUQsQ0FBQztZQUNELE9BQU8sS0FBSyxDQUFDO1FBQ2YsQ0FBQztLQUNGLENBQUM7QUFDSixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBWTS1jb21wYXRpYmxlIGNvcHk6IGlkZW50aWNhbCBzZW1hbnRpY3MgdG8gc3RlcC1mdW5jdGlvbi50cyBiZWZvcmUgdGhlIGhvc3Qtc2lkZVxuICogaGFyZGVuaW5nICgjMzI1NykgbWFkZSB0aGF0IG1vZHVsZSBkZXBlbmQgb24gYHNlcmlhbGl6YXRpb24vaGFyZGVuZWQudHNgXG4gKiAod2hpY2ggaW1wb3J0cyBgbm9kZTp1dGlsYCBhbmQgY2FwdHVyZXMgaG9zdCBpbnRyaW5zaWNzIOKAlCBtZWFuaW5nbGVzc1xuICogYW5kIHVuYnVuZGxlYWJsZSBpbnNpZGUgdGhlIFF1aWNrSlMgVk0sIHdoZXJlIHRoZSBjb2RlYyBhbHJlYWR5IHJ1bnMgaW5cbiAqIHRoZSBndWVzdCByZWFsbSkuIFRoZSBob3N0L2d1ZXN0IGJvdW5kYXJ5IGhhcmRlbmluZyBmb3IgdGhlIFF1aWNrSlNcbiAqIGVuZ2luZSBsYW5kcyB3aXRoIHRoZSBob3N0LXNpZGUgc2VyZGUgKCMzMjYzKSwgd2hpY2ggcmV0aXJlcyB0aGlzXG4gKiBidW5kbGUgZW50aXJlbHkuIFdpcmUgZm9ybWF0IGlzIGlkZW50aWNhbCB0byB0aGUgaGFyZGVuZWQgaG9zdCB2ZXJzaW9uLlxuICovXG4vKipcbiAqIFJlZHVjZXIgYW5kIHJldml2ZXIgZm9yIHN0ZXAgZnVuY3Rpb24gcmVmZXJlbmNlcy5cbiAqXG4gKiBJbiB3b3JrZmxvdyBtb2RlLCBzdGVwIGZ1bmN0aW9ucyBhcmUgcmVwbGFjZWQgYnkgdGhlIFNXQyBwbHVnaW4gd2l0aFxuICogcHJveGllcyBjcmVhdGVkIGJ5IGBnbG9iYWxUaGlzW1N5bWJvbC5mb3IoXCJXT1JLRkxPV19VU0VfU1RFUFwiKV0oXCJzdGVwSWRcIilgLlxuICogVGhlc2UgcHJveGllcyBoYXZlIGEgYC5zdGVwSWRgIHByb3BlcnR5IGFuZCBvcHRpb25hbGx5IGEgYC5fX2Nsb3N1cmVWYXJzRm5gXG4gKiBmb3IgY2FwdHVyZWQgY2xvc3VyZSB2YXJpYWJsZXMuIFRoZXkgbWF5IGFkZGl0aW9uYWxseSBoYXZlIGAuX19ib3VuZFRoaXNgXG4gKiAoYW5kIHJhcmVseSBgLl9fYm91bmRBcmdzYCkgd2hlbiB0aGUgU1dDIHBsdWdpbiBlbWl0dGVkXG4gKiBgdXNlU3RlcCguLi4pLmJpbmQodGhpcylgIGZvciBhIG5lc3RlZCBhcnJvdyBzdGVwIHRoYXQgbGV4aWNhbGx5XG4gKiBjYXB0dXJlZCBgdGhpc2AgKHNlZSBgcGFja2FnZXMvc3djLXBsdWdpbi13b3JrZmxvdy9zcGVjLm1kYCDihpIgXCJMZXhpY2FsXG4gKiBgdGhpc2AgQ2FwdHVyZSBpbiBOZXN0ZWQgQXJyb3cgU3RlcHNcIikuXG4gKlxuICogVGhlIHJlZHVjZXIgc2VyaWFsaXplcyB0aGVtIGFzXG4gKiAgIGB7IHN0ZXBJZCwgY2xvc3VyZVZhcnM/LCBib3VuZFRoaXM/LCBib3VuZEFyZ3M/IH1gLlxuICogVGhlIHJldml2ZXIgcmVjb25zdHJ1Y3RzIHRoZW0gYnkgY2FsbGluZyBXT1JLRkxPV19VU0VfU1RFUCBhbmQsIHdoZW5cbiAqIGBib3VuZFRoaXNgIChvciBgYm91bmRBcmdzYCkgaXMgcHJlc2VudCwgcmUtYmluZGluZyB0aGUgcmVzdWx0aW5nXG4gKiBwcm94eSBzbyB0aGUgY2FsbGVyJ3MgY2FwdHVyZWQgYHRoaXNgIChhbmQgcHJlZmlsbGVkIGFyZ3MpIHN1cnZpdmUgdGhlXG4gKiByb3VuZCB0cmlwLlxuICovXG5cbmltcG9ydCB0eXBlIHsgUmVkdWNlcnMsIFJldml2ZXJzIH0gZnJvbSAnLi4vdHlwZXMuanMnO1xuXG4vLyAtLS0tIFJlZHVjZXIgLS0tLVxuXG5leHBvcnQgZnVuY3Rpb24gZ2V0U3RlcEZ1bmN0aW9uUmVkdWNlcigpOiBQYXJ0aWFsPFJlZHVjZXJzPiB7XG4gIHJldHVybiB7XG4gICAgU3RlcEZ1bmN0aW9uOiAodmFsdWUpID0+IHtcbiAgICAgIGlmICh0eXBlb2YgdmFsdWUgIT09ICdmdW5jdGlvbicpIHJldHVybiBmYWxzZTtcbiAgICAgIGNvbnN0IHN0ZXBJZCA9ICh2YWx1ZSBhcyBhbnkpLnN0ZXBJZDtcbiAgICAgIGlmICh0eXBlb2Ygc3RlcElkICE9PSAnc3RyaW5nJykgcmV0dXJuIGZhbHNlO1xuXG4gICAgICBjb25zdCBjbG9zdXJlVmFyc0ZuID0gKHZhbHVlIGFzIGFueSkuX19jbG9zdXJlVmFyc0ZuO1xuICAgICAgY29uc3QgY2xvc3VyZVZhcnMgPVxuICAgICAgICBjbG9zdXJlVmFyc0ZuICYmIHR5cGVvZiBjbG9zdXJlVmFyc0ZuID09PSAnZnVuY3Rpb24nXG4gICAgICAgICAgPyBjbG9zdXJlVmFyc0ZuKClcbiAgICAgICAgICA6IHVuZGVmaW5lZDtcblxuICAgICAgLy8gYF9fYm91bmRUaGlzYCAvIGBfX2JvdW5kQXJnc2AgYXJlIG1hcmtlciBwcm9wZXJ0aWVzIGFkZGVkIGJ5IHRoZVxuICAgICAgLy8gc3RlcCBwcm94eSdzIG92ZXJyaWRkZW4gYC5iaW5kYCAoc2VlIHN0ZXAudHMpIHRvIHJlY29yZCB0aGVcbiAgICAgIC8vIGJvdW5kIHJlY2VpdmVyIGFuZCBhbnkgcHJlZmlsbGVkIGFyZ3VtZW50cy4gVXNlIGBpbmAgZm9yXG4gICAgICAvLyBgX19ib3VuZFRoaXNgIHNvIHdlIHJvdW5kLXRyaXAgZXZlbiB3aGVuIHRoZSBib3VuZCBgdGhpc2AgaXNcbiAgICAgIC8vIGB1bmRlZmluZWRgL2BudWxsYC4gYF9fYm91bmRBcmdzYCBpcyBvbmx5IHNldCB3aGVuIHRoZSB1c2VyXG4gICAgICAvLyBhY3R1YWxseSBzdXBwbGllZCBwcmVmaWxsZWQgYXJncywgc28gYSBtaXNzaW5nIHByb3BlcnR5IG1lYW5zXG4gICAgICAvLyBcIm5vIHByZWZpbGxlZCBhcmdzXCIuXG4gICAgICBjb25zdCBoYXNCb3VuZFRoaXMgPSAnX19ib3VuZFRoaXMnIGluICh2YWx1ZSBhcyBhbnkpO1xuICAgICAgY29uc3QgYm91bmRUaGlzID0gaGFzQm91bmRUaGlzID8gKHZhbHVlIGFzIGFueSkuX19ib3VuZFRoaXMgOiB1bmRlZmluZWQ7XG4gICAgICBjb25zdCBib3VuZEFyZ3MgPSAodmFsdWUgYXMgYW55KS5fX2JvdW5kQXJncyBhcyB1bmtub3duW10gfCB1bmRlZmluZWQ7XG5cbiAgICAgIGNvbnN0IHBheWxvYWQ6IHtcbiAgICAgICAgc3RlcElkOiBzdHJpbmc7XG4gICAgICAgIGNsb3N1cmVWYXJzPzogUmVjb3JkPHN0cmluZywgYW55PjtcbiAgICAgICAgYm91bmRUaGlzPzogdW5rbm93bjtcbiAgICAgICAgYm91bmRBcmdzPzogdW5rbm93bltdO1xuICAgICAgfSA9IHsgc3RlcElkIH07XG4gICAgICBpZiAoY2xvc3VyZVZhcnMgIT09IHVuZGVmaW5lZCkgcGF5bG9hZC5jbG9zdXJlVmFycyA9IGNsb3N1cmVWYXJzO1xuICAgICAgaWYgKGhhc0JvdW5kVGhpcykgcGF5bG9hZC5ib3VuZFRoaXMgPSBib3VuZFRoaXM7XG4gICAgICBpZiAoQXJyYXkuaXNBcnJheShib3VuZEFyZ3MpICYmIGJvdW5kQXJncy5sZW5ndGggPiAwKSB7XG4gICAgICAgIHBheWxvYWQuYm91bmRBcmdzID0gYm91bmRBcmdzO1xuICAgICAgfVxuXG4gICAgICByZXR1cm4gcGF5bG9hZDtcbiAgICB9LFxuICB9O1xufVxuXG4vLyAtLS0tIFJldml2ZXIgLS0tLVxuXG4vKipcbiAqIENyZWF0ZSB0aGUgU3RlcEZ1bmN0aW9uIHJldml2ZXIgZm9yIHdvcmtmbG93IGNvbnRleHQuXG4gKlxuICogVGhlIHJldml2ZXIgY2FsbHMgV09SS0ZMT1dfVVNFX1NURVAgdG8gY3JlYXRlIHRoZSBzdGVwIHByb3h5LFxuICogcmVzdG9yaW5nIHRoZSBhYmlsaXR5IHRvIGNhbGwgdGhlIHN0ZXAgZnJvbSB3b3JrZmxvdyBjb2RlLiBJZiB0aGVcbiAqIHNlcmlhbGl6ZWQgcGF5bG9hZCBpbmNsdWRlcyBgYm91bmRUaGlzYCAoYW5kIG9wdGlvbmFsbHkgYGJvdW5kQXJnc2ApLFxuICogdGhlIHJldml2ZXIgYWxzbyByZS1iaW5kcyB0aGUgZnJlc2hseS1jcmVhdGVkIHByb3h5IHNvIGEgc3RlcCBwcm94eVxuICogdGhhdCB3YXMgY29uc3RydWN0ZWQgd2l0aCBgLmJpbmQodGhpcywg4oCmKWAgaW4gdGhlIHdvcmtmbG93IGJ1bmRsZVxuICogY29udGludWVzIHRvIGNhcnJ5IHRoYXQgcmVjZWl2ZXIgYW5kIGFueSBwcmVmaWxsZWQgYXJndW1lbnRzIGFmdGVyXG4gKiBiZWluZyBkZXNlcmlhbGl6ZWQgaW4gYW5vdGhlciBidW5kbGUgKGUuZy4gd2hlbiBwYXNzZWQgYXMgYSBzdGVwXG4gKiBhcmd1bWVudCkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRTdGVwRnVuY3Rpb25SZXZpdmVyKFxuICBnbG9iYWw6IFJlY29yZDxzdHJpbmcsIGFueT4gPSBnbG9iYWxUaGlzXG4pOiBQYXJ0aWFsPFJldml2ZXJzPiB7XG4gIGNvbnN0IHVzZVN0ZXAgPSAoZ2xvYmFsIGFzIGFueSlbU3ltYm9sLmZvcignV09SS0ZMT1dfVVNFX1NURVAnKV0gYXNcbiAgICB8ICgoXG4gICAgICAgIHN0ZXBJZDogc3RyaW5nLFxuICAgICAgICBjbG9zdXJlVmFyc0ZuPzogKCkgPT4gUmVjb3JkPHN0cmluZywgdW5rbm93bj5cbiAgICAgICkgPT4gKC4uLmFyZ3M6IHVua25vd25bXSkgPT4gUHJvbWlzZTx1bmtub3duPilcbiAgICB8IHVuZGVmaW5lZDtcblxuICByZXR1cm4ge1xuICAgIFN0ZXBGdW5jdGlvbjogKHZhbHVlKSA9PiB7XG4gICAgICBjb25zdCBzdGVwSWQgPSB2YWx1ZS5zdGVwSWQ7XG4gICAgICBjb25zdCBjbG9zdXJlVmFycyA9IHZhbHVlLmNsb3N1cmVWYXJzO1xuXG4gICAgICBpZiAoIXVzZVN0ZXApIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICAgICdXT1JLRkxPV19VU0VfU1RFUCBub3QgZm91bmQgb24gZ2xvYmFsIG9iamVjdC4gU3RlcCBmdW5jdGlvbnMgY2Fubm90IGJlIGRlc2VyaWFsaXplZCBvdXRzaWRlIHdvcmtmbG93IGNvbnRleHQuJ1xuICAgICAgICApO1xuICAgICAgfVxuXG4gICAgICBjb25zdCBwcm94eSA9IGNsb3N1cmVWYXJzXG4gICAgICAgID8gdXNlU3RlcChzdGVwSWQsICgpID0+IGNsb3N1cmVWYXJzKVxuICAgICAgICA6IHVzZVN0ZXAoc3RlcElkKTtcblxuICAgICAgaWYgKCdib3VuZFRoaXMnIGluIHZhbHVlKSB7XG4gICAgICAgIGNvbnN0IGJvdW5kQXJncyA9IEFycmF5LmlzQXJyYXkodmFsdWUuYm91bmRBcmdzKSA/IHZhbHVlLmJvdW5kQXJncyA6IFtdO1xuICAgICAgICByZXR1cm4gKHByb3h5IGFzIGFueSkuYmluZCh2YWx1ZS5ib3VuZFRoaXMsIC4uLmJvdW5kQXJncyk7XG4gICAgICB9XG4gICAgICByZXR1cm4gcHJveHk7XG4gICAgfSxcbiAgfTtcbn1cbiJdfQ==
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Reducer and reviver for step function references.
3
+ *
4
+ * In workflow mode, step functions are replaced by the SWC plugin with
5
+ * proxies created by `globalThis[Symbol.for("WORKFLOW_USE_STEP")]("stepId")`.
6
+ * These proxies have a `.stepId` property and optionally a `.__closureVarsFn`
7
+ * for captured closure variables. They may additionally have `.__boundThis`
8
+ * (and rarely `.__boundArgs`) when the SWC plugin emitted
9
+ * `useStep(...).bind(this)` for a nested arrow step that lexically
10
+ * captured `this` (see `packages/swc-plugin-workflow/spec.md` → "Lexical
11
+ * `this` Capture in Nested Arrow Steps").
12
+ *
13
+ * The reducer serializes them as
14
+ * `{ stepId, closureVars?, boundThis?, boundArgs? }`.
15
+ * The reviver reconstructs them by calling WORKFLOW_USE_STEP and, when
16
+ * `boundThis` (or `boundArgs`) is present, re-binding the resulting
17
+ * proxy so the caller's captured `this` (and prefilled args) survive the
18
+ * round trip.
19
+ */
20
+ import type { Reducers, Revivers } from '../types.js';
21
+ export declare function getStepFunctionReducer(): Partial<Reducers>;
22
+ /**
23
+ * Create the StepFunction reviver for workflow context.
24
+ *
25
+ * The reviver calls WORKFLOW_USE_STEP to create the step proxy,
26
+ * restoring the ability to call the step from workflow code. If the
27
+ * serialized payload includes `boundThis` (and optionally `boundArgs`),
28
+ * the reviver also re-binds the freshly-created proxy so a step proxy
29
+ * that was constructed with `.bind(this, …)` in the workflow bundle
30
+ * continues to carry that receiver and any prefilled arguments after
31
+ * being deserialized in another bundle (e.g. when passed as a step
32
+ * argument).
33
+ */
34
+ export declare function getStepFunctionReviver(global?: Record<string, any>): Partial<Revivers>;
35
+ //# sourceMappingURL=step-function.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"step-function.d.ts","sourceRoot":"","sources":["../../../src/serialization/reducers/step-function.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAItD,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAuD1D;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAc,GACvC,OAAO,CAAC,QAAQ,CAAC,CA8BnB"}
@@ -0,0 +1,104 @@
1
+ /**
2
+ * Reducer and reviver for step function references.
3
+ *
4
+ * In workflow mode, step functions are replaced by the SWC plugin with
5
+ * proxies created by `globalThis[Symbol.for("WORKFLOW_USE_STEP")]("stepId")`.
6
+ * These proxies have a `.stepId` property and optionally a `.__closureVarsFn`
7
+ * for captured closure variables. They may additionally have `.__boundThis`
8
+ * (and rarely `.__boundArgs`) when the SWC plugin emitted
9
+ * `useStep(...).bind(this)` for a nested arrow step that lexically
10
+ * captured `this` (see `packages/swc-plugin-workflow/spec.md` → "Lexical
11
+ * `this` Capture in Nested Arrow Steps").
12
+ *
13
+ * The reducer serializes them as
14
+ * `{ stepId, closureVars?, boundThis?, boundArgs? }`.
15
+ * The reviver reconstructs them by calling WORKFLOW_USE_STEP and, when
16
+ * `boundThis` (or `boundArgs`) is present, re-binding the resulting
17
+ * proxy so the caller's captured `this` (and prefilled args) survive the
18
+ * round trip.
19
+ */
20
+ import { hasProperty, isUseStepClosureFn, readProperty, recordGuestCode, } from '../hardened.js';
21
+ // ---- Reducer ----
22
+ export function getStepFunctionReducer() {
23
+ return {
24
+ StepFunction: (value) => {
25
+ if (typeof value !== 'function')
26
+ return false;
27
+ const stepId = readProperty(value, 'stepId');
28
+ if (typeof stepId !== 'string')
29
+ return false;
30
+ const closureVarsFn = readProperty(value, '__closureVarsFn');
31
+ // The reducer has to invoke this to read the step's captured closure
32
+ // variables. The compiler-generated function is a sequence of lexical
33
+ // reads and cannot perturb observable VM state, so reporting it would
34
+ // flag every step that captures a variable — but the property is
35
+ // reachable from workflow code, which can replace it with anything.
36
+ // `step.ts` marks the function that came through `useStep` when it
37
+ // builds the proxy, so this is checked rather than assumed; anything
38
+ // unrecognized is reported like other guest code. See
39
+ // `markUseStepClosureFn` for what the mark does and does not prove.
40
+ let closureVars;
41
+ if (typeof closureVarsFn === 'function') {
42
+ if (!isUseStepClosureFn(closureVarsFn)) {
43
+ recordGuestCode('method', '__closureVarsFn');
44
+ }
45
+ closureVars = closureVarsFn();
46
+ }
47
+ // `__boundThis` / `__boundArgs` are marker properties added by the
48
+ // step proxy's overridden `.bind` (see step.ts) to record the
49
+ // bound receiver and any prefilled arguments. Use `in` for
50
+ // `__boundThis` so we round-trip even when the bound `this` is
51
+ // `undefined`/`null`. `__boundArgs` is only set when the user
52
+ // actually supplied prefilled args, so a missing property means
53
+ // "no prefilled args".
54
+ const hasBoundThis = hasProperty(value, '__boundThis');
55
+ const boundThis = hasBoundThis
56
+ ? readProperty(value, '__boundThis')
57
+ : undefined;
58
+ const boundArgs = readProperty(value, '__boundArgs');
59
+ const payload = { stepId };
60
+ if (closureVars !== undefined)
61
+ payload.closureVars = closureVars;
62
+ if (hasBoundThis)
63
+ payload.boundThis = boundThis;
64
+ if (Array.isArray(boundArgs) && boundArgs.length > 0) {
65
+ payload.boundArgs = boundArgs;
66
+ }
67
+ return payload;
68
+ },
69
+ };
70
+ }
71
+ // ---- Reviver ----
72
+ /**
73
+ * Create the StepFunction reviver for workflow context.
74
+ *
75
+ * The reviver calls WORKFLOW_USE_STEP to create the step proxy,
76
+ * restoring the ability to call the step from workflow code. If the
77
+ * serialized payload includes `boundThis` (and optionally `boundArgs`),
78
+ * the reviver also re-binds the freshly-created proxy so a step proxy
79
+ * that was constructed with `.bind(this, …)` in the workflow bundle
80
+ * continues to carry that receiver and any prefilled arguments after
81
+ * being deserialized in another bundle (e.g. when passed as a step
82
+ * argument).
83
+ */
84
+ export function getStepFunctionReviver(global = globalThis) {
85
+ const useStep = global[Symbol.for('WORKFLOW_USE_STEP')];
86
+ return {
87
+ StepFunction: (value) => {
88
+ const stepId = value.stepId;
89
+ const closureVars = value.closureVars;
90
+ if (!useStep) {
91
+ throw new Error('WORKFLOW_USE_STEP not found on global object. Step functions cannot be deserialized outside workflow context.');
92
+ }
93
+ const proxy = closureVars
94
+ ? useStep(stepId, () => closureVars)
95
+ : useStep(stepId);
96
+ if ('boundThis' in value) {
97
+ const boundArgs = Array.isArray(value.boundArgs) ? value.boundArgs : [];
98
+ return proxy.bind(value.boundThis, ...boundArgs);
99
+ }
100
+ return proxy;
101
+ },
102
+ };
103
+ }
104
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RlcC1mdW5jdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zZXJpYWxpemF0aW9uL3JlZHVjZXJzL3N0ZXAtZnVuY3Rpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQWtCRztBQUVILE9BQU8sRUFDTCxXQUFXLEVBQ1gsa0JBQWtCLEVBQ2xCLFlBQVksRUFDWixlQUFlLEdBQ2hCLE1BQU0sZ0JBQWdCLENBQUM7QUFHeEIsb0JBQW9CO0FBRXBCLE1BQU0sVUFBVSxzQkFBc0I7SUFDcEMsT0FBTztRQUNMLFlBQVksRUFBRSxDQUFDLEtBQUssRUFBRSxFQUFFO1lBQ3RCLElBQUksT0FBTyxLQUFLLEtBQUssVUFBVTtnQkFBRSxPQUFPLEtBQUssQ0FBQztZQUM5QyxNQUFNLE1BQU0sR0FBRyxZQUFZLENBQUMsS0FBSyxFQUFFLFFBQVEsQ0FBQyxDQUFDO1lBQzdDLElBQUksT0FBTyxNQUFNLEtBQUssUUFBUTtnQkFBRSxPQUFPLEtBQUssQ0FBQztZQUU3QyxNQUFNLGFBQWEsR0FBRyxZQUFZLENBQUMsS0FBSyxFQUFFLGlCQUFpQixDQUFDLENBQUM7WUFDN0QscUVBQXFFO1lBQ3JFLHNFQUFzRTtZQUN0RSxzRUFBc0U7WUFDdEUsaUVBQWlFO1lBQ2pFLG9FQUFvRTtZQUNwRSxtRUFBbUU7WUFDbkUscUVBQXFFO1lBQ3JFLHNEQUFzRDtZQUN0RCxvRUFBb0U7WUFDcEUsSUFBSSxXQUFnRCxDQUFDO1lBQ3JELElBQUksT0FBTyxhQUFhLEtBQUssVUFBVSxFQUFFLENBQUM7Z0JBQ3hDLElBQUksQ0FBQyxrQkFBa0IsQ0FBQyxhQUFhLENBQUMsRUFBRSxDQUFDO29CQUN2QyxlQUFlLENBQUMsUUFBUSxFQUFFLGlCQUFpQixDQUFDLENBQUM7Z0JBQy9DLENBQUM7Z0JBQ0QsV0FBVyxHQUFJLGFBQStDLEVBQUUsQ0FBQztZQUNuRSxDQUFDO1lBRUQsbUVBQW1FO1lBQ25FLDhEQUE4RDtZQUM5RCwyREFBMkQ7WUFDM0QsK0RBQStEO1lBQy9ELDhEQUE4RDtZQUM5RCxnRUFBZ0U7WUFDaEUsdUJBQXVCO1lBQ3ZCLE1BQU0sWUFBWSxHQUFHLFdBQVcsQ0FBQyxLQUFLLEVBQUUsYUFBYSxDQUFDLENBQUM7WUFDdkQsTUFBTSxTQUFTLEdBQUcsWUFBWTtnQkFDNUIsQ0FBQyxDQUFDLFlBQVksQ0FBQyxLQUFLLEVBQUUsYUFBYSxDQUFDO2dCQUNwQyxDQUFDLENBQUMsU0FBUyxDQUFDO1lBQ2QsTUFBTSxTQUFTLEdBQUcsWUFBWSxDQUFDLEtBQUssRUFBRSxhQUFhLENBRXRDLENBQUM7WUFFZCxNQUFNLE9BQU8sR0FLVCxFQUFFLE1BQU0sRUFBRSxDQUFDO1lBQ2YsSUFBSSxXQUFXLEtBQUssU0FBUztnQkFBRSxPQUFPLENBQUMsV0FBVyxHQUFHLFdBQVcsQ0FBQztZQUNqRSxJQUFJLFlBQVk7Z0JBQUUsT0FBTyxDQUFDLFNBQVMsR0FBRyxTQUFTLENBQUM7WUFDaEQsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLFNBQVMsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUM7Z0JBQ3JELE9BQU8sQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFDO1lBQ2hDLENBQUM7WUFFRCxPQUFPLE9BQU8sQ0FBQztRQUNqQixDQUFDO0tBQ0YsQ0FBQztBQUNKLENBQUM7QUFFRCxvQkFBb0I7QUFFcEI7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLFVBQVUsc0JBQXNCLENBQ3BDLFNBQThCLFVBQVU7SUFFeEMsTUFBTSxPQUFPLEdBQUksTUFBYyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsbUJBQW1CLENBQUMsQ0FLbEQsQ0FBQztJQUVkLE9BQU87UUFDTCxZQUFZLEVBQUUsQ0FBQyxLQUFLLEVBQUUsRUFBRTtZQUN0QixNQUFNLE1BQU0sR0FBRyxLQUFLLENBQUMsTUFBTSxDQUFDO1lBQzVCLE1BQU0sV0FBVyxHQUFHLEtBQUssQ0FBQyxXQUFXLENBQUM7WUFFdEMsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDO2dCQUNiLE1BQU0sSUFBSSxLQUFLLENBQ2IsK0dBQStHLENBQ2hILENBQUM7WUFDSixDQUFDO1lBRUQsTUFBTSxLQUFLLEdBQUcsV0FBVztnQkFDdkIsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsR0FBRyxFQUFFLENBQUMsV0FBVyxDQUFDO2dCQUNwQyxDQUFDLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO1lBRXBCLElBQUksV0FBVyxJQUFJLEtBQUssRUFBRSxDQUFDO2dCQUN6QixNQUFNLFNBQVMsR0FBRyxLQUFLLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO2dCQUN4RSxPQUFRLEtBQWEsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLFNBQVMsRUFBRSxHQUFHLFNBQVMsQ0FBQyxDQUFDO1lBQzVELENBQUM7WUFDRCxPQUFPLEtBQUssQ0FBQztRQUNmLENBQUM7S0FDRixDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogUmVkdWNlciBhbmQgcmV2aXZlciBmb3Igc3RlcCBmdW5jdGlvbiByZWZlcmVuY2VzLlxuICpcbiAqIEluIHdvcmtmbG93IG1vZGUsIHN0ZXAgZnVuY3Rpb25zIGFyZSByZXBsYWNlZCBieSB0aGUgU1dDIHBsdWdpbiB3aXRoXG4gKiBwcm94aWVzIGNyZWF0ZWQgYnkgYGdsb2JhbFRoaXNbU3ltYm9sLmZvcihcIldPUktGTE9XX1VTRV9TVEVQXCIpXShcInN0ZXBJZFwiKWAuXG4gKiBUaGVzZSBwcm94aWVzIGhhdmUgYSBgLnN0ZXBJZGAgcHJvcGVydHkgYW5kIG9wdGlvbmFsbHkgYSBgLl9fY2xvc3VyZVZhcnNGbmBcbiAqIGZvciBjYXB0dXJlZCBjbG9zdXJlIHZhcmlhYmxlcy4gVGhleSBtYXkgYWRkaXRpb25hbGx5IGhhdmUgYC5fX2JvdW5kVGhpc2BcbiAqIChhbmQgcmFyZWx5IGAuX19ib3VuZEFyZ3NgKSB3aGVuIHRoZSBTV0MgcGx1Z2luIGVtaXR0ZWRcbiAqIGB1c2VTdGVwKC4uLikuYmluZCh0aGlzKWAgZm9yIGEgbmVzdGVkIGFycm93IHN0ZXAgdGhhdCBsZXhpY2FsbHlcbiAqIGNhcHR1cmVkIGB0aGlzYCAoc2VlIGBwYWNrYWdlcy9zd2MtcGx1Z2luLXdvcmtmbG93L3NwZWMubWRgIOKGkiBcIkxleGljYWxcbiAqIGB0aGlzYCBDYXB0dXJlIGluIE5lc3RlZCBBcnJvdyBTdGVwc1wiKS5cbiAqXG4gKiBUaGUgcmVkdWNlciBzZXJpYWxpemVzIHRoZW0gYXNcbiAqICAgYHsgc3RlcElkLCBjbG9zdXJlVmFycz8sIGJvdW5kVGhpcz8sIGJvdW5kQXJncz8gfWAuXG4gKiBUaGUgcmV2aXZlciByZWNvbnN0cnVjdHMgdGhlbSBieSBjYWxsaW5nIFdPUktGTE9XX1VTRV9TVEVQIGFuZCwgd2hlblxuICogYGJvdW5kVGhpc2AgKG9yIGBib3VuZEFyZ3NgKSBpcyBwcmVzZW50LCByZS1iaW5kaW5nIHRoZSByZXN1bHRpbmdcbiAqIHByb3h5IHNvIHRoZSBjYWxsZXIncyBjYXB0dXJlZCBgdGhpc2AgKGFuZCBwcmVmaWxsZWQgYXJncykgc3Vydml2ZSB0aGVcbiAqIHJvdW5kIHRyaXAuXG4gKi9cblxuaW1wb3J0IHtcbiAgaGFzUHJvcGVydHksXG4gIGlzVXNlU3RlcENsb3N1cmVGbixcbiAgcmVhZFByb3BlcnR5LFxuICByZWNvcmRHdWVzdENvZGUsXG59IGZyb20gJy4uL2hhcmRlbmVkLmpzJztcbmltcG9ydCB0eXBlIHsgUmVkdWNlcnMsIFJldml2ZXJzIH0gZnJvbSAnLi4vdHlwZXMuanMnO1xuXG4vLyAtLS0tIFJlZHVjZXIgLS0tLVxuXG5leHBvcnQgZnVuY3Rpb24gZ2V0U3RlcEZ1bmN0aW9uUmVkdWNlcigpOiBQYXJ0aWFsPFJlZHVjZXJzPiB7XG4gIHJldHVybiB7XG4gICAgU3RlcEZ1bmN0aW9uOiAodmFsdWUpID0+IHtcbiAgICAgIGlmICh0eXBlb2YgdmFsdWUgIT09ICdmdW5jdGlvbicpIHJldHVybiBmYWxzZTtcbiAgICAgIGNvbnN0IHN0ZXBJZCA9IHJlYWRQcm9wZXJ0eSh2YWx1ZSwgJ3N0ZXBJZCcpO1xuICAgICAgaWYgKHR5cGVvZiBzdGVwSWQgIT09ICdzdHJpbmcnKSByZXR1cm4gZmFsc2U7XG5cbiAgICAgIGNvbnN0IGNsb3N1cmVWYXJzRm4gPSByZWFkUHJvcGVydHkodmFsdWUsICdfX2Nsb3N1cmVWYXJzRm4nKTtcbiAgICAgIC8vIFRoZSByZWR1Y2VyIGhhcyB0byBpbnZva2UgdGhpcyB0byByZWFkIHRoZSBzdGVwJ3MgY2FwdHVyZWQgY2xvc3VyZVxuICAgICAgLy8gdmFyaWFibGVzLiBUaGUgY29tcGlsZXItZ2VuZXJhdGVkIGZ1bmN0aW9uIGlzIGEgc2VxdWVuY2Ugb2YgbGV4aWNhbFxuICAgICAgLy8gcmVhZHMgYW5kIGNhbm5vdCBwZXJ0dXJiIG9ic2VydmFibGUgVk0gc3RhdGUsIHNvIHJlcG9ydGluZyBpdCB3b3VsZFxuICAgICAgLy8gZmxhZyBldmVyeSBzdGVwIHRoYXQgY2FwdHVyZXMgYSB2YXJpYWJsZSDigJQgYnV0IHRoZSBwcm9wZXJ0eSBpc1xuICAgICAgLy8gcmVhY2hhYmxlIGZyb20gd29ya2Zsb3cgY29kZSwgd2hpY2ggY2FuIHJlcGxhY2UgaXQgd2l0aCBhbnl0aGluZy5cbiAgICAgIC8vIGBzdGVwLnRzYCBtYXJrcyB0aGUgZnVuY3Rpb24gdGhhdCBjYW1lIHRocm91Z2ggYHVzZVN0ZXBgIHdoZW4gaXRcbiAgICAgIC8vIGJ1aWxkcyB0aGUgcHJveHksIHNvIHRoaXMgaXMgY2hlY2tlZCByYXRoZXIgdGhhbiBhc3N1bWVkOyBhbnl0aGluZ1xuICAgICAgLy8gdW5yZWNvZ25pemVkIGlzIHJlcG9ydGVkIGxpa2Ugb3RoZXIgZ3Vlc3QgY29kZS4gU2VlXG4gICAgICAvLyBgbWFya1VzZVN0ZXBDbG9zdXJlRm5gIGZvciB3aGF0IHRoZSBtYXJrIGRvZXMgYW5kIGRvZXMgbm90IHByb3ZlLlxuICAgICAgbGV0IGNsb3N1cmVWYXJzOiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPiB8IHVuZGVmaW5lZDtcbiAgICAgIGlmICh0eXBlb2YgY2xvc3VyZVZhcnNGbiA9PT0gJ2Z1bmN0aW9uJykge1xuICAgICAgICBpZiAoIWlzVXNlU3RlcENsb3N1cmVGbihjbG9zdXJlVmFyc0ZuKSkge1xuICAgICAgICAgIHJlY29yZEd1ZXN0Q29kZSgnbWV0aG9kJywgJ19fY2xvc3VyZVZhcnNGbicpO1xuICAgICAgICB9XG4gICAgICAgIGNsb3N1cmVWYXJzID0gKGNsb3N1cmVWYXJzRm4gYXMgKCkgPT4gUmVjb3JkPHN0cmluZywgdW5rbm93bj4pKCk7XG4gICAgICB9XG5cbiAgICAgIC8vIGBfX2JvdW5kVGhpc2AgLyBgX19ib3VuZEFyZ3NgIGFyZSBtYXJrZXIgcHJvcGVydGllcyBhZGRlZCBieSB0aGVcbiAgICAgIC8vIHN0ZXAgcHJveHkncyBvdmVycmlkZGVuIGAuYmluZGAgKHNlZSBzdGVwLnRzKSB0byByZWNvcmQgdGhlXG4gICAgICAvLyBib3VuZCByZWNlaXZlciBhbmQgYW55IHByZWZpbGxlZCBhcmd1bWVudHMuIFVzZSBgaW5gIGZvclxuICAgICAgLy8gYF9fYm91bmRUaGlzYCBzbyB3ZSByb3VuZC10cmlwIGV2ZW4gd2hlbiB0aGUgYm91bmQgYHRoaXNgIGlzXG4gICAgICAvLyBgdW5kZWZpbmVkYC9gbnVsbGAuIGBfX2JvdW5kQXJnc2AgaXMgb25seSBzZXQgd2hlbiB0aGUgdXNlclxuICAgICAgLy8gYWN0dWFsbHkgc3VwcGxpZWQgcHJlZmlsbGVkIGFyZ3MsIHNvIGEgbWlzc2luZyBwcm9wZXJ0eSBtZWFuc1xuICAgICAgLy8gXCJubyBwcmVmaWxsZWQgYXJnc1wiLlxuICAgICAgY29uc3QgaGFzQm91bmRUaGlzID0gaGFzUHJvcGVydHkodmFsdWUsICdfX2JvdW5kVGhpcycpO1xuICAgICAgY29uc3QgYm91bmRUaGlzID0gaGFzQm91bmRUaGlzXG4gICAgICAgID8gcmVhZFByb3BlcnR5KHZhbHVlLCAnX19ib3VuZFRoaXMnKVxuICAgICAgICA6IHVuZGVmaW5lZDtcbiAgICAgIGNvbnN0IGJvdW5kQXJncyA9IHJlYWRQcm9wZXJ0eSh2YWx1ZSwgJ19fYm91bmRBcmdzJykgYXNcbiAgICAgICAgfCB1bmtub3duW11cbiAgICAgICAgfCB1bmRlZmluZWQ7XG5cbiAgICAgIGNvbnN0IHBheWxvYWQ6IHtcbiAgICAgICAgc3RlcElkOiBzdHJpbmc7XG4gICAgICAgIGNsb3N1cmVWYXJzPzogUmVjb3JkPHN0cmluZywgYW55PjtcbiAgICAgICAgYm91bmRUaGlzPzogdW5rbm93bjtcbiAgICAgICAgYm91bmRBcmdzPzogdW5rbm93bltdO1xuICAgICAgfSA9IHsgc3RlcElkIH07XG4gICAgICBpZiAoY2xvc3VyZVZhcnMgIT09IHVuZGVmaW5lZCkgcGF5bG9hZC5jbG9zdXJlVmFycyA9IGNsb3N1cmVWYXJzO1xuICAgICAgaWYgKGhhc0JvdW5kVGhpcykgcGF5bG9hZC5ib3VuZFRoaXMgPSBib3VuZFRoaXM7XG4gICAgICBpZiAoQXJyYXkuaXNBcnJheShib3VuZEFyZ3MpICYmIGJvdW5kQXJncy5sZW5ndGggPiAwKSB7XG4gICAgICAgIHBheWxvYWQuYm91bmRBcmdzID0gYm91bmRBcmdzO1xuICAgICAgfVxuXG4gICAgICByZXR1cm4gcGF5bG9hZDtcbiAgICB9LFxuICB9O1xufVxuXG4vLyAtLS0tIFJldml2ZXIgLS0tLVxuXG4vKipcbiAqIENyZWF0ZSB0aGUgU3RlcEZ1bmN0aW9uIHJldml2ZXIgZm9yIHdvcmtmbG93IGNvbnRleHQuXG4gKlxuICogVGhlIHJldml2ZXIgY2FsbHMgV09SS0ZMT1dfVVNFX1NURVAgdG8gY3JlYXRlIHRoZSBzdGVwIHByb3h5LFxuICogcmVzdG9yaW5nIHRoZSBhYmlsaXR5IHRvIGNhbGwgdGhlIHN0ZXAgZnJvbSB3b3JrZmxvdyBjb2RlLiBJZiB0aGVcbiAqIHNlcmlhbGl6ZWQgcGF5bG9hZCBpbmNsdWRlcyBgYm91bmRUaGlzYCAoYW5kIG9wdGlvbmFsbHkgYGJvdW5kQXJnc2ApLFxuICogdGhlIHJldml2ZXIgYWxzbyByZS1iaW5kcyB0aGUgZnJlc2hseS1jcmVhdGVkIHByb3h5IHNvIGEgc3RlcCBwcm94eVxuICogdGhhdCB3YXMgY29uc3RydWN0ZWQgd2l0aCBgLmJpbmQodGhpcywg4oCmKWAgaW4gdGhlIHdvcmtmbG93IGJ1bmRsZVxuICogY29udGludWVzIHRvIGNhcnJ5IHRoYXQgcmVjZWl2ZXIgYW5kIGFueSBwcmVmaWxsZWQgYXJndW1lbnRzIGFmdGVyXG4gKiBiZWluZyBkZXNlcmlhbGl6ZWQgaW4gYW5vdGhlciBidW5kbGUgKGUuZy4gd2hlbiBwYXNzZWQgYXMgYSBzdGVwXG4gKiBhcmd1bWVudCkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRTdGVwRnVuY3Rpb25SZXZpdmVyKFxuICBnbG9iYWw6IFJlY29yZDxzdHJpbmcsIGFueT4gPSBnbG9iYWxUaGlzXG4pOiBQYXJ0aWFsPFJldml2ZXJzPiB7XG4gIGNvbnN0IHVzZVN0ZXAgPSAoZ2xvYmFsIGFzIGFueSlbU3ltYm9sLmZvcignV09SS0ZMT1dfVVNFX1NURVAnKV0gYXNcbiAgICB8ICgoXG4gICAgICAgIHN0ZXBJZDogc3RyaW5nLFxuICAgICAgICBjbG9zdXJlVmFyc0ZuPzogKCkgPT4gUmVjb3JkPHN0cmluZywgdW5rbm93bj5cbiAgICAgICkgPT4gKC4uLmFyZ3M6IHVua25vd25bXSkgPT4gUHJvbWlzZTx1bmtub3duPilcbiAgICB8IHVuZGVmaW5lZDtcblxuICByZXR1cm4ge1xuICAgIFN0ZXBGdW5jdGlvbjogKHZhbHVlKSA9PiB7XG4gICAgICBjb25zdCBzdGVwSWQgPSB2YWx1ZS5zdGVwSWQ7XG4gICAgICBjb25zdCBjbG9zdXJlVmFycyA9IHZhbHVlLmNsb3N1cmVWYXJzO1xuXG4gICAgICBpZiAoIXVzZVN0ZXApIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICAgICdXT1JLRkxPV19VU0VfU1RFUCBub3QgZm91bmQgb24gZ2xvYmFsIG9iamVjdC4gU3RlcCBmdW5jdGlvbnMgY2Fubm90IGJlIGRlc2VyaWFsaXplZCBvdXRzaWRlIHdvcmtmbG93IGNvbnRleHQuJ1xuICAgICAgICApO1xuICAgICAgfVxuXG4gICAgICBjb25zdCBwcm94eSA9IGNsb3N1cmVWYXJzXG4gICAgICAgID8gdXNlU3RlcChzdGVwSWQsICgpID0+IGNsb3N1cmVWYXJzKVxuICAgICAgICA6IHVzZVN0ZXAoc3RlcElkKTtcblxuICAgICAgaWYgKCdib3VuZFRoaXMnIGluIHZhbHVlKSB7XG4gICAgICAgIGNvbnN0IGJvdW5kQXJncyA9IEFycmF5LmlzQXJyYXkodmFsdWUuYm91bmRBcmdzKSA/IHZhbHVlLmJvdW5kQXJncyA6IFtdO1xuICAgICAgICByZXR1cm4gKHByb3h5IGFzIGFueSkuYmluZCh2YWx1ZS5ib3VuZFRoaXMsIC4uLmJvdW5kQXJncyk7XG4gICAgICB9XG4gICAgICByZXR1cm4gcHJveHk7XG4gICAgfSxcbiAgfTtcbn1cbiJdfQ==
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Step mode serialization.
3
+ *
4
+ * Used by the step executor for serializing step return values and
5
+ * deserializing step arguments. Supports encryption as a composable layer.
6
+ */
7
+ import type { CodecOptions } from './codec.js';
8
+ import { type PayloadKey } from './encryption.js';
9
+ /**
10
+ * Serialize a value from the step execution environment.
11
+ */
12
+ export declare function serialize(value: unknown, encryptionKey?: PayloadKey, options?: CodecOptions): Promise<Uint8Array | unknown>;
13
+ /**
14
+ * Deserialize a value for the step execution environment.
15
+ */
16
+ export declare function deserialize(data: Uint8Array | unknown, encryptionKey?: PayloadKey, options?: CodecOptions): Promise<unknown>;
17
+ //# sourceMappingURL=step.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/serialization/step.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAKzB;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,OAAO,EACd,aAAa,CAAC,EAAE,UAAU,EAC1B,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,CAmB/B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,UAAU,GAAG,OAAO,EAC1B,aAAa,CAAC,EAAE,UAAU,EAC1B,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,OAAO,CAAC,CAsBlB"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Step mode serialization.
3
+ *
4
+ * Used by the step executor for serializing step return values and
5
+ * deserializing step arguments. Supports encryption as a composable layer.
6
+ */
7
+ import { SerializationError } from '@workflow/errors';
8
+ import { devalueCodec } from './codec-devalue.js';
9
+ import { compress, decompress } from './compression.js';
10
+ import { decrypt as decryptData, encrypt as encryptData, } from './encryption.js';
11
+ import { formatSerializationError, rethrowIfRuntimeError } from './errors.js';
12
+ import { decodeFormatPrefix, encodeWithFormatPrefix } from './format.js';
13
+ import { SerializationFormat } from './types.js';
14
+ /**
15
+ * Serialize a value from the step execution environment.
16
+ */
17
+ export async function serialize(value, encryptionKey, options) {
18
+ try {
19
+ const payload = devalueCodec.serialize(value, 'step', options);
20
+ const prefixed = encodeWithFormatPrefix(SerializationFormat.DEVALUE_V1, payload);
21
+ // Compress before encrypting — encrypted bytes don't compress.
22
+ const compressed = await compress(prefixed, options?.compression === true, options?.compressionStats);
23
+ return encryptData(compressed, encryptionKey);
24
+ }
25
+ catch (error) {
26
+ rethrowIfRuntimeError(error);
27
+ const { message, hint } = formatSerializationError('step value', error);
28
+ throw new SerializationError(message, { hint, cause: error });
29
+ }
30
+ }
31
+ /**
32
+ * Deserialize a value for the step execution environment.
33
+ */
34
+ export async function deserialize(data, encryptionKey, options) {
35
+ const decrypted = await decompress(await decryptData(data, encryptionKey), options?.compressionStats);
36
+ if (!(decrypted instanceof Uint8Array)) {
37
+ if (devalueCodec.deserializeLegacy) {
38
+ return devalueCodec.deserializeLegacy(decrypted, 'step', options);
39
+ }
40
+ throw new Error('Cannot deserialize non-binary data without legacy support');
41
+ }
42
+ const { format, payload } = decodeFormatPrefix(decrypted);
43
+ if (format === SerializationFormat.DEVALUE_V1) {
44
+ return devalueCodec.deserialize(payload, 'step', options);
45
+ }
46
+ throw new Error(`Unsupported serialization format: ${format}`);
47
+ }
48
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RlcC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJpYWxpemF0aW9uL3N0ZXAudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7O0dBS0c7QUFFSCxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUV0RCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDbEQsT0FBTyxFQUFFLFFBQVEsRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUN4RCxPQUFPLEVBQ0wsT0FBTyxJQUFJLFdBQVcsRUFDdEIsT0FBTyxJQUFJLFdBQVcsR0FFdkIsTUFBTSxpQkFBaUIsQ0FBQztBQUN6QixPQUFPLEVBQUUsd0JBQXdCLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDOUUsT0FBTyxFQUFFLGtCQUFrQixFQUFFLHNCQUFzQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQ3pFLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUVqRDs7R0FFRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsU0FBUyxDQUM3QixLQUFjLEVBQ2QsYUFBMEIsRUFDMUIsT0FBc0I7SUFFdEIsSUFBSSxDQUFDO1FBQ0gsTUFBTSxPQUFPLEdBQUcsWUFBWSxDQUFDLFNBQVMsQ0FBQyxLQUFLLEVBQUUsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQy9ELE1BQU0sUUFBUSxHQUFHLHNCQUFzQixDQUNyQyxtQkFBbUIsQ0FBQyxVQUFVLEVBQzlCLE9BQU8sQ0FDTSxDQUFDO1FBQ2hCLCtEQUErRDtRQUMvRCxNQUFNLFVBQVUsR0FBRyxNQUFNLFFBQVEsQ0FDL0IsUUFBUSxFQUNSLE9BQU8sRUFBRSxXQUFXLEtBQUssSUFBSSxFQUM3QixPQUFPLEVBQUUsZ0JBQWdCLENBQzFCLENBQUM7UUFDRixPQUFPLFdBQVcsQ0FBQyxVQUFVLEVBQUUsYUFBYSxDQUFDLENBQUM7SUFDaEQsQ0FBQztJQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7UUFDZixxQkFBcUIsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUM3QixNQUFNLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxHQUFHLHdCQUF3QixDQUFDLFlBQVksRUFBRSxLQUFLLENBQUMsQ0FBQztRQUN4RSxNQUFNLElBQUksa0JBQWtCLENBQUMsT0FBTyxFQUFFLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO0lBQ2hFLENBQUM7QUFDSCxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLFdBQVcsQ0FDL0IsSUFBMEIsRUFDMUIsYUFBMEIsRUFDMUIsT0FBc0I7SUFFdEIsTUFBTSxTQUFTLEdBQUcsTUFBTSxVQUFVLENBQ2hDLE1BQU0sV0FBVyxDQUFDLElBQUksRUFBRSxhQUFhLENBQUMsRUFDdEMsT0FBTyxFQUFFLGdCQUFnQixDQUMxQixDQUFDO0lBRUYsSUFBSSxDQUFDLENBQUMsU0FBUyxZQUFZLFVBQVUsQ0FBQyxFQUFFLENBQUM7UUFDdkMsSUFBSSxZQUFZLENBQUMsaUJBQWlCLEVBQUUsQ0FBQztZQUNuQyxPQUFPLFlBQVksQ0FBQyxpQkFBaUIsQ0FBQyxTQUFTLEVBQUUsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQ3BFLENBQUM7UUFDRCxNQUFNLElBQUksS0FBSyxDQUNiLDJEQUEyRCxDQUM1RCxDQUFDO0lBQ0osQ0FBQztJQUVELE1BQU0sRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLEdBQUcsa0JBQWtCLENBQUMsU0FBUyxDQUFDLENBQUM7SUFFMUQsSUFBSSxNQUFNLEtBQUssbUJBQW1CLENBQUMsVUFBVSxFQUFFLENBQUM7UUFDOUMsT0FBTyxZQUFZLENBQUMsV0FBVyxDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDNUQsQ0FBQztJQUVELE1BQU0sSUFBSSxLQUFLLENBQUMscUNBQXFDLE1BQU0sRUFBRSxDQUFDLENBQUM7QUFDakUsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogU3RlcCBtb2RlIHNlcmlhbGl6YXRpb24uXG4gKlxuICogVXNlZCBieSB0aGUgc3RlcCBleGVjdXRvciBmb3Igc2VyaWFsaXppbmcgc3RlcCByZXR1cm4gdmFsdWVzIGFuZFxuICogZGVzZXJpYWxpemluZyBzdGVwIGFyZ3VtZW50cy4gU3VwcG9ydHMgZW5jcnlwdGlvbiBhcyBhIGNvbXBvc2FibGUgbGF5ZXIuXG4gKi9cblxuaW1wb3J0IHsgU2VyaWFsaXphdGlvbkVycm9yIH0gZnJvbSAnQHdvcmtmbG93L2Vycm9ycyc7XG5pbXBvcnQgdHlwZSB7IENvZGVjT3B0aW9ucyB9IGZyb20gJy4vY29kZWMuanMnO1xuaW1wb3J0IHsgZGV2YWx1ZUNvZGVjIH0gZnJvbSAnLi9jb2RlYy1kZXZhbHVlLmpzJztcbmltcG9ydCB7IGNvbXByZXNzLCBkZWNvbXByZXNzIH0gZnJvbSAnLi9jb21wcmVzc2lvbi5qcyc7XG5pbXBvcnQge1xuICBkZWNyeXB0IGFzIGRlY3J5cHREYXRhLFxuICBlbmNyeXB0IGFzIGVuY3J5cHREYXRhLFxuICB0eXBlIFBheWxvYWRLZXksXG59IGZyb20gJy4vZW5jcnlwdGlvbi5qcyc7XG5pbXBvcnQgeyBmb3JtYXRTZXJpYWxpemF0aW9uRXJyb3IsIHJldGhyb3dJZlJ1bnRpbWVFcnJvciB9IGZyb20gJy4vZXJyb3JzLmpzJztcbmltcG9ydCB7IGRlY29kZUZvcm1hdFByZWZpeCwgZW5jb2RlV2l0aEZvcm1hdFByZWZpeCB9IGZyb20gJy4vZm9ybWF0LmpzJztcbmltcG9ydCB7IFNlcmlhbGl6YXRpb25Gb3JtYXQgfSBmcm9tICcuL3R5cGVzLmpzJztcblxuLyoqXG4gKiBTZXJpYWxpemUgYSB2YWx1ZSBmcm9tIHRoZSBzdGVwIGV4ZWN1dGlvbiBlbnZpcm9ubWVudC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHNlcmlhbGl6ZShcbiAgdmFsdWU6IHVua25vd24sXG4gIGVuY3J5cHRpb25LZXk/OiBQYXlsb2FkS2V5LFxuICBvcHRpb25zPzogQ29kZWNPcHRpb25zXG4pOiBQcm9taXNlPFVpbnQ4QXJyYXkgfCB1bmtub3duPiB7XG4gIHRyeSB7XG4gICAgY29uc3QgcGF5bG9hZCA9IGRldmFsdWVDb2RlYy5zZXJpYWxpemUodmFsdWUsICdzdGVwJywgb3B0aW9ucyk7XG4gICAgY29uc3QgcHJlZml4ZWQgPSBlbmNvZGVXaXRoRm9ybWF0UHJlZml4KFxuICAgICAgU2VyaWFsaXphdGlvbkZvcm1hdC5ERVZBTFVFX1YxLFxuICAgICAgcGF5bG9hZFxuICAgICkgYXMgVWludDhBcnJheTtcbiAgICAvLyBDb21wcmVzcyBiZWZvcmUgZW5jcnlwdGluZyDigJQgZW5jcnlwdGVkIGJ5dGVzIGRvbid0IGNvbXByZXNzLlxuICAgIGNvbnN0IGNvbXByZXNzZWQgPSBhd2FpdCBjb21wcmVzcyhcbiAgICAgIHByZWZpeGVkLFxuICAgICAgb3B0aW9ucz8uY29tcHJlc3Npb24gPT09IHRydWUsXG4gICAgICBvcHRpb25zPy5jb21wcmVzc2lvblN0YXRzXG4gICAgKTtcbiAgICByZXR1cm4gZW5jcnlwdERhdGEoY29tcHJlc3NlZCwgZW5jcnlwdGlvbktleSk7XG4gIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgcmV0aHJvd0lmUnVudGltZUVycm9yKGVycm9yKTtcbiAgICBjb25zdCB7IG1lc3NhZ2UsIGhpbnQgfSA9IGZvcm1hdFNlcmlhbGl6YXRpb25FcnJvcignc3RlcCB2YWx1ZScsIGVycm9yKTtcbiAgICB0aHJvdyBuZXcgU2VyaWFsaXphdGlvbkVycm9yKG1lc3NhZ2UsIHsgaGludCwgY2F1c2U6IGVycm9yIH0pO1xuICB9XG59XG5cbi8qKlxuICogRGVzZXJpYWxpemUgYSB2YWx1ZSBmb3IgdGhlIHN0ZXAgZXhlY3V0aW9uIGVudmlyb25tZW50LlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gZGVzZXJpYWxpemUoXG4gIGRhdGE6IFVpbnQ4QXJyYXkgfCB1bmtub3duLFxuICBlbmNyeXB0aW9uS2V5PzogUGF5bG9hZEtleSxcbiAgb3B0aW9ucz86IENvZGVjT3B0aW9uc1xuKTogUHJvbWlzZTx1bmtub3duPiB7XG4gIGNvbnN0IGRlY3J5cHRlZCA9IGF3YWl0IGRlY29tcHJlc3MoXG4gICAgYXdhaXQgZGVjcnlwdERhdGEoZGF0YSwgZW5jcnlwdGlvbktleSksXG4gICAgb3B0aW9ucz8uY29tcHJlc3Npb25TdGF0c1xuICApO1xuXG4gIGlmICghKGRlY3J5cHRlZCBpbnN0YW5jZW9mIFVpbnQ4QXJyYXkpKSB7XG4gICAgaWYgKGRldmFsdWVDb2RlYy5kZXNlcmlhbGl6ZUxlZ2FjeSkge1xuICAgICAgcmV0dXJuIGRldmFsdWVDb2RlYy5kZXNlcmlhbGl6ZUxlZ2FjeShkZWNyeXB0ZWQsICdzdGVwJywgb3B0aW9ucyk7XG4gICAgfVxuICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICdDYW5ub3QgZGVzZXJpYWxpemUgbm9uLWJpbmFyeSBkYXRhIHdpdGhvdXQgbGVnYWN5IHN1cHBvcnQnXG4gICAgKTtcbiAgfVxuXG4gIGNvbnN0IHsgZm9ybWF0LCBwYXlsb2FkIH0gPSBkZWNvZGVGb3JtYXRQcmVmaXgoZGVjcnlwdGVkKTtcblxuICBpZiAoZm9ybWF0ID09PSBTZXJpYWxpemF0aW9uRm9ybWF0LkRFVkFMVUVfVjEpIHtcbiAgICByZXR1cm4gZGV2YWx1ZUNvZGVjLmRlc2VyaWFsaXplKHBheWxvYWQsICdzdGVwJywgb3B0aW9ucyk7XG4gIH1cblxuICB0aHJvdyBuZXcgRXJyb3IoYFVuc3VwcG9ydGVkIHNlcmlhbGl6YXRpb24gZm9ybWF0OiAke2Zvcm1hdH1gKTtcbn1cbiJdfQ==