exisjs 0.5.10 → 0.5.12

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

package/dist/database/migration.js.map

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

package/dist/database/query-builder.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Chainable SQL Query Builder.
+ *
+ * Generates dialect-specific SQL with parameterized queries.
+ * Supports select, insert, update, delete, joins, where, orderBy, limit, offset,
+ * groupBy, and having.
+ *
+ * Uses PostgreSQL-style $1, $2 placeholders by default.
+ * MySQL mode uses ? placeholders.
+ */
+import type { DatabaseAdapter, WhereOperator, OrderDirection, JoinType, QueryResult, ExecuteResult } from './types';
+export declare class QueryBuilder<T = Record<string, unknown>> {
+    private adapter;
+    private dialect;
+    private tableName;
+    private operation;
+    private selectColumns;
+    private whereClauses;
+    private joinClauses;
+    private orderByClauses;
+    private groupByColumns;
+    private havingClauses;
+    private limitValue?;
+    private offsetValue?;
+    private insertData?;
+    private updateData?;
+    private returningColumns?;
+    private distinctFlag;
+    private params;
+    constructor(adapter: DatabaseAdapter, table: string);
+    select(...columns: string[]): this;
+    distinct(): this;
+    where(column: string, operator: WhereOperator, value: unknown): this;
+    orWhere(column: string, operator: WhereOperator, value: unknown): this;
+    whereNull(column: string): this;
+    whereNotNull(column: string): this;
+    whereIn(column: string, values: unknown[]): this;
+    whereBetween(column: string, min: unknown, max: unknown): this;
+    join(table: string, on: string, type?: JoinType): this;
+    leftJoin(table: string, on: string): this;
+    rightJoin(table: string, on: string): this;
+    fullJoin(table: string, on: string): this;
+    orderBy(column: string, direction?: OrderDirection): this;
+    groupBy(...columns: string[]): this;
+    having(column: string, operator: WhereOperator, value: unknown): this;
+    limit(count: number): this;
+    offset(count: number): this;
+    insert(data: Record<string, unknown> | Record<string, unknown>[]): this;
+    update(data: Record<string, unknown>): this;
+    delete(): this;
+    returning(...columns: string[]): this;
+    execute(): Promise<QueryResult<T> | ExecuteResult>;
+    /**
+     * Execute and return just the rows (convenience method for SELECT).
+     */
+    rows(): Promise<T[]>;
+    /**
+     * Execute and return the first row (convenience method for SELECT ... LIMIT 1).
+     */
+    first(): Promise<T | null>;
+    /**
+     * Execute and return the count of matching rows.
+     */
+    count(column?: string): Promise<number>;
+    /**
+     * Build the SQL string and parameters without executing.
+     */
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    private buildSelect;
+    private buildInsert;
+    private buildUpdate;
+    private buildDelete;
+    private buildJoins;
+    private buildWhere;
+    private buildGroupBy;
+    private buildHaving;
+    private buildOrderBy;
+    private buildLimit;
+    /**
+     * Generate the next placeholder for the current dialect.
+     * PostgreSQL: $1, $2, $3...
+     * MySQL/SQLite: ?, ?, ?...
+     */
+    private placeholder;
+}
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/database/query-builder.d.ts.map

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