@pearl-framework/database 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+
+> @pearl-framework/database@0.1.0 build /Users/sharvari/Desktop/Sharvari's Work Station/pearljs/packages/database
+> tsc
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Sharvari Divekar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# @pearl-framework/database
+
+> Drizzle ORM integration, Model helpers, and migrations for Pearl.js
+
+## Installation
+
+```bash
+pnpm add @pearl-framework/database drizzle-orm
+pnpm add -D drizzle-kit
+
+# Add your driver
+pnpm add pg        # PostgreSQL
+pnpm add mysql2    # MySQL
+pnpm add better-sqlite3  # SQLite
+```
+
+## Usage
+
+### Define a schema
+
+```ts
+import { pgTable, serial, varchar, timestamp } from '@pearl-framework/database'
+
+export const users = pgTable('users', {
+  id:        serial('id').primaryKey(),
+  name:      varchar('name', { length: 255 }).notNull(),
+  email:     varchar('email', { length: 255 }).notNull().unique(),
+  createdAt: timestamp('created_at').defaultNow(),
+})
+```
+
+### Define a model
+
+```ts
+import { Model } from '@pearl-framework/database'
+
+export class User extends Model<typeof users> {
+  static table = users
+}
+```
+
+### Query
+
+```ts
+const db = app.make(DatabaseManager).db
+
+await User.all(db)
+await User.find(db, 1)
+await User.findOrFail(db, 1)
+await User.create(db, { name: 'Sharvari', email: 'hi@pearl.dev' })
+await User.update(db, 1, { name: 'Updated' })
+await User.delete(db, 1)
+await User.count(db)
+
+// Raw Drizzle query
+const admins = await db.select().from(users).where(eq(users.role, 'admin'))
+```
+
+### DatabaseServiceProvider
+
+```ts
+export class AppDatabaseServiceProvider extends DatabaseServiceProvider {
+  protected config = {
+    connection: {
+      driver:   'postgres' as const,
+      host:     process.env.DB_HOST!,
+      port:     Number(process.env.DB_PORT),
+      user:     process.env.DB_USER!,
+      password: process.env.DB_PASSWORD!,
+      database: process.env.DB_NAME!,
+    },
+    migrationsFolder: './database/migrations',
+    runMigrationsOnBoot: true,
+  }
+}
+```
+
+### Migrations
+
+```bash
+# Generate migrations from schema changes
+npx drizzle-kit generate:pg --schema=./src/schema
+
+# Apply migrations
+pnpm pearl migrate
+```
+
+---

package/dist/DatabaseManager.d.ts

@@ -0,0 +1,14 @@
+import type { DatabaseConfig } from './config.js';
+export type AnyDrizzleDb = any;
+export declare class DatabaseManager {
+    private _db?;
+    private _config;
+    constructor(config: DatabaseConfig);
+    connect(): Promise<AnyDrizzleDb>;
+    get db(): AnyDrizzleDb;
+    disconnect(): Promise<void>;
+    private connectPostgres;
+    private connectMysql;
+    private connectSqlite;
+}
+//# sourceMappingURL=DatabaseManager.d.ts.map

package/dist/DatabaseManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseManager.d.ts","sourceRoot":"","sources":["../src/DatabaseManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD,MAAM,MAAM,YAAY,GAAG,GAAG,CAAA;AAE9B,qBAAa,eAAe;IACxB,OAAO,CAAC,GAAG,CAAC,CAAc;IAC1B,OAAO,CAAC,OAAO,CAAgB;gBAEnB,MAAM,EAAE,cAAc;IAM5B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAkBtC,IAAI,EAAE,IAAI,YAAY,CAQrB;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAanB,eAAe;YAoBf,YAAY;YAkBZ,aAAa;CAS9B"}

package/dist/DatabaseManager.js

@@ -0,0 +1,76 @@
+export class DatabaseManager {
+    _db;
+    _config;
+    constructor(config) {
+        this._config = config;
+    }
+    // ─── Connection ───────────────────────────────────────────────────────────
+    async connect() {
+        if (this._db)
+            return this._db;
+        switch (this._config.driver) {
+            case 'postgres':
+                this._db = await this.connectPostgres(this._config);
+                break;
+            case 'mysql':
+                this._db = await this.connectMysql(this._config);
+                break;
+            case 'sqlite':
+                this._db = await this.connectSqlite(this._config);
+                break;
+        }
+        return this._db;
+    }
+    get db() {
+        if (!this._db) {
+            throw new Error('Database not connected. Call DatabaseManager.connect() first, ' +
+                'or ensure DatabaseServiceProvider has booted.');
+        }
+        return this._db;
+    }
+    async disconnect() {
+        if (!this._db)
+            return;
+        if (this._config.driver === 'postgres') {
+            const { sql } = await import('drizzle-orm');
+            await this._db.execute(sql `SELECT 1`); // flush pending queries
+        }
+        this._db = undefined;
+    }
+    // ─── Driver connections ───────────────────────────────────────────────────
+    async connectPostgres(config) {
+        const { drizzle } = await import('drizzle-orm/node-postgres');
+        const { Pool } = await import('pg');
+        const pool = new Pool({
+            host: config.host,
+            port: config.port ?? 5432,
+            user: config.user,
+            password: config.password,
+            database: config.database,
+            ssl: config.ssl ?? false,
+            min: config.pool?.min ?? 2,
+            max: config.pool?.max ?? 10,
+        });
+        return drizzle(pool);
+    }
+    async connectMysql(config) {
+        const { drizzle } = await import('drizzle-orm/mysql2');
+        const mysql = await import('mysql2/promise');
+        const pool = mysql.createPool({
+            host: config.host,
+            port: config.port ?? 3306,
+            user: config.user,
+            password: config.password,
+            database: config.database,
+            connectionLimit: config.pool?.max ?? 10,
+        });
+        return drizzle(pool);
+    }
+    async connectSqlite(config) {
+        const { drizzle } = await import('drizzle-orm/better-sqlite3');
+        const Database = await import('better-sqlite3');
+        const client = new Database.default(config.filename);
+        return drizzle(client);
+    }
+}
+//# sourceMappingURL=DatabaseManager.js.map

