@lovable.dev/workflows-sdk 0.0.0-dev.32 → 0.0.0-dev.34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -69,14 +69,21 @@ Every durable operation needs a static, user-facing description:
69
69
  | `ctx.now`, `ctx.uuid` | First argument: `meta.description` |
70
70
  | `ctx.approve` | First argument: `description` |
71
71
 
72
+ Both `ctx.approve` and `ctx.waitForEvent` require `timeoutMs`: a duration in
73
+ milliseconds, written as a finite numeric literal of at least 60000 (one minute) (for example,
74
+ `3600000` for one hour or `86400000` for one day). The Vite build fails if it
75
+ is omitted, computed, or invalid. Do not pass an absolute timestamp or the
76
+ upstream `deadline` option. Execution computes expiry when the wait first
77
+ parks, then preserves that expiry across replays.
78
+
72
79
  ```ts
73
80
  await ctx.step("load-customer", () => loadCustomer(ctx.input.customerId), {
74
81
  meta: { description: "Load the customer record" },
75
82
  });
76
83
  ```
77
84
 
78
- Every durable operation takes an explicit `id` — `ctx.approve({ id, title })`,
79
- `ctx.waitForEvent(name, { id })`, `ctx.sleep(ms, { id })`, `ctx.now({ id })` —
85
+ Every durable operation takes an explicit `id` — `ctx.approve({ id, title, timeoutMs: 86400000 })`,
86
+ `ctx.waitForEvent(name, { id, timeoutMs: 3600000 })`, `ctx.sleep(ms, { id })`, `ctx.now({ id })` —
80
87
  and none is derived from a title, name or duration. IDs share one namespace per
81
88
  workflow, so the build fails on a missing or repeated one, including two calls
82
89
  on mutually exclusive branches. Keep side effects inside step bodies;
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-Cd9aL2HY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CMXcTS6h.js";
2
2
  //#region src/manifests/branch-metadata.ts
