@framers/sql-storage-adapter 0.1.0

package/dist/utils/cloudBackup.js

@@ -0,0 +1,289 @@
+/**
+ * Cloud backup utilities for S3, R2, and other object storage providers.
+ *
+ * This module provides automatic scheduled backups and restore functionality
+ * for SQL databases using S3-compatible storage (AWS S3, Cloudflare R2, MinIO, etc.).
+ *
+ * Features:
+ * - Automatic scheduled backups with configurable intervals
+ * - Gzip compression to reduce storage costs
+ * - Retention policies (automatic cleanup of old backups)
+ * - JSON and SQL export formats
+ * - Manual backup/restore on demand
+ *
+ * @example
+ * ```typescript
+ * import { S3Client } from '@aws-sdk/client-s3';
+ * import { createCloudBackupManager } from '@framers/sql-storage-adapter';
+ *
+ * const s3Client = new S3Client({ region: 'us-east-1' });
+ * const manager = createCloudBackupManager(db, s3Client, 'my-backups', {
+ *   interval: 3600000,  // 1 hour
+ *   maxBackups: 24,
+ *   options: { compression: 'gzip', format: 'json' }
+ * });
+ *
+ * manager.start();  // Auto-schedule backups
+ * await manager.backupNow();  // Manual backup
+ * await manager.restore('backups/db-2024-01-15.json.gz');
+ * ```
+ *
+ * @module cloudBackup
+ */
+import { exportAsJSON, exportAsSQL } from './dataExport';
+import { importFromJSON, importFromSQL } from './dataImport';
+/**
+ * S3-compatible cloud storage provider.
+ *
+ * Works with AWS S3, Cloudflare R2, MinIO, and other S3-compatible services.
+ * Uses the AWS SDK v3 for S3 operations.
+ *
+ * @example
+ * ```typescript
+ * import { S3Client } from '@aws-sdk/client-s3';
+ *
+ * const s3Client = new S3Client({ region: 'us-east-1' });
+ * const provider = new S3StorageProvider(s3Client, 'my-bucket');
+ *
+ * await provider.upload('backups/test.json', JSON.stringify(data));
+ * const backups = await provider.list('backups/');
+ * ```
+ */
+export class S3StorageProvider {
+    /**
+     * @param client - AWS SDK S3Client instance
+     * @param bucket - S3 bucket name
+     */
+    constructor(client, bucket) {
+        this.client = client;
+        this.bucket = bucket;
+    }
+    async upload(key, data) {
+        const { PutObjectCommand } = await import('@aws-sdk/client-s3');
+        await this.client.send(new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+            Body: data,
+        }));
+    }
+    async download(key) {
+        const { GetObjectCommand } = await import('@aws-sdk/client-s3');
+        const response = await this.client.send(new GetObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+        }));
+        // Handle different SDK versions
+        if (response.Body.transformToString) {
+            return await response.Body.transformToString();
+        }
+        return response.Body.toString('utf-8');
+    }
+    async list(prefix) {
+        const { ListObjectsV2Command } = await import('@aws-sdk/client-s3');
+        const response = await this.client.send(new ListObjectsV2Command({
+            Bucket: this.bucket,
+            Prefix: prefix,
+        }));
+        return response.Contents?.map((obj) => obj.Key).filter((key) => !!key) ?? [];
+    }
+    async delete(key) {
+        const { DeleteObjectCommand } = await import('@aws-sdk/client-s3');
+        await this.client.send(new DeleteObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+        }));
+    }
+}
+/**
+ * Compress data using gzip.
+ */
+async function compress(data) {
+    const { gzip } = await import('zlib');
+    const { promisify } = await import('util');
+    const gzipAsync = promisify(gzip);
+    return await gzipAsync(Buffer.from(data));
+}
+/**
+ * Decompress gzipped data.
+ */
+async function decompress(data) {
+    const { gunzip } = await import('zlib');
+    const { promisify } = await import('util');
+    const gunzipAsync = promisify(gunzip);
+    const decompressed = await gunzipAsync(data);
+    return decompressed.toString('utf-8');
+}
+/**
+ * Cloud backup manager for automatic scheduled backups.
+ */
+export class CloudBackupManager {
+    constructor(adapter, storage, config) {
+        this.adapter = adapter;
+        this.storage = storage;
+        this.config = config;
+    }
+    /**
+     * Create a backup and upload to cloud storage.
+     */
+    async backup(options = {}) {
+        const format = options.format ?? this.config.options?.format ?? 'json';
+        const compression = options.compression ?? this.config.options?.compression ?? 'none';
+        const tables = options.tables ?? this.config.options?.tables;
+        const prefix = options.prefix ?? this.config.options?.prefix ?? 'backups/';
+        const includeTimestamp = options.includeTimestamp ?? this.config.options?.includeTimestamp ?? true;
+        // Export data
+        let data;
+        if (format === 'json') {
+            data = await exportAsJSON(this.adapter, { tables });
+        }
+        else {
+            data = await exportAsSQL(this.adapter, { tables });
+        }
+        // Compress if needed
+        let uploadData = data;
+        if (compression === 'gzip') {
+            uploadData = await compress(data);
+        }
+        // Generate key
+        const timestamp = includeTimestamp ? `-${new Date().toISOString().replace(/[:.]/g, '-')}` : '';
+        const ext = format === 'json' ? 'json' : 'sql';
+        const compExt = compression === 'gzip' ? '.gz' : '';
+        const key = `${prefix}backup${timestamp}.${ext}${compExt}`;
+        // Upload
+        await this.storage.upload(key, uploadData);
+        // Cleanup old backups if needed
+        if (this.config.maxBackups) {
+            await this.cleanupOldBackups(prefix);
+        }
+        return key;
+    }
+    /**
+     * Restore from a cloud backup.
+     */
+    async restore(key) {
+        // Download
+        const data = await this.storage.download(key);
+        // Decompress if needed
+        let restored;
+        if (key.endsWith('.gz')) {
+            restored = await decompress(Buffer.from(data));
+        }
+        else {
+            restored = typeof data === 'string' ? data : data.toString('utf-8');
+        }
+        // Import
+        if (key.includes('.json')) {
+            await importFromJSON(this.adapter, restored);
+        }
+        else {
+            await importFromSQL(this.adapter, restored);
+        }
+    }
+    /**
+     * List all backups in cloud storage.
+     */
+    async listBackups(prefix) {
+        const searchPrefix = prefix ?? this.config.options?.prefix ?? 'backups/';
+        return await this.storage.list(searchPrefix);
+    }
+    /**
+     * Delete old backups exceeding maxBackups limit.
+     */
+    async cleanupOldBackups(prefix) {
+        if (!this.config.maxBackups)
+            return;
+        const backups = await this.storage.list(prefix);
+        if (backups.length <= this.config.maxBackups)
+            return;
+        // Sort by name (timestamp) and delete oldest
+        const sorted = backups.sort();
+        const toDelete = sorted.slice(0, backups.length - this.config.maxBackups);
+        for (const key of toDelete) {
+            await this.storage.delete(key);
+        }
+    }
+    /**
+     * Start automatic scheduled backups.
+     */
+    start() {
+        if (this.intervalId) {
+            throw new Error('Scheduled backups already started');
+        }
+        this.intervalId = setInterval(async () => {
+            try {
+                const key = await this.backup();
+                this.config.onSuccess?.(key);
+            }
+            catch (error) {
+                this.config.onError?.(error);
+            }
+        }, this.config.interval);
+    }
+    /**
+     * Stop automatic scheduled backups.
+     */
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        }
+    }
+    /**
+     * Perform a backup immediately (manual trigger).
+     */
+    async backupNow(options) {
+        return await this.backup(options);
+    }
+}
+/**
+ * Create a cloud backup manager with S3-compatible storage.
+ *
+ * This is the main factory function for setting up cloud backups.
+ * It creates an S3StorageProvider and CloudBackupManager configured
+ * with your database and S3-compatible storage.
+ *
+ * @param adapter - The StorageAdapter instance to backup
+ * @param s3Client - AWS SDK S3Client (works with S3, R2, MinIO, etc.)
+ * @param bucket - The S3 bucket name
+ * @param config - Scheduled backup configuration
+ * @returns CloudBackupManager instance ready to start
+ *
+ * @example AWS S3
+ * ```typescript
+ * import { S3Client } from '@aws-sdk/client-s3';
+ * import { createCloudBackupManager } from '@framers/sql-storage-adapter';
+ *
+ * const s3 = new S3Client({ region: 'us-east-1' });
+ * const manager = createCloudBackupManager(db, s3, 'my-bucket', {
+ *   interval: 60 * 60 * 1000, // 1 hour
+ *   maxBackups: 24,
+ *   options: { compression: 'gzip' }
+ * });
+ *
+ * manager.start();
+ * ```
+ *
+ * @example Cloudflare R2
+ * ```typescript
+ * import { S3Client } from '@aws-sdk/client-s3';
+ *
+ * const r2 = new S3Client({
+ *   region: 'auto',
+ *   endpoint: `https://${accountId}.r2.cloudflarestorage.com`,
+ *   credentials: {
+ *     accessKeyId: process.env.R2_ACCESS_KEY_ID,
+ *     secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
+ *   },
+ * });
+ *
+ * const manager = createCloudBackupManager(db, r2, 'backups', {
+ *   interval: 24 * 60 * 60 * 1000, // Daily
+ *   maxBackups: 7
+ * });
+ * ```
+ */
+export function createCloudBackupManager(adapter, s3Client, bucket, config) {
+    const storage = new S3StorageProvider(s3Client, bucket);
+    return new CloudBackupManager(adapter, storage, config);
+}
+//# sourceMappingURL=cloudBackup.js.map

