@upstash/workflow 1.3.0 → 1.3.1

package/nextjs.js

@@ -219,6 +219,31 @@ var import_qstash4 = require("@upstash/qstash");
 // src/utils.ts
 var NANOID_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_";
 var NANOID_LENGTH = 21;
+var RESOURCE_NAME_PATTERN = /^[a-zA-Z0-9\-_.]+$/;
+function validateLabel(label) {
+  if (label === void 0) return;
+  const labels = Array.isArray(label) ? label : [label];
+  if (labels.length === 0) {
+    throw new WorkflowNonRetryableError("Invalid label: label array must not be empty.");
+  }
+  for (const value of labels) {
+    if (!RESOURCE_NAME_PATTERN.test(value)) {
+      throw new WorkflowNonRetryableError(
+        `Invalid label "${value}": must be alphanumeric, hyphen, underscore, or period.`
+      );
+    }
+  }
+}
+function serializeLabel(label) {
+  return Array.isArray(label) ? label.join(",") : label;
+}
+function validateFlowControl(flowControl) {
+  if (flowControl?.key !== void 0 && !RESOURCE_NAME_PATTERN.test(flowControl.key)) {
+    throw new WorkflowNonRetryableError(
+      `Invalid flow control key "${flowControl.key}": must be alphanumeric, hyphen, underscore, or period.`
+    );
+  }
+}
 function getRandomInt() {
   return Math.floor(Math.random() * NANOID_CHARS.length);
 }
@@ -754,8 +779,8 @@ var triggerFirstInvocation = async (params) => {
       if (unknownSdk) {
         headers[WORKFLOW_UNKOWN_SDK_TRIGGER_HEADER] = "true";
       }
-      if (workflowContext.label) {
-        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      if (workflowContext.labels.length > 0) {
+        headers[WORKFLOW_LABEL_HEADER] = serializeLabel(workflowContext.labels);
       }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
@@ -1557,8 +1582,9 @@ var LazyInvokeStep = class extends BaseLazyStep {
     });
     triggerHeaders["Upstash-Workflow-Invoke"] = "true";
     if (label) {
-      triggerHeaders[WORKFLOW_LABEL_HEADER] = label;
-      triggerHeaders[`upstash-forward-${WORKFLOW_LABEL_HEADER}`] = label;
+      const labelHeader = serializeLabel(label);
+      triggerHeaders[WORKFLOW_LABEL_HEADER] = labelHeader;
+      triggerHeaders[`upstash-forward-${WORKFLOW_LABEL_HEADER}`] = labelHeader;
     }
     return { headers: triggerHeaders, contentType };
   }
