@upstash/workflow 0.2.17 → 0.2.18

package/astro.d.mts

@@ -1,6 +1,6 @@
 import { APIContext, APIRoute } from 'astro';
-import { g as WorkflowContext, n as PublicServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.mjs';
-import { s as serveManyBase } from './serve-many-DgDSOvQs.mjs';
+import { g as WorkflowContext, n as PublicServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.mjs';
+import { s as serveManyBase } from './serve-many-CEUYWQvV.mjs';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/astro.d.ts

@@ -1,6 +1,6 @@
 import { APIContext, APIRoute } from 'astro';
-import { g as WorkflowContext, n as PublicServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.js';
-import { s as serveManyBase } from './serve-many-B3DfoTFt.js';
+import { g as WorkflowContext, n as PublicServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.js';
+import { s as serveManyBase } from './serve-many-BObe3pdI.js';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/astro.js

@@ -86,12 +86,13 @@ var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
 var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_PROTOCOL_VERSION = "1";
 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 = "v0.2.17";
+var VERSION = "v0.2.18";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -635,6 +636,9 @@ var triggerFirstInvocation = async (params) => {
       if (useJSONContent) {
         headers["content-type"] = "application/json";
       }
+      if (workflowContext.label) {
+        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
         headers,
@@ -735,10 +739,11 @@ var recreateUserHeaders = (headers) => {
   const pairs = headers.entries();
   for (const [header, value] of pairs) {
     const headerLowerCase = header.toLowerCase();
-    if (!headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
+    const isUserHeader = !headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
     !headerLowerCase.startsWith("x-vercel-") && !headerLowerCase.startsWith("x-forwarded-") && // https://blog.cloudflare.com/preventing-request-loops-using-cdn-loop/
     headerLowerCase !== "cf-connecting-ip" && headerLowerCase !== "cdn-loop" && headerLowerCase !== "cf-ew-via" && headerLowerCase !== "cf-ray" && // For Render https://render.com
-    headerLowerCase !== "render-proxy-ttl") {
+    headerLowerCase !== "render-proxy-ttl" || headerLowerCase === WORKFLOW_LABEL_HEADER.toLocaleLowerCase();
+    if (isUserHeader) {
       filteredHeaders.append(header, value);
     }
   }
@@ -2768,6 +2773,22 @@ var WorkflowContext = class {
    * and number of requests per second with the same key.
    */
   flowControl;
+  /**
+   * Label to apply to the workflow run.
+   *
+   * Can be used to filter the workflow run logs.
+   *
+   * Can be set by passing a `label` parameter when triggering the workflow
+   * with `client.trigger`:
+   *
+   * ```ts
+   * await client.trigger({
+   *   url: "https://workflow-endpoint.com",
+   *   label: "my-label"
+   * });
+   * ```
+   */
+  label;
   constructor({
     qstashClient,
     workflowRunId,
@@ -2782,7 +2803,8 @@ var WorkflowContext = class {
     retryDelay,
     telemetry: telemetry2,
     invokeCount,
-    flowControl
+    flowControl,
+    label
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -2795,6 +2817,7 @@ var WorkflowContext = class {
     this.retries = retries ?? DEFAULT_RETRIES;
     this.retryDelay = retryDelay;
     this.flowControl = flowControl;
+    this.label = label;
     this.executor = new AutoExecutor(this, this.steps, telemetry2, invokeCount, debug);
   }
   /**
@@ -3095,7 +3118,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       env: context.env,
       retries: context.retries,
       retryDelay: context.retryDelay,
-      flowControl: context.flowControl
+      flowControl: context.flowControl,
+      label: context.label
     });
     try {
       await routeFunction(disabledContext);
@@ -3272,11 +3296,12 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
     if (!errorMessage) {
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
+    const userHeaders = recreateUserHeaders(request.headers);
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
       initialPayload: sourceBody ? initialPayloadParser(decodeBase64(sourceBody)) : void 0,
-      headers: recreateUserHeaders(request.headers),
+      headers: userHeaders,
       steps: [],
       url,
       failureUrl: url,
@@ -3285,8 +3310,9 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
       retries,
       retryDelay,
       flowControl,
-      telemetry: void 0
+      telemetry: void 0,
       // not going to make requests in authentication check
+      label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -3495,6 +3521,7 @@ var serveBase = (routeFunction, telemetry2, options) => {
       });
     }
     const invokeCount = Number(request.headers.get(WORKFLOW_INVOKE_COUNT_HEADER) ?? "0");
+    const label = request.headers.get(WORKFLOW_LABEL_HEADER) ?? void 0;
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -3509,7 +3536,8 @@ var serveBase = (routeFunction, telemetry2, options) => {
       retryDelay,
       telemetry: telemetry2,
       invokeCount,
-      flowControl
+      flowControl,
+      label
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,

package/astro.mjs

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

package/{chunk-RP7G4UD5.mjs → chunk-EHL7SSJF.mjs}

@@ -37,12 +37,13 @@ var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
 var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_PROTOCOL_VERSION = "1";
 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 = "v0.2.17";
+var VERSION = "v0.2.18";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -852,6 +853,9 @@ var triggerFirstInvocation = async (params) => {
       if (useJSONContent) {
         headers["content-type"] = "application/json";
       }
+      if (workflowContext.label) {
+        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
         headers,
@@ -952,10 +956,11 @@ var recreateUserHeaders = (headers) => {
   const pairs = headers.entries();
   for (const [header, value] of pairs) {
     const headerLowerCase = header.toLowerCase();
-    if (!headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
+    const isUserHeader = !headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
     !headerLowerCase.startsWith("x-vercel-") && !headerLowerCase.startsWith("x-forwarded-") && // https://blog.cloudflare.com/preventing-request-loops-using-cdn-loop/
     headerLowerCase !== "cf-connecting-ip" && headerLowerCase !== "cdn-loop" && headerLowerCase !== "cf-ew-via" && headerLowerCase !== "cf-ray" && // For Render https://render.com
-    headerLowerCase !== "render-proxy-ttl") {
+    headerLowerCase !== "render-proxy-ttl" || headerLowerCase === WORKFLOW_LABEL_HEADER.toLocaleLowerCase();
+    if (isUserHeader) {
       filteredHeaders.append(header, value);
     }
   }
@@ -2812,6 +2817,22 @@ var WorkflowContext = class {
    * and number of requests per second with the same key.
    */
   flowControl;
+  /**
+   * Label to apply to the workflow run.
+   *
+   * Can be used to filter the workflow run logs.
+   *
+   * Can be set by passing a `label` parameter when triggering the workflow
+   * with `client.trigger`:
+   *
+   * ```ts
+   * await client.trigger({
+   *   url: "https://workflow-endpoint.com",
+   *   label: "my-label"
+   * });
+   * ```
+   */
+  label;
   constructor({
     qstashClient,
     workflowRunId,
@@ -2826,7 +2847,8 @@ var WorkflowContext = class {
     retryDelay,
     telemetry,
     invokeCount,
-    flowControl
+    flowControl,
+    label
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -2839,6 +2861,7 @@ var WorkflowContext = class {
     this.retries = retries ?? DEFAULT_RETRIES;
     this.retryDelay = retryDelay;
     this.flowControl = flowControl;
+    this.label = label;
     this.executor = new AutoExecutor(this, this.steps, telemetry, invokeCount, debug);
   }
   /**
@@ -3139,7 +3162,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       env: context.env,
       retries: context.retries,
       retryDelay: context.retryDelay,
-      flowControl: context.flowControl
+      flowControl: context.flowControl,
+      label: context.label
     });
     try {
       await routeFunction(disabledContext);
@@ -3316,11 +3340,12 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
     if (!errorMessage) {
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
+    const userHeaders = recreateUserHeaders(request.headers);
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
       initialPayload: sourceBody ? initialPayloadParser(decodeBase64(sourceBody)) : void 0,
-      headers: recreateUserHeaders(request.headers),
+      headers: userHeaders,
       steps: [],
       url,
       failureUrl: url,
@@ -3329,8 +3354,9 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
       retries,
       retryDelay,
       flowControl,
-      telemetry: void 0
+      telemetry: void 0,
       // not going to make requests in authentication check
+      label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -3539,6 +3565,7 @@ var serveBase = (routeFunction, telemetry, options) => {
       });
     }
     const invokeCount = Number(request.headers.get(WORKFLOW_INVOKE_COUNT_HEADER) ?? "0");
+    const label = request.headers.get(WORKFLOW_LABEL_HEADER) ?? void 0;
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -3553,7 +3580,8 @@ var serveBase = (routeFunction, telemetry, options) => {
       retryDelay,
       telemetry,
       invokeCount,
-      flowControl
+      flowControl,
+      label
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -3674,6 +3702,7 @@ export {
   __toESM,
   makeNotifyRequest,
   makeGetWaitersRequest,
+  WORKFLOW_LABEL_HEADER,
   SDK_TELEMETRY,
   WorkflowError,
   WorkflowAbort,

package/cloudflare.d.mts

@@ -1,5 +1,5 @@
-import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.mjs';
-import { s as serveManyBase } from './serve-many-DgDSOvQs.mjs';
+import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.mjs';
+import { s as serveManyBase } from './serve-many-CEUYWQvV.mjs';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/cloudflare.d.ts

@@ -1,5 +1,5 @@
-import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.js';
-import { s as serveManyBase } from './serve-many-B3DfoTFt.js';
+import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.js';
+import { s as serveManyBase } from './serve-many-BObe3pdI.js';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/cloudflare.js

@@ -33,12 +33,13 @@ var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
 var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_PROTOCOL_VERSION = "1";
 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 = "v0.2.17";
+var VERSION = "v0.2.18";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -635,6 +636,9 @@ var triggerFirstInvocation = async (params) => {
       if (useJSONContent) {
         headers["content-type"] = "application/json";
       }
+      if (workflowContext.label) {
+        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
         headers,
@@ -735,10 +739,11 @@ var recreateUserHeaders = (headers) => {
   const pairs = headers.entries();
   for (const [header, value] of pairs) {
     const headerLowerCase = header.toLowerCase();
-    if (!headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
+    const isUserHeader = !headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
     !headerLowerCase.startsWith("x-vercel-") && !headerLowerCase.startsWith("x-forwarded-") && // https://blog.cloudflare.com/preventing-request-loops-using-cdn-loop/
     headerLowerCase !== "cf-connecting-ip" && headerLowerCase !== "cdn-loop" && headerLowerCase !== "cf-ew-via" && headerLowerCase !== "cf-ray" && // For Render https://render.com
-    headerLowerCase !== "render-proxy-ttl") {
+    headerLowerCase !== "render-proxy-ttl" || headerLowerCase === WORKFLOW_LABEL_HEADER.toLocaleLowerCase();
+    if (isUserHeader) {
       filteredHeaders.append(header, value);
     }
   }
@@ -2768,6 +2773,22 @@ var WorkflowContext = class {
    * and number of requests per second with the same key.
    */
   flowControl;
+  /**
+   * Label to apply to the workflow run.
+   *
+   * Can be used to filter the workflow run logs.
+   *
+   * Can be set by passing a `label` parameter when triggering the workflow
+   * with `client.trigger`:
+   *
+   * ```ts
+   * await client.trigger({
+   *   url: "https://workflow-endpoint.com",
+   *   label: "my-label"
+   * });
+   * ```
+   */
+  label;
   constructor({
     qstashClient,
     workflowRunId,
@@ -2782,7 +2803,8 @@ var WorkflowContext = class {
     retryDelay,
     telemetry: telemetry2,
     invokeCount,
-    flowControl
+    flowControl,
+    label
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -2795,6 +2817,7 @@ var WorkflowContext = class {
     this.retries = retries ?? DEFAULT_RETRIES;
     this.retryDelay = retryDelay;
     this.flowControl = flowControl;
+    this.label = label;
     this.executor = new AutoExecutor(this, this.steps, telemetry2, invokeCount, debug);
   }
   /**
@@ -3095,7 +3118,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       env: context.env,
       retries: context.retries,
       retryDelay: context.retryDelay,
-      flowControl: context.flowControl
+      flowControl: context.flowControl,
+      label: context.label
     });
     try {
       await routeFunction(disabledContext);
@@ -3272,11 +3296,12 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
     if (!errorMessage) {
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
+    const userHeaders = recreateUserHeaders(request.headers);
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
       initialPayload: sourceBody ? initialPayloadParser(decodeBase64(sourceBody)) : void 0,
-      headers: recreateUserHeaders(request.headers),
+      headers: userHeaders,
       steps: [],
       url,
       failureUrl: url,
@@ -3285,8 +3310,9 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
       retries,
       retryDelay,
       flowControl,
-      telemetry: void 0
+      telemetry: void 0,
       // not going to make requests in authentication check
+      label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -3495,6 +3521,7 @@ var serveBase = (routeFunction, telemetry2, options) => {
       });
     }
     const invokeCount = Number(request.headers.get(WORKFLOW_INVOKE_COUNT_HEADER) ?? "0");
+    const label = request.headers.get(WORKFLOW_LABEL_HEADER) ?? void 0;
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -3509,7 +3536,8 @@ var serveBase = (routeFunction, telemetry2, options) => {
       retryDelay,
       telemetry: telemetry2,
       invokeCount,
-      flowControl
+      flowControl,
+      label
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,

package/cloudflare.mjs

@@ -2,7 +2,7 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-RP7G4UD5.mjs";
+} from "./chunk-EHL7SSJF.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 { R as RouteFunction, W as WorkflowServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.mjs';
+import { R as RouteFunction, W as WorkflowServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.mjs';
 import { Router } from 'express';
-import { s as serveManyBase } from './serve-many-DgDSOvQs.mjs';
+import { s as serveManyBase } from './serve-many-CEUYWQvV.mjs';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/express.d.ts

@@ -1,7 +1,7 @@
 import * as express_serve_static_core from 'express-serve-static-core';
-import { R as RouteFunction, W as WorkflowServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.js';
+import { R as RouteFunction, W as WorkflowServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.js';
 import { Router } from 'express';
-import { s as serveManyBase } from './serve-many-B3DfoTFt.js';
+import { s as serveManyBase } from './serve-many-BObe3pdI.js';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/express.js

@@ -23479,12 +23479,13 @@ var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
 var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_PROTOCOL_VERSION = "1";
 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 = "v0.2.17";
+var VERSION = "v0.2.18";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -24081,6 +24082,9 @@ var triggerFirstInvocation = async (params) => {
       if (useJSONContent) {
         headers["content-type"] = "application/json";
       }
+      if (workflowContext.label) {
+        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
         headers,
@@ -24181,10 +24185,11 @@ var recreateUserHeaders = (headers) => {
   const pairs = headers.entries();
   for (const [header, value] of pairs) {
     const headerLowerCase = header.toLowerCase();
-    if (!headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
+    const isUserHeader = !headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
     !headerLowerCase.startsWith("x-vercel-") && !headerLowerCase.startsWith("x-forwarded-") && // https://blog.cloudflare.com/preventing-request-loops-using-cdn-loop/
     headerLowerCase !== "cf-connecting-ip" && headerLowerCase !== "cdn-loop" && headerLowerCase !== "cf-ew-via" && headerLowerCase !== "cf-ray" && // For Render https://render.com
-    headerLowerCase !== "render-proxy-ttl") {
+    headerLowerCase !== "render-proxy-ttl" || headerLowerCase === WORKFLOW_LABEL_HEADER.toLocaleLowerCase();
+    if (isUserHeader) {
       filteredHeaders.append(header, value);
     }
   }
@@ -26214,6 +26219,22 @@ var WorkflowContext = class {
    * and number of requests per second with the same key.
    */
   flowControl;
+  /**
+   * Label to apply to the workflow run.
+   *
+   * Can be used to filter the workflow run logs.
+   *
+   * Can be set by passing a `label` parameter when triggering the workflow
+   * with `client.trigger`:
+   *
+   * ```ts
+   * await client.trigger({
+   *   url: "https://workflow-endpoint.com",
+   *   label: "my-label"
+   * });
+   * ```
+   */
+  label;
   constructor({
     qstashClient,
     workflowRunId,
@@ -26228,7 +26249,8 @@ var WorkflowContext = class {
     retryDelay,
     telemetry: telemetry2,
     invokeCount,
-    flowControl
+    flowControl,
+    label
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -26241,6 +26263,7 @@ var WorkflowContext = class {
     this.retries = retries ?? DEFAULT_RETRIES;
     this.retryDelay = retryDelay;
     this.flowControl = flowControl;
+    this.label = label;
     this.executor = new AutoExecutor(this, this.steps, telemetry2, invokeCount, debug);
   }
   /**
@@ -26541,7 +26564,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       env: context.env,
       retries: context.retries,
       retryDelay: context.retryDelay,
-      flowControl: context.flowControl
+      flowControl: context.flowControl,
+      label: context.label
     });
     try {
       await routeFunction(disabledContext);
@@ -26718,11 +26742,12 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
     if (!errorMessage) {
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
+    const userHeaders = recreateUserHeaders(request.headers);
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
       initialPayload: sourceBody ? initialPayloadParser(decodeBase64(sourceBody)) : void 0,
-      headers: recreateUserHeaders(request.headers),
+      headers: userHeaders,
       steps: [],
       url,
       failureUrl: url,
@@ -26731,8 +26756,9 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
       retries,
       retryDelay,
       flowControl,
-      telemetry: void 0
+      telemetry: void 0,
       // not going to make requests in authentication check
+      label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -26941,6 +26967,7 @@ var serveBase = (routeFunction, telemetry2, options) => {
       });
     }
     const invokeCount = Number(request.headers.get(WORKFLOW_INVOKE_COUNT_HEADER) ?? "0");
+    const label = request.headers.get(WORKFLOW_LABEL_HEADER) ?? void 0;
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -26955,7 +26982,8 @@ var serveBase = (routeFunction, telemetry2, options) => {
       retryDelay,
       telemetry: telemetry2,
       invokeCount,
-      flowControl
+      flowControl,
+      label
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,

package/express.mjs

@@ -5,7 +5,7 @@ import {
   __toESM,
   serveBase,
   serveManyBase
-} from "./chunk-RP7G4UD5.mjs";
+} from "./chunk-EHL7SSJF.mjs";
 
 // node_modules/depd/index.js
 var require_depd = __commonJS({

package/h3.d.mts

@@ -1,6 +1,6 @@
 import * as h3 from 'h3';
-import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.mjs';
-import { s as serveManyBase } from './serve-many-DgDSOvQs.mjs';
+import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.mjs';
+import { s as serveManyBase } from './serve-many-CEUYWQvV.mjs';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/h3.d.ts

@@ -1,6 +1,6 @@
 import * as h3 from 'h3';
-import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.js';
-import { s as serveManyBase } from './serve-many-B3DfoTFt.js';
+import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.js';
+import { s as serveManyBase } from './serve-many-BObe3pdI.js';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';