nanodb-orm 0.0.3 → 0.0.4

package/dist/core/connection.js

@@ -1,109 +1,59 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.db = exports.DatabaseConnection = void 0;
+exports.DatabaseConnection = void 0;
 const libsql_1 = require("drizzle-orm/libsql");
 const client_1 = require("@libsql/client");
 const config_1 = require("./config");
-const errors_1 = require("../types/errors");
 /**
- * Database connection management
- * Handles the creation and configuration of database connections
+ * Thread-safe singleton database connection manager.
+ * Supports both Turso (remote) and local SQLite databases.
  */
 class DatabaseConnection {
-    /**
-     * Get or create the database connection instance (thread-safe)
-     */
+    /** Get the database connection instance (creates if needed) */
     static async getInstance() {
-        if (this.instance) {
+        if (this.instance)
             return this.instance;
-        }
-        if (this.isCreating && this.creationPromise) {
-            return this.creationPromise;
-        }
-        this.isCreating = true;
-        this.creationPromise = this.createConnectionAsync();
+        if (this.pending)
+            return this.pending;
+        this.pending = this.createConnection();
         try {
-            this.instance = await this.creationPromise;
+            this.instance = await this.pending;
             return this.instance;
         }
         finally {
-            this.isCreating = false;
-            this.creationPromise = null;
+            this.pending = null;
         }
     }
-    /**
-     * Synchronous getter for backward compatibility (deprecated)
-     * @deprecated Use getInstance() instead for thread safety
-     */
-    static getInstanceSync() {
-        if (!this.instance) {
-            this.instance = this.createConnection();
+    /** Create a new database connection */
+    static async createConnection() {
+        // Test environment: use isolated local database
+        if (process.env.NODE_ENV === 'test' || process.env.FORCE_LOCAL_DB === 'true') {
+            const dbName = process.env.JEST_WORKER_ID ? `test-${process.env.JEST_WORKER_ID}.db` : 'test.db';
+            return (0, libsql_1.drizzle)((0, client_1.createClient)({ url: `file:${dbName}` }));
         }
-        return this.instance;
-    }
-    /**
-     * Create a new database connection asynchronously
-     */
-    static async createConnectionAsync() {
-        return this.createConnection();
-    }
-    /**
-     * Create a new database connection
-     */
-    static createConnection() {
+        // Production: try Turso first, fallback to local SQLite
         try {
-            // For testing, force local SQLite database to avoid remote schema conflicts
-            if (process.env.NODE_ENV === 'test' || process.env.FORCE_LOCAL_DB === 'true') {
-                // Use unique database file for each test to avoid locking issues
-                const testDbName = process.env.JEST_WORKER_ID ? `test-${process.env.JEST_WORKER_ID}.db` : 'test.db';
-                console.log(`Using local SQLite database for testing: ${testDbName}`);
-                const client = (0, client_1.createClient)({
-                    url: `file:${testDbName}`,
-                });
-                return (0, libsql_1.drizzle)(client);
-            }
-            // Try to get Turso config first, fallback to local SQLite if not available
-            try {
-                const config = (0, config_1.getDatabaseConfig)();
-                const client = (0, client_1.createClient)({
-                    url: config.connectionUrl,
-                    authToken: config.authToken,
-                });
-                console.log('Connected to Turso database');
-                return (0, libsql_1.drizzle)(client);
-            }
-            catch (configError) {
-                // Fallback to local SQLite database
-                console.log('Turso config not found, using local SQLite database');
-                const client = (0, client_1.createClient)({
-                    url: 'file:database.db',
-                });
-                return (0, libsql_1.drizzle)(client);
-            }
+            const config = (0, config_1.getDatabaseConfig)();
+            return (0, libsql_1.drizzle)((0, client_1.createClient)({
+                url: config.connectionUrl,
+                authToken: config.authToken,
+            }));
         }
-        catch (error) {
-            throw new errors_1.DatabaseError(`Failed to create database connection: ${error.message}`, 'connection', error);
+        catch {
+            return (0, libsql_1.drizzle)((0, client_1.createClient)({ url: 'file:database.db' }));
         }
     }
-    /**
-     * Reset the connection instance (useful for testing)
-     */
+    /** Reset the connection (for testing) */
     static reset() {
         this.instance = null;
-        this.isCreating = false;
-        this.creationPromise = null;
+        this.pending = null;
     }
-    /**
-     * Check if connection is established
-     */
+    /** Check if a connection exists */
     static isConnected() {
         return this.instance !== null;
     }
 }
 exports.DatabaseConnection = DatabaseConnection;
 DatabaseConnection.instance = null;
-DatabaseConnection.isCreating = false;
-DatabaseConnection.creationPromise = null;
-// Export the database instance for convenience (deprecated - use getInstance() instead)
-exports.db = DatabaseConnection.getInstanceSync();
+DatabaseConnection.pending = null;
 //# sourceMappingURL=connection.js.map

package/dist/core/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../core/connection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../core/connection.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAC7C,2CAA8C;AAC9C,qCAA6C;AAK7C;;;GAGG;AACH,MAAa,kBAAkB;IAI7B,+DAA+D;IAC/D,MAAM,CAAC,KAAK,CAAC,WAAW;QACtB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACxC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;QAEtC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YACnC,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,uCAAuC;IAC/B,MAAM,CAAC,KAAK,CAAC,gBAAgB;QACnC,gDAAgD;QAChD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;YAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YAChG,OAAO,IAAA,gBAAO,EAAC,IAAA,qBAAY,EAAC,EAAE,GAAG,EAAE,QAAQ,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,wDAAwD;QACxD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,0BAAiB,GAAE,CAAC;YACnC,OAAO,IAAA,gBAAO,EAAC,IAAA,qBAAY,EAAC;gBAC1B,GAAG,EAAE,MAAM,CAAC,aAAa;gBACzB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAA,gBAAO,EAAC,IAAA,qBAAY,EAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,MAAM,CAAC,KAAK;QACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,mCAAmC;IACnC,MAAM,CAAC,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;IAChC,CAAC;;AAhDH,gDAiDC;AAhDgB,2BAAQ,GAA2B,IAAI,CAAC;AACxC,0BAAO,GAAoC,IAAI,CAAC"}

package/dist/core/index.d.ts

@@ -1,7 +1,6 @@
 /**
  * Core database functionality
- * Essential database components: connection, schema, and configuration
  */
-export { db, DatabaseConnection } from './connection';
-export * from './config';
+export { DatabaseConnection } from './connection';
+export { getDatabaseConfig } from './config';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,EAAE,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACtD,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/core/index.js

@@ -1,26 +1,11 @@
 "use strict";
 /**
  * Core database functionality
- * Essential database components: connection, schema, and configuration
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DatabaseConnection = exports.db = void 0;
+exports.getDatabaseConfig = exports.DatabaseConnection = void 0;
 var connection_1 = require("./connection");
-Object.defineProperty(exports, "db", { enumerable: true, get: function () { return connection_1.db; } });
 Object.defineProperty(exports, "DatabaseConnection", { enumerable: true, get: function () { return connection_1.DatabaseConnection; } });
-__exportStar(require("./config"), exports);
+var config_1 = require("./config");
+Object.defineProperty(exports, "getDatabaseConfig", { enumerable: true, get: function () { return config_1.getDatabaseConfig; } });
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,2CAAsD;AAA7C,gGAAA,EAAE,OAAA;AAAE,gHAAA,kBAAkB,OAAA;AAC/B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2CAAkD;AAAzC,gHAAA,kBAAkB,OAAA;AAC3B,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA"}

package/dist/index.d.ts

@@ -1,14 +1,44 @@
 /**
- * Database module exports
- * Main entry point for all database-related functionality
+ * nanodb-orm - A lightweight ORM wrapper for Drizzle + SQLite/Turso
  *
- * @fileoverview Organized database module with proper separation of concerns
- * @version 2.0.0
- * @author Database Team
+ * @example
+ * ```ts
+ * import { createDatabase, table, integer, text, eq } from 'nanodb-orm';
+ *
+ * const users = table('users', {
+ *   id: integer('id').primaryKey({ autoIncrement: true }),
+ *   name: text('name').notNull(),
+ * });
+ *
+ * const db = await createDatabase({ tables: { users } });
+ * const allUsers = await db.select().from(users);
+ * ```
  */
-export * from './core';
-export * from './utils';
-export * from './init';
-export { DatabaseError, SchemaError, SyncError, ConnectionError, ValidationError } from './types/errors';
-export * from './constants';
+export { createDatabase, initializeDatabase } from './init';
+export type { CreateDatabaseConfig } from './init';
+export type { NanoPlugin, HookFn, ErrorHookFn, LifecycleHookFn, SchemaData, MigrationConfig, DrizzleTable, DrizzleColumn, DatabaseClient, DatabaseConfig, DatabaseInfo, HealthCheck, SyncResult, SchemaValidation, ForeignKey, TableMetadata, QueryResult, } from './types';
+export { DatabaseError, SchemaError, ConnectionError, MigrationError, SeedError, parseDbError, } from './types/errors';
+export { DatabaseConnection } from './core/connection';
+export { getDatabaseConfig } from './core/config';
+export { DatabaseSync } from './utils/sync';
+export { DatabaseMigrations } from './utils/migrations';
+export { DatabaseSeeds } from './utils/seeds';
+export { SchemaIntrospection } from './utils/schema-introspection';
+export { transaction, recreateTable } from './utils/transactions';
+import { sqliteTable, integer as drizzleInteger, text as drizzleText, real as drizzleReal, blob as drizzleBlob } from 'drizzle-orm/sqlite-core';
+/** Define a SQLite table */
+export declare const table: import("drizzle-orm/sqlite-core").SQLiteTableFn<undefined>;
+export { sqliteTable };
+/** Column type builders */
+export declare const integer: typeof drizzleInteger;
+export declare const text: typeof drizzleText;
+export declare const real: typeof drizzleReal;
+export declare const blob: typeof drizzleBlob;
+export declare const column: {
+    integer: typeof drizzleInteger;
+    text: typeof drizzleText;
+    real: typeof drizzleReal;
+    blob: typeof drizzleBlob;
+};
+export { eq, ne, gt, gte, lt, lte, like, and, or, not, desc, asc, count, sql, } from 'drizzle-orm';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,QAAQ,CAAC;AAGvB,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGzG,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAMnD,YAAY,EAEV,UAAU,EACV,MAAM,EACN,WAAW,EACX,eAAe,EAGf,UAAU,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EAGb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,SAAS,EACT,YAAY,GACb,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMlE,OAAO,EACL,WAAW,EACX,OAAO,IAAI,cAAc,EACzB,IAAI,IAAI,WAAW,EACnB,IAAI,IAAI,WAAW,EACnB,IAAI,IAAI,WAAW,EACpB,MAAM,yBAAyB,CAAC;AAEjC,4BAA4B;AAC5B,eAAO,MAAM,KAAK,4DAAc,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,2BAA2B;AAC3B,eAAO,MAAM,OAAO,uBAAiB,CAAC;AACtC,eAAO,MAAM,IAAI,oBAAc,CAAC;AAChC,eAAO,MAAM,IAAI,oBAAc,CAAC;AAChC,eAAO,MAAM,IAAI,oBAAc,CAAC;AAGhC,eAAO,MAAM,MAAM;;;;;CAAuF,CAAC;AAM3G,OAAO,EACL,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAC9B,GAAG,EAAE,EAAE,EAAE,GAAG,EACZ,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,GAAG,GACX,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,41 +1,86 @@
 "use strict";
 /**
- * Database module exports
- * Main entry point for all database-related functionality
+ * nanodb-orm - A lightweight ORM wrapper for Drizzle + SQLite/Turso
  *
- * @fileoverview Organized database module with proper separation of concerns
- * @version 2.0.0
- * @author Database Team
+ * @example
+ * ```ts
+ * import { createDatabase, table, integer, text, eq } from 'nanodb-orm';
+ *
+ * const users = table('users', {
+ *   id: integer('id').primaryKey({ autoIncrement: true }),
+ *   name: text('name').notNull(),
+ * });
+ *
+ * const db = await createDatabase({ tables: { users } });
+ * const allUsers = await db.select().from(users);
+ * ```
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidationError = exports.ConnectionError = exports.SyncError = exports.SchemaError = exports.DatabaseError = void 0;
-// Core database functionality
-__exportStar(require("./core"), exports);
-// Database utilities and services
-__exportStar(require("./utils"), exports);
-// Database initialization for npm package usage
-__exportStar(require("./init"), exports);
-// Explicit error exports for better IDE support
+exports.sql = exports.count = exports.asc = exports.desc = exports.not = exports.or = exports.and = exports.like = exports.lte = exports.lt = exports.gte = exports.gt = exports.ne = exports.eq = exports.column = exports.blob = exports.real = exports.text = exports.integer = exports.sqliteTable = exports.table = exports.recreateTable = exports.transaction = exports.SchemaIntrospection = exports.DatabaseSeeds = exports.DatabaseMigrations = exports.DatabaseSync = exports.getDatabaseConfig = exports.DatabaseConnection = exports.parseDbError = exports.SeedError = exports.MigrationError = exports.ConnectionError = exports.SchemaError = exports.DatabaseError = exports.initializeDatabase = exports.createDatabase = void 0;
+// -----------------------------------------------------------------------------
+// Main API
+// -----------------------------------------------------------------------------
+var init_1 = require("./init");
+Object.defineProperty(exports, "createDatabase", { enumerable: true, get: function () { return init_1.createDatabase; } });
+Object.defineProperty(exports, "initializeDatabase", { enumerable: true, get: function () { return init_1.initializeDatabase; } });
+// -----------------------------------------------------------------------------
+// Errors
+// -----------------------------------------------------------------------------
 var errors_1 = require("./types/errors");
 Object.defineProperty(exports, "DatabaseError", { enumerable: true, get: function () { return errors_1.DatabaseError; } });
 Object.defineProperty(exports, "SchemaError", { enumerable: true, get: function () { return errors_1.SchemaError; } });
-Object.defineProperty(exports, "SyncError", { enumerable: true, get: function () { return errors_1.SyncError; } });
 Object.defineProperty(exports, "ConnectionError", { enumerable: true, get: function () { return errors_1.ConnectionError; } });
-Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
-// Constants and configuration values
-__exportStar(require("./constants"), exports);
+Object.defineProperty(exports, "MigrationError", { enumerable: true, get: function () { return errors_1.MigrationError; } });
+Object.defineProperty(exports, "SeedError", { enumerable: true, get: function () { return errors_1.SeedError; } });
+Object.defineProperty(exports, "parseDbError", { enumerable: true, get: function () { return errors_1.parseDbError; } });
+// -----------------------------------------------------------------------------
+// Utilities (for advanced use)
+// -----------------------------------------------------------------------------
+var connection_1 = require("./core/connection");
+Object.defineProperty(exports, "DatabaseConnection", { enumerable: true, get: function () { return connection_1.DatabaseConnection; } });
+var config_1 = require("./core/config");
+Object.defineProperty(exports, "getDatabaseConfig", { enumerable: true, get: function () { return config_1.getDatabaseConfig; } });
+var sync_1 = require("./utils/sync");
+Object.defineProperty(exports, "DatabaseSync", { enumerable: true, get: function () { return sync_1.DatabaseSync; } });
+var migrations_1 = require("./utils/migrations");
+Object.defineProperty(exports, "DatabaseMigrations", { enumerable: true, get: function () { return migrations_1.DatabaseMigrations; } });
+var seeds_1 = require("./utils/seeds");
+Object.defineProperty(exports, "DatabaseSeeds", { enumerable: true, get: function () { return seeds_1.DatabaseSeeds; } });
+var schema_introspection_1 = require("./utils/schema-introspection");
+Object.defineProperty(exports, "SchemaIntrospection", { enumerable: true, get: function () { return schema_introspection_1.SchemaIntrospection; } });
+var transactions_1 = require("./utils/transactions");
+Object.defineProperty(exports, "transaction", { enumerable: true, get: function () { return transactions_1.transaction; } });
+Object.defineProperty(exports, "recreateTable", { enumerable: true, get: function () { return transactions_1.recreateTable; } });
+// -----------------------------------------------------------------------------
+// Drizzle Re-exports (Schema Building)
+// -----------------------------------------------------------------------------
+const sqlite_core_1 = require("drizzle-orm/sqlite-core");
+Object.defineProperty(exports, "sqliteTable", { enumerable: true, get: function () { return sqlite_core_1.sqliteTable; } });
+/** Define a SQLite table */
+exports.table = sqlite_core_1.sqliteTable;
+/** Column type builders */
+exports.integer = sqlite_core_1.integer;
+exports.text = sqlite_core_1.text;
+exports.real = sqlite_core_1.real;
+exports.blob = sqlite_core_1.blob;
+// Grouped column export for convenience
+exports.column = { integer: sqlite_core_1.integer, text: sqlite_core_1.text, real: sqlite_core_1.real, blob: sqlite_core_1.blob };
+// -----------------------------------------------------------------------------
+// Drizzle Re-exports (Query Operators)
+// -----------------------------------------------------------------------------
+var drizzle_orm_1 = require("drizzle-orm");
+Object.defineProperty(exports, "eq", { enumerable: true, get: function () { return drizzle_orm_1.eq; } });
+Object.defineProperty(exports, "ne", { enumerable: true, get: function () { return drizzle_orm_1.ne; } });
+Object.defineProperty(exports, "gt", { enumerable: true, get: function () { return drizzle_orm_1.gt; } });
+Object.defineProperty(exports, "gte", { enumerable: true, get: function () { return drizzle_orm_1.gte; } });
+Object.defineProperty(exports, "lt", { enumerable: true, get: function () { return drizzle_orm_1.lt; } });
+Object.defineProperty(exports, "lte", { enumerable: true, get: function () { return drizzle_orm_1.lte; } });
+Object.defineProperty(exports, "like", { enumerable: true, get: function () { return drizzle_orm_1.like; } });
+Object.defineProperty(exports, "and", { enumerable: true, get: function () { return drizzle_orm_1.and; } });
+Object.defineProperty(exports, "or", { enumerable: true, get: function () { return drizzle_orm_1.or; } });
+Object.defineProperty(exports, "not", { enumerable: true, get: function () { return drizzle_orm_1.not; } });
+Object.defineProperty(exports, "desc", { enumerable: true, get: function () { return drizzle_orm_1.desc; } });
+Object.defineProperty(exports, "asc", { enumerable: true, get: function () { return drizzle_orm_1.asc; } });
+Object.defineProperty(exports, "count", { enumerable: true, get: function () { return drizzle_orm_1.count; } });
+Object.defineProperty(exports, "sql", { enumerable: true, get: function () { return drizzle_orm_1.sql; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;AAEH,8BAA8B;AAC9B,yCAAuB;AAEvB,kCAAkC;AAClC,0CAAwB;AAExB,gDAAgD;AAChD,yCAAuB;AAEvB,gDAAgD;AAChD,yCAAyG;AAAhG,uGAAA,aAAa,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AAEhF,qCAAqC;AACrC,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,+BAA4D;AAAnD,sGAAA,cAAc,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AAgC3C,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,yCAOwB;AANtB,uGAAA,aAAa,OAAA;AACb,qGAAA,WAAW,OAAA;AACX,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,mGAAA,SAAS,OAAA;AACT,sGAAA,YAAY,OAAA;AAGd,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF,gDAAuD;AAA9C,gHAAA,kBAAkB,OAAA;AAC3B,wCAAkD;AAAzC,2GAAA,iBAAiB,OAAA;AAC1B,qCAA4C;AAAnC,oGAAA,YAAY,OAAA;AACrB,iDAAwD;AAA/C,gHAAA,kBAAkB,OAAA;AAC3B,uCAA8C;AAArC,sGAAA,aAAa,OAAA;AACtB,qEAAmE;AAA1D,2HAAA,mBAAmB,OAAA;AAC5B,qDAAkE;AAAzD,2GAAA,WAAW,OAAA;AAAE,6GAAA,aAAa,OAAA;AAEnC,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAEhF,yDAMiC;AAIxB,4FATP,yBAAW,OASO;AAFpB,4BAA4B;AACf,QAAA,KAAK,GAAG,yBAAW,CAAC;AAGjC,2BAA2B;AACd,QAAA,OAAO,GAAG,qBAAc,CAAC;AACzB,QAAA,IAAI,GAAG,kBAAW,CAAC;AACnB,QAAA,IAAI,GAAG,kBAAW,CAAC;AACnB,QAAA,IAAI,GAAG,kBAAW,CAAC;AAEhC,wCAAwC;AAC3B,QAAA,MAAM,GAAG,EAAE,OAAO,EAAE,qBAAc,EAAE,IAAI,EAAE,kBAAW,EAAE,IAAI,EAAE,kBAAW,EAAE,IAAI,EAAE,kBAAW,EAAE,CAAC;AAE3G,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAEhF,2CAKqB;AAJnB,iGAAA,EAAE,OAAA;AAAE,iGAAA,EAAE,OAAA;AAAE,iGAAA,EAAE,OAAA;AAAE,kGAAA,GAAG,OAAA;AAAE,iGAAA,EAAE,OAAA;AAAE,kGAAA,GAAG,OAAA;AAAE,mGAAA,IAAI,OAAA;AAC9B,kGAAA,GAAG,OAAA;AAAE,iGAAA,EAAE,OAAA;AAAE,kGAAA,GAAG,OAAA;AACZ,mGAAA,IAAI,OAAA;AAAE,kGAAA,GAAG,OAAA;AACT,oGAAA,KAAK,OAAA;AAAE,kGAAA,GAAG,OAAA"}

package/dist/init.d.ts

@@ -1,28 +1,85 @@
-/**
- * Database initialization utility
- * Initializes the db package with schema data to work as an npm package
- */
-export interface MigrationConfig {
-    preserveData?: boolean;
-    autoMigrate?: boolean;
-    dropTables?: boolean;
-}
-export interface SchemaData {
-    tables: Record<string, any>;
-    seedData?: Record<string, any[]>;
-    migrationConfig?: MigrationConfig;
+import type { SchemaData, MigrationConfig, NanoPlugin } from './types';
+export type { SchemaData, MigrationConfig, NanoPlugin };
+/** Configuration for createDatabase() */
+export interface CreateDatabaseConfig extends SchemaData {
+    /** Plugins to extend database functionality */
+    plugins?: NanoPlugin[];
 }
+declare const HOOK_TYPES: readonly ["beforeInsert", "afterInsert", "beforeUpdate", "afterUpdate", "beforeDelete", "afterDelete", "beforeQuery", "afterQuery"];
+type HookType = typeof HOOK_TYPES[number];
 /**
- * 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.
+ *
+ * @example
+ * ```ts
+ * const db = await createDatabase({
+ *   tables: { users, posts },
+ *   seedData: { users: [{ name: 'Alice' }] },
+ *   plugins: [auditPlugin],
+ * });
+ * ```
  */
-export declare function initializeDatabase(schemaData: SchemaData): void;
+export declare function createDatabase(config: CreateDatabaseConfig): Promise<import("drizzle-orm/libsql").LibSQLDatabase<Record<string, unknown>> & {
+    $client: import("@libsql/core/api").Client;
+} & {
+    select: {
+        (): import("drizzle-orm/sqlite-core").SQLiteSelectBuilder<undefined, "async", import("@libsql/core/api").ResultSet, "db">;
+        <TSelection extends import("drizzle-orm/sqlite-core").SelectedFields>(fields: TSelection): import("drizzle-orm/sqlite-core").SQLiteSelectBuilder<TSelection, "async", import("@libsql/core/api").ResultSet, "db">;
+    };
+    insert: (table: any) => import("drizzle-orm/sqlite-core").SQLiteInsertBuilder<any, "async", import("@libsql/core/api").ResultSet>;
+    update: (table: any) => import("drizzle-orm/sqlite-core").SQLiteUpdateBuilder<any, "async", import("@libsql/core/api").ResultSet>;
+    delete: (table: any) => any;
+    healthCheck: () => Promise<import("./types").HealthCheck>;
+    isReady: () => Promise<boolean>;
+    sync: () => Promise<import("./types").SyncResult>;
+    reset: () => Promise<void>;
+    seed: () => Promise<void>;
+    clearData: () => Promise<void>;
+    schema: {
+        tables: () => string[];
+        getTable: (name: string) => import("./types").TableMetadata;
+        getColumns: (name: string) => string[];
+        validate: () => Promise<import("./types").SchemaValidation>;
+        stats: () => {
+            totalTables: number;
+            tableNames: string[];
+            tableDetails: import("./types").TableMetadata[];
+        };
+        relationships: () => {
+            fromTable: string;
+            fromColumn: string;
+            toTable: string;
+            toColumn: string;
+        }[];
+    };
+    migrations: {
+        run: () => Promise<void>;
+        validate: () => Promise<import("./types").SchemaValidation>;
+        checkTables: () => Promise<Record<string, boolean>>;
+    };
+    plugins: {
+        list: () => string[];
+    };
+    hooks: {
+        beforeInsert: (t: string, d: any) => any;
+        afterInsert: (t: string, d: any, r: any) => any;
+        beforeUpdate: (t: string, d: any) => any;
+        afterUpdate: (t: string, d: any, r: any) => any;
+        beforeDelete: (t: string, d: any) => any;
+        afterDelete: (t: string, d: any, r: any) => any;
+        beforeQuery: (t: string, d: any) => any;
+        afterQuery: (t: string, d: any, r: any) => any;
+        onError: (e: Error, op: string, t?: string) => void;
+        onReady: (db: any) => void;
+        has: (type: HookType) => boolean;
+    };
+}>;
 /**
- * Get initialized schema data (for verification)
+ * Initialize internal modules with schema data.
+ * Prefer `createDatabase()` which calls this automatically.
+ *
+ * @internal
  */
-export declare function getSchemaInfo(): {
-    tableNames: string[];
-    tableCount: number;
-    seedDataTables: string[];
-};
+export declare function initializeDatabase(schemaData: SchemaData): void;
 //# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAwC/D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAMA"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../init.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAwC,MAAM,SAAS,CAAC;AAE7G,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;AAExD,yCAAyC;AACzC,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,+CAA+C;IAC/C,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAMD,QAAA,MAAM,UAAU,qIAKN,CAAC;AAEX,KAAK,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AA8D1C;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB;;;;;;;oBA8DjC,GAAG;oBAoBH,GAAG;oBAkBH,GAAG;;;;;;;;;yBAyBZ,MAAM;2BACJ,MAAM;;;;;;;;;;;;;;;;;;;;;;;0BApKT,MAAM,KAAK,GAAG;yBACf,MAAM,KAAK,GAAG,KAAK,GAAG;0BACrB,MAAM,KAAK,GAAG;yBACf,MAAM,KAAK,GAAG,KAAK,GAAG;0BACrB,MAAM,KAAK,GAAG;yBACf,MAAM,KAAK,GAAG,KAAK,GAAG;yBACtB,MAAM,KAAK,GAAG;wBACf,MAAM,KAAK,GAAG,KAAK,GAAG;qBACzB,KAAK,MAAM,MAAM,MAAM,MAAM;sBAC5B,GAAG;oBACL,QAAQ;;GAwLvB;AAaD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAuB/D"}