@convex-dev/workpool 0.2.18-alpha.2 → 0.2.18

package/README.md

@@ -12,9 +12,7 @@ This Convex component pools actions and mutations to restrict parallel requests.
 - An `onComplete` callback so you can build durable, reliable workflows. Called
   when the work is finished, whether it succeeded, failed, or was canceled.
 
-## Use cases
-
-### Separating and throttling async workloads
+## Separating and throttling async workloads
 
 Suppose you have some important async work, like sending verification emails,
 and some less important async work, like scraping data from an API. If all of
@@ -51,9 +49,9 @@ export const downloadLatestWeather = mutation({
 });
 ```
 
-### Durable, reliable workflows meet workpool
+## Durable, reliable workflows
 
-#### Retry management
+### Retry management
 
 Imagine that the payment processor is a 3rd party API, and they temporarily have an
 outage. Now imagine you implement your own action retrying logic for your busy app.
@@ -65,7 +63,7 @@ Creating an upper bound on how much work will be done in parallel is a good way
 mitigate this risk. Actions that are currently backing off awaiting retry will not tie
 up a thread in the workpool.
 
-#### Completion handling
+### Completion handling
 
 By handing off asynchronous work, it will be guaranteed to run, and with retries
 you can account for temporary failures, while avoiding a "stampeding herd"
@@ -114,7 +112,7 @@ export const emailSent = internalMutation({
       error: result.kind === "failed" ? result.error : null,
     });
     if (result.kind === "failed") {
-      await pool.enqueueAction(ctx, internal.email.checkResendStatus, context, {
+      await pool.enqueueAction(ctx, internal.email.checkStatus, { userId }, {
         retry: { maxAttempts: 10, initialBackoffMs: 250, base: 2 }, // custom
         onComplete: internal.email.handleEmailStatus,
         context: { emailLogId },
@@ -141,7 +139,7 @@ export const emailSent = pool.defineOnComplete<DataModel>({
 });
 ```
 
-#### Idempotency?
+### Idempotency
 
 Idempotent actions are actions that can be run multiple times safely. This typically
 means they don't cause any side effects that would be a problem if executed twice or more.
@@ -162,10 +160,10 @@ If you're creating complex workflows with many steps involving 3rd party APIs:
 1.  You should ensure that each step is an idempotent Convex action.
 2.  You should use this component to manage these actions so it all just works!
 
-### Optimize OCC errors
+### Reducing database write conflicts (aka OCC errors)
 
 With limited parallelism, you can reduce
