@upstash/workflow 1.3.3 → 1.4.0

package/index.d.ts

@@ -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 };

package/index.js

@@ -33,6 +33,9 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/serve/index.ts
+var import_qstash12 = require("@upstash/qstash");
+
 // src/client/utils.ts
 var import_qstash2 = require("@upstash/qstash");
 
@@ -868,6 +871,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,
@@ -971,7 +978,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.`
@@ -1048,6 +1058,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({
@@ -1065,6 +1076,7 @@ ${atob(callbackMessage.body ?? "")}`
         workflowConfig: {
           workflowRunId,
           workflowUrl,
+          workflowRunCreatedAt: Number(workflowRunCreatedAt ?? "0"),
           telemetry
         },
         invokeCount: Number(invokeCount)
@@ -1212,6 +1224,7 @@ var BaseLazyStep = class _BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         useJSONContent: false,
         telemetry
       },
@@ -1539,6 +1552,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"]
@@ -1641,6 +1656,7 @@ var LazyInvokeStep = class extends BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         telemetry,
         useJSONContent: false
       },
@@ -1650,6 +1666,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(
@@ -1678,6 +1697,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,
@@ -1842,6 +1864,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;
     }
@@ -2001,6 +2026,7 @@ var submitParallelSteps = async ({
         workflowConfig: {
           workflowRunId: context.workflowRunId,
           workflowUrl: context.url,
+          workflowRunCreatedAt: context.workflowRunCreatedAt,
           telemetry
         },
         invokeCount
@@ -3435,7 +3461,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 };
@@ -3485,7 +3517,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)
       }
