@upstash/workflow 1.2.0 → 1.3.0

package/README.md

@@ -108,6 +108,16 @@ const result = await client.getWaiters({
 });
 ```
 
+## Local Development
+
+For local development, set `QSTASH_DEV=true` in your environment and the SDK will automatically download and run a local QStash dev server. No tokens or signing keys required: workflow endpoints will verify signatures against the dev server's keys automatically.
+
+```bash .env
+QSTASH_DEV=true
+```
+
+See [Local Development](https://upstash.com/docs/workflow/howto/local-development/development-server) for details.
+
 ## Telemetry
 
 This sdk sends anonymous telemetry headers to help us improve your experience.

package/astro.d.mts

@@ -1,6 +1,6 @@
 import { APIContext, APIRoute } from 'astro';
-import { u as WorkflowContext, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B2S08hRU.mjs';
-import { s as serveManyBase } from './serve-many-C6sa_DxN.mjs';
+import { u as WorkflowContext, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B_E1VAK6.mjs';
+import { s as serveManyBase } from './serve-many-D3D9uE4u.mjs';
 import '@upstash/qstash';
 import 'zod';
 

package/astro.d.ts

@@ -1,6 +1,6 @@
 import { APIContext, APIRoute } from 'astro';
-import { u as WorkflowContext, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B2S08hRU.js';
-import { s as serveManyBase } from './serve-many-B-fe7bh7.js';
+import { u as WorkflowContext, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B_E1VAK6.js';
+import { s as serveManyBase } from './serve-many-kPOasiyb.js';
 import '@upstash/qstash';
 import 'zod';
 

package/astro.js

@@ -192,6 +192,7 @@ var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FAILURE_CALLBACK_HEADER = "Upstash-Workflow-Failure-Callback";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_RETRIED_HEADER = "Upstash-Retried";
 var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_UNKOWN_SDK_VERSION_HEADER = "Upstash-Workflow-Unknown-Sdk";
 var WORKFLOW_UNKOWN_SDK_TRIGGER_HEADER = "upstash-workflow-trigger-by-sdk";
@@ -200,7 +201,7 @@ var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
 var DEFAULT_CONTENT_TYPE = "application/json";
 var NO_CONCURRENCY = 1;
 var DEFAULT_RETRIES = 3;
-var VERSION = "v1.0.0";
+var VERSION = "v1.2.1";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -855,6 +856,9 @@ var recreateUserHeaders = (headers) => {
   }
   return filteredHeaders;
 };
+var isThirdPartyCallResult = (request) => {
+  return request.headers.get("Upstash-Workflow-Callback") !== null;
+};
 var handleThirdPartyCallResult = async ({
   request,
   requestPayload,
@@ -864,7 +868,7 @@ var handleThirdPartyCallResult = async ({
   middlewareManager
 }) => {
   try {
-    if (request.headers.get("Upstash-Workflow-Callback")) {
+    if (isThirdPartyCallResult(request)) {
       let callbackPayload;
       if (requestPayload) {
         callbackPayload = requestPayload;
@@ -2707,6 +2711,13 @@ var WorkflowContext = class {
    * ```
    */
   label;
