@upstash/workflow 1.2.0 → 1.2.1

package/index.mjs

@@ -8,20 +8,34 @@ import {
   WorkflowMiddleware,
   WorkflowNonRetryableError,
   WorkflowRetryAfterError,
+  buildBulkActionQueryParameters,
   getWorkflowRunId,
   loggingMiddleware,
   makeGetWaitersRequest,
   makeNotifyRequest,
+  normalizeCursor,
   prepareFlowControl,
   serve,
   triggerFirstInvocation
-} from "./chunk-V5ZUHMAF.mjs";
+} from "./chunk-THS5AX2D.mjs";
 
 // src/client/index.ts
 import { Client as QStashClient } from "@upstash/qstash";
 
 // src/client/dlq.ts
-var DLQ = class _DLQ {
+function buildResumeRestartHeaders(options) {
+  const headers = {};
+  if (options?.flowControl) {
+    const { flowControlKey, flowControlValue } = prepareFlowControl(options.flowControl);
+    headers["Upstash-Flow-Control-Key"] = flowControlKey;
+    headers["Upstash-Flow-Control-Value"] = flowControlValue;
+  }
+  if (options?.retries !== void 0) {
+    headers["Upstash-Retries"] = options.retries.toString();
+  }
+  return headers;
+}
+var DLQ = class {
   constructor(client) {
     this.client = client;
   }
@@ -44,40 +58,66 @@ var DLQ = class _DLQ {
    */
   async list(parameters) {
     const { cursor, count, filter } = parameters || {};
-    return await this.client.http.request({
-      path: ["v2", "dlq"],
-      method: "GET",
-      query: {
-        cursor,
-        count,
-        ...filter,
-        source: "workflow"
-      }
-    });
+    return normalizeCursor(
+      await this.client.http.request({
+        path: ["v2", "dlq"],
+        method: "GET",
+        query: {
+          cursor,
+          count,
+          ...filter,
+          source: "workflow"
+        }
+      })
+    );
   }
-  async resume(parameters) {
-    const { headers, queryParams } = _DLQ.handleDLQOptions(parameters);
-    const { workflowRuns } = await this.client.http.request({
-      path: ["v2", "workflows", "dlq", `resume?${queryParams}`],
-      headers,
-      method: "POST"
-    });
-    if (Array.isArray(parameters.dlqId)) {
-      return workflowRuns;
+  async resume(request, options) {
+    if (typeof request === "object" && !Array.isArray(request) && "dlqId" in request) {
+      const { dlqId, flowControl, retries } = request;
+      const dlqIds = Array.isArray(dlqId) ? dlqId : [dlqId];
+      const { workflowRuns } = await this.client.http.request({
+        path: ["v2", "workflows", "dlq", "resume"],
+        query: { dlqIds },
+        method: "POST",
+        headers: buildResumeRestartHeaders({ flowControl, retries })
+      });
+      return Array.isArray(dlqId) ? workflowRuns : workflowRuns[0];
     }
-    return workflowRuns[0];
+    if (typeof request === "string") request = [request];
+    if (Array.isArray(request) && request.length === 0) return { workflowRuns: [] };
+    const filters = Array.isArray(request) ? { dlqIds: request } : request;
+    return normalizeCursor(
+      await this.client.http.request({
+        path: ["v2", "workflows", "dlq", "resume"],
+        query: buildBulkActionQueryParameters(filters),
+        method: "POST",
+        headers: buildResumeRestartHeaders(options)
+      })
+    );
   }
-  async restart(parameters) {
-    const { headers, queryParams } = _DLQ.handleDLQOptions(parameters);
-    const { workflowRuns } = await this.client.http.request({
-      path: ["v2", "workflows", "dlq", `restart?${queryParams}`],
-      headers,
-      method: "POST"
-    });
-    if (Array.isArray(parameters.dlqId)) {
-      return workflowRuns;
+  async restart(request, options) {
+    if (typeof request === "object" && !Array.isArray(request) && "dlqId" in request) {
+      const { dlqId, flowControl, retries } = request;
+      const dlqIds = Array.isArray(dlqId) ? dlqId : [dlqId];
+      const { workflowRuns } = await this.client.http.request({
+        path: ["v2", "workflows", "dlq", "restart"],
+        query: { dlqIds },
+        method: "POST",
+        headers: buildResumeRestartHeaders({ flowControl, retries })
+      });
+      return Array.isArray(dlqId) ? workflowRuns : workflowRuns[0];
     }
-    return workflowRuns[0];
+    if (typeof request === "string") request = [request];
+    if (Array.isArray(request) && request.length === 0) return { workflowRuns: [] };
+    const filters = Array.isArray(request) ? { dlqIds: request } : request;
+    return normalizeCursor(
+      await this.client.http.request({
+        path: ["v2", "workflows", "dlq", "restart"],
+        query: buildBulkActionQueryParameters(filters),
+        method: "POST",
+        headers: buildResumeRestartHeaders(options)
+      })
+    );
   }
   /**
    * Retry the failure callback of a workflow run whose failureUrl/failureFunction
@@ -94,35 +134,36 @@ var DLQ = class _DLQ {
     return response;
   }
   /**
-   * Handles DLQ options and prepares headers and query parameters.
+   * Delete DLQ messages.
    *
-   * @param options - DLQ resume/restart options
-   */
-  static handleDLQOptions(options) {
-    const { dlqId, flowControl, retries } = options;
-    const headers = {};
-    if (flowControl) {
-      const { flowControlKey, flowControlValue } = prepareFlowControl(flowControl);
-      headers["Upstash-Flow-Control-Key"] = flowControlKey;
-      headers["Upstash-Flow-Control-Value"] = flowControlValue;
-    }
-    if (retries !== void 0) {
-      headers["Upstash-Retries"] = retries.toString();
-    }
-    return {
-      queryParams: _DLQ.getDlqIdQueryParameter(dlqId),
-      headers
-    };
-  }
-  /**
-   * Converts DLQ ID(s) to query parameter string.
+   * Can be called with:
+   * - A single dlqId: `delete("id")`
+   * - An array of dlqIds: `delete(["id1", "id2"])`
+   * - A filter object: `delete({ filter: { label: "my-label", fromDate: 1640995200000 } })`
+   * - To target all entries: `delete({ all: true })`
+   *
+   * Processes up to `count` messages per call (defaults to 100).
+   * Call in a loop until cursor is undefined to process all:
    *
-   * @param dlqId - Single DLQ ID or array of DLQ IDs
+   * ```ts
+   * let cursor: string | undefined;
+   * do {
+   *   const result = await client.dlq.delete({ all: true, count: 100, cursor });
+   *   cursor = result.cursor;
+   * } while (cursor);
+   * ```
    */
-  static getDlqIdQueryParameter(dlqId) {
-    const dlqIds = Array.isArray(dlqId) ? dlqId : [dlqId];
-    const paramsArray = dlqIds.map((id) => ["dlqIds", id]);
-    return new URLSearchParams(paramsArray).toString();
+  async delete(request) {
+    if (typeof request === "string") request = [request];
+    if (Array.isArray(request) && request.length === 0) return { deleted: 0 };
+    const filters = Array.isArray(request) ? { dlqIds: request } : request;
+    return normalizeCursor(
+      await this.client.http.request({
+        path: ["v2", "workflows", "dlq"],
+        method: "DELETE",
+        query: buildBulkActionQueryParameters(filters)
+      })
+    );
   }
 };
 
@@ -132,82 +173,25 @@ var Client = class {
   constructor(clientConfig) {
     this.client = new QStashClient(clientConfig);
   }
-  /**
-   * Cancel an ongoing workflow
-   *
-   * Returns true if workflow is canceled succesfully. Otherwise, throws error.
-   *
-   * There are multiple ways you can cancel workflows:
-   * - pass one or more workflow run ids to cancel them
-   * - pass a workflow url to cancel all runs starting with this url
-   * - cancel all pending or active workflow runs
-   *
-   * ### Cancel a set of workflow runs
-   *
-   * ```ts
-   * // cancel a single workflow
-   * await client.cancel({ ids: "<WORKFLOW_RUN_ID>" })
-   *
-   * // cancel a set of workflow runs
-   * await client.cancel({ ids: [
-   *   "<WORKFLOW_RUN_ID_1>",
-   *   "<WORKFLOW_RUN_ID_2>",
-   * ]})
-   * ```
-   *
-   * ### Cancel workflows starting with a url
-   *
-   * If you have an endpoint called `https://your-endpoint.com` and you
-   * want to cancel all workflow runs on it, you can use `urlStartingWith`.
-   *
-   * Note that this will cancel workflows in all endpoints under
-   * `https://your-endpoint.com`.
-   *
-   * ```ts
-   * await client.cancel({ urlStartingWith: "https://your-endpoint.com" })
-   * ```
-   *
-   * ### Cancel *all* workflows
-   *
-   * To cancel all pending and currently running workflows, you can
-   * do it like this:
-   *
-   * ```ts
-   * await client.cancel({ all: true })
-   * ```
-   *
-   * @param ids run id of the workflow to delete
-   * @param urlStartingWith cancel workflows starting with this url. Will be ignored
-   *   if `ids` parameter is set.
-   * @param all set to true in order to cancel all workflows. Will be ignored
-   *   if `ids` or `urlStartingWith` parameters are set.
-   * @returns true if workflow is succesfully deleted. Otherwise throws QStashError
-   */
-  async cancel({
-    ids,
-    urlStartingWith,
-    all
-  }) {
-    let body;
-    if (ids) {
-      const runIdArray = typeof ids === "string" ? [ids] : ids;
-      body = JSON.stringify({ workflowRunIds: runIdArray });
-    } else if (urlStartingWith) {
-      body = JSON.stringify({ workflowUrl: urlStartingWith });
-    } else if (all) {
-      body = "{}";
-    } else {
-      throw new TypeError("The `cancel` method cannot be called without any options.");
+  async cancel(request) {
+    if (typeof request === "object" && !Array.isArray(request) && ("ids" in request || "urlStartingWith" in request)) {
+      const legacy = request;
+      if (legacy.ids) {
+        const ids = typeof legacy.ids === "string" ? [legacy.ids] : legacy.ids;
+        return this.cancel(ids);
+      }
+      if (legacy.urlStartingWith) {
+        return this.cancel({ filter: { workflowUrlStartingWith: legacy.urlStartingWith } });
+      }
     }
-    const result = await this.client.http.request({
+    if (typeof request === "string") request = [request];
+    if (Array.isArray(request) && request.length === 0) return { cancelled: 0 };
+    const filters = Array.isArray(request) ? { workflowRunIds: request } : request;
+    return await this.client.http.request({
       path: ["v2", "workflows", "runs"],
       method: "DELETE",
-      body,
-      headers: {
-        "Content-Type": "application/json"
-      }
+      query: buildBulkActionQueryParameters(filters, { translateWorkflowUrl: true })
     });
-    return result;
   }
   /**
    * Notify a workflow run waiting for an event
@@ -331,33 +315,17 @@ var Client = class {
    * ```
    */
   async logs(params) {
-    const { workflowRunId, cursor, count, state, workflowUrl, workflowCreatedAt } = params ?? {};
-    const urlParams = new URLSearchParams({ groupBy: "workflowRunId" });
-    if (workflowRunId) {
-      urlParams.append("workflowRunId", workflowRunId);
-    }
-    if (cursor) {
-      urlParams.append("cursor", cursor);
-    }
-    if (count) {
-      urlParams.append("count", count.toString());
-    }
-    if (state) {
-      urlParams.append("state", state);
-    }
-    if (workflowUrl) {
-      urlParams.append("workflowUrl", workflowUrl);
-    }
-    if (workflowCreatedAt) {
-      urlParams.append("workflowCreatedAt", workflowCreatedAt.toString());
-    }
-    if (params?.label) {
-      urlParams.append("label", params.label);
-    }
-    const result = await this.client.http.request({
-      path: ["v2", "workflows", `events?${urlParams.toString()}`]
+    const { cursor, count, filter, ...legacyFilter } = params ?? {};
+    return await this.client.http.request({
+      path: ["v2", "workflows", "events"],
+      query: {
+        groupBy: "workflowRunId",
+        ...legacyFilter,
+        cursor,
+        count,
+        ...filter
+      }
     });
-    return result;
   }
   get dlq() {
     return new DLQ(this.client);

package/nextjs.mjs

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

package/package.json

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

package/react-router.mjs

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

package/solidjs.mjs

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

package/svelte.mjs

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

package/tanstack.mjs

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