typhex 0.1.0-alpha.0

package/dist/migration/generator.js

@@ -0,0 +1,98 @@
+/**
+ * Migration generator: takes DiffActions, groups them by table, orders them
+ * topologically, and writes timestamped .js files with up() and down() functions.
+ * Uses the dialect migrator for diff and the query compiler for SQL generation.
+ */
+import { writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { parseFkDependencies, topoSort } from "./topo-sort.js";
+import { groupBy } from "../utils.js";
+function timestamp() {
+    const d = new Date();
+    const pad = (n, len = 2) => String(n).padStart(len, "0");
+    return (`${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}` +
+        `${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`);
+}
+function slugify(s) {
+    return s.replace(/[^a-z0-9]+/gi, "_").toLowerCase();
+}
+function scriptName(ts, seq, action) {
+    const seqStr = String(seq).padStart(2, "0");
+    const base = `${ts}${seqStr}`;
+    switch (action.kind) {
+        case "add_table":
+            return `${base}_add_${slugify(action.table)}_table`;
+        case "drop_table":
+            return `${base}_drop_${slugify(action.table)}_table`;
+        case "add_column":
+            return `${base}_add_${slugify(action.column)}_column_on_${slugify(action.table)}`;
+        case "drop_column":
+            return `${base}_drop_${slugify(action.column)}_column_on_${slugify(action.table)}`;
+        case "alter_column":
+            return `${base}_alter_${slugify(action.column)}_column_on_${slugify(action.table)}`;
+    }
+}
+function escapeTemplateLiteralContent(value) {
+    return value.replaceAll("`", "\\`").replaceAll("${", "\\${");
+}
+function renderMigrationFile(upSql, downSql) {
+    return `export const upSql = \`${escapeTemplateLiteralContent(upSql)}\`;
+
+export const downSql = \`${escapeTemplateLiteralContent(downSql)}\`;
+
+export async function up(db) {
+  await db.run(upSql);
+}
+
+export async function down(db) {
+  await db.run(downSql);
+}
+`;
+}
+function groupByTable(actions) {
+    return [...groupBy(actions, (a) => a.table)].map(([table, actions]) => ({ table, actions }));
+}
+/** Generates SQL migration files from entity definitions compared to the live database schema. */
+export async function generateMigrationFiles(driver, entities) {
+    const resolvedDriver = driver;
+    const compiler = resolvedDriver.dialect.queryCompiler;
+    const actions = await resolvedDriver.dialect.migrator.diffSchema(resolvedDriver, entities);
+    if (actions.length === 0)
+        return [];
+    const groups = groupByTable(actions);
+    const deps = parseFkDependencies(entities);
+    const allTables = groups.map((g) => g.table);
+    const sorted = topoSort(allTables, deps);
+    const sortedGroups = sorted
+        .map((t) => groups.find((g) => g.table === t))
+        .filter((g) => g != null);
+    const ts = timestamp();
+    const files = [];
+    let seq = 1;
+    for (const group of sortedGroups) {
+        for (const action of group.actions) {
+            const upSql = compiler.compileMigrationUp(action);
+            const downSql = compiler.compileMigrationDown(action);
+            files.push({
+                name: scriptName(ts, seq, action),
+                upSql,
+                downSql,
+                content: renderMigrationFile(upSql, downSql),
+            });
+            seq++;
+        }
+    }
+    return files;
+}
+export function writeMigrationFiles(dir, files) {
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const paths = [];
+    for (const f of files) {
+        const filePath = join(dir, `${f.name}.js`);
+        writeFileSync(filePath, f.content, "utf-8");
+        paths.push(filePath);
+    }
+    return paths;
+}
+//# sourceMappingURL=generator.js.map

package/dist/migration/generator.js.map

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

package/dist/migration/index.d.ts

@@ -0,0 +1,7 @@
+export { diffSchema } from "./diff.js";
+export { generateMigrationFiles, writeMigrationFiles } from "./generator.js";
+export { runMigrations, migrationStatus, appliedMigrations, pendingMigrations, dryRunMigrations, upMigration, downMigration, } from "./runner.js";
+export type { MigrationResult } from "./runner.js";
+export { parseFkDependencies, topoSort } from "./topo-sort.js";
+export type { DiffAction, DialectName, MigrationFile, MigrationRecord, MigrationConfig, PendingMigration, MigrationDryRun, MigrationDb, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/migration/index.js

@@ -0,0 +1,5 @@
+export { diffSchema } from "./diff.js";
+export { generateMigrationFiles, writeMigrationFiles } from "./generator.js";
+export { runMigrations, migrationStatus, appliedMigrations, pendingMigrations, dryRunMigrations, upMigration, downMigration, } from "./runner.js";
+export { parseFkDependencies, topoSort } from "./topo-sort.js";
+//# sourceMappingURL=index.js.map

package/dist/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/migration/runner.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Migration runner: discovers .js/.mjs migration files, skips already-applied ones,
+ * executes pending ones in filename order by calling their exported up(db) function,
+ * and records each in the _typhex_migrations tracking table.
+ * downMigration calls the exported down(db) function and removes the tracking record.
+ */
+import type { Driver } from "../driver/types.js";
+import type { MigrationRecord, PendingMigration } from "./types.js";
+/** Result returned by `runMigrations`: lists of applied and skipped migration file names. */
+export interface MigrationResult {
+    /** Names of migration files that were applied in this run. */
+    applied: string[];
+    /** Names of migration files that were already applied and skipped. */
+    skipped: string[];
+}
+/** Applies all pending migration files from `dir` in chronological order. */
+export declare function runMigrations(driver: Driver, dir: string): Promise<MigrationResult>;
+/** Returns which migration files have been applied and which are pending. */
+export declare function migrationStatus(driver: Driver, dir: string): Promise<{
+    applied: MigrationRecord[];
+    pending: string[];
+}>;
+export declare function appliedMigrations(driver: Driver): Promise<MigrationRecord[]>;
+export declare function pendingMigrations(driver: Driver, dir: string): Promise<PendingMigration[]>;
+export declare function dryRunMigrations(driver: Driver, dir: string): Promise<{
+    applied: MigrationRecord[];
+    pending: PendingMigration[];
+    skipped: string[];
+}>;
+export declare function upMigration(driver: Driver, dir: string, name: string): Promise<void>;
+export declare function downMigration(driver: Driver, dir: string, name: string): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/migration/runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAe,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgLjF,6FAA6F;AAC7F,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,6EAA6E;AAC7E,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAyBzF;AAED,6EAA6E;AAC7E,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAO5D;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAElF;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAKhG;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgBzF;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1F;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F"}

package/dist/migration/runner.js

@@ -0,0 +1,279 @@
+/**
+ * Migration runner: discovers .js/.mjs migration files, skips already-applied ones,
+ * executes pending ones in filename order by calling their exported up(db) function,
+ * and records each in the _typhex_migrations tracking table.
+ * downMigration calls the exported down(db) function and removes the tracking record.
+ */
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import * as acorn from "acorn";
+function asResolvedDriver(driver) {
+    return driver;
+}
+class ConnectionMigrationDb {
+    conn;
+    constructor(conn) {
+        this.conn = conn;
+    }
+    async run(sql, params = []) {
+        if (params.length > 0) {
+            await this.conn.execute(sql, params);
+            return;
+        }
+        for (const statement of splitSqlStatements(sql)) {
+            await this.conn.execute(statement, []);
+        }
+    }
+}
+async function ensureTrackingTable(driver) {
+    const compiled = asResolvedDriver(driver).dialect.queryCompiler.compileTrackingTable();
+    await driver.execute(compiled.sql, compiled.params);
+}
+async function getAppliedRows(driver) {
+    await ensureTrackingTable(driver);
+    const compiled = asResolvedDriver(driver).dialect.queryCompiler.compileAppliedMigrations();
+    const rows = await driver.execute(compiled.sql, compiled.params).then((r) => r.rows);
+    return rows;
+}
+async function getAppliedNames(driver) {
+    const rows = await getAppliedRows(driver);
+    return new Set(rows.map((r) => r.name));
+}
+function listMigrationFiles(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir).sort();
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const seen = new Set();
+    const files = [];
+    for (const file of entries) {
+        if (!file.endsWith(".js") && !file.endsWith(".mjs"))
+            continue;
+        const name = stripExtension(file);
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        files.push(file);
+    }
+    return files;
+}
+function stripExtension(file) {
+    return file.replace(/\.(m?js)$/, "");
+}
+async function loadModule(dir, file) {
+    const url = pathToFileURL(join(dir, file)).href;
+    return import(url);
+}
+function readMigrationSql(dir, file) {
+    const source = readFileSync(join(dir, file), "utf-8");
+    const ast = acorn.parse(source, {
+        ecmaVersion: "latest",
+        sourceType: "module",
+    });
+    const values = new Map();
+    for (const node of ast.body) {
+        if (!isRecord(node) || node.type !== "ExportNamedDeclaration")
+            continue;
+        const declaration = node.declaration;
+        if (!isRecord(declaration) || declaration.type !== "VariableDeclaration")
+            continue;
+        if (!Array.isArray(declaration.declarations))
+            continue;
+        for (const declarator of declaration.declarations) {
+            if (!isRecord(declarator))
+                continue;
+            const name = identifierName(declarator.id);
+            if (name !== "upSql" && name !== "downSql")
+                continue;
+            values.set(name, readStaticStringExport(file, name, declarator.init));
+        }
+    }
+    const upSql = values.get("upSql");
+    const downSql = values.get("downSql");
+    if (upSql == null || downSql == null) {
+        throw new Error(`Migration "${file}" must export static string upSql and downSql values.`);
+    }
+    return { upSql, downSql };
+}
+function identifierName(node) {
+    if (!isRecord(node) || node.type !== "Identifier" || typeof node.name !== "string") {
+        return null;
+    }
+    return node.name;
+}
+function readStaticStringExport(file, name, node) {
+    if (isRecord(node) && node.type === "Literal" && typeof node.value === "string")
+        return node.value;
+    if (isRecord(node) && node.type === "TemplateLiteral") {
+        const expressions = node.expressions;
+        const quasis = node.quasis;
+        if (Array.isArray(expressions) &&
+            expressions.length === 0 &&
+            Array.isArray(quasis) &&
+            quasis.length === 1) {
+            const quasi = quasis[0];
+            if (isRecord(quasi) && isRecord(quasi.value) && typeof quasi.value.cooked === "string") {
+                return quasi.value.cooked;
+            }
+        }
+    }
+    throw new Error(`Migration "${file}" export "${name}" must be a static string literal.`);
+}
+function isRecord(value) {
+    return value != null && typeof value === "object";
+}
+function buildPendingMigration(dir, file) {
+    const { upSql, downSql } = readMigrationSql(dir, file);
+    return {
+        name: stripExtension(file),
+        file,
+        upSql,
+        downSql,
+        statements: splitSqlStatements(upSql),
+        downStatements: splitSqlStatements(downSql),
+    };
+}
+async function withConnection(driver, fn) {
+    const conn = await driver.connect();
+    try {
+        return await fn(conn);
+    }
+    finally {
+        await conn.release();
+    }
+}
+async function withTransaction(conn, fn) {
+    const db = new ConnectionMigrationDb(conn);
+    await conn.execute("BEGIN", []);
+    try {
+        const result = await fn(db);
+        await conn.execute("COMMIT", []);
+        return result;
+    }
+    catch (e) {
+        try {
+            await conn.execute("ROLLBACK", []);
+        }
+        catch {
+            /* ignore */
+        }
+        throw e;
+    }
+}
+/** Applies all pending migration files from `dir` in chronological order. */
+export async function runMigrations(driver, dir) {
+    const applied = await getAppliedNames(driver);
+    const files = listMigrationFiles(dir);
+    const compiler = asResolvedDriver(driver).dialect.queryCompiler;
+    const result = { applied: [], skipped: [] };
+    await withConnection(driver, (conn) => withTransaction(conn, async (db) => {
+        for (const file of files) {
+            const name = stripExtension(file);
+            if (applied.has(name)) {
+                result.skipped.push(name);
+                continue;
+            }
+            const mod = await loadModule(dir, file);
+            await mod.up(db);
+            const record = compiler.compileRecordMigration(name);
+            await conn.execute(record.sql, record.params);
+            applied.add(name);
+            result.applied.push(name);
+        }
+    }));
+    return result;
+}
+/** Returns which migration files have been applied and which are pending. */
+export async function migrationStatus(driver, dir) {
+    const appliedRows = await getAppliedRows(driver);
+    const appliedNames = new Set(appliedRows.map((r) => r.name));
+    const pending = listMigrationFiles(dir)
+        .map(stripExtension)
+        .filter((n) => !appliedNames.has(n));
+    return { applied: appliedRows, pending };
+}
+export async function appliedMigrations(driver) {
+    return getAppliedRows(driver);
+}
+export async function pendingMigrations(driver, dir) {
+    const appliedNames = await getAppliedNames(driver);
+    return listMigrationFiles(dir)
+        .filter((file) => !appliedNames.has(stripExtension(file)))
+        .map((file) => buildPendingMigration(dir, file));
+}
+export async function dryRunMigrations(driver, dir) {
+    const applied = await getAppliedRows(driver);
+    const appliedNames = new Set(applied.map((r) => r.name));
+    const pending = [];
+    const skipped = [];
+    for (const file of listMigrationFiles(dir)) {
+        const name = stripExtension(file);
+        if (appliedNames.has(name)) {
+            skipped.push(name);
+        }
+        else {
+            pending.push(buildPendingMigration(dir, file));
+        }
+    }
+    return { applied, pending, skipped };
+}
+export async function upMigration(driver, dir, name) {
+    await runSingleMigration(driver, dir, name, "up");
+}
+export async function downMigration(driver, dir, name) {
+    await runSingleMigration(driver, dir, name, "down");
+}
+async function runSingleMigration(driver, dir, name, direction) {
+    const applied = await getAppliedNames(driver);
+    const isApplied = applied.has(name);
+    if (direction === "up" && isApplied) {
+        throw new Error(`Migration "${name}" is already applied.`);
+    }
+    if (direction === "down" && !isApplied) {
+        throw new Error(`Migration "${name}" is not applied.`);
+    }
+    const file = findMigrationFile(dir, name);
+    if (!file) {
+        throw new Error(`Migration file for "${name}" not found in "${dir}".`);
+    }
+    const mod = await loadModule(dir, file);
+    const compiler = asResolvedDriver(driver).dialect.queryCompiler;
+    const tracking = direction === "up"
+        ? compiler.compileRecordMigration(name)
+        : compiler.compileDeleteMigration(name);
+    await withConnection(driver, (conn) => withTransaction(conn, async (db) => {
+        await mod[direction](db);
+        await conn.execute(tracking.sql, tracking.params);
+    }));
+}
+function findMigrationFile(dir, name) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    for (const ext of [".js", ".mjs"]) {
+        const file = `${name}${ext}`;
+        if (entries.includes(file))
+            return file;
+    }
+    return null;
+}
+function splitSqlStatements(sql) {
+    return sql
+        .split(";")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0 && !isCommentOnlySql(s));
+}
+function isCommentOnlySql(sql) {
+    return sql.split("\n").every((line) => line.trim() === "" || line.trim().startsWith("--"));
+}
+//# sourceMappingURL=runner.js.map

