@njdamstra/appwrite-utils-cli 1.11.1 → 1.11.2

package/dist/cli/commands/migrateCommands.js

@@ -37,6 +37,30 @@ export const migrateCommands = {
             MessageFormatter.error("No database adapter available. Ensure a server connection is established.", undefined, { prefix: "Analyze" });
             return;
         }
+        // Prompt for database selection
+        const allDatabases = controller.config.databases || [];
+        let databaseIds;
+        if (allDatabases.length > 1) {
+            const { selectedDbs } = await inquirer.prompt([
+                {
+                    type: "checkbox",
+                    name: "selectedDbs",
+                    message: "Select databases to include in the analysis:",
+                    choices: allDatabases.map((db) => ({
+                        name: `${db.name} (${db.$id})`,
+                        value: db.$id,
+                        checked: true,
+                    })),
+                },
+            ]);
+            if (selectedDbs.length === 0) {
+                MessageFormatter.warning("No databases selected. Aborting.", { prefix: "Analyze" });
+                return;
+            }
+            if (selectedDbs.length < allDatabases.length) {
+                databaseIds = selectedDbs;
+            }
+        }
         // Prompt for output path
         const { outputPath } = await inquirer.prompt([
             {
@@ -46,7 +70,7 @@ export const migrateCommands = {
                 default: path.join(process.cwd(), "migrate-strings-plan.yaml"),
             },
         ]);
-        const options = { outputPath };
+        const options = { outputPath, databaseIds };
         try {
             await analyzeStringAttributes(controller.adapter, controller.config, options);
             MessageFormatter.success("Analysis complete. Review the YAML plan, edit targetType/action as needed, then run Execute.", { prefix: "Analyze" });

package/dist/main.js

@@ -469,6 +469,11 @@ const argv = yargs(hideBin(process.argv))
     alias: ["migrate-strings-output"],
     type: "string",
     description: "Output path for the migration plan (default: ./migrate-strings-plan.yaml)",
+})
+    .option("migrateStringsDbIds", {
+    alias: ["migrate-strings-db-ids"],
+    type: "string",
+    description: "Comma-separated database IDs to include in analysis (default: all)",
 })
     .option("migrateStringsKeepBackups", {
     alias: ["migrate-strings-keep-backups"],
@@ -652,8 +657,12 @@ async function main() {
                     MessageFormatter.error("No database adapter available. Ensure config has valid credentials.", undefined, { prefix: "Migration" });
                     return;
                 }
+                const databaseIds = argv.migrateStringsDbIds
+                    ? argv.migrateStringsDbIds.split(",").map((s) => s.trim()).filter(Boolean)
+                    : undefined;
                 await analyzeStringAttributes(controller.adapter, controller.config, {
                     outputPath: argv.migrateStringsOutput,
+                    databaseIds,
                 });
             }
             else if (argv.migrateStringsExecute) {

package/dist/migrations/migrateStrings.js

@@ -11,7 +11,11 @@ import { MigrationPlanSchema, MigrationCheckpointSchema, suggestTargetType, gene
 // Phase 1: Analyze — queries Appwrite server for real state
 // ────────────────────────────────────────────────────────
 export async function analyzeStringAttributes(adapter, config, options = {}) {
-    const databases = config.databases || [];
+    let databasesToScan = config.databases || [];
+    if (options.databaseIds?.length) {
+        databasesToScan = databasesToScan.filter(db => options.databaseIds.includes(db.$id));
+    }
+    const databases = databasesToScan;
     if (databases.length === 0) {
         MessageFormatter.warning("No databases configured. Nothing to analyze.", {
             prefix: "Analyze",

package/dist/migrations/migrateStringsTypes.d.ts

@@ -182,6 +182,7 @@ export type MigrationCheckpoint = z.infer<typeof MigrationCheckpointSchema>;
 export interface AnalyzeOptions {
     outputPath?: string;
     verbose?: boolean;
+    databaseIds?: string[];
 }
 export interface ExecuteOptions {
     planPath: string;

package/dist/migrations/migrateStringsTypes.js

@@ -97,16 +97,17 @@ export function suggestTargetType(size, hasIndex) {
 }
 // ── Helper: generate backup key with length limits ──
 const MAX_KEY_LENGTH = 36;
-const BACKUP_PREFIX = "_mig_";
+const BACKUP_PREFIX = "mig_";
 export function generateBackupKey(originalKey) {
     const candidate = `${BACKUP_PREFIX}${originalKey}`;
     if (candidate.length <= MAX_KEY_LENGTH) {
         return candidate;
     }
-    // Truncate + 4-char hash for uniqueness
+    // Truncate + 4-char hash for uniqueness: m_ + orig + _ + hash(4)
     const hash = simpleHash(originalKey);
-    const maxOrigLen = MAX_KEY_LENGTH - BACKUP_PREFIX.length - 1 - 4; // _mig_ + _ + hash4
-    return `_m_${originalKey.slice(0, maxOrigLen)}_${hash}`;
+    const TRUNC_PREFIX = "m_";
+    const maxOrigLen = MAX_KEY_LENGTH - TRUNC_PREFIX.length - 1 - 4;
+    return `${TRUNC_PREFIX}${originalKey.slice(0, maxOrigLen)}_${hash}`;
 }
 function simpleHash(str) {
     let h = 0;

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.1",
+  "version": "1.11.2",
   "main": "dist/main.js",
   "type": "module",
   "repository": {

package/src/cli/commands/migrateCommands.ts

@@ -48,6 +48,31 @@ export const migrateCommands = {
       return;
     }
 
+    // Prompt for database selection
+    const allDatabases = controller.config.databases || [];
+    let databaseIds: string[] | undefined;
+    if (allDatabases.length > 1) {
+      const { selectedDbs } = await inquirer.prompt([
+        {
+          type: "checkbox",
+          name: "selectedDbs",
+          message: "Select databases to include in the analysis:",
+          choices: allDatabases.map((db: any) => ({
+            name: `${db.name} (${db.$id})`,
+            value: db.$id,
+            checked: true,
+          })),
+        },
+      ]);
+      if (selectedDbs.length === 0) {
+        MessageFormatter.warning("No databases selected. Aborting.", { prefix: "Analyze" });
+        return;
+      }
+      if (selectedDbs.length < allDatabases.length) {
+        databaseIds = selectedDbs;
+      }
+    }
+
     // Prompt for output path
     const { outputPath } = await inquirer.prompt([
       {
@@ -58,7 +83,7 @@ export const migrateCommands = {
       },
     ]);
 
-    const options: AnalyzeOptions = { outputPath };
+    const options: AnalyzeOptions = { outputPath, databaseIds };
 
     try {
       await analyzeStringAttributes(controller.adapter, controller.config, options);

package/src/main.ts

@@ -86,6 +86,7 @@ interface CliOptions {
   migrateStringsAnalyze?: boolean;
   migrateStringsExecute?: string;
   migrateStringsOutput?: string;
+  migrateStringsDbIds?: string;
   migrateStringsKeepBackups?: boolean;
   migrateStringsDryRun?: boolean;
 }
@@ -642,6 +643,11 @@ const argv = yargs(hideBin(process.argv))
     type: "string",
     description: "Output path for the migration plan (default: ./migrate-strings-plan.yaml)",
   })
+  .option("migrateStringsDbIds", {
+    alias: ["migrate-strings-db-ids"],
+    type: "string",
+    description: "Comma-separated database IDs to include in analysis (default: all)",
+  })
   .option("migrateStringsKeepBackups", {
     alias: ["migrate-strings-keep-backups"],
     type: "boolean",
@@ -889,8 +895,12 @@ async function main() {
           );
           return;
         }
+        const databaseIds = argv.migrateStringsDbIds
+          ? argv.migrateStringsDbIds.split(",").map((s: string) => s.trim()).filter(Boolean)
+          : undefined;
         await analyzeStringAttributes(controller.adapter, controller.config, {
           outputPath: argv.migrateStringsOutput,
+          databaseIds,
         });
       } else if (argv.migrateStringsExecute) {
         if (!controller.adapter) {

package/src/migrations/migrateStrings.ts

@@ -34,7 +34,11 @@ export async function analyzeStringAttributes(
   config: AppwriteConfig,
   options: AnalyzeOptions = {}
 ): Promise<MigrationPlan> {
-  const databases = config.databases || [];
+  let databasesToScan = config.databases || [];
+  if (options.databaseIds?.length) {
+    databasesToScan = databasesToScan.filter(db => options.databaseIds!.includes(db.$id));
+  }
+  const databases = databasesToScan;
   if (databases.length === 0) {
     MessageFormatter.warning("No databases configured. Nothing to analyze.", {
       prefix: "Analyze",

package/src/migrations/migrateStringsTypes.ts

@@ -108,6 +108,7 @@ export type MigrationCheckpoint = z.infer<typeof MigrationCheckpointSchema>;
 export interface AnalyzeOptions {
   outputPath?: string;
   verbose?: boolean;
+  databaseIds?: string[];
 }
 
 export interface ExecuteOptions {
@@ -136,17 +137,18 @@ export function suggestTargetType(
 // ── Helper: generate backup key with length limits ──
 
 const MAX_KEY_LENGTH = 36;
-const BACKUP_PREFIX = "_mig_";
+const BACKUP_PREFIX = "mig_";
 
 export function generateBackupKey(originalKey: string): string {
   const candidate = `${BACKUP_PREFIX}${originalKey}`;
   if (candidate.length <= MAX_KEY_LENGTH) {
     return candidate;
   }
-  // Truncate + 4-char hash for uniqueness
+  // Truncate + 4-char hash for uniqueness: m_ + orig + _ + hash(4)
   const hash = simpleHash(originalKey);
-  const maxOrigLen = MAX_KEY_LENGTH - BACKUP_PREFIX.length - 1 - 4; // _mig_ + _ + hash4
-  return `_m_${originalKey.slice(0, maxOrigLen)}_${hash}`;
+  const TRUNC_PREFIX = "m_";
+  const maxOrigLen = MAX_KEY_LENGTH - TRUNC_PREFIX.length - 1 - 4;
+  return `${TRUNC_PREFIX}${originalKey.slice(0, maxOrigLen)}_${hash}`;
 }
 
 function simpleHash(str: string): string {