@convex-dev/workpool 0.1.3-alpha.0 → 0.2.0-beta.0

package/dist/commonjs/component/shared.d.ts

@@ -0,0 +1,130 @@
+import { Infer } from "convex/values";
+import { Logger } from "./logging.js";
+export declare const SECOND = 1000;
+export declare const MINUTE: number;
+export declare const HOUR: number;
+export declare const DAY: number;
+export declare const YEAR: number;
+export declare function toSegment(ms: number): bigint;
+export declare function currentSegment(): bigint;
+export declare function nextSegment(): bigint;
+export declare function fromSegment(segment: bigint): number;
+export declare const config: import("convex/values").VObject<{
+    maxParallelism: number;
+    logLevel: "DEBUG" | "INFO" | "WARN" | "ERROR";
+}, {
+    maxParallelism: import("convex/values").VFloat64<number, "required">;
+    logLevel: import("convex/values").VUnion<"DEBUG" | "INFO" | "WARN" | "ERROR", [import("convex/values").VLiteral<"DEBUG", "required">, import("convex/values").VLiteral<"INFO", "required">, import("convex/values").VLiteral<"WARN", "required">, import("convex/values").VLiteral<"ERROR", "required">], "required", never>;
+}, "required", "maxParallelism" | "logLevel">;
+export type Config = Infer<typeof config>;
+export declare const retryBehavior: import("convex/values").VObject<{
+    maxAttempts: number;
+    initialBackoffMs: number;
+    base: number;
+}, {
+    maxAttempts: import("convex/values").VFloat64<number, "required">;
+    initialBackoffMs: import("convex/values").VFloat64<number, "required">;
+    base: import("convex/values").VFloat64<number, "required">;
+}, "required", "maxAttempts" | "initialBackoffMs" | "base">;
+export type RetryBehavior = {
+    /**
+     * The maximum number of attempts to make. 2 means one retry.
+     */
+    maxAttempts: number;
+    /**
+     * The initial backoff time in milliseconds. 100 means wait 100ms before the
+     * first retry.
+     */
+    initialBackoffMs: number;
+    /**
+     * The base for the backoff. 2 means double the backoff each time.
+     * e.g. if the initial backoff is 100ms, and the base is 2, then the first
+     * retry will wait 200ms, the second will wait 400ms, etc.
+     */
+    base: number;
+};
+export declare const runResult: import("convex/values").VUnion<{
+    kind: "success";
+    returnValue: any;
+} | {
+    kind: "failed";
+    error: string;
+} | {
+    kind: "canceled";
+}, [import("convex/values").VObject<{
+    kind: "success";
+    returnValue: any;
+}, {
+    kind: import("convex/values").VLiteral<"success", "required">;
+    returnValue: import("convex/values").VAny<any, "required", string>;
+}, "required", "kind" | "returnValue" | `returnValue.${string}`>, import("convex/values").VObject<{
+    kind: "failed";
+    error: string;
+}, {
+    kind: import("convex/values").VLiteral<"failed", "required">;
+    error: import("convex/values").VString<string, "required">;
+}, "required", "kind" | "error">, import("convex/values").VObject<{
+    kind: "canceled";
+}, {
+    kind: import("convex/values").VLiteral<"canceled", "required">;
+}, "required", "kind">], "required", "kind" | "returnValue" | `returnValue.${string}` | "error">;
+export type RunResult = Infer<typeof runResult>;
+export declare const onComplete: import("convex/values").VObject<{
+    context?: any;
+    fnHandle: string;
+}, {
+    fnHandle: import("convex/values").VString<string, "required">;
+    context: import("convex/values").VAny<any, "optional", string>;
+}, "required", "fnHandle" | "context" | `context.${string}`>;
+export type OnComplete = Infer<typeof onComplete>;
+export type OnCompleteArgs = {
+    /**
+     * The ID of the work that completed.
+     */
+    workId: string;
+    /**
+     * The context object passed when enqueuing the work.
+     * Useful for passing data from the enqueue site to the onComplete site.
+     */
+    context: unknown;
+    /**
+     * The result of the run that completed.
+     */
+    result: RunResult;
+};
+export declare const status: import("convex/values").VUnion<{
+    state: "pending";
+    attempt: number;
+} | {
+    state: "running";
+    attempt: number;
+} | {
+    state: "finished";
+}, [import("convex/values").VUnion<{
+    state: "pending";
+    attempt: number;
+} | {
+    state: "running";
+    attempt: number;
+} | {
+    state: "finished";
+}, [import("convex/values").VObject<{
+    state: "pending";
+    attempt: number;
+}, {
+    state: import("convex/values").VLiteral<"pending", "required">;
+    attempt: import("convex/values").VFloat64<number, "required">;
+}, "required", "state" | "attempt">, import("convex/values").VObject<{
+    state: "running";
+    attempt: number;
+}, {
+    state: import("convex/values").VLiteral<"running", "required">;
+    attempt: import("convex/values").VFloat64<number, "required">;
+}, "required", "state" | "attempt">, import("convex/values").VObject<{
+    state: "finished";
+}, {
+    state: import("convex/values").VLiteral<"finished", "required">;
+}, "required", "state">], "required", "state" | "attempt">], "required", "state" | "attempt">;
+export type Status = Infer<typeof status>;
+export declare function boundScheduledTime(ms: number, console: Logger): number;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commonjs/component/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/component/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,OAAO,EAAE,MAAM,EAAY,MAAM,cAAc,CAAC;AAGhD,eAAO,MAAM,MAAM,OAAO,CAAC;AAC3B,eAAO,MAAM,MAAM,QAAc,CAAC;AAClC,eAAO,MAAM,IAAI,QAAc,CAAC;AAChC,eAAO,MAAM,GAAG,QAAY,CAAC;AAC7B,eAAO,MAAM,IAAI,QAAY,CAAC;AAE9B,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,eAAO,MAAM,MAAM;;;;;;6CAGjB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE1C,eAAO,MAAM,aAAa;;;;;;;;2DAIxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAIF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;gGAYrB,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAEhD,eAAO,MAAM,UAAU;;;;;;4DAGrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6FAclB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE1C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAatE"}