-[OCC errors](https://docs.convex.dev/error#1)
+[write conflicts](https://docs.convex.dev/error#1)
 from mutations that read and write the same data.
 
 Consider this action that calls a mutation to increment a singleton counter.
@@ -199,7 +197,44 @@ Effectively, Workpool runs async functions similar to
 `ctx.scheduler.runAfter(0, ...)`, but it limits the number of functions that
 can run in parallel.
 
-## Pre-requisite: Convex
+## Reactive status of asynchronous work
+
+The workpool stores the status of each function in the database, and thanks to
+Convex's reactive queries, you can read it in a query to power a reactive UI.
+
+By default, it will keep the status for 1 day but you can change this with
+the `statusTtl` option to `Workpool`.
+
+To keep the status forever, set `statusTtl: Number.POSITIVE_INFINITY`.
+
+You can read the status of a function by calling `pool.status(id)`.
+
+```ts
+import { vWorkIdValidator } from "@convex-dev/workpool";
+import { query } from "./_generated/server";
+
+export const getStatus = query({
+  args: { id: vWorkIdValidator },
+  handler: async (ctx, args) => {
+    const status = await pool.status(args.id);
+    return status;
+  },
+});
+```
+
+The status will be one of:
+
+- `{ kind: "pending"; previousAttempts: number }`: The function has not started yet.
+- `{ kind: "running"; previousAttempts: number }`: The function is currently running.
+- `{ kind: "finished" }`: The function has succeeded, failed, or been canceled.
+
+To get the result of your function, you can either write to the database from
+within your function, call or schedule another function from there, or use the
+`onComplete` handler to respond to the job result.
+
+## Get started
+
+### Pre-requisite: Convex
 
 You'll need an existing Convex project to use the component.
 Convex is a hosted backend platform, including a database, serverless functions,
@@ -207,7 +242,7 @@ and a ton more you can learn about [here](https://docs.convex.dev/get-started).
 
 Run `npm create convex` or follow any of the [quickstarts](https://docs.convex.dev/home) to set one up.
 
-## Installation
+### Install the component
 
 See [`example/`](./example/convex/) for a working demo.
 
@@ -231,49 +266,7 @@ app.use(workpool, { name: "scrapeWorkpool" });
 export default app;
 ```
 
-## Usage
-
-```ts
-import { components } from "./_generated/api";
-import { Workpool } from "@convex-dev/workpool";
-
-const pool = new Workpool(components.emailWorkpool, { maxParallelism: 10 });
-```
-
-Then you have the following interface on `pool`:
-
-```ts
-import { vWorkIdValidator } from "@convex-dev/workpool";
-
-export const myMutation = mutation({
-  args: {},
-  handler: async (ctx, args) => {
-    // Schedule functions to run in the background.
-    const id = await pool.enqueueMutation(ctx, internal.foo.bar, args);
-    // Or for an action:
-    const id = await pool.enqueueAction(ctx, internal.foo.baz, args);
-  },
-});
-
-export const getStatus = query({
-  args: { id: vWorkIdValidator },
-  handler: async (ctx, args) => {
-    // Is it done yet? Did it succeed or fail?
-    const status = await pool.status(args.id);
-    return status;
-  },
-});
-
-export const cancelWork = mutation({
-  args: { id: vWorkIdValidator },
-  handler: async (ctx, args) => {
-    // You can cancel the work, if it hasn't finished yet.
-    await pool.cancel(ctx, args.id);
-  },
-});
-```
-
-See more example usage in [example.ts](./example/convex/example.ts).
+See example usage in [example.ts](./example/convex/example.ts).
 
 ### Configuring the Workpool
 
@@ -326,39 +319,49 @@ If you're running into issues with too many concurrent functions, there are
 alternatives to Workpool:
 
 - Try combining multiple mutations into a single mutation, with batching or
-  debouncing.
+  debouncing. See the next section for enqueueing multiple actions at once.
 - Call plain TypeScript functions if possible.
   - In particular, an action calling `ctx.runAction` has more overhead than just
     calling the action's handler directly.
 
 See [best practices](https://docs.convex.dev/production/best-practices) for more.
 
-## Reading function status
+### Batching
 
-The workpool stores the status of each function in the database, so you can
-read it even after the function has finished.
-By default, it will keep the status for 1 day but you can change this with
-the `statusTtl` option to `Workpool`.
+If you're enqueuing a lot of work, you can use `enqueueActionBatch` to enqueue
+a batch of actions at once, or the equivalents for queries or mutations.
 
-To keep the status forever, set `statusTtl: Number.POSITIVE_INFINITY`.
+This helps in two ways:
 
-You can read the status of a function by calling `pool.status(id)`.
-
-The status will be one of:
+1.  It reduces the number of calls to the component, which reduces overhead
+    as each component call runs in a fresh container (for strong isolation).
+2.  When called from an action, it reduces the number of mutations that might
+    conflict with each other, especially if they were being called in parallel.
 
-- `{ kind: "pending"; previousAttempts: number }`: The function has not started yet.
-- `{ kind: "running"; previousAttempts: number }`: The function is currently running.
-- `{ kind: "finished" }`: The function has succeeded, failed, or been canceled.
+```ts
+await pool.enqueueActionBatch(ctx, internal.weather.scrape, [
+  { city: "New York" },
+  { city: "Los Angeles" },
+  { city: "Chicago" },
+]);
+```
 
-To get the result of your function, you can either write to the database from
-within your function, call or schedule another function from there, or use the
-`onComplete` handler to respond to the job result.
 
 ## Canceling work
 
 You can cancel work by calling `pool.cancel(id)` or all of them with
 `pool.cancelAll()`.
 
+```ts
+export const cancelWork = mutation({
+  args: { id: vWorkIdValidator },
+  handler: async (ctx, args) => {
+    // You can cancel the work, if it hasn't finished yet.
+    await pool.cancel(ctx, args.id);
+  },
+});
+```
+
 This will avoid starting or retrying, but will not stop in-progress work.
 
 ## Monitoring the workpool

package/dist/commonjs/client/index.d.ts

@@ -1,4 +1,4 @@
-import { DefaultFunctionArgs, FunctionReference, FunctionVisibility, GenericDataModel, GenericMutationCtx, RegisteredMutation } from "convex/server";
+import { DefaultFunctionArgs, FunctionReference, FunctionType, FunctionVisibility, GenericDataModel, GenericMutationCtx, RegisteredMutation } from "convex/server";
 import { Infer, Validator, VAny, VString } from "convex/values";
 import { Mounts } from "../component/_generated/api.js";
 import { type LogLevel } from "../component/logging.js";
@@ -16,7 +16,7 @@ export {
 vWorkIdValidator as workIdValidator, 
 /** @deprecated Use `vResultValidator` instead. */
 vResultValidator as resultValidator, };
-/** @deprecated Use `vOnCompleteArgs(<your-context-validator>)` instead. */
+/** Equivalent to `vOnCompleteArgs(<your-context-validator>)`. */
 export declare const vOnComplete: import("convex/values").VObject<{
     context: any;
     workId: WorkId;
@@ -31,7 +31,7 @@ export declare const vOnComplete: import("convex/values").VObject<{
     };
 }, {
     workId: VString<WorkId, "required">;
-    context: VAny<any, "required", string> | VAny<any, "optional", string>;
+    context: VAny<any, "required", string>;
     result: import("convex/values").VUnion<{
         kind: "success";
         returnValue: any;
@@ -61,8 +61,9 @@ export declare const vOnComplete: import("convex/values").VObject<{
 /** @deprecated Use `vOnCompleteArgs()` instead. */
 export declare const vOnCompleteValidator: typeof vOnCompleteArgs;
 export declare const DEFAULT_RETRY_BEHAVIOR: RetryBehavior;
+export type WorkpoolComponent = UseApi<Mounts>;
 export declare class Workpool {
-    private component;
+    component: WorkpoolComponent;
     options: WorkpoolOptions;
     /**
      * Initializes a Workpool.
@@ -75,8 +76,7 @@ export declare class Workpool {
      *   `./_generated/api.ts`.
      * @param options - The {@link WorkpoolOptions} for the Workpool.
      */
-    constructor(component: UseApi<Mounts>, // UseApi<api> for jump to definition
-    options: WorkpoolOptions);
+    constructor(component: WorkpoolComponent, options: WorkpoolOptions);
     /**
      * Enqueues an action to be run.
      *
@@ -87,7 +87,20 @@ export declare class Workpool {
      *   onComplete handling, and scheduling via `runAt` or `runAfter`.
      * @returns The ID of the work that was enqueued.
      */
-    enqueueAction<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"action", FunctionVisibility, Args, ReturnType>, fnArgs: Args, options?: RetryOption & CallbackOptions & SchedulerOptions & NameOption): Promise<WorkId>;
+    enqueueAction<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"action", FunctionVisibility, Args, ReturnType>, fnArgs: Args, options?: RetryOption & EnqueueOptions): Promise<WorkId>;
+    /**
+     * Enqueues a batch of actions to be run.
+     * Each action will be run independently, and the onComplete handler will
+     * be called for each action.
+     *
+     * @param ctx - The mutation or action ctx that can call ctx.runMutation.
+     * @param fn - The action to run, like `internal.example.myAction`.
+     * @param argsArray - The arguments to pass to the action.
+     * @param options - The options for the actions to specify retry behavior,
+     *   onComplete handling, and scheduling via `runAt` or `runAfter`.
+     * @returns The IDs of the work that was enqueued.
+     */
+    enqueueActionBatch<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"action", FunctionVisibility, Args, ReturnType>, argsArray: Array<Args>, options?: RetryOption & EnqueueOptions): Promise<WorkId[]>;
     /**
      * Enqueues a mutation to be run.
      *
@@ -101,8 +114,44 @@ export declare class Workpool {
      * @param options - The options for the mutation to specify onComplete handling
      *   and scheduling via `runAt` or `runAfter`.
      */
-    enqueueMutation<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"mutation", FunctionVisibility, Args, ReturnType>, fnArgs: Args, options?: CallbackOptions & SchedulerOptions & NameOption): Promise<WorkId>;
-    enqueueQuery<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"query", FunctionVisibility, Args, ReturnType>, fnArgs: Args, options?: CallbackOptions & SchedulerOptions & NameOption): Promise<WorkId>;
+    enqueueMutation<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"mutation", FunctionVisibility, Args, ReturnType>, fnArgs: Args, options?: EnqueueOptions): Promise<WorkId>;
+    /**
+     * Enqueues a batch of mutations to be run.
+     * Each mutation will be run independently, and the onComplete handler will
+     * be called for each mutation.
+     *
+     * @param ctx - The mutation or action context that can call ctx.runMutation.
+     * @param fn - The mutation to run, like `internal.example.myMutation`.
+     * @param argsArray - The arguments to pass to the mutations.
+     * @param options - The options for the mutations to specify onComplete handling
+     *   and scheduling via `runAt` or `runAfter`.
+     */
+    enqueueMutationBatch<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"mutation", FunctionVisibility, Args, ReturnType>, argsArray: Array<Args>, options?: EnqueueOptions): Promise<WorkId[]>;
+    /**
+     * Enqueues a query to be run.
+     * Usually not what you want, but it can be useful during workflows.
+     * The query is run in a mutation and the result is returned to the caller,
+     * so it can conflict if other mutations are writing the value.
+     *
+     * @param ctx - The mutation or action context that can call ctx.runMutation.
+     * @param fn - The query to run, like `internal.example.myQuery`.
+     * @param fnArgs - The arguments to pass to the query.
+     * @param options - The options for the query to specify onComplete handling
+     *   and scheduling via `runAt` or `runAfter`.
+     */
+    enqueueQuery<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"query", FunctionVisibility, Args, ReturnType>, fnArgs: Args, options?: EnqueueOptions): Promise<WorkId>;
+    /**
+     * Enqueues a batch of queries to be run.
+     * Each query will be run independently, and the onComplete handler will
+     * be called for each query.
+     *
+     * @param ctx - The mutation or action context that can call ctx.runMutation.
+     * @param fn - The query to run, like `internal.example.myQuery`.
+     * @param argsArray - The arguments to pass to the queries.
+     * @param options - The options for the queries to specify onComplete handling
+     *   and scheduling via `runAt` or `runAfter`.
+     */
+    enqueueQueryBatch<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"query", FunctionVisibility, Args, ReturnType>, argsArray: Array<Args>, options?: EnqueueOptions): Promise<WorkId[]>;
     /**
      * Cancels a work item. If it's already started, it will be allowed to finish
      * but will not be retried.
@@ -128,6 +177,14 @@ export declare class Workpool {
      * - `{ state: "finished" }`
      */
     status(ctx: RunQueryCtx, id: WorkId): Promise<Status>;
+    /**
+     * Gets the status of a batch of work items.
+     *
+     * @param ctx - The query context that can call ctx.runQuery.
+     * @param ids - The IDs of the work to get the status of.
+     * @returns The status of the work items.
+     */
+    statusBatch(ctx: RunQueryCtx, ids: WorkId[]): Promise<Status[]>;
     /**
      * Defines a mutation that will be run after a work item completes.
      * You can pass this to a call to enqueue* like so:
@@ -170,9 +227,9 @@ export declare class Workpool {
  * @param context - The context validator. If not provided, it will be `v.any()`.
  * @returns The validator for the onComplete mutation.
  */
-export declare function vOnCompleteArgs<V extends Validator<any, "required", any> = VAny>(context?: V): import("convex/values").VObject<import("convex/server").Expand<{ [Property in (VAny<any, "optional", string> | V)["isOptional"] extends "optional" ? "context" : never]?: Exclude<Infer<{
+export declare function vOnCompleteArgs<V extends Validator<any, "required", any> = VAny>(context?: V): import("convex/values").VObject<import("convex/server").Expand<{ [Property in V["isOptional"] extends "optional" ? "context" : never]?: Exclude<Infer<{
     workId: VString<WorkId, "required">;
-    context: VAny<any, "optional", string> | V;
+    context: V;
     result: import("convex/values").VUnion<{
         kind: "success";
         returnValue: any;
@@ -198,9 +255,9 @@ export declare function vOnCompleteArgs<V extends Validator<any, "required", any
     }, {
         kind: import("convex/values").VLiteral<"canceled", "required">;
     }, "required", "kind">], "required", "kind" | "returnValue" | `returnValue.${string}` | "error">;
-}[Property]>, undefined> | undefined; } & { [Property_1 in Exclude<"context", (VAny<any, "optional", string> | V)["isOptional"] extends "optional" ? "context" : never> | Exclude<"workId", (VAny<any, "optional", string> | V)["isOptional"] extends "optional" ? "context" : never> | Exclude<"result", (VAny<any, "optional", string> | V)["isOptional"] extends "optional" ? "context" : never>]: Infer<{
+}[Property]>, undefined> | undefined; } & { [Property_1 in Exclude<"context", V["isOptional"] extends "optional" ? "context" : never> | Exclude<"workId", V["isOptional"] extends "optional" ? "context" : never> | Exclude<"result", V["isOptional"] extends "optional" ? "context" : never>]: Infer<{
     workId: VString<WorkId, "required">;
-    context: VAny<any, "optional", string> | V;
+    context: V;
     result: import("convex/values").VUnion<{
         kind: "success";
         returnValue: any;
@@ -228,7 +285,7 @@ export declare function vOnCompleteArgs<V extends Validator<any, "required", any
     }, "required", "kind">], "required", "kind" | "returnValue" | `returnValue.${string}` | "error">;
 }[Property_1]>; }>, {
     workId: VString<WorkId, "required">;
-    context: VAny<any, "optional", string> | V;
+    context: V;
     result: import("convex/values").VUnion<{
         kind: "success";
         returnValue: any;
@@ -254,15 +311,7 @@ export declare function vOnCompleteArgs<V extends Validator<any, "required", any
     }, {
         kind: import("convex/values").VLiteral<"canceled", "required">;
     }, "required", "kind">], "required", "kind" | "returnValue" | `returnValue.${string}` | "error">;
-}, "required", "context" | "workId" | "result" | `context.${(VAny<any, "optional", string> | V)["fieldPaths"]}` | "result.kind" | "result.returnValue" | `result.returnValue.${string}` | "result.error">;
-export type NameOption = {
-    /**
-     * The name of the function. By default, if you pass in api.foo.bar.baz,
-     * it will use "foo/bar:baz" as the name. If you pass in a function handle,
-     * it will use the function handle directly.
-     */
-    name?: string;
-};
+}, "required", "context" | "workId" | "result" | `context.${V["fieldPaths"]}` | "result.kind" | "result.returnValue" | `result.returnValue.${string}` | "result.error">;
 export type RetryOption = {
     /** Whether to retry the action if it fails.
      * If true, it will use the default retry behavior.
@@ -298,22 +347,13 @@ export type WorkpoolRetryOptions = {
      */
     retryActionsByDefault?: boolean;
 };
-export type SchedulerOptions = {
-    /**
-     * The time (ms since epoch) to run the action at.
-     * If not provided, the action will be run as soon as possible.
-     * Note: this is advisory only. It may run later.
-     */
-    runAt?: number;
-} | {
+export type EnqueueOptions = {
     /**
-     * The number of milliseconds to run the action after.
-     * If not provided, the action will be run as soon as possible.
-     * Note: this is advisory only. It may run later.
+     * The name of the function. By default, if you pass in api.foo.bar.baz,
+     * it will use "foo/bar:baz" as the name. If you pass in a function handle,
+     * it will use the function handle directly.
      */
-    runAfter?: number;
-};
-export type CallbackOptions = {
+    name?: string;
     /**
      * A mutation to run after the function succeeds, fails, or is canceled.
      * The context type is for your use, feel free to provide a validator for it.
@@ -343,7 +383,21 @@ export type CallbackOptions = {
      * Useful for passing data from the enqueue site to the onComplete site.
      */
     context?: unknown;
-};
+} & ({
+    /**
+     * The time (ms since epoch) to run the action at.
+     * If not provided, the action will be run as soon as possible.
+     * Note: this is advisory only. It may run later.
+     */
+    runAt?: number;
+} | {
+    /**
+     * The number of milliseconds to run the action after.
+     * If not provided, the action will be run as soon as possible.
+     * Note: this is advisory only. It may run later.
+     */
+    runAfter?: number;
+});
 export type OnCompleteArgs = {
     /**
      * The ID of the work that completed.
@@ -359,4 +413,14 @@ export type OnCompleteArgs = {
      */
     result: RunResult;
 };
+export declare function enqueueBatch<FnType extends FunctionType, Args extends DefaultFunctionArgs, ReturnType>(component: UseApi<Mounts>, ctx: RunMutationCtx, fnType: FnType, fn: FunctionReference<FnType, FunctionVisibility, Args, ReturnType>, fnArgsArray: Array<Args>, options: EnqueueOptions & {
+    retryBehavior?: RetryBehavior;
+    maxParallelism?: number;
+    logLevel?: LogLevel;
+}): Promise<WorkId[]>;
+export declare function enqueue<FnType extends FunctionType, Args extends DefaultFunctionArgs, ReturnType>(component: UseApi<Mounts>, ctx: RunMutationCtx, fnType: FnType, fn: FunctionReference<FnType, FunctionVisibility, Args, ReturnType>, fnArgs: Args, options: EnqueueOptions & {
+    retryBehavior?: RetryBehavior;
+    maxParallelism?: number;
+    logLevel?: LogLevel;
+}): Promise<WorkId>;
 //# sourceMappingURL=index.d.ts.map

package/dist/commonjs/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"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"}