@@ -2699,9 +2725,10 @@ var WorkflowContext = class {
    */
   env;
   /**
-   * Label to apply to the workflow run.
+   * Labels attached to the workflow run.
    *
-   * Can be used to filter the workflow run logs.
+   * Can be used to filter the workflow run logs. A run can have multiple
+   * labels when triggered with `label: string[]`.
    *
    * Can be set by passing a `label` parameter when triggering the workflow
    * with `client.trigger`:
@@ -2709,11 +2736,20 @@ var WorkflowContext = class {
    * ```ts
    * await client.trigger({
    *   url: "https://workflow-endpoint.com",
-   *   label: "my-label"
+   *   label: ["label-1", "label-2"]
    * });
    * ```
    */
-  label;
+  labels;
+  /**
+   * Label of the workflow run.
+   *
+   * @deprecated Use `labels` instead. When a run has multiple labels, this
+   *   only returns the first one.
+   */
+  get label() {
+    return this.labels[0];
+  }
   /**
    * Number of times QStash has retried delivering the current request.
    *
@@ -2744,7 +2780,7 @@ var WorkflowContext = class {
     this.headers = headers;
     this.requestPayload = initialPayload;
     this.env = env ?? {};
-    this.label = label;
+    this.labels = label === void 0 ? [] : Array.isArray(label) ? label : label ? label.split(",") : [];
     this.retried = retried ?? 0;
     const middlewareManagerInstance = middlewareManager ?? new MiddlewareManager([]);
     middlewareManagerInstance.assignContext(this);
@@ -2825,8 +2861,10 @@ var WorkflowContext = class {
     await this.addStep(new LazySleepUntilStep(this, stepName, time));
   }
   async call(stepName, settings) {
+    validateFlowControl(settings.flowControl);
     let callStep;
     if ("workflow" in settings) {
+      validateLabel(settings.label);
       const url = getNewUrlFromWorkflowId(this.url, settings.workflow.workflowId);
       const stringBody = typeof settings.body === "string" ? settings.body : settings.body === void 0 ? void 0 : JSON.stringify(settings.body);
       callStep = new LazyCallStep({
@@ -2934,6 +2972,8 @@ var WorkflowContext = class {
     );
   }
   async invoke(stepName, settings) {
+    validateLabel(settings.label);
+    validateFlowControl(settings.flowControl);
     return await this.addStep(
       new LazyInvokeStep(this, stepName, settings)
     );
@@ -3019,7 +3059,7 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       url: context.url,
       initialPayload: context.requestPayload,
       env: context.env,
-      label: context.label,
+      label: context.labels,
       retried: context.retried
     });
     try {

package/nextjs.mjs

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

package/package.json

@@ -1 +1 @@
-{"name":"@upstash/workflow","version":"1.3.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.0"},"directories":{"example":"examples"},"peerDependencies":{"zod":"^3.25.0 || ^4.0.0"}}
+{"name":"@upstash/workflow","version":"1.3.1","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"}}

package/react-router.d.mts

@@ -1,5 +1,5 @@
-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 { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-CekOpKvz.mjs';
+import { s as serveManyBase } from './serve-many-CG3BFvO3.mjs';
 import '@upstash/qstash';
 import 'zod';
 

package/react-router.d.ts

@@ -1,5 +1,5 @@
-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 { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-CekOpKvz.js';
+import { s as serveManyBase } from './serve-many-iJF1IUXk.js';
 import '@upstash/qstash';
 import 'zod';
 

package/react-router.js

@@ -216,6 +216,31 @@ var import_qstash4 = require("@upstash/qstash");
 // src/utils.ts
 var NANOID_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_";
 var NANOID_LENGTH = 21;
+var RESOURCE_NAME_PATTERN = /^[a-zA-Z0-9\-_.]+$/;
+function validateLabel(label) {
+  if (label === void 0) return;
+  const labels = Array.isArray(label) ? label : [label];
+  if (labels.length === 0) {
+    throw new WorkflowNonRetryableError("Invalid label: label array must not be empty.");
+  }
+  for (const value of labels) {
+    if (!RESOURCE_NAME_PATTERN.test(value)) {
+      throw new WorkflowNonRetryableError(
+        `Invalid label "${value}": must be alphanumeric, hyphen, underscore, or period.`
+      );
+    }
+  }
+}
+function serializeLabel(label) {
+  return Array.isArray(label) ? label.join(",") : label;
+}
+function validateFlowControl(flowControl) {
+  if (flowControl?.key !== void 0 && !RESOURCE_NAME_PATTERN.test(flowControl.key)) {
+    throw new WorkflowNonRetryableError(
+      `Invalid flow control key "${flowControl.key}": must be alphanumeric, hyphen, underscore, or period.`
+    );
+  }
+}
 function getRandomInt() {
   return Math.floor(Math.random() * NANOID_CHARS.length);
 }
@@ -751,8 +776,8 @@ var triggerFirstInvocation = async (params) => {
       if (unknownSdk) {
         headers[WORKFLOW_UNKOWN_SDK_TRIGGER_HEADER] = "true";
       }
-      if (workflowContext.label) {
-        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      if (workflowContext.labels.length > 0) {
+        headers[WORKFLOW_LABEL_HEADER] = serializeLabel(workflowContext.labels);
       }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
@@ -1554,8 +1579,9 @@ var LazyInvokeStep = class extends BaseLazyStep {
     });
     triggerHeaders["Upstash-Workflow-Invoke"] = "true";
     if (label) {
-      triggerHeaders[WORKFLOW_LABEL_HEADER] = label;
-      triggerHeaders[`upstash-forward-${WORKFLOW_LABEL_HEADER}`] = label;
+      const labelHeader = serializeLabel(label);
+      triggerHeaders[WORKFLOW_LABEL_HEADER] = labelHeader;
+      triggerHeaders[`upstash-forward-${WORKFLOW_LABEL_HEADER}`] = labelHeader;
     }
     return { headers: triggerHeaders, contentType };
   }
@@ -2696,9 +2722,10 @@ var WorkflowContext = class {
    */
   env;
   /**
-   * Label to apply to the workflow run.
+   * Labels attached to the workflow run.
    *
-   * Can be used to filter the workflow run logs.
+   * Can be used to filter the workflow run logs. A run can have multiple
+   * labels when triggered with `label: string[]`.
    *
    * Can be set by passing a `label` parameter when triggering the workflow
    * with `client.trigger`:
@@ -2706,11 +2733,20 @@ var WorkflowContext = class {
    * ```ts
    * await client.trigger({
    *   url: "https://workflow-endpoint.com",
-   *   label: "my-label"
+   *   label: ["label-1", "label-2"]
    * });
    * ```
    */
-  label;
+  labels;
+  /**
+   * Label of the workflow run.
+   *
+   * @deprecated Use `labels` instead. When a run has multiple labels, this
+   *   only returns the first one.
+   */
+  get label() {
+    return this.labels[0];
+  }
   /**
    * Number of times QStash has retried delivering the current request.
    *
@@ -2741,7 +2777,7 @@ var WorkflowContext = class {
     this.headers = headers;
     this.requestPayload = initialPayload;
     this.env = env ?? {};
-    this.label = label;
+    this.labels = label === void 0 ? [] : Array.isArray(label) ? label : label ? label.split(",") : [];
     this.retried = retried ?? 0;
     const middlewareManagerInstance = middlewareManager ?? new MiddlewareManager([]);
     middlewareManagerInstance.assignContext(this);
@@ -2822,8 +2858,10 @@ var WorkflowContext = class {
     await this.addStep(new LazySleepUntilStep(this, stepName, time));
   }
   async call(stepName, settings) {
+    validateFlowControl(settings.flowControl);
     let callStep;
     if ("workflow" in settings) {
+      validateLabel(settings.label);
       const url = getNewUrlFromWorkflowId(this.url, settings.workflow.workflowId);
       const stringBody = typeof settings.body === "string" ? settings.body : settings.body === void 0 ? void 0 : JSON.stringify(settings.body);
       callStep = new LazyCallStep({
@@ -2931,6 +2969,8 @@ var WorkflowContext = class {
     );
   }
   async invoke(stepName, settings) {
+    validateLabel(settings.label);
+    validateFlowControl(settings.flowControl);
     return await this.addStep(
       new LazyInvokeStep(this, stepName, settings)
     );
@@ -3016,7 +3056,7 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       url: context.url,
       initialPayload: context.requestPayload,
       env: context.env,
-      label: context.label,
+      label: context.labels,
       retried: context.retried
     });
     try {

package/react-router.mjs

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

package/{serve-many-D3D9uE4u.d.mts → serve-many-CG3BFvO3.d.mts}

@@ -1,4 +1,4 @@
-import { d as WorkflowServeOptions, c as RouteFunction, I as InvokableWorkflow } from './types-B_E1VAK6.mjs';
+import { d as WorkflowServeOptions, c as RouteFunction, I as InvokableWorkflow } from './types-CekOpKvz.mjs';
 
 type OmitOptionsInServeMany<TOptions> = Omit<TOptions, "env" | "url" | "schema" | "initialPayloadParser">;
 declare const serveManyBase: <THandler extends (...params: any[]) => any, TOptions extends OmitOptionsInServeMany<WorkflowServeOptions> = OmitOptionsInServeMany<WorkflowServeOptions>, TServeParams extends [routeFunction: RouteFunction<any, any>, options: TOptions] = [routeFunction: RouteFunction<any, any>, options: TOptions]>({ workflows, getUrl, serveMethod, options, }: {

package/{serve-many-kPOasiyb.d.ts → serve-many-iJF1IUXk.d.ts}

@@ -1,4 +1,4 @@
-import { d as WorkflowServeOptions, c as RouteFunction, I as InvokableWorkflow } from './types-B_E1VAK6.js';
+import { d as WorkflowServeOptions, c as RouteFunction, I as InvokableWorkflow } from './types-CekOpKvz.js';
 
 type OmitOptionsInServeMany<TOptions> = Omit<TOptions, "env" | "url" | "schema" | "initialPayloadParser">;
 declare const serveManyBase: <THandler extends (...params: any[]) => any, TOptions extends OmitOptionsInServeMany<WorkflowServeOptions> = OmitOptionsInServeMany<WorkflowServeOptions>, TServeParams extends [routeFunction: RouteFunction<any, any>, options: TOptions] = [routeFunction: RouteFunction<any, any>, options: TOptions]>({ workflows, getUrl, serveMethod, options, }: {

package/solidjs.d.mts

@@ -1,5 +1,5 @@
 import { APIEvent } from '@solidjs/start/server';
-import { c as RouteFunction, d as WorkflowServeOptions } from './types-B_E1VAK6.mjs';
+import { c as RouteFunction, d as WorkflowServeOptions } from './types-CekOpKvz.mjs';
 import '@upstash/qstash';
 import 'zod';
 

package/solidjs.d.ts

@@ -1,5 +1,5 @@
 import { APIEvent } from '@solidjs/start/server';
-import { c as RouteFunction, d as WorkflowServeOptions } from './types-B_E1VAK6.js';
+import { c as RouteFunction, d as WorkflowServeOptions } from './types-CekOpKvz.js';
 import '@upstash/qstash';
 import 'zod';
 

package/solidjs.js

@@ -214,6 +214,31 @@ var import_qstash4 = require("@upstash/qstash");
 // src/utils.ts
 var NANOID_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_";
 var NANOID_LENGTH = 21;
+var RESOURCE_NAME_PATTERN = /^[a-zA-Z0-9\-_.]+$/;
+function validateLabel(label) {
+  if (label === void 0) return;
+  const labels = Array.isArray(label) ? label : [label];
+  if (labels.length === 0) {
+    throw new WorkflowNonRetryableError("Invalid label: label array must not be empty.");
+  }
+  for (const value of labels) {
+    if (!RESOURCE_NAME_PATTERN.test(value)) {
+      throw new WorkflowNonRetryableError(
+        `Invalid label "${value}": must be alphanumeric, hyphen, underscore, or period.`
+      );
+    }
+  }
+}
+function serializeLabel(label) {
+  return Array.isArray(label) ? label.join(",") : label;
+}
+function validateFlowControl(flowControl) {
+  if (flowControl?.key !== void 0 && !RESOURCE_NAME_PATTERN.test(flowControl.key)) {
+    throw new WorkflowNonRetryableError(
+      `Invalid flow control key "${flowControl.key}": must be alphanumeric, hyphen, underscore, or period.`
+    );
+  }
+}
 function getRandomInt() {
   return Math.floor(Math.random() * NANOID_CHARS.length);
 }
@@ -749,8 +774,8 @@ var triggerFirstInvocation = async (params) => {
       if (unknownSdk) {
         headers[WORKFLOW_UNKOWN_SDK_TRIGGER_HEADER] = "true";
       }
-      if (workflowContext.label) {
-        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      if (workflowContext.labels.length > 0) {
+        headers[WORKFLOW_LABEL_HEADER] = serializeLabel(workflowContext.labels);
       }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
@@ -1552,8 +1577,9 @@ var LazyInvokeStep = class extends BaseLazyStep {
     });
     triggerHeaders["Upstash-Workflow-Invoke"] = "true";
     if (label) {
-      triggerHeaders[WORKFLOW_LABEL_HEADER] = label;
-      triggerHeaders[`upstash-forward-${WORKFLOW_LABEL_HEADER}`] = label;
+      const labelHeader = serializeLabel(label);
+      triggerHeaders[WORKFLOW_LABEL_HEADER] = labelHeader;
+      triggerHeaders[`upstash-forward-${WORKFLOW_LABEL_HEADER}`] = labelHeader;
     }
     return { headers: triggerHeaders, contentType };
   }
@@ -2627,9 +2653,10 @@ var WorkflowContext = class {
    */
   env;
   /**
-   * Label to apply to the workflow run.
+   * Labels attached to the workflow run.
    *
-   * Can be used to filter the workflow run logs.
+   * Can be used to filter the workflow run logs. A run can have multiple
+   * labels when triggered with `label: string[]`.
    *
    * Can be set by passing a `label` parameter when triggering the workflow
    * with `client.trigger`:
@@ -2637,11 +2664,20 @@ var WorkflowContext = class {
    * ```ts
    * await client.trigger({
    *   url: "https://workflow-endpoint.com",
-   *   label: "my-label"
+   *   label: ["label-1", "label-2"]
    * });
    * ```
    */
-  label;
+  labels;
+  /**
+   * Label of the workflow run.
+   *
+   * @deprecated Use `labels` instead. When a run has multiple labels, this
+   *   only returns the first one.
+   */
+  get label() {
+    return this.labels[0];
+  }
   /**
    * Number of times QStash has retried delivering the current request.
    *
@@ -2672,7 +2708,7 @@ var WorkflowContext = class {
     this.headers = headers;
     this.requestPayload = initialPayload;
     this.env = env ?? {};
-    this.label = label;
+    this.labels = label === void 0 ? [] : Array.isArray(label) ? label : label ? label.split(",") : [];
     this.retried = retried ?? 0;
     const middlewareManagerInstance = middlewareManager ?? new MiddlewareManager([]);
     middlewareManagerInstance.assignContext(this);
@@ -2753,8 +2789,10 @@ var WorkflowContext = class {
     await this.addStep(new LazySleepUntilStep(this, stepName, time));
   }
   async call(stepName, settings) {
+    validateFlowControl(settings.flowControl);
     let callStep;
     if ("workflow" in settings) {
+      validateLabel(settings.label);
       const url = getNewUrlFromWorkflowId(this.url, settings.workflow.workflowId);
       const stringBody = typeof settings.body === "string" ? settings.body : settings.body === void 0 ? void 0 : JSON.stringify(settings.body);
       callStep = new LazyCallStep({
@@ -2862,6 +2900,8 @@ var WorkflowContext = class {
     );
   }
   async invoke(stepName, settings) {
+    validateLabel(settings.label);
+    validateFlowControl(settings.flowControl);
     return await this.addStep(
       new LazyInvokeStep(this, stepName, settings)
     );
@@ -2947,7 +2987,7 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       url: context.url,
       initialPayload: context.requestPayload,
       env: context.env,
-      label: context.label,
+      label: context.labels,
       retried: context.retried
     });
     try {

package/solidjs.mjs

@@ -1,7 +1,7 @@
 import {
   SDK_TELEMETRY,
   serveBase
-} from "./chunk-G24J5PCC.mjs";
+} from "./chunk-CWCCIOXR.mjs";
 
 // platforms/solidjs.ts
 var serve = (routeFunction, options) => {

package/svelte.d.mts

@@ -1,7 +1,7 @@
 import * as _sveltejs_kit from '@sveltejs/kit';
 import { RequestHandler } from '@sveltejs/kit';
-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 { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-CekOpKvz.mjs';
+import { s as serveManyBase } from './serve-many-CG3BFvO3.mjs';
 import '@upstash/qstash';
 import 'zod';
 

package/svelte.d.ts

@@ -1,7 +1,7 @@
 import * as _sveltejs_kit from '@sveltejs/kit';
 import { RequestHandler } from '@sveltejs/kit';
-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 { c as RouteFunction, d as WorkflowServeOptions, I as InvokableWorkflow } from './types-CekOpKvz.js';
+import { s as serveManyBase } from './serve-many-iJF1IUXk.js';
 import '@upstash/qstash';
 import 'zod';
 

package/svelte.js

@@ -216,6 +216,31 @@ var import_qstash4 = require("@upstash/qstash");
 // src/utils.ts
 var NANOID_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_";
 var NANOID_LENGTH = 21;
+var RESOURCE_NAME_PATTERN = /^[a-zA-Z0-9\-_.]+$/;
+function validateLabel(label) {
+  if (label === void 0) return;
+  const labels = Array.isArray(label) ? label : [label];
+  if (labels.length === 0) {
+    throw new WorkflowNonRetryableError("Invalid label: label array must not be empty.");
+  }
+  for (const value of labels) {
+    if (!RESOURCE_NAME_PATTERN.test(value)) {
+      throw new WorkflowNonRetryableError(
+        `Invalid label "${value}": must be alphanumeric, hyphen, underscore, or period.`
+      );
+    }
+  }
+}
+function serializeLabel(label) {
+  return Array.isArray(label) ? label.join(",") : label;
+}
+function validateFlowControl(flowControl) {
+  if (flowControl?.key !== void 0 && !RESOURCE_NAME_PATTERN.test(flowControl.key)) {
+    throw new WorkflowNonRetryableError(
+      `Invalid flow control key "${flowControl.key}": must be alphanumeric, hyphen, underscore, or period.`
+    );
+  }
+}
 function getRandomInt() {
   return Math.floor(Math.random() * NANOID_CHARS.length);
 }
@@ -751,8 +776,8 @@ var triggerFirstInvocation = async (params) => {
       if (unknownSdk) {
         headers[WORKFLOW_UNKOWN_SDK_TRIGGER_HEADER] = "true";
       }
-      if (workflowContext.label) {
-        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      if (workflowContext.labels.length > 0) {
+        headers[WORKFLOW_LABEL_HEADER] = serializeLabel(workflowContext.labels);
       }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
@@ -1554,8 +1579,9 @@ var LazyInvokeStep = class extends BaseLazyStep {
     });
     triggerHeaders["Upstash-Workflow-Invoke"] = "true";
     if (label) {
-      triggerHeaders[WORKFLOW_LABEL_HEADER] = label;
-      triggerHeaders[`upstash-forward-${WORKFLOW_LABEL_HEADER}`] = label;
+      const labelHeader = serializeLabel(label);
+      triggerHeaders[WORKFLOW_LABEL_HEADER] = labelHeader;
+      triggerHeaders[`upstash-forward-${WORKFLOW_LABEL_HEADER}`] = labelHeader;
     }
     return { headers: triggerHeaders, contentType };
   }
@@ -2696,9 +2722,10 @@ var WorkflowContext = class {
    */
   env;
   /**
-   * Label to apply to the workflow run.
+   * Labels attached to the workflow run.
    *
-   * Can be used to filter the workflow run logs.
+   * Can be used to filter the workflow run logs. A run can have multiple
+   * labels when triggered with `label: string[]`.
    *
    * Can be set by passing a `label` parameter when triggering the workflow
    * with `client.trigger`:
@@ -2706,11 +2733,20 @@ var WorkflowContext = class {
    * ```ts
    * await client.trigger({
    *   url: "https://workflow-endpoint.com",
-   *   label: "my-label"
+   *   label: ["label-1", "label-2"]
    * });
    * ```
    */
-  label;
+  labels;
+  /**
+   * Label of the workflow run.
+   *
+   * @deprecated Use `labels` instead. When a run has multiple labels, this
+   *   only returns the first one.
+   */
+  get label() {
+    return this.labels[0];
+  }
   /**
    * Number of times QStash has retried delivering the current request.
    *
@@ -2741,7 +2777,7 @@ var WorkflowContext = class {
     this.headers = headers;
     this.requestPayload = initialPayload;
     this.env = env ?? {};
-    this.label = label;
+    this.labels = label === void 0 ? [] : Array.isArray(label) ? label : label ? label.split(",") : [];
     this.retried = retried ?? 0;
     const middlewareManagerInstance = middlewareManager ?? new MiddlewareManager([]);
     middlewareManagerInstance.assignContext(this);
@@ -2822,8 +2858,10 @@ var WorkflowContext = class {
     await this.addStep(new LazySleepUntilStep(this, stepName, time));
   }
   async call(stepName, settings) {
+    validateFlowControl(settings.flowControl);
     let callStep;
     if ("workflow" in settings) {
+      validateLabel(settings.label);
       const url = getNewUrlFromWorkflowId(this.url, settings.workflow.workflowId);
       const stringBody = typeof settings.body === "string" ? settings.body : settings.body === void 0 ? void 0 : JSON.stringify(settings.body);
       callStep = new LazyCallStep({
@@ -2931,6 +2969,8 @@ var WorkflowContext = class {
     );
   }
   async invoke(stepName, settings) {
+    validateLabel(settings.label);
+    validateFlowControl(settings.flowControl);
     return await this.addStep(
       new LazyInvokeStep(this, stepName, settings)
     );
@@ -3016,7 +3056,7 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       url: context.url,
       initialPayload: context.requestPayload,
       env: context.env,
-      label: context.label,
+      label: context.labels,
       retried: context.retried
     });
     try {

package/svelte.mjs

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

package/tanstack.d.mts

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

package/tanstack.d.ts

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