nanodb-orm 0.0.3 → 0.0.5

package/dist/index.js

@@ -1,41 +1,258 @@
 "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
+ * // Default import (recommended)
+ * import nanodb from 'nanodb-orm';
+ *
+ * const users = nanodb.schema.table('users', {
+ *   id: nanodb.schema.integer('id').primaryKey({ autoIncrement: true }),
+ *   name: nanodb.schema.text('name').notNull(),
+ * });
+ *
+ * const db = await nanodb.createDatabase({ tables: { users } });
+ * const adults = await db.select().from(users).where(nanodb.query.gte(users.age, 18));
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Named imports
+ * import { createDatabase, schema, query } from 'nanodb-orm';
+ * ```
  */
-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
-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);
+exports.isNotNull = exports.isNull = exports.notInArray = exports.inArray = exports.between = exports.not = exports.or = exports.and = exports.notLike = exports.ilike = 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.runValidate = exports.getStatus = exports.runReset = exports.runSetup = exports.launchStudio = exports.recreateTable = exports.batch = 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 = exports.cli = exports.errors = exports.query = exports.schema = void 0;
+exports.sql = exports.max = exports.min = exports.avg = exports.sum = exports.count = exports.asc = exports.desc = void 0;
+const sqlite_core_1 = require("drizzle-orm/sqlite-core");
+Object.defineProperty(exports, "sqliteTable", { enumerable: true, get: function () { return sqlite_core_1.sqliteTable; } });
+const drizzle_orm_1 = require("drizzle-orm");
+// =============================================================================
+// GROUPED EXPORTS (Recommended for cleaner imports)
+// =============================================================================
+/**
+ * Schema building utilities.
+ *
+ * @example
+ * ```ts
+ * import { schema } from 'nanodb-orm';
+ *
+ * const users = schema.table('users', {
+ *   id: schema.integer('id').primaryKey({ autoIncrement: true }),
+ *   name: schema.text('name').notNull(),
+ *   email: schema.text('email').unique(),
+ * });
+ * ```
+ */
+exports.schema = {
+    table: sqlite_core_1.sqliteTable,
+    integer: sqlite_core_1.integer,
+    text: sqlite_core_1.text,
+    real: sqlite_core_1.real,
+    blob: sqlite_core_1.blob,
+};
+/**
+ * Query operators for WHERE clauses and expressions.
+ *
+ * @example
+ * ```ts
+ * import { query } from 'nanodb-orm';
+ *
+ * await db.select().from(users).where(
+ *   query.and(
+ *     query.gte(users.age, 18),
+ *     query.like(users.name, 'A%')
+ *   )
+ * );
+ * ```
+ */
+exports.query = {
+    // Comparison
+    eq: drizzle_orm_1.eq,
+    ne: drizzle_orm_1.ne,
+    gt: drizzle_orm_1.gt,
+    gte: drizzle_orm_1.gte,
+    lt: drizzle_orm_1.lt,
+    lte: drizzle_orm_1.lte,
+    like: drizzle_orm_1.like,
+    ilike: drizzle_orm_1.ilike,
+    notLike: drizzle_orm_1.notLike,
+    // Logical
+    and: drizzle_orm_1.and,
+    or: drizzle_orm_1.or,
+    not: drizzle_orm_1.not,
+    // Range
+    between: drizzle_orm_1.between,
+    inArray: drizzle_orm_1.inArray,
+    notInArray: drizzle_orm_1.notInArray,
+    isNull: drizzle_orm_1.isNull,
+    isNotNull: drizzle_orm_1.isNotNull,
+    // Ordering
+    desc: drizzle_orm_1.desc,
+    asc: drizzle_orm_1.asc,
+    // Aggregates
+    count: drizzle_orm_1.count,
+    sum: drizzle_orm_1.sum,
+    avg: drizzle_orm_1.avg,
+    min: drizzle_orm_1.min,
+    max: drizzle_orm_1.max,
+    // Raw SQL
+    sql: drizzle_orm_1.sql,
+};
+/**
+ * Error classes and utilities.
+ *
+ * @example
+ * ```ts
+ * import { errors } from 'nanodb-orm';
+ *
+ * try {
+ *   await db.insert(users).values({ ... });
+ * } catch (e) {
+ *   if (e instanceof errors.DatabaseError) {
+ *     console.log(e.message, e.table);
+ *   }
+ *   const parsed = errors.parse(e, { table: 'users' });
+ * }
+ * ```
+ */
+const errors_1 = require("./types/errors");
+exports.errors = {
+    DatabaseError: errors_1.DatabaseError,
+    SchemaError: errors_1.SchemaError,
+    ConnectionError: errors_1.ConnectionError,
+    MigrationError: errors_1.MigrationError,
+    SeedError: errors_1.SeedError,
+    parse: errors_1.parseDbError,
+};
+/**
+ * CLI functions for programmatic access.
+ *
+ * @example
+ * ```ts
+ * import { cli } from 'nanodb-orm';
+ *
+ * await cli.setup();
+ * const status = await cli.status(true);
+ * await cli.studio({ port: 3000 });
+ * ```
+ */
+const cli_1 = require("./cli");
+exports.cli = {
+    studio: cli_1.launchStudio,
+    setup: cli_1.runSetup,
+    reset: cli_1.runReset,
+    status: cli_1.getStatus,
+    validate: cli_1.runValidate,
+};
+// =============================================================================
+// 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; } });
+// =============================================================================
+// INDIVIDUAL EXPORTS (for tree-shaking or preference)
+// =============================================================================
+// Errors (individual)
+var errors_2 = require("./types/errors");
+Object.defineProperty(exports, "DatabaseError", { enumerable: true, get: function () { return errors_2.DatabaseError; } });
+Object.defineProperty(exports, "SchemaError", { enumerable: true, get: function () { return errors_2.SchemaError; } });
+Object.defineProperty(exports, "ConnectionError", { enumerable: true, get: function () { return errors_2.ConnectionError; } });
+Object.defineProperty(exports, "MigrationError", { enumerable: true, get: function () { return errors_2.MigrationError; } });
+Object.defineProperty(exports, "SeedError", { enumerable: true, get: function () { return errors_2.SeedError; } });
+Object.defineProperty(exports, "parseDbError", { enumerable: true, get: function () { return errors_2.parseDbError; } });
+// Utilities
+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, "batch", { enumerable: true, get: function () { return transactions_1.batch; } });
+Object.defineProperty(exports, "recreateTable", { enumerable: true, get: function () { return transactions_1.recreateTable; } });
+// CLI (individual)
+var cli_2 = require("./cli");
+Object.defineProperty(exports, "launchStudio", { enumerable: true, get: function () { return cli_2.launchStudio; } });
+Object.defineProperty(exports, "runSetup", { enumerable: true, get: function () { return cli_2.runSetup; } });
+Object.defineProperty(exports, "runReset", { enumerable: true, get: function () { return cli_2.runReset; } });
+Object.defineProperty(exports, "getStatus", { enumerable: true, get: function () { return cli_2.getStatus; } });
+Object.defineProperty(exports, "runValidate", { enumerable: true, get: function () { return cli_2.runValidate; } });
+// Schema building (individual)
+exports.table = sqlite_core_1.sqliteTable;
+exports.integer = sqlite_core_1.integer;
+exports.text = sqlite_core_1.text;
+exports.real = sqlite_core_1.real;
+exports.blob = sqlite_core_1.blob;
+exports.column = exports.schema; // Alias
+// Query operators (individual)
+var drizzle_orm_2 = require("drizzle-orm");
+Object.defineProperty(exports, "eq", { enumerable: true, get: function () { return drizzle_orm_2.eq; } });
+Object.defineProperty(exports, "ne", { enumerable: true, get: function () { return drizzle_orm_2.ne; } });
+Object.defineProperty(exports, "gt", { enumerable: true, get: function () { return drizzle_orm_2.gt; } });
+Object.defineProperty(exports, "gte", { enumerable: true, get: function () { return drizzle_orm_2.gte; } });
+Object.defineProperty(exports, "lt", { enumerable: true, get: function () { return drizzle_orm_2.lt; } });
+Object.defineProperty(exports, "lte", { enumerable: true, get: function () { return drizzle_orm_2.lte; } });
+Object.defineProperty(exports, "like", { enumerable: true, get: function () { return drizzle_orm_2.like; } });
+Object.defineProperty(exports, "ilike", { enumerable: true, get: function () { return drizzle_orm_2.ilike; } });
+Object.defineProperty(exports, "notLike", { enumerable: true, get: function () { return drizzle_orm_2.notLike; } });
+Object.defineProperty(exports, "and", { enumerable: true, get: function () { return drizzle_orm_2.and; } });
+Object.defineProperty(exports, "or", { enumerable: true, get: function () { return drizzle_orm_2.or; } });
+Object.defineProperty(exports, "not", { enumerable: true, get: function () { return drizzle_orm_2.not; } });
+Object.defineProperty(exports, "between", { enumerable: true, get: function () { return drizzle_orm_2.between; } });
+Object.defineProperty(exports, "inArray", { enumerable: true, get: function () { return drizzle_orm_2.inArray; } });
+Object.defineProperty(exports, "notInArray", { enumerable: true, get: function () { return drizzle_orm_2.notInArray; } });
+Object.defineProperty(exports, "isNull", { enumerable: true, get: function () { return drizzle_orm_2.isNull; } });
+Object.defineProperty(exports, "isNotNull", { enumerable: true, get: function () { return drizzle_orm_2.isNotNull; } });
+Object.defineProperty(exports, "desc", { enumerable: true, get: function () { return drizzle_orm_2.desc; } });
+Object.defineProperty(exports, "asc", { enumerable: true, get: function () { return drizzle_orm_2.asc; } });
+Object.defineProperty(exports, "count", { enumerable: true, get: function () { return drizzle_orm_2.count; } });
+Object.defineProperty(exports, "sum", { enumerable: true, get: function () { return drizzle_orm_2.sum; } });
+Object.defineProperty(exports, "avg", { enumerable: true, get: function () { return drizzle_orm_2.avg; } });
+Object.defineProperty(exports, "min", { enumerable: true, get: function () { return drizzle_orm_2.min; } });
+Object.defineProperty(exports, "max", { enumerable: true, get: function () { return drizzle_orm_2.max; } });
+Object.defineProperty(exports, "sql", { enumerable: true, get: function () { return drizzle_orm_2.sql; } });
+// =============================================================================
+// DEFAULT EXPORT
+// =============================================================================
+const init_2 = require("./init");
+const transactions_2 = require("./utils/transactions");
+/**
+ * Default export with all nanodb-orm functionality.
+ *
+ * @example
+ * ```ts
+ * import nanodb from 'nanodb-orm';
+ *
+ * const users = nanodb.schema.table('users', {
+ *   id: nanodb.schema.integer('id').primaryKey({ autoIncrement: true }),
+ *   name: nanodb.schema.text('name').notNull(),
+ * });
+ *
+ * const db = await nanodb.createDatabase({ tables: { users } });
+ * await db.select().from(users).where(nanodb.query.eq(users.id, 1));
+ * ```
+ */
+const nanodb = {
+    // Main API
+    createDatabase: init_2.createDatabase,
+    initializeDatabase: init_2.initializeDatabase,
+    transaction: transactions_2.transaction,
+    batch: transactions_2.batch,
+    // Grouped utilities
+    schema: exports.schema,
+    query: exports.query,
+    errors: exports.errors,
+    cli: exports.cli,
+};
+exports.default = nanodb;
 //# 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;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;AAEH,yDAMiC;AAoRxB,4FAzRP,yBAAW,OAyRO;AAlRpB,6CA0BqB;AAErB,gFAAgF;AAChF,oDAAoD;AACpD,gFAAgF;AAEhF;;;;;;;;;;;;;GAaG;AACU,QAAA,MAAM,GAAG;IACpB,KAAK,EAAE,yBAAW;IAClB,OAAO,EAAE,qBAAc;IACvB,IAAI,EAAE,kBAAW;IACjB,IAAI,EAAE,kBAAW;IACjB,IAAI,EAAE,kBAAW;CAClB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACU,QAAA,KAAK,GAAG;IACnB,aAAa;IACb,EAAE,EAAE,gBAAS;IACb,EAAE,EAAE,gBAAS;IACb,EAAE,EAAE,gBAAS;IACb,GAAG,EAAE,iBAAU;IACf,EAAE,EAAE,gBAAS;IACb,GAAG,EAAE,iBAAU;IACf,IAAI,EAAE,kBAAW;IACjB,KAAK,EAAE,mBAAY;IACnB,OAAO,EAAE,qBAAc;IACvB,UAAU;IACV,GAAG,EAAE,iBAAU;IACf,EAAE,EAAE,gBAAS;IACb,GAAG,EAAE,iBAAU;IACf,QAAQ;IACR,OAAO,EAAE,qBAAc;IACvB,OAAO,EAAE,qBAAc;IACvB,UAAU,EAAE,wBAAiB;IAC7B,MAAM,EAAE,oBAAa;IACrB,SAAS,EAAE,uBAAgB;IAC3B,WAAW;IACX,IAAI,EAAE,kBAAW;IACjB,GAAG,EAAE,iBAAU;IACf,aAAa;IACb,KAAK,EAAE,mBAAY;IACnB,GAAG,EAAE,iBAAU;IACf,GAAG,EAAE,iBAAU;IACf,GAAG,EAAE,iBAAU;IACf,GAAG,EAAE,iBAAU;IACf,UAAU;IACV,GAAG,EAAE,iBAAU;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,2CAOwB;AAEX,QAAA,MAAM,GAAG;IACpB,aAAa,EAAb,sBAAa;IACb,WAAW,EAAX,oBAAW;IACX,eAAe,EAAf,wBAAe;IACf,cAAc,EAAd,uBAAc;IACd,SAAS,EAAT,kBAAS;IACT,KAAK,EAAE,qBAAY;CACpB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,+BAMe;AAEF,QAAA,GAAG,GAAG;IACjB,MAAM,EAAE,kBAAY;IACpB,KAAK,EAAE,cAAQ;IACf,KAAK,EAAE,cAAQ;IACf,MAAM,EAAE,eAAS;IACjB,QAAQ,EAAE,iBAAW;CACtB,CAAC;AAEF,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,+BAA4D;AAAnD,sGAAA,cAAc,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AAsE3C,gFAAgF;AAChF,sDAAsD;AACtD,gFAAgF;AAEhF,sBAAsB;AACtB,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,YAAY;AACZ,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,qDAAyE;AAAhE,2GAAA,WAAW,OAAA;AAAE,qGAAA,KAAK,OAAA;AAAE,6GAAA,aAAa,OAAA;AAE1C,mBAAmB;AACnB,6BAMe;AALb,mGAAA,YAAY,OAAA;AACZ,+FAAA,QAAQ,OAAA;AACR,+FAAA,QAAQ,OAAA;AACR,gGAAA,SAAS,OAAA;AACT,kGAAA,WAAW,OAAA;AAGb,+BAA+B;AAClB,QAAA,KAAK,GAAG,yBAAW,CAAC;AAEpB,QAAA,OAAO,GAAG,qBAAc,CAAC;AACzB,QAAA,IAAI,GAAG,kBAAW,CAAC;AACnB,QAAA,IAAI,GAAG,kBAAW,CAAC;AACnB,QAAA,IAAI,GAAG,kBAAW,CAAC;AACnB,QAAA,MAAM,GAAG,cAAM,CAAC,CAAC,QAAQ;AAEtC,+BAA+B;AAC/B,2CAMqB;AALnB,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;AAAE,oGAAA,KAAK,OAAA;AAAE,sGAAA,OAAO,OAAA;AAC9C,kGAAA,GAAG,OAAA;AAAE,iGAAA,EAAE,OAAA;AAAE,kGAAA,GAAG,OAAA;AAAE,sGAAA,OAAO,OAAA;AAAE,sGAAA,OAAO,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,qGAAA,MAAM,OAAA;AAAE,wGAAA,SAAS,OAAA;AAC7D,mGAAA,IAAI,OAAA;AAAE,kGAAA,GAAG,OAAA;AACT,oGAAA,KAAK,OAAA;AAAE,kGAAA,GAAG,OAAA;AAAE,kGAAA,GAAG,OAAA;AAAE,kGAAA,GAAG,OAAA;AAAE,kGAAA,GAAG,OAAA;AACzB,kGAAA,GAAG,OAAA;AAGL,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,iCAA4D;AAC5D,uDAA0D;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,GAAG;IACb,WAAW;IACX,cAAc,EAAd,qBAAc;IACd,kBAAkB,EAAlB,yBAAkB;IAClB,WAAW,EAAX,0BAAW;IACX,KAAK,EAAL,oBAAK;IAEL,oBAAoB;IACpB,MAAM,EAAN,cAAM;IACN,KAAK,EAAL,aAAK;IACL,MAAM,EAAN,cAAM;IACN,GAAG,EAAH,WAAG;CACJ,CAAC;AAEF,kBAAe,MAAM,CAAC"}

package/dist/init.d.ts

@@ -1,28 +1,137 @@
+import type { Schema, SchemaData, MigrationConfig, NanoPlugin, HealthCheck, SyncResult, SchemaValidation, TableMetadata } from './types';
+import type { LibSQLDatabase } from 'drizzle-orm/libsql';
+export type { SchemaData, MigrationConfig, NanoPlugin };
 /**
- * Database initialization utility
- * Initializes the db package with schema data to work as an npm package
+ * Hook system attached to the database instance.
  */
-export interface MigrationConfig {
-    preserveData?: boolean;
-    autoMigrate?: boolean;
-    dropTables?: boolean;
+export interface Hooks {
+    beforeInsert: <T>(table: string, data: T) => T;
+    afterInsert: <T, R>(table: string, data: T, result: R) => T;
+    beforeUpdate: <T>(table: string, data: T) => T;
+    afterUpdate: <T, R>(table: string, data: T, result: R) => T;
+    beforeDelete: <T>(table: string, data: T) => T;
+    afterDelete: <T, R>(table: string, data: T, result: R) => T;
+    beforeQuery: <T>(table: string, data: T) => T;
+    afterQuery: <T, R>(table: string, data: T, result: R) => T;
+    onError: (error: Error, operation: string, table?: string) => void;
+    onReady: (db: unknown) => void;
+    has: (type: HookType) => boolean;
 }
-export interface SchemaData {
-    tables: Record<string, any>;
-    seedData?: Record<string, any[]>;
-    migrationConfig?: MigrationConfig;
+/**
+ * Schema introspection utilities.
+ */
+export interface SchemaUtils<S extends Schema> {
+    /** Get all table names */
+    tables: () => (keyof S)[];
+    /** Get metadata for a specific table */
+    getTable: (name: keyof S) => TableMetadata;
+    /** Get column names for a table */
+    getColumns: (name: keyof S) => string[];
+    /** Validate schema against database */
+    validate: () => Promise<SchemaValidation>;
+    /** Get schema statistics */
+    stats: () => {
+        totalTables: number;
+        tableNames: string[];
+        tableDetails: TableMetadata[];
+    };
+    /** Get all foreign key relationships */
+    relationships: () => Array<{
+        fromTable: string;
+        fromColumn: string;
+        toTable: string;
+        toColumn: string;
+    }>;
 }
 /**
- * Initialize the database package with schema data
- * This allows the db package to work independently without direct imports
+ * Migration utilities.
  */
-export declare function initializeDatabase(schemaData: SchemaData): void;
+export interface MigrationUtils {
+    /** Run migrations */
+    run: () => Promise<void>;
+    /** Validate schema against database */
+    validate: () => Promise<SchemaValidation>;
+    /** Check which tables exist */
+    checkTables: () => Promise<Record<string, boolean>>;
+}
 /**
- * Get initialized schema data (for verification)
+ * Plugin utilities.
  */
-export declare function getSchemaInfo(): {
-    tableNames: string[];
-    tableCount: number;
-    seedDataTables: string[];
+export interface PluginUtils {
+    /** List installed plugin names */
+    list: () => string[];
+}
+/**
+ * The enhanced database instance returned by createDatabase.
+ * Extends the Drizzle database with additional utilities while preserving
+ * full type safety for all table operations.
+ */
+export type NanoDatabase<S extends Schema> = LibSQLDatabase<S> & {
+    /** Health check */
+    healthCheck: () => Promise<HealthCheck>;
+    /** Check if database is ready */
+    isReady: () => Promise<boolean>;
+    /** Sync with remote (Turso) */
+    sync: () => Promise<SyncResult>;
+    /** Reset database (drop, recreate, seed) */
+    reset: () => Promise<void>;
+    /** Re-seed database */
+    seed: () => Promise<void>;
+    /** Clear all data */
+    clearData: () => Promise<void>;
+    /** Schema introspection utilities */
+    schema: SchemaUtils<S>;
+    /** Migration utilities */
+    migrations: MigrationUtils;
+    /** Installed plugins */
+    plugins: PluginUtils;
+    /** Hook system */
+    hooks: Hooks;
 };
+/**
+ * Configuration for createDatabase().
+ */
+export interface CreateDatabaseConfig<S extends Schema = Schema> extends SchemaData<S> {
+    /** 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];
+/**
+ * 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' });
+ * ```
+ */
+export declare function createDatabase<S extends Schema>(config: CreateDatabaseConfig<S>): Promise<NanoDatabase<S>>;
+/**
+ * Initialize internal modules with schema data.
+ * Prefer `createDatabase()` which calls this automatically.
+ *
+ * @internal
+ */
+export declare function initializeDatabase<S extends Schema>(schemaData: SchemaData<S>): 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":"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"}