package/dist/commonjs/component/shared.js

@@ -0,0 +1,65 @@
+import { v } from "convex/values";
+import { logLevel } from "./logging.js";
+const SEGMENT_MS = 250;
+export const SECOND = 1000;
+export const MINUTE = 60 * SECOND;
+export const HOUR = 60 * MINUTE;
+export const DAY = 24 * HOUR;
+export const YEAR = 365 * DAY;
+export function toSegment(ms) {
+    return BigInt(Math.floor(ms / SEGMENT_MS));
+}
+export function currentSegment() {
+    return toSegment(Date.now());
+}
+export function nextSegment() {
+    return toSegment(Date.now()) + 1n;
+}
+export function fromSegment(segment) {
+    return Number(segment) * SEGMENT_MS;
+}
+export const config = v.object({
+    maxParallelism: v.number(),
+    logLevel,
+});
+export const retryBehavior = v.object({
+    maxAttempts: v.number(),
+    initialBackoffMs: v.number(),
+    base: v.number(),
+});
+// This ensures that the type satisfies the schema.
+const _ = {};
+export const runResult = v.union(v.object({
+    kind: v.literal("success"),
+    returnValue: v.any(),
+}), v.object({
+    kind: v.literal("failed"),
+    error: v.string(),
+}), v.object({
+    kind: v.literal("canceled"),
+}));
+export const onComplete = v.object({
+    fnHandle: v.string(),
+    context: v.optional(v.any()),
+});
+export const status = v.union(v.union(v.object({
+    state: v.literal("pending"),
+    attempt: v.number(),
+}), v.object({
+    state: v.literal("running"),
+    attempt: v.number(),
+}), v.object({
+    state: v.literal("finished"),
+})));
+export function boundScheduledTime(ms, console) {
+    if (ms < Date.now() - YEAR) {
+        console.warn("runAt is too far in the past, defaulting to now", ms);
+        return Date.now();
+    }
+    if (ms > Date.now() + 4 * YEAR) {
+        console.warn("runAt is too far in the future, defaulting to 1 year from now", ms);
+        return Date.now() + YEAR;
+    }
+    return ms;
+}
+//# sourceMappingURL=shared.js.map

