@upstash/workflow 1.3.3 → 1.4.0

package/express.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(
@@ -3941,6 +3976,7 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
 
 // platforms/express.ts
 var import_express = require("express");
+var import_qstash13 = require("@upstash/qstash");
 var isEmptyRequest = (req) => {
   return req.headers["content-type"] === "application/json" && req.headers["content-length"] === "0";
 };
@@ -3991,6 +4027,7 @@ function createExpressHandler(params) {
   };
 }
 function serve(routeFunction, options) {
+  void (0, import_qstash13.startDevServer)();
   const router = (0, import_express.Router)();
   const handler = createExpressHandler([routeFunction, options]);
   router.all(/(.*)/, handler);
@@ -4006,6 +4043,7 @@ var createWorkflow = (...params) => {
   };
 };
 var serveMany = (workflows, options) => {
+  void (0, import_qstash13.startDevServer)();
   const router = (0, import_express.Router)();
   const { handler } = serveManyBase({
     workflows,

package/express.mjs

@@ -2,12 +2,13 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-WEQGCISK.mjs";
+} from "./chunk-DRHEHWMS.mjs";
 
 // platforms/express.ts
 import {
   Router
 } from "express";
+import { startDevServer } from "@upstash/qstash";
 var isEmptyRequest = (req) => {
   return req.headers["content-type"] === "application/json" && req.headers["content-length"] === "0";
 };
@@ -58,6 +59,7 @@ function createExpressHandler(params) {
   };
 }
 function serve(routeFunction, options) {
+  void startDevServer();
   const router = Router();
   const handler = createExpressHandler([routeFunction, options]);
   router.all(/(.*)/, handler);
@@ -73,6 +75,7 @@ var createWorkflow = (...params) => {
   };
 };
 var serveMany = (workflows, options) => {
+  void startDevServer();
   const router = Router();
   const { handler } = serveManyBase({
     workflows,

package/h3.js

@@ -335,6 +335,9 @@ async function _callHandler(event, handler, hooks) {
 var H3Headers = globalThis.Headers;
 var H3Response = globalThis.Response;
 
+// src/serve/index.ts
+var import_qstash12 = require("@upstash/qstash");
+
 // src/client/utils.ts
 var import_qstash2 = require("@upstash/qstash");
 
@@ -1090,6 +1093,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,
@@ -1193,7 +1200,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.`
@@ -1270,6 +1280,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({
@@ -1287,6 +1298,7 @@ ${atob(callbackMessage.body ?? "")}`
         workflowConfig: {
           workflowRunId,
           workflowUrl,
+          workflowRunCreatedAt: Number(workflowRunCreatedAt ?? "0"),
           telemetry: telemetry2
         },
         invokeCount: Number(invokeCount)
@@ -1434,6 +1446,7 @@ var BaseLazyStep = class _BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         useJSONContent: false,
         telemetry: telemetry2
       },
@@ -1761,6 +1774,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"]
@@ -1863,6 +1878,7 @@ var LazyInvokeStep = class extends BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         telemetry: telemetry2,
         useJSONContent: false
       },
@@ -1872,6 +1888,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(
@@ -1900,6 +1919,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,
@@ -2064,6 +2086,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;
     }
@@ -2223,6 +2248,7 @@ var submitParallelSteps = async ({
         workflowConfig: {
           workflowRunId: context.workflowRunId,
           workflowUrl: context.url,
+          workflowRunCreatedAt: context.workflowRunCreatedAt,
           telemetry: telemetry2
         },
         invokeCount
@@ -3724,7 +3750,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 };
@@ -3774,7 +3806,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)
       }
@@ -4113,7 +4147,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,
@@ -4126,7 +4161,7 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
       invokeCount,
       label,
       retried,
-      workflowRunCreatedAt: Number(workflowRunCreatedAt),
+      workflowRunCreatedAt,
       middlewareManager
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
@@ -4249,6 +4284,7 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
 };
 
 // platforms/h3.ts
+var import_qstash13 = require("@upstash/qstash");
 function transformHeaders(headers) {
   const formattedHeaders = Object.entries(headers).map(([key, value]) => [
     key,
@@ -4269,6 +4305,7 @@ var telemetry = {
   runtime: process.versions.bun ? `bun@${process.versions.bun}/node@${process.version}` : `node@${process.version}`
 };
 var serve = (routeFunction, options) => {
+  void (0, import_qstash13.startDevServer)();
   const handler = defineEventHandler(async (event) => {
     const method = event.node.req.method;
     if (method?.toUpperCase() !== "POST") {

package/h3.mjs

@@ -2,7 +2,7 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-WEQGCISK.mjs";
+} from "./chunk-DRHEHWMS.mjs";
 
 // node_modules/defu/dist/defu.mjs
 function isPlainObject(value) {
@@ -314,6 +314,7 @@ var H3Headers = globalThis.Headers;
 var H3Response = globalThis.Response;
 
 // platforms/h3.ts
+import { startDevServer } from "@upstash/qstash";
 function transformHeaders(headers) {
   const formattedHeaders = Object.entries(headers).map(([key, value]) => [
     key,
@@ -334,6 +335,7 @@ var telemetry = {
   runtime: process.versions.bun ? `bun@${process.versions.bun}/node@${process.version}` : `node@${process.version}`
 };
 var serve = (routeFunction, options) => {
+  void startDevServer();
   const handler = defineEventHandler(async (event) => {
     const method = event.node.req.method;
     if (method?.toUpperCase() !== "POST") {

package/hono.js

@@ -26,6 +26,9 @@ __export(hono_exports, {
 });
 module.exports = __toCommonJS(hono_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,11 +3975,13 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
 };
 
 // platforms/hono.ts
+var import_qstash13 = require("@upstash/qstash");
 var telemetry = {
   sdk: SDK_TELEMETRY,
   framework: "hono"
 };
 var serve = (routeFunction, options) => {
+  void (0, import_qstash13.startDevServer)();
   const handler = async (context) => {
     const environment = context.env ? context.env : typeof process === "undefined" ? {} : process.env;
     const request = context.req.raw;

package/hono.mjs

@@ -2,14 +2,16 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-WEQGCISK.mjs";
+} from "./chunk-DRHEHWMS.mjs";
 
 // platforms/hono.ts
+import { startDevServer } from "@upstash/qstash";
 var telemetry = {
   sdk: SDK_TELEMETRY,
   framework: "hono"
 };
 var serve = (routeFunction, options) => {
+  void startDevServer();
   const handler = async (context) => {
     const environment = context.env ? context.env : typeof process === "undefined" ? {} : process.env;
     const request = context.req.raw;

package/index.d.mts

@@ -209,6 +209,11 @@ type StepLogGroup = {
      */
     type: "next";
 };
+/**
+ * State of the failure function (`failureUrl`/`failureFunction`) call of a
+ * failed workflow run.
+ */
+type FailureFunctionState = "CALLBACK_INPROGRESS" | "CALLBACK_SUCCESS" | "CALLBACK_FAIL" | "CALLBACK_CANCELED";
 type FailureFunctionLog = {
     /**
      * messageId of the message published for handling the failure
@@ -221,7 +226,7 @@ type FailureFunctionLog = {
     /**
      * State of the message published for failure
      */
-    state: "CALLBACK_INPROGRESS" | "CALLBACK_SUCCESS" | "CALLBACK_FAIL" | "CALLBACK_CANCELED";
+    state: FailureFunctionState;
     /**
      * Headers received from the step which caused the workflow to fail
      */
@@ -570,7 +575,11 @@ type WorkflowFilterFields = {
     workflowUrl?: string | string[];
     workflowRunId?: string;
     workflowCreatedAt?: number;
-    failureFunctionState?: string;
+    /**
+     * Filter by the state of the failure function call. Supports multiple values:
+     * pass an array to match runs in any of the given states (OR semantics).
+     */
+    failureFunctionState?: FailureFunctionState | FailureFunctionState[];
 };
 type WorkflowLogsFilterFields = {
     state?: WorkflowRunLog["workflowState"];
@@ -680,7 +689,7 @@ type ResumeRestartOptions = {
     retries?: number;
 };
 type FailureCallbackInfo = {
-    state?: "CALLBACK_FAIL" | "CALLBACK_SUCCESS" | "CALLBACK_INPROGRESS" | "CALLBACK_CANCELED";
+    state?: FailureFunctionState;
     responseStatus?: number;
     responseBody?: string;
     responseHeaders?: Record<string, string[]>;
@@ -834,6 +843,15 @@ declare class DLQ {
     retryFailureFunction({ dlqId }: Pick<DLQResumeRestartOptions<string>, "dlqId">): Promise<DLQResumeRestartResponse & {
         error?: string;
     }>;
+    /**
+     * Cancel the in-progress failure function (failureUrl/failureFunction) call
+     * of a workflow run.
+     *
+     * Fails if the run has no failure function call in progress.
+     *
+     * @param dlqId - The ID of the DLQ message whose failure function call will be canceled
+     */
+    cancelFailureFunction({ dlqId }: Pick<DLQResumeRestartOptions<string>, "dlqId">): Promise<void>;
     /**
      * Delete DLQ messages.
      *
@@ -1071,4 +1089,4 @@ declare class Client {
     get dlq(): DLQ;
 }
 
-export { Client, type DLQResumeRestartOptions, type DLQResumeRestartResponse, NotifyResponse, RawStep, RouteFunction, type StepError, type StepLog, StepType, Telemetry, type TriggerOptions, Waiter, WorkflowClient, WorkflowMiddleware, WorkflowReceiver, type WorkflowRunLog, type WorkflowRunLogs, WorkflowServeOptions, loggingMiddleware, serve };
+export { Client, type DLQResumeRestartOptions, type DLQResumeRestartResponse, type FailureFunctionState, NotifyResponse, RawStep, RouteFunction, type StepError, type StepLog, StepType, Telemetry, type TriggerOptions, Waiter, WorkflowClient, WorkflowMiddleware, WorkflowReceiver, type WorkflowRunLog, type WorkflowRunLogs, WorkflowServeOptions, loggingMiddleware, serve };