@convex-dev/crons 0.0.1

package/dist/commonjs/component/public.js

@@ -0,0 +1,225 @@
+// Implementation of crons in user space.
+//
+// See ../client/index.ts for the public API.
+import { v } from "convex/values";
+import { mutation, query, internalMutation, } from "./_generated/server.js";
+import { internal } from "./_generated/api.js";
+import parser from "cron-parser";
+import schema from "./schema.js";
+const scheduleValidator = schema.tables.crons.validator.fields.schedule;
+const cronInfoValidator = v.object({
+    id: v.id("crons"),
+    name: v.optional(v.string()),
+    functionHandle: v.string(),
+    args: v.record(v.string(), v.any()),
+    schedule: scheduleValidator,
+});
+/**
+ * Schedule a mutation or action to run on a cron schedule or interval.
+ *
+ * @param name - Optional unique name for the job. Will throw if a name is
+ *        provided and a job with the same name already exists.
+ * @param schedule - Either a cron specification string or an interval in
+ *        milliseconds. For intervals, ms must be >= 1000.
+ * @param functionHandle - A {@link FunctionHandle} string for the function to
+ *        schedule.
+ * @param args - The arguments to the function.
+ * @returns The ID of the scheduled job.
+ */
+export const register = mutation({
+    args: {
+        name: v.optional(v.string()),
+        schedule: scheduleValidator,
+        functionHandle: v.string(),
+        args: v.record(v.string(), v.any()),
+    },
+    returns: v.id("crons"),
+    handler: async (ctx, { name, schedule, functionHandle, args }) => {
+        if (name &&
+            (await ctx.db
+                .query("crons")
+                .withIndex("name", (q) => q.eq("name", name))
+                .unique())) {
+            throw new Error(`Cron with name "${name}" already exists`);
+        }
+        validateSchedule(schedule);
+        const id = await ctx.db.insert("crons", {
+            functionHandle,
+            args,
+            name,
+            schedule,
+        });
+        console.log(`Scheduling cron "${name}" (${id}) on schedule ${JSON.stringify(schedule)}`);
+        await scheduleNextRun(ctx, id, new Date(), schedule);
+        return id;
+    },
+});
+function validateSchedule(schedule) {
+    if (schedule.kind === "interval" && schedule.ms < 1000) {
+        throw new Error("Interval must be >= 1000ms");
+    }
+    if (schedule.kind === "cron") {
+        try {
+            parser.parseExpression(schedule.cronspec);
+        }
+        catch {
+            throw new Error(`Invalid cronspec: "${schedule.cronspec}"`);
+        }
+    }
+}
+async function scheduleNextRun(ctx, id, lastScheduled, schedule) {
+    const nextRun = calculateNextRun(lastScheduled, schedule);
+    const schedulerJobId = await ctx.scheduler.runAt(nextRun, internal.public.rescheduler, { id });
+    await ctx.db.patch(id, { schedulerJobId });
+}
+function calculateNextRun(lastScheduled, schedule) {
+    if (schedule.kind === "interval") {
+        return new Date(lastScheduled.getTime() + schedule.ms);
+    }
+    else {
+        const cron = parser.parseExpression(schedule.cronspec, {
+            currentDate: lastScheduled,
+        });
+        return cron.next().toDate();
+    }
+}
+/**
+ * List all user space cron jobs.
+ *
+ * @returns List of `cron` table rows.
+ */
+export const list = query({
+    args: {},
+    returns: v.array(cronInfoValidator),
+    handler: async (ctx) => {
+        const crons = await ctx.db.query("crons").collect();
+        return crons.map((cron) => ({
+            id: cron._id,
+            ...(cron.name && { name: cron.name }),
+            functionHandle: cron.functionHandle,
+            args: cron.args,
+            schedule: cron.schedule,
+        }));
+    },
+});
+/**
+ * Get an existing cron job by id or name.
+ *
+ * @param identifier - Either the ID or name of the cron job.
+ * @returns Cron job document or null if not found.
+ */
+export const get = query({
+    args: {
+        identifier: v.union(v.object({ id: v.id("crons") }), v.object({ name: v.string() })),
+    },
+    returns: v.union(cronInfoValidator, v.null()),
+    handler: async (ctx, { identifier }) => {
+        const cron = "id" in identifier
+            ? await ctx.db.get(identifier.id)
+            : await ctx.db
+                .query("crons")
+                .withIndex("name", (q) => q.eq("name", identifier.name))
+                .unique();
+        if (!cron)
+            return null;
+        return {
+            id: cron._id,
+            ...(cron.name && { name: cron.name }),
+            functionHandle: cron.functionHandle,
+            args: cron.args,
+            schedule: cron.schedule,
+        };
+    },
+});
+/**
+ * Delete and deschedule a cron job by id or name.
+ *
+ * @param identifier - Either the ID or name of the cron job.
+ */
+export const del = mutation({
+    args: {
+        identifier: v.union(v.object({ id: v.id("crons") }), v.object({ name: v.string() })),
+    },
+    returns: v.null(),
+    handler: async (ctx, { identifier }) => {
+        let cron;
+        if ("id" in identifier) {
+            cron = await ctx.db.get(identifier.id);
+            if (!cron) {
+                throw new Error(`Cron ${identifier.id} not found`);
+            }
+        }
+        else {
+            cron = await ctx.db
+                .query("crons")
+                .withIndex("name", (q) => q.eq("name", identifier.name))
+                .unique();
+            if (!cron) {
+                throw new Error(`Cron "${identifier.name}" not found`);
+            }
+        }
+        if (!cron.schedulerJobId) {
+            throw new Error(`Cron ${cron._id} not scheduled`);
+        }
+        console.log(`Canceling scheduler job ${cron.schedulerJobId}`);
+        await ctx.scheduler.cancel(cron.schedulerJobId);
+        if (cron.executionJobId) {
+            console.log(`Canceling execution job ${cron.executionJobId}`);
+            await ctx.scheduler.cancel(cron.executionJobId);
+        }
+        console.log(`Deleting cron ${cron._id}`);
+        await ctx.db.delete(cron._id);
+    },
+});
+// Continue rescheduling a cron job.
+//
+// This is the main worker function that does the scheduling but also schedules
+// the target function so that it runs in a different context. As a result this
+// function probably *shouldn't* fail since it isn't doing much, but under heavy
+// OCC contention it's possible it may eventually fail. In this case the cron
+// will be lost and we'll need a janitor job to recover it.
+export const rescheduler = internalMutation({
+    args: {
+        id: v.id("crons"),
+    },
+    returns: v.null(),
+    handler: async (ctx, { id }) => {
+        // Cron job is the logical concept we're rescheduling repeatedly.
+        const cronJob = await ctx.db.get(id);
+        if (!cronJob) {
+            throw Error(`Cron ${id} not found`);
+        }
+        if (!cronJob.schedulerJobId) {
+            throw Error(`Cron ${id} not scheduled`);
+        }
+        // Scheduler job is the job that's running right now, that we use to trigger
+        // repeated executions.
+        const schedulerJob = await ctx.db.system.get(cronJob.schedulerJobId);
+        if (!schedulerJob) {
+            throw Error(`Scheduler job ${cronJob.schedulerJobId} not found`);
+        }
+        if (schedulerJob.state.kind !== "pending" &&
+            schedulerJob.state.kind !== "inProgress") {
+            throw Error(`We are running in job ${schedulerJob._id} but state is ${schedulerJob.state.kind}`);
+        }
+        // Execution job is the previous job used to actually do the work of the cron.
+        let stillRunning = false;
+        if (cronJob.executionJobId) {
+            const executionJob = await ctx.db.system.get(cronJob.executionJobId);
+            if (executionJob &&
+                (executionJob.state.kind === "pending" ||
+                    executionJob.state.kind === "inProgress")) {
+                stillRunning = true;
+            }
+        }
+        if (stillRunning) {
+            console.log(`Cron ${cronJob._id} still running, skipping this run.`);
+        }
+        else {
+            console.log(`Running cron ${cronJob._id}.`);
+            await ctx.scheduler.runAfter(0, cronJob.functionHandle, cronJob.args);
+        }
+        await scheduleNextRun(ctx, id, new Date(schedulerJob.scheduledTime), cronJob.schedule);
+    },
+});
+//# sourceMappingURL=public.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/component/public.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,6CAA6C;AAG7C,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAEL,QAAQ,EACR,KAAK,EACL,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,MAAM,MAAM,aAAa,CAAC;AAKjC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AASxE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IACnC,QAAQ,EAAE,iBAAiB;CAC5B,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC/B,IAAI,EAAE;QACJ,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5B,QAAQ,EAAE,iBAAiB;QAC3B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;KACpC;IACD,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;IACtB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE;QAC/D,IACE,IAAI;YACJ,CAAC,MAAM,GAAG,CAAC,EAAE;iBACV,KAAK,CAAC,OAAO,CAAC;iBACd,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;iBAC5C,MAAM,EAAE,CAAC,EACZ;YACA,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,kBAAkB,CAAC,CAAC;SAC5D;QACD,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE3B,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;YACtC,cAAc;YACd,IAAI;YACJ,IAAI;YACJ,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CACT,oBAAoB,IAAI,MAAM,EAAE,iBAAiB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAC5E,CAAC;QAEF,MAAM,eAAe,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;QACrD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,gBAAgB,CAAC,QAAkB;IAC1C,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,IAAI,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE;QACtD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;KAC/C;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE;QAC5B,IAAI;YACF,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAC3C;QAAC,MAAM;YACN,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC;SAC7D;KACF;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,GAAgB,EAChB,EAAe,EACf,aAAmB,EACnB,QAAkB;IAElB,MAAM,OAAO,GAAG,gBAAgB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,KAAK,CAC9C,OAAO,EACP,QAAQ,CAAC,MAAM,CAAC,WAAW,EAC3B,EAAE,EAAE,EAAE,CACP,CAAC;IACF,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,gBAAgB,CAAC,aAAmB,EAAE,QAAkB;IAC/D,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE;QAChC,OAAO,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;KACxD;SAAM;QACL,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,EAAE;YACrD,WAAW,EAAE,aAAa;SAC3B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;KAC7B;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC;IACxB,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACnC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,EAAE,EAAE,IAAI,CAAC,GAAG;YACZ,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC;IACvB,IAAI,EAAE;QACJ,UAAU,EAAE,CAAC,CAAC,KAAK,CACjB,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAC/B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC/B;KACF;IACD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACrC,MAAM,IAAI,GACR,IAAI,IAAI,UAAU;YAChB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;iBACT,KAAK,CAAC,OAAO,CAAC;iBACd,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;iBACvD,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,GAAG;YACZ,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE;QACJ,UAAU,EAAE,CAAC,CAAC,KAAK,CACjB,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAC/B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC/B;KACF;IACD,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACrC,IAAI,IAAyB,CAAC;QAC9B,IAAI,IAAI,IAAI,UAAU,EAAE;YACtB,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,IAAI,EAAE;gBACT,MAAM,IAAI,KAAK,CAAC,QAAQ,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;aACpD;SACF;aAAM;YACL,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE;iBAChB,KAAK,CAAC,OAAO,CAAC;iBACd,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;iBACvD,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,EAAE;gBACT,MAAM,IAAI,KAAK,CAAC,SAAS,UAAU,CAAC,IAAI,aAAa,CAAC,CAAC;aACxD;SACF;QACD,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC;SACnD;QACD,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAC9D,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,cAAc,EAAE;YACvB,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;YAC9D,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;SACjD;QACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACzC,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;CACF,CAAC,CAAC;AAEH,oCAAoC;AACpC,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC;IAC1C,IAAI,EAAE;QACJ,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;KAClB;IACD,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QAC7B,iEAAiE;QACjE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE;YACZ,MAAM,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;SACrC;QACD,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;YAC3B,MAAM,KAAK,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;SACzC;QAED,4EAA4E;QAC5E,uBAAuB;QACvB,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACrE,IAAI,CAAC,YAAY,EAAE;YACjB,MAAM,KAAK,CAAC,iBAAiB,OAAO,CAAC,cAAc,YAAY,CAAC,CAAC;SAClE;QACD,IACE,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;YACrC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,EACxC;YACA,MAAM,KAAK,CACT,yBAAyB,YAAY,CAAC,GAAG,iBAAiB,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CACpF,CAAC;SACH;QAED,8EAA8E;QAC9E,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,OAAO,CAAC,cAAc,EAAE;YAC1B,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACrE,IACE,YAAY;gBACZ,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;oBACpC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,EAC3C;gBACA,YAAY,GAAG,IAAI,CAAC;aACrB;SACF;QACD,IAAI,YAAY,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,CAAC,GAAG,oCAAoC,CAAC,CAAC;SACtE;aAAM;YACL,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;YAC5C,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAC1B,CAAC,EACD,OAAO,CAAC,cAAuD,EAC/D,OAAO,CAAC,IAAI,CACb,CAAC;SACH;QAED,MAAM,eAAe,CACnB,GAAG,EACH,EAAE,EACF,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EACpC,OAAO,CAAC,QAAQ,CACjB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,45 @@
+declare const _default: import("convex/server").SchemaDefinition<{
+    crons: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        name?: string | undefined;
+        schedulerJobId?: import("convex/values").GenericId<"_scheduled_functions"> | undefined;
+        executionJobId?: import("convex/values").GenericId<"_scheduled_functions"> | undefined;
+        functionHandle: string;
+        args: Record<string, any>;
+        schedule: {
+            kind: "interval";
+            ms: number;
+        } | {
+            kind: "cron";
+            cronspec: string;
+        };
+    }, {
+        name: import("convex/values").VString<string | undefined, "optional">;
+        functionHandle: import("convex/values").VString<string, "required">;
+        args: import("convex/values").VRecord<Record<string, any>, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "required", string>;
+        schedule: import("convex/values").VUnion<{
+            kind: "interval";
+            ms: number;
+        } | {
+            kind: "cron";
+            cronspec: string;
+        }, [import("convex/values").VObject<{
+            kind: "interval";
+            ms: number;
+        }, {
+            kind: import("convex/values").VLiteral<"interval", "required">;
+            ms: import("convex/values").VFloat64<number, "required">;
+        }, "required", "kind" | "ms">, import("convex/values").VObject<{
+            kind: "cron";
+            cronspec: string;
+        }, {
+            kind: import("convex/values").VLiteral<"cron", "required">;
+            cronspec: import("convex/values").VString<string, "required">;
+        }, "required", "kind" | "cronspec">], "required", "kind" | "ms" | "cronspec">;
+        schedulerJobId: import("convex/values").VId<import("convex/values").GenericId<"_scheduled_functions"> | undefined, "optional">;
+        executionJobId: import("convex/values").VId<import("convex/values").GenericId<"_scheduled_functions"> | undefined, "optional">;
+    }, "required", "name" | "functionHandle" | "args" | "schedule" | "schedulerJobId" | "executionJobId" | `args.${string}` | "schedule.kind" | "schedule.ms" | "schedule.cronspec">, {
+        name: ["name", "_creationTime"];
+    }, {}, {}>;
+}, true>;
+export default _default;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/component/schema.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,wBAmBG"}