package/dist/commonjs/component/shared.js.map

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

package/dist/commonjs/component/stats.d.ts

@@ -17,7 +17,8 @@ workpool
 
  */
 export declare function recordStarted(work: Doc<"work">): string;
-export declare function recordCompleted(work: Doc<"work">, status: "success" | "error" | "canceled" | "timeout"): string;
+export declare function recordCompleted(work: Doc<"work">, status: "success" | "failed" | "canceled"): string;
+export declare function recordReport(state: Doc<"internalState">): string;
 /**
  * Warning: this should not be used from a mutation, as it will cause conflicts.
  * Use this to debug or diagnose your queue length when it's backed up.
@@ -29,7 +30,7 @@ export declare const queueLength: import("convex/server").RegisteredQuery<"inter
  */
 export declare const debugCounts: import("convex/server").RegisteredQuery<"internal", {}, Promise<{
     pendingStart: any;
-    inProgressWork: any;
+    inProgressWork: number;
     pendingCompletion: any;
     pendingCancelation: any;
     active: number;

package/dist/commonjs/component/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/component/stats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAGhD;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CASvD;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GACnD,MAAM,CASR;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,uEAOtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;GAwBtB,CAAC"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/component/stats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAGhD;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CASvD;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GACxC,MAAM,CASR;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,eAAe,CAAC,GAAG,MAAM,CAahE;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,uEAOtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;GAuBtB,CAAC"}

package/dist/commonjs/component/stats.js

@@ -37,6 +37,20 @@ export function recordCompleted(work, status) {
         lagSinceEnqueued: Date.now() - work._creationTime,
     });
 }
+export function recordReport(state) {
+    const { completed, succeeded, failed, retries, canceled } = state.report;
+    const withoutRetries = completed - retries;
+    return JSON.stringify({
+        event: "report",
+        completed,
+        succeeded,
+        failed,
+        retries,
+        canceled,
+        failureRate: completed ? (failed + retries) / completed : 0,
+        permanentFailureRate: withoutRetries ? failed / withoutRetries : 0,
+    });
+}
 /**
  * Warning: this should not be used from a mutation, as it will cause conflicts.
  * Use this to debug or diagnose your queue length when it's backed up.
@@ -57,19 +71,19 @@ export const debugCounts = internalQuery({
     args: {},
     returns: v.any(),
     handler: async (ctx) => {
+        const inProgressWork = (await ctx.db.query("internalState").unique())?.running.length ?? 0;
         /* eslint-disable @typescript-eslint/no-explicit-any */
-        const inProgressWork = await ctx.db.query("inProgressWork").count();
         const pendingStart = await ctx.db.query("pendingStart").count();
         const pendingCompletion = await ctx.db.query("pendingCompletion").count();
         const pendingCancelation = await ctx.db.query("pendingCancelation").count();
+        /* eslint-enable @typescript-eslint/no-explicit-any */
         return {
             pendingStart,
             inProgressWork,
             pendingCompletion,
             pendingCancelation,
-            active: inProgressWork - pendingCompletion - pendingCancelation,
+            active: inProgressWork - pendingCompletion,
         };
-        /* eslint-enable @typescript-eslint/no-explicit-any */
     },
 });
 //# sourceMappingURL=stats.js.map

