typhex 0.1.0-alpha.0

package/dist/ir/types.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Query Intermediate Representation (IR).
+ * Produced by the TS transformer or runtime parser; consumed by the SQL compiler.
+ */
+export type IrNode = IrBinary | IrUnary | IrMember | IrConst | IrParam | IrCall | IrIn | IrExists | IrAggregate | IrSubqueryRef | IrCase;
+export interface IrPredicate {
+    node: IrNode;
+    rootParam: string;
+    localParamNames?: string[];
+}
+export type IrWhere = IrPredicate;
+export type IrHaving = IrPredicate;
+export interface IrBinary {
+    kind: "binary";
+    op: "&&" | "||" | "===" | "!==" | "==" | "!=" | ">" | ">=" | "<" | "<=" | "+" | "-" | "*" | "/" | "%" | "&" | "|" | "^" | "<<" | ">>";
+    left: IrNode;
+    right: IrNode;
+}
+export interface IrCase {
+    kind: "case";
+    branches: Array<{
+        when: IrNode;
+        then: IrNode;
+    }>;
+    else?: IrNode;
+}
+export interface IrUnary {
+    kind: "unary";
+    op: "!" | "~";
+    operand: IrNode;
+}
+export interface IrMember {
+    kind: "member";
+    /** Parameter name (e.g. "u") and property path ["age"] => u.age */
+    param: string;
+    path: string[];
+}
+export interface IrConst {
+    kind: "const";
+    value: unknown;
+}
+export interface IrParam {
+    kind: "param";
+    /** Runtime key to look up in params map */
+    key: string;
+}
+export interface IrIn {
+    kind: "in";
+    left: IrNode;
+    right: IrNode;
+    negated?: boolean;
+}
+/** EXISTS subquery for one-to-many: relation.some(e => predicate) or relation.every(e => predicate).
+ *  negated: true → every() → NOT EXISTS (... WHERE NOT (predicate)) */
+export interface IrExists {
+    kind: "exists";
+    negated?: boolean;
+    rootParam: string;
+    relationKey: string;
+    innerParam: string;
+    innerWhere: IrNode;
+}
+export interface IrCall {
+    kind: "call";
+    /** e.g. "startsWith", "includes" */
+    method: string;
+    receiver: IrNode;
+    args: IrNode[];
+}
+export interface IrSubqueryRef {
+    kind: "subqueryRef";
+    key: string;
+}
+export interface IrAggregate {
+    kind: "aggregate";
+    func: "SUM" | "AVG" | "MIN" | "MAX" | "COUNT" | "GROUP_CONCAT" | "STRING_AGG" | "ARRAY_AGG" | "JSON_AGG";
+    arg: IrNode | null;
+    alias?: string;
+    distinct?: boolean;
+    separator?: string;
+}
+/** Sort direction for `orderBy`: `'asc'` (ascending) or `'desc'` (descending). */
+export type OrderDirection = "asc" | "desc";
+export interface IrOrderBy {
+    /** Sort key — typically an IrMember (column path) or IrSubqueryRef (scalar subquery). */
+    expr: IrNode;
+    direction: OrderDirection;
+}
+/** Relation to load: name, output key, optional sub-paths and query options. */
+export interface IrSelectRelation {
+    name: string;
+    outputKey: string;
+    /** Columns to select from target; undefined = all columns. */
+    subPaths?: string[][];
+    /** Optional: filter for the relation sub-query. */
+    whereIr?: IrWhere;
+    whereParams?: Record<string, unknown>;
+    /** Optional: order for the relation sub-query. */
+    orderBy?: IrOrderBy[];
+    limitNum?: number | null;
+    offsetNum?: number | null;
+}
+export interface IrSelect {
+    param: string;
+    /** Empty = select all columns for this param */
+    paths: string[][];
+    /** Optional output names (SQL AS). Same length as paths; when set, path[i] is selected as aliases[i]. */
+    aliases?: string[];
+    /** If true, select paths plus all other table columns not in paths (e.g. ({ id, ...rest }) => ({ id, ...rest })). */
+    rest?: boolean;
+    /** Relations to load (manyToOne, oneToOne, oneToMany, manyToMany). Loaded via separate queries. */
+    relations?: IrSelectRelation[];
+    /** Aggregate columns in SELECT (SUM, AVG, MIN, MAX, COUNT). */
+    aggregates?: IrAggregate[];
+    /** Scalar subquery columns in SELECT (e.g. `(SELECT COUNT(*) FROM …) AS "x"`). */
+    subqueries?: Array<{
+        alias: string;
+        subquery: IrSubqueryRef;
+    }>;
+    /** Computed expression columns (arithmetic, ternary, etc.). Emitted as inline-literal SQL. */
+    expressions?: Array<{
+        expr: IrNode;
+        alias: string;
+    }>;
+    /** GROUP BY entries: string[] = member path, number = positional column reference (GROUP BY 1). */
+    groupBy?: Array<string[] | number>;
+}
+export type JoinType = "inner" | "left" | "right" | "cross" | "full";
+export interface JoinHint {
+    relationKey: string;
+    joinType: JoinType;
+}
+/** JOIN to an entity table with a custom ON predicate (not a declared relation). */
+export interface EntityJoinHint {
+    joinType: JoinType;
+    entity: {
+        table: {
+            _table: string;
+            _schema: Record<string, string>;
+        };
+    };
+    onIr: IrWhere;
+}
+export declare function isIrOrderBy(value: unknown): value is IrOrderBy;
+export declare function isIrWhere(value: unknown): value is IrWhere;
+export declare function isIrNode(node: unknown): node is IrNode;
+export declare function isIrSelect(node: unknown): node is IrSelect;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/ir/types.js