package/dist/commonjs/component/schema.js

@@ -0,0 +1,20 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+export default defineSchema({
+    // User space crons.
+    crons: defineTable({
+        name: v.optional(v.string()),
+        functionHandle: v.string(),
+        args: v.record(v.string(), v.any()),
+        schedule: v.union(v.object({
+            kind: v.literal("interval"),
+            ms: v.float64(), // milliseconds
+        }), v.object({
+            kind: v.literal("cron"),
+            cronspec: v.string(), // "* * * * *"
+        })),
+        schedulerJobId: v.optional(v.id("_scheduled_functions")),
+        executionJobId: v.optional(v.id("_scheduled_functions")), // async job to run the function
+    }).index("name", ["name"]),
+});
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,eAAe,YAAY,CAAC;IAC1B,oBAAoB;IACpB,KAAK,EAAE,WAAW,CAAC;QACjB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACnC,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;YAC3B,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,eAAe;SACjC,CAAC,EACF,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc;SACrC,CAAC,CACH;QACD,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC;QACxD,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,EAAE,gCAAgC;KAC3F,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;CAC3B,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function subtract(a: number, b: number): number;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/frontend/index.ts"],"names":[],"mappings":"AAKA,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/commonjs/frontend/index.js

@@ -0,0 +1,8 @@
+// This is where React components go.
+if (typeof window === "undefined") {
+    throw new Error("this is frontend code, but it's running somewhere else!");
+}
+export function subtract(a, b) {
+    return a - b;
+}
+//# sourceMappingURL=index.js.map