package/dist/commonjs/component/stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/component/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AAEH,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,GAAG;QAChB,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,aAAa;QAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa;KAClD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAiB,EACjB,MAAoD;IAEpD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,GAAG;QAChB,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,MAAM;QACN,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa;KAClD,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,8DAA8D;QAC9D,OAAQ,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAS,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;CACF,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;IAChB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,uDAAuD;QACvD,MAAM,cAAc,GAAG,MACrB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAC9B,CAAC,KAAK,EAAE,CAAC;QACV,MAAM,YAAY,GAAG,MAAO,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAS,CAAC,KAAK,EAAE,CAAC;QACzE,MAAM,iBAAiB,GAAG,MACxB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CACjC,CAAC,KAAK,EAAE,CAAC;QACV,MAAM,kBAAkB,GAAG,MACzB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAClC,CAAC,KAAK,EAAE,CAAC;QACV,OAAO;YACL,YAAY;YACZ,cAAc;YACd,iBAAiB;YACjB,kBAAkB;YAClB,MAAM,EAAE,cAAc,GAAG,iBAAiB,GAAG,kBAAkB;SAChE,CAAC;QACF,sDAAsD;IACxD,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/component/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AAEH,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,GAAG;QAChB,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,IAAI,CAAC,aAAa;QAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa;KAClD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAiB,EACjB,MAAyC;IAEzC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,GAAG;QAChB,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,MAAM;QACN,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa;KAClD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA2B;IACtD,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;IACzE,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,CAAC;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK,EAAE,QAAQ;QACf,SAAS;QACT,SAAS;QACT,MAAM;QACN,OAAO;QACP,QAAQ;QACR,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3D,oBAAoB,EAAE,cAAc,CAAC,CAAC,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;KACnE,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,8DAA8D;QAC9D,OAAQ,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAS,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;CACF,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;IAChB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,cAAc,GAClB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QACtE,uDAAuD;QACvD,MAAM,YAAY,GAAG,MAAO,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAS,CAAC,KAAK,EAAE,CAAC;QACzE,MAAM,iBAAiB,GAAG,MACxB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CACjC,CAAC,KAAK,EAAE,CAAC;QACV,MAAM,kBAAkB,GAAG,MACzB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAClC,CAAC,KAAK,EAAE,CAAC;QACV,sDAAsD;QACtD,OAAO;YACL,YAAY;YACZ,cAAc;YACd,iBAAiB;YACjB,kBAAkB;YAClB,MAAM,EAAE,cAAc,GAAG,iBAAiB;SAC3C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/commonjs/component/worker.d.ts

@@ -0,0 +1,25 @@
+export declare const runMutationWrapper: import("convex/server").RegisteredMutation<"internal", {
+    logLevel: "DEBUG" | "INFO" | "WARN" | "ERROR";
+    fnHandle: string;
+    workId: import("convex/values").GenericId<"work">;
+    fnArgs: any;
+}, Promise<void>>;
+export declare const runActionWrapper: import("convex/server").RegisteredAction<"internal", {
+    logLevel: "DEBUG" | "INFO" | "WARN" | "ERROR";
+    fnHandle: string;
+    workId: import("convex/values").GenericId<"work">;
+    fnArgs: any;
+}, Promise<void>>;
+export declare const saveResult: import("convex/server").RegisteredMutation<"internal", {
+    workId: import("convex/values").GenericId<"work">;
+    runResult: {
+        kind: "success";
+        returnValue: any;
+    } | {
+        kind: "failed";
+        error: string;
+    } | {
+        kind: "canceled";
+    };
+}, Promise<void>>;
+//# sourceMappingURL=worker.d.ts.map

package/dist/commonjs/component/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/component/worker.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,kBAAkB;;;;;iBA0B7B,CAAC;AASH,eAAO,MAAM,gBAAgB;;;;;iBA2B3B,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;iBAarB,CAAC"}

