@framers/sql-storage-adapter 0.1.0

package/dist/utils/dataImport.js

@@ -0,0 +1,324 @@
+/**
+ * Data import utilities for cross-adapter migration and restoration.
+ * Supports importing from JSON, SQL dumps, and CSV files.
+ */
+/**
+ * Import data from exported JSON format.
+ */
+export async function importData(adapter, data, options = {}) {
+    const startTime = Date.now();
+    const { dropTables = false, skipSchema = false, skipData = false, batchSize = 100, tables, onConflict = 'error', } = options;
+    const errors = [];
+    let tablesImported = 0;
+    let rowsImported = 0;
+    // Determine tables to import from both schema and data
+    let tablesToImport;
+    if (tables) {
+        tablesToImport = tables;
+    }
+    else {
+        const dataTables = Object.keys(data.data);
+        const schemaTables = data.schema?.map(s => s.name) || [];
+        tablesToImport = Array.from(new Set([...dataTables, ...schemaTables]));
+    }
+    try {
+        // Import schema
+        if (!skipSchema && data.schema) {
+            for (const tableSchema of data.schema) {
+                if (!tablesToImport.includes(tableSchema.name))
+                    continue;
+                try {
+                    if (dropTables) {
+                        await adapter.run(`DROP TABLE IF EXISTS ${escapeIdentifier(tableSchema.name)}`);
+                    }
+                    await createTable(adapter, tableSchema);
+                    // Only count if we're not also importing data (to avoid double counting)
+                    if (skipData) {
+                        tablesImported++;
+                    }
+                }
+                catch (error) {
+                    const errorMsg = `Schema error for ${tableSchema.name}: ${error.message}`;
+                    errors.push(errorMsg);
+                    // If we're in error mode, fail fast
+                    if (onConflict === 'error') {
+                        return {
+                            success: false,
+                            tablesImported,
+                            rowsImported,
+                            errors,
+                            duration: Date.now() - startTime,
+                        };
+                    }
+                }
+            }
+        }
+        // Import data
+        if (!skipData) {
+            for (const [tableName, rows] of Object.entries(data.data)) {
+                if (!tablesToImport.includes(tableName))
+                    continue;
+                if (!Array.isArray(rows) || rows.length === 0)
+                    continue;
+                try {
+                    const imported = await importTableData(adapter, tableName, rows, {
+                        batchSize,
+                        onConflict,
+                    });
+                    rowsImported += imported;
+                    tablesImported++;
+                }
+                catch (error) {
+                    errors.push(`Data error for ${tableName}: ${error.message}`);
+                }
+            }
+        }
+        return {
+            success: errors.length === 0,
+            tablesImported,
+            rowsImported,
+            errors: errors.length > 0 ? errors : undefined,
+            duration: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            tablesImported,
+            rowsImported,
+            errors: [...errors, `Fatal error: ${error.message}`],
+            duration: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * Import data from JSON string.
+ */
+export async function importFromJSON(adapter, jsonString, options = {}) {
+    try {
+        const data = JSON.parse(jsonString);
+        return await importData(adapter, data, options);
+    }
+    catch (error) {
+        return {
+            success: false,
+            tablesImported: 0,
+            rowsImported: 0,
+            errors: [`JSON parse error: ${error.message}`],
+            duration: 0,
+        };
+    }
+}
+/**
+ * Import data from SQL dump.
+ */
+export async function importFromSQL(adapter, sqlDump, options = {}) {
+    const startTime = Date.now();
+    const errors = [];
+    let statementsExecuted = 0;
+    try {
+        // Remove comments first
+        const withoutComments = sqlDump
+            .split('\n')
+            .filter(line => !line.trim().startsWith('--'))
+            .join('\n');
+        // Split SQL dump into individual statements
+        // Handle both inline and multi-line statements
+        const statements = withoutComments
+            .split(';')
+            .map(s => s.trim())
+            .filter(s => s.length > 0);
+        for (const statement of statements) {
+            try {
+                // Skip if filtering by tables
+                if (options.tables) {
+                    const matchesTable = options.tables.some(table => statement.toLowerCase().includes(table.toLowerCase()));
+                    if (!matchesTable)
+                        continue;
+                }
+                // Execute the statement
+                await adapter.run(statement);
+                statementsExecuted++;
+            }
+            catch (error) {
+                errors.push(`SQL error in statement: ${error.message}`);
+            }
+        }
+        return {
+            success: errors.length === 0,
+            tablesImported: statementsExecuted,
+            rowsImported: 0, // Cannot accurately count from SQL
+            errors: errors.length > 0 ? errors : undefined,
+            duration: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            tablesImported: 0,
+            rowsImported: 0,
+            errors: [...errors, `Fatal error: ${error.message}`],
+            duration: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * Import data from CSV.
+ */
+export async function importFromCSV(adapter, tableName, csvContent, options = {}) {
+    const startTime = Date.now();
+    try {
+        const rows = parseCSV(csvContent);
+        if (rows.length === 0) {
+            return {
+                success: true,
+                tablesImported: 0,
+                rowsImported: 0,
+                duration: Date.now() - startTime,
+            };
+        }
+        const imported = await importTableData(adapter, tableName, rows, {
+            batchSize: options.batchSize || 100,
+            onConflict: options.onConflict || 'error',
+        });
+        return {
+            success: true,
+            tablesImported: 1,
+            rowsImported: imported,
+            duration: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            tablesImported: 0,
+            rowsImported: 0,
+            errors: [`CSV import error: ${error.message}`],
+            duration: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * Migrate data from one adapter to another.
+ */
+export async function migrateAdapter(sourceAdapter, targetAdapter, options = {}) {
+    const { exportData } = await import('./dataExport.js');
+    // Export from source
+    const exportedData = await exportData(sourceAdapter, {
+        tables: options.tables,
+        includeSchema: !options.skipSchema,
+    });
+    // Import to target
+    return await importData(targetAdapter, exportedData, options);
+}
+/**
+ * Create table from schema.
+ */
+async function createTable(adapter, schema) {
+    if (schema.columns.length === 0) {
+        throw new Error(`Cannot create table ${schema.name} without column definitions`);
+    }
+    const columnDefs = schema.columns.map(col => {
+        let def = `${escapeIdentifier(col.name)} ${col.type}`;
+        if (!col.nullable)
+            def += ' NOT NULL';
+        if (col.defaultValue)
+            def += ` DEFAULT ${col.defaultValue}`;
+        return def;
+    });
+    const createSQL = `CREATE TABLE IF NOT EXISTS ${escapeIdentifier(schema.name)} (
+    ${columnDefs.join(',\n    ')}
+  )`;
+    await adapter.run(createSQL);
+}
+/**
+ * Import rows into a table.
+ */
+async function importTableData(adapter, tableName, rows, options) {
+    let imported = 0;
+    const { batchSize, onConflict } = options;
+    // Process in batches
+    for (let i = 0; i < rows.length; i += batchSize) {
+        const batch = rows.slice(i, i + batchSize);
+        for (const row of batch) {
+            const record = row;
+            const columns = Object.keys(record);
+            const placeholders = columns.map(() => '?');
+            let insertSQL = `INSERT `;
+            // Handle conflicts (SQLite syntax)
+            if (onConflict === 'replace') {
+                insertSQL = `INSERT OR REPLACE `;
+            }
+            else if (onConflict === 'ignore') {
+                insertSQL = `INSERT OR IGNORE `;
+            }
+            insertSQL += `INTO ${escapeIdentifier(tableName)} (${columns.map(escapeIdentifier).join(', ')}) VALUES (${placeholders.join(', ')})`;
+            try {
+                await adapter.run(insertSQL, columns.map(col => record[col]));
+                imported++;
+            }
+            catch (error) {
+                if (onConflict === 'error') {
+                    throw error;
+                }
+                // Otherwise silently skip
+            }
+        }
+    }
+    return imported;
+}
+/**
+ * Parse CSV content into rows.
+ */
+function parseCSV(content) {
+    const lines = content.split('\n').filter(line => line.trim().length > 0);
+    if (lines.length === 0)
+        return [];
+    const headers = parseCSVLine(lines[0]);
+    const rows = [];
+    for (let i = 1; i < lines.length; i++) {
+        const values = parseCSVLine(lines[i]);
+        const row = {};
+        headers.forEach((header, idx) => {
+            row[header] = values[idx] ?? null;
+        });
+        rows.push(row);
+    }
+    return rows;
+}
+/**
+ * Parse a single CSV line.
+ */
+function parseCSVLine(line) {
+    const values = [];
+    let current = '';
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i++) {
+        const char = line[i];
+        if (char === '"') {
+            if (inQuotes && line[i + 1] === '"') {
+                current += '"';
+                i++;
+            }
+            else {
+                inQuotes = !inQuotes;
+            }
+        }
+        else if (char === ',' && !inQuotes) {
+            values.push(current);
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    values.push(current);
+    return values;
+}
+/**
+ * Escape SQL identifier.
+ */
+function escapeIdentifier(identifier) {
+    return `"${identifier.replace(/"/g, '""')}"`;
+}
+//# sourceMappingURL=dataImport.js.map

package/dist/utils/dataImport.js.map

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

package/dist/utils/migration.d.ts

@@ -0,0 +1,89 @@
+/**
+ * High-level migration utilities for moving data between adapters.
+ * Simplifies common migration scenarios like local → Supabase, Supabase → local, etc.
+ */
+import type { StorageAdapter } from '../types';
+import { type ImportResult, type DataImportOptions } from './dataImport';
+/**
+ * Migration strategy for handling conflicts and errors.
+ */
+export interface MigrationStrategy {
+    /** Whether to drop existing tables */
+    dropExisting?: boolean;
+    /** How to handle conflicts during import */
+    onConflict?: 'replace' | 'ignore' | 'error';
+    /** Whether to verify data after migration */
+    verify?: boolean;
+    /** Batch size for operations */
+    batchSize?: number;
+    /** Tables to migrate (all if not specified) */
+    tables?: string[];
+}
+/**
+ * Migration result with detailed statistics.
+ */
+export interface MigrationResult extends ImportResult {
+    sourceAdapter: string;
+    targetAdapter: string;
+    verification?: VerificationResult;
+}
+/**
+ * Verification result after migration.
+ */
+export interface VerificationResult {
+    passed: boolean;
+    tableCounts: Record<string, {
+        source: number;
+        target: number;
+        match: boolean;
+    }>;
+    errors?: string[];
+}
+/**
+ * Migrate from Better-SQLite3 (local) to Supabase.
+ */
+export declare function migrateLocalToSupabase(localAdapter: StorageAdapter, supabaseAdapter: StorageAdapter, strategy?: MigrationStrategy): Promise<MigrationResult>;
+/**
+ * Migrate from Supabase to Better-SQLite3 (local).
+ */
+export declare function migrateSupabaseToLocal(supabaseAdapter: StorageAdapter, localAdapter: StorageAdapter, strategy?: MigrationStrategy): Promise<MigrationResult>;
+/**
+ * Migrate from Supabase to PostgreSQL.
+ */
+export declare function migrateSupabaseToPostgres(supabaseAdapter: StorageAdapter, postgresAdapter: StorageAdapter, strategy?: MigrationStrategy): Promise<MigrationResult>;
+/**
+ * Migrate from SQL.js (browser) to Capacitor SQLite (mobile).
+ */
+export declare function migrateBrowserToMobile(sqlJsAdapter: StorageAdapter, capacitorAdapter: StorageAdapter, strategy?: MigrationStrategy): Promise<MigrationResult>;
+/**
+ * Generic migration between any two adapters.
+ */
+export declare function migrateAdapters(sourceAdapter: StorageAdapter, targetAdapter: StorageAdapter, strategy?: MigrationStrategy): Promise<MigrationResult>;
+/**
+ * Create a backup of an adapter to JSON file.
+ */
+export declare function createBackup(adapter: StorageAdapter, options?: {
+    tables?: string[];
+    pretty?: boolean;
+}): Promise<string>;
+/**
+ * Restore from a backup JSON string.
+ */
+export declare function restoreFromBackup(adapter: StorageAdapter, backupJSON: string, options?: DataImportOptions): Promise<ImportResult>;
+/**
+ * Clone an adapter's data to another adapter.
+ */
+export declare function cloneAdapter(sourceAdapter: StorageAdapter, targetAdapter: StorageAdapter, options?: MigrationStrategy): Promise<MigrationResult>;
+/**
+ * Sync data between two adapters (bidirectional).
+ * NOTE: This is a simple implementation - for production use, implement proper conflict resolution.
+ */
+export declare function syncAdapters(adapter1: StorageAdapter, adapter2: StorageAdapter, strategy?: MigrationStrategy): Promise<{
+    toAdapter2: MigrationResult;
+    toAdapter1: MigrationResult;
+}>;
+/**
+ * Get migration summary for display.
+ */
+export declare function formatMigrationResult(result: MigrationResult): string;
+//# sourceMappingURL=migration.d.ts.map

package/dist/utils/migration.d.ts.map

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

package/dist/utils/migration.js

@@ -0,0 +1,184 @@
+/**
+ * High-level migration utilities for moving data between adapters.
+ * Simplifies common migration scenarios like local → Supabase, Supabase → local, etc.
+ */
+import { exportData, exportAsJSON } from './dataExport';
+import { migrateAdapter } from './dataImport';
+/**
+ * Migrate from Better-SQLite3 (local) to Supabase.
+ */
+export async function migrateLocalToSupabase(localAdapter, supabaseAdapter, strategy = {}) {
+    return await executeMigration(localAdapter, supabaseAdapter, 'better-sqlite3', 'supabase', strategy);
+}
+/**
+ * Migrate from Supabase to Better-SQLite3 (local).
+ */
+export async function migrateSupabaseToLocal(supabaseAdapter, localAdapter, strategy = {}) {
+    return await executeMigration(supabaseAdapter, localAdapter, 'supabase', 'better-sqlite3', strategy);
+}
+/**
+ * Migrate from Supabase to PostgreSQL.
+ */
+export async function migrateSupabaseToPostgres(supabaseAdapter, postgresAdapter, strategy = {}) {
+    return await executeMigration(supabaseAdapter, postgresAdapter, 'supabase', 'postgres', strategy);
+}
+/**
+ * Migrate from SQL.js (browser) to Capacitor SQLite (mobile).
+ */
+export async function migrateBrowserToMobile(sqlJsAdapter, capacitorAdapter, strategy = {}) {
+    return await executeMigration(sqlJsAdapter, capacitorAdapter, 'sql.js', 'capacitor-sqlite', strategy);
+}
+/**
+ * Generic migration between any two adapters.
+ */
+export async function migrateAdapters(sourceAdapter, targetAdapter, strategy = {}) {
+    return await executeMigration(sourceAdapter, targetAdapter, 'unknown', 'unknown', strategy);
+}
+/**
+ * Execute migration with strategy.
+ */
+async function executeMigration(sourceAdapter, targetAdapter, sourceName, targetName, strategy) {
+    const importOptions = {
+        dropTables: strategy.dropExisting,
+        onConflict: strategy.onConflict,
+        batchSize: strategy.batchSize,
+        tables: strategy.tables,
+    };
+    const result = await migrateAdapter(sourceAdapter, targetAdapter, importOptions);
+    const migrationResult = {
+        ...result,
+        sourceAdapter: sourceName,
+        targetAdapter: targetName,
+    };
+    // Verify migration if requested
+    if (strategy.verify && result.success) {
+        migrationResult.verification = await verifyMigration(sourceAdapter, targetAdapter, strategy.tables);
+    }
+    return migrationResult;
+}
+/**
+ * Verify migration by comparing row counts.
+ */
+async function verifyMigration(sourceAdapter, targetAdapter, tables) {
+    const errors = [];
+    const tableCounts = {};
+    try {
+        // Get list of tables
+        const sourceData = await exportData(sourceAdapter, { tables, includeSchema: false });
+        const targetData = await exportData(targetAdapter, { tables, includeSchema: false });
+        // Compare counts for each table
+        for (const tableName of Object.keys(sourceData.data)) {
+            const sourceCount = sourceData.data[tableName]?.length || 0;
+            const targetCount = targetData.data[tableName]?.length || 0;
+            const match = sourceCount === targetCount;
+            tableCounts[tableName] = {
+                source: sourceCount,
+                target: targetCount,
+                match,
+            };
+            if (!match) {
+                errors.push(`Table ${tableName}: source has ${sourceCount} rows, target has ${targetCount} rows`);
+            }
+        }
+        // Check for missing tables in target
+        for (const tableName of Object.keys(targetData.data)) {
+            if (!sourceData.data[tableName]) {
+                errors.push(`Table ${tableName} exists in target but not in source`);
+            }
+        }
+        return {
+            passed: errors.length === 0,
+            tableCounts,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    catch (error) {
+        return {
+            passed: false,
+            tableCounts,
+            errors: [`Verification failed: ${error.message}`],
+        };
+    }
+}
+/**
+ * Create a backup of an adapter to JSON file.
+ */
+export async function createBackup(adapter, options = {}) {
+    return await exportAsJSON(adapter, {
+        tables: options.tables,
+        includeSchema: true,
+        pretty: options.pretty ?? true,
+    });
+}
+/**
+ * Restore from a backup JSON string.
+ */
+export async function restoreFromBackup(adapter, backupJSON, options = {}) {
+    const { importFromJSON } = await import('./dataImport.js');
+    return await importFromJSON(adapter, backupJSON, options);
+}
+/**
+ * Clone an adapter's data to another adapter.
+ */
+export async function cloneAdapter(sourceAdapter, targetAdapter, options = {}) {
+    return await migrateAdapters(sourceAdapter, targetAdapter, {
+        ...options,
+        verify: options.verify ?? true,
+    });
+}
+/**
+ * Sync data between two adapters (bidirectional).
+ * NOTE: This is a simple implementation - for production use, implement proper conflict resolution.
+ */
+export async function syncAdapters(adapter1, adapter2, strategy = {}) {
+    // Export data from both adapters (unused currently, but kept for future bidirectional sync)
+    // const data1 = await exportData(adapter1, { tables: strategy.tables });
+    // const data2 = await exportData(adapter2, { tables: strategy.tables });
+    // Find differences and sync
+    const toAdapter2 = await migrateAdapters(adapter1, adapter2, {
+        ...strategy,
+        onConflict: 'replace',
+    });
+    const toAdapter1 = await migrateAdapters(adapter2, adapter1, {
+        ...strategy,
+        onConflict: 'replace',
+    });
+    return { toAdapter2, toAdapter1 };
+}
+/**
+ * Get migration summary for display.
+ */
+export function formatMigrationResult(result) {
+    const lines = [];
+    lines.push('='.repeat(60));
+    lines.push('Migration Result');
+    lines.push('='.repeat(60));
+    lines.push(`Source: ${result.sourceAdapter}`);
+    lines.push(`Target: ${result.targetAdapter}`);
+    lines.push(`Status: ${result.success ? '✅ SUCCESS' : '❌ FAILED'}`);
+    lines.push(`Duration: ${result.duration}ms`);
+    lines.push(`Tables: ${result.tablesImported}`);
+    lines.push(`Rows: ${result.rowsImported}`);
+    if (result.errors && result.errors.length > 0) {
+        lines.push('\nErrors:');
+        result.errors.forEach(err => lines.push(`  ❌ ${err}`));
+    }
+    if (result.verification) {
+        lines.push('\nVerification:');
+        lines.push(`Status: ${result.verification.passed ? '✅ PASSED' : '❌ FAILED'}`);
+        if (Object.keys(result.verification.tableCounts).length > 0) {
+            lines.push('\nTable Counts:');
+            for (const [table, counts] of Object.entries(result.verification.tableCounts)) {
+                const status = counts.match ? '✅' : '❌';
+                lines.push(`  ${status} ${table}: source=${counts.source}, target=${counts.target}`);
+            }
+        }
+        if (result.verification.errors && result.verification.errors.length > 0) {
+            lines.push('\nVerification Errors:');
+            result.verification.errors.forEach(err => lines.push(`  ❌ ${err}`));
+        }
+    }
+    lines.push('='.repeat(60));
+    return lines.join('\n');
+}
+//# sourceMappingURL=migration.js.map

package/dist/utils/migration.js.map

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

package/dist/utils/parameterUtils.d.ts

@@ -0,0 +1,9 @@
+import type { StorageParameters } from '../types';
+/**
+ * Normalises parameter payloads into a tuple of named/object parameters and positional arrays.
+ */
+export declare const normaliseParameters: (parameters?: StorageParameters) => {
+    named?: Record<string, unknown>;
+    positional?: Array<unknown>;
+};
+//# sourceMappingURL=parameterUtils.d.ts.map

package/dist/utils/parameterUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameterUtils.d.ts","sourceRoot":"","sources":["../../src/utils/parameterUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,aAAa,iBAAiB,KAC7B;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;CAehE,CAAC"}

package/dist/utils/parameterUtils.js

@@ -0,0 +1,17 @@
+/**
+ * Normalises parameter payloads into a tuple of named/object parameters and positional arrays.
+ */
+export const normaliseParameters = (parameters) => {
+    if (parameters == null) {
+        return {};
+    }
+    if (Array.isArray(parameters)) {
+        return { positional: parameters };
+    }
+    if (typeof parameters === 'object') {
+        return { named: parameters };
+    }
+    // Fall back to positional when unknown primitive is provided.
+    return { positional: [parameters] };
+};
+//# sourceMappingURL=parameterUtils.js.map

package/dist/utils/parameterUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameterUtils.js","sourceRoot":"","sources":["../../src/utils/parameterUtils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,UAA8B,EACoC,EAAE;IACpE,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,UAAqC,EAAE,CAAC;IAC1D,CAAC;IAED,8DAA8D;IAC9D,OAAO,EAAE,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;AACtC,CAAC,CAAC"}