@convex-dev/workos-authkit 0.1.7 → 0.2.0

package/dist/component/_generated/component.d.ts

@@ -19,16 +19,14 @@ import type { FunctionReference } from "convex/server";
  * ```
  */
 export type ComponentApi<Name extends string | undefined = string | undefined> = {
-    lib: {
-        enqueueWebhookEvent: FunctionReference<"mutation", "internal", {
+    backfill: {
+        startBackfill: FunctionReference<"mutation", "internal", {
             apiKey: string;
-            event: string;
-            eventId: string;
-            eventTypes?: Array<string>;
             logLevel?: "DEBUG";
             onEventHandle?: string;
-            updatedAt?: string;
-        }, any, Name>;
+        }, null, Name>;
+    };
+    lib: {
         getAuthUser: FunctionReference<"query", "internal", {
             id: string;
         }, {
@@ -45,6 +43,19 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
             profilePictureUrl?: null | string;
             updatedAt: string;
         } | null, Name>;
+        onWebhookEvent: FunctionReference<"mutation", "internal", {
+            apiKey: string;
+            event: {
+                context?: Record<string, any>;
+                createdAt: string;
+                data: Record<string, any>;
+                event: string;
+                id: string;
+            };
+            eventTypes?: Array<string>;
+            logLevel?: "DEBUG";
+            onEventHandle?: string;
+        }, null, Name>;
     };
 };
 //# sourceMappingURL=component.d.ts.map

package/dist/component/_generated/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/component.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,IAC3E;IACE,GAAG,EAAE;QACH,mBAAmB,EAAE,iBAAiB,CACpC,UAAU,EACV,UAAU,EACV;YACE,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;YACd,OAAO,EAAE,MAAM,CAAC;YAChB,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,EACD,GAAG,EACH,IAAI,CACL,CAAC;QACF,WAAW,EAAE,iBAAiB,CAC5B,OAAO,EACP,UAAU,EACV;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,EACd;YACE,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,aAAa,EAAE,OAAO,CAAC;YACvB,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YAC3B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YAC1B,EAAE,EAAE,MAAM,CAAC;YACX,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YACzB,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YAC7B,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC9B,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YAClC,SAAS,EAAE,MAAM,CAAC;SACnB,GAAG,IAAI,EACR,IAAI,CACL,CAAC;KACH,CAAC;CACH,CAAC"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/component.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,IAC3E;IACE,QAAQ,EAAE;QACR,aAAa,EAAE,iBAAiB,CAC9B,UAAU,EACV,UAAU,EACV;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,aAAa,CAAC,EAAE,MAAM,CAAA;SAAE,EAC9D,IAAI,EACJ,IAAI,CACL,CAAC;KACH,CAAC;IACF,GAAG,EAAE;QACH,WAAW,EAAE,iBAAiB,CAC5B,OAAO,EACP,UAAU,EACV;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,EACd;YACE,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,aAAa,EAAE,OAAO,CAAC;YACvB,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YAC3B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YAC1B,EAAE,EAAE,MAAM,CAAC;YACX,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YACzB,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YAC7B,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC9B,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;YAClC,SAAS,EAAE,MAAM,CAAC;SACnB,GAAG,IAAI,EACR,IAAI,CACL,CAAC;QACF,cAAc,EAAE,iBAAiB,CAC/B,UAAU,EACV,UAAU,EACV;YACE,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,EAAE;gBACL,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAC9B,SAAS,EAAE,MAAM,CAAC;gBAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAC1B,KAAK,EAAE,MAAM,CAAC;gBACd,EAAE,EAAE,MAAM,CAAC;aACZ,CAAC;YACF,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,aAAa,CAAC,EAAE,MAAM,CAAC;SACxB,EACD,IAAI,EACJ,IAAI,CACL,CAAC;KACH,CAAC;CACH,CAAC"}

package/dist/component/backfill.d.ts

@@ -0,0 +1,60 @@
+export declare const getBackfillApiKey: import("convex/server").RegisteredQuery<"internal", {}, Promise<string | null>>;
+/** Fetches one page of users from WorkOS and upserts them, returning only the cursor. */
+export declare const processUsersPage: import("convex/server").RegisteredAction<"internal", {
+    logLevel?: "DEBUG" | undefined;
+    onEventHandle?: string | undefined;
+    after?: string | undefined;
+}, Promise<{
+    nextCursor: string | undefined;
+}>>;
+export declare const upsertUsersPage: import("convex/server").RegisteredMutation<"internal", {
+    logLevel?: "DEBUG" | undefined;
+    onEventHandle?: string | undefined;
+    users: {
+        firstName?: string | null | undefined;
+        lastName?: string | null | undefined;
+        profilePictureUrl?: string | null | undefined;
+        lastSignInAt?: string | null | undefined;
+        externalId?: string | null | undefined;
+        locale?: string | null | undefined;
+        id: string;
+        updatedAt: string;
+        email: string;
+        emailVerified: boolean;
+        metadata: Record<string, any>;
+        createdAt: string;
+    }[];
+}, Promise<null>>;
+export declare const backfillBatch: import("convex/server").RegisteredMutation<"internal", {
+    fn: "You should not call this directly, call workflow.start instead";
+    args: {
+        logLevel?: "DEBUG" | undefined;
+        onEventHandle?: string | undefined;
+        after?: string | undefined;
+    };
+}, {
+    cursor?: string | undefined;
+    done: boolean;
+}>;
+export declare const backfillOnComplete: import("convex/server").RegisteredMutation<"internal", {
+    result: {
+        kind: "success";
+        returnValue: any;
+    } | {
+        kind: "failed";
+        error: string;
+    } | {
+        kind: "canceled";
+    };
+    workflowId: string;
+    context: {
+        logLevel?: "DEBUG" | undefined;
+        onEventHandle?: string | undefined;
+    };
+}, Promise<null>>;
+export declare const startBackfill: import("convex/server").RegisteredMutation<"public", {
+    logLevel?: "DEBUG" | undefined;
+    onEventHandle?: string | undefined;
+    apiKey: string;
+}, Promise<null>>;
+//# sourceMappingURL=backfill.d.ts.map

package/dist/component/backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../src/component/backfill.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,iBAAiB,iFAO5B,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,gBAAgB;;;;;gBAYF,MAAM,GAAG,SAAS;GA0B3C,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;iBAqC1B,CAAC;AAIH,eAAO,MAAM,aAAa;;;;;;;;;;EAiCxB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;iBA4C7B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;iBAwBxB,CAAC"}

package/dist/component/backfill.js

@@ -0,0 +1,171 @@
+import { v } from "convex/values";
+import { internalAction, internalMutation, internalQuery, mutation, } from "./_generated/server.js";
+import { components, internal } from "./_generated/api.js";
+import { WorkOS } from "@workos-inc/node";
+import { WorkflowManager } from "@convex-dev/workflow";
+import { vResultValidator } from "@convex-dev/workpool";
+import schema from "./schema.js";
+const workflow = new WorkflowManager(components.backfillWorkflow, {
+    workpoolOptions: { maxParallelism: 1 },
+});
+const vUser = schema.tables.users.validator;
+export const getBackfillApiKey = internalQuery({
+    args: {},
+    returns: v.union(v.string(), v.null()),
+    handler: async (ctx) => {
+        const backfillState = await ctx.db.query("backfillState").unique();
+        return backfillState?.apiKey ?? null;
+    },
+});
+/** Fetches one page of users from WorkOS and upserts them, returning only the cursor. */
+export const processUsersPage = internalAction({
+    args: {
+        after: v.optional(v.string()),
+        onEventHandle: v.optional(v.string()),
+        logLevel: v.optional(v.literal("DEBUG")),
+    },
+    returns: v.object({
+        nextCursor: v.optional(v.string()),
+    }),
+    handler: async (ctx, args) => {
+        const apiKey = await ctx.runQuery(internal.backfill.getBackfillApiKey, {});
+        if (!apiKey) {
+            throw new Error("Backfill API key not found");
+        }
+        const workos = new WorkOS(apiKey);
+        const { data, listMetadata } = await workos.userManagement.listUsers({
+            limit: 100,
+            after: args.after,
+            order: "asc",
+        });
+        const users = data.map(({ object: _object, ...rest }) => rest);
+        if (users.length > 0) {
+            await ctx.runMutation(internal.backfill.upsertUsersPage, {
+                users,
+                onEventHandle: args.onEventHandle,
+                logLevel: args.logLevel,
+            });
+        }
+        return {
+            nextCursor: listMetadata.after ?? undefined,
+        };
+    },
+});
+export const upsertUsersPage = internalMutation({
+    args: {
+        users: v.array(vUser),
+        onEventHandle: v.optional(v.string()),
+        logLevel: v.optional(v.literal("DEBUG")),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const existingUsers = await Promise.all(args.users.map((user) => ctx.db
+            .query("users")
+            .withIndex("id", (q) => q.eq("id", user.id))
+            .unique()));
+        const newUsers = args.users.filter((_, i) => !existingUsers[i]);
+        if (args.logLevel === "DEBUG") {
+            console.log(`backfill: ${newUsers.length} new users out of ${args.users.length}`);
+        }
+        for (const user of newUsers) {
+            await ctx.db.insert("users", user);
+            if (args.onEventHandle) {
+                await ctx.runMutation(args.onEventHandle, { event: "user.created", data: { ...user, object: "user" } });
+            }
+        }
+        return null;
+    },
+});
+const MAX_PAGES_PER_BATCH = 50;
+export const backfillBatch = workflow.define({
+    args: {
+        onEventHandle: v.optional(v.string()),
+        logLevel: v.optional(v.literal("DEBUG")),
+        after: v.optional(v.string()),
+    },
+    returns: v.object({
+        done: v.boolean(),
+        cursor: v.optional(v.string()),
+    }),
+    handler: async (step, args) => {
+        let cursor = args.after;
+        let pagesProcessed = 0;
+        while (pagesProcessed < MAX_PAGES_PER_BATCH) {
+            const result = await step.runAction(internal.backfill.processUsersPage, {
+                after: cursor,
+                onEventHandle: args.onEventHandle,
+                logLevel: args.logLevel,
+            });
+            cursor = result.nextCursor;
+            pagesProcessed++;
+            if (!cursor) {
+                return { done: true };
+            }
+        }
+        return { done: false, cursor };
+    },
+});
+export const backfillOnComplete = internalMutation({
+    args: {
+        workflowId: v.string(),
+        result: vResultValidator,
+        context: v.object({
+            onEventHandle: v.optional(v.string()),
+            logLevel: v.optional(v.literal("DEBUG")),
+        }),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        if (args.result.kind !== "success") {
+            console.error(`Backfill workflow ${args.result.kind}`, args.result);
+            const backfillState = await ctx.db.query("backfillState").unique();
+            if (backfillState) {
+                await ctx.db.delete(backfillState._id);
+            }
+            return null;
+        }
+        const returnValue = args.result.returnValue;
+        if (returnValue.done || !returnValue.cursor) {
+            const backfillState = await ctx.db.query("backfillState").unique();
+            if (backfillState) {
+                await ctx.db.delete(backfillState._id);
+            }
+        }
+        else {
+            await workflow.start(ctx, internal.backfill.backfillBatch, {
+                ...args.context,
+                after: returnValue.cursor,
+            }, {
+                onComplete: internal.backfill.backfillOnComplete,
+                context: args.context,
+            });
+        }
+        return null;
+    },
+});
+export const startBackfill = mutation({
+    args: {
+        apiKey: v.string(),
+        onEventHandle: v.optional(v.string()),
+        logLevel: v.optional(v.literal("DEBUG")),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const existing = await ctx.db.query("backfillState").unique();
+        if (existing) {
+            console.warn("Backfill already in progress, skipping");
+            return null;
+        }
+        await ctx.db.insert("backfillState", { apiKey: args.apiKey });
+        const context = {
+            onEventHandle: args.onEventHandle,
+            logLevel: args.logLevel,
+        };
+        await workflow.start(ctx, internal.backfill.backfillBatch, context, {
+            onComplete: internal.backfill.backfillOnComplete,
+            context,
+        });
+        return null;
+    },
+});
+//# sourceMappingURL=backfill.js.map

package/dist/component/backfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.js","sourceRoot":"","sources":["../../src/component/backfill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,QAAQ,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,UAAU,CAAC,gBAAgB,EAAE;IAChE,eAAe,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE;CACvC,CAAC,CAAC;AAEH,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;AAE5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;IAC7C,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,OAAO,EAAE,KAAK,EAAE,GAAG,EAA0B,EAAE;QAC7C,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC;QACnE,OAAO,aAAa,EAAE,MAAM,IAAI,IAAI,CAAC;IACvC,CAAC;CACF,CAAC,CAAC;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;IAC7C,IAAI,EAAE;QACJ,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACrC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;KACzC;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACnC,CAAC;IACF,OAAO,EAAE,KAAK,EACZ,GAAG,EACH,IAAI,EACyC,EAAE;QAC/C,MAAM,MAAM,GAAkB,MAAM,GAAG,CAAC,QAAQ,CAC9C,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,EACnC,EAAE,CACH,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC;YACnE,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE;gBACvD,KAAK;gBACL,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;QACD,OAAO;YACL,UAAU,EAAE,YAAY,CAAC,KAAK,IAAI,SAAS;SAC5C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;IAC9C,IAAI,EAAE;QACJ,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QACrB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACrC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;KACzC;IACD,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACtB,GAAG,CAAC,EAAE;aACH,KAAK,CAAC,OAAO,CAAC;aACd,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;aAC3C,MAAM,EAAE,CACZ,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhE,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CACT,aAAa,QAAQ,CAAC,MAAM,qBAAqB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CACrE,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAEnC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,GAAG,CAAC,WAAW,CACnB,IAAI,CAAC,aAA2C,EAChD,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAC7D,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE;QACJ,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACrC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC9B;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;QACjB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC/B,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAA+C,EAAE;QACzE,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,OAAO,cAAc,GAAG,mBAAmB,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CACjC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,EAClC;gBACE,KAAK,EAAE,MAAM;gBACb,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CACF,CAAC;YAEF,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;YAC3B,cAAc,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACjC,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;IACjD,IAAI,EAAE;QACJ,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACrC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SACzC,CAAC;KACH;IACD,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACpE,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC;YACnE,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAG/B,CAAC;QACF,IAAI,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC;YACnE,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,CAAC,KAAK,CAClB,GAAG,EACH,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAC/B;gBACE,GAAG,IAAI,CAAC,OAAO;gBACf,KAAK,EAAE,WAAW,CAAC,MAAM;aAC1B,EACD;gBACE,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,kBAAkB;gBAChD,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CACF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC;IACpC,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACrC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;KACzC;IACD,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9D,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG;YACd,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;QACF,MAAM,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,EAAE;YAClE,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,kBAAkB;YAChD,OAAO;SACR,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC"}

package/dist/component/convex.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convex.config.d.ts","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,SAAS,kDAAmC,CAAC;AAInD,eAAe,SAAS,CAAC"}
+{"version":3,"file":"convex.config.d.ts","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,SAAS,kDAAmC,CAAC;AAKnD,eAAe,SAAS,CAAC"}

package/dist/component/convex.config.js

@@ -1,6 +1,8 @@
 import { defineComponent } from "convex/server";
 import workpool from "@convex-dev/workpool/convex.config";
+import workflow from "@convex-dev/workflow/convex.config";
 const component = defineComponent("workOSAuthKit");
 component.use(workpool, { name: "eventWorkpool" });
+component.use(workflow, { name: "backfillWorkflow" });
 export default component;
 //# sourceMappingURL=convex.config.js.map

package/dist/component/convex.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"convex.config.js","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,QAAQ,MAAM,oCAAoC,CAAC;AAE1D,MAAM,SAAS,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;AAEnD,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;AAEnD,eAAe,SAAS,CAAC"}
+{"version":3,"file":"convex.config.js","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,QAAQ,MAAM,oCAAoC,CAAC;AAC1D,OAAO,QAAQ,MAAM,oCAAoC,CAAC;AAE1D,MAAM,SAAS,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;AAEnD,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;AACnD,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAEtD,eAAe,SAAS,CAAC"}

package/dist/component/lib.d.ts

@@ -1,17 +1,34 @@
-export declare const enqueueWebhookEvent: import("convex/server").RegisteredMutation<"public", {
-    eventTypes?: string[] | undefined;
+export declare const vEvent: import("convex/values").VObject<{
+    context?: Record<string, any> | undefined;
+    id: string;
+    event: string;
+    createdAt: string;
+    data: Record<string, any>;
+}, {
+    id: import("convex/values").VString<string, "required">;
+    createdAt: import("convex/values").VString<string, "required">;
+    event: import("convex/values").VString<string, "required">;
+    data: import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>;
+    context: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
+}, "required", "id" | "event" | "createdAt" | "context" | "data" | `context.${string}` | `data.${string}`>;
+export declare const onWebhookEvent: import("convex/server").RegisteredMutation<"public", {
     logLevel?: "DEBUG" | undefined;
     onEventHandle?: string | undefined;
-    updatedAt?: string | undefined;
+    eventTypes?: string[] | undefined;
     apiKey: string;
-    event: string;
-    eventId: string;
-}, Promise<void>>;
+    event: {
+        context?: Record<string, any> | undefined;
+        id: string;
+        event: string;
+        createdAt: string;
+        data: Record<string, any>;
+    };
+}, Promise<null>>;
 export declare const getCursor: import("convex/server").RegisteredQuery<"internal", {}, Promise<string | undefined>>;
 export declare const updateEvents: import("convex/server").RegisteredAction<"internal", {
-    eventTypes?: string[] | undefined;
     logLevel?: "DEBUG" | undefined;
     onEventHandle?: string | undefined;
+    eventTypes?: string[] | undefined;
     apiKey: string;
 }, Promise<void>>;
 export declare const processEvent: import("convex/server").RegisteredMutation<"internal", {
@@ -19,10 +36,10 @@ export declare const processEvent: import("convex/server").RegisteredMutation<"i
     onEventHandle?: string | undefined;
     event: {
         context?: Record<string, any> | undefined;
-        event: string;
         id: string;
-        data: Record<string, any>;
+        event: string;
         createdAt: string;
+        data: Record<string, any>;
     };
 }, Promise<void>>;
 export declare const getAuthUser: import("convex/server").RegisteredQuery<"public", {
@@ -34,8 +51,8 @@ export declare const getAuthUser: import("convex/server").RegisteredQuery<"publi
     lastSignInAt?: string | null | undefined;
     externalId?: string | null | undefined;
     locale?: string | null | undefined;
-    updatedAt: string;
     id: string;
+    updatedAt: string;
     email: string;
     emailVerified: boolean;
     metadata: Record<string, any>;

package/dist/component/lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,mBAAmB;;;;;;;;iBAmB9B,CAAC;AAEH,eAAO,MAAM,SAAS,sFAUpB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;iBAuCvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;iBA4EvB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;UAYtB,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,MAAM;;;;;;;;;;;;0GAMjB,CAAC;AAgFH,eAAO,MAAM,cAAc;;;;;;;;;;;;iBA0BzB,CAAC;AAEH,eAAO,MAAM,SAAS,sFAUpB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;iBA0CvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;iBASvB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;UAYtB,CAAC"}

package/dist/component/lib.js

@@ -9,31 +9,108 @@ import { parse } from "convex-helpers/validators";
 const eventWorkpool = new Workpool(components.eventWorkpool, {
     maxParallelism: 1,
 });
-const vEvent = v.object({
+export const vEvent = v.object({
     id: v.string(),
     createdAt: v.string(),
     event: v.string(),
     data: v.record(v.string(), v.any()),
     context: v.optional(v.record(v.string(), v.any())),
 });
-export const enqueueWebhookEvent = mutation({
+async function processEventHandler(ctx, args) {
+    if (args.logLevel === "DEBUG") {
+        console.log("processing event", args.event);
+    }
+    const dbEvent = await ctx.db
+        .query("events")
+        .withIndex("eventId", (q) => q.eq("eventId", args.event.id))
+        .unique();
+    if (dbEvent) {
+        console.log("event already processed", args.event.id);
+        return;
+    }
+    await ctx.db.insert("events", {
+        eventId: args.event.id,
+        event: args.event.event,
+        updatedAt: args.event.data.updatedAt,
+    });
+    const event = args.event;
+    switch (event.event) {
+        case "user.created": {
+            const data = omit(event.data, ["object"]);
+            const existingUser = await ctx.db
+                .query("users")
+                .withIndex("id", (q) => q.eq("id", data.id))
+                .unique();
+            if (existingUser) {
+                console.warn("user already exists", data.id);
+                return;
+            }
+            await ctx.db.insert("users", data);
+            break;
+        }
+        case "user.updated": {
+            const data = omit(event.data, ["object"]);
+            const user = await ctx.db
+                .query("users")
+                .withIndex("id", (q) => q.eq("id", data.id))
+                .unique();
+            if (!user) {
+                console.error("user not found", data.id);
+                return;
+            }
+            if (user.updatedAt >= data.updatedAt) {
+                console.warn(`user already updated for event ${event.id}, skipping`);
+                return;
+            }
+            await ctx.db.patch(user._id, data);
+            break;
+        }
+        case "user.deleted": {
+            const data = omit(event.data, ["object"]);
+            const user = await ctx.db
+                .query("users")
+                .withIndex("id", (q) => q.eq("id", data.id))
+                .unique();
+            if (!user) {
+                console.warn("user not found", data.id);
+                return;
+            }
+            await ctx.db.delete(user._id);
+            break;
+        }
+    }
+    if (args.onEventHandle) {
+        await ctx.runMutation(args.onEventHandle, {
+            event: args.event.event,
+            data: args.event.data,
+        });
+    }
+}
+export const onWebhookEvent = mutation({
     args: {
         apiKey: v.string(),
-        eventId: v.string(),
-        event: v.string(),
-        updatedAt: v.optional(v.string()),
+        event: vEvent,
         onEventHandle: v.optional(v.string()),
         eventTypes: v.optional(v.array(v.string())),
         logLevel: v.optional(v.literal("DEBUG")),
     },
+    returns: v.null(),
     handler: async (ctx, args) => {
-        await eventWorkpool.cancelAll(ctx);
-        await eventWorkpool.enqueueAction(ctx, internal.lib.updateEvents, {
-            apiKey: args.apiKey,
-            onEventHandle: args.onEventHandle,
-            eventTypes: args.eventTypes,
-            logLevel: args.logLevel,
-        });
+        const isCreateEvent = args.event.event.endsWith(".created");
+        if (isCreateEvent) {
+            // Process create events immediately
+            await processEventHandler(ctx, args);
+        }
+        else {
+            // Enqueue update/delete events to workpool
+            await eventWorkpool.enqueueAction(ctx, internal.lib.updateEvents, {
+                apiKey: args.apiKey,
+                onEventHandle: args.onEventHandle,
+                eventTypes: args.eventTypes,
+                logLevel: args.logLevel,
+            });
+        }
+        return null;
     },
 });
 export const getCursor = internalQuery({
@@ -55,6 +132,9 @@ export const updateEvents = internalAction({
         logLevel: v.optional(v.literal("DEBUG")),
     },
     handler: async (ctx, args) => {
+        // Cancel other pending workpool jobs since this run will
+        // process all available events from the WorkOS API.
+        await eventWorkpool.cancelAll(ctx);
         const workos = new WorkOS(args.apiKey);
         const cursor = await ctx.runQuery(internal.lib.getCursor);
         let nextCursor = cursor ?? undefined;
@@ -94,74 +174,7 @@ export const processEvent = internalMutation({
         onEventHandle: v.optional(v.string()),
     },
     handler: async (ctx, args) => {
-        if (args.logLevel === "DEBUG") {
-            console.log("processing event", args.event);
-        }
-        const dbEvent = await ctx.db
-            .query("events")
-            .withIndex("eventId", (q) => q.eq("eventId", args.event.id))
-            .unique();
-        if (dbEvent) {
-            console.log("event already processed", args.event.id);
-            return;
-        }
-        await ctx.db.insert("events", {
-            eventId: args.event.id,
-            event: args.event.event,
-            updatedAt: args.event.data.updatedAt,
-        });
-        const event = args.event;
-        switch (event.event) {
-            case "user.created": {
-                const data = omit(event.data, ["object"]);
-                const existingUser = await ctx.db
-                    .query("users")
-                    .withIndex("id", (q) => q.eq("id", data.id))
-                    .unique();
-                if (existingUser) {
-                    console.warn("user already exists", data.id);
-                    break;
-                }
-                await ctx.db.insert("users", data);
-                break;
-            }
-            case "user.updated": {
-                const data = omit(event.data, ["object"]);
-                const user = await ctx.db
-                    .query("users")
-                    .withIndex("id", (q) => q.eq("id", data.id))
-                    .unique();
-                if (!user) {
-                    console.error("user not found", data.id);
-                    break;
-                }
-                if (user.updatedAt >= data.updatedAt) {
-                    console.warn(`user already updated for event ${event.id}, skipping`);
-                    break;
-                }
-                await ctx.db.patch(user._id, data);
-                break;
-            }
-            case "user.deleted": {
-                const data = omit(event.data, ["object"]);
-                const user = await ctx.db
-                    .query("users")
-                    .withIndex("id", (q) => q.eq("id", data.id))
-                    .unique();
-                if (!user) {
-                    console.warn("user not found", data.id);
-                    break;
-                }
-                await ctx.db.delete(user._id);
-                break;
-            }
-        }
-        if (args.onEventHandle) {
-            await ctx.runMutation(args.onEventHandle, {
-                event: args.event.event,
-                data: args.event.data,
-            });
-        }
+        await processEventHandler(ctx, args);
     },
 });
 export const getAuthUser = query({