package/dist/commonjs/component/worker.js

@@ -0,0 +1,86 @@
+import { v } from "convex/values";
+import { internal } from "./_generated/api.js";
+import { internalAction, internalMutation } from "./_generated/server.js";
+import { kickMainLoop } from "./kick.js";
+import { createLogger, logLevel } from "./logging.js";
+import { nextSegment, runResult } from "./shared.js";
+export const runMutationWrapper = internalMutation({
+    args: {
+        workId: v.id("work"),
+        fnHandle: v.string(),
+        fnArgs: v.any(),
+        logLevel,
+    },
+    handler: async (ctx, { workId, fnHandle: handleStr, fnArgs, logLevel }) => {
+        const console = createLogger(logLevel);
+        const fnHandle = handleStr;
+        try {
+            const returnValue = await ctx.runMutation(fnHandle, fnArgs);
+            // NOTE: we could run the `saveResult` handler here, or call `ctx.runMutation`,
+            // but we want the mutation to be a separate transaction to reduce the window for OCCs.
+            await ctx.scheduler.runAfter(0, internal.worker.saveResult, {
+                workId,
+                runResult: { kind: "success", returnValue },
+            });
+        }
+        catch (e) {
+            console.error(e);
+            await ctx.scheduler.runAfter(0, internal.worker.saveResult, {
+                workId,
+                runResult: { kind: "failed", error: formatError(e) },
+            });
+        }
+    },
+});
+function formatError(e) {
+    if (e instanceof Error) {
+        return e.message;
+    }
+    return String(e);
+}
+export const runActionWrapper = internalAction({
+    args: {
+        workId: v.id("work"),
+        fnHandle: v.string(),
+        fnArgs: v.any(),
+        logLevel,
+    },
+    handler: async (ctx, { workId, fnHandle: handleStr, fnArgs, logLevel }) => {
+        const console = createLogger(logLevel);
+        const fnHandle = handleStr;
+        try {
+            const returnValue = await ctx.runAction(fnHandle, fnArgs);
+            // NOTE: we could run `ctx.runMutation`, but we want to guarantee execution,
+            // and `ctx.scheduler.runAfter` won't OCC.
+            await ctx.scheduler.runAfter(0, internal.worker.saveResult, {
+                workId,
+                runResult: { kind: "success", returnValue },
+            });
+        }
+        catch (e) {
+            console.error(e);
+            // We let the main loop handle the retries.
+            await ctx.scheduler.runAfter(0, internal.worker.saveResult, {
+                workId,
+                runResult: { kind: "failed", error: formatError(e) },
+            });
+        }
+    },
+});
+export const saveResult = internalMutation({
+    args: {
+        workId: v.id("work"),
+        runResult,
+    },
+    handler: async (ctx, { workId, runResult }) => {
+        await ctx.db.insert("pendingCompletion", {
+            runResult,
+            workId,
+            segment: nextSegment(),
+        });
+        await kickMainLoop(ctx, "saveResult");
+    },
+});
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const console = "THIS IS A REMINDER TO USE createLogger";
+//# sourceMappingURL=worker.js.map