package/dist/utils/cloudBackup.js.map

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

package/dist/utils/dataExport.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Data export utilities for cross-adapter migration and backup.
+ * Supports exporting data to portable formats (JSON, SQL, CSV).
+ */
+import type { StorageAdapter } from '../types';
+/**
+ * Export format types.
+ */
+export type ExportFormat = 'json' | 'sql' | 'csv';
+/**
+ * Options for data export.
+ */
+export interface DataExportOptions {
+    /** Tables to export (all if not specified) */
+    tables?: string[];
+    /** Include schema/DDL statements */
+    includeSchema?: boolean;
+    /** Format for export */
+    format?: ExportFormat;
+    /** Batch size for large exports */
+    batchSize?: number;
+    /** Whether to pretty-print JSON */
+    pretty?: boolean;
+}
+/**
+ * Exported data structure.
+ */
+export interface ExportedData {
+    version: string;
+    exportedAt: string;
+    adapter: string;
+    schema?: TableSchema[];
+    data: Record<string, unknown[]>;
+}
+/**
+ * Table schema information.
+ */
+export interface TableSchema {
+    name: string;
+    columns: ColumnInfo[];
+    primaryKeys?: string[];
+    indexes?: IndexInfo[];
+}
+/**
+ * Column information.
+ */
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable?: boolean;
+    defaultValue?: string;
+}
+/**
+ * Index information.
+ */
+export interface IndexInfo {
+    name: string;
+    columns: string[];
+    unique?: boolean;
+}
+/**
+ * Export data from an adapter to a portable format.
+ */
+export declare function exportData(adapter: StorageAdapter, options?: DataExportOptions): Promise<ExportedData>;
+/**
+ * Export data as JSON string.
+ */
+export declare function exportAsJSON(adapter: StorageAdapter, options?: DataExportOptions): Promise<string>;
+/**
+ * Export data as SQL statements.
+ */
+export declare function exportAsSQL(adapter: StorageAdapter, options?: DataExportOptions): Promise<string>;
+/**
+ * Export data as CSV (one file per table).
+ */
+export declare function exportAsCSV(adapter: StorageAdapter, options?: DataExportOptions): Promise<Record<string, string>>;
+//# sourceMappingURL=dataExport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataExport.d.ts","sourceRoot":"","sources":["../../src/utils/dataExport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oCAAoC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wBAAwB;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA2BjC"}