package/dist/DatabaseManager.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+export type DatabaseDriver = 'postgres' | 'mysql' | 'sqlite';
+export interface PostgresConfig {
+    driver: 'postgres';
+    host: string;
+    port?: number;
+    user: string;
+    password: string;
+    database: string;
+    ssl?: boolean;
+    pool?: {
+        min?: number;
+        max?: number;
+    };
+}
+export interface MysqlConfig {
+    driver: 'mysql';
+    host: string;
+    port?: number;
+    user: string;
+    password: string;
+    database: string;
+    pool?: {
+        min?: number;
+        max?: number;
+    };
+}
+export interface SqliteConfig {
+    driver: 'sqlite';
+    filename: string;
+}
+export type DatabaseConfig = PostgresConfig | MysqlConfig | SqliteConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE5D,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE;QACH,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,GAAG,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACJ;AAED,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE;QACH,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,GAAG,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACJ;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,QAAQ,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,WAAW,GAAG,YAAY,CAAA"}

package/dist/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { DatabaseManager } from './DatabaseManager.js';
+export type { AnyDrizzleDb } from './DatabaseManager.js';
+export type { DatabaseConfig, DatabaseDriver, PostgresConfig, MysqlConfig, SqliteConfig } from './config.js';
+export { Model } from './schema/Model.js';
+export { Migrator } from './migrations/Migrator.js';
+export type { MigratorOptions } from './migrations/Migrator.js';
+export { DatabaseServiceProvider } from './providers/DatabaseServiceProvider.js';
+export type { DatabaseServiceConfig } from './providers/DatabaseServiceProvider.js';
+export * from './query/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGxD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG5G,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAGzC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAG/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAA;AAChF,YAAY,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAA;AAGnF,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Core
+export { DatabaseManager } from './DatabaseManager.js';
+// Model
+export { Model } from './schema/Model.js';
+// Migrations
+export { Migrator } from './migrations/Migrator.js';
+// Service Provider
+export { DatabaseServiceProvider } from './providers/DatabaseServiceProvider.js';
+// Schema builders + query operators (Drizzle re-exports)
+export * from './query/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAMtD,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAEzC,aAAa;AACb,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAGnD,mBAAmB;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAA;AAGhF,yDAAyD;AACzD,cAAc,kBAAkB,CAAA"}

package/dist/migrations/Migrator.d.ts

@@ -0,0 +1,13 @@
+import type { AnyDrizzleDb } from '../DatabaseManager.js';
+import type { DatabaseConfig } from '../config.js';
+export interface MigratorOptions {
+    migrationsFolder: string;
+}
+export declare class Migrator {
+    private readonly db;
+    private readonly config;
+    private readonly options;
+    constructor(db: AnyDrizzleDb, config: DatabaseConfig, options: MigratorOptions);
+    run(): Promise<void>;
+}
+//# sourceMappingURL=Migrator.d.ts.map

package/dist/migrations/Migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migrator.d.ts","sourceRoot":"","sources":["../../src/migrations/Migrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,qBAAa,QAAQ;IAEb,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe;IAGvC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB7B"}

package/dist/migrations/Migrator.js