3
3
  const optionsArgument = {
4
4
  step: 2,
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-Cd9aL2HY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CMXcTS6h.js";
2
2
  //#region src/manifests/context-escapes.ts
3
3
  const durableMethods = /* @__PURE__ */ new Set([
4
4
  "step",
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-Cd9aL2HY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CMXcTS6h.js";
2
2
  //#region src/manifests/duplicate-ids.ts
3
3
  /** Where an explicit `{ id }` would sit for each operation. */
4
4
  const optionsArgument = {
@@ -6626,13 +6626,13 @@ function listValueFromJson(listValue, json) {
6626
6626
  }
6627
6627
  //#endregion
6628
6628
  //#region package.json
6629
- var version = "0.0.0-dev.32";
6629
+ var version = "0.0.0-dev.34";
6630
6630
  //#endregion
6631
6631
  //#region src/proto/lovable/appworkflows/v1/workflow_manifest_pb.ts
6632
6632
  /**
6633
6633
  * Describes the file lovable/appworkflows/v1/workflow_manifest.proto.
6634
6634
  */
6635
- const file_lovable_appworkflows_v1_workflow_manifest = /*@__PURE__*/ fileDesc("Ci9sb3ZhYmxlL2FwcHdvcmtmbG93cy92MS93b3JrZmxvd19tYW5pZmVzdC5wcm90bxIXbG92YWJsZS5hcHB3b3JrZmxvd3MudjEikgQKEldvcmtmbG93TWFuaWZlc3RWMRIYChBtYW5pZmVzdF92ZXJzaW9uGAEgASgNEhMKC3Nka192ZXJzaW9uGAIgASgJEhMKC3dvcmtmbG93X2lkGAMgASgJEhgKC2Rlc2NyaXB0aW9uGAQgASgJSACIAQESHQoQd29ya2Zsb3dfdmVyc2lvbhgFIAEoCUgBiAEBEiwKDGlucHV0X3NjaGVtYRgGIAEoCzIWLmdvb2dsZS5wcm90b2J1Zi5WYWx1ZRItCg1vdXRwdXRfc2NoZW1hGAcgASgLMhYuZ29vZ2xlLnByb3RvYnVmLlZhbHVlEiwKDHN0YXRlX3NjaGVtYRgIIAEoCzIWLmdvb2dsZS5wcm90b2J1Zi5WYWx1ZRJECgh0cmlnZ2VycxgJIAMoCzIyLmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RUcmlnZ2VyVjESPwoFZ3JhcGgYCiABKAsyMC5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0R3JhcGhWMRIUCgdjdXJyZW50GAsgASgISAKIAQESFwoKcm91dGVfcGF0aBgMIAEoCUgDiAEBQg4KDF9kZXNjcmlwdGlvbkITChFfd29ya2Zsb3dfdmVyc2lvbkIKCghfY3VycmVudEINCgtfcm91dGVfcGF0aCJ/ChlXb3JrZmxvd01hbmlmZXN0VHJpZ2dlclYxEgoKAmlkGAEgASgJEk4KCHNjaGVkdWxlGAIgASgLMjoubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdFNjaGVkdWxlVHJpZ2dlclYxSABCBgoEa2luZCLcAQohV29ya2Zsb3dNYW5pZmVzdFNjaGVkdWxlVHJpZ2dlclYxEkMKB2NhZGVuY2UYASABKAsyMi5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0Q2FkZW5jZVYxEhEKCXRpbWVfem9uZRgCIAEoCRIUCgdlbmFibGVkGAMgASgISACIAQESFgoOb3ZlcmxhcF9wb2xpY3kYBCABKAkSJQoFaW5wdXQYBSABKAsyFi5nb29nbGUucHJvdG9idWYuVmFsdWVCCgoIX2VuYWJsZWQihQIKGVdvcmtmbG93TWFuaWZlc3RDYWRlbmNlVjESSgoGaG91cmx5GAEgASgLMjgubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdEhvdXJseUNhZGVuY2VWMUgAEkgKBWRhaWx5GAIgASgLMjcubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdERhaWx5Q2FkZW5jZVYxSAASSgoGd2Vla2x5GAMgASgLMjgubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdFdlZWtseUNhZGVuY2VWMUgAQgYKBGtpbmQiIQofV29ya2Zsb3dNYW5pZmVzdEhvdXJseUNhZGVuY2VWMSIvCh5Xb3JrZmxvd01hbmlmZXN0RGFpbHlDYWRlbmNlVjESDQoFaG91cnMYASADKA0icgofV29ya2Zsb3dNYW5pZmVzdFdlZWtseUNhZGVuY2VWMRJACgRkYXlzGAEgAygOMjIubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdFdlZWtkYXlWMRINCgVob3VycxgCIAMoDSL7AQoXV29ya2Zsb3dNYW5pZmVzdEdyYXBoVjESDgoGc291cmNlGAEgASgJEg0KBXNjb3BlGAIgASgJEhUKCGNvbXBsZXRlGAMgASgISACIAQESQwoFbm9kZXMYBCADKAsyNC5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0R3JhcGhOb2RlVjESQwoFZWRnZXMYBSADKAsyNC5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0R3JhcGhFZGdlVjESEwoLZGlhZ25vc3RpY3MYBiADKAlCCwoJX2NvbXBsZXRlIu4GChtXb3JrZmxvd01hbmlmZXN0R3JhcGhOb2RlVjESCgoCaWQYASABKAkSDQoFbGFiZWwYAiABKAkSQwoEc3RlcBgDIAEoCzIzLmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RTdGVwTm9kZVYxSAASSwoIcGFyYWxsZWwYBCABKAsyNy5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0UGFyYWxsZWxOb2RlVjFIABJDCgRsb29wGAUgASgLMjMubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdExvb3BOb2RlVjFIABJJCgdhcHByb3ZlGAYgASgLMjYubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdEFwcHJvdmVOb2RlVjFIABJVCg53YWl0X2Zvcl9ldmVudBgHIAEoCzI7LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RXYWl0Rm9yRXZlbnROb2RlVjFIABJFCgVzbGVlcBgIIAEoCzI0LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RTbGVlcE5vZGVWMUgAElAKC3NsZWVwX3VudGlsGAkgASgLMjkubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdFNsZWVwVW50aWxOb2RlVjFIABJBCgNub3cYCiABKAsyMi5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0Tm93Tm9kZVYxSAASQwoEdXVpZBgLIAEoCzIzLmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RVdWlkTm9kZVYxSAASRwoGYnJhbmNoGAwgASgLMjUubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdEJyYW5jaE5vZGVWMUgAEkkKB3Vua25vd24YDSABKAsyNi5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0VW5rbm93bk5vZGVWMUgAQgYKBGtpbmQinAEKGldvcmtmbG93TWFuaWZlc3RTdGVwTm9kZVYxEg8KB3N0ZXBfaWQYASABKAkSEwoLZGVzY3JpcHRpb24YAiABKAkSWAoQZXhlY3V0aW9uX3BvbGljeRgDIAEoCzI+LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RTdGVwRXhlY3V0aW9uUG9saWN5VjEieQoeV29ya2Zsb3dNYW5pZmVzdFBhcmFsbGVsTm9kZVYxEhAKCGdyb3VwX2lkGAEgASgJEkUKBHN0ZXAYAiABKAsyNy5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0UmVwZWF0ZWRTdGVwVjEidQoaV29ya2Zsb3dNYW5pZmVzdExvb3BOb2RlVjESEAoIZ3JvdXBfaWQYASABKAkSRQoEc3RlcBgCIAEoCzI3LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RSZXBlYXRlZFN0ZXBWMSKpAQoeV29ya2Zsb3dNYW5pZmVzdFJlcGVhdGVkU3RlcFYxEhgKEHN0ZXBfaWRfdGVtcGxhdGUYASABKAkSEwoLZGVzY3JpcHRpb24YAiABKAkSWAoQZXhlY3V0aW9uX3BvbGljeRgDIAEoCzI+LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RTdGVwRXhlY3V0aW9uUG9saWN5VjEi/gEKJVdvcmtmbG93TWFuaWZlc3RTdGVwRXhlY3V0aW9uUG9saWN5VjESFAoMbWF4X2F0dGVtcHRzGAEgASgNEl8KFnJldHJ5X2JhY2tvZmZfc3RyYXRlZ3kYAiABKA4yPy5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0UmV0cnlCYWNrb2ZmU3RyYXRlZ3lWMRIVCg1yZXRyeV9iYXNlX21zGAMgASgBEh8KF2hhc19jdXN0b21fc2hvdWxkX3JldHJ5GAQgASgIEhcKCnRpbWVvdXRfbXMYBSABKAFIAIgBAUINCgtfdGltZW91dF9tcyJUCh1Xb3JrZmxvd01hbmlmZXN0QXBwcm92ZU5vZGVWMRIPCgdzdGVwX2lkGAEgASgJEhMKC2Rlc2NyaXB0aW9uGAIgASgJEg0KBXRpdGxlGAMgASgJIn0KIldvcmtmbG93TWFuaWZlc3RXYWl0Rm9yRXZlbnROb2RlVjESDwoHc3RlcF9pZBgBIAEoCRITCgtkZXNjcmlwdGlvbhgCIAEoCRINCgVldmVudBgDIAEoCRIVCghkZWFkbGluZRgEIAEoAUgAiAEBQgsKCV9kZWFkbGluZSJPChtXb3JrZmxvd01hbmlmZXN0U2xlZXBOb2RlVjESDwoHc3RlcF9pZBgBIAEoCRITCgtkZXNjcmlwdGlvbhgCIAEoCRIKCgJtcxgDIAEoASJbCiBXb3JrZmxvd01hbmlmZXN0U2xlZXBVbnRpbE5vZGVWMRIPCgdzdGVwX2lkGAEgASgJEhMKC2Rlc2NyaXB0aW9uGAIgASgJEhEKCXRpbWVzdGFtcBgDIAEoASJBChlXb3JrZmxvd01hbmlmZXN0Tm93Tm9kZVYxEg8KB3N0ZXBfaWQYASABKAkSEwoLZGVzY3JpcHRpb24YAiABKAkiQgoaV29ya2Zsb3dNYW5pZmVzdFV1aWROb2RlVjESDwoHc3RlcF9pZBgBIAEoCRITCgtkZXNjcmlwdGlvbhgCIAEoCSJZChxXb3JrZmxvd01hbmlmZXN0QnJhbmNoTm9kZVYxEhEKCWJyYW5jaF9pZBgBIAEoCRIRCgljb25kaXRpb24YAiABKAkSEwoLZGVzY3JpcHRpb24YAyABKAkiHwodV29ya2Zsb3dNYW5pZmVzdFVua25vd25Ob2RlVjEi1QEKG1dvcmtmbG93TWFuaWZlc3RHcmFwaEVkZ2VWMRIOCgZzb3VyY2UYASABKAkSDgoGdGFyZ2V0GAIgASgJEkUKBW9yZGVyGAMgASgLMjQubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdE9yZGVyRWRnZVYxSAASRwoGYnJhbmNoGAQgASgLMjUubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdEJyYW5jaEVkZ2VWMUgAQgYKBGtpbmQiHQobV29ya2Zsb3dNYW5pZmVzdE9yZGVyRWRnZVYxIi8KHFdvcmtmbG93TWFuaWZlc3RCcmFuY2hFZGdlVjESDwoHb3V0Y29tZRgBIAEoCCrwAgoZV29ya2Zsb3dNYW5pZmVzdFdlZWtkYXlWMRIsCihXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX1VOU1BFQ0lGSUVEEAASJwojV09SS0ZMT1dfTUFOSUZFU1RfV0VFS0RBWV9WMV9NT05EQVkQARIoCiRXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX1RVRVNEQVkQAhIqCiZXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX1dFRE5FU0RBWRADEikKJVdPUktGTE9XX01BTklGRVNUX1dFRUtEQVlfVjFfVEhVUlNEQVkQBBInCiNXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX0ZSSURBWRAFEikKJVdPUktGTE9XX01BTklGRVNUX1dFRUtEQVlfVjFfU0FUVVJEQVkQBhInCiNXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX1NVTkRBWRAHKpECCiZXb3JrZmxvd01hbmlmZXN0UmV0cnlCYWNrb2ZmU3RyYXRlZ3lWMRI7CjdXT1JLRkxPV19NQU5JRkVTVF9SRVRSWV9CQUNLT0ZGX1NUUkFURUdZX1YxX1VOU1BFQ0lGSUVEEAASOwo3V09SS0ZMT1dfTUFOSUZFU1RfUkVUUllfQkFDS09GRl9TVFJBVEVHWV9WMV9FWFBPTkVOVElBTBABEjUKMVdPUktGTE9XX01BTklGRVNUX1JFVFJZX0JBQ0tPRkZfU1RSQVRFR1lfVjFfRklYRUQQAhI2CjJXT1JLRkxPV19NQU5JRkVTVF9SRVRSWV9CQUNLT0ZGX1NUUkFURUdZX1YxX0NVU1RPTRADQoYCChtjb20ubG92YWJsZS5hcHB3b3JrZmxvd3MudjFCFVdvcmtmbG93TWFuaWZlc3RQcm90b1ABWlJnaXRodWIuY29tL2xvdmFibGVsYWJzL2xvdmFibGUvZ28vcHJvdG8vZ2VuL2xvdmFibGUvYXBwd29ya2Zsb3dzL3YxO2FwcHdvcmtmbG93c3YxogIDTEFYqgIXTG92YWJsZS5BcHB3b3JrZmxvd3MuVjHKAhdMb3ZhYmxlXEFwcHdvcmtmbG93c1xWMeICI0xvdmFibGVcQXBwd29ya2Zsb3dzXFYxXEdQQk1ldGFkYXRh6gIZTG92YWJsZTo6QXBwd29ya2Zsb3dzOjpWMWIGcHJvdG8z", [file_google_protobuf_struct]);
6635
+ const file_lovable_appworkflows_v1_workflow_manifest = /*@__PURE__*/ fileDesc("Ci9sb3ZhYmxlL2FwcHdvcmtmbG93cy92MS93b3JrZmxvd19tYW5pZmVzdC5wcm90bxIXbG92YWJsZS5hcHB3b3JrZmxvd3MudjEikgQKEldvcmtmbG93TWFuaWZlc3RWMRIYChBtYW5pZmVzdF92ZXJzaW9uGAEgASgNEhMKC3Nka192ZXJzaW9uGAIgASgJEhMKC3dvcmtmbG93X2lkGAMgASgJEhgKC2Rlc2NyaXB0aW9uGAQgASgJSACIAQESHQoQd29ya2Zsb3dfdmVyc2lvbhgFIAEoCUgBiAEBEiwKDGlucHV0X3NjaGVtYRgGIAEoCzIWLmdvb2dsZS5wcm90b2J1Zi5WYWx1ZRItCg1vdXRwdXRfc2NoZW1hGAcgASgLMhYuZ29vZ2xlLnByb3RvYnVmLlZhbHVlEiwKDHN0YXRlX3NjaGVtYRgIIAEoCzIWLmdvb2dsZS5wcm90b2J1Zi5WYWx1ZRJECgh0cmlnZ2VycxgJIAMoCzIyLmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RUcmlnZ2VyVjESPwoFZ3JhcGgYCiABKAsyMC5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0R3JhcGhWMRIUCgdjdXJyZW50GAsgASgISAKIAQESFwoKcm91dGVfcGF0aBgMIAEoCUgDiAEBQg4KDF9kZXNjcmlwdGlvbkITChFfd29ya2Zsb3dfdmVyc2lvbkIKCghfY3VycmVudEINCgtfcm91dGVfcGF0aCJ/ChlXb3JrZmxvd01hbmlmZXN0VHJpZ2dlclYxEgoKAmlkGAEgASgJEk4KCHNjaGVkdWxlGAIgASgLMjoubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdFNjaGVkdWxlVHJpZ2dlclYxSABCBgoEa2luZCLcAQohV29ya2Zsb3dNYW5pZmVzdFNjaGVkdWxlVHJpZ2dlclYxEkMKB2NhZGVuY2UYASABKAsyMi5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0Q2FkZW5jZVYxEhEKCXRpbWVfem9uZRgCIAEoCRIUCgdlbmFibGVkGAMgASgISACIAQESFgoOb3ZlcmxhcF9wb2xpY3kYBCABKAkSJQoFaW5wdXQYBSABKAsyFi5nb29nbGUucHJvdG9idWYuVmFsdWVCCgoIX2VuYWJsZWQihQIKGVdvcmtmbG93TWFuaWZlc3RDYWRlbmNlVjESSgoGaG91cmx5GAEgASgLMjgubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdEhvdXJseUNhZGVuY2VWMUgAEkgKBWRhaWx5GAIgASgLMjcubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdERhaWx5Q2FkZW5jZVYxSAASSgoGd2Vla2x5GAMgASgLMjgubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdFdlZWtseUNhZGVuY2VWMUgAQgYKBGtpbmQiIQofV29ya2Zsb3dNYW5pZmVzdEhvdXJseUNhZGVuY2VWMSIvCh5Xb3JrZmxvd01hbmlmZXN0RGFpbHlDYWRlbmNlVjESDQoFaG91cnMYASADKA0icgofV29ya2Zsb3dNYW5pZmVzdFdlZWtseUNhZGVuY2VWMRJACgRkYXlzGAEgAygOMjIubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdFdlZWtkYXlWMRINCgVob3VycxgCIAMoDSL7AQoXV29ya2Zsb3dNYW5pZmVzdEdyYXBoVjESDgoGc291cmNlGAEgASgJEg0KBXNjb3BlGAIgASgJEhUKCGNvbXBsZXRlGAMgASgISACIAQESQwoFbm9kZXMYBCADKAsyNC5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0R3JhcGhOb2RlVjESQwoFZWRnZXMYBSADKAsyNC5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0R3JhcGhFZGdlVjESEwoLZGlhZ25vc3RpY3MYBiADKAlCCwoJX2NvbXBsZXRlIu4GChtXb3JrZmxvd01hbmlmZXN0R3JhcGhOb2RlVjESCgoCaWQYASABKAkSDQoFbGFiZWwYAiABKAkSQwoEc3RlcBgDIAEoCzIzLmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RTdGVwTm9kZVYxSAASSwoIcGFyYWxsZWwYBCABKAsyNy5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0UGFyYWxsZWxOb2RlVjFIABJDCgRsb29wGAUgASgLMjMubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdExvb3BOb2RlVjFIABJJCgdhcHByb3ZlGAYgASgLMjYubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdEFwcHJvdmVOb2RlVjFIABJVCg53YWl0X2Zvcl9ldmVudBgHIAEoCzI7LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RXYWl0Rm9yRXZlbnROb2RlVjFIABJFCgVzbGVlcBgIIAEoCzI0LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RTbGVlcE5vZGVWMUgAElAKC3NsZWVwX3VudGlsGAkgASgLMjkubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdFNsZWVwVW50aWxOb2RlVjFIABJBCgNub3cYCiABKAsyMi5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0Tm93Tm9kZVYxSAASQwoEdXVpZBgLIAEoCzIzLmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RVdWlkTm9kZVYxSAASRwoGYnJhbmNoGAwgASgLMjUubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdEJyYW5jaE5vZGVWMUgAEkkKB3Vua25vd24YDSABKAsyNi5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0VW5rbm93bk5vZGVWMUgAQgYKBGtpbmQinAEKGldvcmtmbG93TWFuaWZlc3RTdGVwTm9kZVYxEg8KB3N0ZXBfaWQYASABKAkSEwoLZGVzY3JpcHRpb24YAiABKAkSWAoQZXhlY3V0aW9uX3BvbGljeRgDIAEoCzI+LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RTdGVwRXhlY3V0aW9uUG9saWN5VjEieQoeV29ya2Zsb3dNYW5pZmVzdFBhcmFsbGVsTm9kZVYxEhAKCGdyb3VwX2lkGAEgASgJEkUKBHN0ZXAYAiABKAsyNy5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0UmVwZWF0ZWRTdGVwVjEidQoaV29ya2Zsb3dNYW5pZmVzdExvb3BOb2RlVjESEAoIZ3JvdXBfaWQYASABKAkSRQoEc3RlcBgCIAEoCzI3LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RSZXBlYXRlZFN0ZXBWMSKpAQoeV29ya2Zsb3dNYW5pZmVzdFJlcGVhdGVkU3RlcFYxEhgKEHN0ZXBfaWRfdGVtcGxhdGUYASABKAkSEwoLZGVzY3JpcHRpb24YAiABKAkSWAoQZXhlY3V0aW9uX3BvbGljeRgDIAEoCzI+LmxvdmFibGUuYXBwd29ya2Zsb3dzLnYxLldvcmtmbG93TWFuaWZlc3RTdGVwRXhlY3V0aW9uUG9saWN5VjEi/gEKJVdvcmtmbG93TWFuaWZlc3RTdGVwRXhlY3V0aW9uUG9saWN5VjESFAoMbWF4X2F0dGVtcHRzGAEgASgNEl8KFnJldHJ5X2JhY2tvZmZfc3RyYXRlZ3kYAiABKA4yPy5sb3ZhYmxlLmFwcHdvcmtmbG93cy52MS5Xb3JrZmxvd01hbmlmZXN0UmV0cnlCYWNrb2ZmU3RyYXRlZ3lWMRIVCg1yZXRyeV9iYXNlX21zGAMgASgBEh8KF2hhc19jdXN0b21fc2hvdWxkX3JldHJ5GAQgASgIEhcKCnRpbWVvdXRfbXMYBSABKAFIAIgBAUINCgtfdGltZW91dF9tcyJ4Ch1Xb3JrZmxvd01hbmlmZXN0QXBwcm92ZU5vZGVWMRIPCgdzdGVwX2lkGAEgASgJEhMKC2Rlc2NyaXB0aW9uGAIgASgJEg0KBXRpdGxlGAMgASgJEhUKCGRlYWRsaW5lGAQgASgBSACIAQFCCwoJX2RlYWRsaW5lIn0KIldvcmtmbG93TWFuaWZlc3RXYWl0Rm9yRXZlbnROb2RlVjESDwoHc3RlcF9pZBgBIAEoCRITCgtkZXNjcmlwdGlvbhgCIAEoCRINCgVldmVudBgDIAEoCRIVCghkZWFkbGluZRgEIAEoAUgAiAEBQgsKCV9kZWFkbGluZSJPChtXb3JrZmxvd01hbmlmZXN0U2xlZXBOb2RlVjESDwoHc3RlcF9pZBgBIAEoCRITCgtkZXNjcmlwdGlvbhgCIAEoCRIKCgJtcxgDIAEoASJbCiBXb3JrZmxvd01hbmlmZXN0U2xlZXBVbnRpbE5vZGVWMRIPCgdzdGVwX2lkGAEgASgJEhMKC2Rlc2NyaXB0aW9uGAIgASgJEhEKCXRpbWVzdGFtcBgDIAEoASJBChlXb3JrZmxvd01hbmlmZXN0Tm93Tm9kZVYxEg8KB3N0ZXBfaWQYASABKAkSEwoLZGVzY3JpcHRpb24YAiABKAkiQgoaV29ya2Zsb3dNYW5pZmVzdFV1aWROb2RlVjESDwoHc3RlcF9pZBgBIAEoCRITCgtkZXNjcmlwdGlvbhgCIAEoCSJZChxXb3JrZmxvd01hbmlmZXN0QnJhbmNoTm9kZVYxEhEKCWJyYW5jaF9pZBgBIAEoCRIRCgljb25kaXRpb24YAiABKAkSEwoLZGVzY3JpcHRpb24YAyABKAkiHwodV29ya2Zsb3dNYW5pZmVzdFVua25vd25Ob2RlVjEi1QEKG1dvcmtmbG93TWFuaWZlc3RHcmFwaEVkZ2VWMRIOCgZzb3VyY2UYASABKAkSDgoGdGFyZ2V0GAIgASgJEkUKBW9yZGVyGAMgASgLMjQubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdE9yZGVyRWRnZVYxSAASRwoGYnJhbmNoGAQgASgLMjUubG92YWJsZS5hcHB3b3JrZmxvd3MudjEuV29ya2Zsb3dNYW5pZmVzdEJyYW5jaEVkZ2VWMUgAQgYKBGtpbmQiHQobV29ya2Zsb3dNYW5pZmVzdE9yZGVyRWRnZVYxIi8KHFdvcmtmbG93TWFuaWZlc3RCcmFuY2hFZGdlVjESDwoHb3V0Y29tZRgBIAEoCCrwAgoZV29ya2Zsb3dNYW5pZmVzdFdlZWtkYXlWMRIsCihXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX1VOU1BFQ0lGSUVEEAASJwojV09SS0ZMT1dfTUFOSUZFU1RfV0VFS0RBWV9WMV9NT05EQVkQARIoCiRXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX1RVRVNEQVkQAhIqCiZXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX1dFRE5FU0RBWRADEikKJVdPUktGTE9XX01BTklGRVNUX1dFRUtEQVlfVjFfVEhVUlNEQVkQBBInCiNXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX0ZSSURBWRAFEikKJVdPUktGTE9XX01BTklGRVNUX1dFRUtEQVlfVjFfU0FUVVJEQVkQBhInCiNXT1JLRkxPV19NQU5JRkVTVF9XRUVLREFZX1YxX1NVTkRBWRAHKpECCiZXb3JrZmxvd01hbmlmZXN0UmV0cnlCYWNrb2ZmU3RyYXRlZ3lWMRI7CjdXT1JLRkxPV19NQU5JRkVTVF9SRVRSWV9CQUNLT0ZGX1NUUkFURUdZX1YxX1VOU1BFQ0lGSUVEEAASOwo3V09SS0ZMT1dfTUFOSUZFU1RfUkVUUllfQkFDS09GRl9TVFJBVEVHWV9WMV9FWFBPTkVOVElBTBABEjUKMVdPUktGTE9XX01BTklGRVNUX1JFVFJZX0JBQ0tPRkZfU1RSQVRFR1lfVjFfRklYRUQQAhI2CjJXT1JLRkxPV19NQU5JRkVTVF9SRVRSWV9CQUNLT0ZGX1NUUkFURUdZX1YxX0NVU1RPTRADQoYCChtjb20ubG92YWJsZS5hcHB3b3JrZmxvd3MudjFCFVdvcmtmbG93TWFuaWZlc3RQcm90b1ABWlJnaXRodWIuY29tL2xvdmFibGVsYWJzL2xvdmFibGUvZ28vcHJvdG8vZ2VuL2xvdmFibGUvYXBwd29ya2Zsb3dzL3YxO2FwcHdvcmtmbG93c3YxogIDTEFYqgIXTG92YWJsZS5BcHB3b3JrZmxvd3MuVjHKAhdMb3ZhYmxlXEFwcHdvcmtmbG93c1xWMeICI0xvdmFibGVcQXBwd29ya2Zsb3dzXFYxXEdQQk1ldGFkYXRh6gIZTG92YWJsZTo6QXBwd29ya2Zsb3dzOjpWMWIGcHJvdG8z", [file_google_protobuf_struct]);
6636
6636
  /**
6637
6637
  * Describes the message lovable.appworkflows.v1.WorkflowManifestV1.
6638
6638
  * Use `create(WorkflowManifestV1Schema)` to create a new message.
@@ -6819,14 +6819,16 @@ function serializeSchema(schema, direction, label) {
6819
6819
  }
6820
6820
  }
6821
6821
  async function generateManifests(definition, options = {}) {
6822
- const { extractWorkflowGraph } = await import("./graph-Cd9aL2HY.js");
6823
- const { findBranchMetadataIssues } = await import("./branch-metadata-DmTc2agd.js");
6824
- const { findWorkflowContextEscapes } = await import("./context-escapes-DjpWclA6.js");
6825
- const { findDuplicateOperationIds } = await import("./duplicate-ids-D7HMDNMh.js");
6822
+ const { extractWorkflowGraph } = await import("./graph-CMXcTS6h.js");
6823
+ const { findBranchMetadataIssues } = await import("./branch-metadata-BQV4Q5g5.js");
6824
+ const { findWorkflowContextEscapes } = await import("./context-escapes-D1VYi9Uk.js");
6825
+ const { findDuplicateOperationIds } = await import("./duplicate-ids-DMSb6yoK.js");
6826
6826
  const { DURABLE_ID_REQUIRED } = await import("./durable-ids-Cx341nJQ.js").then((n) => n.n);
6827
- const { findNestedDurableOperations } = await import("./nested-operations-DgjRz2Ps.js");
6828
- const { findOperationDescriptionIssues } = await import("./operation-descriptions-5RfHLwu3.js");
6829
- const { findStepMetadataIssues } = await import("./step-metadata-BdT25yO4.js");
6827
+ const { findNestedDurableOperations } = await import("./nested-operations-BAwR1unx.js");
6828
+ const { findOperationDescriptionIssues } = await import("./operation-descriptions-Dtsd2DyI.js");
6829
+ const { findStepMetadataIssues } = await import("./step-metadata-NricLBXO.js");
6830
+ const { findWaitDeadlineIssues } = await import("./wait-deadlines-B8Mpbd8R.js");
6831
+ const { WAIT_DEADLINE_REQUIRED } = await import("./wait-deadlines-DpK-Fgnd.js");
6830
6832
  const collection = registerWorkflows(definition);
6831
6833
  const manifests = [];
6832
6834
  for (const workflow of collection.workflows.flatMap(workflowVersions)) {
@@ -6849,6 +6851,12 @@ async function generateManifests(definition, options = {}) {
6849
6851
  const where = duplicate.reason === "loop" ? "inside a loop or callback" : "more than once";
6850
6852
  throw new Error(`@lovable.dev/workflows-sdk: workflow "${workflow.id}" uses id ${JSON.stringify(duplicate.id)} ${where}; every durable operation id must be unique within a workflow`);
6851
6853
  }
6854
+ const deadlineIssue = (await findWaitDeadlineIssues(workflow.handler))[0];
6855
+ if (deadlineIssue) {
6856
+ const call = `ctx.${deadlineIssue.method}()`;
6857
+ const fault = deadlineIssue.reason === "missing" ? "without timeoutMs" : deadlineIssue.reason === "dynamic" ? "with a timeoutMs the manifest cannot record" : deadlineIssue.reason === "absolute" ? "with the unsupported absolute deadline option" : "with a timeoutMs that is not a finite duration of at least 60000 milliseconds (one minute)";
6858
+ throw new Error(`@lovable.dev/workflows-sdk: workflow "${workflow.id}" calls ${call} ${fault}; ${WAIT_DEADLINE_REQUIRED}`);
6859
+ }
6852
6860
  const metadataIssue = (await findStepMetadataIssues(workflow.handler))[0];
6853
6861
  if (metadataIssue?.kind === "description") {
6854
6862
  const step = metadataIssue.stepId ? `ctx.step(${JSON.stringify(metadataIssue.stepId)})` : "ctx.step()";
@@ -1,4 +1,4 @@
1
- import { _ as WorkflowManifestUnknownNodeV1Schema, a as WorkflowManifestGraphEdgeV1Schema, b as create, c as WorkflowManifestLoopNodeV1Schema, d as WorkflowManifestParallelNodeV1Schema, f as WorkflowManifestRepeatedStepV1Schema, g as WorkflowManifestStepNodeV1Schema, h as WorkflowManifestStepExecutionPolicyV1Schema, i as WorkflowManifestBranchNodeV1Schema, l as WorkflowManifestNowNodeV1Schema, m as WorkflowManifestSleepUntilNodeV1Schema, n as WorkflowManifestApproveNodeV1Schema, o as WorkflowManifestGraphNodeV1Schema, p as WorkflowManifestSleepNodeV1Schema, r as WorkflowManifestBranchEdgeV1Schema, s as WorkflowManifestGraphV1Schema, u as WorkflowManifestOrderEdgeV1Schema, v as WorkflowManifestUuidNodeV1Schema, y as WorkflowManifestWaitForEventNodeV1Schema } from "./generate-D1zt5ZZf.js";
1
+ import { _ as WorkflowManifestUnknownNodeV1Schema, a as WorkflowManifestGraphEdgeV1Schema, b as create, c as WorkflowManifestLoopNodeV1Schema, d as WorkflowManifestParallelNodeV1Schema, f as WorkflowManifestRepeatedStepV1Schema, g as WorkflowManifestStepNodeV1Schema, h as WorkflowManifestStepExecutionPolicyV1Schema, i as WorkflowManifestBranchNodeV1Schema, l as WorkflowManifestNowNodeV1Schema, m as WorkflowManifestSleepUntilNodeV1Schema, n as WorkflowManifestApproveNodeV1Schema, o as WorkflowManifestGraphNodeV1Schema, p as WorkflowManifestSleepNodeV1Schema, r as WorkflowManifestBranchEdgeV1Schema, s as WorkflowManifestGraphV1Schema, u as WorkflowManifestOrderEdgeV1Schema, v as WorkflowManifestUuidNodeV1Schema, y as WorkflowManifestWaitForEventNodeV1Schema } from "./generate-DBk472B5.js";
2
2
  //#region src/manifests/handler-source.ts
3
3
  const nativeFunctionSource = /\{\s*\[native code\]\s*\}\s*$/;
4
4
  function workflowHandlerSource(handler) {
@@ -307,12 +307,14 @@ async function extractWorkflowGraph(workflow) {
307
307
  if (stepId === void 0) return unknown("ctx.approve needs a static { id }", parents);
308
308
  const description = stringLiteral(option(options, "description"));
309
309
  if (description === void 0) return unknown("Approval descriptions must be static strings", parents);
310
+ const deadline = numberLiteral(option(options, "timeoutMs"));
310
311
  return addNode(title, {
311
312
  case: "approve",
312
313
  value: create(WorkflowManifestApproveNodeV1Schema, {
313
314
  stepId,
314
315
  description,
315
- title
316
+ title,
317
+ ...deadline === void 0 ? {} : { deadline }
316
318
  })
317
319
  }, parents);
318
320
  }
@@ -324,9 +326,7 @@ async function extractWorkflowGraph(workflow) {
324
326
  if (stepId === void 0) return unknown("Dynamic waitForEvent IDs are not supported yet", parents);
325
327
  const description = operationDescription(options);
326
328
  if (description === void 0) return unknown("Wait descriptions must be static strings", parents);
327
- const given = option(options, "deadline");
328
- const deadline = numberLiteral(given);
329
- if (given && deadline === void 0) degrade("Dynamic waitForEvent deadlines are not recorded");
329
+ const deadline = numberLiteral(option(options, "timeoutMs"));
330
330
  return addNode(event, {
331
331
  case: "waitForEvent",
332
332
  value: create(WorkflowManifestWaitForEventNodeV1Schema, {
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { AnyWorkflowDefinition, AnyWorkflowDefinition as AnyWorkflowDefinition$1, CreateWorkflowConfig, Ctx, RunStore, SchemaInput, StepContext, StepOptions, WorkflowDefinition, WorkflowEvent, WorkflowInput, WorkflowInput as WorkflowInput$1, WorkflowMetadata, WorkflowOutput, WorkflowState, createMiddleware } from "@tanstack/workflow-core";
1
+ import { AccumulateExtensions, AnyMiddleware, AnyWorkflowDefinition, AnyWorkflowDefinition as AnyWorkflowDefinition$1, ApprovalResult, ApproveOptions as ApproveOptions$1, CreateWorkflowConfig, Ctx as Ctx$1, InferSchema, RunStore, SchemaInput, StepContext, StepOptions, WaitForEventOptions as WaitForEventOptions$1, WorkflowBuilder, WorkflowDefinition, WorkflowDefinition as WorkflowDefinition$1, WorkflowEvent, WorkflowInput, WorkflowInput as WorkflowInput$1, WorkflowMetadata, WorkflowOutput, WorkflowState, createMiddleware } from "@tanstack/workflow-core";
2
2
  //#region src/core/cadence.d.ts
3
3
  type Weekday = "mon" | "tue" | "wed" | "thu" | "fri" | "sat" | "sun";
4
4
  type Cadence = {
@@ -45,7 +45,25 @@ type ResolvedTrigger = ResolvedSchedule;
45
45
  //#region src/core/workflow.d.ts
46
46
  declare function createWorkflow<TInputSchema extends SchemaInput | undefined = undefined, TOutputSchema extends SchemaInput | undefined = undefined, TStateSchema extends SchemaInput | undefined = undefined>(config: CreateWorkflowConfig<TInputSchema, TOutputSchema, TStateSchema> & {
47
47
  version: string;
48
- }): import("@tanstack/workflow-core").WorkflowBuilder<TInputSchema, TOutputSchema, TStateSchema, unknown>;
48
+ }): WorkflowBuilder$1<TInputSchema, TOutputSchema, TStateSchema>;
49
+ type ApproveOptions = ApproveOptions$1 & {
50
+ timeoutMs: number;
51
+ deadline?: never;
52
+ };
53
+ type WaitForEventOptions<TPayload = unknown> = Omit<WaitForEventOptions$1<TPayload>, "deadline"> & {
54
+ timeoutMs: number;
55
+ deadline?: never;
56
+ };
57
+ type Ctx<TInput = unknown, TState = Record<string, unknown>, TExtensions = unknown> = Omit<Ctx$1<TInput, TState>, "approve" | "waitForEvent"> & {
58
+ approve: (options: ApproveOptions) => Promise<ApprovalResult>;
59
+ waitForEvent: <TPayload = unknown>(name: string, options: WaitForEventOptions<TPayload>) => Promise<TPayload>;
60
+ } & TExtensions;
61
+ type InferValue<T extends SchemaInput | undefined, TFallback> = T extends SchemaInput ? InferSchema<T> : TFallback;
62
+ interface WorkflowBuilder$1<TInputSchema extends SchemaInput | undefined, TOutputSchema extends SchemaInput | undefined, TStateSchema extends SchemaInput | undefined, TExtensions = unknown> extends Omit<WorkflowBuilder<TInputSchema, TOutputSchema, TStateSchema, TExtensions>, "handler" | "middleware" | "previousVersions"> {
63
+ middleware: <const TMiddlewares extends readonly AnyMiddleware[]>(middlewares: TMiddlewares) => WorkflowBuilder$1<TInputSchema, TOutputSchema, TStateSchema, TExtensions & AccumulateExtensions<TMiddlewares>>;
64
+ previousVersions: (versions: readonly AnyWorkflowDefinition$1[]) => WorkflowBuilder$1<TInputSchema, TOutputSchema, TStateSchema, TExtensions>;
65
+ handler: <TOutput extends InferValue<TOutputSchema, unknown>>(fn: (ctx: Ctx<InferValue<TInputSchema, unknown>, InferValue<TStateSchema, Record<string, unknown>>, TExtensions>) => Promise<TOutput>) => WorkflowDefinition$1<InferValue<TInputSchema, unknown>, TOutput, InferValue<TStateSchema, Record<string, unknown>>>;
66
+ }
49
67
  interface WorkflowsDefinition<TWorkflow extends AnyWorkflowDefinition$1 = AnyWorkflowDefinition$1> {
50
68
  readonly workflows: readonly TWorkflow[];
51
69
  readonly triggers: readonly ResolvedTrigger[];
@@ -512,6 +530,13 @@ type WorkflowManifestApproveNodeV1Json = {
512
530
  * @generated from field: string title = 3;
513
531
  */
514
532
  title?: string;
533
+ /**
534
+ * Milliseconds the approval may stay open, from the round that parks it.
535
+ * The SDK requires one, so a run cannot park for ever.
536
+ *
537
+ * @generated from field: optional double deadline = 4;
538
+ */
539
+ deadline?: number | "NaN" | "Infinity" | "-Infinity";
515
540
  };
516
541
  /**
517
542
  * Appears for a statically described ctx.waitForEvent call.
@@ -734,8 +759,6 @@ interface MemoEntry {
734
759
  * branches can order differently on a later pass, so it is not the key. */
735
760
  seq: number;
736
761
  stepId: string;
737
- /** Which call of this `stepId` in the run, from 0. */
738
- occurrence: number;
739
762
  /** Key of the step whose body recorded this, if any; a memoized parent hides it. */
740
763
  parent?: string;
741
764
  kind: StepKind;
@@ -747,7 +770,6 @@ interface MemoEntry {
747
770
  interface StepIntentBase {
748
771
  seq: number;
749
772
  stepId: string;
750
- occurrence: number;
751
773
  /** Kind-specific detail: sleep `ms`, `waitForEvent` name, approval title. */
752
774
  config?: Record<string, unknown>;
753
775
  meta?: WorkflowMetadata;
@@ -761,7 +783,6 @@ type StepIntent = StepIntentBase & ({
761
783
  interface StepResult<K extends StepKind = StepKind> {
762
784
  seq: number;
763
785
  stepId: string;
764
- occurrence: number;
765
786
  kind: K;
766
787
  meta?: WorkflowMetadata;
767
788
  status: "completed" | "failed";
@@ -788,7 +809,6 @@ interface ReplayOutcome {
788
809
  interface StepReference {
789
810
  kind: "step";
790
811
  stepId: string;
791
- occurrence: number;
792
812
  }
793
813
  //#endregion
794
814
  //#region src/stacks/tanstack/project-auth.d.ts
@@ -845,4 +865,4 @@ declare function createStepsHandler(collection: WorkflowCollection, options?: St
845
865
  */
846
866
  declare function toServerSentEventsResponse(events: AsyncIterable<WorkflowEvent>): Response;
847
867
  //#endregion
848
- export { type AnyWorkflowDefinition, type Cadence, type Ctx, type MemoEntry, type OverlapPolicy, type ReplayOutcome, type ResolvedSchedule, type ResolvedTrigger, type ScheduleDefinition, type StepContext, type StepIntent, type StepKind, type StepOptions, type StepReference, type StepResult, type StepsDisposition, type StepsHandler, type StepsHandlerOptions, type StepsRequest, type StepsResponse, type TanStackWorkflowHandler, type TanStackWorkflowHandlerOptions, type TriggerDefinition, type Weekday, type WorkflowBranchMetadata, type WorkflowCollection, type WorkflowDefinition, type WorkflowInput, type WorkflowManifest, type WorkflowOperationMetadata, type WorkflowOutput, type WorkflowState, type WorkflowStepGroup, type WorkflowStepMetadata, type WorkflowsDefinition, createMiddleware, createStepsHandler, createTanStackWorkflowHandler, createWorkflow, daily, defineSchedule, generateManifests, hourly, registerWorkflows, toServerSentEventsResponse, weekly };
868
+ export { type AnyWorkflowDefinition, type ApproveOptions, type Cadence, type Ctx, type MemoEntry, type OverlapPolicy, type ReplayOutcome, type ResolvedSchedule, type ResolvedTrigger, type ScheduleDefinition, type StepContext, type StepIntent, type StepKind, type StepOptions, type StepReference, type StepResult, type StepsDisposition, type StepsHandler, type StepsHandlerOptions, type StepsRequest, type StepsResponse, type TanStackWorkflowHandler, type TanStackWorkflowHandlerOptions, type TriggerDefinition, type WaitForEventOptions, type Weekday, type WorkflowBranchMetadata, type WorkflowCollection, type WorkflowDefinition, type WorkflowInput, type WorkflowManifest, type WorkflowOperationMetadata, type WorkflowOutput, type WorkflowState, type WorkflowStepGroup, type WorkflowStepMetadata, type WorkflowsDefinition, createMiddleware, createStepsHandler, createTanStackWorkflowHandler, createWorkflow, daily, defineSchedule, generateManifests, hourly, registerWorkflows, toServerSentEventsResponse, weekly };
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { t as DURABLE_ID_REQUIRED } from "./durable-ids-Cx341nJQ.js";
2
- import { C as registerWorkflows, D as hourly, E as daily, O as weekly, S as createWorkflow, T as defineSchedule, t as generateManifests, w as workflowVersions, x as createMiddleware } from "./generate-D1zt5ZZf.js";
2
+ import { C as registerWorkflows, D as hourly, E as daily, O as weekly, S as createWorkflow, T as defineSchedule, t as generateManifests, w as workflowVersions, x as createMiddleware } from "./generate-DBk472B5.js";
3
3
  import { WorkflowRequestParseError, inMemoryRunStore, parseWorkflowRequest, runWorkflow } from "@tanstack/workflow-core";
4
4
  //#region src/stacks/tanstack/sse.ts
5
5
  const HEADERS = {
@@ -127,9 +127,6 @@ async function hashInput(input) {
127
127
  //#region src/runtime/replay.ts
128
128
  /** How long a pass waits for handler work that is not a durable operation. */
129
129
  const DEFAULT_SETTLE_MS = 5e3;
130
- function memoKey(stepId, occurrence) {
131
- return `${stepId}#${occurrence}`;
132
- }
133
130
  const EXECUTABLE = /* @__PURE__ */ new Set([
134
131
  "step",
135
132
  "now",
@@ -169,13 +166,13 @@ async function throughMiddleware(middlewares, ctx, handler) {
169
166
  }
170
167
  async function replay(options) {
171
168
  const { workflow, input, runId } = options;
172
- const byKey = new Map(options.memo.map((entry) => [memoKey(entry.stepId, entry.occurrence ?? 0), entry]));
169
+ const byKey = new Map(options.memo.map((entry) => [entry.stepId, entry]));
173
170
  const allow = options.shouldExecute ?? (() => true);
174
171
  const never = new Promise(() => {});
175
172
  const pending = [];
176
173
  const settled = /* @__PURE__ */ new Map();
177
174
  const pass = { stepsSettled: 0 };
178
- const occurrences = /* @__PURE__ */ new Map();
175
+ const reached = /* @__PURE__ */ new Set();
179
176
  const consumed = /* @__PURE__ */ new Set();
180
177
  let lastProgress = Date.now();
181
178
  let currentParent;
@@ -185,13 +182,12 @@ async function replay(options) {
185
182
  let seq = 0;
186
183
  let nonDeterminism;
187
184
  function record(entry) {
188
- settled.set(memoKey(entry.stepId, entry.occurrence), entry);
185
+ settled.set(entry.stepId, entry);
189
186
  lastProgress = Date.now();
190
187
  if (entry.kind === "step") pass.stepsSettled += 1;
191
188
  const result = {
192
189
  seq: entry.seq,
193
190
  stepId: entry.stepId,
194
- occurrence: entry.occurrence,
195
191
  kind: entry.kind,
196
192
  ...entry.meta ? { meta: entry.meta } : {},
197
193
  status: entry.status,
@@ -207,18 +203,16 @@ async function replay(options) {
207
203
  return never;
208
204
  }
209
205
  const index = seq++;
210
- const occurrence = occurrences.get(stepId) ?? 0;
211
- occurrences.set(stepId, occurrence + 1);
212
- if (occurrence > 0) {
206
+ if (reached.has(stepId)) {
213
207
  nonDeterminism = `id "${stepId}" was reached more than once; every durable operation id must be unique within a workflow`;
214
208
  return never;
215
209
  }
216
- const key = memoKey(stepId, occurrence);
217
- consumed.add(key);
218
- const answered = byKey.get(key) ?? settled.get(key);
210
+ reached.add(stepId);
211
+ consumed.add(stepId);
212
+ const answered = byKey.get(stepId) ?? settled.get(stepId);
219
213
  if (answered) {
220
214
  if (answered.kind !== kind) {
221
- nonDeterminism = `memo has ${answered.kind} "${stepId}" (#${occurrence}), replay produced ${kind}`;
215
+ nonDeterminism = `memo has ${answered.kind} "${stepId}", replay produced ${kind}`;
222
216
  return never;
223
217
  }
224
218
  const recordedGroupId = groupId(answered.meta);
@@ -233,7 +227,6 @@ async function replay(options) {
233
227
  const intent = {
234
228
  seq: index,
235
229
  stepId,
236
- occurrence,
237
230
  kind,
238
231
  ...config ? { config } : {},
239
232
  ...meta ? { meta } : {}
@@ -244,7 +237,7 @@ async function replay(options) {
244
237
  }
245
238
  options.onStepStart?.(intent);
246
239
  const enclosing = currentParent;
247
- currentParent = key;
240
+ currentParent = stepId;
248
241
  let body;
249
242
  try {
250
243
  body = run();
@@ -255,7 +248,6 @@ async function replay(options) {
255
248
  record({
256
249
  seq: index,
257
250
  stepId,
258
- occurrence,
259
251
  kind,
260
252
  status: "completed",
261
253
  result,
@@ -267,7 +259,6 @@ async function replay(options) {
267
259
  record({
268
260
  seq: index,
269
261
  stepId,
270
- occurrence,
271
262
  kind,
272
263
  status: "failed",
273
264
  error: describe(error),
@@ -472,7 +463,7 @@ function resolveWorkflowId(ctx, param) {
472
463
  }
473
464
  function isMemoEntry(value) {
474
465
  const entry = value;
475
- return typeof entry === "object" && entry !== null && Number.isInteger(entry.seq) && entry.seq >= 0 && typeof entry.stepId === "string" && Number.isInteger(entry.seq) && Number.isInteger(entry.occurrence) && entry.occurrence >= 0 && (entry.status === "completed" || entry.status === "failed");
466
+ return typeof entry === "object" && entry !== null && Number.isInteger(entry.seq) && entry.seq >= 0 && typeof entry.stepId === "string" && Number.isInteger(entry.seq) && (entry.status === "completed" || entry.status === "failed");
476
467
  }
477
468
  function parseBody(value) {
478
469
  if (value === null || typeof value !== "object") return "body must be a JSON object";
@@ -480,10 +471,10 @@ function parseBody(value) {
480
471
  if (body.workflowVersion !== void 0 && typeof body.workflowVersion !== "string") return "workflowVersion must be a string";
481
472
  if (body.memo !== void 0) {
482
473
  if (!Array.isArray(body.memo) || !body.memo.every(isMemoEntry)) return "memo must be an array of settled step entries";
483
- if (new Set(body.memo.map((entry) => memoKey(entry.stepId, entry.occurrence))).size !== body.memo.length) return "memo entries must be unique per stepId and occurrence";
474
+ if (new Set(body.memo.map((entry) => entry.stepId)).size !== body.memo.length) return "memo entries must be unique per stepId";
484
475
  }
485
476
  if (body.action !== void 0 && body.action !== "advance" && body.action !== "execute") return "action must be \"advance\" or \"execute\"";
486
- if (body.action === "execute" && !isStepReference(body.step)) return "step must be a { kind: \"step\", stepId, occurrence } reference when action is \"execute\"";
477
+ if (body.action === "execute" && !isStepReference(body.step)) return "step must be a { kind: \"step\", stepId } reference when action is \"execute\"";
487
478
  if (body.action !== "execute" && body.step !== void 0) return "step is only valid when action is \"execute\"";
488
479
  if (body.memo !== void 0 && body.memo.length > 0 && !("input" in value)) return "input must be sent with every call, including a resume";
489
480
  return body;
@@ -493,12 +484,9 @@ async function readBody(request) {
493
484
  if (!text.trim()) return {};
494
485
  return JSON.parse(text);
495
486
  }
496
- function operationKey(operation) {
497
- return memoKey(operation.stepId, operation.occurrence);
498
- }
499
487
  function isStepReference(value) {
500
488
  const step = value;
501
- return typeof step === "object" && step !== null && step.kind === "step" && typeof step.stepId === "string" && Number.isInteger(step.occurrence) && step.occurrence >= 0;
489
+ return typeof step === "object" && step !== null && step.kind === "step" && typeof step.stepId === "string";
502
490
  }
503
491
  function disposition(outcome) {
504
492
  if (outcome.status === "completed") return "completed";
@@ -507,8 +495,8 @@ function disposition(outcome) {
507
495
  return outcome.steps.length > 1 ? "fork" : "advanced";
508
496
  }
509
497
  function memoDelta(before, after) {
510
- const existing = new Set(before.map((entry) => memoKey(entry.stepId, entry.occurrence)));
511
- return after.filter((entry) => !existing.has(memoKey(entry.stepId, entry.occurrence)));
498
+ const existing = new Set(before.map((entry) => entry.stepId));
499
+ return after.filter((entry) => !existing.has(entry.stepId));
512
500
  }
513
501
  function respond(runId, inputHash, workflowVersion, before, outcome, executed) {
514
502
  const { steps, emitted, output, error } = outcome;
@@ -654,12 +642,12 @@ function createStepsHandler(collection, options = {}) {
654
642
  input,
655
643
  memo: before,
656
644
  runId,
657
- shouldExecute: (intent) => intent.kind !== "step" || operationKey(intent) === operationKey(selected)
645
+ shouldExecute: (intent) => intent.kind !== "step" || intent.stepId === selected.stepId
658
646
  }));
659
- const executed = outcome.results.find((result) => result.kind === "step" && operationKey(result) === operationKey(selected));
647
+ const executed = outcome.results.find((result) => result.kind === "step" && result.stepId === selected.stepId);
660
648
  if (executed === void 0 && outcome.status !== "failed") return json(409, {
661
649
  error: "stale_step",
662
- message: `step "${selected.stepId}" (#${selected.occurrence}) is not executable from this memo`
650
+ message: `step "${selected.stepId}" is not executable from this memo`
663
651
  });
664
652
  return respond(runId, inputHash, workflow.version, before, outcome, executed);
665
653
  }
@@ -677,12 +665,12 @@ function createStepsHandler(collection, options = {}) {
677
665
  input,
678
666
  memo: described.memo,
679
667
  runId,
680
- shouldExecute: (intent) => intent.kind !== "step" || operationKey(intent) === operationKey(only)
668
+ shouldExecute: (intent) => intent.kind !== "step" || intent.stepId === only.stepId
681
669
  }));
682
- const executed = outcome.results.find((result) => result.kind === "step" && operationKey(result) === operationKey(only));
670
+ const executed = outcome.results.find((result) => result.kind === "step" && result.stepId === only.stepId);
683
671
  if (executed === void 0 && outcome.status !== "failed") return json(409, {
684
672
  error: "stale_step",
685
- message: `step "${only.stepId}" (#${only.occurrence}) is not executable from this memo`
673
+ message: `step "${only.stepId}" is not executable from this memo`
686
674
  });
687
675
  return respond(runId, inputHash, workflow.version, before, outcome, executed);
688
676
  };
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-Cd9aL2HY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CMXcTS6h.js";
2
2
  //#region src/manifests/nested-operations.ts
3
3
  const durableMethods = [
4
4
  "step",
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-Cd9aL2HY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CMXcTS6h.js";
2
2
  //#region src/manifests/operation-descriptions.ts
3
3
  const optionsArgument = {
4
4
  approve: 0,
@@ -1,4 +1,4 @@
1
- import { loadTypeScript, t as workflowHandlerSource } from "./graph-Cd9aL2HY.js";
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CMXcTS6h.js";
2
2
  //#region src/manifests/step-metadata.ts
3
3
  async function findStepMetadataIssues(handler) {
4
4
  const api = await loadTypeScript();
package/dist/vite.js CHANGED
@@ -1,4 +1,4 @@
1
- import { t as generateManifests } from "./generate-D1zt5ZZf.js";
1
+ import { t as generateManifests } from "./generate-DBk472B5.js";
2
2
  import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
3
3
  import { createServer } from "vite";
4
4
  import { lstat, mkdir, mkdtemp, readdir, rename, rm, writeFile } from "node:fs/promises";
@@ -0,0 +1,63 @@
1
+ import { loadTypeScript, t as workflowHandlerSource } from "./graph-CMXcTS6h.js";
2
+ //#region src/manifests/wait-deadlines.ts
3
+ const optionsArgument = {
4
+ approve: 0,
5
+ waitForEvent: 1
6
+ };
7
+ async function findWaitDeadlineIssues(handler) {
8
+ const api = await loadTypeScript();
9
+ if (!api) return [];
10
+ const ts = api;
11
+ const handlerSource = workflowHandlerSource(handler);
12
+ if (!handlerSource) return [];
13
+ const declaration = ts.createSourceFile("handler.js", `const handler = ${handlerSource};`, ts.ScriptTarget.ESNext, true, ts.ScriptKind.JS).statements[0];
14
+ const fn = declaration && ts.isVariableStatement(declaration) ? declaration.declarationList.declarations[0]?.initializer : void 0;
15
+ if (!fn || !ts.isArrowFunction(fn) && !ts.isFunctionExpression(fn)) return [];
16
+ const parameter = fn.parameters[0]?.name;
17
+ if (!parameter || !ts.isIdentifier(parameter)) return [];
18
+ const context = parameter.text;
19
+ function property(node, name) {
20
+ if (!node || !ts.isObjectLiteralExpression(node)) return void 0;
21
+ let result;
22
+ for (const entry of node.properties) {
23
+ if (ts.isSpreadAssignment(entry) || entry.name && ts.isComputedPropertyName(entry.name)) {
24
+ if (name === "timeoutMs") return node;
25
+ continue;
26
+ }
27
+ if ((entry.name && (ts.isIdentifier(entry.name) || ts.isStringLiteral(entry.name)) ? entry.name.text : void 0) === name) {
28
+ if (result !== void 0) return node;
29
+ result = ts.isPropertyAssignment(entry) ? entry.initializer : node;
30
+ }
31
+ }
32
+ return result;
33
+ }
34
+ const issues = [];
35
+ const visit = (node) => {
36
+ if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && ts.isIdentifier(node.expression.expression) && node.expression.expression.text === context && node.expression.name.text in optionsArgument) {
37
+ const method = node.expression.name.text;
38
+ const options = node.arguments[optionsArgument[method]];
39
+ const given = property(options, "timeoutMs");
40
+ if (property(options, "deadline") !== void 0) issues.push({
41
+ method,
42
+ reason: "absolute"
43
+ });
44
+ if (given === void 0) issues.push({
45
+ method,
46
+ reason: "missing"
47
+ });
48
+ else if (!ts.isNumericLiteral(given)) issues.push({
49
+ method,
50
+ reason: "dynamic"
51
+ });
52
+ else if (!(Number(given.text) >= 6e4 && Number.isFinite(Number(given.text)))) issues.push({
53
+ method,
54
+ reason: "invalid"
55
+ });
56
+ }
57
+ ts.forEachChild(node, visit);
58
+ };
59
+ visit(fn);
60
+ return issues;
61
+ }
62
+ //#endregion
63
+ export { findWaitDeadlineIssues };
@@ -0,0 +1,4 @@
1
+ //#region src/core/wait-deadlines.ts
2
+ const WAIT_DEADLINE_REQUIRED = "every waiting operation needs a static timeoutMs duration in milliseconds (a finite numeric literal of at least 60000 (one minute)), measured from when the wait first parks: ctx.approve({ id, title, timeoutMs: 3600000 }), ctx.waitForEvent(name, { id, timeoutMs: 3600000 }); absolute deadlines are not supported";
3
+ //#endregion
4
+ export { WAIT_DEADLINE_REQUIRED };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lovable.dev/workflows-sdk",
3
- "version": "0.0.0-dev.32",
3
+ "version": "0.0.0-dev.34",
4
4
  "publishConfig": {
5
5
  "access": "public",
6
6
  "tag": "dev",