appwrite-utils-cli 1.9.7 → 1.11.0

package/dist/main.js

@@ -1,1180 +0,0 @@
-#!/usr/bin/env node
-import yargs from "yargs";
-import {} from "yargs";
-import { hideBin } from "yargs/helpers";
-import { InteractiveCLI } from "./interactiveCLI.js";
-import { UtilsController } from "./utilsController.js";
-import { Databases, Storage } from "node-appwrite";
-import { getClient } from "./utils/getClientFromConfig.js";
-import { fetchAllDatabases } from "./databases/methods.js";
-import { setupDirsFiles } from "./utils/setupFiles.js";
-import { fetchAllCollections } from "./collections/methods.js";
-import chalk from "chalk";
-import { listSpecifications } from "./functions/methods.js";
-import { MessageFormatter } from "./shared/messageFormatter.js";
-import { ConfirmationDialogs } from "./shared/confirmationDialogs.js";
-import { SelectionDialogs } from "./shared/selectionDialogs.js";
-import { logger } from "./shared/logging.js";
-import path from "path";
-import fs from "fs";
-import { createRequire } from "node:module";
-import { loadAppwriteProjectConfig, findAppwriteProjectConfig, projectConfigToAppwriteConfig, } from "./utils/projectConfig.js";
-import { hasSessionAuth, getAvailableSessions, getAuthenticationStatus, } from "./utils/sessionAuth.js";
-import { findYamlConfig, loadYamlConfigWithSession, } from "./config/yamlConfig.js";
-const require = createRequire(import.meta.url);
-if (!globalThis.require) {
-    globalThis.require = require;
-}
-/**
- * Enhanced sync function with intelligent configuration detection and selection dialogs
- */
-async function performEnhancedSync(controller, parsedArgv) {
-    try {
-        MessageFormatter.banner("Enhanced Sync", "Intelligent configuration detection and selection");
-        if (!controller.config) {
-            MessageFormatter.error("No Appwrite configuration found", undefined, { prefix: "Sync" });
-            return null;
-        }
-        // Get all available databases from remote
-        const availableDatabases = await fetchAllDatabases(controller.database);
-        if (availableDatabases.length === 0) {
-            MessageFormatter.warning("No databases found in remote project", { prefix: "Sync" });
-            return null;
-        }
-        // Get existing configuration
-        const configuredDatabases = controller.config.databases || [];
-        const configuredBuckets = controller.config.buckets || [];
-        // Check if we have existing configuration
-        const hasExistingConfig = configuredDatabases.length > 0 || configuredBuckets.length > 0;
-        let syncExisting = false;
-        let modifyConfiguration = true;
-        if (hasExistingConfig) {
-            // Prompt about existing configuration
-            const response = await SelectionDialogs.promptForExistingConfig([
-                ...configuredDatabases,
-                ...configuredBuckets
-            ]);
-            syncExisting = response.syncExisting;
-            modifyConfiguration = response.modifyConfiguration;
-            if (syncExisting && !modifyConfiguration) {
-                // Just sync existing configuration without changes
-                MessageFormatter.info("Syncing existing configuration without modifications", { prefix: "Sync" });
-                // Convert configured databases to DatabaseSelection format
-                const databaseSelections = configuredDatabases.map(db => ({
-                    databaseId: db.$id,
-                    databaseName: db.name,
-                    tableIds: [], // Tables will be populated from collections config
-                    tableNames: [],
-                    isNew: false
-                }));
-                // Convert configured buckets to BucketSelection format
-                const bucketSelections = configuredBuckets.map(bucket => ({
-                    bucketId: bucket.$id,
-                    bucketName: bucket.name,
-                    databaseId: undefined,
-                    databaseName: undefined,
-                    isNew: false
-                }));
-                const selectionSummary = SelectionDialogs.createSyncSelectionSummary(databaseSelections, bucketSelections);
-                const confirmed = await SelectionDialogs.confirmSyncSelection(selectionSummary, 'pull');
-                if (!confirmed) {
-                    MessageFormatter.info("Pull operation cancelled by user", { prefix: "Sync" });
-                    return null;
-                }
-                // Perform sync with existing configuration (pull from remote)
-                await controller.selectivePull(databaseSelections, bucketSelections);
-                return selectionSummary;
-            }
-        }
-        if (!modifyConfiguration) {
-            MessageFormatter.info("No configuration changes requested", { prefix: "Sync" });
-            return null;
-        }
-        // Allow new items selection based on user choice
-        const allowNewOnly = !syncExisting;
-        // Select databases
-        const selectedDatabaseIds = await SelectionDialogs.selectDatabases(availableDatabases, configuredDatabases, {
-            showSelectAll: false,
-            allowNewOnly,
-            defaultSelected: []
-        });
-        if (selectedDatabaseIds.length === 0) {
-            MessageFormatter.warning("No databases selected for sync", { prefix: "Sync" });
-            return null;
-        }
-        // For each selected database, get available tables and select them
-        const tableSelectionsMap = new Map();
-        const availableTablesMap = new Map();
-        for (const databaseId of selectedDatabaseIds) {
-            const database = availableDatabases.find(db => db.$id === databaseId);
-            SelectionDialogs.showProgress(`Fetching tables for database: ${database.name}`);
-            // Get available tables from remote
-            const availableTables = await fetchAllCollections(databaseId, controller.database);
-            availableTablesMap.set(databaseId, availableTables);
-            // Get configured tables for this database
-            // Note: Collections are stored globally in the config, not per database
-            const configuredTables = controller.config.collections || [];
-            // Select tables for this database
-            const selectedTableIds = await SelectionDialogs.selectTablesForDatabase(databaseId, database.name, availableTables, configuredTables, {
-                showSelectAll: false,
-                allowNewOnly,
-                defaultSelected: []
-            });
-            tableSelectionsMap.set(databaseId, selectedTableIds);
-            if (selectedTableIds.length === 0) {
-                MessageFormatter.warning(`No tables selected for database: ${database.name}`, { prefix: "Sync" });
-            }
-        }
-        // Select buckets
-        let selectedBucketIds = [];
-        // Get available buckets from remote
-        if (controller.storage) {
-            try {
-                // Note: We need to implement fetchAllBuckets or use storage.listBuckets
-                // For now, we'll use configured buckets as available
-                SelectionDialogs.showProgress("Fetching storage buckets...");
-                // Create a mock availableBuckets array - in real implementation,
-                // you'd fetch this from the Appwrite API
-                const availableBuckets = configuredBuckets; // Placeholder
-                selectedBucketIds = await SelectionDialogs.selectBucketsForDatabases(selectedDatabaseIds, availableBuckets, configuredBuckets, {
-                    showSelectAll: false,
-                    allowNewOnly: parsedArgv.selectBuckets ? false : allowNewOnly,
-                    groupByDatabase: true,
-                    defaultSelected: []
-                });
-            }
-            catch (error) {
-                MessageFormatter.warning("Could not fetch storage buckets", { prefix: "Sync" });
-                logger.warn("Failed to fetch buckets during sync", { error });
-            }
-        }
-        // Create selection objects
-        const databaseSelections = SelectionDialogs.createDatabaseSelection(selectedDatabaseIds, availableDatabases, tableSelectionsMap, configuredDatabases, availableTablesMap);
-        const bucketSelections = SelectionDialogs.createBucketSelection(selectedBucketIds, [], // availableBuckets - would be populated from API
-        configuredBuckets, availableDatabases);
-        // Show final confirmation
-        const selectionSummary = SelectionDialogs.createSyncSelectionSummary(databaseSelections, bucketSelections);
-        const confirmed = await SelectionDialogs.confirmSyncSelection(selectionSummary, 'pull');
-        if (!confirmed) {
-            MessageFormatter.info("Pull operation cancelled by user", { prefix: "Sync" });
-            return null;
-        }
-        // Perform the selective sync (pull from remote)
-        await controller.selectivePull(databaseSelections, bucketSelections);
-        MessageFormatter.success("Enhanced sync completed successfully", { prefix: "Sync" });
-        return selectionSummary;
-    }
-    catch (error) {
-        SelectionDialogs.showError("Enhanced sync failed", error instanceof Error ? error : new Error(String(error)));
-        return null;
-    }
-}
-/**
- * Performs selective sync with the given database and bucket selections
- */
-/**
- * Checks if the migration from collections to tables should be allowed
- * Returns an object with:
- * - allowed: boolean indicating if migration should proceed
- * - reason: string explaining why migration was blocked (if not allowed)
- */
-function checkMigrationConditions(configPath) {
-    const collectionsPath = path.join(configPath, "collections");
-    const tablesPath = path.join(configPath, "tables");
-    // Check if collections/ folder exists
-    if (!fs.existsSync(collectionsPath)) {
-        return {
-            allowed: false,
-            reason: "No collections/ folder found. Migration requires existing collections to migrate.",
-        };
-    }
-    // Check if collections/ folder has YAML files
-    const collectionFiles = fs
-        .readdirSync(collectionsPath)
-        .filter((file) => file.endsWith(".yaml") || file.endsWith(".yml"));
-    if (collectionFiles.length === 0) {
-        return {
-            allowed: false,
-            reason: "No YAML files found in collections/ folder. Migration requires existing collection YAML files.",
-        };
-    }
-    // Check if tables/ folder exists and has YAML files
-    if (fs.existsSync(tablesPath)) {
-        const tableFiles = fs
-            .readdirSync(tablesPath)
-            .filter((file) => file.endsWith(".yaml") || file.endsWith(".yml"));
-        if (tableFiles.length > 0) {
-            return {
-                allowed: false,
-                reason: `Tables folder already exists with ${tableFiles.length} YAML file(s). Migration appears to have already been completed.`,
-            };
-        }
-    }
-    // All conditions met
-    return { allowed: true };
-}
-const argv = yargs(hideBin(process.argv))
-    .option("config", {
-    type: "string",
-    description: "Path to Appwrite configuration file (appwriteConfig.ts)",
-})
-    .option("appwriteConfig", {
-    alias: ["appwrite-config", "use-appwrite-config"],
-    type: "boolean",
-    description: "Prefer loading from appwrite.config.json instead of config.yaml",
-})
-    .option("it", {
-    alias: ["interactive", "i"],
-    type: "boolean",
-    description: "Launch interactive CLI mode with guided prompts",
-})
-    .option("dbIds", {
-    type: "string",
-    description: "Comma-separated list of database IDs to target (e.g., 'db1,db2,db3')",
-})
-    .option("collectionIds", {
-    alias: ["collIds", "tableIds", "tables"],
-    type: "string",
-    description: "Comma-separated list of collection/table IDs to target (e.g., 'users,posts')",
-})
-    .option("bucketIds", {
-    type: "string",
-    description: "Comma-separated list of bucket IDs to operate on",
-})
-    .option("wipe", {
-    choices: ["all", "docs", "users"],
-    description: "⚠️  DESTRUCTIVE: Wipe data (all: databases+storage+users, docs: documents only, users: user accounts only)",
-})
-    .option("wipeCollections", {
-    type: "boolean",
-    description: "⚠️  DESTRUCTIVE: Wipe specific collections/tables (requires --collectionIds or --tableIds)",
-})
-    .option("transferUsers", {
-    type: "boolean",
-    description: "Transfer users between projects",
-})
-    .option("generate", {
-    type: "boolean",
-    description: "Generate TypeScript schemas and types from your Appwrite database schemas",
-})
-    .option("import", {
-    type: "boolean",
-    description: "Import data from importData/ directory into your Appwrite databases",
-})
-    .option("backup", {
-    type: "boolean",
-    description: "Create a complete backup of your databases and collections",
-})
-    .option("backupFormat", {
-    type: "string",
-    choices: ["json", "zip"],
-    default: "json",
-    description: "Backup file format (json or zip)",
-})
-    .option("listBackups", {
-    type: "boolean",
-    description: "List all backups for databases",
-})
-    .option("comprehensiveBackup", {
-    alias: ["comprehensive", "backup-all"],
-    type: "boolean",
-    description: "🚀 Create comprehensive backup of ALL databases and ALL storage buckets",
-})
-    .option("trackingDatabaseId", {
-    alias: ["tracking-db"],
-    type: "string",
-    description: "Database ID to use for centralized backup tracking (interactive prompt if not specified)",
-})
-    .option("parallelDownloads", {
-    type: "number",
-    default: 10,
-    description: "Number of parallel file downloads for bucket backups (default: 10)",
-})
-    .option("writeData", {
-    type: "boolean",
-    description: "Output converted import data to files for validation before importing",
-})
-    .option("push", {
-    type: "boolean",
-    description: "Deploy your local configuration (collections, attributes, indexes) to Appwrite",
-})
-    .option("sync", {
-    type: "boolean",
-    description: "Pull and synchronize your local config with the remote Appwrite project schema",
-})
-    .option("autoSync", {
-    alias: ["auto"],
-    type: "boolean",
-    description: "Skip prompts and sync all databases, tables, and buckets (current behavior)"
-})
-    .option("selectBuckets", {
-    type: "boolean",
-    description: "Force bucket selection dialog even if buckets are already configured"
-})
-    .option("endpoint", {
-    type: "string",
-    description: "Set the Appwrite endpoint",
-})
-    .option("projectId", {
-    type: "string",
-    description: "Set the Appwrite project ID",
-})
-    .option("apiKey", {
-    type: "string",
-    description: "Set the Appwrite API key",
-})
-    .option("transfer", {
-    type: "boolean",
-    description: "Transfer documents and files between databases, collections, or projects",
-})
-    .option("fromDbId", {
-    alias: ["fromDb", "sourceDbId", "sourceDb"],
-    type: "string",
-    description: "Source database ID for transfer operations",
-})
-    .option("toDbId", {
-    alias: ["toDb", "targetDbId", "targetDb"],
-    type: "string",
-    description: "Target database ID for transfer operations",
-})
-    .option("fromCollectionId", {
-    alias: ["fromCollId", "fromColl"],
-    type: "string",
-    description: "Set the source collection ID for transfer",
-})
-    .option("toCollectionId", {
-    alias: ["toCollId", "toColl"],
-    type: "string",
-    description: "Set the destination collection ID for transfer",
-})
-    .option("fromBucketId", {
-    type: "string",
-    description: "Set the source bucket ID for transfer",
-})
-    .option("toBucketId", {
-    type: "string",
-    description: "Set the destination bucket ID for transfer",
-})
-    .option("remoteEndpoint", {
-    type: "string",
-    description: "Set the remote Appwrite endpoint for transfer",
-})
-    .option("remoteProjectId", {
-    type: "string",
-    description: "Set the remote Appwrite project ID for transfer",
-})
-    .option("remoteApiKey", {
-    type: "string",
-    description: "Set the remote Appwrite API key for transfer",
-})
-    .option("setup", {
-    type: "boolean",
-    description: "Initialize project with configuration files and directory structure",
-})
-    .option("updateFunctionSpec", {
-    type: "boolean",
-    description: "Update function specifications",
-})
-    .option("functionId", {
-    type: "string",
-    description: "Function ID to update",
-})
-    .option("specification", {
-    type: "string",
-    description: "New function specification (e.g., 's-1vcpu-1gb')",
-    choices: [
-        "s-0.5vcpu-512mb",
-        "s-1vcpu-1gb",
-        "s-2vcpu-2gb",
-        "s-2vcpu-4gb",
-        "s-4vcpu-4gb",
-        "s-4vcpu-8gb",
-        "s-8vcpu-4gb",
-        "s-8vcpu-8gb",
-    ],
-})
-    .option("migrateConfig", {
-    alias: ["migrate"],
-    type: "boolean",
-    description: "Migrate appwriteConfig.ts to .appwrite structure with YAML configuration",
-})
-    .option("generateConstants", {
-    alias: ["constants"],
-    type: "boolean",
-    description: "Generate cross-language constants file with database, collection, bucket, and function IDs",
-})
-    .option("constantsLanguages", {
-    type: "string",
-    description: "Comma-separated list of languages for constants (typescript,javascript,python,php,dart,json,env)",
-    default: "typescript",
-})
-    .option("constantsOutput", {
-    type: "string",
-    description: "Output directory for generated constants files (default: config-folder/constants)",
-    default: "auto",
-})
-    .option("constantsInclude", {
-    type: "string",
-    description: "Comma-separated categories to include: databases,collections,buckets,functions",
-})
-    .option("generateSchemas", {
-    type: "boolean",
-    description: "Generate schemas/models without interactive prompts",
-})
-    .option("schemaFormat", {
-    type: "string",
-    choices: ["zod", "json", "pydantic", "both", "all"],
-    description: "Schema format: zod, json, pydantic, both (zod+json), or all",
-})
-    .option("schemaOutDir", {
-    type: "string",
-    description: "Output directory for generated schemas (absolute path respected)",
-})
-    .option("migrateCollectionsToTables", {
-    alias: ["migrate-collections"],
-    type: "boolean",
-    description: "Migrate collections to tables format for TablesDB API compatibility",
-})
-    .option("useSession", {
-    alias: ["session"],
-    type: "boolean",
-    description: "Use Appwrite CLI session authentication instead of API key",
-})
-    .option("sessionCookie", {
-    type: "string",
-    description: "Explicit session cookie to use for authentication",
-})
-    .parse();
-async function main() {
-    const startTime = Date.now();
-    const operationStats = {};
-    // Early session detection for better user guidance
-    const availableSessions = getAvailableSessions();
-    let hasAnyValidSessions = availableSessions.length > 0;
-    if (argv.it) {
-        const cli = new InteractiveCLI(process.cwd());
-        await cli.run();
-    }
-    else {
-        // Enhanced config creation with session and project file support
-        let directConfig = undefined;
-        // Show authentication status on startup if no config provided
-        if (!argv.config &&
-            !argv.endpoint &&
-            !argv.projectId &&
-            !argv.apiKey &&
-            !argv.useSession &&
-            !argv.sessionCookie) {
-            if (hasAnyValidSessions) {
-                MessageFormatter.info(`Found ${availableSessions.length} available session(s)`, { prefix: "Auth" });
-                availableSessions.forEach((session) => {
-                    MessageFormatter.info(`  \u2022 ${session.projectId} (${session.email || "unknown"}) at ${session.endpoint}`, { prefix: "Auth" });
-                });
-                MessageFormatter.info("Use --session to enable session authentication", { prefix: "Auth" });
-            }
-            else {
-                MessageFormatter.info("No active Appwrite sessions found", {
-                    prefix: "Auth",
-                });
-                MessageFormatter.info("\u2022 Run 'appwrite login' to authenticate with session", { prefix: "Auth" });
-                MessageFormatter.info("\u2022 Or provide --apiKey for API key authentication", { prefix: "Auth" });
-            }
-        }
-        // Priority 1: Check for appwrite.json project configuration
-        const projectConfigPath = findAppwriteProjectConfig(process.cwd());
-        if (projectConfigPath) {
-            const projectConfig = loadAppwriteProjectConfig(projectConfigPath);
-            if (projectConfig) {
-                directConfig = projectConfigToAppwriteConfig(projectConfig);
-                MessageFormatter.info(`Loaded project configuration from ${projectConfigPath}`, { prefix: "CLI" });
-            }
-        }
-        // Priority 2: CLI arguments override project config
-        if (argv.endpoint ||
-            argv.projectId ||
-            argv.apiKey ||
-            argv.useSession ||
-            argv.sessionCookie) {
-            directConfig = {
-                ...directConfig,
-                appwriteEndpoint: argv.endpoint || directConfig?.appwriteEndpoint,
-                appwriteProject: argv.projectId || directConfig?.appwriteProject,
-                appwriteKey: argv.apiKey || directConfig?.appwriteKey,
-            };
-        }
-        // Priority 3: Session authentication support with improved detection
-        let sessionAuthAvailable = false;
-        if (directConfig?.appwriteEndpoint && directConfig?.appwriteProject) {
-            sessionAuthAvailable = hasSessionAuth(directConfig.appwriteEndpoint, directConfig.appwriteProject);
-        }
-        if (argv.useSession || argv.sessionCookie) {
-            if (argv.sessionCookie) {
-                // Explicit session cookie provided
-                MessageFormatter.info("Using explicit session cookie for authentication", { prefix: "Auth" });
-            }
-            else if (sessionAuthAvailable) {
-                MessageFormatter.info("Session authentication detected and will be used", { prefix: "Auth" });
-            }
-            else {
-                MessageFormatter.warning("Session authentication requested but no valid session found", { prefix: "Auth" });
-                const availableSessions = getAvailableSessions();
-                if (availableSessions.length > 0) {
-                    MessageFormatter.info(`Available sessions: ${availableSessions
-                        .map((s) => `${s.projectId} (${s.email || "unknown"})`)
-                        .join(", ")}`, { prefix: "Auth" });
-                    MessageFormatter.info("Use --session flag to enable session authentication", { prefix: "Auth" });
-                }
-                else {
-                    MessageFormatter.warning("No Appwrite CLI sessions found. Please run 'appwrite login' first.", { prefix: "Auth" });
-                }
-                MessageFormatter.error("Session authentication requested but not available", undefined, { prefix: "Auth" });
-                return; // Exit early if session auth was requested but not available
-            }
-        }
-        else if (sessionAuthAvailable && !argv.apiKey) {
-            // Auto-detect session authentication when no API key is provided
-            MessageFormatter.info("Session authentication detected - no API key required", { prefix: "Auth" });
-            MessageFormatter.info("Use --session flag to explicitly enable session authentication", { prefix: "Auth" });
-        }
-        // Enhanced session authentication support:
-        // 1. If session auth is explicitly requested via flags, use it
-        // 2. If no API key is provided but sessions are available, offer to use session auth
-        // 3. Auto-detect session authentication when possible
-        let finalDirectConfig = directConfig;
-        if ((argv.useSession || argv.sessionCookie) &&
-            (!directConfig ||
-                !directConfig.appwriteEndpoint ||
-                !directConfig.appwriteProject)) {
-            // Don't pass incomplete directConfig - let UtilsController load YAML config normally
-            finalDirectConfig = null;
-        }
-        else if (finalDirectConfig &&
-            !finalDirectConfig.appwriteKey &&
-            !argv.useSession &&
-            !argv.sessionCookie) {
-            // Auto-detect session authentication when no API key provided
-            if (sessionAuthAvailable) {
-                MessageFormatter.info("No API key provided, but session authentication is available", { prefix: "Auth" });
-                MessageFormatter.info("Automatically using session authentication (add --session to suppress this message)", { prefix: "Auth" });
-                // Implicitly enable session authentication
-                argv.useSession = true;
-            }
-        }
-        // Create controller with session authentication support using singleton
-        const controller = UtilsController.getInstance(process.cwd(), finalDirectConfig);
-        // Pass session authentication and config options to the controller
-        const initOptions = {};
-        if (argv.useSession || argv.sessionCookie) {
-            initOptions.useSession = true;
-            if (argv.sessionCookie) {
-                initOptions.sessionCookie = argv.sessionCookie;
-            }
-        }
-        if (argv.appwriteConfig) {
-            initOptions.preferJson = true;
-        }
-        await controller.init(initOptions);
-        if (argv.setup) {
-            await setupDirsFiles(false, process.cwd());
-            return;
-        }
-        if (argv.migrateConfig) {
-            const { migrateConfig } = await import("./utils/configMigration.js");
-            await migrateConfig(process.cwd());
-            return;
-        }
-        if (argv.generateConstants) {
-            const { ConstantsGenerator } = await import("./utils/constantsGenerator.js");
-            if (!controller.config) {
-                MessageFormatter.error("No Appwrite configuration found", undefined, {
-                    prefix: "Constants",
-                });
-                return;
-            }
-            const languages = argv
-                .constantsLanguages.split(",")
-                .map((l) => l.trim());
-            // Determine output directory - use config folder/constants by default, or custom path if specified
-            let outputDir;
-            if (argv.constantsOutput === "auto") {
-                // Default case: use config directory + constants, fallback to current directory
-                const configPath = controller.getAppwriteFolderPath();
-                outputDir = configPath
-                    ? path.join(configPath, "constants")
-                    : path.join(process.cwd(), "constants");
-            }
-            else {
-                // Custom output directory specified
-                outputDir = argv.constantsOutput;
-            }
-            MessageFormatter.info(`Generating constants for languages: ${languages.join(", ")}`, { prefix: "Constants" });
-            const generator = new ConstantsGenerator(controller.config);
-            await generator.generateFiles(languages, outputDir);
-            operationStats.generatedConstants = languages.length;
-            MessageFormatter.success(`Constants generated in ${outputDir}`, {
-                prefix: "Constants",
-            });
-            return;
-        }
-        if (argv.migrateCollectionsToTables) {
-            try {
-                if (!controller.config) {
-                    MessageFormatter.error("No Appwrite configuration found", undefined, {
-                        prefix: "Migration",
-                    });
-                    return;
-                }
-                // Get the config path from the controller or use .appwrite in current directory
-                let configPath = controller.getAppwriteFolderPath();
-                if (!configPath) {
-                    // Try .appwrite in current directory
-                    const defaultPath = path.join(process.cwd(), ".appwrite");
-                    if (fs.existsSync(defaultPath)) {
-                        configPath = defaultPath;
-                    }
-                    else {
-                        MessageFormatter.error("Could not determine configuration folder path", undefined, { prefix: "Migration" });
-                        MessageFormatter.info("Make sure you have a .appwrite/ folder in your current directory", { prefix: "Migration" });
-                        return;
-                    }
-                }
-                // Check if migration conditions are met
-                const migrationCheck = checkMigrationConditions(configPath);
-                if (!migrationCheck.allowed) {
-                    MessageFormatter.error(`Migration not allowed: ${migrationCheck.reason}`, undefined, { prefix: "Migration" });
-                    MessageFormatter.info("Migration requirements:", {
-                        prefix: "Migration",
-                    });
-                    MessageFormatter.info("  • Configuration must be loaded (use --config or have .appwrite/ folder)", { prefix: "Migration" });
-                    MessageFormatter.info("  • collections/ folder must exist with YAML files", { prefix: "Migration" });
-                    MessageFormatter.info("  • tables/ folder must not exist or be empty", { prefix: "Migration" });
-                    return;
-                }
-                const { migrateCollectionsToTables } = await import("./config/configMigration.js");
-                MessageFormatter.info("Starting collections to tables migration...", {
-                    prefix: "Migration",
-                });
-                const result = migrateCollectionsToTables(controller.config, {
-                    strategy: "full_migration",
-                    validateResult: true,
-                    dryRun: false,
-                });
-                if (result.success) {
-                    operationStats.migratedCollections = result.changes.length;
-                    MessageFormatter.success("Collections migration completed successfully", { prefix: "Migration" });
-                }
-                else {
-                    MessageFormatter.error(`Migration failed: ${result.errors.join(", ")}`, undefined, { prefix: "Migration" });
-                    process.exit(1);
-                }
-            }
-            catch (error) {
-                MessageFormatter.error("Migration failed", error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
-                process.exit(1);
-            }
-            return;
-        }
-        if (!controller.config) {
-            // Provide better guidance based on available authentication methods
-            const availableSessions = getAvailableSessions();
-            if (availableSessions.length > 0) {
-                MessageFormatter.error("No Appwrite configuration found", undefined, {
-                    prefix: "CLI",
-                });
-                MessageFormatter.info("Available authentication options:", {
-                    prefix: "Auth",
-                });
-                MessageFormatter.info("• Session authentication: Add --session flag", {
-                    prefix: "Auth",
-                });
-                MessageFormatter.info("• API key authentication: Add --apiKey YOUR_API_KEY", { prefix: "Auth" });
-                MessageFormatter.info(`• Available sessions: ${availableSessions
-                    .map((s) => `${s.projectId} (${s.email || "unknown"})`)
-                    .join(", ")}`, { prefix: "Auth" });
-            }
-            else {
-                MessageFormatter.error("No Appwrite configuration found", undefined, {
-                    prefix: "CLI",
-                });
-                MessageFormatter.info("Authentication options:", { prefix: "Auth" });
-                MessageFormatter.info("• Login with Appwrite CLI: Run 'appwrite login' then use --session flag", { prefix: "Auth" });
-                MessageFormatter.info("• Use API key: Add --apiKey YOUR_API_KEY", {
-                    prefix: "Auth",
-                });
-                MessageFormatter.info("• Create config file: Run with --setup to initialize project configuration", { prefix: "Auth" });
-            }
-            return;
-        }
-        const parsedArgv = argv;
-        // List backups if requested
-        if (parsedArgv.listBackups) {
-            const { AdapterFactory } = await import("./adapters/AdapterFactory.js");
-            const { listBackups } = await import("./shared/backupTracking.js");
-            if (!controller.config) {
-                MessageFormatter.error("No Appwrite configuration found", undefined, {
-                    prefix: "Backups",
-                });
-                return;
-            }
-            const { adapter } = await AdapterFactory.create({
-                appwriteEndpoint: controller.config.appwriteEndpoint,
-                appwriteProject: controller.config.appwriteProject,
-                appwriteKey: controller.config.appwriteKey,
-            });
-            const databases = parsedArgv.dbIds
-                ? await controller.getDatabasesByIds(parsedArgv.dbIds.split(","))
-                : await fetchAllDatabases(controller.database);
-            if (!databases || databases.length === 0) {
-                MessageFormatter.info("No databases found", { prefix: "Backups" });
-                return;
-            }
-            for (const db of databases) {
-                const backups = await listBackups(adapter, db.$id);
-                MessageFormatter.info(`\nBackups for database: ${db.name} (${db.$id})`, { prefix: "Backups" });
-                if (backups.length === 0) {
-                    MessageFormatter.info("  No backups found", { prefix: "Backups" });
-                }
-                else {
-                    backups.forEach((backup, index) => {
-                        const date = new Date(backup.$createdAt).toLocaleString();
-                        const size = MessageFormatter.formatBytes(backup.sizeBytes);
-                        MessageFormatter.info(`  ${index + 1}. ${date} - ${backup.format.toUpperCase()} - ${size} - ${backup.collections} collections, ${backup.documents} documents`, { prefix: "Backups" });
-                    });
-                }
-            }
-            return;
-        }
-        const options = {
-            databases: parsedArgv.dbIds
-                ? await controller.getDatabasesByIds(parsedArgv.dbIds.split(","))
-                : undefined,
-            collections: parsedArgv.collectionIds?.split(","),
-            doBackup: parsedArgv.backup,
-            wipeDatabase: parsedArgv.wipe === "all" || parsedArgv.wipe === "docs",
-            wipeDocumentStorage: parsedArgv.wipe === "all" || parsedArgv.wipe === "storage",
-            wipeUsers: parsedArgv.wipe === "all" || parsedArgv.wipe === "users",
-            generateSchemas: parsedArgv.generate,
-            importData: parsedArgv.import,
-            shouldWriteFile: parsedArgv.writeData,
-            wipeCollections: parsedArgv.wipeCollections,
-            transferUsers: parsedArgv.transferUsers,
-        };
-        if (parsedArgv.updateFunctionSpec) {
-            if (!parsedArgv.functionId || !parsedArgv.specification) {
-                throw new Error("Function ID and specification are required for updating function specs");
-            }
-            MessageFormatter.info(`Updating function specification for ${parsedArgv.functionId} to ${parsedArgv.specification}`, { prefix: "Functions" });
-            const specifications = await listSpecifications(controller.appwriteServer);
-            if (!specifications.specifications.some((s) => s.slug === parsedArgv.specification)) {
-                MessageFormatter.error(`Specification ${parsedArgv.specification} not found`, undefined, { prefix: "Functions" });
-                return;
-            }
-            await controller.updateFunctionSpecifications(parsedArgv.functionId, parsedArgv.specification);
-        }
-        // Add default databases if not specified (only if we need them for operations)
-        const needsDatabases = options.doBackup ||
-            options.wipeDatabase ||
-            options.wipeDocumentStorage ||
-            options.wipeUsers ||
-            options.wipeCollections ||
-            options.importData ||
-            parsedArgv.sync ||
-            parsedArgv.transfer;
-        if (needsDatabases &&
-            (!options.databases || options.databases.length === 0)) {
-            const allDatabases = await fetchAllDatabases(controller.database);
-            options.databases = allDatabases;
-        }
-        // Add default collections if not specified
-        if (!options.collections || options.collections.length === 0) {
-            if (controller.config && controller.config.collections) {
-                options.collections = controller.config.collections.map((c) => c.name);
-            }
-            else {
-                options.collections = [];
-            }
-        }
-        // Comprehensive backup (all databases + all buckets)
-        if (parsedArgv.comprehensiveBackup) {
-            const { comprehensiveBackup } = await import("./backups/operations/comprehensiveBackup.js");
-            const { AdapterFactory } = await import("./adapters/AdapterFactory.js");
-            // Get tracking database ID (interactive prompt if not specified)
-            let trackingDatabaseId = parsedArgv.trackingDatabaseId;
-            if (!trackingDatabaseId) {
-                // Fetch all databases for selection
-                const allDatabases = await fetchAllDatabases(controller.database);
-                if (allDatabases.length === 0) {
-                    MessageFormatter.error("No databases found. Cannot create comprehensive backup without a tracking database.", undefined, { prefix: "Backup" });
-                    return;
-                }
-                if (allDatabases.length === 1) {
-                    trackingDatabaseId = allDatabases[0].$id;
-                    MessageFormatter.info(`Using only available database for tracking: ${allDatabases[0].name} (${trackingDatabaseId})`, { prefix: "Backup" });
-                }
-                else {
-                    // Interactive selection
-                    const inquirer = (await import("inquirer")).default;
-                    const answer = await inquirer.prompt([
-                        {
-                            type: "list",
-                            name: "trackingDb",
-                            message: "Select database to store backup tracking metadata:",
-                            choices: allDatabases.map((db) => ({
-                                name: `${db.name} (${db.$id})`,
-                                value: db.$id,
-                            })),
-                        },
-                    ]);
-                    trackingDatabaseId = answer.trackingDb;
-                }
-            }
-            // Ensure trackingDatabaseId is defined before proceeding
-            if (!trackingDatabaseId) {
-                throw new Error("Tracking database ID is required for comprehensive backup");
-            }
-            MessageFormatter.info(`Using tracking database: ${trackingDatabaseId}`, {
-                prefix: "Backup",
-            });
-            // Create adapter for backup tracking
-            const { adapter } = await AdapterFactory.create({
-                appwriteEndpoint: controller.config.appwriteEndpoint,
-                appwriteProject: controller.config.appwriteProject,
-                appwriteKey: controller.config.appwriteKey,
-                sessionCookie: controller.config.sessionCookie,
-            });
-            const result = await comprehensiveBackup(controller.config, controller.database, controller.storage, adapter, {
-                trackingDatabaseId,
-                backupFormat: parsedArgv.backupFormat || "zip",
-                parallelDownloads: parsedArgv.parallelDownloads || 10,
-                onProgress: (message) => {
-                    MessageFormatter.info(message, { prefix: "Backup" });
-                },
-            });
-            operationStats.comprehensiveBackup = 1;
-            operationStats.databasesBackedUp = result.databaseBackups.length;
-            operationStats.bucketsBackedUp = result.bucketBackups.length;
-            operationStats.totalBackupSize = result.totalSizeBytes;
-            if (result.status === "completed") {
-                MessageFormatter.success(`Comprehensive backup completed successfully (ID: ${result.backupId})`, { prefix: "Backup" });
-            }
-            else if (result.status === "partial") {
-                MessageFormatter.warning(`Comprehensive backup completed with errors (ID: ${result.backupId})`, { prefix: "Backup" });
-                result.errors.forEach((err) => MessageFormatter.warning(err, { prefix: "Backup" }));
-            }
-            else {
-                MessageFormatter.error(`Comprehensive backup failed (ID: ${result.backupId})`, undefined, { prefix: "Backup" });
-                result.errors.forEach((err) => MessageFormatter.error(err, undefined, { prefix: "Backup" }));
-            }
-        }
-        if (options.doBackup && options.databases) {
-            MessageFormatter.info(`Creating backups for ${options.databases.length} database(s) in ${parsedArgv.backupFormat} format`, { prefix: "Backup" });
-            for (const db of options.databases) {
-                await controller.backupDatabase(db, parsedArgv.backupFormat || "json");
-            }
-            operationStats.backups = options.databases.length;
-            MessageFormatter.success(`Backup completed for ${options.databases.length} database(s)`, { prefix: "Backup" });
-        }
-        if (options.wipeDatabase ||
-            options.wipeDocumentStorage ||
-            options.wipeUsers ||
-            options.wipeCollections) {
-            // Confirm destructive operations
-            const databaseNames = options.databases?.map((db) => db.name) || [];
-            const confirmed = await ConfirmationDialogs.confirmDatabaseWipe(databaseNames, {
-                includeStorage: options.wipeDocumentStorage,
-                includeUsers: options.wipeUsers,
-            });
-            if (!confirmed) {
-                MessageFormatter.info("Operation cancelled by user", { prefix: "CLI" });
-                return;
-            }
-            let wipeStats = { databases: 0, collections: 0, users: 0, buckets: 0 };
-            if (parsedArgv.wipe === "all") {
-                if (options.databases) {
-                    for (const db of options.databases) {
-                        await controller.wipeDatabase(db, true); // true to wipe associated buckets
-                    }
-                    wipeStats.databases = options.databases.length;
-                }
-                await controller.wipeUsers();
-                wipeStats.users = 1;
-            }
-            else if (parsedArgv.wipe === "docs") {
-                if (options.databases) {
-                    for (const db of options.databases) {
-                        await controller.wipeBucketFromDatabase(db);
-                    }
-                    wipeStats.databases = options.databases.length;
-                }
-                if (parsedArgv.bucketIds) {
-                    const bucketIds = parsedArgv.bucketIds.split(",");
-                    for (const bucketId of bucketIds) {
-                        await controller.wipeDocumentStorage(bucketId);
-                    }
-                    wipeStats.buckets = bucketIds.length;
-                }
-            }
-            else if (parsedArgv.wipe === "users") {
-                await controller.wipeUsers();
-                wipeStats.users = 1;
-            }
-            // Handle specific collection wipes
-            if (options.wipeCollections && options.databases) {
-                for (const db of options.databases) {
-                    const dbCollections = await fetchAllCollections(db.$id, controller.database);
-                    const collectionsToWipe = dbCollections.filter((c) => options.collections.includes(c.$id));
-                    // Confirm collection wipe
-                    const collectionNames = collectionsToWipe.map((c) => c.name);
-                    const collectionConfirmed = await ConfirmationDialogs.confirmCollectionWipe(db.name, collectionNames);
-                    if (collectionConfirmed) {
-                        for (const collection of collectionsToWipe) {
-                            await controller.wipeCollection(db, collection);
-                        }
-                        wipeStats.collections += collectionsToWipe.length;
-                    }
-                }
-            }
-            // Show wipe operation summary
-            if (wipeStats.databases > 0 ||
-                wipeStats.collections > 0 ||
-                wipeStats.users > 0 ||
-                wipeStats.buckets > 0) {
-                operationStats.wipedDatabases = wipeStats.databases;
-                operationStats.wipedCollections = wipeStats.collections;
-                operationStats.wipedUsers = wipeStats.users;
-                operationStats.wipedBuckets = wipeStats.buckets;
-            }
-        }
-        if (parsedArgv.push) {
-            await controller.init();
-            if (!controller.database || !controller.config) {
-                MessageFormatter.error("Database or config not initialized", undefined, { prefix: "Push" });
-                return;
-            }
-            // Fetch available DBs
-            const availableDatabases = await fetchAllDatabases(controller.database);
-            if (availableDatabases.length === 0) {
-                MessageFormatter.warning("No databases found in remote project", { prefix: "Push" });
-                return;
-            }
-            // Determine selected DBs
-            let selectedDbIds = [];
-            if (parsedArgv.dbIds) {
-                selectedDbIds = parsedArgv.dbIds.split(/[,\s]+/).filter(Boolean);
-            }
-            else {
-                selectedDbIds = await SelectionDialogs.selectDatabases(availableDatabases, controller.config.databases || [], { showSelectAll: false, allowNewOnly: false, defaultSelected: [] });
-            }
-            if (selectedDbIds.length === 0) {
-                MessageFormatter.warning("No databases selected for push", { prefix: "Push" });
-                return;
-            }
-            // Build DatabaseSelection[] with tableIds per DB
-            const databaseSelections = [];
-            const allConfigItems = controller.config.collections || controller.config.tables || [];
-            let lastSelectedTableIds = null;
-            for (const dbId of selectedDbIds) {
-                const db = availableDatabases.find(d => d.$id === dbId);
-                if (!db)
-                    continue;
-                // Filter config items eligible for this DB according to databaseId/databaseIds rule
-                const eligibleConfigItems = allConfigItems.filter(item => {
-                    const one = item.databaseId;
-                    const many = item.databaseIds;
-                    if (Array.isArray(many) && many.length > 0)
-                        return many.includes(dbId);
-                    if (one)
-                        return one === dbId;
-                    return true; // eligible everywhere if unspecified
-                });
-                // Fetch available tables from remote for selection context
-                const availableTables = await fetchAllCollections(dbId, controller.database);
-                // Determine selected table IDs
-                let selectedTableIds = [];
-                if (parsedArgv.collectionIds) {
-                    // Non-interactive: respect provided table IDs as-is (apply to each selected DB)
-                    selectedTableIds = parsedArgv.collectionIds.split(/[\,\s]+/).filter(Boolean);
-                }
-                else {
-                    // If we have a previous selection, offer to reuse it
-                    if (lastSelectedTableIds && lastSelectedTableIds.length > 0) {
-                        const inquirer = (await import("inquirer")).default;
-                        const { reuseMode } = await inquirer.prompt([
-                            {
-                                type: "list",
-                                name: "reuseMode",
-                                message: `How do you want to select tables for ${db.name}?`,
-                                choices: [
-                                    { name: `Use same selection as previous (${lastSelectedTableIds.length} items)`, value: "same" },
-                                    { name: `Filter by this database (manual select)`, value: "filter" },
-                                    { name: `Show all available in this database (manual select)`, value: "all" }
-                                ],
-                                default: "same"
-                            }
-                        ]);
-                        if (reuseMode === "same") {
-                            selectedTableIds = [...lastSelectedTableIds];
-                        }
-                        else if (reuseMode === "all") {
-                            selectedTableIds = await SelectionDialogs.selectTablesForDatabase(dbId, db.name, availableTables, allConfigItems, { showSelectAll: false, allowNewOnly: false, defaultSelected: lastSelectedTableIds });
-                        }
-                        else {
-                            selectedTableIds = await SelectionDialogs.selectTablesForDatabase(dbId, db.name, availableTables, eligibleConfigItems, { showSelectAll: false, allowNewOnly: true, defaultSelected: lastSelectedTableIds });
-                        }
-                    }
-                    else {
-                        selectedTableIds = await SelectionDialogs.selectTablesForDatabase(dbId, db.name, availableTables, eligibleConfigItems, { showSelectAll: false, allowNewOnly: true, defaultSelected: [] });
-                    }
-                }
-                databaseSelections.push({
-                    databaseId: db.$id,
-                    databaseName: db.name,
-                    tableIds: selectedTableIds,
-                    tableNames: [],
-                    isNew: false,
-                });
-                if (!parsedArgv.collectionIds) {
-                    lastSelectedTableIds = selectedTableIds;
-                }
-            }
-            if (databaseSelections.every(sel => sel.tableIds.length === 0)) {
-                MessageFormatter.warning("No tables/collections selected for push", { prefix: "Push" });
-                return;
-            }
-            const pushSummary = {
-                databases: databaseSelections.length,
-                collections: databaseSelections.reduce((sum, s) => sum + s.tableIds.length, 0),
-                details: databaseSelections.map(s => `${s.databaseId}: ${s.tableIds.length} items`),
-            };
-            // Skip confirmation if both dbIds and collectionIds are provided (non-interactive)
-            if (!(parsedArgv.dbIds && parsedArgv.collectionIds)) {
-                const confirmed = await ConfirmationDialogs.showOperationSummary('Push', pushSummary, { confirmationRequired: true });
-                if (!confirmed) {
-                    MessageFormatter.info("Push operation cancelled", { prefix: "Push" });
-                    return;
-                }
-            }
-            await controller.selectivePush(databaseSelections, []);
-            operationStats.pushedDatabases = databaseSelections.length;
-            operationStats.pushedCollections = databaseSelections.reduce((sum, s) => sum + s.tableIds.length, 0);
-        }
-        else if (parsedArgv.sync) {
-            // Enhanced SYNC: Pull from remote with intelligent configuration detection
-            if (parsedArgv.autoSync) {
-                // Legacy behavior: sync everything without prompts
-                MessageFormatter.info("Using auto-sync mode (legacy behavior)", { prefix: "Sync" });
-                const databases = options.databases || (await fetchAllDatabases(controller.database));
-                await controller.synchronizeConfigurations(databases);
-                operationStats.syncedDatabases = databases.length;
-            }
-            else {
-                // Enhanced sync flow with selection dialogs
-                const syncResult = await performEnhancedSync(controller, parsedArgv);
-                if (syncResult) {
-                    operationStats.syncedDatabases = syncResult.databases.length;
-                    operationStats.syncedCollections = syncResult.totalTables;
-                    operationStats.syncedBuckets = syncResult.buckets.length;
-                }
-            }
-        }
-        if (options.generateSchemas) {
-            await controller.generateSchemas();
-            operationStats.generatedSchemas = 1;
-        }
-        if (options.importData) {
-            await controller.importData(options);
-            operationStats.importCompleted = 1;
-        }
-        if (parsedArgv.transfer) {
-            const isRemote = !!parsedArgv.remoteEndpoint;
-            let fromDb, toDb;
-            let targetDatabases;
-            let targetStorage;
-            // Only fetch databases if database IDs are provided
-            if (parsedArgv.fromDbId && parsedArgv.toDbId) {
-                MessageFormatter.info(`Starting database transfer from ${parsedArgv.fromDbId} to ${parsedArgv.toDbId}`, { prefix: "Transfer" });
-                fromDb = (await controller.getDatabasesByIds([parsedArgv.fromDbId]))?.[0];
-                if (!fromDb) {
-                    MessageFormatter.error("Source database not found", undefined, {
-                        prefix: "Transfer",
-                    });
-                    return;
-                }
-                if (isRemote) {
-                    if (!parsedArgv.remoteEndpoint ||
-                        !parsedArgv.remoteProjectId ||
-                        !parsedArgv.remoteApiKey) {
-                        throw new Error("Remote transfer details are missing");
-                    }
-                    const remoteClient = getClient(parsedArgv.remoteEndpoint, parsedArgv.remoteProjectId, parsedArgv.remoteApiKey);
-                    targetDatabases = new Databases(remoteClient);
-                    targetStorage = new Storage(remoteClient);
-                    const remoteDbs = await fetchAllDatabases(targetDatabases);
-                    toDb = remoteDbs.find((db) => db.$id === parsedArgv.toDbId);
-                    if (!toDb) {
-                        MessageFormatter.error("Target database not found", undefined, {
-                            prefix: "Transfer",
-                        });
-                        return;
-                    }
-                }
-                else {
-                    toDb = (await controller.getDatabasesByIds([parsedArgv.toDbId]))?.[0];
-                    if (!toDb) {
-                        MessageFormatter.error("Target database not found", undefined, {
-                            prefix: "Transfer",
-                        });
-                        return;
-                    }
-                }
-                if (!fromDb || !toDb) {
-                    MessageFormatter.error("Source or target database not found", undefined, { prefix: "Transfer" });
-                    return;
-                }
-            }
-            // Handle storage setup
-            let sourceBucket, targetBucket;
-            if (parsedArgv.fromBucketId) {
-                sourceBucket = await controller.storage?.getBucket(parsedArgv.fromBucketId);
-            }
-            if (parsedArgv.toBucketId) {
-                if (isRemote) {
-                    if (!targetStorage) {
-                        const remoteClient = getClient(parsedArgv.remoteEndpoint, parsedArgv.remoteProjectId, parsedArgv.remoteApiKey);
-                        targetStorage = new Storage(remoteClient);
-                    }
-                    targetBucket = await targetStorage?.getBucket(parsedArgv.toBucketId);
-                }
-                else {
-                    targetBucket = await controller.storage?.getBucket(parsedArgv.toBucketId);
-                }
-            }
-            // Validate that at least one transfer type is specified
-            if (!fromDb && !sourceBucket && !options.transferUsers) {
-                throw new Error("No source database or bucket specified for transfer");
-            }
-            const transferOptions = {
-                isRemote,
-                fromDb,
-                targetDb: toDb,
-                transferEndpoint: parsedArgv.remoteEndpoint,
-                transferProject: parsedArgv.remoteProjectId,
-                transferKey: parsedArgv.remoteApiKey,
-                sourceBucket: sourceBucket,
-                targetBucket: targetBucket,
-                transferUsers: options.transferUsers,
-            };
-            await controller.transferData(transferOptions);
-            operationStats.transfers = 1;
-        }
-        // Show final operation summary if any operations were performed
-        if (Object.keys(operationStats).length > 0) {
-            const duration = Date.now() - startTime;
-            MessageFormatter.operationSummary("CLI Operations", operationStats, duration);
-        }
-    }
-}
-main().catch((error) => {
-    MessageFormatter.error("CLI execution failed", error, { prefix: "CLI" });
-    process.exit(1);
-});