package/dist/commonjs/component/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/component/worker.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;IACjD,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE;QACf,QAAQ;KACT;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;QACxE,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,SAAuC,CAAC;QACzD,IAAI;YACF,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5D,+EAA+E;YAC/E,uFAAuF;YACvF,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE;gBAC1D,MAAM;gBACN,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE;aAC5C,CAAC,CAAC;SACJ;QAAC,OAAO,CAAU,EAAE;YACnB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjB,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE;gBAC1D,MAAM;gBACN,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE;aACrD,CAAC,CAAC;SACJ;IACH,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,WAAW,CAAC,CAAU;IAC7B,IAAI,CAAC,YAAY,KAAK,EAAE;QACtB,OAAO,CAAC,CAAC,OAAO,CAAC;KAClB;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;IAC7C,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE;QACf,QAAQ;KACT;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;QACxE,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,SAAqC,CAAC;QACvD,IAAI;YACF,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC1D,4EAA4E;YAC5E,0CAA0C;YAC1C,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE;gBAC1D,MAAM;gBACN,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE;aAC5C,CAAC,CAAC;SACJ;QAAC,OAAO,CAAU,EAAE;YACnB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjB,2CAA2C;YAC3C,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE;gBAC1D,MAAM;gBACN,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE;aACrD,CAAC,CAAC;SACJ;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAC;IACzC,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;QACpB,SAAS;KACV;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;QAC5C,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,mBAAmB,EAAE;YACvC,SAAS;YACT,MAAM;YACN,OAAO,EAAE,WAAW,EAAE;SACvB,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,OAAO,GAAG,wCAAwC,CAAC"}

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

