nanodb-orm 0.0.3 → 0.0.5

package/dist/init.js

@@ -1,63 +1,296 @@
 "use strict";
-/**
- * Database initialization utility
- * Initializes the db package with schema data to work as an npm package
- */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDatabase = createDatabase;
 exports.initializeDatabase = initializeDatabase;
-exports.getSchemaInfo = getSchemaInfo;
 const schema_introspection_1 = require("./utils/schema-introspection");
 const seeds_1 = require("./utils/seeds");
 const migrations_1 = require("./utils/migrations");
+const sync_1 = require("./utils/sync");
+const connection_1 = require("./core/connection");
 const logger_1 = require("./utils/logger");
+// ============================================================================
+// Hook System
+// ============================================================================
+const HOOK_TYPES = [
+    'beforeInsert', 'afterInsert',
+    'beforeUpdate', 'afterUpdate',
+    'beforeDelete', 'afterDelete',
+    'beforeQuery', 'afterQuery',
+];
+/** Create hook runner from plugins (optimized - computes hook map once) */
+function createHooks(plugins) {
+    const hookMap = new Map();
+    const errorHandlers = [];
+    const readyHandlers = [];
+    // Build hook map (O(n) - runs once at startup)
+    for (const type of HOOK_TYPES) {
+        const fns = plugins
+            .map((p) => p[type])
+            .filter((fn) => fn !== undefined);
+        if (fns.length > 0)
+            hookMap.set(type, fns);
+    }
+    // Collect lifecycle handlers
+    for (const plugin of plugins) {
+        if (plugin.onError)
+            errorHandlers.push(plugin.onError);
+        if (plugin.onReady)
+            readyHandlers.push(plugin.onReady);
+    }
+    /** Execute hooks - O(1) lookup, then O(k) for k hooks */
+    const run = (type, table, data, result) => {
+        const fns = hookMap.get(type);
+        if (!fns)
+            return data;
+        // "before" hooks can transform data, "after" hooks just execute
+        if (type.startsWith('before')) {
+            return fns.reduce((acc, fn) => fn(table, acc) ?? acc, data);
+        }
+        fns.forEach((fn) => fn(table, data, result));
+        return data;
+    };
+    return {
+        beforeInsert: (t, d) => run('beforeInsert', t, d),
+        afterInsert: (t, d, r) => run('afterInsert', t, d, r),
+        beforeUpdate: (t, d) => run('beforeUpdate', t, d),
+        afterUpdate: (t, d, r) => run('afterUpdate', t, d, r),
+        beforeDelete: (t, d) => run('beforeDelete', t, d),
+        afterDelete: (t, d, r) => run('afterDelete', t, d, r),
+        beforeQuery: (t, d) => run('beforeQuery', t, d),
+        afterQuery: (t, d, r) => run('afterQuery', t, d, r),
+        onError: (e, op, t) => errorHandlers.forEach((h) => h(e, op, t)),
+        onReady: (db) => readyHandlers.forEach((h) => h(db)),
+        has: (type) => hookMap.has(type),
+    };
+}
+// ============================================================================
+// Database Creation
+// ============================================================================
+/** Extract table name from Drizzle table object */
+function getTableName(table) {
+    // Access the internal Drizzle name symbol
+    const t = table;
+    const name = t[Symbol.for('drizzle:Name')] ?? t._?.name;
+    return typeof name === 'string' ? name : 'unknown';
+}
 /**
- * Initialize the database package with schema data
- * This allows the db package to work independently without direct imports
+ * Create and initialize the database with schema, migrations, seeds, and plugins.
+ * This is the main entry point for nanodb-orm.
+ *
+ * The returned database instance is fully type-safe - all queries, inserts, and
+ * updates will have proper TypeScript types inferred from your schema.
+ *
+ * @example
+ * ```ts
+ * import { createDatabase, table, integer, text } from 'nanodb-orm';
+ *
+ * const users = table('users', {
+ *   id: integer('id').primaryKey({ autoIncrement: true }),
+ *   name: text('name').notNull(),
+ *   email: text('email').notNull(),
+ * });
+ *
+ * const db = await createDatabase({
+ *   tables: { users },
+ *   seedData: { users: [{ name: 'Alice', email: 'alice@example.com' }] },
+ * });
+ *
+ * // Fully typed! `allUsers` is User[]
+ * const allUsers = await db.select().from(users);
+ *
+ * // Type error if you try to insert invalid data
+ * await db.insert(users).values({ name: 'Bob', email: 'bob@example.com' });
+ * ```
  */