package/dist/utils/dataExport.js

@@ -0,0 +1,212 @@
+/**
+ * Data export utilities for cross-adapter migration and backup.
+ * Supports exporting data to portable formats (JSON, SQL, CSV).
+ */
+/**
+ * Export data from an adapter to a portable format.
+ */
+export async function exportData(adapter, options = {}) {
+    const { tables, includeSchema = true, batchSize = 1000 } = options;
+    const exportedData = {
+        version: '1.0.0',
+        exportedAt: new Date().toISOString(),
+        adapter: 'sql-storage-adapter',
+        data: {},
+    };
+    // Get list of tables
+    const tablesToExport = tables || (await getTables(adapter));
+    // Export schema if requested
+    if (includeSchema) {
+        exportedData.schema = await Promise.all(tablesToExport.map(table => getTableSchema(adapter, table)));
+    }
+    // Export data from each table
+    for (const table of tablesToExport) {
+        const rows = [];
+        let offset = 0;
+        let batch;
+        // Fetch data in batches
+        do {
+            batch = await adapter.all(`SELECT * FROM ${escapeIdentifier(table)} LIMIT ${batchSize} OFFSET ${offset}`);
+            rows.push(...batch);
+            offset += batchSize;
+        } while (batch.length === batchSize);
+        exportedData.data[table] = rows;
+    }
+    return exportedData;
+}
+/**
+ * Export data as JSON string.
+ */
+export async function exportAsJSON(adapter, options = {}) {
+    const data = await exportData(adapter, options);
+    return JSON.stringify(data, null, options.pretty ? 2 : 0);
+}
+/**
+ * Export data as SQL statements.
+ */
+export async function exportAsSQL(adapter, options = {}) {
+    const data = await exportData(adapter, options);
+    const lines = [];
+    lines.push('-- SQL Export from sql-storage-adapter');
+    lines.push(`-- Generated at: ${data.exportedAt}`);
+    lines.push('');
+    // Export schema
+    if (data.schema) {
+        for (const table of data.schema) {
+            lines.push(`-- Table: ${table.name}`);
+            lines.push(generateCreateTableSQL(table));
+            lines.push('');
+        }
+    }
+    // Export data
+    for (const [tableName, rows] of Object.entries(data.data)) {
+        if (rows.length === 0)
+            continue;
+        lines.push(`-- Data for table: ${tableName}`);
+        for (const row of rows) {
+            lines.push(generateInsertSQL(tableName, row));
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Export data as CSV (one file per table).
+ */
+export async function exportAsCSV(adapter, options = {}) {
+    const data = await exportData(adapter, options);
+    const csvFiles = {};
+    for (const [tableName, rows] of Object.entries(data.data)) {
+        if (rows.length === 0) {
+            csvFiles[tableName] = '';
+            continue;
+        }
+        const firstRow = rows[0];
+        const headers = Object.keys(firstRow);
+        const lines = [];
+        lines.push(headers.map(escapeCSVValue).join(','));
+        for (const row of rows) {
+            const values = headers.map(header => escapeCSVValue(String(row[header] ?? '')));
+            lines.push(values.join(','));
+        }
+        csvFiles[tableName] = lines.join('\n');
+    }
+    return csvFiles;
+}
+/**
+ * Get list of tables from adapter.
+ */
+async function getTables(adapter) {
+    // Try SQLite/PostgreSQL table query
+    try {
+        const rows = await adapter.all(`SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'`);
+        return rows.map(r => r.name);
+    }
+    catch {
+        // Try PostgreSQL
+        try {
+            const rows = await adapter.all(`SELECT tablename AS name FROM pg_tables WHERE schemaname = 'public'`);
+            return rows.map(r => r.name);
+        }
+        catch {
+            throw new Error('Unable to retrieve table list from adapter');
+        }
+    }
+}
+/**
+ * Get schema for a specific table.
+ */
+async function getTableSchema(adapter, table) {
+    try {
+        // Try SQLite PRAGMA
+        const columns = await adapter.all(`PRAGMA table_info(${escapeIdentifier(table)})`);
+        return {
+            name: table,
+            columns: columns.map(col => ({
+                name: col.name,
+                type: col.type,
+                nullable: col.notnull === 0,
+                defaultValue: col.dflt_value ?? undefined,
+            })),
+        };
+    }
+    catch {
+        // Try PostgreSQL information_schema
+        try {
+            const columns = await adapter.all(`SELECT column_name, data_type, is_nullable, column_default 
+         FROM information_schema.columns 
+         WHERE table_name = $1`, [table]);
+            return {
+                name: table,
+                columns: columns.map(col => ({
+                    name: col.column_name,
+                    type: col.data_type,
+                    nullable: col.is_nullable === 'YES',
+                    defaultValue: col.column_default ?? undefined,
+                })),
+            };
+        }
+        catch {
+            // Fallback: no schema info
+            return {
+                name: table,
+                columns: [],
+            };
+        }
+    }
+}
+/**
+ * Generate CREATE TABLE SQL from schema.
+ */
+function generateCreateTableSQL(schema) {
+    if (schema.columns.length === 0) {
+        return `CREATE TABLE ${escapeIdentifier(schema.name)} ();`;
+    }
+    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;
+    });
+    return `CREATE TABLE ${escapeIdentifier(schema.name)} (\n${columnDefs.join(',\n')}\n);`;
+}
+/**
+ * Generate INSERT SQL for a row.
+ */
+function generateInsertSQL(table, row) {
+    const columns = Object.keys(row);
+    const values = columns.map(col => escapeSQLValue(row[col]));
+    return `INSERT INTO ${escapeIdentifier(table)} (${columns.map(escapeIdentifier).join(', ')}) VALUES (${values.join(', ')});`;
+}
+/**
+ * Escape SQL identifier (table/column name).
+ */
+function escapeIdentifier(identifier) {
+    return `"${identifier.replace(/"/g, '""')}"`;
+}
+/**
+ * Escape SQL value for INSERT statement.
+ */
+function escapeSQLValue(value) {
+    if (value === null || value === undefined)
+        return 'NULL';
+    if (typeof value === 'number')
+        return String(value);
+    if (typeof value === 'boolean')
+        return value ? '1' : '0';
+    if (value instanceof Date)
+        return `'${value.toISOString()}'`;
+    return `'${String(value).replace(/'/g, "''")}'`;
+}
+/**
+ * Escape CSV value.
+ */
+function escapeCSVValue(value) {
+    if (value.includes(',') || value.includes('"') || value.includes('\n')) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+//# sourceMappingURL=dataExport.js.map

package/dist/utils/dataExport.js.map

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

package/dist/utils/dataImport.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Data import utilities for cross-adapter migration and restoration.
+ * Supports importing from JSON, SQL dumps, and CSV files.
+ */
+import type { StorageAdapter } from '../types';
+import type { ExportedData } from './dataExport';
+/**
+ * Options for data import.
+ */
+export interface DataImportOptions {
+    /** Drop existing tables before import */
+    dropTables?: boolean;
+    /** Skip schema creation (data only) */
+    skipSchema?: boolean;
+    /** Skip data import (schema only) */
+    skipData?: boolean;
+    /** Batch size for inserts */
+    batchSize?: number;
+    /** Tables to import (all if not specified) */
+    tables?: string[];
+    /** On conflict strategy */
+    onConflict?: 'replace' | 'ignore' | 'error';
+}
+/**
+ * Import result with statistics.
+ */
+export interface ImportResult {
+    success: boolean;
+    tablesImported: number;
+    rowsImported: number;
+    errors?: string[];
+    duration: number;
+}
+/**
+ * Import data from exported JSON format.
+ */
+export declare function importData(adapter: StorageAdapter, data: ExportedData, options?: DataImportOptions): Promise<ImportResult>;
+/**
+ * Import data from JSON string.
+ */
+export declare function importFromJSON(adapter: StorageAdapter, jsonString: string, options?: DataImportOptions): Promise<ImportResult>;
+/**
+ * Import data from SQL dump.
+ */
+export declare function importFromSQL(adapter: StorageAdapter, sqlDump: string, options?: DataImportOptions): Promise<ImportResult>;
+/**
+ * Import data from CSV.
+ */
+export declare function importFromCSV(adapter: StorageAdapter, tableName: string, csvContent: string, options?: DataImportOptions): Promise<ImportResult>;
+/**
+ * Migrate data from one adapter to another.
+ */
+export declare function migrateAdapter(sourceAdapter: StorageAdapter, targetAdapter: StorageAdapter, options?: DataImportOptions): Promise<ImportResult>;
+//# sourceMappingURL=dataImport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataImport.d.ts","sourceRoot":"","sources":["../../src/utils/dataImport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CA4FvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAqDvB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAkCvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,cAAc,EAC7B,aAAa,EAAE,cAAc,EAC7B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAWvB"}