exisjs 0.5.9 → 0.5.11

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":"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"}

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"}

package/dist/database/migration.js

@@ -0,0 +1,329 @@
+"use strict";
+/**
+ * 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
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Migrator = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const DEFAULT_TABLE = '_exis_migrations';
+class Migrator {
+    constructor(adapter, config) {
+        this.adapter = adapter;
+        this.config = {
+            directory: config?.directory || './migrations',
+            tableName: config?.tableName || DEFAULT_TABLE,
+        };
+    }
+    /**
+     * Ensure the migrations tracking table exists.
+     */
+    async ensureTable() {
+        const { tableName } = this.config;
+        const dialect = this.adapter.dialect;
+        if (dialect === 'mongodb') {
+            // MongoDB doesn't need a schema — we just use a collection
+            return;
+        }
+        const createSQL = dialect === 'sqlite'
+            ? `CREATE TABLE IF NOT EXISTS ${tableName} (
+            name TEXT PRIMARY KEY,
+            batch INTEGER NOT NULL,
+            applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+          )`
+            : dialect === 'mysql'
+                ? `CREATE TABLE IF NOT EXISTS ${tableName} (
+              name VARCHAR(255) PRIMARY KEY,
+              batch INT NOT NULL,
+              applied_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
+            )`
+                : `CREATE TABLE IF NOT EXISTS ${tableName} (
+              name VARCHAR(255) PRIMARY KEY,
+              batch INT NOT NULL,
+              applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+            )`;
+        await this.adapter.execute(createSQL);
+    }
+    /**
+     * Apply all pending migrations.
+     * @returns The names of the migrations that were applied.
+     */
+    async up() {
+        await this.ensureTable();
+        const applied = await this.getApplied();
+        const allMigrations = await this.loadMigrations();
+        const pending = allMigrations.filter((m) => !applied.has(m.name));
+        if (pending.length === 0) {
+            return [];
+        }
+        const batch = await this.getNextBatch();
+        const appliedNames = [];
+        for (const migration of pending) {
+            await this.adapter.transaction(async (tx) => {
+                // Run the migration
+                await migration.up(this.adapter);
+                // Record it
+                if (this.adapter.dialect === 'mongodb') {
+                    await this.adapter.execute('_exis_migrations.insertOne', [
+                        { name: migration.name, batch, applied_at: new Date() },
+                    ]);
+                }
+                else {
+                    const placeholder = this.adapter.dialect === 'postgres' ? '$1' : '?';
+                    const placeholder2 = this.adapter.dialect === 'postgres' ? '$2' : '?';
+                    await tx.execute(`INSERT INTO ${this.config.tableName} (name, batch) VALUES (${placeholder}, ${placeholder2})`, [migration.name, batch]);
+                }
+            });
+            appliedNames.push(migration.name);
+        }
+        return appliedNames;
+    }
+    /**
+     * Rollback the last batch of migrations.
+     * @returns The names of the migrations that were rolled back.
+     */
+    async down() {
+        await this.ensureTable();
+        const lastBatch = await this.getLastBatch();
+        if (lastBatch === 0) {
+            return [];
+        }
+        const batchMigrations = await this.getMigrationsInBatch(lastBatch);
+        const allMigrations = await this.loadMigrations();
+        const migrationMap = new Map(allMigrations.map((m) => [m.name, m]));
+        const rolledBack = [];
+        // Rollback in reverse order
+        for (const record of batchMigrations.reverse()) {
+            const migration = migrationMap.get(record.name);
+            if (!migration) {
+                throw new Error(`Migration file for '${record.name}' not found. Cannot rollback.`);
+            }
+            await this.adapter.transaction(async (tx) => {
+                await migration.down(this.adapter);
+                if (this.adapter.dialect === 'mongodb') {
+                    await this.adapter.execute('_exis_migrations.deleteOne', [
+                        { name: record.name },
+                    ]);
+                }
+                else {
+                    const placeholder = this.adapter.dialect === 'postgres' ? '$1' : '?';
+                    await tx.execute(`DELETE FROM ${this.config.tableName} WHERE name = ${placeholder}`, [record.name]);
+                }
+            });
+            rolledBack.push(record.name);
+        }
+        return rolledBack;
+    }
+    /**
+     * Rollback all migrations.
+     */
+    async reset() {
+        const rolledBack = [];
+        let batch = await this.getLastBatch();
+        while (batch > 0) {
+            const names = await this.down();
+            rolledBack.push(...names);
+            batch = await this.getLastBatch();
+        }
+        return rolledBack;
+    }
+    /**
+     * Get the status of all migrations.
+     */
+    async status() {
+        await this.ensureTable();
+        const applied = await this.getAppliedRecords();
+        const allMigrations = await this.loadMigrations();
+        const appliedMap = new Map(applied.map((r) => [r.name, r]));
+        return allMigrations.map((m) => {
+            const record = appliedMap.get(m.name);
+            return {
+                name: m.name,
+                applied: !!record,
+                batch: record?.batch,
+                appliedAt: record?.appliedAt,
+            };
+        });
+    }
+    /**
+     * Create a new migration file in the migrations directory.
+     */
+    async create(name) {
+        const { mkdir, writeFile } = await Promise.resolve().then(() => __importStar(require('node:fs/promises')));
+        const dir = (0, node_path_1.resolve)(this.config.directory);
+        await mkdir(dir, { recursive: true });
+        const timestamp = new Date()
+            .toISOString()
+            .replace(/[-:T]/g, '')
+            .slice(0, 14);
+        const filename = `${timestamp}_${name}.ts`;
+        const filepath = (0, node_path_1.resolve)(dir, filename);
+        const template = `import type { DatabaseAdapter } from 'exisjs/database'
+
+export default {
+  name: '${timestamp}_${name}',
+
+  async up(db: DatabaseAdapter): Promise<void> {
+    // Write your migration here
+    // await db.execute('CREATE TABLE ...')
+  },
+
+  async down(db: DatabaseAdapter): Promise<void> {
+    // Write the rollback here
+    // await db.execute('DROP TABLE ...')
+  },
+}
+`;
+        await writeFile(filepath, template, 'utf-8');
+        return filepath;
+    }
+    // ─── Private Helpers ───────────────────────────────────────────────────────
+    async loadMigrations() {
+        const dir = (0, node_path_1.resolve)(this.config.directory);
+        let files;
+        try {
+            files = await (0, promises_1.readdir)(dir);
+        }
+        catch {
+            return [];
+        }
+        const migrationFiles = files
+            .filter((f) => {
+            const ext = (0, node_path_1.extname)(f);
+            return ext === '.ts' || ext === '.js' || ext === '.mjs';
+        })
+            .sort();
+        const migrations = [];
+        for (const file of migrationFiles) {
+            const filepath = (0, node_path_1.resolve)(dir, file);
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const mod = require(filepath);
+                const migration = mod.default || mod;
+                if (migration &&
+                    typeof migration.up === 'function' &&
+                    typeof migration.down === 'function') {
+                    migrations.push({
+                        name: migration.name || (0, node_path_1.basename)(file, (0, node_path_1.extname)(file)),
+                        up: migration.up,
+                        down: migration.down,
+                    });
+                }
+            }
+            catch (err) {
+                throw new Error(`Failed to load migration '${file}': ${err.message}`, {
+                    cause: err,
+                });
+            }
+        }
+        return migrations;
+    }
+    async getApplied() {
+        const records = await this.getAppliedRecords();
+        return new Set(records.map((r) => r.name));
+    }
+    async getAppliedRecords() {
+        if (this.adapter.dialect === 'mongodb') {
+            const result = await this.adapter.query('_exis_migrations', [{}]);
+            return result.rows.map((r) => ({
+                name: r.name,
+                batch: r.batch,
+                appliedAt: new Date(r.applied_at),
+            }));
+        }
+        try {
+            const result = await this.adapter.query(`SELECT name, batch, applied_at FROM ${this.config.tableName} ORDER BY name`);
+            return result.rows.map((r) => ({
+                name: r.name,
+                batch: r.batch,
+                appliedAt: new Date(r.applied_at),
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    async getNextBatch() {
+        return (await this.getLastBatch()) + 1;
+    }
+    async getLastBatch() {
+        if (this.adapter.dialect === 'mongodb') {
+            const result = await this.adapter.query('_exis_migrations', [
+                {},
+                { sort: { batch: -1 }, limit: 1 },
+            ]);
+            return result.rows[0]?.batch ?? 0;
+        }
+        try {
+            const result = await this.adapter.query(`SELECT MAX(batch) as max_batch FROM ${this.config.tableName}`);
+            return result.rows[0]?.max_batch ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    async getMigrationsInBatch(batch) {
+        if (this.adapter.dialect === 'mongodb') {
+            const result = await this.adapter.query('_exis_migrations', [
+                { batch },
+            ]);
+            return result.rows.map((r) => ({
+                name: r.name,
+                batch: r.batch,
+                appliedAt: new Date(r.applied_at),
+            }));
+        }
+        const placeholder = this.adapter.dialect === 'postgres' ? '$1' : '?';
+        const result = await this.adapter.query(`SELECT name, batch, applied_at FROM ${this.config.tableName} WHERE batch = ${placeholder} ORDER BY name`, [batch]);
+        return result.rows.map((r) => ({
+            name: r.name,
+            batch: r.batch,
+            appliedAt: new Date(r.applied_at),
+        }));
+    }
+}
+exports.Migrator = Migrator;
+//# sourceMappingURL=migration.js.map