package/dist/migration/runner.js.map

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

package/dist/migration/topo-sort.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Topological sort for table creation order based on FK references.
+ * Parses "references <table>(...)" from column definitions.
+ */
+export declare function parseFkDependencies(entities: ReadonlyArray<{
+    table: {
+        _table: string;
+        _schema: Record<string, string>;
+    };
+}>): Map<string, string[]>;
+export declare function topoSort(names: string[], deps: Map<string, string[]>): string[];
+//# sourceMappingURL=topo-sort.d.ts.map

package/dist/migration/topo-sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo-sort.d.ts","sourceRoot":"","sources":["../../src/migration/topo-sort.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,CAAC,GACtF,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAWvB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAsB/E"}

package/dist/migration/topo-sort.js

@@ -0,0 +1,42 @@
+/**
+ * Topological sort for table creation order based on FK references.
+ * Parses "references <table>(...)" from column definitions.
+ */
+export function parseFkDependencies(entities) {
+    const deps = new Map();
+    for (const e of entities) {
+        const refs = [];
+        for (const def of Object.values(e.table._schema)) {
+            const match = def.match(/references\s+"?(\w+)"?/i);
+            if (match && match[1] !== e.table._table)
+                refs.push(match[1]);
+        }
+        deps.set(e.table._table, refs);
+    }
+    return deps;
+}
+export function topoSort(names, deps) {
+    const visited = new Set();
+    const visiting = new Set();
+    const result = [];
+    const nameSet = new Set(names);
+    function visit(name) {
+        if (visited.has(name))
+            return;
+        if (visiting.has(name)) {
+            throw new Error(`Circular FK dependency detected involving table "${name}"`);
+        }
+        visiting.add(name);
+        for (const dep of deps.get(name) ?? []) {
+            if (nameSet.has(dep))
+                visit(dep);
+        }
+        visiting.delete(name);
+        visited.add(name);
+        result.push(name);
+    }
+    for (const name of names)
+        visit(name);
+    return result;
+}
+//# sourceMappingURL=topo-sort.js.map