@@ -1,53 +1,141 @@
-import { DefaultFunctionArgs, Expand, FunctionReference, FunctionVisibility, GenericDataModel, GenericMutationCtx, GenericQueryCtx } from "convex/server";
-import { GenericId } from "convex/values";
-import { api } from "../component/_generated/api.js";
-import { LogLevel } from "../component/logging.js";
-import { completionStatus, type CompletionStatus } from "../component/schema.js";
-export { completionStatus, type CompletionStatus };
-export type WorkId = string;
+import { DefaultFunctionArgs, FunctionReference, FunctionVisibility } from "convex/server";
+import { VString } from "convex/values";
+import { Mounts } from "../component/_generated/api.js";
+import { runResult as runResultValidator, RunResult, type RetryBehavior, Status } from "../component/shared.js";
+import { type LogLevel } from "../component/logging.js";
+import { RunMutationCtx, RunQueryCtx, UseApi } from "./utils.js";
+export { runResultValidator, type RunResult };
+export declare const DEFAULT_RETRY_BEHAVIOR: RetryBehavior;
+export type WorkId = string & {
+    __isWorkId: true;
+};
+export declare const workIdValidator: VString<WorkId, "required">;
 export declare class Workpool {
     private component;
     private options;
-    constructor(component: UseApi<typeof api>, options: {
+    /**
+     * Initializes a Workpool.
+     *
+     * Note: if you want different pools, you need to *create different instances*
+     * of Workpool in convex.config.ts. It isn't sufficient to have different
+     * instances of this class.
+     *
+     * @param component - The component to use, like `components.workpool` from
+     *   `./_generated/api.ts`.
+     * @param options - The options for the Workpool.
+     */
+    constructor(component: UseApi<Mounts>, // UseApi<api> for jump to definition
+    options: {
         /** How many actions/mutations can be running at once within this pool.
          * Min 1, Max 300.
          */
-        maxParallelism: number;
-        /** How much to log.
-         * Default WARN.
+        maxParallelism?: number;
+        /** How much to log. This is updated on each call to `enqueue*`,
+         * `status`, or `cancel*`.
+         * Default is WARN.
          * With INFO, you can see events for started and completed work, which can
-         * be parsed.
+         * be parsed by tools like [Axiom](https://axiom.co) for monitoring.
          * With DEBUG, you can see timers and internal events for work being
          * scheduled.
          */
         logLevel?: LogLevel;
-        /** How long to keep completed work in the database, for access by `status`.
-         * Default 1 day.
+        /** Default retry behavior for enqueued actions. */
+        defaultRetryBehavior?: RetryBehavior;
+        /** Whether to retry actions that fail by default. Default: false.
+         * NOTE: Only do this if your actions are idempotent.
+         * See the docs (README.md) for more details.
          */
-        statusTtl?: number;
+        retryActionsByDefault?: boolean;
     });
-    enqueueAction<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"action", FunctionVisibility, Args, ReturnType>, fnArgs: Args): Promise<WorkId>;
-    enqueueMutation<Args extends DefaultFunctionArgs, ReturnType>(ctx: RunMutationCtx, fn: FunctionReference<"mutation", FunctionVisibility, Args, ReturnType>, fnArgs: Args): Promise<WorkId>;
+    /**
+     * Enqueues an action to be run.
+     *
+     * @param ctx - The mutation or action context that can call ctx.runMutation.
+     * @param fn - The action to run, like `internal.example.myAction`.
+     * @param fnArgs - The arguments to pass to the action.
+     * @param options - The options for the action to specify retry behavior,
+     *   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?: {
+        /** Whether to retry the action if it fails.
+         * If true, it will use the default retry behavior.
+         * If custom behavior is provided, it will retry using that behavior.
+         * If unset, it will use the Workpool's configured default.
+         */
+        retry?: boolean | RetryBehavior;
+    } & CallbackOptions & SchedulerOptions): Promise<WorkId>;
+    /**
+     * Enqueues a mutation to be run.
+     *
+     * Note: mutations are not retried by the workpool. Convex automatically
+     * retries them on database conflicts and transient failures.
+     * Because they're deterministic, external retries don't provide any benefit.
+     *
+     * @param ctx - The mutation or action context that can call ctx.runMutation.
+     * @param fn - The mutation to run, like `internal.example.myMutation`.
+     * @param fnArgs - The arguments to pass to the mutation.
+     * @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): Promise<WorkId>;
     cancel(ctx: RunMutationCtx, id: WorkId): Promise<void>;
-    status(ctx: RunQueryCtx, id: WorkId): Promise<{
-        kind: "pending";
-    } | {
-        kind: "inProgress";
-    } | {
-        kind: "completed";
-        completionStatus: CompletionStatus;
-    }>;
+    cancelAll(ctx: RunMutationCtx): Promise<void>;
+    status(ctx: RunQueryCtx, id: WorkId): Promise<Status>;
 }
-type RunQueryCtx = {
-    runQuery: GenericQueryCtx<GenericDataModel>["runQuery"];
+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;
+} | {
+    /**
+     * 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 CallbackOptions = {
+    /**
+     * 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.
+     * e.g.
+     * ```ts
+     * export const completion = internalMutation({
+     *  args: {
+     *    workId: workIdValidator,
+     *    context: v.any(),
+     *    result: runResult,
+     *  },
+     *  handler: async (ctx, args) => {
+     *    console.log(args.result, "Got Context back -> ", args.context, Date.now() - args.context);
+     *  },
+     * });
+     * ```
+     */
+    onComplete?: FunctionReference<"mutation", FunctionVisibility, OnCompleteArgs> | null;
+    /**
+     * A context object to pass to the `onComplete` mutation.
+     * Useful for passing data from the enqueue site to the onComplete site.
+     */
+    context?: unknown;
 };
-type RunMutationCtx = {
-    runMutation: GenericMutationCtx<GenericDataModel>["runMutation"];
+export type OnCompleteArgs = {
+    /**
+     * The ID of the work that completed.
+     */
+    workId: WorkId;
+    /**
+     * The context object passed when enqueuing the work.
+     * Useful for passing data from the enqueue site to the onComplete site.
+     */
+    context: unknown;
+    /**
+     * The result of the run that completed.
+     */
+    result: RunResult;
 };
-export type OpaqueIds<T> = T extends GenericId<infer _T> ? string : T extends (infer U)[] ? OpaqueIds<U>[] : T extends object ? {
-    [K in keyof T]: OpaqueIds<T[K]>;
-} : T;
-export type UseApi<API> = Expand<{
-    [mod in keyof API]: API[mod] extends FunctionReference<infer FType, "public", infer FArgs, infer FReturnType, infer FComponentPath> ? FunctionReference<FType, "internal", OpaqueIds<FArgs>, OpaqueIds<FReturnType>, FComponentPath> : UseApi<API[mod]>;
-}>;
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/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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"}