package/dist/commonjs/frontend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/frontend/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;IACjC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;CAC5E;AAED,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS;IAC3C,OAAO,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,50 @@
+import { FunctionArgs, SchedulableFunctionReference } from "convex/server";
+import { api } from "../component/_generated/api.js";
+import { CronInfo, Schedule } from "../component/public.js";
+import { RunMutationCtx, RunQueryCtx, UseApi } from "./utils.js";
+export type { CronInfo };
+export declare class Crons {
+    private component;
+    constructor(component: UseApi<typeof api>);
+    /**
+     * Schedule a mutation or action to run on a cron schedule or interval.
+     *
+     * @param ctx - The mutation context from the calling Convex mutation.
+     * @param schedule - Either a cron specification string or an interval in
+     *        milliseconds. For intervals, ms must be >= 1000.
+     * @param func - A function reference to the mutation or action to schedule.
+     * @param args - The arguments to the function.
+     * @param name - Optional unique name for the cron. Will throw if a name is
+     *        provided and a cron with the same name already exists.
+     * @returns A string identifier for the cron job.
+     */
+    register<F extends SchedulableFunctionReference>(ctx: RunMutationCtx, schedule: Schedule, func: F, args: FunctionArgs<F>, name?: string): Promise<string>;
+    /**
+     * List all user space cron jobs.
+     *
+     * @returns List of `cron` table rows.
+     */
+    list(ctx: RunQueryCtx): Promise<CronInfo[]>;
+    /**
+     * Get an existing cron job by id or name.
+     *
+     * @param identifier - Either the ID or name of the cron job.
+     * @returns Cron job document.
+     */
+    get(ctx: RunQueryCtx, identifier: {
+        id: string;
+    } | {
+        name: string;
+    }): Promise<CronInfo | null>;
+    /**
+     * Delete and deschedule a cron job by id or name.
+     *
+     * @param identifier - Either the ID or name of the cron job.
+     */
+    del(ctx: RunMutationCtx, identifier: {
+        id: string;
+    } | {
+        name: string;
+    }): Promise<null>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,YAAY,EAEZ,4BAA4B,EAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEjE,YAAY,EAAE,QAAQ,EAAE,CAAC;AAqCzB,qBAAa,KAAK;IACJ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC;IAEjD;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,CAAC,SAAS,4BAA4B,EACnD,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC;IASlB;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUjD;;;;;OAKG;IACG,GAAG,CACP,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAa3B;;;;OAIG;IACG,GAAG,CACP,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,IAAI,CAAC;CAGjB"}

package/dist/esm/client/index.js

@@ -0,0 +1,99 @@
+// Client side implementation of the Crons component.
+import { createFunctionHandle, } from "convex/server";
+// TODO (james): should we add helpers for minutely, hourly, etc schedules?
+// Implementation of crons in user space.
+//
+// Supports intervals in ms as well as cron schedules with the same format as
+// the unix `cron` command:
+//
+//  *  *  *  *  *  *
+//  ┬  ┬  ┬  ┬  ┬  ┬
+//  │  │  │  │  │  |
+//  │  │  │  │  │  └── day of week (0 - 7, 1L - 7L) (0 or 7 is Sun)
+//  │  │  │  │  └───── month (1 - 12)
+//  │  │  │  └──────── day of month (1 - 31, L)
+//  │  │  └─────────── hour (0 - 23)
+//  │  └────────────── minute (0 - 59)
+//  └───────────────── second (0 - 59, optional)
+//
+// Crons can be registered at runtime via the `register` function.
+//
+// If you'd like to statically define cronjobs like in the built-in `crons.ts`
+// Convex feature you can do so via an init script that idempotently registers a
+// cron with a given name. e.g., in an `init.ts` file that gets run on every
+// deploy via `convex dev --run init`:
+//
+// const crons = new Crons(components.crons);
+// ...
+// if ((await crons.get(ctx, { name: "daily" })) === null) {
+//   await crons.register(
+//     ctx,
+//     { kind: "cron", cronspec: "0 0 * * *" },
+//     internal.example.logStuff,
+//     { message: "daily cron" },
+//     "daily"
+//   );
+// }
+export class Crons {
+    component;
+    constructor(component) {
+        this.component = component;
+    }
+    /**
+     * Schedule a mutation or action to run on a cron schedule or interval.
+     *
+     * @param ctx - The mutation context from the calling Convex mutation.
+     * @param schedule - Either a cron specification string or an interval in
+     *        milliseconds. For intervals, ms must be >= 1000.
+     * @param func - A function reference to the mutation or action to schedule.
+     * @param args - The arguments to the function.
+     * @param name - Optional unique name for the cron. Will throw if a name is
+     *        provided and a cron with the same name already exists.
+     * @returns A string identifier for the cron job.
+     */
+    async register(ctx, schedule, func, args, name) {
+        return ctx.runMutation(this.component.public.register, {
+            name,
+            schedule,
+            functionHandle: await createFunctionHandle(func),
+            args,
+        });
+    }
+    /**
+     * List all user space cron jobs.
+     *
+     * @returns List of `cron` table rows.
+     */
+    async list(ctx) {
+        const crons = await ctx.runQuery(this.component.public.list, {});
+        return crons.map((cron) => ({
+            ...cron,
+            functionHandle: cron.functionHandle,
+        }));
+    }
+    /**
+     * Get an existing cron job by id or name.
+     *
+     * @param identifier - Either the ID or name of the cron job.
+     * @returns Cron job document.
+     */
+    async get(ctx, identifier) {
+        const cron = await ctx.runQuery(this.component.public.get, { identifier });
+        if (cron === null) {
+            return null;
+        }
+        return {
+            ...cron,
+            functionHandle: cron.functionHandle,
+        };
+    }
+    /**
+     * Delete and deschedule a cron job by id or name.
+     *
+     * @param identifier - Either the ID or name of the cron job.
+     */
+    async del(ctx, identifier) {
+        return ctx.runMutation(this.component.public.del, { identifier });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD,OAAO,EACL,oBAAoB,GAIrB,MAAM,eAAe,CAAC;AAOvB,2EAA2E;AAE3E,yCAAyC;AACzC,EAAE;AACF,6EAA6E;AAC7E,2BAA2B;AAC3B,EAAE;AACF,oBAAoB;AACpB,oBAAoB;AACpB,oBAAoB;AACpB,mEAAmE;AACnE,qCAAqC;AACrC,+CAA+C;AAC/C,oCAAoC;AACpC,sCAAsC;AACtC,gDAAgD;AAChD,EAAE;AACF,kEAAkE;AAClE,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,4EAA4E;AAC5E,sCAAsC;AACtC,EAAE;AACF,6CAA6C;AAC7C,MAAM;AACN,4DAA4D;AAC5D,0BAA0B;AAC1B,WAAW;AACX,+CAA+C;AAC/C,iCAAiC;AACjC,iCAAiC;AACjC,cAAc;AACd,OAAO;AACP,IAAI;AACJ,MAAM,OAAO,KAAK;IACI;IAApB,YAAoB,SAA6B;QAA7B,cAAS,GAAT,SAAS,CAAoB;IAAG,CAAC;IAErD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,CACZ,GAAmB,EACnB,QAAkB,EAClB,IAAO,EACP,IAAqB,EACrB,IAAa;QAEb,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE;YACrD,IAAI;YACJ,QAAQ;YACR,cAAc,EAAE,MAAM,oBAAoB,CAAC,IAAI,CAAC;YAChD,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,GAAgB;QACzB,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,GAAG,IAAI;YACP,cAAc,EAAE,IAAI,CAAC,cAEpB;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CACP,GAAgB,EAChB,UAA6C;QAE7C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3E,IAAI,IAAI,KAAK,IAAI,EAAE;YACjB,OAAO,IAAI,CAAC;SACb;QACD,OAAO;YACL,GAAG,IAAI;YACP,cAAc,EAAE,IAAI,CAAC,cAEpB;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CACP,GAAmB,EACnB,UAA6C;QAE7C,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACpE,CAAC;CACF"}

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

@@ -0,0 +1,15 @@
+import { Expand, FunctionReference, GenericDataModel, GenericMutationCtx, GenericQueryCtx } from "convex/server";
+import { GenericId } from "convex/values";
+export type RunQueryCtx = {
+    runQuery: GenericQueryCtx<GenericDataModel>["runQuery"];
+};
+export type RunMutationCtx = {
+    runMutation: GenericMutationCtx<GenericDataModel>["runMutation"];
+};
+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=utils.d.ts.map

package/dist/esm/client/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/client/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC,UAAU,CAAC,CAAC;CACzD,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,aAAa,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,IACrB,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,CAAC,GACzB,MAAM,GACN,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACnB,SAAS,CAAC,CAAC,CAAC,EAAE,GACd,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACnC,CAAC,CAAC;AAEZ,MAAM,MAAM,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC;KAC9B,GAAG,IAAI,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,iBAAiB,CACpD,MAAM,KAAK,EACX,QAAQ,EACR,MAAM,KAAK,EACX,MAAM,WAAW,EACjB,MAAM,cAAc,CACrB,GACG,iBAAiB,CACf,KAAK,EACL,UAAU,EACV,SAAS,CAAC,KAAK,CAAC,EAChB,SAAS,CAAC,WAAW,CAAC,EACtB,cAAc,CACf,GACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACrB,CAAC,CAAC"}

package/dist/esm/client/utils.js

@@ -0,0 +1,3 @@
+// Type utilities for component clients.
+export {};
+//# sourceMappingURL=utils.js.map

package/dist/esm/client/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/client/utils.ts"],"names":[],"mappings":"AAAA,wCAAwC"}

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

@@ -0,0 +1,14 @@
+/**
+ * A utility for referencing Convex functions in your app's API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export const api: import("convex/server").AnyApi;
+export const internal: import("convex/server").AnyApi;
+export const components: {
+    [x: string]: import("../../../node_modules/convex/dist/esm-types/server/components/index.js").AnyComponentReference;
+};
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/component/_generated/api.js"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,iDAA0B;AAC1B,sDAA+B;AAC/B;;EAA8C"}

package/dist/esm/component/_generated/api.js

@@ -0,0 +1,24 @@
+/* prettier-ignore-start */
+/* eslint-disable */
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import { anyApi, componentsGeneric } from "convex/server";
+/**
+ * A utility for referencing Convex functions in your app's API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export const api = anyApi;
+export const internal = anyApi;
+export const components = componentsGeneric();
+/* prettier-ignore-end */
+//# sourceMappingURL=api.js.map

package/dist/esm/component/_generated/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../src/component/_generated/api.js"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,oBAAoB;AACpB;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC;AAC1B,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;AAE9C,yBAAyB"}

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

@@ -0,0 +1,64 @@
+/**
+ * Define a query in this Convex app's public API.
+ *
+ * This function will be allowed to read your Convex database and will be accessible from the client.
+ *
+ * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
+ * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
+ */
+export const query: import("convex/server").QueryBuilder<any, "public">;
+/**
+ * Define a query that is only accessible from other Convex functions (but not from the client).
+ *
+ * This function will be allowed to read from your Convex database. It will not be accessible from the client.
+ *
+ * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
+ * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
+ */
+export const internalQuery: import("convex/server").QueryBuilder<any, "internal">;
+/**
+ * Define a mutation in this Convex app's public API.
+ *
+ * This function will be allowed to modify your Convex database and will be accessible from the client.
+ *
+ * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
+ * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
+ */
+export const mutation: import("convex/server").MutationBuilder<any, "public">;
+/**
+ * Define a mutation that is only accessible from other Convex functions (but not from the client).
+ *
+ * This function will be allowed to modify your Convex database. It will not be accessible from the client.
+ *
+ * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
+ * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
+ */
+export const internalMutation: import("convex/server").MutationBuilder<any, "internal">;
+/**
+ * Define an action in this Convex app's public API.
+ *
+ * An action is a function which can execute any JavaScript code, including non-deterministic
+ * code and code with side-effects, like calling third-party services.
+ * They can be run in Convex's JavaScript environment or in Node.js using the "use node" directive.
+ * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.
+ *
+ * @param func - The action. It receives an {@link ActionCtx} as its first argument.
+ * @returns The wrapped action. Include this as an `export` to name it and make it accessible.
+ */
+export const action: import("convex/server").ActionBuilder<any, "public">;
+/**
+ * Define an action that is only accessible from other Convex functions (but not from the client).
+ *
+ * @param func - The function. It receives an {@link ActionCtx} as its first argument.
+ * @returns The wrapped function. Include this as an `export` to name it and make it accessible.
+ */
+export const internalAction: import("convex/server").ActionBuilder<any, "internal">;
+/**
+ * Define a Convex HTTP action.
+ *
+ * @param func - The function. It receives an {@link ActionCtx} as its first argument, and a `Request` object
+ * as its second.
+ * @returns The wrapped endpoint function. Route a URL path to this function in `convex/http.js`.
+ */
+export const httpAction: (func: (ctx: import("convex/server").GenericActionCtx<import("convex/server").GenericDataModel>, request: Request) => Promise<Response>) => import("convex/server").PublicHttpAction;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/component/_generated/server.js"],"names":[],"mappings":"AAuBA;;;;;;;GAOG;AACH,wEAAkC;AAElC;;;;;;;GAOG;AACH,kFAAkD;AAElD;;;;;;;GAOG;AACH,8EAAwC;AAExC;;;;;;;GAOG;AACH,wFAAwD;AAExD;;;;;;;;;;GAUG;AACH,0EAAoC;AAEpC;;;;;GAKG;AACH,oFAAoD;AAEpD;;;;;;GAMG;AACH,8MAA4C"}