@xixixao/convex-migrations 0.3.1

package/dist/client/index.js

@@ -0,0 +1,528 @@
+import { createFunctionHandle, getFunctionAddress, getFunctionName, internalMutationGeneric, makeFunctionReference, } from "convex/server";
+import { migrationArgs, } from "../shared.js";
+import { ConvexError, v, } from "convex/values";
+import { logStatusAndInstructions } from "./log.js";
+// Note: this value is hard-coded in the docstring below. Please keep in sync.
+export const DEFAULT_BATCH_SIZE = 100;
+/**
+ * When args are provided, append a deterministic serialization to the migration
+ * name so that each unique set of args is tracked as a separate migration run.
+ */
+function migrationNameWithArgs(baseName, args) {
+    if (args === undefined || args === null)
+        return baseName;
+    const serialized = JSON.stringify(args, Object.keys(args).sort());
+    return `${baseName}(${serialized})`;
+}
+export class Migrations {
+    component;
+    options;
+    /**
+     * Makes the migration wrapper, with types for your own tables.
+     *
+     * It will keep track of migration state.
+     * Add in convex/migrations.ts for example:
+     * ```ts
+     * import { Migrations } from "@convex-dev/migrations";
+     * import { components } from "./_generated/api.js";
+     * import { internalMutation } from "./_generated/server";
+     *
+     * export const migrations = new Migrations(components.migrations, { internalMutation });
+     * // the private mutation to run migrations.
+     * export const run = migrations.runner();
+     *
+     * export const myMigration = migrations.define({
+     *  table: "users",
+     *  migrateOne: async (ctx, doc) => {
+     *    await ctx.db.patch(doc._id, { someField: "value" });
+     *  }
+     * });
+     * ```
+     * You can then run it from the CLI or dashboard:
+     * ```sh
+     * npx convex run migrations:run '{"fn": "migrations:myMigration"}'
+     * ```
+     * For starting a migration from code, see {@link runOne}/{@link runSerially}.
+     * @param component - The migrations component. It will be on components.migrations
+     * after being configured in in convex.config.js.
+     * @param options - Configure options and set the internalMutation to use.
+     */
+    constructor(component, options) {
+        this.component = component;
+        this.options = options;
+    }
+    /**
+     * Creates a migration runner that can be called from the CLI or dashboard.
+     *
+     * For starting a migration from code, see {@link runOne}/{@link runSerially}.
+     *
+     * It can be created for a specific migration:
+     * ```ts
+     * export const runMyMigration = runner(internal.migrations.myMigration);
+     * ```
+     * CLI: `npx convex run migrations:runMyMigration`
+     *
+     * Or for any migration:
+     * ```ts
+     * export const run = runner();
+     * ```
+     * CLI: `npx convex run migrations:run '{"fn": "migrations:myMigration"}'`
+     *
+     * Where `myMigration` is the name of the migration function, defined in
+     * "convex/migrations.ts" along with the run function.
+     *
+     * @param specificMigration If you want a migration runner for one migration,
+     * pass in the migration function reference like `internal.migrations.foo`.
+     * Otherwise it will be a generic runner that requires the migration name.
+     * @returns An internal mutation,
+     */
+    runner(specificMigrationOrSeries) {
+        return internalMutationGeneric({
+            args: migrationArgs,
+            handler: async (ctx, args) => {
+                const [specificMigration, next] = Array.isArray(specificMigrationOrSeries)
+                    ? [
+                        specificMigrationOrSeries[0],
+                        await Promise.all(specificMigrationOrSeries.slice(1).map(async (fnRef) => ({
+                            name: getFunctionName(fnRef),
+                            fnHandle: await createFunctionHandle(fnRef),
+                        }))),
+                    ]
+                    : [specificMigrationOrSeries, undefined];
+                if (args.fn && specificMigration) {
+                    throw new Error("Specify only one of fn or specificMigration");
+                }
+                if (!args.fn && !specificMigration) {
+                    throw new Error(`Specify the migration: '{"fn": "migrations:foo"}'\n` +
+                        "Or initialize a `runner` runner specific to the migration like\n" +
+                        "`export const runMyMigration = runner(internal.migrations.myMigration)`");
+                }
+                return await this._runInteractive(ctx, args, specificMigration, next);
+            },
+        });
+    }
+    async _runInteractive(ctx, args, fnRef, next) {
+        const baseName = args.fn
+            ? this.prefixedName(args.fn)
+            : getFunctionName(fnRef);
+        const name = migrationNameWithArgs(baseName, args.args);
+        async function makeFn(fn) {
+            try {
+                return await createFunctionHandle(makeFunctionReference(fn));
+            }
+            catch {
+                throw new Error(`Can't find function ${fn}\n` +
+                    "The name should match the folder/file:method\n" +
+                    "See https://docs.convex.dev/functions/query-functions#query-names");
+            }
+        }
+        const fnHandle = args.fn
+            ? await makeFn(name)
+            : await createFunctionHandle(fnRef);
+        if (args.next) {
+            next = (next ?? []).concat(await Promise.all(args.next.map(async (nextFn) => ({
+                name: this.prefixedName(nextFn),
+                fnHandle: await makeFn(this.prefixedName(nextFn)),
+            }))));
+        }
+        let status;
+        try {
+            status = await ctx.runMutation(this.component.lib.migrate, {
+                name,
+                fnHandle,
+                cursor: args.cursor,
+                batchSize: args.batchSize,
+                next,
+                dryRun: args.dryRun ?? false,
+                args: args.args,
+            });
+        }
+        catch (e) {
+            if (args.dryRun &&
+                e instanceof ConvexError &&
+                e.data.kind === "DRY RUN") {
+                status = e.data.status;
+            }
+            else {
+                throw e;
+            }
+        }
+        return logStatusAndInstructions(name, status, args);
+    }
+    /**
+     * Use this to wrap a mutation that will be run over all documents in a table.
+     * Your mutation only needs to handle changing one document at a time,
+     * passed into migrateOne.
+     * Optionally specify a custom batch size to override the default (100).
+     *
+     * In convex/migrations.ts for example:
+     * ```ts
+     * export const foo = migrations.define({
+     *  table: "users",
+     *  migrateOne: async (ctx, doc) => {
+     *   await ctx.db.patch(doc._id, { someField: "value" });
+     *  },
+     * });
+     * ```
+     *
+     * You can run this manually from the CLI or dashboard:
+     * ```sh
+     * # Start or resume a migration. No-ops if it's already done:
+     * npx convex run migrations:run '{"fn": "migrations:foo"}'
+     *
+     * # Restart a migration from a cursor (null is from the beginning):
+     * npx convex run migrations:run '{"fn": "migrations:foo", "cursor": null }'
+     *
+     * # Dry run - runs one batch but doesn't schedule or commit changes.
+     * # so you can see what it would do without committing the transaction.
+     * npx convex run migrations:run '{"fn": "migrations:foo", "dryRun": true}'
+     * # or
+     * npx convex run migrations:myMigration '{"dryRun": true}'
+     *
+     * # Run many migrations serially:
+     * npx convex run migrations:run '{"fn": "migrations:foo", "next": ["migrations:bar", "migrations:baz"] }'
+     * ```
+     *
+     * The fn is the string form of the function reference. See:
+     * https://docs.convex.dev/functions/query-functions#query-names
+     *
+     * See {@link runOne} and {@link runSerially} for programmatic use.
+     *
+     * @param table - The table to run the migration over.
+     * @param migrateOne - The function to run on each document.
+     * @param batchSize - The number of documents to process in a batch.
+     *   If not set, defaults to the value passed to makeMigration,
+     *   or {@link DEFAULT_BATCH_SIZE}. Overriden by arg at runtime if supplied.
+     * @param parallelize - If true, each migration batch will be run in parallel.
+     * @returns An internal mutation that runs the migration.
+     */
+    define({ table, migrateOne, customRange, batchSize: functionDefaultBatchSize, parallelize, args: defineArgs, }) {
+        const defaultBatchSize = functionDefaultBatchSize ??
+            this.options?.defaultBatchSize ??
+            DEFAULT_BATCH_SIZE;
+        // Under the hood it's an internal mutation that calls the migrateOne
+        // function for every document in a page, recursively scheduling batches.
+        return (this.options?.internalMutation ?? internalMutationGeneric)({
+            args: {
+                ...migrationArgs,
+                args: v.optional((defineArgs ?? v.any())),
+            },
+            handler: async (ctx, args) => {
+                if (args.fn) {
+                    // This is a one-off execution from the CLI or dashboard.
+                    // While not the recommended appproach, it's helpful for one-offs and
+                    // compatibility with the old way of running migrations.
+                    return (await this._runInteractive(ctx, args));
+                }
+                else if (args.next?.length) {
+                    throw new Error("You can only pass next if you also provide fn");
+                }
+                else if (args.cursor === undefined ||
+                    args.cursor === "" ||
+                    args.dryRun === undefined ||
+                    args.batchSize === 0) {
+                    console.warn("Running this from the CLI or dashboard? Here's some args to use:");
+                    console.warn({
+                        "Dry run": '{ "dryRun": true, "cursor": null }',
+                        "For real": '{ "fn": "path/to/migrations:yourFnName" }',
+                    });
+                }
+                const numItems = args.batchSize || defaultBatchSize;
+                if (args.cursor === undefined || args.cursor === "") {
+                    if (args.dryRun === undefined) {
+                        console.warn("No cursor or dryRun specified - doing a dry run on the next batch.");
+                        args.cursor = null;
+                        args.dryRun = true;
+                    }
+                    else if (args.dryRun) {
+                        console.warn("Setting cursor to null for dry run");
+                        args.cursor = null;
+                    }
+                    else {
+                        throw new Error(`Cursor must be specified for a one-off execution.
+              Use null to start from the beginning.
+              Use the value in the migrations database to pick up from where it left off.`);
+                    }
+                }
+                const q = ctx.db.query(table);
+                const range = customRange ? customRange(q, args.args) : q;
+                let continueCursor;
+                let page;
+                let isDone;
+                try {
+                    ({ continueCursor, page, isDone } = await range.paginate({
+                        cursor: args.cursor,
+                        numItems,
+                    }));
+                }
+                catch (e) {
+                    console.error("Error paginating. This can happen if the migration " +
+                        "was initially run on a different table, different custom range, " +
+                        "or you upgraded convex-helpers with in-progress migrations. " +
+                        "This creates an invalid pagination cursor. " +
+                        "Run all migrations to completion on the old cursor, or re-run " +
+                        "them explicitly with the cursor set to null. " +
+                        "If the problem persists, contact support@convex.dev");
+                    throw e;
+                }
+                async function doOne(doc) {
+                    try {
+                        const next = await migrateOne(ctx, doc, args.args);
+                        if (next && Object.keys(next).length > 0) {
+                            await ctx.db.patch(doc._id, next);
+                        }
+                    }
+                    catch (error) {
+                        console.error(`Document failed: ${doc._id}`);
+                        throw error;
+                    }
+                }
+                if (parallelize) {
+                    await Promise.all(page.map(doOne));
+                }
+                else {
+                    for (const doc of page) {
+                        await doOne(doc);
+                    }
+                }
+                const result = {
+                    continueCursor,
+                    isDone,
+                    processed: page.length,
+                };
+                if (args.dryRun) {
+                    // Throwing an error rolls back the transaction
+                    let anyChanges = false;
+                    let printedChanges = 0;
+                    for (const before of page) {
+                        const after = await ctx.db.get(before._id);
+                        if (JSON.stringify(after) !== JSON.stringify(before)) {
+                            anyChanges = true;
+                            printedChanges++;
+                            if (printedChanges > 10) {
+                                console.debug("DRY RUN: More than 10 changes were found in the first page. Skipping the rest.");
+                                break;
+                            }
+                            console.debug("DRY RUN: Example change", {
+                                before,
+                                after,
+                            });
+                        }
+                    }
+                    if (!anyChanges) {
+                        console.debug("DRY RUN: No changes were found in the first page. " +
+                            `Try {"dryRun": true, "cursor": "${continueCursor}"}`);
+                    }
+                    throw new ConvexError({
+                        kind: "DRY RUN",
+                        result,
+                    });
+                }
+                if (args.dryRun === undefined) {
+                    // We are running it in a one-off mode.
+                    // The component will always provide dryRun.
+                    // A bit of a hack / implicit, but non-critical logging.
+                    console.debug(`Next cursor: ${continueCursor}`);
+                }
+                return result;
+            },
+        });
+    }
+    /**
+     * Start a migration from a server function via a function reference.
+     *
+     * ```ts
+     * const migrations = new Migrations(components.migrations, { internalMutation });
+     *
+     * // in a mutation or action:
+     *   await migrations.runOne(ctx, internal.migrations.myMigration, {
+     *     cursor: null, // optional override
+     *     batchSize: 10, // optional override
+     *   });
+     * ```
+     *
+     * Overrides any options you passed in, such as resetting the cursor.
+     * If it's already in progress, it will no-op.
+     * If you run a migration that had previously failed which was part of a series,
+     * it will not resume the series.
+     * To resume a series, call the series again: {@link Migrations.runSerially}.
+     *
+     * Note: It's up to you to determine if it's safe to run a migration while
+     * others are in progress. It won't run multiple instance of the same migration
+     * but it currently allows running multiple migrations on the same table.
+     *
+     * @param ctx Context from a mutation or action. Needs `runMutation`.
+     * @param fnRef The migration function to run. Like `internal.migrations.foo`.
+     * @param opts Options to start the migration.
+     * @param opts.cursor The cursor to start from.
+     *   null: start from the beginning.
+     *   undefined: start or resume from where it failed. If done, it won't restart.
+     * @param opts.batchSize The number of documents to process in a batch.
+     * @param opts.dryRun If true, it will run a batch and then throw an error.
+     *   It's helpful to see what it would do without committing the transaction.
+     */
+    async runOne(ctx, fnRef, opts) {
+        const baseName = getFunctionName(fnRef);
+        return ctx.runMutation(this.component.lib.migrate, {
+            name: migrationNameWithArgs(baseName, opts?.args),
+            fnHandle: await createFunctionHandle(fnRef),
+            cursor: opts?.cursor,
+            batchSize: opts?.batchSize,
+            dryRun: opts?.dryRun ?? false,
+            args: opts?.args,
+        });
+    }
+    /**
+     * Start a series of migrations, running one a time. Each call starts a series.
+     *
+     * ```ts
+     * const migrations = new Migrations(components.migrations, { internalMutation });
+     *
+     * // in a mutation or action:
+     *   await migrations.runSerially(ctx, [
+     *    internal.migrations.myMigration,
+     *    internal.migrations.myOtherMigration,
+     *   ]);
+     * ```
+     *
+     * It runs one batch at a time currently.
+     * If a migration has previously completed it will skip it.
+     * If a migration had partial progress, it will resume from where it left off.
+     * If a migration is already in progress when attempted, it will no-op.
+     * If a migration fails or is canceled, it will stop executing and NOT execute
+     * any subsequent migrations in the series. Call the series again to retry.
+     *
+     * This is useful to run as an post-deploy script where you specify all the
+     * live migrations that should be run.
+     *
+     * Note: if you start multiple serial migrations, the behavior is:
+     * - If they don't overlap on functions, they will happily run in parallel.
+     * - If they have a function in common and one completes before the other
+     *   attempts it, the second will just skip it.
+     * - If they have a function in common and one is in progress, the second will
+     *   no-op and not run any further migrations in its series.
+     *
+     * To stop a migration in progress, see {@link cancelMigration}.
+     *
+     * @param ctx Context from a mutation or action. Needs `runMutation`.
+     * @param fnRefs The migrations to run in order. Like [internal.migrations.foo].
+     */
+    async runSerially(ctx, fnRefs) {
+        if (fnRefs.length === 0)
+            return;
+        const [fnRef, ...rest] = fnRefs;
+        const next = await Promise.all(rest.map(async (fnRef) => ({
+            name: getFunctionName(fnRef),
+            fnHandle: await createFunctionHandle(fnRef),
+        })));
+        return ctx.runMutation(this.component.lib.migrate, {
+            name: getFunctionName(fnRef),
+            fnHandle: await createFunctionHandle(fnRef),
+            next,
+            dryRun: false,
+        });
+    }
+    /**
+     * Get the status of a migration or all migrations.
+     * @param ctx Context from a query, mutation or action. Needs `runQuery`.
+     * @param migrations The migrations to get the status of. Defaults to all.
+     * @param limit How many migrations to fetch, if not specified by name.
+     * @returns The status of the migrations, in the order of the input.
+     */
+    async getStatus(ctx, { migrations, limit, }) {
+        const names = migrations?.map((m) => typeof m === "string" ? this.prefixedName(m) : getFunctionName(m));
+        return ctx.runQuery(this.component.lib.getStatus, {
+            names,
+            limit,
+        });
+    }
+    /**
+     * Cancels a migration if it's in progress.
+     * You can resume it later by calling the migration without an explicit cursor.
+     * If the migration had "next" migrations, e.g. from {@link runSerially},
+     * they will not run. To resume, call the series again or manually pass "next".
+     * @param ctx Context from a mutation or action. Needs `runMutation`.
+     * @param migration Migration to cancel. Either the name like "migrations:foo"
+     * or the function reference like `internal.migrations.foo`.
+     * @returns The status of the migration after attempting to cancel it.
+     */
+    async cancel(ctx, migration) {
+        const name = typeof migration === "string"
+            ? this.prefixedName(migration)
+            : getFunctionName(migration);
+        return ctx.runMutation(this.component.lib.cancel, { name });
+    }
+    /**
+     * Cancels all migrations that are in progress.
+     * You can resume it later by calling the migration without an explicit cursor.
+     * If the migration had "next" migrations, e.g. from {@link runSerially},
+     * they will not run. To resume, call the series again or manually pass "next".
+     * @param ctx Context from a mutation or action. Needs `runMutation`.
+     * @returns The status of up to 100 of the canceled migrations.
+     */
+    async cancelAll(ctx) {
+        return ctx.runMutation(this.component.lib.cancelAll, {});
+    }
+    // Helper to prefix the name with the location.
+    // migrationsLocationPrefix of "bar/baz:" and name "foo" => "bar/baz:foo"
+    prefixedName(name) {
+        return this.options?.migrationsLocationPrefix && !name.includes(":")
+            ? `${this.options.migrationsLocationPrefix}${name}`
+            : name;
+    }
+}
+/**
+ * Start a migration and run it synchronously until it's done.
+ * If this function crashes, the migration will not continue.
+ *
+ * ```ts
+ * // In an action
+ * const toRun = internal.migrations.myMigration;
+ * await runToCompletion(ctx, components.migrations, toRun);
+ * ```
+ *
+ * If it's already in progress, it will no-op.
+ * If you run a migration that had previously failed which was part of a series,
+ * it will not resume the series.
+ * To resume a series, call the series again: {@link Migrations.runSerially}.
+ *
+ * Note: It's up to you to determine if it's safe to run a migration while
+ * others are in progress. It won't run multiple instances of the same migration
+ * but it currently allows running multiple migrations on the same table.
+ *
+ * @param ctx Context from an action.
+ * @param component The migrations component, usually `components.migrations`.
+ * @param fnRef The migration function to run. Like `internal.migrations.foo`.
+ * @param opts Options to start the migration.
+ *   It's helpful to see what it would do without committing the transaction.
+ */
+export async function runToCompletion(ctx, component, fnRef, opts) {
+    let cursor = opts?.cursor;
+    const { name: nameOverride, batchSize, dryRun = false, args, } = opts ?? {};
+    const name = nameOverride ?? migrationNameWithArgs(getFunctionName(fnRef), args);
+    const address = getFunctionAddress(fnRef);
+    const fnHandle = address.functionHandle ?? (await createFunctionHandle(fnRef));
+    while (true) {
+        const status = await ctx.runMutation(component.lib.migrate, {
+            name,
+            fnHandle,
+            cursor,
+            batchSize,
+            dryRun,
+            args,
+            oneBatchOnly: true,
+        });
+        if (status.isDone) {
+            return status;
+        }
+        if (status.error) {
+            throw new Error(status.error);
+        }
+        if (!status.cursor || status.cursor === cursor) {
+            throw new Error("Invariant violation: Migration did not make progress." +
+                `\nStatus: ${JSON.stringify(status)}`);
+        }
+        cursor = status.cursor;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/client/log.d.ts

@@ -0,0 +1,8 @@
+import type { MigrationStatus } from "../shared.js";
+export declare function logStatusAndInstructions(name: string, status: MigrationStatus, args: {
+    fn?: string;
+    cursor?: string | null;
+    batchSize?: number;
+    dryRun?: boolean;
+}): Record<string, unknown>;
+//# sourceMappingURL=log.d.ts.map

package/dist/client/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/client/log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE;IACJ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,2BAiEF"}

package/dist/client/log.js

@@ -0,0 +1,74 @@
+export function logStatusAndInstructions(name, status, args) {
+    const output = {};
+    if (status.isDone) {
+        if (status.latestEnd < Date.now()) {
+            output["Status"] = "Migration already done.";
+        }
+        else if (status.latestStart === status.latestEnd) {
+            output["Status"] = "Migration was started and finished in one batch.";
+        }
+        else {
+            output["Status"] = "Migration completed with this batch.";
+        }
+    }
+    else {
+        if (status.state === "failed") {
+            output["Status"] = `Migration failed: ${status.error}`;
+        }
+        else if (status.state === "canceled") {
+            output["Status"] = "Migration canceled.";
+        }
+        else if (status.latestStart >= Date.now()) {
+            output["Status"] = "Migration started.";
+        }
+        else {
+            output["Status"] = "Migration running.";
+        }
+    }
+    if (args.dryRun) {
+        output["DryRun"] = "No changes were committed.";
+        output["Status"] = "DRY RUN: " + output["Status"];
+    }
+    output["Name"] = name;
+    output["lastStarted"] = new Date(status.latestStart).toISOString();
+    if (status.latestEnd) {
+        output["lastFinished"] = new Date(status.latestEnd).toISOString();
+    }
+    output["processed"] = status.processed;
+    if (status.next?.length) {
+        if (status.isDone) {
+            output["nowUp"] = status.next;
+        }
+        else {
+            output["nextUp"] = status.next;
+        }
+    }
+    const nextArgs = (status.next || []).map((n) => `"${n}"`).join(", ");
+    const run = `npx convex run --component migrations`;
+    if (!args.dryRun) {
+        if (status.state === "inProgress") {
+            output["toCancel"] = {
+                cmd: `${run} lib:cancel`,
+                args: `{"name": "${name}"}`,
+                prod: `--prod`,
+            };
+            output["toMonitorStatus"] = {
+                cmd: `${run} --watch lib:getStatus`,
+                args: `{"names": ["${name}"${status.next?.length ? ", " + nextArgs : ""}]}`,
+                prod: `--prod`,
+            };
+        }
+        else {
+            output["toStartOver"] = JSON.stringify({ ...args, cursor: null });
+            if (status.next?.length) {
+                output["toMonitorStatus"] = {
+                    cmd: `${run} --watch lib:getStatus`,
+                    args: `{"names": [${nextArgs}]}`,
+                    prod: `--prod`,
+                };
+            }
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=log.js.map

package/dist/client/log.js.map

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