+  /**
+   * Number of times QStash has retried delivering the current request.
+   *
+   * Sourced from the `Upstash-Retried` header. `0` on the first delivery,
+   * `1` on the first retry, `2` on the second, and so on.
+   */
+  retried;
   constructor({
     qstashClient,
     workflowRunId,
@@ -2719,6 +2730,7 @@ var WorkflowContext = class {
     telemetry: telemetry2,
     invokeCount,
     label,
+    retried,
     middlewareManager
   }) {
     this.qstashClient = qstashClient;
@@ -2730,6 +2742,7 @@ var WorkflowContext = class {
     this.requestPayload = initialPayload;
     this.env = env ?? {};
     this.label = label;
+    this.retried = retried ?? 0;
     const middlewareManagerInstance = middlewareManager ?? new MiddlewareManager([]);
     middlewareManagerInstance.assignContext(this);
     this.executor = new AutoExecutor(
@@ -2993,7 +3006,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
     const disabledContext = new _DisabledWorkflowContext({
       qstashClient: new import_qstash10.Client({
         baseUrl: "disabled-client",
-        token: "disabled-client"
+        token: "disabled-client",
+        devMode: false
       }),
       workflowRunId: context.workflowRunId,
       workflowRunCreatedAt: context.workflowRunCreatedAt,
@@ -3002,7 +3016,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       url: context.url,
       initialPayload: context.requestPayload,
       env: context.env,
-      label: context.label
+      label: context.label,
+      retried: context.retried
     });
     try {
       await routeFunction(disabledContext);
@@ -3218,6 +3233,7 @@ var handleFailure = async ({
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
     const userHeaders = recreateUserHeaders(request.headers);
+    const retried = Number(request.headers.get(WORKFLOW_RETRIED_HEADER) ?? "0");
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -3229,6 +3245,7 @@ var handleFailure = async ({
       telemetry: void 0,
       // not going to make requests in authentication check
       label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0,
+      retried,
       workflowRunCreatedAt: workflowCreatedAt,
       middlewareManager: void 0
     });
@@ -3388,6 +3405,9 @@ var getReceiver = (environment, receiverConfig, region) => {
     if (receiverConfig === "set-to-undefined") {
       return void 0;
     }
+    if (isQStashDevModeEnabled(environment)) {
+      return new import_qstash11.Receiver({ devMode: true });
+    }
     const receiverEnv = readReceiverEnvironmentVariables(environment, region);
     return receiverEnv.QSTASH_CURRENT_SIGNING_KEY && receiverEnv.QSTASH_NEXT_SIGNING_KEY ? new import_qstash11.Receiver({
       currentSigningKey: receiverEnv.QSTASH_CURRENT_SIGNING_KEY,
@@ -3397,6 +3417,10 @@ var getReceiver = (environment, receiverConfig, region) => {
     return receiverConfig;
   }
 };
+var isQStashDevModeEnabled = (env) => {
+  const value = env.QSTASH_DEV;
+  return value === "true" || value === "1";
+};
 var getQStashHandlerOptions = (...params) => {
   const handlers = getQStashHandlers(...params);
   return {
@@ -3706,12 +3730,13 @@ 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 workflowContext = new WorkflowContext({
       qstashClient: regionalClient,
       workflowRunId,
-      initialPayload: initialPayloadParser(rawInitialPayload),
+      initialPayload: isThirdPartyCallResult(request) ? JSON.parse(rawInitialPayload) : initialPayloadParser(rawInitialPayload),
       headers: recreateUserHeaders(request.headers),
       steps,
       url: workflowUrl,
@@ -3719,6 +3744,7 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
       telemetry: telemetry2,
       invokeCount,
       label,
+      retried,
       workflowRunCreatedAt: Number(workflowRunCreatedAt),
       middlewareManager
     });

package/astro.mjs

@@ -2,7 +2,7 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-V5ZUHMAF.mjs";
+} from "./chunk-G24J5PCC.mjs";
 
 // platforms/astro.ts
 var telemetry = {

package/{chunk-V5ZUHMAF.mjs → chunk-G24J5PCC.mjs}

@@ -103,6 +103,7 @@ var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FAILURE_CALLBACK_HEADER = "Upstash-Workflow-Failure-Callback";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_RETRIED_HEADER = "Upstash-Retried";
 var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_UNKOWN_SDK_VERSION_HEADER = "Upstash-Workflow-Unknown-Sdk";
 var WORKFLOW_UNKOWN_SDK_TRIGGER_HEADER = "upstash-workflow-trigger-by-sdk";
@@ -111,7 +112,7 @@ var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
 var DEFAULT_CONTENT_TYPE = "application/json";
 var NO_CONCURRENCY = 1;
 var DEFAULT_RETRIES = 3;
-var VERSION = "v1.0.0";
+var VERSION = "v1.2.1";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -277,6 +278,66 @@ var getSteps = async (requester, workflowRunId, messageId, dispatchDebug) => {
     }
   }
 };
+function normalizeCursor(response) {
+  const cursor = response.cursor;
+  return { ...response, cursor: cursor || void 0 };
+}
+var DEFAULT_BULK_COUNT = 100;
+function buildBulkActionQueryParameters(request, options) {
+  const cursor = "cursor" in request ? request.cursor : void 0;
+  if ("all" in request) {
+    return { count: request.count ?? DEFAULT_BULK_COUNT, cursor };
+  }
+  if ("dlqIds" in request) {
+    const ids = request.dlqIds;
+    if (Array.isArray(ids) && ids.length === 0) {
+      throw new QstashError2(
+        "Empty dlqIds array provided. If you intend to target all DLQ messages, use { all: true } explicitly."
+      );
+    }
+    return { dlqIds: ids, cursor };
+  }
+  if ("workflowRunIds" in request && request.workflowRunIds) {
+    if (request.workflowRunIds.length === 0) {
+      throw new QstashError2(
+        "Empty workflowRunIds array provided. If you intend to target all workflow runs, use { all: true } explicitly."
+      );
+    }
+    return { workflowRunIds: request.workflowRunIds };
+  }
+  const filter = request.filter;
+  if (!filter) {
+    throw new QstashError2(
+      "No filter provided. Use { filter: { ... } } with at least one filter field, or { all: true }."
+    );
+  }
+  if (options?.translateWorkflowUrl) {
+    const { workflowUrlStartingWith, workflowUrl, ...rest } = filter;
+    if (workflowUrlStartingWith && workflowUrl) {
+      throw new QstashError2(
+        "workflowUrl and workflowUrlStartingWith are mutually exclusive. Use workflowUrl for exact match or workflowUrlStartingWith for prefix match."
+      );
+    }
+    const urlParams = {};
+    if (workflowUrlStartingWith) {
+      urlParams.workflowUrl = workflowUrlStartingWith;
+    } else if (workflowUrl) {
+      urlParams.workflowUrl = workflowUrl;
+      urlParams.workflowUrlExactMatch = true;
+    }
+    return {
+      ...rest,
+      ...urlParams,
+      count: request.count ?? DEFAULT_BULK_COUNT,
+      cursor
+    };
+  }
+  return {
+    ...filter,
+    count: request.count ?? DEFAULT_BULK_COUNT,
+    cursor
+  };
+}
 
 // src/utils.ts
 var NANOID_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_";
@@ -907,6 +968,9 @@ var recreateUserHeaders = (headers) => {
   }
   return filteredHeaders;
 };
+var isThirdPartyCallResult = (request) => {
+  return request.headers.get("Upstash-Workflow-Callback") !== null;
+};
 var handleThirdPartyCallResult = async ({
   request,
   requestPayload,
@@ -916,7 +980,7 @@ var handleThirdPartyCallResult = async ({
   middlewareManager
 }) => {
   try {
-    if (request.headers.get("Upstash-Workflow-Callback")) {
+    if (isThirdPartyCallResult(request)) {
       let callbackPayload;
       if (requestPayload) {
         callbackPayload = requestPayload;
@@ -2684,6 +2748,13 @@ var WorkflowContext = class {
    * ```
    */
   label;
+  /**
+   * Number of times QStash has retried delivering the current request.
+   *
+   * Sourced from the `Upstash-Retried` header. `0` on the first delivery,
+   * `1` on the first retry, `2` on the second, and so on.
+   */
+  retried;
   constructor({
     qstashClient,
     workflowRunId,
@@ -2696,6 +2767,7 @@ var WorkflowContext = class {
     telemetry,
     invokeCount,
     label,
+    retried,
     middlewareManager
   }) {
     this.qstashClient = qstashClient;
@@ -2707,6 +2779,7 @@ var WorkflowContext = class {
     this.requestPayload = initialPayload;
     this.env = env ?? {};
     this.label = label;
+    this.retried = retried ?? 0;
     const middlewareManagerInstance = middlewareManager ?? new MiddlewareManager([]);
     middlewareManagerInstance.assignContext(this);
     this.executor = new AutoExecutor(
@@ -3044,7 +3117,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
     const disabledContext = new _DisabledWorkflowContext({
       qstashClient: new Client2({
         baseUrl: "disabled-client",
-        token: "disabled-client"
+        token: "disabled-client",
+        devMode: false
       }),
       workflowRunId: context.workflowRunId,
       workflowRunCreatedAt: context.workflowRunCreatedAt,
@@ -3053,7 +3127,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       url: context.url,
       initialPayload: context.requestPayload,
       env: context.env,
-      label: context.label
+      label: context.label,
+      retried: context.retried
     });
     try {
       await routeFunction(disabledContext);
@@ -3269,6 +3344,7 @@ var handleFailure = async ({
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
     const userHeaders = recreateUserHeaders(request.headers);
+    const retried = Number(request.headers.get(WORKFLOW_RETRIED_HEADER) ?? "0");
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -3280,6 +3356,7 @@ var handleFailure = async ({
       telemetry: void 0,
       // not going to make requests in authentication check
       label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0,
+      retried,
       workflowRunCreatedAt: workflowCreatedAt,
       middlewareManager: void 0
     });
@@ -3439,6 +3516,9 @@ var getReceiver = (environment, receiverConfig, region) => {
     if (receiverConfig === "set-to-undefined") {
       return void 0;
     }
+    if (isQStashDevModeEnabled(environment)) {
+      return new Receiver({ devMode: true });
+    }
     const receiverEnv = readReceiverEnvironmentVariables(environment, region);
     return receiverEnv.QSTASH_CURRENT_SIGNING_KEY && receiverEnv.QSTASH_NEXT_SIGNING_KEY ? new Receiver({
       currentSigningKey: receiverEnv.QSTASH_CURRENT_SIGNING_KEY,
@@ -3448,6 +3528,10 @@ var getReceiver = (environment, receiverConfig, region) => {
     return receiverConfig;
   }
 };
+var isQStashDevModeEnabled = (env) => {
+  const value = env.QSTASH_DEV;
+  return value === "true" || value === "1";
+};
 var getQStashHandlerOptions = (...params) => {
   const handlers = getQStashHandlers(...params);
   return {
@@ -3683,12 +3767,13 @@ 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 workflowContext = new WorkflowContext({
       qstashClient: regionalClient,
       workflowRunId,
-      initialPayload: initialPayloadParser(rawInitialPayload),
+      initialPayload: isThirdPartyCallResult(request) ? JSON.parse(rawInitialPayload) : initialPayloadParser(rawInitialPayload),
       headers: recreateUserHeaders(request.headers),
       steps,
       url: workflowUrl,
@@ -3696,6 +3781,7 @@ var serveBase = (routeFunction, telemetry, options, internalOptions) => {
       telemetry,
       invokeCount,
       label,
+      retried,
       workflowRunCreatedAt: Number(workflowRunCreatedAt),
       middlewareManager
     });
@@ -3833,6 +3919,8 @@ export {
   WorkflowRetryAfterError,
   makeNotifyRequest,
   makeGetWaitersRequest,
+  normalizeCursor,
+  buildBulkActionQueryParameters,
   WORKFLOW_LABEL_HEADER,
   SDK_TELEMETRY,
   getWorkflowRunId,

package/cloudflare.d.mts

@@ -1,5 +1,5 @@
-import { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B2S08hRU.mjs';
-import { s as serveManyBase } from './serve-many-C6sa_DxN.mjs';
+import { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B_E1VAK6.mjs';
+import { s as serveManyBase } from './serve-many-D3D9uE4u.mjs';
 import '@upstash/qstash';
 import 'zod';
 

package/cloudflare.d.ts

@@ -1,5 +1,5 @@
-import { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B2S08hRU.js';
-import { s as serveManyBase } from './serve-many-B-fe7bh7.js';
+import { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B_E1VAK6.js';
+import { s as serveManyBase } from './serve-many-kPOasiyb.js';
 import '@upstash/qstash';
 import 'zod';
 

package/cloudflare.js

@@ -35,6 +35,7 @@ var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FAILURE_CALLBACK_HEADER = "Upstash-Workflow-Failure-Callback";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_RETRIED_HEADER = "Upstash-Retried";
 var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_UNKOWN_SDK_VERSION_HEADER = "Upstash-Workflow-Unknown-Sdk";
 var WORKFLOW_UNKOWN_SDK_TRIGGER_HEADER = "upstash-workflow-trigger-by-sdk";
@@ -43,7 +44,7 @@ var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
 var DEFAULT_CONTENT_TYPE = "application/json";
 var NO_CONCURRENCY = 1;
 var DEFAULT_RETRIES = 3;
-var VERSION = "v1.0.0";
+var VERSION = "v1.2.1";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -855,6 +856,9 @@ var recreateUserHeaders = (headers) => {
   }
   return filteredHeaders;
 };
+var isThirdPartyCallResult = (request) => {
+  return request.headers.get("Upstash-Workflow-Callback") !== null;
+};
 var handleThirdPartyCallResult = async ({
   request,
   requestPayload,
@@ -864,7 +868,7 @@ var handleThirdPartyCallResult = async ({
   middlewareManager
 }) => {
   try {
-    if (request.headers.get("Upstash-Workflow-Callback")) {
+    if (isThirdPartyCallResult(request)) {
       let callbackPayload;
       if (requestPayload) {
         callbackPayload = requestPayload;
@@ -2707,6 +2711,13 @@ var WorkflowContext = class {
    * ```
    */
   label;
+  /**
+   * Number of times QStash has retried delivering the current request.
+   *
+   * Sourced from the `Upstash-Retried` header. `0` on the first delivery,
+   * `1` on the first retry, `2` on the second, and so on.
+   */
+  retried;
   constructor({
     qstashClient,
     workflowRunId,
@@ -2719,6 +2730,7 @@ var WorkflowContext = class {
     telemetry: telemetry2,
     invokeCount,
     label,
+    retried,
     middlewareManager
   }) {
     this.qstashClient = qstashClient;
@@ -2730,6 +2742,7 @@ var WorkflowContext = class {
     this.requestPayload = initialPayload;
     this.env = env ?? {};
     this.label = label;
+    this.retried = retried ?? 0;
     const middlewareManagerInstance = middlewareManager ?? new MiddlewareManager([]);
     middlewareManagerInstance.assignContext(this);
     this.executor = new AutoExecutor(
@@ -2993,7 +3006,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
     const disabledContext = new _DisabledWorkflowContext({
       qstashClient: new import_qstash10.Client({
         baseUrl: "disabled-client",
-        token: "disabled-client"
+        token: "disabled-client",
+        devMode: false
       }),
       workflowRunId: context.workflowRunId,
       workflowRunCreatedAt: context.workflowRunCreatedAt,
@@ -3002,7 +3016,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       url: context.url,
       initialPayload: context.requestPayload,
       env: context.env,
-      label: context.label
+      label: context.label,
+      retried: context.retried
     });
     try {
       await routeFunction(disabledContext);
@@ -3218,6 +3233,7 @@ var handleFailure = async ({
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
     const userHeaders = recreateUserHeaders(request.headers);
+    const retried = Number(request.headers.get(WORKFLOW_RETRIED_HEADER) ?? "0");
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -3229,6 +3245,7 @@ var handleFailure = async ({
       telemetry: void 0,
       // not going to make requests in authentication check
       label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0,
+      retried,
       workflowRunCreatedAt: workflowCreatedAt,
       middlewareManager: void 0
     });
@@ -3388,6 +3405,9 @@ var getReceiver = (environment, receiverConfig, region) => {
     if (receiverConfig === "set-to-undefined") {
       return void 0;
     }
+    if (isQStashDevModeEnabled(environment)) {
+      return new import_qstash11.Receiver({ devMode: true });
+    }
     const receiverEnv = readReceiverEnvironmentVariables(environment, region);
     return receiverEnv.QSTASH_CURRENT_SIGNING_KEY && receiverEnv.QSTASH_NEXT_SIGNING_KEY ? new import_qstash11.Receiver({
       currentSigningKey: receiverEnv.QSTASH_CURRENT_SIGNING_KEY,
@@ -3397,6 +3417,10 @@ var getReceiver = (environment, receiverConfig, region) => {
     return receiverConfig;
   }
 };
+var isQStashDevModeEnabled = (env) => {
+  const value = env.QSTASH_DEV;
+  return value === "true" || value === "1";
+};
 var getQStashHandlerOptions = (...params) => {
   const handlers = getQStashHandlers(...params);
   return {
@@ -3706,12 +3730,13 @@ 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 workflowContext = new WorkflowContext({
       qstashClient: regionalClient,
       workflowRunId,
-      initialPayload: initialPayloadParser(rawInitialPayload),
+      initialPayload: isThirdPartyCallResult(request) ? JSON.parse(rawInitialPayload) : initialPayloadParser(rawInitialPayload),
       headers: recreateUserHeaders(request.headers),
       steps,
       url: workflowUrl,
@@ -3719,6 +3744,7 @@ var serveBase = (routeFunction, telemetry2, options, internalOptions) => {
       telemetry: telemetry2,
       invokeCount,
       label,
+      retried,
       workflowRunCreatedAt: Number(workflowRunCreatedAt),
       middlewareManager
     });

package/cloudflare.mjs

@@ -2,7 +2,7 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-V5ZUHMAF.mjs";
+} from "./chunk-G24J5PCC.mjs";
 
 // platforms/cloudflare.ts
 var getArgs = (args) => {

package/express.d.mts

@@ -1,7 +1,7 @@
 import * as express_serve_static_core from 'express-serve-static-core';
-import { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B2S08hRU.mjs';
+import { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B_E1VAK6.mjs';
 import { Router } from 'express';
-import { s as serveManyBase } from './serve-many-C6sa_DxN.mjs';
+import { s as serveManyBase } from './serve-many-D3D9uE4u.mjs';
 import '@upstash/qstash';
 import 'zod';
 

package/express.d.ts

@@ -1,7 +1,7 @@
 import * as express_serve_static_core from 'express-serve-static-core';
-import { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B2S08hRU.js';
+import { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-B_E1VAK6.js';
 import { Router } from 'express';
-import { s as serveManyBase } from './serve-many-B-fe7bh7.js';
+import { s as serveManyBase } from './serve-many-kPOasiyb.js';
 import '@upstash/qstash';
 import 'zod';