@upstash/workflow 1.3.2 → 1.3.3

package/astro.js

@@ -142,8 +142,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/astro.mjs

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

package/{chunk-ICDNN4UW.mjs → chunk-WEQGCISK.mjs}

@@ -232,8 +232,20 @@ import { QstashError as QstashError4 } from "@upstash/qstash";
 
 // src/client/utils.ts
 import { QstashError as QstashError2 } from "@upstash/qstash";
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new QstashError2(`${label} cannot be empty`);
+  }
+};
+var toNonEmptyIdArray = (request, label = "id") => {
+  const ids = typeof request === "string" ? [request] : request;
+  for (const id of ids) assertNonEmptyId(id, label);
+  return ids;
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",
@@ -242,6 +254,7 @@ var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) =>
   return result;
 };
 var makeGetWaitersRequest = async (requester, eventId) => {
+  assertNonEmptyId(eventId, "Event id");
   const result = await requester.request({
     path: ["v2", "waiters", eventId],
     method: "GET"
@@ -328,6 +341,13 @@ function buildBulkActionQueryParameters(request, options) {
       "No filter provided. Use { filter: { ... } } with at least one filter field, or { all: true }."
     );
   }
+  for (const [field, value] of Object.entries(filter)) {
+    if (Array.isArray(value) && value.length === 0) {
+      throw new QstashError2(
+        `Empty array provided for filter field '${field}'. If you intend to target all records, use { all: true } explicitly.`
+      );
+    }
+  }
   if (options?.translateWorkflowUrl) {
     const { workflowUrlStartingWith, workflowUrl, ...rest } = filter;
     if (workflowUrlStartingWith && workflowUrl) {
@@ -3984,6 +4004,8 @@ export {
   WorkflowAbort,
   WorkflowNonRetryableError,
   WorkflowRetryAfterError,
+  assertNonEmptyId,
+  toNonEmptyIdArray,
   makeNotifyRequest,
   makeGetWaitersRequest,
   normalizeCursor,

package/cloudflare.js

@@ -167,8 +167,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/cloudflare.mjs

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

package/express.js

@@ -167,8 +167,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/express.mjs

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

package/h3.js

@@ -451,8 +451,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/h3.mjs

@@ -2,7 +2,7 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-ICDNN4UW.mjs";
+} from "./chunk-WEQGCISK.mjs";
 
 // node_modules/defu/dist/defu.mjs
 function isPlainObject(value) {

package/hono.js

@@ -142,8 +142,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/hono.mjs

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

package/index.d.mts

@@ -221,7 +221,7 @@ type FailureFunctionLog = {
     /**
      * State of the message published for failure
      */
-    state: "CALLBACK_INPROGRESS" | "CALLBACK_SUCCESS" | "CALLBACK_FAIL";
+    state: "CALLBACK_INPROGRESS" | "CALLBACK_SUCCESS" | "CALLBACK_FAIL" | "CALLBACK_CANCELED";
     /**
      * Headers received from the step which caused the workflow to fail
      */
@@ -538,14 +538,21 @@ declare const serveBase: <TInitialPayload = unknown, TRequest extends Request =
  */
 declare const serve: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, options?: WorkflowServeOptions<TInitialPayload, TResult>) => ReturnType<typeof serveBase<TInitialPayload, TRequest, TResponse, TResult>>;
 
-type RequireAtLeastOne<T> = {
+type RequireAtLeastOne<T> = T & {
     [K in keyof T]-?: Required<Pick<T, K>>;
 }[keyof T];
-/** Shared filter fields accepted by every qstash & workflow endpoint. */
+/**
+ * Shared filter fields accepted by every qstash & workflow endpoint.
+ *
+ * Most fields support multi-value filtering: pass an array to match a record
+ * whose value equals any of the given values (OR semantics). Separate filters
+ * are combined with AND semantics.
+ */
 type UniversalFilterFields = {
     fromDate?: Date | number;
     toDate?: Date | number;
-    callerIp?: string;
+    /** Filter by the IP address of the publisher. Supports multiple values. */
+    callerIp?: string | string[];
     /**
      * Filter by label.
      *
@@ -554,11 +561,13 @@ type UniversalFilterFields = {
      * filtering by `[label_1, label_2]` returns both.
      */
     label?: string | string[];
-    flowControlKey?: string;
+    /** Filter by Flow Control Key. Supports multiple values. */
+    flowControlKey?: string | string[];
 };
 /** Workflow-specific filter fields for DLQ and bulk endpoints. */
 type WorkflowFilterFields = {
-    workflowUrl?: string;
+    /** Filter by workflow URL. Supports multiple values. */
+    workflowUrl?: string | string[];
     workflowRunId?: string;
     workflowCreatedAt?: number;
     failureFunctionState?: string;
@@ -567,19 +576,33 @@ type WorkflowLogsFilterFields = {
     state?: WorkflowRunLog["workflowState"];
     messageId?: string;
 };
+/**
+ * Filter by the host/path of the workflow URL.
+ *
+ * Supported by the cancel and logs endpoints (the DLQ endpoint rejects these).
+ * Each supports multiple values: pass an array to match any value.
+ */
+type HostPathFilterFields = {
+    /** Filter by the host of the workflow URL. Supports multiple values. */
+    host?: string | string[];
+    /** Filter by the path of the workflow URL. Supports multiple values. */
+    path?: string | string[];
+};
 type DLQActionFilterFields = UniversalFilterFields & WorkflowFilterFields;
 /** Cancel filter: exact URL match. Cannot combine with `workflowUrlStartingWith`. */
-type CancelFilterWithExactUrl = UniversalFilterFields & {
-    workflowUrl: string;
+type CancelFilterWithExactUrl = UniversalFilterFields & HostPathFilterFields & {
+    /** Filter by exact workflow URL. Supports multiple values. */
+    workflowUrl: string | string[];
     workflowUrlStartingWith?: never;
 };
 /** Cancel filter: URL prefix match. Cannot combine with `workflowUrl`. */
-type CancelFilterWithPrefixUrl = UniversalFilterFields & {
-    workflowUrlStartingWith: string;
+type CancelFilterWithPrefixUrl = UniversalFilterFields & HostPathFilterFields & {
+    /** Filter by workflow URL prefix. Supports multiple values. */
+    workflowUrlStartingWith: string | string[];
     workflowUrl?: never;
 };
 /** Cancel filter: no URL. Requires at least one other filter field. */
-type CancelFilterWithoutUrl = RequireAtLeastOne<UniversalFilterFields> & {
+type CancelFilterWithoutUrl = RequireAtLeastOne<UniversalFilterFields & HostPathFilterFields> & {
     workflowUrl?: never;
     workflowUrlStartingWith?: never;
 };
@@ -650,14 +673,14 @@ type WorkflowRunCancelFilters = {
     workflowRunIds?: never;
     filter?: never;
 } & WorkflowCancelCount);
-type WorkflowLogsListFilters = UniversalFilterFields & Pick<WorkflowFilterFields, "workflowUrl" | "workflowRunId" | "workflowCreatedAt"> & WorkflowLogsFilterFields;
+type WorkflowLogsListFilters = UniversalFilterFields & Pick<WorkflowFilterFields, "workflowUrl" | "workflowRunId" | "workflowCreatedAt"> & HostPathFilterFields & WorkflowLogsFilterFields;
 
 type ResumeRestartOptions = {
     flowControl?: FlowControl;
     retries?: number;
 };
 type FailureCallbackInfo = {
-    state?: "CALLBACK_FAIL" | "CALLBACK_SUCCESS" | "CALLBACK_INPROGRESS";
+    state?: "CALLBACK_FAIL" | "CALLBACK_SUCCESS" | "CALLBACK_INPROGRESS" | "CALLBACK_CANCELED";
     responseStatus?: number;
     responseBody?: string;
     responseHeaders?: Record<string, string[]>;
@@ -863,6 +886,11 @@ declare class Client {
      * - With other filters: `cancel({ filter: { label: "my-label" } })`
      * - To target all: `cancel({ all: true })`
      *
+     * Filters support multiple values: pass an array to match a run whose value
+     * equals any of the given values (OR logic). Separate filters are combined with
+     * AND logic. For example:
+     * `cancel({ filter: { workflowUrl: ["https://a.com", "https://b.com"] } })`
+     *
      * Cancels up to `count` workflow runs per call (defaults to 100).
      *
      * ```ts

package/index.d.ts

@@ -221,7 +221,7 @@ type FailureFunctionLog = {
     /**
      * State of the message published for failure
      */
-    state: "CALLBACK_INPROGRESS" | "CALLBACK_SUCCESS" | "CALLBACK_FAIL";
+    state: "CALLBACK_INPROGRESS" | "CALLBACK_SUCCESS" | "CALLBACK_FAIL" | "CALLBACK_CANCELED";
     /**
      * Headers received from the step which caused the workflow to fail
      */
@@ -538,14 +538,21 @@ declare const serveBase: <TInitialPayload = unknown, TRequest extends Request =
  */
 declare const serve: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, options?: WorkflowServeOptions<TInitialPayload, TResult>) => ReturnType<typeof serveBase<TInitialPayload, TRequest, TResponse, TResult>>;
 
-type RequireAtLeastOne<T> = {
+type RequireAtLeastOne<T> = T & {
     [K in keyof T]-?: Required<Pick<T, K>>;
 }[keyof T];
-/** Shared filter fields accepted by every qstash & workflow endpoint. */
+/**
+ * Shared filter fields accepted by every qstash & workflow endpoint.
+ *
+ * Most fields support multi-value filtering: pass an array to match a record
+ * whose value equals any of the given values (OR semantics). Separate filters
+ * are combined with AND semantics.
+ */
 type UniversalFilterFields = {
     fromDate?: Date | number;
     toDate?: Date | number;
-    callerIp?: string;
+    /** Filter by the IP address of the publisher. Supports multiple values. */
+    callerIp?: string | string[];
     /**
      * Filter by label.
      *
@@ -554,11 +561,13 @@ type UniversalFilterFields = {
      * filtering by `[label_1, label_2]` returns both.
      */
     label?: string | string[];
-    flowControlKey?: string;
+    /** Filter by Flow Control Key. Supports multiple values. */
+    flowControlKey?: string | string[];
 };
 /** Workflow-specific filter fields for DLQ and bulk endpoints. */
 type WorkflowFilterFields = {
-    workflowUrl?: string;
+    /** Filter by workflow URL. Supports multiple values. */
+    workflowUrl?: string | string[];
     workflowRunId?: string;
     workflowCreatedAt?: number;
     failureFunctionState?: string;
@@ -567,19 +576,33 @@ type WorkflowLogsFilterFields = {
     state?: WorkflowRunLog["workflowState"];
     messageId?: string;
 };
+/**
+ * Filter by the host/path of the workflow URL.
+ *
+ * Supported by the cancel and logs endpoints (the DLQ endpoint rejects these).
+ * Each supports multiple values: pass an array to match any value.
+ */
+type HostPathFilterFields = {
+    /** Filter by the host of the workflow URL. Supports multiple values. */
+    host?: string | string[];
+    /** Filter by the path of the workflow URL. Supports multiple values. */
+    path?: string | string[];
+};
 type DLQActionFilterFields = UniversalFilterFields & WorkflowFilterFields;
 /** Cancel filter: exact URL match. Cannot combine with `workflowUrlStartingWith`. */
-type CancelFilterWithExactUrl = UniversalFilterFields & {
-    workflowUrl: string;
+type CancelFilterWithExactUrl = UniversalFilterFields & HostPathFilterFields & {
+    /** Filter by exact workflow URL. Supports multiple values. */
+    workflowUrl: string | string[];
     workflowUrlStartingWith?: never;
 };
 /** Cancel filter: URL prefix match. Cannot combine with `workflowUrl`. */
-type CancelFilterWithPrefixUrl = UniversalFilterFields & {
-    workflowUrlStartingWith: string;
+type CancelFilterWithPrefixUrl = UniversalFilterFields & HostPathFilterFields & {
+    /** Filter by workflow URL prefix. Supports multiple values. */
+    workflowUrlStartingWith: string | string[];
     workflowUrl?: never;
 };
 /** Cancel filter: no URL. Requires at least one other filter field. */
-type CancelFilterWithoutUrl = RequireAtLeastOne<UniversalFilterFields> & {
+type CancelFilterWithoutUrl = RequireAtLeastOne<UniversalFilterFields & HostPathFilterFields> & {
     workflowUrl?: never;
     workflowUrlStartingWith?: never;
 };
@@ -650,14 +673,14 @@ type WorkflowRunCancelFilters = {
     workflowRunIds?: never;
     filter?: never;
 } & WorkflowCancelCount);
-type WorkflowLogsListFilters = UniversalFilterFields & Pick<WorkflowFilterFields, "workflowUrl" | "workflowRunId" | "workflowCreatedAt"> & WorkflowLogsFilterFields;
+type WorkflowLogsListFilters = UniversalFilterFields & Pick<WorkflowFilterFields, "workflowUrl" | "workflowRunId" | "workflowCreatedAt"> & HostPathFilterFields & WorkflowLogsFilterFields;
 
 type ResumeRestartOptions = {
     flowControl?: FlowControl;
     retries?: number;
 };
 type FailureCallbackInfo = {
-    state?: "CALLBACK_FAIL" | "CALLBACK_SUCCESS" | "CALLBACK_INPROGRESS";
+    state?: "CALLBACK_FAIL" | "CALLBACK_SUCCESS" | "CALLBACK_INPROGRESS" | "CALLBACK_CANCELED";
     responseStatus?: number;
     responseBody?: string;
     responseHeaders?: Record<string, string[]>;
@@ -863,6 +886,11 @@ declare class Client {
      * - With other filters: `cancel({ filter: { label: "my-label" } })`
      * - To target all: `cancel({ all: true })`
      *
+     * Filters support multiple values: pass an array to match a run whose value
+     * equals any of the given values (OR logic). Separate filters are combined with
+     * AND logic. For example:
+     * `cancel({ filter: { workflowUrl: ["https://a.com", "https://b.com"] } })`
+     *
      * Cancels up to `count` workflow runs per call (defaults to 100).
      *
      * ```ts

package/index.js

@@ -149,8 +149,20 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
+var toNonEmptyIdArray = (request, label = "id") => {
+  const ids = typeof request === "string" ? [request] : request;
+  for (const id of ids) assertNonEmptyId(id, label);
+  return ids;
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",
@@ -159,6 +171,7 @@ var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) =>
   return result;
 };
 var makeGetWaitersRequest = async (requester, eventId) => {
+  assertNonEmptyId(eventId, "Event id");
   const result = await requester.request({
     path: ["v2", "waiters", eventId],
     method: "GET"
@@ -245,6 +258,13 @@ function buildBulkActionQueryParameters(request, options) {
       "No filter provided. Use { filter: { ... } } with at least one filter field, or { all: true }."
     );
   }
+  for (const [field, value] of Object.entries(filter)) {
+    if (Array.isArray(value) && value.length === 0) {
+      throw new import_qstash2.QstashError(
+        `Empty array provided for filter field '${field}'. If you intend to target all records, use { all: true } explicitly.`
+      );
+    }
+  }
   if (options?.translateWorkflowUrl) {
     const { workflowUrlStartingWith, workflowUrl, ...rest } = filter;
     if (workflowUrlStartingWith && workflowUrl) {
@@ -4013,8 +4033,11 @@ var DLQ = class {
       });
       return Array.isArray(dlqId) ? workflowRuns : workflowRuns[0];
     }
-    if (typeof request === "string") request = [request];
-    if (Array.isArray(request) && request.length === 0) return { workflowRuns: [] };
+    if (typeof request === "string" || Array.isArray(request)) {
+      const ids = toNonEmptyIdArray(request, "DLQ id");
+      if (ids.length === 0) return { workflowRuns: [] };
+      request = ids;
+    }
     const filters = Array.isArray(request) ? { dlqIds: request } : request;
     return normalizeCursor(
       await this.client.http.request({
@@ -4037,8 +4060,11 @@ var DLQ = class {
       });
       return Array.isArray(dlqId) ? workflowRuns : workflowRuns[0];
     }
-    if (typeof request === "string") request = [request];
-    if (Array.isArray(request) && request.length === 0) return { workflowRuns: [] };
+    if (typeof request === "string" || Array.isArray(request)) {
+      const ids = toNonEmptyIdArray(request, "DLQ id");
+      if (ids.length === 0) return { workflowRuns: [] };
+      request = ids;
+    }
     const filters = Array.isArray(request) ? { dlqIds: request } : request;
     return normalizeCursor(
       await this.client.http.request({
@@ -4057,6 +4083,7 @@ var DLQ = class {
    * @returns response with workflow run information
    */
   async retryFailureFunction({ dlqId }) {
+    assertNonEmptyId(dlqId, "DLQ id");
     const response = await this.client.http.request({
       path: ["v2", "workflows", "dlq", "callback", dlqId],
       method: "POST"
@@ -4084,8 +4111,11 @@ var DLQ = class {
    * ```
    */
   async delete(request) {
-    if (typeof request === "string") request = [request];
-    if (Array.isArray(request) && request.length === 0) return { deleted: 0 };
+    if (typeof request === "string" || Array.isArray(request)) {
+      const ids = toNonEmptyIdArray(request, "DLQ id");
+      if (ids.length === 0) return { deleted: 0 };
+      request = ids;
+    }
     const filters = Array.isArray(request) ? { dlqIds: request } : request;
     return normalizeCursor(
       await this.client.http.request({
@@ -4114,8 +4144,11 @@ var Client4 = class {
         return this.cancel({ filter: { workflowUrlStartingWith: legacy.urlStartingWith } });
       }
     }
-    if (typeof request === "string") request = [request];
-    if (Array.isArray(request) && request.length === 0) return { cancelled: 0 };
+    if (typeof request === "string" || Array.isArray(request)) {
+      const ids = toNonEmptyIdArray(request, "Workflow run id");
+      if (ids.length === 0) return { cancelled: 0 };
+      request = ids;
+    }
     const filters = Array.isArray(request) ? { workflowRunIds: request } : request;
     return await this.client.http.request({
       path: ["v2", "workflows", "runs"],

package/index.mjs

@@ -8,6 +8,7 @@ import {
   WorkflowMiddleware,
   WorkflowNonRetryableError,
   WorkflowRetryAfterError,
+  assertNonEmptyId,
   buildBulkActionQueryParameters,
   getWorkflowRunId,
   loggingMiddleware,
@@ -17,10 +18,11 @@ import {
   prepareFlowControl,
   serializeLabel,
   serve,
+  toNonEmptyIdArray,
   triggerFirstInvocation,
   validateFlowControl,
   validateLabel
-} from "./chunk-ICDNN4UW.mjs";
+} from "./chunk-WEQGCISK.mjs";
 
 // src/client/index.ts
 import { Client as QStashClient } from "@upstash/qstash";
@@ -86,8 +88,11 @@ var DLQ = class {
       });
       return Array.isArray(dlqId) ? workflowRuns : workflowRuns[0];
     }
-    if (typeof request === "string") request = [request];
-    if (Array.isArray(request) && request.length === 0) return { workflowRuns: [] };
+    if (typeof request === "string" || Array.isArray(request)) {
+      const ids = toNonEmptyIdArray(request, "DLQ id");
+      if (ids.length === 0) return { workflowRuns: [] };
+      request = ids;
+    }
     const filters = Array.isArray(request) ? { dlqIds: request } : request;
     return normalizeCursor(
       await this.client.http.request({
@@ -110,8 +115,11 @@ var DLQ = class {
       });
       return Array.isArray(dlqId) ? workflowRuns : workflowRuns[0];
     }
-    if (typeof request === "string") request = [request];
-    if (Array.isArray(request) && request.length === 0) return { workflowRuns: [] };
+    if (typeof request === "string" || Array.isArray(request)) {
+      const ids = toNonEmptyIdArray(request, "DLQ id");
+      if (ids.length === 0) return { workflowRuns: [] };
+      request = ids;
+    }
     const filters = Array.isArray(request) ? { dlqIds: request } : request;
     return normalizeCursor(
       await this.client.http.request({
@@ -130,6 +138,7 @@ var DLQ = class {
    * @returns response with workflow run information
    */
   async retryFailureFunction({ dlqId }) {
+    assertNonEmptyId(dlqId, "DLQ id");
     const response = await this.client.http.request({
       path: ["v2", "workflows", "dlq", "callback", dlqId],
       method: "POST"
@@ -157,8 +166,11 @@ var DLQ = class {
    * ```
    */
   async delete(request) {
-    if (typeof request === "string") request = [request];
-    if (Array.isArray(request) && request.length === 0) return { deleted: 0 };
+    if (typeof request === "string" || Array.isArray(request)) {
+      const ids = toNonEmptyIdArray(request, "DLQ id");
+      if (ids.length === 0) return { deleted: 0 };
+      request = ids;
+    }
     const filters = Array.isArray(request) ? { dlqIds: request } : request;
     return normalizeCursor(
       await this.client.http.request({
@@ -187,8 +199,11 @@ var Client = class {
         return this.cancel({ filter: { workflowUrlStartingWith: legacy.urlStartingWith } });
       }
     }
-    if (typeof request === "string") request = [request];
-    if (Array.isArray(request) && request.length === 0) return { cancelled: 0 };
+    if (typeof request === "string" || Array.isArray(request)) {
+      const ids = toNonEmptyIdArray(request, "Workflow run id");
+      if (ids.length === 0) return { cancelled: 0 };
+      request = ids;
+    }
     const filters = Array.isArray(request) ? { workflowRunIds: request } : request;
     return await this.client.http.request({
       path: ["v2", "workflows", "runs"],

package/nextjs.js

@@ -145,8 +145,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/nextjs.mjs

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

package/package.json

@@ -1 +1 @@
-{"name":"@upstash/workflow","version":"1.3.2","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.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"}}

package/react-router.js

@@ -167,8 +167,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/react-router.mjs

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

package/solidjs.js

@@ -140,8 +140,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/solidjs.mjs

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

package/svelte.js

@@ -142,8 +142,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/svelte.mjs

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

package/tanstack.js

@@ -142,8 +142,15 @@ function isInstanceOf(v, ctor) {
 }
 
 // src/client/utils.ts
+var assertNonEmptyId = (id, label = "id") => {
+  if (!id) {
+    throw new import_qstash2.QstashError(`${label} cannot be empty`);
+  }
+};
 var makeNotifyRequest = async (requester, eventId, eventData, workflowRunId) => {
-  const path = workflowRunId ? ["v2", "notify", workflowRunId, eventId] : ["v2", "notify", eventId];
+  assertNonEmptyId(eventId, "Event id");
+  if (workflowRunId !== void 0) assertNonEmptyId(workflowRunId, "Workflow run id");
+  const path = workflowRunId === void 0 ? ["v2", "notify", eventId] : ["v2", "notify", workflowRunId, eventId];
   const result = await requester.request({
     path,
     method: "POST",

package/tanstack.mjs

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