typhex 0.1.0-alpha.0

package/dist/orm/db.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Db: the rich database class. Transaction logic lives in dialect-specific Trx subclasses
+ * (see src/orm/trx.ts and dialect trx subclasses). Db.transaction() manages the connection
+ * lifecycle and delegates to Driver.createTrx() for the dialect-specific scope.
+ */
+import type { DialectInfo, Driver, TransactionOptions } from "../driver/types.js";
+import type { DialectName } from "../dbs/types.js";
+import type { MigrationFile } from "../migration/types.js";
+import { Trx, getActiveTrx } from "./trx.js";
+export { Trx, getActiveTrx };
+/** Minimal interface satisfied by both `Db` and `Trx` — pass either as the executor for query builders. */
+export interface QueryExecutor {
+    /** The SQL dialect in use. */
+    readonly dialect: DialectInfo;
+    /** Runs a SQL query and returns all result rows. */
+    query(sql: string, params?: unknown[]): Promise<unknown[]>;
+    /** Executes a SQL statement and returns affected-row metadata. */
+    run(sql: string, params?: unknown[]): Promise<{
+        lastID?: number;
+        changes: number;
+    }>;
+}
+/** Options passed to the `Db` constructor: either a pre-built driver or dialect + connection details. */
+export type DbOptions = {
+    driver: Driver;
+    migrationsFolder?: string;
+} | {
+    dialect: DialectName;
+    database?: string;
+    url?: string;
+    migrationsFolder?: string;
+};
+/** Root database class. Create via `new Db(options)` or `Db.fromConfig()`. */
+export declare class Db implements QueryExecutor {
+    private _migrationsFolder;
+    constructor(options: DbOptions | Driver);
+    /** Create Db from config file. Loads config and creates driver internally. */
+    static fromConfig(options?: {
+        configPath?: string;
+        cwd?: string;
+    }): Promise<Db>;
+    /** The SQL dialect used by this `Db` instance. */
+    get dialect(): DialectInfo;
+    /** The underlying database driver. */
+    get driver(): Driver;
+    /** Runs a SQL query and returns all result rows. */
+    query(sql: string, params?: unknown[]): Promise<unknown[]>;
+    /** Executes a SQL statement and returns affected-row metadata. */
+    run(sql: string, params?: unknown[]): Promise<{
+        lastID?: number;
+        changes: number;
+    }>;
+    /** Runs `fn` inside a transaction; commits on success, rolls back on error. */
+    transaction<T>(fn: (trx: Trx) => Promise<T>, options?: TransactionOptions): Promise<T>;
+    /**
+     * Begin an explicit transaction and return the Trx handle.
+     * You are responsible for calling trx.commit() or trx.rollback().
+     *
+     * @example
+     * const trx = await db.beginTrx();
+     * try {
+     *   await User.query(trx).insert({ name: "Alice" });
+     *   const nested = await trx.beginTrx();
+     *   try {
+     *     await Post.query(nested).insert({ title: "Hello", authorId: 1 });
+     *     await nested.commit();
+     *   } catch { await nested.rollback(); }
+     *   await trx.commit();
+     * } catch { await trx.rollback(); }
+     */
+    beginTrx(options?: TransactionOptions): Promise<Trx>;
+    /** CREATE TABLE IF NOT EXISTS for all registered entities (ordered by FK deps). */
+    migrate(): Promise<void>;
+    /** Validate all registered entities against the database. Throws on mismatch. */
+    validate(): Promise<void>;
+    /**
+     * Diff entity definitions against the database and generate migration files.
+     * Returns the generated files (also written to disk).
+     */
+    generateMigrations(dir?: string): Promise<MigrationFile[]>;
+    /** Apply pending migration scripts from the migrations directory. */
+    runMigrations(dir?: string): Promise<import("../migration/runner.js").MigrationResult>;
+    /** Show applied and pending migration status. */
+    migrationStatus(dir?: string): Promise<{
+        applied: import("../migration/types.js").MigrationRecord[];
+        pending: string[];
+    }>;
+    /** Return applied migration records without inspecting pending files. */
+    appliedMigrations(): Promise<import("../migration/types.js").MigrationRecord[]>;
+    /** Return pending executable migration files without applying them. */
+    pendingMigrations(dir?: string): Promise<import("../migration/types.js").PendingMigration[]>;
+    /** Preview migration execution without applying any SQL. */
+    dryRunMigrations(dir?: string): Promise<{
+        applied: import("../migration/types.js").MigrationRecord[];
+        pending: import("../migration/types.js").PendingMigration[];
+        skipped: string[];
+    }>;
+    /** Apply a specific migration by name. Throws if already applied or file not found. */
+    upMigration(name: string, dir?: string): Promise<void>;
+    /** Roll back a specific migration by name. Throws if not applied or file not found. */
+    downMigration(name: string, dir?: string): Promise<void>;
+    /** Closes the underlying database connection pool. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=db.d.ts.map

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

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

package/dist/orm/db.js

@@ -0,0 +1,172 @@
+/**
+ * Db: the rich database class. Transaction logic lives in dialect-specific Trx subclasses
+ * (see src/orm/trx.ts and dialect trx subclasses). Db.transaction() manages the connection
+ * lifecycle and delegates to Driver.createTrx() for the dialect-specific scope.
+ */
+import { createDriver } from "../driver/factory.js";
+import { getRegisteredEntities, setDefaultDb } from "../entity/global-driver.js";
+import { generateMigrationFiles, writeMigrationFiles } from "../migration/generator.js";
+import { appliedMigrations as appliedMig, downMigration as downMig, dryRunMigrations as dryRunMig, migrationStatus as migStatus, pendingMigrations as pendingMig, runMigrations as runMig, upMigration as upMig, } from "../migration/runner.js";
+import { parseFkDependencies, topoSort } from "../migration/topo-sort.js";
+import { loadConfig } from "../config/load-config.js";
+import { Trx, getActiveTrx, runInTrxStorage } from "./trx.js";
+export { Trx, getActiveTrx };
+function isDriver(v) {
+    return v != null && typeof v === "object" && "execute" in v && "connect" in v && "close" in v;
+}
+/** Internal symbol: only used for the Db internal constructor overload. */
+const INTERNAL = Symbol("db-internal");
+/** Root database class. Create via `new Db(options)` or `Db.fromConfig()`. */
+export class Db {
+    /** @internal */
+    _driver;
+    _migrationsFolder;
+    constructor(arg, internal) {
+        this._driver = (isDriver(arg)
+            ? arg
+            : isDriver(arg.driver)
+                ? arg.driver
+                : createDriver(arg));
+        this._migrationsFolder =
+            arg.migrationsFolder ?? "./migrations";
+        if (internal !== INTERNAL)
+            setDefaultDb(this);
+    }
+    /** Create Db from config file. Loads config and creates driver internally. */
+    static async fromConfig(options) {
+        const config = await loadConfig({
+            configPath: options?.configPath,
+            cwd: options?.cwd,
+        });
+        return new Db(config);
+    }
+    /** The SQL dialect used by this `Db` instance. */
+    get dialect() {
+        return this._driver.dialect;
+    }
+    /** The underlying database driver. */
+    get driver() {
+        return this._driver;
+    }
+    /** Runs a SQL query and returns all result rows. */
+    query(sql, params) {
+        return this._driver.execute(sql, params).then((r) => r.rows);
+    }
+    /** Executes a SQL statement and returns affected-row metadata. */
+    run(sql, params) {
+        return this._driver
+            .execute(sql, params)
+            .then((r) => ({ lastID: r.lastID, changes: r.changes }));
+    }
+    /** Runs `fn` inside a transaction; commits on success, rolls back on error. */
+    async transaction(fn, options) {
+        const conn = await this._driver.connect();
+        const trx = this._driver.createTrx(conn, options);
+        try {
+            return await runInTrxStorage(trx, () => trx.transaction(fn));
+        }
+        finally {
+            await conn.release();
+        }
+    }
+    /**
+     * Begin an explicit transaction and return the Trx handle.
+     * You are responsible for calling trx.commit() or trx.rollback().
+     *
+     * @example
+     * const trx = await db.beginTrx();
+     * try {
+     *   await User.query(trx).insert({ name: "Alice" });
+     *   const nested = await trx.beginTrx();
+     *   try {
+     *     await Post.query(nested).insert({ title: "Hello", authorId: 1 });
+     *     await nested.commit();
+     *   } catch { await nested.rollback(); }
+     *   await trx.commit();
+     * } catch { await trx.rollback(); }
+     */
+    async beginTrx(options) {
+        const conn = await this._driver.connect();
+        const trx = this._driver.createTrx(conn, options);
+        await trx._initRoot(() => conn.release());
+        return trx;
+    }
+    /** CREATE TABLE IF NOT EXISTS for all registered entities (ordered by FK deps). */
+    async migrate() {
+        const compiler = this._driver.dialect.queryCompiler;
+        const entities = getRegisteredEntities();
+        const deps = parseFkDependencies(entities);
+        const names = entities.map((e) => e.table._table);
+        const sorted = topoSort(names, deps);
+        const byName = new Map(entities.map((e) => [e.table._table, e]));
+        for (const name of sorted) {
+            const entity = byName.get(name);
+            if (!entity)
+                continue;
+            const { _schema: schema } = entity.table;
+            await this.run(compiler.compileCreateTableIfNotExists(name, schema));
+        }
+    }
+    /** Validate all registered entities against the database. Throws on mismatch. */
+    async validate() {
+        for (const entity of getRegisteredEntities()) {
+            const { _table: name, _schema: schema } = entity.table;
+            const expectedCols = Object.keys(schema);
+            const rows = await this._driver.dialect.migrator.getDbColumns(this._driver, name);
+            if (rows.length === 0) {
+                throw new Error(`validate: table "${name}" does not exist in the database.`);
+            }
+            const dbCols = new Map(rows.map((r) => [r.name, r]));
+            for (const col of expectedCols) {
+                if (!dbCols.has(col)) {
+                    throw new Error(`validate: column "${col}" is defined in Entity("${name}") but does not exist in the table.`);
+                }
+            }
+        }
+    }
+    /**
+     * Diff entity definitions against the database and generate migration files.
+     * Returns the generated files (also written to disk).
+     */
+    async generateMigrations(dir = this._migrationsFolder) {
+        const entities = getRegisteredEntities();
+        const files = await generateMigrationFiles(this._driver, entities);
+        if (files.length > 0)
+            writeMigrationFiles(dir, files);
+        return files;
+    }
+    /** Apply pending migration scripts from the migrations directory. */
+    async runMigrations(dir = this._migrationsFolder) {
+        return runMig(this._driver, dir);
+    }
+    /** Show applied and pending migration status. */
+    async migrationStatus(dir = this._migrationsFolder) {
+        return migStatus(this._driver, dir);
+    }
+    /** Return applied migration records without inspecting pending files. */
+    async appliedMigrations() {
+        return appliedMig(this._driver);
+    }
+    /** Return pending executable migration files without applying them. */
+    async pendingMigrations(dir = this._migrationsFolder) {
+        return pendingMig(this._driver, dir);
+    }
+    /** Preview migration execution without applying any SQL. */
+    async dryRunMigrations(dir = this._migrationsFolder) {
+        return dryRunMig(this._driver, dir);
+    }
+    /** Apply a specific migration by name. Throws if already applied or file not found. */
+    async upMigration(name, dir = this._migrationsFolder) {
+        return upMig(this._driver, dir, name);
+    }
+    /** Roll back a specific migration by name. Throws if not applied or file not found. */
+    async downMigration(name, dir = this._migrationsFolder) {
+        return downMig(this._driver, dir, name);
+    }
+    /** Closes the underlying database connection pool. */
+    async close() {
+        setDefaultDb(null);
+        await this._driver.close();
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/orm/db.js.map

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

package/dist/orm/expr.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Runtime expression model — what the dialect compiles to SQL.
+ *
+ * Independent of the parser-side IR (`src/ir/types.ts`). The QueryPlanBuilder
+ * converts IR to Expr once during planning, resolving member paths to alias +
+ * column pairs and inlining subquery plans. The dialect walks Expr; it never
+ * imports from `src/ir/`.
+ */
+import type { JoinType } from "../ir/types.js";
+import type { QueryPlan } from "./helpers/query-plan/query-plan.js";
+export type BinaryOp = "&&" | "||" | "===" | "!==" | "==" | "!=" | ">" | ">=" | "<" | "<=" | "+" | "-" | "*" | "/" | "%" | "&" | "|" | "^" | "<<" | ">>";
+export type AggregateFn = "SUM" | "AVG" | "MIN" | "MAX" | "COUNT" | "GROUP_CONCAT" | "STRING_AGG" | "ARRAY_AGG" | "JSON_AGG";
+export type Expr = ExprBinary | ExprUnary | ExprColumn | ExprConst | ExprParam | ExprIn | ExprCall | ExprAggregate | ExprExists | ExprSubquery | ExprCase;
+export interface ExprBinary {
+    kind: "binary";
+    op: BinaryOp;
+    left: Expr;
+    right: Expr;
+}
+export interface ExprUnary {
+    kind: "unary";
+    op: "!" | "~";
+    operand: Expr;
+}
+/** Resolved column reference. `alias` is the SQL table alias (e.g. "t0", "t1").
+ *  `column` is the column path: empty array means the alias itself (rare —
+ *  used when a member path was fully consumed by relation rewrite); a single
+ *  element is a leaf column; multiple elements are a multi-segment path
+ *  rendered as quoted dotted segments. */
+export interface ExprColumn {
+    kind: "column";
+    alias: string;
+    column: string[];
+}
+export interface ExprConst {
+    kind: "const";
+    value: unknown;
+}
+/** Late-bound parameter — resolved at runtime against the plan's param bags. */
+export interface ExprParam {
+    kind: "param";
+    name: string;
+}
+export interface ExprIn {
+    kind: "in";
+    left: Expr;
+    right: ExprInRhs;
+    negated?: boolean;
+}
+export type ExprInRhs = {
+    kind: "values";
+    values: unknown[];
+} | {
+    kind: "param";
+    name: string;
+} | {
+    kind: "subquery";
+    plan: QueryPlan;
+};
+export interface ExprCall {
+    kind: "call";
+    method: string;
+    receiver: Expr;
+    args: Expr[];
+}
+export interface ExprAggregate {
+    kind: "aggregate";
+    func: AggregateFn;
+    arg: Expr | null;
+    alias?: string;
+    distinct?: boolean;
+    separator?: string;
+}
+/** Pre-resolved EXISTS subquery for one-to-many filters. The planner has
+ *  already chosen `outerAlias`/`innerAlias` and resolved the predicate's
+ *  inner row-param to `innerAlias`. */
+export interface ExprExists {
+    kind: "exists";
+    negated?: boolean;
+    outerAlias: string;
+    innerAlias: string;
+    targetTable: string;
+    fkColumns: string[];
+    mainPk: string[];
+    predicate: Expr;
+}
+/** Embedded subquery — fully built child plan. */
+export interface ExprSubquery {
+    kind: "subquery";
+    plan: QueryPlan;
+}
+export interface ExprCase {
+    kind: "case";
+    branches: Array<{
+        when: Expr;
+        then: Expr;
+    }>;
+    else?: Expr;
+}
+/** A SELECT-list item. `alias` is optional — when undefined no AS clause is emitted. */
+export interface SelectItem {
+    expr: Expr;
+    alias?: string;
+}
+export type OrderDirection = "asc" | "desc";
+export interface OrderItem {
+    expr: Expr;
+    direction: OrderDirection;
+}
+export type GroupByItem = ExprColumn | {
+    kind: "index";
+    index: number;
+};
+export interface JoinSpec {
+    relationKey: string;
+    alias: string;
+    targetTable: string;
+    targetPkColumns: string[];
+    foreignKeys: string[];
+    relType: "many-to-one" | "one-to-one";
+    joinType: JoinType;
+    /** Custom ON for entity-table joins; when set, FK columns are ignored. */
+    on?: Expr;
+}
+//# sourceMappingURL=expr.d.ts.map

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

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

package/dist/orm/expr.js

@@ -0,0 +1,10 @@
+/**
+ * Runtime expression model — what the dialect compiles to SQL.
+ *
+ * Independent of the parser-side IR (`src/ir/types.ts`). The QueryPlanBuilder
+ * converts IR to Expr once during planning, resolving member paths to alias +
+ * column pairs and inlining subquery plans. The dialect walks Expr; it never
+ * imports from `src/ir/`.
+ */
+export {};
+//# sourceMappingURL=expr.js.map

package/dist/orm/expr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expr.js","sourceRoot":"","sources":["../../src/orm/expr.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/orm/helpers/insert-graph/insert-graph-batch-executor.d.ts

@@ -0,0 +1,9 @@
+import type { QueryExecutor } from "../../db.js";
+import { InsertGraphExecutor } from "./insert-graph-executor.js";
+import type { PlannedNode } from "./insert-graph-planner.js";
+export declare class InsertGraphBatchExecutor extends InsertGraphExecutor {
+    protected insertReadyNodes(qe: QueryExecutor, nodes: PlannedNode[]): Promise<void>;
+    private insertNodeGroup;
+    private insertNodeBatch;
+}
+//# sourceMappingURL=insert-graph-batch-executor.d.ts.map

package/dist/orm/helpers/insert-graph/insert-graph-batch-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-graph-batch-executor.d.ts","sourceRoot":"","sources":["../../../../src/orm/helpers/insert-graph/insert-graph-batch-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAU7D,qBAAa,wBAAyB,SAAQ,mBAAmB;cAC/C,gBAAgB,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAO1E,eAAe;YAaf,eAAe;CAgB9B"}

package/dist/orm/helpers/insert-graph/insert-graph-batch-executor.js

@@ -0,0 +1,44 @@
+import { InsertGraphExecutor } from "./insert-graph-executor.js";
+import { groupBy } from "../../../utils.js";
+import { SequenceIdAssigner } from "./sequence-id-assigner.js";
+export class InsertGraphBatchExecutor extends InsertGraphExecutor {
+    async insertReadyNodes(qe, nodes) {
+        const compiler = qe.dialect.queryCompiler;
+        for (const group of groupByTable(nodes)) {
+            await this.insertNodeGroup(compiler, qe, group);
+        }
+    }
+    async insertNodeGroup(compiler, qe, group) {
+        await new SequenceIdAssigner(compiler, qe, group.tableName, group.items).assign();
+        if (group.mode === "single") {
+            await this.insertSingleNode(qe, group.items[0]);
+            return;
+        }
+        await this.insertNodeBatch(qe, group);
+    }
+    async insertNodeBatch(qe, group) {
+        const entity = group.items[0].entity;
+        const inserted = await entity.query(qe).insertMany(group.items.map((node) => node.scalarData));
+        if (inserted.length > 0 && inserted.length !== group.items.length) {
+            throw new Error("insertGraph: insertMany did not return the expected number of rows");
+        }
+        for (const [index, node] of group.items.entries()) {
+            const insertedRow = inserted[index];
+            if (insertedRow) {
+                node.insertedRow = insertedRow;
+                node.materializedRow = insertedRow;
+            }
+            else {
+                node.insertedRow = { ...node.scalarData };
+            }
+        }
+    }
+}
+function groupByTable(nodes) {
+    return [...groupBy(nodes, (node) => node.tableName)].map(([tableName, items]) => ({
+        tableName,
+        items,
+        mode: items.length === 1 ? "single" : "batch",
+    }));
+}
+//# sourceMappingURL=insert-graph-batch-executor.js.map

package/dist/orm/helpers/insert-graph/insert-graph-batch-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-graph-batch-executor.js","sourceRoot":"","sources":["../../../../src/orm/helpers/insert-graph/insert-graph-batch-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,MAAM,OAAO,wBAAyB,SAAQ,mBAAmB;IACrD,KAAK,CAAC,gBAAgB,CAAC,EAAiB,EAAE,KAAoB;QACtE,MAAM,QAAQ,GAAI,EAAE,CAAC,OAAmB,CAAC,aAAa,CAAC;QACvD,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,QAAuB,EACvB,EAAiB,EACjB,KAAkB;QAElB,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAClF,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,EAAiB,EAAE,KAAkB;QACjE,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/F,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAwC,CAAC;YAC3E,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;gBAC/B,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,SAAS,YAAY,CAAC,KAAoB;IACxC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAChF,SAAS;QACT,KAAK;QACL,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;KAC9C,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/orm/helpers/insert-graph/insert-graph-executor.d.ts

@@ -0,0 +1,13 @@
+import type { QueryExecutor } from "../../db.js";
+import type { InsertGraphPlan, PlannedNode } from "./insert-graph-planner.js";
+export declare abstract class InsertGraphExecutor {
+    protected readonly plan: InsertGraphPlan;
+    constructor(plan: InsertGraphPlan);
+    execute(): Promise<void>;
+    private drainNodes;
+    protected insertSingleNode(qe: QueryExecutor, node: PlannedNode): Promise<void>;
+    private getReadyNodes;
+    private applyPendingCopies;
+    protected abstract insertReadyNodes(qe: QueryExecutor, nodes: PlannedNode[]): Promise<void>;
+}
+//# sourceMappingURL=insert-graph-executor.d.ts.map

package/dist/orm/helpers/insert-graph/insert-graph-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-graph-executor.d.ts","sourceRoot":"","sources":["../../../../src/orm/helpers/insert-graph/insert-graph-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE9E,8BAAsB,mBAAmB;IAC3B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe;gBAArB,IAAI,EAAE,eAAe;IAE9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,UAAU;cAaR,gBAAgB,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASrF,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;IAS1B,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAC5F"}

package/dist/orm/helpers/insert-graph/insert-graph-executor.js

@@ -0,0 +1,42 @@
+export class InsertGraphExecutor {
+    plan;
+    constructor(plan) {
+        this.plan = plan;
+    }
+    async execute() {
+        await this.drainNodes();
+    }
+    async drainNodes() {
+        let ready = this.getReadyNodes();
+        while (ready.length > 0) {
+            for (const node of ready)
+                this.applyPendingCopies(node);
+            await this.insertReadyNodes(this.plan.qe, ready);
+            ready = this.getReadyNodes();
+        }
+        const stuck = this.plan.nodes.filter((node) => node.insertedRow == null);
+        if (stuck.length > 0) {
+            throw new Error("insertGraph: unresolved node dependencies");
+        }
+    }
+    async insertSingleNode(qe, node) {
+        const inserted = (await node.entity.query(qe).insert(node.scalarData));
+        node.insertedRow = inserted;
+        node.materializedRow = inserted;
+    }
+    getReadyNodes() {
+        return this.plan.nodes
+            .filter((node) => node.insertedRow == null &&
+            node.dependencyIds.every((id) => this.plan.nodes[id]?.insertedRow != null))
+            .sort((left, right) => left.id - right.id);
+    }
+    applyPendingCopies(node) {
+        for (const copy of node.pendingCopies) {
+            const sourceRow = this.plan.nodes[copy.sourceNodeId].insertedRow;
+            for (let i = 0; i < copy.targetColumns.length; i++) {
+                node.scalarData[copy.targetColumns[i]] = sourceRow[copy.sourceColumns[i]];
+            }
+        }
+    }
+}
+//# sourceMappingURL=insert-graph-executor.js.map

package/dist/orm/helpers/insert-graph/insert-graph-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-graph-executor.js","sourceRoot":"","sources":["../../../../src/orm/helpers/insert-graph/insert-graph-executor.ts"],"names":[],"mappings":"AAGA,MAAM,OAAgB,mBAAmB;IACR;IAA/B,YAA+B,IAAqB;QAArB,SAAI,GAAJ,IAAI,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACxD,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACjD,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC;QACzE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAES,KAAK,CAAC,gBAAgB,CAAC,EAAiB,EAAE,IAAiB;QACnE,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAGpE,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC;QAC5B,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAEO,aAAa;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK;aACnB,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,WAAW,IAAI,IAAI;YACxB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,WAAW,IAAI,IAAI,CAAC,CAC7E;aACA,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAEO,kBAAkB,CAAC,IAAiB;QAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,WAAY,CAAC;YAClE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;IACH,CAAC;CAGF"}

package/dist/orm/helpers/insert-graph/insert-graph-planner.d.ts

@@ -0,0 +1,46 @@
+import { type AnyEntityClass, type EntityInstance } from "../../../entity/entity.js";
+import type { QueryExecutor } from "../../db.js";
+import { type QueryState } from "../../query-state.js";
+type InsertGraphInput = Record<string, unknown> | Record<string, unknown>[];
+type GraphInsertIdResolution = "provided" | "needsReturning" | "needsSequence" | "unresolvableInBatch";
+type ColumnCopyInstruction = {
+    sourceNodeId: number;
+    sourceColumns: string[];
+    targetColumns: string[];
+};
+export type PlannedNodeInput = {
+    tableName: string;
+    entity: AnyEntityClass;
+    scalarData: Record<string, unknown>;
+    pkColumns: string[];
+    idResolution: GraphInsertIdResolution;
+    insertedRow?: Record<string, unknown>;
+    materializedRow?: Record<string, unknown>;
+};
+export type PlannedNode = PlannedNodeInput & {
+    id: number;
+    dependencyIds: number[];
+    pendingCopies: ColumnCopyInstruction[];
+};
+export type InsertGraphPlan = {
+    qe: QueryExecutor;
+    nodes: PlannedNode[];
+    rootNodeIds: number[];
+};
+export declare class InsertGraphPlanner<C extends AnyEntityClass> {
+    private readonly state;
+    private readonly input;
+    constructor(state: QueryState<EntityInstance<C>>, input: InsertGraphInput);
+    execute(): Promise<EntityInstance<C> | EntityInstance<C>[]>;
+    private buildInsertGraphPlan;
+    private planGraphNode;
+    private planOwningToOneRelation;
+    private planOneToManyChildren;
+    private planManyToManyRelations;
+    private resolveManyToManyTargetNode;
+    private createJunctionNode;
+    private createReferenceNode;
+    private materializeRootRows;
+}
+export {};
+//# sourceMappingURL=insert-graph-planner.d.ts.map

package/dist/orm/helpers/insert-graph/insert-graph-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-graph-planner.d.ts","sourceRoot":"","sources":["../../../../src/orm/helpers/insert-graph/insert-graph-planner.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAUnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKvD,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;AAE5E,KAAK,uBAAuB,GACxB,UAAU,GACV,gBAAgB,GAChB,eAAe,GACf,qBAAqB,CAAC;AAE1B,KAAK,qBAAqB,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,uBAAuB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAUF,qBAAa,kBAAkB,CAAC,CAAC,SAAS,cAAc;IAEpD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EACpC,KAAK,EAAE,gBAAgB;IAGpC,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAcjE,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,aAAa;IAqCrB,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,2BAA2B;IAcnC,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,mBAAmB;YAiBb,mBAAmB;CAOlC"}