nanodb-orm 0.0.3 → 0.0.5

package/dist/utils/transactions.js

@@ -1,159 +1,125 @@
 "use strict";
-/**
- * Transaction utilities for atomic database operations
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransactionManager = void 0;
+exports.transaction = transaction;
+exports.batch = batch;
+exports.recreateTable = recreateTable;
+const drizzle_orm_1 = require("drizzle-orm");
 const connection_1 = require("../core/connection");
 const logger_1 = require("./logger");
-const error_handler_1 = require("./error-handler");
+// ============================================================================
+// Public API
+// ============================================================================
 /**
- * Transaction management utilities
+ * Execute operations within a database transaction.
+ * Automatically commits on success, rolls back on failure.
+ *
+ * Uses Drizzle's native transaction when available (recommended for Turso),
+ * with fallback to manual BEGIN/COMMIT for local SQLite.
+ *
+ * @example
+ * ```ts
+ * const result = await transaction(async (tx) => {
+ *   await tx.run(sql`UPDATE users SET age = age + 1 WHERE id = ${userId}`);
+ *   await tx.run(sql`INSERT INTO audit_log (action) VALUES ('age_updated')`);
+ *   return { updated: true };
+ * });
+ *
+ * if (result.success) {
+ *   console.log('Transaction committed:', result.result);
+ * } else {
+ *   console.error('Transaction failed:', result.error);
+ * }
+ * ```
  */
