@upstash/workflow 1.2.1 → 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-THS5AX2D.mjs";
+} from "./chunk-G24J5PCC.mjs";
 
 // platforms/astro.ts
 var telemetry = {

package/{chunk-THS5AX2D.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";
@@ -967,6 +968,9 @@ var recreateUserHeaders = (headers) => {
   }
   return filteredHeaders;
 };
+var isThirdPartyCallResult = (request) => {
+  return request.headers.get("Upstash-Workflow-Callback") !== null;
+};
 var handleThirdPartyCallResult = async ({
   request,
   requestPayload,
@@ -976,7 +980,7 @@ var handleThirdPartyCallResult = async ({
   middlewareManager
 }) => {
   try {
-    if (request.headers.get("Upstash-Workflow-Callback")) {
+    if (isThirdPartyCallResult(request)) {
       let callbackPayload;
       if (requestPayload) {
         callbackPayload = requestPayload;
@@ -2744,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,
@@ -2756,6 +2767,7 @@ var WorkflowContext = class {
     telemetry,
     invokeCount,
     label,
+    retried,
     middlewareManager
   }) {
     this.qstashClient = qstashClient;
@@ -2767,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(
@@ -3104,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,
@@ -3113,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);
@@ -3329,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,
@@ -3340,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
     });
@@ -3499,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,
@@ -3508,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 {
@@ -3743,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,
@@ -3756,6 +3781,7 @@ var serveBase = (routeFunction, telemetry, options, internalOptions) => {
       telemetry,
       invokeCount,
       label,
+      retried,
       workflowRunCreatedAt: Number(workflowRunCreatedAt),
       middlewareManager
     });

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-THS5AX2D.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';
 

package/express.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/express.mjs

@@ -2,7 +2,7 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-THS5AX2D.mjs";
+} from "./chunk-G24J5PCC.mjs";
 
 // platforms/express.ts
 import {