@njdamstra/appwrite-utils-cli 1.11.2 → 1.11.3

package/dist/cli/commands/migrateCommands.js

@@ -1,5 +1,6 @@
 import inquirer from "inquirer";
 import path from "node:path";
+import fs from "node:fs";
 import { MessageFormatter } from "@njdamstra/appwrite-utils-helpers";
 import { analyzeStringAttributes, executeMigrationPlan, } from "../../migrations/migrateStrings.js";
 export const migrateCommands = {
@@ -94,6 +95,27 @@ export const migrateCommands = {
                 default: path.join(process.cwd(), "migrate-strings-plan.yaml"),
             },
         ]);
+        // Check for existing checkpoint
+        let freshRun = false;
+        const checkpointPath = planPath.replace(/\.ya?ml$/, ".checkpoint.json");
+        if (fs.existsSync(checkpointPath)) {
+            const { cpAction } = await inquirer.prompt([
+                {
+                    type: "list",
+                    name: "cpAction",
+                    message: "Found an existing checkpoint from a previous run. What would you like to do?",
+                    choices: [
+                        { name: "Resume — continue from where it left off", value: "resume" },
+                        { name: "Start fresh — delete checkpoint and start over", value: "fresh" },
+                        { name: "Cancel", value: "cancel" },
+                    ],
+                },
+            ]);
+            if (cpAction === "cancel")
+                return;
+            if (cpAction === "fresh")
+                freshRun = true;
+        }
         const { keepBackups } = await inquirer.prompt([
             {
                 type: "confirm",
@@ -114,6 +136,7 @@ export const migrateCommands = {
             planPath,
             keepBackups,
             dryRun,
+            freshRun,
         };
         try {
             const results = await executeMigrationPlan(controller.adapter, options);

package/dist/main.js

@@ -485,6 +485,11 @@ const argv = yargs(hideBin(process.argv))
     alias: ["migrate-strings-dry-run"],
     type: "boolean",
     description: "Dry run — show what would happen without making changes",
+})
+    .option("migrateStringsFresh", {
+    alias: ["migrate-strings-fresh"],
+    type: "boolean",
+    description: "Ignore existing checkpoint and start migration fresh",
 })
     .parse();
 async function main() {
@@ -674,6 +679,7 @@ async function main() {
                     planPath: argv.migrateStringsExecute,
                     keepBackups: argv.migrateStringsKeepBackups ?? true,
                     dryRun: argv.migrateStringsDryRun ?? false,
+                    freshRun: argv.migrateStringsFresh ?? false,
                 });
                 if (results.failed > 0) {
                     process.exit(1);

package/dist/migrations/migrateStrings.js

@@ -193,6 +193,12 @@ export async function executeMigrationPlan(adapter, options) {
     // Load or create checkpoint
     const checkpointPath = options.checkpointPath ||
         options.planPath.replace(/\.ya?ml$/, ".checkpoint.json");
+    if (options.freshRun && fs.existsSync(checkpointPath)) {
+        fs.unlinkSync(checkpointPath);
+        MessageFormatter.info("Deleted old checkpoint — starting fresh.", {
+            prefix: "Checkpoint",
+        });
+    }
     const checkpoint = loadOrCreateCheckpoint(checkpointPath, options.planPath);
     const batchSize = options.batchSize || 100;
     const batchDelayMs = options.batchDelayMs || 50;

package/dist/migrations/migrateStringsTypes.d.ts

@@ -191,6 +191,7 @@ export interface ExecuteOptions {
     batchSize?: number;
     batchDelayMs?: number;
     checkpointPath?: string;
+    freshRun?: boolean;
 }
 export declare function suggestTargetType(size: number, hasIndex: boolean): MigrationTargetType;
 export declare function generateBackupKey(originalKey: string): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@njdamstra/appwrite-utils-cli",
   "description": "Appwrite Utility Functions to help with database management, data conversion, data import, migrations, and much more. Meant to be used as a CLI tool, I do not recommend installing this in frontend environments.",
-  "version": "1.11.2",
+  "version": "1.11.3",
   "main": "dist/main.js",
   "type": "module",
   "repository": {

package/src/cli/commands/migrateCommands.ts

@@ -1,5 +1,6 @@
 import inquirer from "inquirer";
 import path from "node:path";
+import fs from "node:fs";
 import { MessageFormatter } from "@njdamstra/appwrite-utils-helpers";
 import type { InteractiveCLI } from "../../interactiveCLI.js";
 import {
@@ -121,6 +122,26 @@ export const migrateCommands = {
       },
     ]);
 
+    // Check for existing checkpoint
+    let freshRun = false;
+    const checkpointPath = planPath.replace(/\.ya?ml$/, ".checkpoint.json");
+    if (fs.existsSync(checkpointPath)) {
+      const { cpAction } = await inquirer.prompt([
+        {
+          type: "list",
+          name: "cpAction",
+          message: "Found an existing checkpoint from a previous run. What would you like to do?",
+          choices: [
+            { name: "Resume — continue from where it left off", value: "resume" },
+            { name: "Start fresh — delete checkpoint and start over", value: "fresh" },
+            { name: "Cancel", value: "cancel" },
+          ],
+        },
+      ]);
+      if (cpAction === "cancel") return;
+      if (cpAction === "fresh") freshRun = true;
+    }
+
     const { keepBackups } = await inquirer.prompt([
       {
         type: "confirm",
@@ -143,6 +164,7 @@ export const migrateCommands = {
       planPath,
       keepBackups,
       dryRun,
+      freshRun,
     };
 
     try {

package/src/main.ts

@@ -89,6 +89,7 @@ interface CliOptions {
   migrateStringsDbIds?: string;
   migrateStringsKeepBackups?: boolean;
   migrateStringsDryRun?: boolean;
+  migrateStringsFresh?: boolean;
 }
 
 type ParsedArgv = ArgumentsCamelCase<CliOptions>;
@@ -659,6 +660,11 @@ const argv = yargs(hideBin(process.argv))
     type: "boolean",
     description: "Dry run — show what would happen without making changes",
   })
+  .option("migrateStringsFresh", {
+    alias: ["migrate-strings-fresh"],
+    type: "boolean",
+    description: "Ignore existing checkpoint and start migration fresh",
+  })
   .parse() as ParsedArgv;
 
 async function main() {
@@ -915,6 +921,7 @@ async function main() {
           planPath: argv.migrateStringsExecute,
           keepBackups: argv.migrateStringsKeepBackups ?? true,
           dryRun: argv.migrateStringsDryRun ?? false,
+          freshRun: argv.migrateStringsFresh ?? false,
         });
         if (results.failed > 0) {
           process.exit(1);

package/src/migrations/migrateStrings.ts

@@ -264,6 +264,12 @@ export async function executeMigrationPlan(
   const checkpointPath =
     options.checkpointPath ||
     options.planPath.replace(/\.ya?ml$/, ".checkpoint.json");
+  if (options.freshRun && fs.existsSync(checkpointPath)) {
+    fs.unlinkSync(checkpointPath);
+    MessageFormatter.info("Deleted old checkpoint — starting fresh.", {
+      prefix: "Checkpoint",
+    });
+  }
   const checkpoint = loadOrCreateCheckpoint(checkpointPath, options.planPath);
 
   const batchSize = options.batchSize || 100;

package/src/migrations/migrateStringsTypes.ts

@@ -118,6 +118,7 @@ export interface ExecuteOptions {
   batchSize?: number;
   batchDelayMs?: number;
   checkpointPath?: string;
+  freshRun?: boolean;
 }
 
 // ── Helper: suggest target type from size + index presence ──