-class TransactionManager {
-    /**
-     * Execute a function within a database transaction
-     */
-    static async execute(operation, options = {}) {
-        const db = await connection_1.DatabaseConnection.getInstance();
-        const client = db;
+async function transaction(operation) {
+    const db = (await connection_1.DatabaseConnection.getInstance());
+    // Try to use Drizzle's native transaction (better for Turso/libSQL)
+    if (typeof db.transaction === 'function') {
         try {
-            logger_1.logger.debug('Starting database transaction');
-            // Begin transaction
-            await client.run('BEGIN TRANSACTION');
-            // Set isolation level if specified
-            if (options.isolationLevel) {
-                await client.run(`SET TRANSACTION ISOLATION LEVEL ${options.isolationLevel}`);
-            }
-            // Execute the operation
-            const result = await operation(client);
-            // Commit transaction
-            await client.run('COMMIT');
-            logger_1.logger.debug('Transaction committed successfully');
-            return {
-                success: true,
-                result
-            };
+            const result = await db.transaction(async (tx) => {
+                const client = {
+                    run: (query) => tx.run(query),
+                };
+                return operation(client);
+            });
+            logger_1.logger.debug('Transaction committed (native)');
+            return { success: true, result };
         }
         catch (error) {
-            logger_1.logger.error('Transaction failed, attempting rollback:', error);
-            try {
-                await client.run('ROLLBACK');
-                logger_1.logger.debug('Transaction rolled back successfully');
-            }
-            catch (rollbackError) {
-                logger_1.logger.error('Failed to rollback transaction:', rollbackError);
-                return {
-                    success: false,
-                    error: error instanceof Error ? error : new Error(String(error)),
-                    rollbackError: rollbackError instanceof Error ? rollbackError : new Error(String(rollbackError))
-                };
-            }
+            logger_1.logger.debug('Transaction rolled back (native)');
             return {
                 success: false,
-                error: error instanceof Error ? error : new Error(String(error))
+                error: error instanceof Error ? error : new Error(String(error)),
             };
         }
     }
-    /**
-     * Execute multiple operations in a single transaction
-     */
-    static async executeBatch(operations, options = {}) {
-        return this.execute(async (db) => {
-            const results = [];
-            for (const operation of operations) {
-                const result = await operation(db);
-                results.push(result);
-            }
-            return results;
-        }, options);
-    }
-    /**
-     * Execute a migration operation with transaction support
-     */
-    static async executeMigration(migrationOperation, options = {}) {
-        return this.execute(async (db) => {
-            logger_1.logger.info('Executing migration within transaction');
-            await migrationOperation(db);
-            logger_1.logger.info('Migration completed successfully');
-        }, options);
+    // Fallback to manual transaction for local SQLite
+    const tx = {
+        run: (query) => db.run(query),
+    };
+    try {
+        await db.run(drizzle_orm_1.sql.raw('BEGIN TRANSACTION'));
+        const result = await operation(tx);
+        await db.run(drizzle_orm_1.sql.raw('COMMIT'));
+        logger_1.logger.debug('Transaction committed');
+        return { success: true, result };
     }
-    /**
-     * Execute table recreation with transaction support
-     */
-    static async recreateTable(tableName, createOperation, options = {}) {
-        return this.execute(async (db) => {
-            logger_1.logger.info(`Recreating table ${tableName} within transaction`);
-            // Drop table if exists
-            await db.run(`DROP TABLE IF EXISTS ${tableName}`);
-            logger_1.logger.debug(`Dropped table ${tableName}`);
-            // Create new table
-            await createOperation(db);
-            logger_1.logger.debug(`Created table ${tableName}`);
-            logger_1.logger.info(`Table ${tableName} recreated successfully`);
-        }, options);
-    }
-    /**
-     * Execute data seeding with transaction support
-     */
-    static async seedData(seedOperation, options = {}) {
-        return this.execute(async (db) => {
-            logger_1.logger.info('Seeding data within transaction');
-            await seedOperation(db);
-            logger_1.logger.info('Data seeding completed successfully');
-        }, options);
-    }
-    /**
-     * Execute database reset with transaction support
-     */
-    static async resetDatabase(resetOperation, options = {}) {
-        return this.execute(async (db) => {
-            logger_1.logger.warn('Resetting database within transaction');
-            await resetOperation(db);
-            logger_1.logger.info('Database reset completed successfully');
-        }, options);
-    }
-    /**
-     * Check if the database supports transactions
-     */
-    static async supportsTransactions() {
+    catch (error) {
         try {
-            const db = await connection_1.DatabaseConnection.getInstance();
-            const client = db;
-            // Try to start a transaction
-            await client.run('BEGIN TRANSACTION');
-            await client.run('ROLLBACK');
-            return true;
+            await db.run(drizzle_orm_1.sql.raw('ROLLBACK'));
+            logger_1.logger.debug('Transaction rolled back');
         }
-        catch (error) {
-            error_handler_1.ErrorHandler.handleOptionalError(error, 'check-transaction-support', 'Database does not support transactions');
-            return false;
+        catch (rollbackError) {
+            logger_1.logger.error('Rollback failed', rollbackError);
         }
+        return {
+            success: false,
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
     }
-    /**
-     * Get transaction status
-     */
-    static async getTransactionStatus() {
-        try {
-            const db = await connection_1.DatabaseConnection.getInstance();
-            const client = db;
-            // Check if we're in a transaction
-            const result = await client.run('SELECT * FROM pragma_transaction_state');
-            const inTransaction = result.rows.length > 0 && result.rows[0].state === 'active';
-            const supportsTransactions = await this.supportsTransactions();
-            return {
-                inTransaction,
-                supportsTransactions
-            };
-        }
-        catch (error) {
-            error_handler_1.ErrorHandler.handleNonThrowingError(error, 'get-transaction-status', 'Failed to get transaction status');
-            return {
-                inTransaction: false,
-                supportsTransactions: false
-            };
+}
+/**
+ * Execute a batch of SQL statements atomically.
+ * All statements succeed or all fail together.
+ *
+ * This is more efficient than individual transactions for multiple operations.
+ *
+ * @example
+ * ```ts
+ * const result = await batch([
+ *   sql`INSERT INTO users (name) VALUES ('Alice')`,
+ *   sql`INSERT INTO users (name) VALUES ('Bob')`,
+ *   sql`UPDATE settings SET value = 'done' WHERE key = 'migration'`,
+ * ]);
+ * ```
+ */
+async function batch(statements) {
+    return transaction(async (tx) => {
+        const results = [];
+        for (const stmt of statements) {
+            results.push(await tx.run(stmt));
         }
-    }
+        return results;
+    });
+}
+/**
+ * Drop and recreate a table within a transaction.
+ *
+ * @example
+ * ```ts
+ * const result = await recreateTable('users', `
+ *   CREATE TABLE users (
+ *     id INTEGER PRIMARY KEY AUTOINCREMENT,
+ *     name TEXT NOT NULL
+ *   )
+ * `);
+ * ```
+ */
+async function recreateTable(tableName, createSql) {
+    return transaction(async (tx) => {
+        await tx.run(drizzle_orm_1.sql.raw(`DROP TABLE IF EXISTS "${tableName}"`));
+        await tx.run(drizzle_orm_1.sql.raw(createSql));
+        logger_1.logger.info(`Recreated table: ${tableName}`);
+    });
 }
-exports.TransactionManager = TransactionManager;
 //# sourceMappingURL=transactions.js.map

package/dist/utils/transactions.js.map

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

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "nanodb-orm",
-  "version": "0.0.3",
-  "description": "Generic database package with Drizzle ORM, auto-migrations, and schema introspection",
+  "version": "0.0.5",
+  "description": "Lightweight ORM wrapper for Drizzle with auto-migrations, schema introspection, and CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "nanodb": "./dist/cli.js"
+  },
   "files": [
     "dist/**/*",
     "README.md",
-    "LICENSE",
-    "llm.txt"
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsc",
@@ -16,7 +18,8 @@
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build",
     "test": "jest",
-    "test:watch": "jest --watchAll"
+    "test:watch": "jest --watchAll",
+    "studio": "npx ts-node cli.ts studio"
   },
   "keywords": [
     "database",
@@ -25,7 +28,9 @@
     "turso",
     "migrations",
     "schema",
-    "orm"
+    "orm",
+    "cli",
+    "studio"
   ],
   "author": "Damilola Alao",
   "license": "MIT",
@@ -36,19 +41,33 @@
   "devDependencies": {
     "@types/jest": "^29.5.12",
     "@types/node": "^22.15.21",
+    "drizzle-kit": "^0.31.8",
     "jest": "^29.7.0",
     "ts-jest": "^29.2.0",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {
-    "dotenv": "^17.2.1"
+    "dotenv": "^17.2.1",
+    "drizzle-kit": "^0.30.0"
+  },
+  "peerDependenciesMeta": {
+    "drizzle-kit": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@libsql/darwin-arm64": "^0.3.19",
+    "@libsql/darwin-x64": "^0.3.19",
+    "@libsql/linux-x64-gnu": "^0.3.19",
+    "@libsql/linux-arm64-gnu": "^0.3.19",
+    "@libsql/win32-x64-msvc": "^0.3.19"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/damilolaalao/nanodb-orm.git"
+    "url": "https://github.com/Easy-Deploy-Dev/nanodb-orm.git"
   },
   "bugs": {
-    "url": "https://github.com/damilolaalao/nanodb-orm/issues"
+    "url": "https://github.com/Easy-Deploy-Dev/nanodb-orm/issues"
   },
-  "homepage": "https://github.com/damilolaalao/nanodb-orm#readme"
+  "homepage": "https://github.com/Easy-Deploy-Dev/nanodb-orm#readme"
 }

package/dist/example.d.ts

@@ -1,67 +0,0 @@
-/**
- * Example usage of nanodb-orm package
- * This file demonstrates how to use the database package in your application
- */
-declare const exampleTables: {
-    users: {
-        id: {
-            dataType: string;
-            primary: boolean;
-            autoIncrement: boolean;
-            notNull: boolean;
-        };
-        name: {
-            dataType: string;
-            notNull: boolean;
-        };
-        age: {
-            dataType: string;
-            notNull: boolean;
-        };
-        email: {
-            dataType: string;
-            notNull: boolean;
-            unique: boolean;
-        };
-    };
-    posts: {
-        id: {
-            dataType: string;
-            primary: boolean;
-            autoIncrement: boolean;
-            notNull: boolean;
-        };
-        title: {
-            dataType: string;
-            notNull: boolean;
-        };
-        content: {
-            dataType: string;
-            notNull: boolean;
-        };
-        userId: {
-            dataType: string;
-            notNull: boolean;
-        };
-    };
-};
-declare const exampleSeedData: {
-    users: {
-        name: string;
-        age: number;
-        email: string;
-    }[];
-    posts: {
-        title: string;
-        content: string;
-        userId: number;
-    }[];
-};
-declare const exampleMigrationConfig: {
-    preserveData: boolean;
-    autoMigrate: boolean;
-    dropTables: boolean;
-};
-declare function example(): Promise<void>;
-export { example, exampleTables, exampleSeedData, exampleMigrationConfig };
-//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../example.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAalB,CAAC;AAGF,QAAA,MAAM,eAAe;;;;;;;;;;;CASpB,CAAC;AAGF,QAAA,MAAM,sBAAsB;;;;CAI3B,CAAC;AAEF,iBAAe,OAAO,kBA2CrB;AAOD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/example.js

@@ -1,86 +0,0 @@
-"use strict";
-/**
- * Example usage of nanodb-orm package
- * This file demonstrates how to use the database package in your application
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.exampleMigrationConfig = exports.exampleSeedData = exports.exampleTables = void 0;
-exports.example = example;
-const index_1 = require("./index");
-// Example: Define your Drizzle tables
-const exampleTables = {
-    users: {
-        id: { dataType: 'integer', primary: true, autoIncrement: true, notNull: true },
-        name: { dataType: 'text', notNull: true },
-        age: { dataType: 'integer', notNull: true },
-        email: { dataType: 'text', notNull: true, unique: true }
-    },
-    posts: {
-        id: { dataType: 'integer', primary: true, autoIncrement: true, notNull: true },
-        title: { dataType: 'text', notNull: true },
-        content: { dataType: 'text', notNull: true },
-        userId: { dataType: 'integer', notNull: true }
-    }
-};
-exports.exampleTables = exampleTables;
-// Example: Define seed data
-const exampleSeedData = {
-    users: [
-        { name: 'Alice Johnson', age: 28, email: 'alice@example.com' },
-        { name: 'Bob Smith', age: 32, email: 'bob@example.com' }
-    ],
-    posts: [
-        { title: 'Welcome to our blog', content: 'This is our first post!', userId: 1 },
-        { title: 'Getting started', content: 'Here are some tips for beginners.', userId: 2 }
-    ]
-};
-exports.exampleSeedData = exampleSeedData;
-// Example: Migration configuration
-const exampleMigrationConfig = {
-    preserveData: true, // Always try to preserve existing data
-    autoMigrate: true, // Enable automatic migrations
-    dropTables: false // Don't drop tables by default
-};
-exports.exampleMigrationConfig = exampleMigrationConfig;
-async function example() {
-    try {
-        console.log('🚀 Initializing database package...');
-        // Initialize the database package
-        (0, index_1.initializeDatabase)({
-            tables: exampleTables,
-            seedData: exampleSeedData,
-            migrationConfig: exampleMigrationConfig
-        });
-        console.log('✅ Database package initialized successfully!');
-        // Setup the database (create tables, run migrations, seed data)
-        console.log('🔧 Setting up database...');
-        await index_1.DatabaseSync.setup();
-        console.log('✅ Database setup completed!');
-        // Example: Schema introspection
-        console.log('🔍 Analyzing schema...');
-        const tableNames = index_1.SchemaIntrospection.getAllTableNames();
-        console.log('📊 Tables found:', tableNames);
-        const schemaStats = index_1.SchemaIntrospection.getSchemaStats();
-        console.log('📈 Schema statistics:', {
-            totalTables: schemaStats.totalTables,
-            tableNames: schemaStats.tableNames
-        });
-        // Example: Check database health
-        const healthCheck = await index_1.DatabaseSync.healthCheck();
-        console.log('🎯 Database health:', healthCheck.healthy);
-        console.log('📊 Database info:', {
-            tables: healthCheck.tables,
-            totalRecords: healthCheck.totalRecords,
-            schemaValid: healthCheck.schemaValid
-        });
-        console.log('🎉 Example completed successfully!');
-    }
-    catch (error) {
-        console.error('❌ Error in example:', error);
-    }
-}
-// Run the example if this file is executed directly
-if (require.main === module) {
-    example();
-}
-//# sourceMappingURL=example.js.map

package/dist/example.js.map

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

package/dist/types/database.d.ts

@@ -1,74 +0,0 @@
-/**
- * Database type definitions for better type safety
- */
-export interface DatabaseClient {
-    run(query: string, params?: any[]): Promise<{
-        rows: any[];
-    }>;
-    $client?: {
-        sync?: () => Promise<void>;
-        [key: string]: any;
-    };
-}
-export interface TableColumn {
-    name: string;
-    dataType: string;
-    primary?: boolean;
-    autoIncrement?: boolean;
-    notNull?: boolean;
-    unique?: boolean;
-    default?: any;
-    references?: {
-        table: string;
-        column: string;
-        onDelete?: string;
-    };
-}
-export interface TableDefinition {
-    name: string;
-    columns: Record<string, TableColumn>;
-    primaryKey: string[];
-    foreignKeys: Array<{
-        column: string;
-        references: string;
-        table: string;
-    }>;
-    indexes: string[];
-}
-export interface DatabaseRow {
-    [key: string]: any;
-}
-export interface QueryResult {
-    rows: DatabaseRow[];
-    changes?: number;
-    lastInsertRowid?: number;
-}
-export interface MigrationResult {
-    success: boolean;
-    message: string;
-    tablesAffected: string[];
-    errors: string[];
-}
-export interface SchemaValidationResult {
-    isValid: boolean;
-    missingTables: string[];
-    extraTables: string[];
-    errors: string[];
-}
-export interface DatabaseInfoExtended {
-    tables: string[];
-    tableCounts: Record<string, number>;
-    totalRecords: number;
-    schemaValid: boolean;
-    syncSupported: boolean;
-}
-export interface HealthCheckResultExtended {
-    healthy: boolean;
-    tables: string[];
-    tableCounts: Record<string, number>;
-    totalRecords: number;
-    schemaValid: boolean;
-    syncSupported: boolean;
-    errors: string[];
-}
-//# sourceMappingURL=database.d.ts.map

package/dist/types/database.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../types/database.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/types/database.js

@@ -1,6 +0,0 @@
-"use strict";
-/**
- * Database type definitions for better type safety
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=database.js.map

package/dist/types/database.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../types/database.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/types.d.ts

@@ -1,30 +0,0 @@
-/**
- * Database-related TypeScript interfaces and types
- */
-export interface DatabaseInfo {
-    dbTables: string[];
-    schemaTables: string[];
-    tableCounts: Record<string, number>;
-    connectionUrl: string;
-    hasAuth: boolean;
-    isSchemaSynced: boolean;
-}
-export interface HealthCheckResult {
-    isHealthy: boolean;
-    missingTables: string[];
-    errors: string[];
-}
-export interface SeedData {
-    [tableName: string]: Array<Record<string, any>>;
-}
-export interface SyncResult {
-    success: boolean;
-    message: string;
-    timestamp: Date;
-}
-export interface TableInfo {
-    name: string;
-    exists: boolean;
-    rowCount: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../types/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB"}