exisjs 0.5.10 → 0.5.11

package/dist/database/index.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * ExisJS Database Layer
+ *
+ * A unified database abstraction providing connection pooling, query building,
+ * transactions, migrations, and multi-dialect support.
+ *
+ * @example
+ * ```ts
+ * import { createDatabase, db } from 'exisjs/database'
+ *
+ * const database = createDatabase({
+ *   dialect: 'postgres',
+ *   url: process.env.DATABASE_URL,
+ * })
+ * await database.connect()
+ *
+ * // Raw queries
+ * const users = await db.query<User>('SELECT * FROM users WHERE role = $1', ['admin'])
+ *
+ * // Query builder
+ * const admins = await db.table('users').where('role', '=', 'admin').rows()
+ *
+ * // Transactions
+ * await db.transaction(async (tx) => {
+ *   await tx.execute('INSERT INTO orders ...', [...])
+ *   await tx.execute('UPDATE inventory ...', [...])
+ * })
+ *
+ * // Migrations
+ * const migrator = db.getMigrator({ directory: './migrations' })
+ * await migrator.up()
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongodbAdapter = exports.SqliteAdapter = exports.MysqlAdapter = exports.PostgresAdapter = exports.Migrator = exports.QueryBuilder = exports.setDefaultDatabase = exports.db = exports.createDatabase = exports.DatabaseManager = void 0;
+// ─── Core ────────────────────────────────────────────────────────────────────
+var manager_1 = require("./manager");
+Object.defineProperty(exports, "DatabaseManager", { enumerable: true, get: function () { return manager_1.DatabaseManager; } });
+Object.defineProperty(exports, "createDatabase", { enumerable: true, get: function () { return manager_1.createDatabase; } });
+Object.defineProperty(exports, "db", { enumerable: true, get: function () { return manager_1.db; } });
+Object.defineProperty(exports, "setDefaultDatabase", { enumerable: true, get: function () { return manager_1.setDefaultDatabase; } });
+// ─── Query Builder ───────────────────────────────────────────────────────────
+var query_builder_1 = require("./query-builder");
+Object.defineProperty(exports, "QueryBuilder", { enumerable: true, get: function () { return query_builder_1.QueryBuilder; } });
+// ─── Migration ───────────────────────────────────────────────────────────────
+var migration_1 = require("./migration");
+Object.defineProperty(exports, "Migrator", { enumerable: true, get: function () { return migration_1.Migrator; } });
+// ─── Adapters ────────────────────────────────────────────────────────────────
+var postgres_1 = require("./adapters/postgres");
+Object.defineProperty(exports, "PostgresAdapter", { enumerable: true, get: function () { return postgres_1.PostgresAdapter; } });
+var mysql_1 = require("./adapters/mysql");
+Object.defineProperty(exports, "MysqlAdapter", { enumerable: true, get: function () { return mysql_1.MysqlAdapter; } });
+var sqlite_1 = require("./adapters/sqlite");
+Object.defineProperty(exports, "SqliteAdapter", { enumerable: true, get: function () { return sqlite_1.SqliteAdapter; } });
+var mongodb_1 = require("./adapters/mongodb");
+Object.defineProperty(exports, "MongodbAdapter", { enumerable: true, get: function () { return mongodb_1.MongodbAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;;AAEH,gFAAgF;AAChF,qCAKkB;AAJhB,0GAAA,eAAe,OAAA;AACf,yGAAA,cAAc,OAAA;AACd,6FAAA,EAAE,OAAA;AACF,6GAAA,kBAAkB,OAAA;AAGpB,gFAAgF;AAChF,iDAA8C;AAArC,6GAAA,YAAY,OAAA;AAErB,gFAAgF;AAChF,yCAAsC;AAA7B,qGAAA,QAAQ,OAAA;AAEjB,gFAAgF;AAChF,gDAAqD;AAA5C,2GAAA,eAAe,OAAA;AACxB,0CAA+C;AAAtC,qGAAA,YAAY,OAAA;AACrB,4CAAiD;AAAxC,uGAAA,aAAa,OAAA;AACtB,8CAAmD;AAA1C,yGAAA,cAAc,OAAA"}

package/dist/database/manager.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Database Manager.
+ *
+ * The central orchestrator for all database connections. Manages named connections,
+ * provides lifecycle integration with the ExisJS app (auto-disconnect on shutdown),
+ * and exposes the query builder, raw query execution, and migration system.
+ *
+ * Usage:
+ *   import { db, createDatabase } from 'exisjs/database'
+ *
+ *   // Quick setup
+ *   const database = createDatabase({ dialect: 'postgres', url: process.env.DATABASE_URL })
+ *   await database.connect()
+ *
+ *   // Query
+ *   const users = await database.query<User>('SELECT * FROM users')
+ *   const admins = await database.table('users').where('role', '=', 'admin').rows()
+ */
+import type { DatabaseAdapter, DatabaseConfig, DatabaseDialect, QueryResult, ExecuteResult, Transaction, MigrationConfig } from './types';
+import { QueryBuilder } from './query-builder';
+import { Migrator } from './migration';
+export declare class DatabaseManager {
+    private connections;
+    private configs;
+    private defaultName;
+    private migrator;
+    /**
+     * Add a named database connection.
+     * The first connection added becomes the default.
+     */
+    addConnection(config: DatabaseConfig, name?: string): this;
+    /**
+     * Connect all registered connections (or a specific named connection).
+     */
+    connect(name?: string): Promise<void>;
+    /**
+     * Disconnect all connections (or a specific named connection).
+     */
+    disconnect(name?: string): Promise<void>;
+    /**
+     * Execute a SELECT query on the default (or named) connection.
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[], connectionName?: string): Promise<QueryResult<T>>;
+    /**
+     * Execute an INSERT, UPDATE, or DELETE on the default (or named) connection.
+     */
+    execute(sql: string, params?: unknown[], connectionName?: string): Promise<ExecuteResult>;
+    /**
+     * Execute a series of operations within an atomic transaction.
+     */
+    transaction<T>(fn: (tx: Transaction) => Promise<T>, connectionName?: string): Promise<T>;
+    /**
+     * Start building a query for a table (chainable query builder).
+     */
+    table<T = Record<string, unknown>>(tableName: string, connectionName?: string): QueryBuilder<T>;
+    /**
+     * Check if a connection is healthy.
+     */
+    isHealthy(connectionName?: string): Promise<boolean>;
+    /**
+     * Check health of all connections.
+     */
+    healthCheck(): Promise<Record<string, boolean>>;
+    /**
+     * Get the raw adapter for a connection (for advanced use cases).
+     */
+    getAdapter(name?: string): DatabaseAdapter;
+    /**
+     * Get the raw underlying client for a connection.
+     */
+    getRawClient(name?: string): unknown;
+    /**
+     * Get the dialect of a connection.
+     */
+    getDialect(name?: string): DatabaseDialect;
+    /**
+     * Get the migration system for the default connection.
+     */
+    getMigrator(config?: MigrationConfig, connectionName?: string): Migrator;
+    private shutdownRegistered;
+    private registerShutdownHook;
+}
+/**
+ * Create a new DatabaseManager with the given configuration.
+ * This is the recommended way to set up a database connection.
+ *
+ * @example
+ * ```ts
+ * const db = createDatabase({
+ *   dialect: 'postgres',
+ *   url: process.env.DATABASE_URL,
+ * })
+ * await db.connect()
+ * ```
+ */
+export declare function createDatabase(config: DatabaseConfig): DatabaseManager;
+/**
+ * Lazy-initialized global database proxy.
+ * Forwards all calls to the default DatabaseManager.
+ *
+ * @example
+ * ```ts
+ * import { db } from 'exisjs/database'
+ *
+ * // After createDatabase() has been called elsewhere:
+ * const users = await db.query('SELECT * FROM users')
+ * ```
+ */
+export declare const db: DatabaseManager;
+/**
+ * Set or replace the default DatabaseManager.
+ */
+export declare function setDefaultDatabase(manager: DatabaseManager): void;
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/database/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EAChB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAkCtC,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,WAAW,CAAY;IAC/B,OAAO,CAAC,QAAQ,CAAwB;IAExC;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ1D;;OAEG;IACG,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3C;;OAEG;IACG,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9C;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAK1B;;OAEG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,CAAC;IAKzB;;OAEG;IACG,WAAW,CAAC,CAAC,EACjB,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACH,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,GACtB,YAAY,CAAC,CAAC,CAAC;IAKlB;;OAEG;IACG,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM1D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAYrD;;OAEG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe;IAW1C;;OAEG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe;IAI1C;;OAEG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ;IAUxE,OAAO,CAAC,kBAAkB,CAAQ;IAElC,OAAO,CAAC,oBAAoB;CAiB7B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAUtE;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,EAAE,EAAE,eAUf,CAAA;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEjE"}

package/dist/database/manager.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * Database Manager.
+ *
+ * The central orchestrator for all database connections. Manages named connections,
+ * provides lifecycle integration with the ExisJS app (auto-disconnect on shutdown),
+ * and exposes the query builder, raw query execution, and migration system.
+ *
+ * Usage:
+ *   import { db, createDatabase } from 'exisjs/database'
+ *
+ *   // Quick setup
+ *   const database = createDatabase({ dialect: 'postgres', url: process.env.DATABASE_URL })
+ *   await database.connect()
+ *
+ *   // Query
+ *   const users = await database.query<User>('SELECT * FROM users')
+ *   const admins = await database.table('users').where('role', '=', 'admin').rows()
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.db = exports.DatabaseManager = void 0;
+exports.createDatabase = createDatabase;
+exports.setDefaultDatabase = setDefaultDatabase;
+const query_builder_1 = require("./query-builder");
+const migration_1 = require("./migration");
+/**
+ * Create a database adapter for the given dialect.
+ */
+function createAdapter(config) {
+    switch (config.dialect) {
+        case 'postgres': {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { PostgresAdapter } = require('./adapters/postgres');
+            return new PostgresAdapter(config);
+        }
+        case 'mysql': {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { MysqlAdapter } = require('./adapters/mysql');
+            return new MysqlAdapter(config);
+        }
+        case 'sqlite': {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { SqliteAdapter } = require('./adapters/sqlite');
+            return new SqliteAdapter(config);
+        }
+        case 'mongodb': {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { MongodbAdapter } = require('./adapters/mongodb');
+            return new MongodbAdapter(config);
+        }
+        default:
+            throw new Error(`Unsupported database dialect: ${config.dialect}`);
+    }
+}
+class DatabaseManager {
+    constructor() {
+        this.connections = new Map();
+        this.configs = new Map();
+        this.defaultName = 'default';
+        this.migrator = null;
+        // ─── Private ───────────────────────────────────────────────────────────────
+        this.shutdownRegistered = false;
+    }
+    /**
+     * Add a named database connection.
+     * The first connection added becomes the default.
+     */
+    addConnection(config, name) {
+        const connName = name || this.defaultName;
+        const adapter = createAdapter(config);
+        this.connections.set(connName, adapter);
+        this.configs.set(connName, config);
+        return this;
+    }
+    /**
+     * Connect all registered connections (or a specific named connection).
+     */
+    async connect(name) {
+        if (name) {
+            const adapter = this.getAdapter(name);
+            await adapter.connect();
+            this.registerShutdownHook();
+            return;
+        }
+        const promises = [];
+        for (const [, adapter] of this.connections) {
+            promises.push(adapter.connect());
+        }
+        await Promise.all(promises);
+        this.registerShutdownHook();
+    }
+    /**
+     * Disconnect all connections (or a specific named connection).
+     */
+    async disconnect(name) {
+        if (name) {
+            const adapter = this.connections.get(name);
+            if (adapter) {
+                await adapter.disconnect();
+                this.connections.delete(name);
+                this.configs.delete(name);
+            }
+            return;
+        }
+        const promises = [];
+        for (const [, adapter] of this.connections) {
+            promises.push(adapter.disconnect());
+        }
+        await Promise.all(promises);
+        this.connections.clear();
+        this.configs.clear();
+    }
+    /**
+     * Execute a SELECT query on the default (or named) connection.
+     */
+    async query(sql, params, connectionName) {
+        const adapter = this.getAdapter(connectionName || this.defaultName);
+        return adapter.query(sql, params);
+    }
+    /**
+     * Execute an INSERT, UPDATE, or DELETE on the default (or named) connection.
+     */
+    async execute(sql, params, connectionName) {
+        const adapter = this.getAdapter(connectionName || this.defaultName);
+        return adapter.execute(sql, params);
+    }
+    /**
+     * Execute a series of operations within an atomic transaction.
+     */
+    async transaction(fn, connectionName) {
+        const adapter = this.getAdapter(connectionName || this.defaultName);
+        return adapter.transaction(fn);
+    }
+    /**
+     * Start building a query for a table (chainable query builder).
+     */
+    table(tableName, connectionName) {
+        const adapter = this.getAdapter(connectionName || this.defaultName);
+        return new query_builder_1.QueryBuilder(adapter, tableName);
+    }
+    /**
+     * Check if a connection is healthy.
+     */
+    async isHealthy(connectionName) {
+        const adapter = this.connections.get(connectionName || this.defaultName);
+        if (!adapter)
+            return false;
+        return adapter.isHealthy();
+    }
+    /**
+     * Check health of all connections.
+     */
+    async healthCheck() {
+        const results = {};
+        for (const [name, adapter] of this.connections) {
+            try {
+                results[name] = await adapter.isHealthy();
+            }
+            catch {
+                results[name] = false;
+            }
+        }
+        return results;
+    }
+    /**
+     * Get the raw adapter for a connection (for advanced use cases).
+     */
+    getAdapter(name) {
+        const connName = name || this.defaultName;
+        const adapter = this.connections.get(connName);
+        if (!adapter) {
+            throw new Error(`Database connection '${connName}' not found. Did you call addConnection() and connect()?`);
+        }
+        return adapter;
+    }
+    /**
+     * Get the raw underlying client for a connection.
+     */
+    getRawClient(name) {
+        return this.getAdapter(name).getRawClient();
+    }
+    /**
+     * Get the dialect of a connection.
+     */
+    getDialect(name) {
+        return this.getAdapter(name).dialect;
+    }
+    /**
+     * Get the migration system for the default connection.
+     */
+    getMigrator(config, connectionName) {
+        if (!this.migrator || connectionName) {
+            const adapter = this.getAdapter(connectionName || this.defaultName);
+            this.migrator = new migration_1.Migrator(adapter, config);
+        }
+        return this.migrator;
+    }
+    registerShutdownHook() {
+        if (this.shutdownRegistered)
+            return;
+        this.shutdownRegistered = true;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { getActiveApp } = require('../server/app');
+            const app = getActiveApp();
+            if (app && typeof app.onShutdown === 'function') {
+                app.onShutdown(async () => {
+                    await this.disconnect();
+                });
+            }
+        }
+        catch {
+            // Not in an app context — user must disconnect manually
+        }
+    }
+}
+exports.DatabaseManager = DatabaseManager;
+// ─── Factory & Singleton ─────────────────────────────────────────────────────
+let defaultManager = null;
+/**
+ * Create a new DatabaseManager with the given configuration.
+ * This is the recommended way to set up a database connection.
+ *
+ * @example
+ * ```ts
+ * const db = createDatabase({
+ *   dialect: 'postgres',
+ *   url: process.env.DATABASE_URL,
+ * })
+ * await db.connect()
+ * ```
+ */
+function createDatabase(config) {
+    const manager = new DatabaseManager();
+    manager.addConnection(config);
+    // Set as the global default if none exists
+    if (!defaultManager) {
+        defaultManager = manager;
+    }
+    return manager;
+}
+/**
+ * Lazy-initialized global database proxy.
+ * Forwards all calls to the default DatabaseManager.
+ *
+ * @example
+ * ```ts
+ * import { db } from 'exisjs/database'
+ *
+ * // After createDatabase() has been called elsewhere:
+ * const users = await db.query('SELECT * FROM users')
+ * ```
+ */
+exports.db = new Proxy({}, {
+    get(_target, prop) {
+        if (!defaultManager) {
+            throw new Error('No database has been configured. Call createDatabase() first.');
+        }
+        const value = defaultManager[prop];
+        return typeof value === 'function' ? value.bind(defaultManager) : value;
+    },
+});
+/**
+ * Set or replace the default DatabaseManager.
+ */
+function setDefaultDatabase(manager) {
+    defaultManager = manager;
+}
+//# sourceMappingURL=manager.js.map

package/dist/database/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/database/manager.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AA+PH,wCAUC;AA6BD,gDAEC;AA7RD,mDAA8C;AAC9C,2CAAsC;AAEtC;;GAEG;AACH,SAAS,aAAa,CAAC,MAAsB;IAC3C,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,iEAAiE;YACjE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;YAC1D,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAA;QACpC,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,iEAAiE;YACjE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;YACpD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAA;QACjC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,iEAAiE;YACjE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;YACtD,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAA;QAClC,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,iEAAiE;YACjE,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;YACxD,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;QACnC,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CACb,iCAAkC,MAAc,CAAC,OAAO,EAAE,CAC3D,CAAA;IACL,CAAC;AACH,CAAC;AAED,MAAa,eAAe;IAA5B;QACU,gBAAW,GAAG,IAAI,GAAG,EAA2B,CAAA;QAChD,YAAO,GAAG,IAAI,GAAG,EAA0B,CAAA;QAC3C,gBAAW,GAAG,SAAS,CAAA;QACvB,aAAQ,GAAoB,IAAI,CAAA;QAqKxC,8EAA8E;QAEtE,uBAAkB,GAAG,KAAK,CAAA;IAmBpC,CAAC;IAxLC;;;OAGG;IACH,aAAa,CAAC,MAAsB,EAAE,IAAa;QACjD,MAAM,QAAQ,GAAG,IAAI,IAAI,IAAI,CAAC,WAAW,CAAA;QACzC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;QACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAa;QACzB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;YACrC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;YACvB,IAAI,CAAC,oBAAoB,EAAE,CAAA;YAC3B,OAAM;QACR,CAAC;QAED,MAAM,QAAQ,GAAoB,EAAE,CAAA;QACpC,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QAClC,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC3B,IAAI,CAAC,oBAAoB,EAAE,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,IAAa;QAC5B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAC1C,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;gBAC1B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAC3B,CAAC;YACD,OAAM;QACR,CAAC;QAED,MAAM,QAAQ,GAAoB,EAAE,CAAA;QACpC,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;QACrC,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC3B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;QACxB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,GAAW,EACX,MAAkB,EAClB,cAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,IAAI,IAAI,CAAC,WAAW,CAAC,CAAA;QACnE,OAAO,OAAO,CAAC,KAAK,CAAI,GAAG,EAAE,MAAM,CAAC,CAAA;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,GAAW,EACX,MAAkB,EAClB,cAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,IAAI,IAAI,CAAC,WAAW,CAAC,CAAA;QACnE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,EAAmC,EACnC,cAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,IAAI,IAAI,CAAC,WAAW,CAAC,CAAA;QACnE,OAAO,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CACH,SAAiB,EACjB,cAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,IAAI,IAAI,CAAC,WAAW,CAAC,CAAA;QACnE,OAAO,IAAI,4BAAY,CAAI,OAAO,EAAE,SAAS,CAAC,CAAA;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,cAAuB;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,WAAW,CAAC,CAAA;QACxE,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAA;QAC1B,OAAO,OAAO,CAAC,SAAS,EAAE,CAAA;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAA4B,EAAE,CAAA;QAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;YAC3C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;YACvB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAa;QACtB,MAAM,QAAQ,GAAG,IAAI,IAAI,IAAI,CAAC,WAAW,CAAA;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,wBAAwB,QAAQ,0DAA0D,CAC3F,CAAA;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAa;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAa;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAA;IACtC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAwB,EAAE,cAAuB;QAC3D,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,cAAc,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,IAAI,IAAI,CAAC,WAAW,CAAC,CAAA;YACnE,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAMO,oBAAoB;QAC1B,IAAI,IAAI,CAAC,kBAAkB;YAAE,OAAM;QACnC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAA;QAE9B,IAAI,CAAC;YACH,iEAAiE;YACjE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;YACjD,MAAM,GAAG,GAAG,YAAY,EAAE,CAAA;YAC1B,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAChD,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;oBACxB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;gBACzB,CAAC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;IACH,CAAC;CACF;AA9LD,0CA8LC;AAED,gFAAgF;AAEhF,IAAI,cAAc,GAA2B,IAAI,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,SAAgB,cAAc,CAAC,MAAsB;IACnD,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAA;IACrC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAE7B,2CAA2C;IAC3C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,OAAO,CAAA;IAC1B,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACU,QAAA,EAAE,GAAoB,IAAI,KAAK,CAAC,EAAqB,EAAE;IAClE,GAAG,CAAC,OAAO,EAAE,IAAI;QACf,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAA;QACH,CAAC;QACD,MAAM,KAAK,GAAI,cAAsB,CAAC,IAAI,CAAC,CAAA;QAC3C,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACzE,CAAC;CACF,CAAC,CAAA;AAEF;;GAEG;AACH,SAAgB,kBAAkB,CAAC,OAAwB;IACzD,cAAc,GAAG,OAAO,CAAA;AAC1B,CAAC"}

package/dist/database/migration.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Built-in Migration System.
+ *
+ * Tracks applied migrations in a `_exis_migrations` table and provides
+ * up/down/status operations. Migrations are ordered by filename and
+ * applied in batches for clean rollbacks.
+ *
+ * Usage:
+ *   const migrator = new Migrator(adapter, { directory: './migrations' })
+ *   await migrator.up()       // Apply all pending migrations
+ *   await migrator.down()     // Rollback the last batch
+ *   await migrator.status()   // Get migration status
+ */
+import type { DatabaseAdapter, MigrationConfig } from './types';
+export declare class Migrator {
+    private adapter;
+    private config;
+    constructor(adapter: DatabaseAdapter, config?: MigrationConfig);
+    /**
+     * Ensure the migrations tracking table exists.
+     */
+    ensureTable(): Promise<void>;
+    /**
+     * Apply all pending migrations.
+     * @returns The names of the migrations that were applied.
+     */
+    up(): Promise<string[]>;
+    /**
+     * Rollback the last batch of migrations.
+     * @returns The names of the migrations that were rolled back.
+     */
+    down(): Promise<string[]>;
+    /**
+     * Rollback all migrations.
+     */
+    reset(): Promise<string[]>;
+    /**
+     * Get the status of all migrations.
+     */
+    status(): Promise<{
+        name: string;
+        applied: boolean;
+        batch?: number;
+        appliedAt?: Date;
+    }[]>;
+    /**
+     * Create a new migration file in the migrations directory.
+     */
+    create(name: string): Promise<string>;
+    private loadMigrations;
+    private getApplied;
+    private getAppliedRecords;
+    private getNextBatch;
+    private getLastBatch;
+    private getMigrationsInBatch;
+}
+//# sourceMappingURL=migration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/database/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAGhB,MAAM,SAAS,CAAA;AAIhB,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAA2B;gBAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,eAAe;IAQ9D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BlC;;;OAGG;IACG,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAwC7B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA6C/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAahC;;OAEG;IACG,MAAM,IAAI,OAAO,CACrB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,IAAI,CAAA;KAAE,EAAE,CACvE;IAkBD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAoC7B,cAAc;YA8Cd,UAAU;YAKV,iBAAiB;YAwBjB,YAAY;YAIZ,YAAY;YAmBZ,oBAAoB;CA0BnC"}