@@ -0,0 +1,32 @@
+import { resolve } from 'node:path';
+export class Migrator {
+    db;
+    config;
+    options;
+    constructor(db, config, options) {
+        this.db = db;
+        this.config = config;
+        this.options = options;
+    }
+    async run() {
+        const folder = resolve(this.options.migrationsFolder);
+        switch (this.config.driver) {
+            case 'postgres': {
+                const { migrate } = await import('drizzle-orm/node-postgres/migrator');
+                await migrate(this.db, { migrationsFolder: folder });
+                break;
+            }
+            case 'mysql': {
+                const { migrate } = await import('drizzle-orm/mysql2/migrator');
+                await migrate(this.db, { migrationsFolder: folder });
+                break;
+            }
+            case 'sqlite': {
+                const { migrate } = await import('drizzle-orm/better-sqlite3/migrator');
+                await migrate(this.db, { migrationsFolder: folder });
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=Migrator.js.map

package/dist/migrations/Migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migrator.js","sourceRoot":"","sources":["../../src/migrations/Migrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,MAAM,OAAO,QAAQ;IAEI;IACA;IACA;IAHrB,YACqB,EAAgB,EAChB,MAAsB,EACtB,OAAwB;QAFxB,OAAE,GAAF,EAAE,CAAc;QAChB,WAAM,GAAN,MAAM,CAAgB;QACtB,YAAO,GAAP,OAAO,CAAiB;IAC1C,CAAC;IAEJ,KAAK,CAAC,GAAG;QACL,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;QAErD,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC7B,KAAK,UAAU,CAAC,CAAC,CAAC;gBACd,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAA;gBACtE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAA;gBACpD,MAAK;YACT,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACX,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAA;gBAC/D,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAA;gBACpD,MAAK;YACT,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACZ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAA;gBACvE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAA;gBACpD,MAAK;YACT,CAAC;QACD,CAAC;IACL,CAAC;CACJ"}

package/dist/providers/DatabaseServiceProvider.d.ts

@@ -0,0 +1,34 @@
+import { ServiceProvider } from '@pearl-framework/core';
+import type { DatabaseConfig } from '../config.js';
+export interface DatabaseServiceConfig {
+    connection: DatabaseConfig;
+    migrationsFolder?: string;
+    runMigrationsOnBoot?: boolean;
+}
+/**
+ * DatabaseServiceProvider connects to the database and optionally runs migrations on boot.
+ *
+ * Usage — extend this in your app:
+ *
+ *   export class AppDatabaseServiceProvider extends DatabaseServiceProvider {
+ *     protected config: DatabaseServiceConfig = {
+ *       connection: {
+ *         driver: 'postgres',
+ *         host:     env('DB_HOST'),
+ *         port:     env.number('DB_PORT', 5432),
+ *         user:     env('DB_USER'),
+ *         password: env('DB_PASSWORD'),
+ *         database: env('DB_NAME'),
+ *       },
+ *       migrationsFolder: './database/migrations',
+ *       runMigrationsOnBoot: true,
+ *     }
+ *   }
+ */
+export declare class DatabaseServiceProvider extends ServiceProvider {
+    protected config: DatabaseServiceConfig;
+    register(): void;
+    boot(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=DatabaseServiceProvider.d.ts.map

package/dist/providers/DatabaseServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseServiceProvider.d.ts","sourceRoot":"","sources":["../../src/providers/DatabaseServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,cAAc,CAAA;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;IACxD,SAAS,CAAC,MAAM,EAAG,qBAAqB,CAAA;IAExC,QAAQ,IAAI,IAAI;IAOD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIlC"}

package/dist/providers/DatabaseServiceProvider.js

@@ -0,0 +1,42 @@
+import { ServiceProvider } from '@pearl-framework/core';
+import { DatabaseManager } from '../DatabaseManager.js';
+import { Migrator } from '../migrations/Migrator.js';
+/**
+ * DatabaseServiceProvider connects to the database and optionally runs migrations on boot.
+ *
+ * Usage — extend this in your app:
+ *
+ *   export class AppDatabaseServiceProvider extends DatabaseServiceProvider {
+ *     protected config: DatabaseServiceConfig = {
+ *       connection: {
+ *         driver: 'postgres',
+ *         host:     env('DB_HOST'),
+ *         port:     env.number('DB_PORT', 5432),
+ *         user:     env('DB_USER'),
+ *         password: env('DB_PASSWORD'),
+ *         database: env('DB_NAME'),
+ *       },
+ *       migrationsFolder: './database/migrations',
+ *       runMigrationsOnBoot: true,
+ *     }
+ *   }
+ */
+export class DatabaseServiceProvider extends ServiceProvider {
+    config;
+    register() {
+        this.container.singleton(DatabaseManager, () => new DatabaseManager(this.config.connection));
+    }
+    async boot() {
+        const manager = this.container.make(DatabaseManager);
+        await manager.connect();
+        if (this.config.runMigrationsOnBoot && this.config.migrationsFolder) {
+            const migrator = new Migrator(manager.db, this.config.connection, { migrationsFolder: this.config.migrationsFolder });
+            await migrator.run();
+        }
+    }
+    async shutdown() {
+        const manager = this.container.make(DatabaseManager);
+        await manager.disconnect();
+    }
+}
+//# sourceMappingURL=DatabaseServiceProvider.js.map

package/dist/providers/DatabaseServiceProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseServiceProvider.js","sourceRoot":"","sources":["../../src/providers/DatabaseServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AASpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC9C,MAAM,CAAwB;IAExC,QAAQ;QACJ,IAAI,CAAC,SAAS,CAAC,SAAS,CACpB,eAAe,EACf,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CACpD,CAAA;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QACpD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;QAEvB,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAClE,MAAM,QAAQ,GAAG,IAAI,QAAQ,CACzB,OAAO,CAAC,EAAE,EACV,IAAI,CAAC,MAAM,CAAC,UAAU,EACtB,EAAE,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CACrD,CAAA;YACD,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAA;QACxB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QACpD,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;IAC9B,CAAC;CACJ"}

package/dist/query/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Re-export Drizzle's schema builders and operators.
+ * Users import from @pearl-framework/database instead of drizzle-orm directly.
+ */
+export { pgTable, pgEnum, serial, integer, bigserial, bigint, varchar, text, boolean, timestamp, date, numeric, jsonb, uuid, primaryKey, index, uniqueIndex, } from 'drizzle-orm/pg-core';
+export { mysqlTable, mysqlEnum, int, bigint as mysqlBigint, varchar as mysqlVarchar, text as mysqlText, boolean as mysqlBoolean, timestamp as mysqlTimestamp, datetime, decimal, json, primaryKey as mysqlPrimaryKey, index as mysqlIndex, uniqueIndex as mysqlUniqueIndex, } from 'drizzle-orm/mysql-core';
+export { sqliteTable, integer as sqliteInteger, text as sqliteText, real, blob, primaryKey as sqlitePrimaryKey, index as sqliteIndex, uniqueIndex as sqliteUniqueIndex, } from 'drizzle-orm/sqlite-core';
+export { eq, ne, gt, gte, lt, lte, and, or, not, isNull, isNotNull, inArray, notInArray, like, ilike, between, sql, count, sum, avg, min, max, asc, desc, } from 'drizzle-orm';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,OAAO,EACP,MAAM,EACN,MAAM,EACN,OAAO,EACP,SAAS,EACT,MAAM,EACN,OAAO,EACP,IAAI,EACJ,OAAO,EACP,SAAS,EACT,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAK,EACL,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,UAAU,EACV,SAAS,EACT,GAAG,EACH,MAAM,IAAI,WAAW,EACrB,OAAO,IAAI,YAAY,EACvB,IAAI,IAAI,SAAS,EACjB,OAAO,IAAI,YAAY,EACvB,SAAS,IAAI,cAAc,EAC3B,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,UAAU,IAAI,eAAe,EAC7B,KAAK,IAAI,UAAU,EACnB,WAAW,IAAI,gBAAgB,GAChC,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,WAAW,EACX,OAAO,IAAI,aAAa,EACxB,IAAI,IAAI,UAAU,EAClB,IAAI,EACJ,IAAI,EACJ,UAAU,IAAI,gBAAgB,EAC9B,KAAK,IAAI,WAAW,EACpB,WAAW,IAAI,iBAAiB,GACjC,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EACL,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,GAAG,EACH,EAAE,EACF,GAAG,EACH,MAAM,EACN,SAAS,EACT,OAAO,EACP,UAAU,EACV,IAAI,EACJ,KAAK,EACL,OAAO,EACP,GAAG,EACH,KAAK,EACL,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,IAAI,GACL,MAAM,aAAa,CAAA"}

package/dist/query/index.js

@@ -0,0 +1,11 @@
+/**
+ * Re-export Drizzle's schema builders and operators.
+ * Users import from @pearl-framework/database instead of drizzle-orm directly.
+ */
+// Schema builders
+export { pgTable, pgEnum, serial, integer, bigserial, bigint, varchar, text, boolean, timestamp, date, numeric, jsonb, uuid, primaryKey, index, uniqueIndex, } from 'drizzle-orm/pg-core';
+export { mysqlTable, mysqlEnum, int, bigint as mysqlBigint, varchar as mysqlVarchar, text as mysqlText, boolean as mysqlBoolean, timestamp as mysqlTimestamp, datetime, decimal, json, primaryKey as mysqlPrimaryKey, index as mysqlIndex, uniqueIndex as mysqlUniqueIndex, } from 'drizzle-orm/mysql-core';
+export { sqliteTable, integer as sqliteInteger, text as sqliteText, real, blob, primaryKey as sqlitePrimaryKey, index as sqliteIndex, uniqueIndex as sqliteUniqueIndex, } from 'drizzle-orm/sqlite-core';
+// Query operators
+export { eq, ne, gt, gte, lt, lte, and, or, not, isNull, isNotNull, inArray, notInArray, like, ilike, between, sql, count, sum, avg, min, max, asc, desc, } from 'drizzle-orm';
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kBAAkB;AAClB,OAAO,EACL,OAAO,EACP,MAAM,EACN,MAAM,EACN,OAAO,EACP,SAAS,EACT,MAAM,EACN,OAAO,EACP,IAAI,EACJ,OAAO,EACP,SAAS,EACT,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,UAAU,EACV,KAAK,EACL,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,UAAU,EACV,SAAS,EACT,GAAG,EACH,MAAM,IAAI,WAAW,EACrB,OAAO,IAAI,YAAY,EACvB,IAAI,IAAI,SAAS,EACjB,OAAO,IAAI,YAAY,EACvB,SAAS,IAAI,cAAc,EAC3B,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,UAAU,IAAI,eAAe,EAC7B,KAAK,IAAI,UAAU,EACnB,WAAW,IAAI,gBAAgB,GAChC,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,WAAW,EACX,OAAO,IAAI,aAAa,EACxB,IAAI,IAAI,UAAU,EAClB,IAAI,EACJ,IAAI,EACJ,UAAU,IAAI,gBAAgB,EAC9B,KAAK,IAAI,WAAW,EACpB,WAAW,IAAI,iBAAiB,GACjC,MAAM,yBAAyB,CAAA;AAEhC,kBAAkB;AAClB,OAAO,EACL,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,GAAG,EACH,EAAE,EACF,GAAG,EACH,MAAM,EACN,SAAS,EACT,OAAO,EACP,UAAU,EACV,IAAI,EACJ,KAAK,EACL,OAAO,EACP,GAAG,EACH,KAAK,EACL,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,IAAI,GACL,MAAM,aAAa,CAAA"}

package/dist/schema/Model.d.ts

@@ -0,0 +1,38 @@
+import { type SQL } from 'drizzle-orm';
+import type { AnyDrizzleDb } from '../DatabaseManager.js';
+import type { PgTableWithColumns } from 'drizzle-orm/pg-core';
+import type { MySqlTableWithColumns } from 'drizzle-orm/mysql-core';
+import type { SQLiteTableWithColumns } from 'drizzle-orm/sqlite-core';
+export type AnyTable = PgTableWithColumns<any> | MySqlTableWithColumns<any> | SQLiteTableWithColumns<any>;
+/**
+ * Model is a thin static query helper that wraps a Drizzle table.
+ *
+ * Usage:
+ *   // Define your schema with Drizzle
+ *   export const users = pgTable('users', {
+ *     id:    serial('id').primaryKey(),
+ *     name:  varchar('name', { length: 255 }).notNull(),
+ *     email: varchar('email', { length: 255 }).notNull().unique(),
+ *   })
+ *
+ *   // Define your model
+ *   export class User extends Model<typeof users> {
+ *     static table = users
+ *   }
+ *
+ *   // Use it
+ *   const user = await User.find(db, 1)
+ *   const all  = await User.all(db)
+ */
+export declare class Model<TTable extends AnyTable> {
+    static table: AnyTable;
+    static all<T extends typeof Model>(this: T, db: AnyDrizzleDb): Promise<unknown[]>;
+    static find<T extends typeof Model>(this: T, db: AnyDrizzleDb, id: number | string): Promise<unknown | undefined>;
+    static findOrFail<T extends typeof Model>(this: T, db: AnyDrizzleDb, id: number | string): Promise<unknown>;
+    static where<T extends typeof Model>(this: T, db: AnyDrizzleDb, condition: SQL): Promise<unknown[]>;
+    static create<T extends typeof Model>(this: T, db: AnyDrizzleDb, data: Record<string, unknown>): Promise<unknown>;
+    static update<T extends typeof Model>(this: T, db: AnyDrizzleDb, id: number | string, data: Record<string, unknown>): Promise<unknown>;
+    static delete<T extends typeof Model>(this: T, db: AnyDrizzleDb, id: number | string): Promise<void>;
+    static count<T extends typeof Model>(this: T, db: AnyDrizzleDb): Promise<number>;
+}
+//# sourceMappingURL=Model.d.ts.map

package/dist/schema/Model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../../src/schema/Model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,GAAG,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAErE,MAAM,MAAM,QAAQ,GAChB,kBAAkB,CAAC,GAAG,CAAC,GACvB,qBAAqB,CAAC,GAAG,CAAC,GAC1B,sBAAsB,CAAC,GAAG,CAAC,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,KAAK,CAAC,MAAM,SAAS,QAAQ;IAEtC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAA;WAIT,GAAG,CAAC,CAAC,SAAS,OAAO,KAAK,EACnC,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,GACjB,OAAO,CAAC,OAAO,EAAE,CAAC;WAIR,IAAI,CAAC,CAAC,SAAS,OAAO,KAAK,EACpC,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,GAAG,MAAM,GACpB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;WASlB,UAAU,CAAC,CAAC,SAAS,OAAO,KAAK,EAC1C,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,GAAG,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;WAMN,KAAK,CAAC,CAAC,SAAS,OAAO,KAAK,EACrC,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,GAAG,GACf,OAAO,CAAC,OAAO,EAAE,CAAC;WAIR,MAAM,CAAC,CAAC,SAAS,OAAO,KAAK,EACtC,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;WAKN,MAAM,CAAC,CAAC,SAAS,OAAO,KAAK,EACtC,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;WAaN,MAAM,CAAC,CAAC,SAAS,OAAO,KAAK,EACtC,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,GAAG,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;WAQH,KAAK,CAAC,CAAC,SAAS,OAAO,KAAK,EACrC,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,GACjB,OAAO,CAAC,MAAM,CAAC;CAOrB"}

package/dist/schema/Model.js

@@ -0,0 +1,77 @@
+import { eq } from 'drizzle-orm';
+/**
+ * Model is a thin static query helper that wraps a Drizzle table.
+ *
+ * Usage:
+ *   // Define your schema with Drizzle
+ *   export const users = pgTable('users', {
+ *     id:    serial('id').primaryKey(),
+ *     name:  varchar('name', { length: 255 }).notNull(),
+ *     email: varchar('email', { length: 255 }).notNull().unique(),
+ *   })
+ *
+ *   // Define your model
+ *   export class User extends Model<typeof users> {
+ *     static table = users
+ *   }
+ *
+ *   // Use it
+ *   const user = await User.find(db, 1)
+ *   const all  = await User.all(db)
+ */
+export class Model {
+    // Subclasses set this to their Drizzle table definition
+    static table;
+    // ─── Queries ──────────────────────────────────────────────────────────────
+    static async all(db) {
+        return db.select().from(this.table);
+    }
+    static async find(db, id) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const idCol = this.table.id;
+        if (!idCol)
+            throw new Error(`Table has no "id" column.`);
+        const rows = await db.select().from(this.table).where(eq(idCol, id)).limit(1);
+        return rows[0];
+    }
+    static async findOrFail(db, id) {
+        const row = await this.find(db, id);
+        if (!row)
+            throw new Error(`Record not found with id: ${id}`);
+        return row;
+    }
+    static async where(db, condition) {
+        return db.select().from(this.table).where(condition);
+    }
+    static async create(db, data) {
+        const rows = await db.insert(this.table).values(data).returning();
+        return rows[0];
+    }
+    static async update(db, id, data) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const idCol = this.table.id;
+        if (!idCol)
+            throw new Error(`Table has no "id" column.`);
+        const rows = await db
+            .update(this.table)
+            .set(data)
+            .where(eq(idCol, id))
+            .returning();
+        return rows[0];
+    }
+    static async delete(db, id) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const idCol = this.table.id;
+        if (!idCol)
+            throw new Error(`Table has no "id" column.`);
+        await db.delete(this.table).where(eq(idCol, id));
+    }
+    static async count(db) {
+        const { count } = await import('drizzle-orm');
+        const result = await db
+            .select({ count: count() })
+            .from(this.table);
+        return Number(result[0]?.count ?? 0);
+    }
+}
+//# sourceMappingURL=Model.js.map

package/dist/schema/Model.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@pearl-framework/database",
+  "version": "0.1.0",
+  "description": "Pearl.js database — Drizzle ORM integration, migrations, and connection management",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/index.d.ts"
+      ]
+    }
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.30.0",
+    "drizzle-kit": "^0.20.0",
+    "@pearl-framework/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "pg": "^8.11.0",
+    "mysql2": "^3.9.0",
+    "better-sqlite3": "^9.4.0"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/pg": "^8.11.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/skd09/pearl.js.git",
+    "directory": "packages/database"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/DatabaseManager.ts

@@ -0,0 +1,105 @@
+import type { DatabaseConfig } from './config.js'
+
+// Use a union type for the Drizzle db instance since each driver returns different types
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type AnyDrizzleDb = any
+
+export class DatabaseManager {
+    private _db?: AnyDrizzleDb
+    private _config: DatabaseConfig
+
+    constructor(config: DatabaseConfig) {
+        this._config = config
+    }
+
+    // ─── Connection ───────────────────────────────────────────────────────────
+
+    async connect(): Promise<AnyDrizzleDb> {
+        if (this._db) return this._db
+
+        switch (this._config.driver) {
+        case 'postgres':
+            this._db = await this.connectPostgres(this._config)
+            break
+        case 'mysql':
+            this._db = await this.connectMysql(this._config)
+            break
+        case 'sqlite':
+            this._db = await this.connectSqlite(this._config)
+            break
+        }
+
+        return this._db
+    }
+
+    get db(): AnyDrizzleDb {
+        if (!this._db) {
+            throw new Error(
+                'Database not connected. Call DatabaseManager.connect() first, ' +
+                'or ensure DatabaseServiceProvider has booted.'
+            )
+        }
+        return this._db
+    }
+
+    async disconnect(): Promise<void> {
+        if (!this._db) return
+
+        if (this._config.driver === 'postgres') {
+            const { sql } = await import('drizzle-orm')
+            await this._db.execute(sql`SELECT 1`) // flush pending queries
+        }
+
+        this._db = undefined
+    }
+
+    // ─── Driver connections ───────────────────────────────────────────────────
+
+    private async connectPostgres(
+        config: Extract<DatabaseConfig, { driver: 'postgres' }>
+    ): Promise<AnyDrizzleDb> {
+        const { drizzle } = await import('drizzle-orm/node-postgres')
+        const { Pool } = await import('pg')
+
+        const pool = new Pool({
+            host: config.host,
+            port: config.port ?? 5432,
+            user: config.user,
+            password: config.password,
+            database: config.database,
+            ssl: config.ssl ?? false,
+            min: config.pool?.min ?? 2,
+            max: config.pool?.max ?? 10,
+        })
+
+        return drizzle(pool)
+    }
+
+    private async connectMysql(
+        config: Extract<DatabaseConfig, { driver: 'mysql' }>
+    ): Promise<AnyDrizzleDb> {
+        const { drizzle } = await import('drizzle-orm/mysql2')
+        const mysql = await import('mysql2/promise')
+
+        const pool = mysql.createPool({
+            host: config.host,
+            port: config.port ?? 3306,
+            user: config.user,
+            password: config.password,
+            database: config.database,
+            connectionLimit: config.pool?.max ?? 10,
+        })
+
+        return drizzle(pool)
+    }
+
+    private async connectSqlite(
+        config: Extract<DatabaseConfig, { driver: 'sqlite' }>
+    ): Promise<AnyDrizzleDb> {
+        const { drizzle } = await import('drizzle-orm/better-sqlite3')
+        const Database = await import('better-sqlite3')
+
+        const client = new Database.default(config.filename)
+        return drizzle(client)
+    }
+}

package/src/config.ts

@@ -0,0 +1,35 @@
+export type DatabaseDriver = 'postgres' | 'mysql' | 'sqlite'
+
+export interface PostgresConfig {
+    driver: 'postgres'
+    host: string
+    port?: number
+    user: string
+    password: string
+    database: string
+    ssl?: boolean
+    pool?: {
+        min?: number
+        max?: number
+    }
+}
+
+export interface MysqlConfig {
+    driver: 'mysql'
+    host: string
+    port?: number
+    user: string
+    password: string
+    database: string
+    pool?: {
+        min?: number
+        max?: number
+    }
+}
+
+export interface SqliteConfig {
+    driver: 'sqlite'
+    filename: string
+}
+
+export type DatabaseConfig = PostgresConfig | MysqlConfig | SqliteConfig

package/src/index.ts

@@ -0,0 +1,20 @@
+// Core
+export { DatabaseManager } from './DatabaseManager.js'
+export type { AnyDrizzleDb } from './DatabaseManager.js'
+
+// Config
+export type { DatabaseConfig, DatabaseDriver, PostgresConfig, MysqlConfig, SqliteConfig } from './config.js'
+
+// Model
+export { Model } from './schema/Model.js'
+
+// Migrations
+export { Migrator } from './migrations/Migrator.js'
+export type { MigratorOptions } from './migrations/Migrator.js'
+
+// Service Provider
+export { DatabaseServiceProvider } from './providers/DatabaseServiceProvider.js'
+export type { DatabaseServiceConfig } from './providers/DatabaseServiceProvider.js'
+
+// Schema builders + query operators (Drizzle re-exports)
+export * from './query/index.js'

package/src/migrations/Migrator.ts

@@ -0,0 +1,37 @@
+import { resolve } from 'node:path'
+import type { AnyDrizzleDb } from '../DatabaseManager.js'
+import type { DatabaseConfig } from '../config.js'
+
+export interface MigratorOptions {
+  migrationsFolder: string
+}
+
+export class Migrator {
+    constructor(
+        private readonly db: AnyDrizzleDb,
+        private readonly config: DatabaseConfig,
+        private readonly options: MigratorOptions,
+    ) {}
+
+    async run(): Promise<void> {
+        const folder = resolve(this.options.migrationsFolder)
+
+        switch (this.config.driver) {
+        case 'postgres': {
+            const { migrate } = await import('drizzle-orm/node-postgres/migrator')
+            await migrate(this.db, { migrationsFolder: folder })
+            break
+        }
+        case 'mysql': {
+            const { migrate } = await import('drizzle-orm/mysql2/migrator')
+            await migrate(this.db, { migrationsFolder: folder })
+            break
+        }
+        case 'sqlite': {
+            const { migrate } = await import('drizzle-orm/better-sqlite3/migrator')
+            await migrate(this.db, { migrationsFolder: folder })
+            break
+        }
+        }
+    }
+}

package/src/providers/DatabaseServiceProvider.ts

@@ -0,0 +1,60 @@
+import { ServiceProvider } from '@pearl-framework/core'
+import { DatabaseManager } from '../DatabaseManager.js'
+import { Migrator } from '../migrations/Migrator.js'
+import type { DatabaseConfig } from '../config.js'
+
+export interface DatabaseServiceConfig {
+  connection: DatabaseConfig
+  migrationsFolder?: string
+  runMigrationsOnBoot?: boolean
+}
+
+/**
+ * DatabaseServiceProvider connects to the database and optionally runs migrations on boot.
+ *
+ * Usage — extend this in your app:
+ *
+ *   export class AppDatabaseServiceProvider extends DatabaseServiceProvider {
+ *     protected config: DatabaseServiceConfig = {
+ *       connection: {
+ *         driver: 'postgres',
+ *         host:     env('DB_HOST'),
+ *         port:     env.number('DB_PORT', 5432),
+ *         user:     env('DB_USER'),
+ *         password: env('DB_PASSWORD'),
+ *         database: env('DB_NAME'),
+ *       },
+ *       migrationsFolder: './database/migrations',
+ *       runMigrationsOnBoot: true,
+ *     }
+ *   }
+ */
+export class DatabaseServiceProvider extends ServiceProvider {
+    protected config!: DatabaseServiceConfig
+
+    register(): void {
+        this.container.singleton(
+            DatabaseManager,
+            () => new DatabaseManager(this.config.connection),
+        )
+    }
+
+    override async boot(): Promise<void> {
+        const manager = this.container.make(DatabaseManager)
+        await manager.connect()
+
+        if (this.config.runMigrationsOnBoot && this.config.migrationsFolder) {
+            const migrator = new Migrator(
+                manager.db,
+                this.config.connection,
+                { migrationsFolder: this.config.migrationsFolder },
+            )
+            await migrator.run()
+        }
+    }
+
+    async shutdown(): Promise<void> {
+        const manager = this.container.make(DatabaseManager)
+        await manager.disconnect()
+    }
+}

package/src/query/index.ts

@@ -0,0 +1,81 @@
+/**
+ * Re-export Drizzle's schema builders and operators.
+ * Users import from @pearl-framework/database instead of drizzle-orm directly.
+ */
+
+// Schema builders
+export {
+  pgTable,
+  pgEnum,
+  serial,
+  integer,
+  bigserial,
+  bigint,
+  varchar,
+  text,
+  boolean,
+  timestamp,
+  date,
+  numeric,
+  jsonb,
+  uuid,
+  primaryKey,
+  index,
+  uniqueIndex,
+} from 'drizzle-orm/pg-core'
+
+export {
+  mysqlTable,
+  mysqlEnum,
+  int,
+  bigint as mysqlBigint,
+  varchar as mysqlVarchar,
+  text as mysqlText,
+  boolean as mysqlBoolean,
+  timestamp as mysqlTimestamp,
+  datetime,
+  decimal,
+  json,
+  primaryKey as mysqlPrimaryKey,
+  index as mysqlIndex,
+  uniqueIndex as mysqlUniqueIndex,
+} from 'drizzle-orm/mysql-core'
+
+export {
+  sqliteTable,
+  integer as sqliteInteger,
+  text as sqliteText,
+  real,
+  blob,
+  primaryKey as sqlitePrimaryKey,
+  index as sqliteIndex,
+  uniqueIndex as sqliteUniqueIndex,
+} from 'drizzle-orm/sqlite-core'
+
+// Query operators
+export {
+  eq,
+  ne,
+  gt,
+  gte,
+  lt,
+  lte,
+  and,
+  or,
+  not,
+  isNull,
+  isNotNull,
+  inArray,
+  notInArray,
+  like,
+  ilike,
+  between,
+  sql,
+  count,
+  sum,
+  avg,
+  min,
+  max,
+  asc,
+  desc,
+} from 'drizzle-orm'

package/src/schema/Model.ts

@@ -0,0 +1,125 @@
+import { eq, type SQL } from 'drizzle-orm'
+import type { AnyDrizzleDb } from '../DatabaseManager.js'
+import type { PgTableWithColumns } from 'drizzle-orm/pg-core'
+import type { MySqlTableWithColumns } from 'drizzle-orm/mysql-core'
+import type { SQLiteTableWithColumns } from 'drizzle-orm/sqlite-core'
+
+export type AnyTable =
+  | PgTableWithColumns<any> // eslint-disable-line @typescript-eslint/no-explicit-any
+  | MySqlTableWithColumns<any> // eslint-disable-line @typescript-eslint/no-explicit-any
+  | SQLiteTableWithColumns<any> // eslint-disable-line @typescript-eslint/no-explicit-any
+
+/**
+ * Model is a thin static query helper that wraps a Drizzle table.
+ *
+ * Usage:
+ *   // Define your schema with Drizzle
+ *   export const users = pgTable('users', {
+ *     id:    serial('id').primaryKey(),
+ *     name:  varchar('name', { length: 255 }).notNull(),
+ *     email: varchar('email', { length: 255 }).notNull().unique(),
+ *   })
+ *
+ *   // Define your model
+ *   export class User extends Model<typeof users> {
+ *     static table = users
+ *   }
+ *
+ *   // Use it
+ *   const user = await User.find(db, 1)
+ *   const all  = await User.all(db)
+ */
+export class Model<TTable extends AnyTable> {
+    // Subclasses set this to their Drizzle table definition
+    static table: AnyTable
+
+    // ─── Queries ──────────────────────────────────────────────────────────────
+
+    static async all<T extends typeof Model>(
+        this: T,
+        db: AnyDrizzleDb,
+    ): Promise<unknown[]> {
+        return db.select().from(this.table)
+    }
+
+    static async find<T extends typeof Model>(
+        this: T,
+        db: AnyDrizzleDb,
+        id: number | string,
+    ): Promise<unknown | undefined> {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const idCol = (this.table as any).id
+        if (!idCol) throw new Error(`Table has no "id" column.`)
+
+        const rows = await db.select().from(this.table).where(eq(idCol, id)).limit(1)
+        return rows[0]
+    }
+
+    static async findOrFail<T extends typeof Model>(
+        this: T,
+        db: AnyDrizzleDb,
+        id: number | string,
+    ): Promise<unknown> {
+        const row = await this.find(db, id)
+        if (!row) throw new Error(`Record not found with id: ${id}`)
+        return row
+    }
+
+    static async where<T extends typeof Model>(
+        this: T,
+        db: AnyDrizzleDb,
+        condition: SQL,
+    ): Promise<unknown[]> {
+        return db.select().from(this.table).where(condition)
+    }
+
+    static async create<T extends typeof Model>(
+        this: T,
+        db: AnyDrizzleDb,
+        data: Record<string, unknown>,
+    ): Promise<unknown> {
+        const rows = await db.insert(this.table).values(data).returning()
+        return rows[0]
+    }
+
+    static async update<T extends typeof Model>(
+        this: T,
+        db: AnyDrizzleDb,
+        id: number | string,
+        data: Record<string, unknown>,
+    ): Promise<unknown> {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const idCol = (this.table as any).id
+        if (!idCol) throw new Error(`Table has no "id" column.`)
+
+        const rows = await db
+        .update(this.table)
+        .set(data)
+        .where(eq(idCol, id))
+        .returning()
+        return rows[0]
+    }
+
+    static async delete<T extends typeof Model>(
+        this: T,
+        db: AnyDrizzleDb,
+        id: number | string,
+    ): Promise<void> {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const idCol = (this.table as any).id
+        if (!idCol) throw new Error(`Table has no "id" column.`)
+
+        await db.delete(this.table).where(eq(idCol, id))
+    }
+
+    static async count<T extends typeof Model>(
+        this: T,
+        db: AnyDrizzleDb,
+    ): Promise<number> {
+        const { count } = await import('drizzle-orm')
+        const result = await db
+        .select({ count: count() })
+        .from(this.table)
+        return Number(result[0]?.count ?? 0)
+    }
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+}