@upstash/workflow 1.3.3 → 1.4.0

package/astro.js

@@ -26,6 +26,9 @@ __export(astro_exports, {
 });
 module.exports = __toCommonJS(astro_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/astro.ts
+var import_qstash13 = require("@upstash/qstash");
 var telemetry = {
   sdk: SDK_TELEMETRY,
   framework: "astro",
   runtime: process.versions.bun ? `bun@${process.versions.bun}/node@${process.version}` : `node@${process.version}`
 };
 function serve(routeFunction, options) {
+  void (0, import_qstash13.startDevServer)();
   const POST = (apiContext) => {
     const { handler } = serveBase(
       (workflowContext) => routeFunction(workflowContext, apiContext),

package/astro.mjs

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

package/{chunk-WEQGCISK.mjs → chunk-DRHEHWMS.mjs}

@@ -906,6 +906,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,
@@ -1009,7 +1013,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.`
@@ -1086,6 +1093,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({
@@ -1103,6 +1111,7 @@ ${atob(callbackMessage.body ?? "")}`
         workflowConfig: {
           workflowRunId,
           workflowUrl,
+          workflowRunCreatedAt: Number(workflowRunCreatedAt ?? "0"),
           telemetry
         },
         invokeCount: Number(invokeCount)
@@ -1250,6 +1259,7 @@ var BaseLazyStep = class _BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         useJSONContent: false,
         telemetry
       },
@@ -1577,6 +1587,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"]
@@ -1679,6 +1691,7 @@ var LazyInvokeStep = class extends BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         telemetry,
         useJSONContent: false
       },
@@ -1688,6 +1701,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(
@@ -1716,6 +1732,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,
@@ -1880,6 +1899,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;
     }
@@ -2039,6 +2061,7 @@ var submitParallelSteps = async ({
         workflowConfig: {
           workflowRunId: context.workflowRunId,
           workflowUrl: context.url,
+          workflowRunCreatedAt: context.workflowRunCreatedAt,
           telemetry
         },
         invokeCount
@@ -3167,6 +3190,9 @@ var loggingMiddleware = new WorkflowMiddleware({
   }
 });
 
+// src/serve/index.ts
+import { startDevServer } from "@upstash/qstash";
+
 // src/serve/authorization.ts
 import { Client as Client2 } from "@upstash/qstash";
 var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowContext {
@@ -3539,7 +3565,13 @@ var createRegionalHandler = (environment, receiverConfig, region, clientOptions)
   const client = new Client3({
     ...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 };
@@ -3589,7 +3621,9 @@ var getQStashHandlers = ({
         client: qstashClientOption && "http" in qstashClientOption ? qstashClientOption : new Client3({
           ...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)
       }
@@ -3854,7 +3888,8 @@ var serveBase = (routeFunction, telemetry, 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,
@@ -3867,7 +3902,7 @@ var serveBase = (routeFunction, telemetry, options, internalOptions) => {
       invokeCount,
       label,
       retried,
-      workflowRunCreatedAt: Number(workflowRunCreatedAt),
+      workflowRunCreatedAt,
       middlewareManager
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
@@ -3989,6 +4024,7 @@ var serveBase = (routeFunction, telemetry, options, internalOptions) => {
   return { handler: safeHandler };
 };
 var serve = (routeFunction, options) => {
+  void startDevServer();
   return serveBase(
     routeFunction,
     {
@@ -4004,6 +4040,7 @@ export {
   WorkflowAbort,
   WorkflowNonRetryableError,
   WorkflowRetryAfterError,
+  isInstanceOf,
   assertNonEmptyId,
   toNonEmptyIdArray,
   makeNotifyRequest,

package/cloudflare.js

@@ -51,6 +51,9 @@ var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
 var TELEMETRY_HEADER_RUNTIME = "Upstash-Telemetry-Runtime";
 
+// 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,6 +3975,7 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
 };
 
 // platforms/cloudflare.ts
+var import_qstash13 = require("@upstash/qstash");
 var getArgs = (args) => {
   if (!Array.isArray(args) || args.length === 0) {
     throw new Error("No arguments passed to serve handler");
@@ -3963,6 +3999,7 @@ var telemetry = {
   framework: "cloudflare"
 };
 var serve = (routeFunction, options) => {
+  void (0, import_qstash13.startDevServer)();
   const fetch = async (...args) => {
     const { request, env } = getArgs(args);
     const { handler: serveHandler } = serveBase(routeFunction, telemetry, {

package/cloudflare.mjs

@@ -2,9 +2,10 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-WEQGCISK.mjs";
+} from "./chunk-DRHEHWMS.mjs";
 
 // platforms/cloudflare.ts
+import { startDevServer } from "@upstash/qstash";
 var getArgs = (args) => {
   if (!Array.isArray(args) || args.length === 0) {
     throw new Error("No arguments passed to serve handler");
@@ -28,6 +29,7 @@ var telemetry = {
   framework: "cloudflare"
 };
 var serve = (routeFunction, options) => {
+  void startDevServer();
   const fetch = async (...args) => {
     const { request, env } = getArgs(args);
     const { handler: serveHandler } = serveBase(routeFunction, telemetry, {