@@ -0,0 +1,97 @@
+/**
+ * Query Intermediate Representation (IR).
+ * Produced by the TS transformer or runtime parser; consumed by the SQL compiler.
+ */
+export function isIrOrderBy(value) {
+    if (value == null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const v = value;
+    return isIrNode(v.expr) && (v.direction === "asc" || v.direction === "desc");
+}
+export function isIrWhere(value) {
+    if (value == null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const v = value;
+    return isIrNode(v.node) && typeof v.rootParam === "string";
+}
+export function isIrNode(node) {
+    if (node == null || typeof node !== "object")
+        return false;
+    const k = node.kind;
+    return (k === "binary" ||
+        k === "unary" ||
+        k === "member" ||
+        k === "const" ||
+        k === "param" ||
+        k === "in" ||
+        k === "call" ||
+        k === "exists" ||
+        k === "aggregate" ||
+        k === "subqueryRef" ||
+        k === "case");
+}
+export function isIrSelect(node) {
+    if (node == null || typeof node !== "object")
+        return false;
+    const o = node;
+    if (typeof o.param !== "string" || !Array.isArray(o.paths))
+        return false;
+    if (!o.paths.every((p) => Array.isArray(p) && p.every((x) => typeof x === "string")))
+        return false;
+    if (o.rest !== undefined && typeof o.rest !== "boolean")
+        return false;
+    if (o.relations !== undefined) {
+        if (!Array.isArray(o.relations))
+            return false;
+        if (!o.relations.every((r) => {
+            const x = r;
+            return (x &&
+                typeof x.name === "string" &&
+                typeof x.outputKey === "string" &&
+                (x.subPaths === undefined ||
+                    (Array.isArray(x.subPaths) &&
+                        x.subPaths.every((p) => Array.isArray(p) && p.every((s) => typeof s === "string")))) &&
+                (x.whereIr === undefined || isIrWhere(x.whereIr)) &&
+                (x.orderBy === undefined || (Array.isArray(x.orderBy) && x.orderBy.every(isIrOrderBy))));
+        }))
+            return false;
+    }
+    if (o.aggregates !== undefined) {
+        if (!Array.isArray(o.aggregates))
+            return false;
+        if (!o.aggregates.every((a) => {
+            const x = a;
+            return x && x.kind === "aggregate" && typeof x.func === "string";
+        }))
+            return false;
+    }
+    if (o.groupBy !== undefined) {
+        if (!Array.isArray(o.groupBy))
+            return false;
+    }
+    if (o.subqueries !== undefined) {
+        if (!Array.isArray(o.subqueries))
+            return false;
+        if (!o.subqueries.every((s) => {
+            const x = s;
+            const sub = x?.subquery;
+            return (x &&
+                typeof x.alias === "string" &&
+                sub != null &&
+                sub.kind === "subqueryRef" &&
+                typeof sub.key === "string");
+        }))
+            return false;
+    }
+    if (o.expressions !== undefined) {
+        if (!Array.isArray(o.expressions))
+            return false;
+        if (!o.expressions.every((e) => {
+            const x = e;
+            return x && typeof x.alias === "string" && isIrNode(x.expr);
+        }))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=types.js.map

package/dist/ir/types.js.map

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

package/dist/migration/cli.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * CLI for typhex migrations.
+ *
+ * Usage:
+ *   typhex migrate:generate [--config <path>] [--entities <path>] [--db <path>] [--dir <path>] [--dialect <name>]
+ *   typhex migrate:run      [--config <path>] [--db <path>] [--dir <path>]
+ *   typhex migrate:status   [--config <path>] [--db <path>] [--dir <path>]
+ *   typhex migrate:dry-run  [--config <path>] [--db <path>] [--dir <path>]
+ *   typhex migrate:pending  [--config <path>] [--db <path>] [--dir <path>]
+ *   typhex migrate:applied  [--config <path>] [--db <path>]
+ *
+ * Config is loaded from: --config path, or typhex.config.js/mjs/json in cwd, or .env (TYPHEX_*).
+ * CLI args override config. --db can be omitted if TYPHEX_DATABASE or config.database is set.
+ *
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/migration/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;GAcG"}

package/dist/migration/cli.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+/**
+ * CLI for typhex migrations.
+ *
+ * Usage:
+ *   typhex migrate:generate [--config <path>] [--entities <path>] [--db <path>] [--dir <path>] [--dialect <name>]
+ *   typhex migrate:run      [--config <path>] [--db <path>] [--dir <path>]
+ *   typhex migrate:status   [--config <path>] [--db <path>] [--dir <path>]
+ *   typhex migrate:dry-run  [--config <path>] [--db <path>] [--dir <path>]
+ *   typhex migrate:pending  [--config <path>] [--db <path>] [--dir <path>]
+ *   typhex migrate:applied  [--config <path>] [--db <path>]
+ *
+ * Config is loaded from: --config path, or typhex.config.js/mjs/json in cwd, or .env (TYPHEX_*).
+ * CLI args override config. --db can be omitted if TYPHEX_DATABASE or config.database is set.
+ *
+ */
+import { resolve, relative } from "node:path";
+import { getRegisteredEntities } from "../entity/global-driver.js";
+import { createDriver } from "../driver/factory.js";
+import { generateMigrationFiles, writeMigrationFiles } from "./generator.js";
+import { appliedMigrations, dryRunMigrations, pendingMigrations, runMigrations, migrationStatus, upMigration, downMigration, } from "./runner.js";
+import { loadConfig } from "../config/load-config.js";
+function parseArgs(argv) {
+    const args = {};
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i].startsWith("--") && i + 1 < argv.length && !argv[i + 1].startsWith("--")) {
+            args[argv[i].slice(2)] = argv[i + 1];
+            i++;
+        }
+    }
+    return args;
+}
+/** Resolve db path: --db flag, then config, then TYPHEX_DATABASE env. */
+function resolveDbPath(cliDb, configDb) {
+    const raw = cliDb ?? configDb ?? process.env.TYPHEX_DATABASE ?? process.env.TYPHEX_DB;
+    if (!raw) {
+        throw new Error("Database path required. Use --db <path>, config.database, or TYPHEX_DATABASE.");
+    }
+    return raw === ":memory:" ? raw : resolveWithinCwd(raw, "--db");
+}
+/** Ensure path is within cwd to prevent path traversal. */
+function resolveWithinCwd(pathArg, label) {
+    const cwd = process.cwd();
+    const resolved = resolve(cwd, pathArg);
+    const rel = relative(cwd, resolved);
+    if (rel.startsWith("..")) {
+        throw new Error(`${label} path must be within the current working directory`);
+    }
+    return resolved;
+}
+/** Create a driver, run callback, and always close — regardless of outcome. */
+async function withDriver(config, dbPath, callback) {
+    const driver = createDriver({
+        dialect: config.dialect,
+        database: dbPath,
+        url: config.url,
+    });
+    try {
+        return await callback(driver);
+    }
+    finally {
+        await driver.close();
+    }
+}
+function usage() {
+    console.log(`
+typhex — migration CLI
+
+Commands:
+  migrate:generate  Diff entity definitions against the database and generate .js migration files
+  migrate:run       Apply pending migrations to the database
+  migrate:status    Show applied and pending migrations
+  migrate:dry-run   Show executable pending SQL without applying it
+  migrate:pending   List executable pending migration files
+  migrate:applied   List applied migration records
+  migrate:up        Apply a specific migration by name (requires --name)
+  migrate:down      Rollback a specific migration by name using its down() function (requires --name)
+
+Options:
+  --config <path>    Config file path (default: auto-detect typhex.config.js)
+  --entities <path>  Path to module that defines Entity() calls (required for generate)
+  --db <path>        Database path (or config.database / TYPHEX_DATABASE)
+  --dir <path>       Migrations directory (default: ./migrations)
+  --dialect <name>   Target dialect: sqlite (default) or postgres
+  --name <name>      Migration name, without extension (required for up/down)
+`);
+    process.exit(1);
+}
+async function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    const args = parseArgs(rest);
+    if (!command)
+        usage();
+    const overrides = {};
+    if (args.db)
+        overrides.database = args.db;
+    if (args.dir)
+        overrides.migrationsFolder = args.dir;
+    if (args.dialect)
+        overrides.dialect = args.dialect;
+    if (args.entities)
+        overrides.entities = args.entities;
+    const config = await loadConfig({
+        configPath: args.config,
+        cwd: process.cwd(),
+        overrides: overrides,
+    });
+    const dir = resolveWithinCwd(config.migrationsFolder ?? "./migrations", "--dir");
+    const dbPath = resolveDbPath(args.db, config.database);
+    if (command === "migrate:generate") {
+        const entitiesPath = args.entities ?? config.entities;
+        if (!entitiesPath) {
+            console.error("migrate:generate requires --entities or config.entities");
+            process.exit(1);
+        }
+        const entitiesResolved = resolveWithinCwd(entitiesPath, "--entities");
+        await withDriver(config, dbPath, async (driver) => {
+            await import(entitiesResolved);
+            const entities = getRegisteredEntities();
+            if (entities.length === 0) {
+                console.log("No entities registered. Nothing to generate.");
+                return;
+            }
+            const files = await generateMigrationFiles(driver, entities);
+            if (files.length === 0) {
+                console.log("Schema is up to date. No migrations generated.");
+                return;
+            }
+            const paths = writeMigrationFiles(dir, files);
+            console.log(`Generated ${paths.length} migration(s):`);
+            for (const p of paths)
+                console.log(`  ${p}`);
+        });
+    }
+    else if (command === "migrate:run") {
+        await withDriver(config, dbPath, async (driver) => {
+            const result = await runMigrations(driver, dir);
+            if (result.applied.length === 0) {
+                console.log("No pending migrations.");
+            }
+            else {
+                console.log(`Applied ${result.applied.length} migration(s):`);
+                for (const n of result.applied)
+                    console.log(`  ✓ ${n}`);
+            }
+            if (result.skipped.length > 0) {
+                console.log(`Skipped ${result.skipped.length} (already applied).`);
+            }
+        });
+    }
+    else if (command === "migrate:status") {
+        await withDriver(config, dbPath, async (driver) => {
+            const status = await migrationStatus(driver, dir);
+            if (status.applied.length > 0) {
+                console.log("Applied migrations:");
+                for (const r of status.applied)
+                    console.log(`  ✓ ${r.name}  (${r.applied_at})`);
+            }
+            if (status.pending.length > 0) {
+                console.log("Pending migrations:");
+                for (const n of status.pending)
+                    console.log(`  ○ ${n}`);
+            }
+            if (status.applied.length === 0 && status.pending.length === 0) {
+                console.log("No migrations found.");
+            }
+        });
+    }
+    else if (command === "migrate:dry-run") {
+        await withDriver(config, dbPath, async (driver) => {
+            const plan = await dryRunMigrations(driver, dir);
+            if (plan.pending.length === 0) {
+                console.log("No executable pending migrations.");
+                return;
+            }
+            console.log(`Would apply ${plan.pending.length} migration(s):`);
+            for (const migration of plan.pending) {
+                console.log(`  ○ ${migration.name} (${migration.statements.length} statement(s))`);
+            }
+            if (plan.skipped.length > 0) {
+                console.log(`Skipped ${plan.skipped.length} migration(s).`);
+            }
+        });
+    }
+    else if (command === "migrate:pending") {
+        await withDriver(config, dbPath, async (driver) => {
+            const pending = await pendingMigrations(driver, dir);
+            if (pending.length === 0) {
+                console.log("No executable pending migrations.");
+                return;
+            }
+            for (const migration of pending)
+                console.log(migration.name);
+        });
+    }
+    else if (command === "migrate:applied") {
+        await withDriver(config, dbPath, async (driver) => {
+            const applied = await appliedMigrations(driver);
+            if (applied.length === 0) {
+                console.log("No applied migrations.");
+                return;
+            }
+            for (const migration of applied)
+                console.log(`${migration.name}\t${migration.applied_at}`);
+        });
+    }
+    else if (command === "migrate:up") {
+        if (!args.name) {
+            console.error("migrate:up requires --name <migration-name>");
+            process.exit(1);
+        }
+        await withDriver(config, dbPath, async (driver) => {
+            await upMigration(driver, dir, args.name);
+            console.log(`Applied: ${args.name}`);
+        });
+    }
+    else if (command === "migrate:down") {
+        if (!args.name) {
+            console.error("migrate:down requires --name <migration-name>");
+            process.exit(1);
+        }
+        await withDriver(config, dbPath, async (driver) => {
+            await downMigration(driver, dir, args.name);
+            console.log(`Rolled back: ${args.name}`);
+        });
+    }
+    else {
+        console.error(`Unknown command: ${command}`);
+        usage();
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/migration/cli.js.map

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

package/dist/migration/diff.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Schema diff: compare registered entity definitions against the live database.
+ * Delegates to the dialect migrator for dialect-specific diff logic.
+ */
+import type { Driver } from "../driver/types.js";
+import type { DiffAction } from "./types.js";
+import type { RegisteredEntity } from "../entity/global-driver.js";
+/** Compares entity definitions against the live database schema and returns the list of pending `DiffAction` items. */
+export declare function diffSchema(driver: Driver, entities: readonly RegisteredEntity[]): Promise<DiffAction[]>;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/migration/diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,uHAAuH;AACvH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB"}

package/dist/migration/diff.js

@@ -0,0 +1,10 @@
+/**
+ * Schema diff: compare registered entity definitions against the live database.
+ * Delegates to the dialect migrator for dialect-specific diff logic.
+ */
+/** Compares entity definitions against the live database schema and returns the list of pending `DiffAction` items. */
+export async function diffSchema(driver, entities) {
+    const resolvedDriver = driver;
+    return resolvedDriver.dialect.migrator.diffSchema(resolvedDriver, entities);
+}
+//# sourceMappingURL=diff.js.map

package/dist/migration/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/migration/diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,uHAAuH;AACvH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAc,EACd,QAAqC;IAErC,MAAM,cAAc,GAAG,MAAwB,CAAC;IAChD,OAAO,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC9E,CAAC"}

package/dist/migration/generator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 type { Driver } from "../driver/types.js";
+import type { MigrationFile } from "./types.js";
+import type { RegisteredEntity } from "../entity/global-driver.js";
+/** Generates SQL migration files from entity definitions compared to the live database schema. */
+export declare function generateMigrationFiles(driver: Driver, entities: readonly RegisteredEntity[]): Promise<MigrationFile[]>;
+export declare function writeMigrationFiles(dir: string, files: MigrationFile[]): string[];
+//# sourceMappingURL=generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/migration/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AA8DnE,kGAAkG;AAClG,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,OAAO,CAAC,aAAa,EAAE,CAAC,CAkC1B;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CASjF"}