-function initializeDatabase(schemaData) {
-    try {
-        logger_1.logger.info('Initializing database package with schema data...');
-        // Derive table names from the tables object
-        const tableNames = Object.keys(schemaData.tables);
-        // Initialize schema introspection
-        schema_introspection_1.SchemaIntrospection.initialize({
-            tables: schemaData.tables,
-            tableNames: tableNames,
-        });
-        // Initialize database migrations
-        migrations_1.DatabaseMigrations.initialize({
-            tables: schemaData.tables,
-            tableNames: tableNames,
-            migrationConfig: {
-                preserveData: true, // Always preserve data by default
-                autoMigrate: true, // Default to auto-migration
-                dropTables: false, // Default to not dropping tables
-                ...schemaData.migrationConfig, // Override with any provided config
-            },
-        });
-        // Initialize database seeds
-        seeds_1.DatabaseSeeds.initialize({
-            tables: schemaData.tables,
-            tableNames: tableNames,
-            seedData: schemaData.seedData || {},
-        });
-        logger_1.logger.info('Database package initialized successfully!');
-        logger_1.logger.info(`Loaded ${tableNames.length} tables: ${tableNames.join(', ')}`);
-        logger_1.logger.info(`Loaded seed data for ${Object.keys(schemaData.seedData || {}).length} tables`);
+async function createDatabase(config) {
+    // Initialize all modules with schema
+    initializeDatabase(config);
+    // Run migrations and seed
+    await migrations_1.DatabaseMigrations.initializeSchema();
+    if (config.seedData)
+        await seeds_1.DatabaseSeeds.seed();
+    // Get Drizzle instance and setup plugins
+    const drizzle = await connection_1.DatabaseConnection.getInstance();
+    const plugins = config.plugins ?? [];
+    const hooks = createHooks(plugins);
+    // Store original methods
+    const originalInsert = drizzle.insert.bind(drizzle);
+    const originalUpdate = drizzle.update.bind(drizzle);
+    const originalDelete = drizzle.delete.bind(drizzle);
+    const originalSelect = drizzle.select.bind(drizzle);
+    // Helper to wrap promise with after hook (preserves original type)
+    function wrapWithAfterHook(promise, afterFn) {
+        const original = promise.then.bind(promise);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        promise.then = function (onFulfilled, onRejected) {
+            return original((result) => {
+                afterFn();
+                return onFulfilled ? onFulfilled(result) : result;
+            }, onRejected);
+        };
+        return promise;
     }
-    catch (error) {
-        logger_1.logger.error('Failed to initialize database package:', error);
-        throw error;
+    const wrappedSelect = new Proxy(originalSelect, {
+        apply(target, _thisArg, args) {
+            const builder = target(...args);
+            const originalFrom = builder.from;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            builder.from = new Proxy(originalFrom, {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                apply(fromTarget, fromThis, fromArgs) {
+                    const table = fromArgs[0];
+                    const tableName = getTableName(table);
+                    hooks.beforeQuery(tableName, args[0] ?? '*');
+                    const result = fromTarget.apply(fromThis, fromArgs);
+                    // Wrap then() to call afterQuery
+                    const originalThen = result.then.bind(result);
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    result.then = function (onFulfilled, onRejected) {
+                        return originalThen((rows) => {
+                            hooks.afterQuery(tableName, args[0] ?? '*', rows);
+                            return onFulfilled ? onFulfilled(rows) : rows;
+                        }, onRejected);
+                    };
+                    return result;
+                },
+            });
+            return builder;
+        },
+    });
+    const wrappedInsert = ((table) => {
+        const tableName = getTableName(table);
+        const builder = originalInsert(table);
+        const originalValues = builder.values.bind(builder);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        builder.values = (data) => {
+            try {
+                const processed = Array.isArray(data)
+                    ? data.map((d) => hooks.beforeInsert(tableName, d))
+                    : hooks.beforeInsert(tableName, data);
+                const result = originalValues(processed);
+                return wrapWithAfterHook(result, () => hooks.afterInsert(tableName, processed, result));
+            }
+            catch (err) {
+                hooks.onError(err, 'insert', tableName);
+                throw err;
+            }
+        };
+        return builder;
+    });
+    const wrappedUpdate = ((table) => {
+        const tableName = getTableName(table);
+        const builder = originalUpdate(table);
+        const originalSet = builder.set.bind(builder);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        builder.set = (data) => {
+            try {
+                const processed = hooks.beforeUpdate(tableName, data);
+                const result = originalSet(processed);
+                return wrapWithAfterHook(result, () => hooks.afterUpdate(tableName, processed, result));
+            }
+            catch (err) {
+                hooks.onError(err, 'update', tableName);
+                throw err;
+            }
+        };
+        return builder;
+    });
+    const wrappedDelete = ((table) => {
+        const tableName = getTableName(table);
+        const builder = originalDelete(table);
+        const originalWhere = builder.where.bind(builder);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        builder.where = (condition) => {
+            try {
+                hooks.beforeDelete(tableName, condition ?? {});
+                const result = originalWhere(condition);
+                return wrapWithAfterHook(result, () => hooks.afterDelete(tableName, condition ?? {}, result));
+            }
+            catch (err) {
+                hooks.onError(err, 'delete', tableName);
+                throw err;
+            }
+        };
+        return builder;
+    });
+    // Schema utilities with proper typing
+    const schemaUtils = {
+        tables: () => schema_introspection_1.SchemaIntrospection.getAllTableNames(),
+        getTable: (name) => schema_introspection_1.SchemaIntrospection.getTableInfo(String(name)),
+        getColumns: (name) => schema_introspection_1.SchemaIntrospection.getTableColumns(String(name)),
+        validate: () => schema_introspection_1.SchemaIntrospection.validateSchema(),
+        stats: () => schema_introspection_1.SchemaIntrospection.getSchemaStats(),
+        relationships: () => schema_introspection_1.SchemaIntrospection.getTableRelationships(),
+    };
+    // Build enhanced db instance with utilities
+    let db = Object.assign(drizzle, {
+        select: wrappedSelect,
+        insert: wrappedInsert,
+        update: wrappedUpdate,
+        delete: wrappedDelete,
+        // Health & sync
+        healthCheck: () => sync_1.DatabaseSync.healthCheck(),
+        isReady: () => sync_1.DatabaseSync.isReady(),
+        sync: () => sync_1.DatabaseSync.sync(),
+        reset: () => sync_1.DatabaseSync.reset(),
+        seed: () => seeds_1.DatabaseSeeds.seed(),
+        clearData: () => seeds_1.DatabaseSeeds.clearAllData(),
+        // Schema introspection
+        schema: schemaUtils,
+        // Migration utilities
+        migrations: {
+            run: () => migrations_1.DatabaseMigrations.initializeSchema(),
+            validate: () => migrations_1.DatabaseMigrations.validateSchema(),
+            checkTables: () => migrations_1.DatabaseMigrations.checkTableExistence(),
+        },
+        // Plugin info
+        plugins: { list: () => plugins.map((p) => p.name) },
+        hooks,
+    });
+    // Apply plugin installers
+    for (const plugin of plugins) {
+        if (plugin.install) {
+            const result = plugin.install(db);
+            if (result)
+                db = result;
+        }
     }
+    // Trigger ready hooks
+    hooks.onReady(db);
+    return db;
 }
+// ============================================================================
+// Module Initialization
+// ============================================================================
+/** Default migration settings */
+const DEFAULT_MIGRATION_CONFIG = {
+    preserveData: true,
+    autoMigrate: true,
+    dropTables: false,
+};
 /**
- * Get initialized schema data (for verification)
+ * Initialize internal modules with schema data.
+ * Prefer `createDatabase()` which calls this automatically.
+ *
+ * @internal
  */
-function getSchemaInfo() {
-    return {
-        tableNames: schema_introspection_1.SchemaIntrospection.getAllTableNames(),
-        tableCount: schema_introspection_1.SchemaIntrospection.getTableCount(),
-        seedDataTables: Object.keys(seeds_1.DatabaseSeeds['seedData'] || {}),
-    };
+function initializeDatabase(schemaData) {
+    const tableNames = Object.keys(schemaData.tables);
+    logger_1.logger.info(`Initializing with ${tableNames.length} tables: ${tableNames.join(', ')}`);
+    schema_introspection_1.SchemaIntrospection.initialize({
+        tables: schemaData.tables,
+        tableNames,
+    });
+    migrations_1.DatabaseMigrations.initialize({
+        tables: schemaData.tables,
+        tableNames,
+        migrationConfig: { ...DEFAULT_MIGRATION_CONFIG, ...schemaData.migrationConfig },
+    });
+    seeds_1.DatabaseSeeds.initialize({
+        tables: schemaData.tables,
+        tableNames,
+        seedData: (schemaData.seedData ?? {}),
+    });
+    logger_1.logger.info('Database initialized');
 }
 //# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../init.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAuBH,gDAwCC;AAKD,sCAUC;AA5ED,uEAAmE;AACnE,yCAA8C;AAC9C,mDAAwD;AACxD,2CAAwC;AAcxC;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,UAAsB;IACvD,IAAI,CAAC;QACH,eAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAEjE,4CAA4C;QAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAElD,kCAAkC;QAClC,0CAAmB,CAAC,UAAU,CAAC;YAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,UAAU,EAAE,UAAU;SACvB,CAAC,CAAC;QAEH,iCAAiC;QACjC,+BAAkB,CAAC,UAAU,CAAC;YAC5B,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,UAAU,EAAE,UAAU;YACtB,eAAe,EAAE;gBACf,YAAY,EAAE,IAAI,EAAE,kCAAkC;gBACtD,WAAW,EAAE,IAAI,EAAG,4BAA4B;gBAChD,UAAU,EAAE,KAAK,EAAG,iCAAiC;gBACrD,GAAG,UAAU,CAAC,eAAe,EAAE,oCAAoC;aACpE;SACF,CAAC,CAAC;QAEH,4BAA4B;QAC5B,qBAAa,CAAC,UAAU,CAAC;YACvB,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,UAAU,EAAE,UAAU;YACtB,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,EAAE;SACpC,CAAC,CAAC;QAEH,eAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC1D,eAAM,CAAC,IAAI,CAAC,UAAU,UAAU,CAAC,MAAM,YAAY,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5E,eAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC;IAE9F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;QAC9D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa;IAK3B,OAAO;QACL,UAAU,EAAE,0CAAmB,CAAC,gBAAgB,EAAE;QAClD,UAAU,EAAE,0CAAmB,CAAC,aAAa,EAAE;QAC/C,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,qBAAa,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../init.ts"],"names":[],"mappings":"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"}

package/dist/jest.setup.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Jest setup file to mock native dependencies
+ */
+//# sourceMappingURL=jest.setup.d.ts.map

package/dist/jest.setup.d.ts.map

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

package/dist/jest.setup.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Jest setup file to mock native dependencies
+ */
+// Mock @libsql/client to avoid loading native modules in tests
+jest.mock('@libsql/client', () => {
+    const mockClient = {
+        execute: jest.fn(),
+        batch: jest.fn(),
+        transaction: jest.fn(),
+        close: jest.fn(),
+    };
+    return {
+        createClient: jest.fn(() => mockClient),
+    };
+});
+// Mock drizzle-orm/libsql to avoid native module issues
+jest.mock('drizzle-orm/libsql', () => {
+    const mockDb = {
+        select: jest.fn(() => ({
+            from: jest.fn(() => Promise.resolve([])),
+        })),
+        insert: jest.fn(() => ({
+            values: jest.fn(() => Promise.resolve({})),
+        })),
+        update: jest.fn(() => ({
+            set: jest.fn(() => ({
+                where: jest.fn(() => Promise.resolve({})),
+            })),
+        })),
+        delete: jest.fn(() => ({
+            where: jest.fn(() => Promise.resolve({})),
+        })),
+        run: jest.fn(() => Promise.resolve({})),
+    };
+    return {
+        drizzle: jest.fn(() => mockDb),
+    };
+});
+//# sourceMappingURL=jest.setup.js.map

package/dist/jest.setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.setup.js","sourceRoot":"","sources":["../jest.setup.ts"],"names":[],"mappings":";AAAA;;GAEG;AAEH,+DAA+D;AAC/D,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC/B,MAAM,UAAU,GAAG;QACjB,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;QAClB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;QAChB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;QACtB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;KACjB,CAAC;IAEF,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC;KACxC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,wDAAwD;AACxD,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YACrB,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;SACzC,CAAC,CAAC;QACH,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YACrB,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;SAC3C,CAAC,CAAC;QACH,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YACrB,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;gBAClB,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;aAC1C,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YACrB,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;SAC1C,CAAC,CAAC;QACH,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;KACxC,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;KAC/B,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/types/errors.d.ts

@@ -1,23 +1,41 @@
 /**
- * Custom database error types for better error handling
+ * Custom error types for database operations
  */
+interface ErrorOptions {
+    table?: string | undefined;
+    detail?: string | undefined;
+    cause?: Error | undefined;
+}
 export declare class DatabaseError extends Error {
     readonly operation: string;
-    readonly originalError?: Error | undefined;
-    constructor(message: string, operation: string, originalError?: Error | undefined);
+    readonly table: string | undefined;
+    readonly detail: string | undefined;
+    readonly originalError: Error | undefined;
+    constructor(message: string, operation: string, options?: ErrorOptions);
+    /** Format error for display */
+    format(): string;
+    /** Override toString for cleaner console output */
+    toString(): string;
 }
 export declare class SchemaError extends DatabaseError {
-    readonly tableName?: string | undefined;
-    constructor(message: string, tableName?: string | undefined, originalError?: Error);
-}
-export declare class SyncError extends DatabaseError {
-    constructor(message: string, originalError?: Error);
+    constructor(message: string, table?: string, detail?: string);
 }
 export declare class ConnectionError extends DatabaseError {
-    constructor(message: string, originalError?: Error);
+    constructor(message: string, detail?: string);
+}
+export declare class MigrationError extends DatabaseError {
+    constructor(message: string, table?: string, detail?: string);
 }
-export declare class ValidationError extends DatabaseError {
-    readonly field?: string | undefined;
-    constructor(message: string, field?: string | undefined, originalError?: Error);
+export declare class SeedError extends DatabaseError {
+    constructor(message: string, table?: string, detail?: string);
 }
+interface ParseContext {
+    table?: string | undefined;
+    operation?: string | undefined;
+}
+/**
+ * Parse internal database errors into user-friendly messages
+ */
+export declare function parseDbError(error: unknown, context?: ParseContext): DatabaseError;
+export {};
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,aAAc,SAAQ,KAAK;aACO,SAAS,EAAE,MAAM;aAAkB,aAAa,CAAC,EAAE,KAAK;gBAAzF,OAAO,EAAE,MAAM,EAAkB,SAAS,EAAE,MAAM,EAAkB,aAAa,CAAC,EAAE,KAAK,YAAA;CAItG;AAED,qBAAa,WAAY,SAAQ,aAAa;aACC,SAAS,CAAC,EAAE,MAAM;gBAAnD,OAAO,EAAE,MAAM,EAAkB,SAAS,CAAC,EAAE,MAAM,YAAA,EAAE,aAAa,CAAC,EAAE,KAAK;CAIvF;AAED,qBAAa,SAAU,SAAQ,aAAa;gBAC9B,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK;CAInD;AAED,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK;CAInD;AAED,qBAAa,eAAgB,SAAQ,aAAa;aACH,KAAK,CAAC,EAAE,MAAM;gBAA/C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,MAAM,YAAA,EAAE,aAAa,CAAC,EAAE,KAAK;CAInF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CAC3B;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,KAAK,GAAG,SAAS,CAAC;gBAE9B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAStE,+BAA+B;IAC/B,MAAM,IAAI,MAAM;IAiBhB,mDAAmD;IACnD,QAAQ,IAAI,MAAM;CAGnB;AAED,qBAAa,WAAY,SAAQ,aAAa;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAI7D;AAED,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAI7C;AAED,qBAAa,cAAe,SAAQ,aAAa;gBACnC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAI7D;AAED,qBAAa,SAAU,SAAQ,aAAa;gBAC9B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAI7D;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AA4BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,aAAa,CA6ClF"}

package/dist/types/errors.js

@@ -1,46 +1,121 @@
 "use strict";
 /**
- * Custom database error types for better error handling
+ * Custom error types for database operations
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidationError = exports.ConnectionError = exports.SyncError = exports.SchemaError = exports.DatabaseError = void 0;
+exports.SeedError = exports.MigrationError = exports.ConnectionError = exports.SchemaError = exports.DatabaseError = void 0;
+exports.parseDbError = parseDbError;
 class DatabaseError extends Error {
-    constructor(message, operation, originalError) {
+    constructor(message, operation, options) {
         super(message);
-        this.operation = operation;
-        this.originalError = originalError;
         this.name = 'DatabaseError';
+        this.operation = operation;
+        this.table = options?.table;
+        this.detail = options?.detail;
+        this.originalError = options?.cause;
+    }
+    /** Format error for display */
+    format() {
+        const lines = [
+            '',
+            `┌─ nanodb-orm error ─────────────────────────────`,
+            `│ ${this.message}`,
+        ];
+        if (this.table)
+            lines.push(`│ Table: ${this.table}`);
+        if (this.operation)
+            lines.push(`│ Operation: ${this.operation}`);
+        if (this.detail)
+            lines.push(`│ Detail: ${this.detail}`);
+        lines.push(`└────────────────────────────────────────────────`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    /** Override toString for cleaner console output */
+    toString() {
+        return this.format();
     }
 }
 exports.DatabaseError = DatabaseError;
 class SchemaError extends DatabaseError {
-    constructor(message, tableName, originalError) {
-        super(message, 'schema', originalError);
-        this.tableName = tableName;
+    constructor(message, table, detail) {
+        super(message, 'schema', { table, detail });
         this.name = 'SchemaError';
     }
 }
 exports.SchemaError = SchemaError;
-class SyncError extends DatabaseError {
-    constructor(message, originalError) {
-        super(message, 'sync', originalError);
-        this.name = 'SyncError';
-    }
-}
-exports.SyncError = SyncError;
 class ConnectionError extends DatabaseError {
-    constructor(message, originalError) {
-        super(message, 'connection', originalError);
+    constructor(message, detail) {
+        super(message, 'connection', { detail });
         this.name = 'ConnectionError';
     }
 }
 exports.ConnectionError = ConnectionError;
-class ValidationError extends DatabaseError {
-    constructor(message, field, originalError) {
-        super(message, 'validation', originalError);
-        this.field = field;
-        this.name = 'ValidationError';
+class MigrationError extends DatabaseError {
+    constructor(message, table, detail) {
+        super(message, 'migration', { table, detail });
+        this.name = 'MigrationError';
+    }
+}
+exports.MigrationError = MigrationError;
+class SeedError extends DatabaseError {
+    constructor(message, table, detail) {
+        super(message, 'seed', { table, detail });
+        this.name = 'SeedError';
+    }
+}
+exports.SeedError = SeedError;
+/**
+ * Extract the root error message, traversing the cause chain
+ */
+function getRootMessage(error) {
+    if (!(error instanceof Error))
+        return String(error);
+    // Check for nested cause (drizzle wraps libsql errors)
+    let current = error;
+    let deepestMessage = error.message;
+    while (current instanceof Error) {
+        deepestMessage = current.message;
+        // Check various cause patterns
+        const err = current;
+        if (err.cause) {
+            current = err.cause;
+        }
+        else if (err.originalError) {
+            current = err.originalError;
+        }
+        else {
+            break;
+        }
+    }
+    return deepestMessage;
+}
+/**
+ * Parse internal database errors into user-friendly messages
+ */
+function parseDbError(error, context) {
+    const rootMsg = getRootMessage(error);
+    const op = context?.operation ?? 'query';
+    const tbl = context?.table;
+    // SQLite constraint errors
+    if (rootMsg.includes('SQLITE_CONSTRAINT_NOTNULL')) {
+        const match = rootMsg.match(/NOT NULL constraint failed: (\w+)\.(\w+)/);
+        const col = match ? match[2] : 'unknown column';
+        return new DatabaseError(`Missing required value for column "${col}"`, op, { table: tbl, detail: 'This column is NOT NULL but no value was provided' });
+    }
+    if (rootMsg.includes('SQLITE_CONSTRAINT_UNIQUE')) {
+        return new DatabaseError('Duplicate value for unique column', op, { table: tbl, detail: 'A record with this value already exists' });
+    }
+    if (rootMsg.includes('no column named')) {
+        const col = rootMsg.match(/no column named (\w+)/)?.[1] ?? 'unknown';
+        return new DatabaseError(`Column "${col}" does not exist`, op, { table: tbl, detail: 'Your seed data has a column that is not in the table schema' });
+    }
+    if (rootMsg.includes('no such table')) {
+        const tableName = rootMsg.match(/no such table: (\w+)/)?.[1] ?? tbl ?? 'unknown';
+        return new DatabaseError(`Table "${tableName}" does not exist`, op, { table: tableName, detail: 'Run DatabaseSync.setup() to create tables' });
     }
+    // Generic fallback - first line only, clean up
+    const cleanMsg = rootMsg.split('\n')[0]?.replace(/^SQLITE_\w+:\s*/, '') ?? rootMsg;
+    return new DatabaseError(cleanMsg, op, { table: tbl });
 }
-exports.ValidationError = ValidationError;
 //# sourceMappingURL=errors.js.map