package/dist/migration/topo-sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo-sort.js","sourceRoot":"","sources":["../../src/migration/topo-sort.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,mBAAmB,CACjC,QAAuF;IAEvF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACnD,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAe,EAAE,IAA2B;IACnE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAE/B,SAAS,KAAK,CAAC,IAAY;QACzB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC9B,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oDAAoD,IAAI,GAAG,CAAC,CAAC;QAC/E,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/migration/types.d.ts

@@ -0,0 +1,45 @@
+import type { Driver } from "../driver/types.js";
+import type { DialectName, DiffAction, DbColumnInfo } from "../dbs/types.js";
+export type { DialectName, DiffAction, DbColumnInfo };
+/** Minimal DB handle passed into up(db) and down(db) migration functions. */
+export interface MigrationDb {
+    run(sql: string, params?: unknown[]): Promise<void>;
+}
+/** A generated migration file: name, SQL content, and rendered module. */
+export interface MigrationFile {
+    /** File name (without extension). */
+    name: string;
+    /** SQL statements to apply this migration. */
+    upSql: string;
+    /** SQL statements to roll back this migration. */
+    downSql: string;
+    /** Rendered JavaScript migration module content. */
+    content: string;
+}
+/** A row from the `_typhex_migrations` tracking table. */
+export interface MigrationRecord {
+    /** Auto-incrementing row ID. */
+    id: number;
+    /** Migration file name (without extension). */
+    name: string;
+    /** ISO timestamp when this migration was applied. */
+    applied_at: string;
+}
+export interface PendingMigration {
+    name: string;
+    file: string;
+    upSql: string;
+    downSql: string;
+    statements: string[];
+    downStatements: string[];
+}
+export interface MigrationDryRun {
+    applied: MigrationRecord[];
+    pending: PendingMigration[];
+    skipped: string[];
+}
+export interface MigrationConfig {
+    dir: string;
+    driver: Driver;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/migration/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE7E,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AAEtD,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/migration/types.js

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

package/dist/migration/types.js.map

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

package/dist/orm/aggregates.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Aggregate function stubs for use inside .select() and .having() lambdas.
+ * These are never executed at runtime — the TypeScript transformer replaces them
+ * at compile time, and the runtime parser reads source text via acorn.
+ * Calling them directly outside a lambda throws a clear error.
+ */
+/** Returns the count of rows matching the query. Use inside `.select()` or `.having()` lambdas. */
+export declare function count(_field?: unknown): number;
+/** Returns the sum of the given numeric field. Use inside `.select()` or `.having()` lambdas. */
+export declare function sum(_field: number): number;
+/** Returns the average of the given numeric field. Use inside `.select()` or `.having()` lambdas. */
+export declare function avg(_field: number): number;
+/** Returns the minimum value of the given field. Use inside `.select()` or `.having()` lambdas. */
+export declare function min<T>(_field: T): T;
+/** Returns the maximum value of the given field. Use inside `.select()` or `.having()` lambdas. */
+export declare function max<T>(_field: T): T;
+/** Marks a field as DISTINCT inside an aggregate: count(distinct(p.category)). */
+export declare function distinct<T>(_field: T): T;
+//# sourceMappingURL=aggregates.d.ts.map

package/dist/orm/aggregates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregates.d.ts","sourceRoot":"","sources":["../../src/orm/aggregates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,mGAAmG;AACnG,wBAAgB,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAE9C;AAED,iGAAiG;AACjG,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,qGAAqG;AACrG,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,mGAAmG;AACnG,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEnC;AAED,mGAAmG;AACnG,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEnC;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAExC"}

package/dist/orm/aggregates.js

@@ -0,0 +1,32 @@
+/**
+ * Aggregate function stubs for use inside .select() and .having() lambdas.
+ * These are never executed at runtime — the TypeScript transformer replaces them
+ * at compile time, and the runtime parser reads source text via acorn.
+ * Calling them directly outside a lambda throws a clear error.
+ */
+const msg = (n) => `${n}() can only be used inside a .select() or .having() lambda`;
+/** Returns the count of rows matching the query. Use inside `.select()` or `.having()` lambdas. */
+export function count(_field) {
+    throw new Error(msg("count"));
+}
+/** Returns the sum of the given numeric field. Use inside `.select()` or `.having()` lambdas. */
+export function sum(_field) {
+    throw new Error(msg("sum"));
+}
+/** Returns the average of the given numeric field. Use inside `.select()` or `.having()` lambdas. */
+export function avg(_field) {
+    throw new Error(msg("avg"));
+}
+/** Returns the minimum value of the given field. Use inside `.select()` or `.having()` lambdas. */
+export function min(_field) {
+    throw new Error(msg("min"));
+}
+/** Returns the maximum value of the given field. Use inside `.select()` or `.having()` lambdas. */
+export function max(_field) {
+    throw new Error(msg("max"));
+}
+/** Marks a field as DISTINCT inside an aggregate: count(distinct(p.category)). */
+export function distinct(_field) {
+    throw new Error(msg("distinct"));
+}
+//# sourceMappingURL=aggregates.js.map

package/dist/orm/aggregates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregates.js","sourceRoot":"","sources":["../../src/orm/aggregates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,4DAA4D,CAAC;AAE5F,mGAAmG;AACnG,MAAM,UAAU,KAAK,CAAC,MAAgB;IACpC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,GAAG,CAAC,MAAc;IAChC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,GAAG,CAAC,MAAc;IAChC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,GAAG,CAAI,MAAS;IAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,GAAG,CAAI,MAAS;IAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CAAI,MAAS;IACnC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;AACnC,CAAC"}