@@ -3824,7 +3858,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,
@@ -3837,7 +3872,7 @@ var serveBase = (routeFunction, telemetry, options, internalOptions) => {
       invokeCount,
       label,
       retried,
-      workflowRunCreatedAt: Number(workflowRunCreatedAt),
+      workflowRunCreatedAt,
       middlewareManager
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
@@ -3959,6 +3994,7 @@ var serveBase = (routeFunction, telemetry, options, internalOptions) => {
   return { handler: safeHandler };
 };
 var serve = (routeFunction, options) => {
+  void (0, import_qstash12.startDevServer)();
   return serveBase(
     routeFunction,
     {
@@ -3970,9 +4006,10 @@ var serve = (routeFunction, options) => {
 };
 
 // src/client/index.ts
-var import_qstash12 = require("@upstash/qstash");
+var import_qstash14 = require("@upstash/qstash");
 
 // src/client/dlq.ts
+var import_qstash13 = require("@upstash/qstash");
 function buildResumeRestartHeaders(options) {
   const headers = {};
   if (options?.flowControl) {
@@ -4090,6 +4127,27 @@ var DLQ = class {
     });
     return response;
   }
+  /**
+   * 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
+   */
+  async cancelFailureFunction({ dlqId }) {
+    assertNonEmptyId(dlqId, "DLQ id");
+    try {
+      await this.client.http.request({
+        path: ["v2", "workflows", "dlq", "callback", dlqId],
+        method: "DELETE",
+        parseResponseAsJson: false
+      });
+    } catch (error) {
+      if (isInstanceOf(error, import_qstash13.QstashError) && error.status === 302) return;
+      throw error;
+    }
+  }
   /**
    * Delete DLQ messages.
    *
@@ -4131,7 +4189,7 @@ var DLQ = class {
 var Client4 = class {
   client;
   constructor(clientConfig) {
-    this.client = new import_qstash12.Client(clientConfig);
+    this.client = new import_qstash14.Client(clientConfig);
   }
   async cancel(request) {
     if (typeof request === "object" && !Array.isArray(request) && ("ids" in request || "urlStartingWith" in request)) {

package/index.mjs

@@ -11,6 +11,7 @@ import {
   assertNonEmptyId,
   buildBulkActionQueryParameters,
   getWorkflowRunId,
+  isInstanceOf,
   loggingMiddleware,
   makeGetWaitersRequest,
   makeNotifyRequest,
@@ -22,12 +23,13 @@ import {
   triggerFirstInvocation,
   validateFlowControl,
   validateLabel
-} from "./chunk-WEQGCISK.mjs";
+} from "./chunk-DRHEHWMS.mjs";
 
 // src/client/index.ts
-import { Client as QStashClient } from "@upstash/qstash";
+import { Client as QStashClient2 } from "@upstash/qstash";
 
 // src/client/dlq.ts
+import { QstashError } from "@upstash/qstash";
 function buildResumeRestartHeaders(options) {
   const headers = {};
   if (options?.flowControl) {
@@ -145,6 +147,27 @@ var DLQ = class {
     });
     return response;
   }
+  /**
+   * 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
+   */
+  async cancelFailureFunction({ dlqId }) {
+    assertNonEmptyId(dlqId, "DLQ id");
+    try {
+      await this.client.http.request({
+        path: ["v2", "workflows", "dlq", "callback", dlqId],
+        method: "DELETE",
+        parseResponseAsJson: false
+      });
+    } catch (error) {
+      if (isInstanceOf(error, QstashError) && error.status === 302) return;
+      throw error;
+    }
+  }
   /**
    * Delete DLQ messages.
    *
@@ -186,7 +209,7 @@ var DLQ = class {
 var Client = class {
   client;
   constructor(clientConfig) {
-    this.client = new QStashClient(clientConfig);
+    this.client = new QStashClient2(clientConfig);
   }
   async cancel(request) {
     if (typeof request === "object" && !Array.isArray(request) && ("ids" in request || "urlStartingWith" in request)) {

package/nextjs.js

@@ -29,6 +29,9 @@ __export(nextjs_exports, {
 });
 module.exports = __toCommonJS(nextjs_exports);
 
+// src/serve/index.ts
+var import_qstash12 = require("@upstash/qstash");
+
 // src/client/utils.ts
 var import_qstash2 = require("@upstash/qstash");
 
@@ -784,6 +787,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,
@@ -887,7 +894,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.`
@@ -964,6 +974,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({
@@ -981,6 +992,7 @@ ${atob(callbackMessage.body ?? "")}`
         workflowConfig: {
           workflowRunId,
           workflowUrl,
+          workflowRunCreatedAt: Number(workflowRunCreatedAt ?? "0"),
           telemetry
         },
         invokeCount: Number(invokeCount)
@@ -1128,6 +1140,7 @@ var BaseLazyStep = class _BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         useJSONContent: false,
         telemetry
       },
@@ -1455,6 +1468,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"]
@@ -1557,6 +1572,7 @@ var LazyInvokeStep = class extends BaseLazyStep {
       workflowConfig: {
         workflowRunId: context.workflowRunId,
         workflowUrl: context.url,
+        workflowRunCreatedAt: context.workflowRunCreatedAt,
         telemetry,
         useJSONContent: false
       },
@@ -1566,6 +1582,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(
@@ -1594,6 +1613,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,
@@ -1758,6 +1780,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;
     }
@@ -1917,6 +1942,7 @@ var submitParallelSteps = async ({
         workflowConfig: {
           workflowRunId: context.workflowRunId,
           workflowUrl: context.url,
+          workflowRunCreatedAt: context.workflowRunCreatedAt,
           telemetry
         },
         invokeCount
@@ -3418,7 +3444,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 };
@@ -3468,7 +3500,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)
       }
@@ -3807,7 +3841,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,
@@ -3820,7 +3855,7 @@ var serveBase = (routeFunction, telemetry, options, internalOptions) => {
       invokeCount,
       label,
       retried,
-      workflowRunCreatedAt: Number(workflowRunCreatedAt),
+      workflowRunCreatedAt,
       middlewareManager
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
@@ -3943,6 +3978,7 @@ var serveBase = (routeFunction, telemetry, options, internalOptions) => {
 };
 
 // platforms/nextjs.ts
+var import_qstash13 = require("@upstash/qstash");
 var appTelemetry = {
   sdk: SDK_TELEMETRY,
   framework: "nextjs",
@@ -3954,6 +3990,7 @@ var pagesTelemetry = {
   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: serveHandler } = serveBase(
     routeFunction,
     appTelemetry,
@@ -3986,6 +4023,7 @@ var serveMany = (workflows, options) => {
   };
 };
 var servePagesRouter = (routeFunction, options) => {
+  void (0, import_qstash13.startDevServer)();
   const { handler: serveHandler } = serveBase(routeFunction, pagesTelemetry, options, void 0);
   const handler = async (request_, res) => {
     if (request_.method?.toUpperCase() !== "POST") {

package/nextjs.mjs

@@ -2,9 +2,10 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-WEQGCISK.mjs";
+} from "./chunk-DRHEHWMS.mjs";
 
 // platforms/nextjs.ts
+import { startDevServer } from "@upstash/qstash";
 var appTelemetry = {
   sdk: SDK_TELEMETRY,
   framework: "nextjs",
@@ -16,6 +17,7 @@ var pagesTelemetry = {
   runtime: process.versions.bun ? `bun@${process.versions.bun}/node@${process.version}` : `node@${process.version}`
 };
 var serve = (routeFunction, options) => {
+  void startDevServer();
   const { handler: serveHandler } = serveBase(
     routeFunction,
     appTelemetry,
@@ -48,6 +50,7 @@ var serveMany = (workflows, options) => {
   };
 };
 var servePagesRouter = (routeFunction, options) => {
+  void startDevServer();
   const { handler: serveHandler } = serveBase(routeFunction, pagesTelemetry, options, void 0);
   const handler = async (request_, res) => {
     if (request_.method?.toUpperCase() !== "POST") {

package/package.json

@@ -1 +1 @@
-{"name":"@upstash/workflow","version":"1.3.3","description":"Durable, Reliable and Performant Serverless Functions","main":"./index.js","module":"./index.mjs","types":"./index.d.ts","files":["./*"],"exports":{".":{"import":"./index.mjs","require":"./index.js"},"./dist/nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./h3":{"import":"./h3.mjs","require":"./h3.js"},"./svelte":{"import":"./svelte.mjs","require":"./svelte.js"},"./solidjs":{"import":"./solidjs.mjs","require":"./solidjs.js"},"./workflow":{"import":"./workflow.mjs","require":"./workflow.js"},"./hono":{"import":"./hono.mjs","require":"./hono.js"},"./cloudflare":{"import":"./cloudflare.mjs","require":"./cloudflare.js"},"./astro":{"import":"./astro.mjs","require":"./astro.js"},"./express":{"import":"./express.mjs","require":"./express.js"},"./tanstack":{"import":"./tanstack.mjs","require":"./tanstack.js"},"./react-router":{"import":"./react-router.mjs","require":"./react-router.js"}},"scripts":{"build":"tsup && cp README.md ./dist/ && cp package.json ./dist/ && cp LICENSE ./dist/","test":"bun test src","fmt":"prettier --write .","lint":"tsc && eslint \"{src,platforms}/**/*.{js,ts,tsx}\" --quiet --fix","check-exports":"bun run build && cd dist && attw -P"},"repository":{"type":"git","url":"git@github.com:upstash/workflow-js.git"},"keywords":["upstash","qstash","workflow","serverless"],"author":"Cahid Arda Oz","license":"MIT","bugs":{"url":"https://github.com/upstash/workflow-ts/issues"},"homepage":"https://github.com/upstash/workflow-ts#readme","devDependencies":{"@commitlint/cli":"^19.5.0","@commitlint/config-conventional":"^19.5.0","@eslint/js":"^9.11.1","@solidjs/start":"^1.0.8","@sveltejs/kit":"^2.6.1","@types/bun":"^1.1.10","@types/express":"^5.0.6","astro":"^4.16.7","eslint":"^9.11.1","eslint-plugin-unicorn":"^55.0.0","express":"^5.1.0","globals":"^15.10.0","h3":"^1.12.0","hono":"^4.6.20","husky":"^9.1.6","next":"^14.2.14","prettier":"3.3.3","tsup":"^8.3.0","typescript":"^5.7.2","typescript-eslint":"^8.18.0"},"dependencies":{"@upstash/qstash":"^2.11.0"},"directories":{"example":"examples"},"peerDependencies":{"zod":"^3.25.0 || ^4.0.0"}}
+{"name":"@upstash/workflow","version":"1.4.0","description":"Durable, Reliable and Performant Serverless Functions","main":"./index.js","module":"./index.mjs","types":"./index.d.ts","files":["./*"],"exports":{".":{"import":"./index.mjs","require":"./index.js"},"./dist/nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./h3":{"import":"./h3.mjs","require":"./h3.js"},"./svelte":{"import":"./svelte.mjs","require":"./svelte.js"},"./solidjs":{"import":"./solidjs.mjs","require":"./solidjs.js"},"./workflow":{"import":"./workflow.mjs","require":"./workflow.js"},"./hono":{"import":"./hono.mjs","require":"./hono.js"},"./cloudflare":{"import":"./cloudflare.mjs","require":"./cloudflare.js"},"./astro":{"import":"./astro.mjs","require":"./astro.js"},"./express":{"import":"./express.mjs","require":"./express.js"},"./tanstack":{"import":"./tanstack.mjs","require":"./tanstack.js"},"./react-router":{"import":"./react-router.mjs","require":"./react-router.js"}},"scripts":{"build":"tsup && cp README.md ./dist/ && cp package.json ./dist/ && cp LICENSE ./dist/","test":"bun test src","fmt":"prettier --write .","lint":"tsc && eslint \"{src,platforms}/**/*.{js,ts,tsx}\" --quiet --fix","check-exports":"bun run build && cd dist && attw -P"},"repository":{"type":"git","url":"git@github.com:upstash/workflow-js.git"},"keywords":["upstash","qstash","workflow","serverless"],"author":"Cahid Arda Oz","license":"MIT","bugs":{"url":"https://github.com/upstash/workflow-ts/issues"},"homepage":"https://github.com/upstash/workflow-ts#readme","devDependencies":{"@commitlint/cli":"^19.5.0","@commitlint/config-conventional":"^19.5.0","@eslint/js":"^9.11.1","@solidjs/start":"^1.0.8","@sveltejs/kit":"^2.6.1","@types/bun":"^1.1.10","@types/express":"^5.0.6","astro":"^4.16.7","eslint":"^9.11.1","eslint-plugin-unicorn":"^55.0.0","express":"^5.1.0","globals":"^15.10.0","h3":"^1.12.0","hono":"^4.6.20","husky":"^9.1.6","next":"^14.2.14","prettier":"3.3.3","tsup":"^8.3.0","typescript":"^5.7.2","typescript-eslint":"^8.18.0"},"dependencies":{"@upstash/qstash":"^2.11.3"},"directories":{"example":"examples"},"peerDependencies":{"zod":"^3.25.0 || ^4.0.0"}}