@upstash/workflow 1.3.3 → 1.4.0

package/tanstack.js

@@ -26,6 +26,9 @@ __export(tanstack_exports, {
 });
 module.exports = __toCommonJS(tanstack_exports);
 
+// src/serve/index.ts
+var import_qstash12 = require("@upstash/qstash");
+
 // src/client/utils.ts
 var import_qstash2 = require("@upstash/qstash");
 
@@ -781,6 +784,10 @@ var triggerFirstInvocation = async (params) => {
         workflowConfig: {
           workflowRunId: workflowContext.workflowRunId,
           workflowUrl: workflowContext.url,
+          // the run doesn't exist yet, so the trigger time is sent when the creation time
+          // is not known. serve and client.trigger set it on the context already, so a
+          // retry of this request carries the same value and is deduplicated.
+          workflowRunCreatedAt: workflowContext.workflowRunCreatedAt || Date.now(),
           failureUrl,
           retries,
           retryDelay,
@@ -884,7 +891,10 @@ var triggerWorkflowDelete = async (workflowContext, result, cancel = false, disp
     path: ["v2", "workflows", "runs", `${workflowContext.workflowRunId}?cancel=${cancel}`],
     method: "DELETE",
     parseResponseAsJson: false,
-    body: JSON.stringify(result)
+    body: JSON.stringify(result),
+    // with the creation time, QStash deletes the run only if it is the same run.
+    // a late delete of a previous run can't delete a new run with the same id.
+    headers: workflowContext.workflowRunCreatedAt ? { [WORKFLOW_CREATED_AT_HEADER]: workflowContext.workflowRunCreatedAt.toString() } : void 0
   });
   await dispatchDebug?.("onInfo", {
     info: `Workflow run ${workflowContext.workflowRunId} deleted from QStash successfully.`
@@ -961,6 +971,7 @@ ${atob(callbackMessage.body ?? "")}`
       const concurrentString = request.headers.get("Upstash-Workflow-Concurrent");
       const contentType = request.headers.get("Upstash-Workflow-ContentType");
       const invokeCount = request.headers.get(WORKFLOW_INVOKE_COUNT_HEADER);
+      const workflowRunCreatedAt = request.headers.get(WORKFLOW_CREATED_AT_HEADER);
       if (!(workflowRunId && stepIdString && stepName && StepTypes.includes(stepType) && concurrentString && contentType)) {
         throw new Error(
           `Missing info in callback message source header: ${JSON.stringify({
@@ -978,6 +989,7 @@ ${atob(callbackMessage.body ?? "")}`
         workflowConfig: {
           workflowRunId,
           workflowUrl,
+          workflowRunCreatedAt: Number(workflowRunCreatedAt ?? "0"),
           telemetry: telemetry2
         },
         invokeCount: Number(invokeCount)
@@ -1125,6 +1137,7 @@ var BaseLazyStep = class _BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         useJSONContent: false,
         telemetry: telemetry2
       },
@@ -1452,6 +1465,8 @@ var LazyWaitEventStep = class extends BaseLazyStep {
       ) : {},
       // note: using WORKFLOW_ID_HEADER doesn't work, because Runid -> RunId:
       "Upstash-Workflow-Runid": [context.workflowRunId],
+      // same for WORKFLOW_CREATED_AT_HEADER, because Createdat -> CreatedAt:
+      ...context.workflowRunCreatedAt ? { "Upstash-Workflow-Createdat": [context.workflowRunCreatedAt.toString()] } : {},
       [WORKFLOW_INIT_HEADER]: ["false"],
       [WORKFLOW_URL_HEADER]: [context.url],
       "Upstash-Workflow-CallType": ["step"]
@@ -1554,6 +1569,7 @@ var LazyInvokeStep = class extends BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         telemetry: telemetry2,
         useJSONContent: false
       },
@@ -1563,6 +1579,9 @@ var LazyInvokeStep = class extends BaseLazyStep {
       invokerHeaders[key] = value;
     });
     invokerHeaders["Upstash-Workflow-Runid"] = context.workflowRunId;
+    if (context.workflowRunCreatedAt) {
+      invokerHeaders["Upstash-Workflow-Createdat"] = context.workflowRunCreatedAt.toString();
+    }
     const request = {
       body: stringifyBody(this.params.body),
       headers: Object.fromEntries(
@@ -1591,6 +1610,9 @@ var LazyInvokeStep = class extends BaseLazyStep {
       workflowConfig: {
         workflowRunId: getWorkflowRunId(workflowRunId),
         workflowUrl: newUrl,
+        // the invoked run doesn't exist yet, so the creation time of the invoker run is sent.
+        // it separates the invocations made by different runs of the invoker.
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         retries,
         retryDelay,
         telemetry: telemetry2,
@@ -1755,6 +1777,9 @@ var WorkflowHeaders = class {
       [WORKFLOW_PROTOCOL_VERSION_HEADER]: WORKFLOW_PROTOCOL_VERSION,
       ...this.workflowConfig.telemetry ? getTelemetryHeaders(this.workflowConfig.telemetry) : {}
     };
+    if (this.workflowConfig.workflowRunCreatedAt) {
+      this.headers.rawHeaders[WORKFLOW_CREATED_AT_HEADER] = this.workflowConfig.workflowRunCreatedAt.toString();
+    }
     if (this.stepInfo?.lazyStep.stepType !== "Call") {
       this.headers.rawHeaders[`Upstash-Forward-${WORKFLOW_PROTOCOL_VERSION_HEADER}`] = WORKFLOW_PROTOCOL_VERSION;
     }
@@ -1914,6 +1939,7 @@ var submitParallelSteps = async ({
         workflowConfig: {
           workflowRunId: context.workflowRunId,
           workflowUrl: context.url,
+          workflowRunCreatedAt: context.workflowRunCreatedAt,
           telemetry: telemetry2
         },
         invokeCount
@@ -3415,7 +3441,13 @@ var createRegionalHandler = (environment, receiverConfig, region, clientOptions)
   const client = new import_qstash11.Client({
     ...clientOptions,
     baseUrl: clientEnv.QSTASH_URL,
-    token: clientEnv.QSTASH_TOKEN
+    token: clientEnv.QSTASH_TOKEN,
+    // Mirror the receiver's dev-mode decision so a single QSTASH_DEV=true points
+    // the client at the local dev server too. Without this the QStash Client
+    // re-derives dev mode from its own process.env, which is blind to the
+    // Cloudflare worker `env` binding that actually carries QSTASH_DEV there.
+    // An explicit devMode in the user's client config still wins.
+    devMode: clientOptions?.devMode ?? isQStashDevModeEnabled(environment)
   });
   const receiver = getReceiver(environment, receiverConfig, region);
   return { client, receiver };
@@ -3465,7 +3497,9 @@ var getQStashHandlers = ({
         client: qstashClientOption && "http" in qstashClientOption ? qstashClientOption : new import_qstash11.Client({
           ...qstashClientOption,
           baseUrl: environment.QSTASH_URL,
-          token: environment.QSTASH_TOKEN
+          token: environment.QSTASH_TOKEN,
+          // Mirror the receiver's dev-mode decision (see createRegionalHandler).
+          devMode: qstashClientOption?.devMode ?? isQStashDevModeEnabled(environment)
         }),
         receiver: getReceiver(environment, receiverConfig)
       }
@@ -3804,7 +3838,8 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
     const invokeCount = Number(request.headers.get(WORKFLOW_INVOKE_COUNT_HEADER) ?? "0");
     const retried = Number(request.headers.get(WORKFLOW_RETRIED_HEADER) ?? "0");
     const label = request.headers.get(WORKFLOW_LABEL_HEADER) ?? void 0;
-    const workflowRunCreatedAt = request.headers.get(WORKFLOW_CREATED_AT_HEADER);
+    const workflowRunCreatedAtHeader = request.headers.get(WORKFLOW_CREATED_AT_HEADER);
+    const workflowRunCreatedAt = workflowRunCreatedAtHeader ? Number(workflowRunCreatedAtHeader) : isFirstInvocation ? Date.now() : 0;
     const workflowContext = new WorkflowContext({
       qstashClient: regionalClient,
       workflowRunId,
@@ -3817,7 +3852,7 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
       invokeCount,
       label,
       retried,
-      workflowRunCreatedAt: Number(workflowRunCreatedAt),
+      workflowRunCreatedAt,
       middlewareManager
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
@@ -3940,12 +3975,14 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
 };
 
 // platforms/tanstack.ts
+var import_qstash13 = require("@upstash/qstash");
 var telemetry = {
   sdk: SDK_TELEMETRY,
   framework: "tanstack",
   runtime: `node@${process.version}`
 };
 function serve(routeFunction, options) {
+  void (0, import_qstash13.startDevServer)();
   const POST = (tanstackContext) => {
     const { handler } = serveBase(
       routeFunction,

package/tanstack.mjs

@@ -2,15 +2,17 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-WEQGCISK.mjs";
+} from "./chunk-DRHEHWMS.mjs";
 
 // platforms/tanstack.ts
+import { startDevServer } from "@upstash/qstash";
 var telemetry = {
   sdk: SDK_TELEMETRY,
   framework: "tanstack",
   runtime: `node@${process.version}`
 };
 function serve(routeFunction, options) {
+  void startDevServer();
   const POST = (tanstackContext) => {
     const { handler } = serveBase(
       routeFunction,