@fazetitans/fscopy 1.1.2 → 1.2.0

package/src/config/defaults.ts

@@ -26,6 +26,10 @@ export const defaults: Config = {
     rateLimit: 0,
     skipOversized: false,
     json: false,
+    transformSamples: 3,
+    detectConflicts: false,
+    maxDepth: 0,
+    verifyIntegrity: false,
 };
 
 export const iniTemplate = `; fscopy configuration file

package/src/config/parser.ts

@@ -257,5 +257,9 @@ export function mergeConfig(
         rateLimit: cliArgs.rateLimit ?? defaultConfig.rateLimit,
         skipOversized: cliArgs.skipOversized ?? defaultConfig.skipOversized,
         json: cliArgs.json ?? defaultConfig.json,
+        transformSamples: cliArgs.transformSamples ?? defaultConfig.transformSamples,
+        detectConflicts: cliArgs.detectConflicts ?? defaultConfig.detectConflicts,
+        maxDepth: cliArgs.maxDepth ?? defaultConfig.maxDepth,
+        verifyIntegrity: cliArgs.verifyIntegrity ?? defaultConfig.verifyIntegrity,
     };
 }

package/src/config/validator.ts

@@ -1,5 +1,51 @@
 import type { Config } from '../types.js';
 
+/**
+ * Validate a Firestore collection or document ID.
+ * Returns an error message if invalid, null if valid.
+ */
+export function validateFirestoreId(
+    id: string,
+    type: 'collection' | 'document' = 'collection'
+): string | null {
+    // Cannot be empty
+    if (!id || id.length === 0) {
+        return `${type} name cannot be empty`;
+    }
+
+    // Cannot be a lone period or double period
+    if (id === '.' || id === '..') {
+        return `${type} name cannot be '.' or '..'`;
+    }
+
+    // Cannot match __.*__ pattern (reserved by Firestore)
+    if (/^__.*__$/.test(id)) {
+        return `${type} name cannot match pattern '__*__' (reserved by Firestore)`;
+    }
+
+    return null;
+}
+
+/**
+ * Validate a collection path (may contain nested paths like users/123/orders).
+ * Returns array of error messages, empty if valid.
+ */
+export function validateCollectionPath(path: string): string[] {
+    const errors: string[] = [];
+    const segments = path.split('/');
+
+    for (let i = 0; i < segments.length; i++) {
+        const segment = segments[i];
+        const type = i % 2 === 0 ? 'collection' : 'document';
+        const error = validateFirestoreId(segment, type);
+        if (error) {
+            errors.push(`Invalid ${type} in path "${path}": ${error}`);
+        }
+    }
+
+    return errors;
+}
+
 export function validateConfig(config: Config): string[] {
     const errors: string[] = [];
 
@@ -25,5 +71,11 @@ export function validateConfig(config: Config): string[] {
         errors.push('At least one collection is required (-c or --collections)');
     }
 
+    // Validate collection names
+    for (const collection of config.collections) {
+        const pathErrors = validateCollectionPath(collection);
+        errors.push(...pathErrors);
+    }
+
     return errors;
 }

package/src/firebase/index.ts

@@ -0,0 +1,82 @@
+import admin from 'firebase-admin';
+import type { Firestore } from 'firebase-admin/firestore';
+import type { Config } from '../types.js';
+import type { Output } from '../utils/output.js';
+import { formatFirebaseError } from '../utils/errors.js';
+
+let sourceApp: admin.app.App | null = null;
+let destApp: admin.app.App | null = null;
+
+export interface FirebaseConnections {
+    sourceDb: Firestore;
+    destDb: Firestore;
+}
+
+export function initializeFirebase(config: Config): FirebaseConnections {
+    sourceApp = admin.initializeApp(
+        {
+            credential: admin.credential.applicationDefault(),
+            projectId: config.sourceProject!,
+        },
+        'source'
+    );
+
+    destApp = admin.initializeApp(
+        {
+            credential: admin.credential.applicationDefault(),
+            projectId: config.destProject!,
+        },
+        'dest'
+    );
+
+    return {
+        sourceDb: sourceApp.firestore(),
+        destDb: destApp.firestore(),
+    };
+}
+
+export async function checkDatabaseConnectivity(
+    sourceDb: Firestore,
+    destDb: Firestore,
+    config: Config,
+    output: Output
+): Promise<void> {
+    output.info('🔌 Checking database connectivity...');
+
+    // Check source database
+    try {
+        await sourceDb.listCollections();
+        output.info(`   ✓ Source (${config.sourceProject}) - connected`);
+    } catch (error) {
+        const err = error as Error & { code?: string };
+        const errorInfo = formatFirebaseError(err);
+        const hint = errorInfo.suggestion ? `\n   Hint: ${errorInfo.suggestion}` : '';
+        throw new Error(
+            `Cannot connect to source database (${config.sourceProject}): ${errorInfo.message}${hint}`
+        );
+    }
+
+    // Check destination database (only if different from source)
+    if (config.sourceProject !== config.destProject) {
+        try {
+            await destDb.listCollections();
+            output.info(`   ✓ Destination (${config.destProject}) - connected`);
+        } catch (error) {
+            const err = error as Error & { code?: string };
+            const errorInfo = formatFirebaseError(err);
+            const hint = errorInfo.suggestion ? `\n   Hint: ${errorInfo.suggestion}` : '';
+            throw new Error(
+                `Cannot connect to destination database (${config.destProject}): ${errorInfo.message}${hint}`
+            );
+        }
+    } else {
+        output.info(`   ✓ Destination (same as source) - connected`);
+    }
+
+    output.blank();
+}
+
+export async function cleanupFirebase(): Promise<void> {
+    if (sourceApp) await sourceApp.delete();
+    if (destApp) await destApp.delete();
+}

package/src/interactive.ts

@@ -3,72 +3,76 @@ import type { Firestore } from 'firebase-admin/firestore';
 import { input, checkbox, confirm } from '@inquirer/prompts';
 import type { Config } from './types.js';
 
-export async function runInteractiveMode(config: Config): Promise<Config> {
-    console.log('\n' + '='.repeat(60));
-    console.log('🔄 FSCOPY - INTERACTIVE MODE');
-    console.log('='.repeat(60) + '\n');
+async function promptForProject(
+    currentValue: string | null | undefined,
+    label: string,
+    emoji: string
+): Promise<string> {
+    if (currentValue) {
+        console.log(`${emoji} ${label}: ${currentValue}`);
+        return currentValue;
+    }
+    return input({
+        message: `${label}:`,
+        validate: (value) => value.length > 0 || 'Project ID is required',
+    });
+}
+
+async function promptForIdModification(
+    currentPrefix: string | null,
+    currentSuffix: string | null
+): Promise<{ idPrefix: string | null; idSuffix: string | null }> {
+    console.log('\n⚠️  Source and destination are the same project.');
+    console.log('   You need to rename collections or modify document IDs to avoid overwriting.\n');
+
+    const modifyIds = await confirm({
+        message: 'Add a prefix to document IDs?',
+        default: true,
+    });
 
-    // Prompt for source project if not set
-    let sourceProject = config.sourceProject;
-    if (!sourceProject) {
-        sourceProject = await input({
-            message: 'Source Firebase project ID:',
-            validate: (value) => value.length > 0 || 'Project ID is required',
+    if (modifyIds) {
+        const idPrefix = await input({
+            message: 'Document ID prefix (e.g., "backup_"):',
+            default: 'backup_',
+            validate: (value) => value.length > 0 || 'Prefix is required',
         });
-    } else {
-        console.log(`📤 Source project: ${sourceProject}`);
+        return { idPrefix, idSuffix: currentSuffix };
     }
 
-    // Prompt for destination project if not set
-    let destProject = config.destProject;
-    if (!destProject) {
-        destProject = await input({
-            message: 'Destination Firebase project ID:',
-            validate: (value) => value.length > 0 || 'Project ID is required',
+    const useSuffix = await confirm({
+        message: 'Add a suffix to document IDs instead?',
+        default: true,
+    });
+
+    if (useSuffix) {
+        const idSuffix = await input({
+            message: 'Document ID suffix (e.g., "_backup"):',
+            default: '_backup',
+            validate: (value) => value.length > 0 || 'Suffix is required',
         });
-    } else {
-        console.log(`📥 Destination project: ${destProject}`);
+        return { idPrefix: currentPrefix, idSuffix };
     }
 
-    // If source = destination, ask for rename/id modifications
-    const renameCollection = config.renameCollection;
+    console.log('\n❌ Cannot proceed: source and destination are the same without ID modification.');
+    console.log('   This would overwrite your data. Use --rename-collection, --id-prefix, or --id-suffix.\n');
+    process.exit(1);
+}
+
+export async function runInteractiveMode(config: Config): Promise<Config> {
+    console.log('\n' + '='.repeat(60));
+    console.log('🔄 FSCOPY - INTERACTIVE MODE');
+    console.log('='.repeat(60) + '\n');
+
+    const sourceProject = await promptForProject(config.sourceProject, 'Source Firebase project ID', '📤');
+    const destProject = await promptForProject(config.destProject, 'Destination Firebase project ID', '📥');
+
     let idPrefix = config.idPrefix;
     let idSuffix = config.idSuffix;
 
     if (sourceProject === destProject) {
-        console.log('\n⚠️  Source and destination are the same project.');
-        console.log('   You need to rename collections or modify document IDs to avoid overwriting.\n');
-
-        const modifyIds = await confirm({
-            message: 'Add a prefix to document IDs?',
-            default: true,
-        });
-
-        if (modifyIds) {
-            idPrefix = await input({
-                message: 'Document ID prefix (e.g., "backup_"):',
-                default: 'backup_',
-                validate: (value) => value.length > 0 || 'Prefix is required',
-            });
-        } else {
-            // Ask for suffix as alternative
-            const useSuffix = await confirm({
-                message: 'Add a suffix to document IDs instead?',
-                default: true,
-            });
-
-            if (useSuffix) {
-                idSuffix = await input({
-                    message: 'Document ID suffix (e.g., "_backup"):',
-                    default: '_backup',
-                    validate: (value) => value.length > 0 || 'Suffix is required',
-                });
-            } else {
-                console.log('\n❌ Cannot proceed: source and destination are the same without ID modification.');
-                console.log('   This would overwrite your data. Use --rename-collection, --id-prefix, or --id-suffix.\n');
-                process.exit(1);
-            }
-        }
+        const mods = await promptForIdModification(idPrefix, idSuffix);
+        idPrefix = mods.idPrefix;
+        idSuffix = mods.idSuffix;
     }
 
     // Initialize source Firebase to list collections
@@ -165,7 +169,6 @@ export async function runInteractiveMode(config: Config): Promise<Config> {
         includeSubcollections,
         dryRun,
         merge,
-        renameCollection,
         idPrefix,
         idSuffix,
     };