typhex 0.1.0-alpha.0

package/dist/dialect.js

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

package/dist/dialect.js.map

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

package/dist/driver/factory.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Create driver from dialect and connection options.
+ */
+import type { Driver } from "./types.js";
+import type { SqliteDriverOptions } from "./sqlite.js";
+import type { PostgresDriverOptions } from "../dbs/postgres/driver.js";
+/** SQLite driver options (path required). */
+export type { SqliteDriverOptions };
+/** PostgreSQL driver options (connectionString or host/port/database). */
+export type { PostgresDriverOptions };
+/** Union of driver options — use `dialect` to discriminate. */
+export type CreateDriverOptions = ({
+    dialect: "sqlite";
+} & SqliteDriverOptions) | ({
+    dialect: "postgres";
+} & PostgresDriverOptions);
+/** Creates a driver from a discriminated options object (`{ dialect: 'sqlite' | 'postgres', … }`). */
+export declare function createDriver(options: CreateDriverOptions): Driver;
+//# sourceMappingURL=factory.d.ts.map

package/dist/driver/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/driver/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,6CAA6C;AAC7C,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,0EAA0E;AAC1E,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAC3B,CAAC;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,GAAG,mBAAmB,CAAC,GAC7C,CAAC;IAAE,OAAO,EAAE,UAAU,CAAA;CAAE,GAAG,qBAAqB,CAAC,CAAC;AAEtD,sGAAsG;AACtG,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAgBjE"}

package/dist/driver/factory.js

@@ -0,0 +1,24 @@
+/**
+ * Create driver from dialect and connection options.
+ */
+import { createSqliteDriver } from "./sqlite.js";
+import { createPostgresDriver } from "../dbs/postgres/driver.js";
+/** Creates a driver from a discriminated options object (`{ dialect: 'sqlite' | 'postgres', … }`). */
+export function createDriver(options) {
+    switch (options.dialect) {
+        case "sqlite": {
+            const { dialect: _, ...rest } = options;
+            if (rest.path === undefined && rest.database === undefined) {
+                return createSqliteDriver({ ...rest, path: ":memory:" });
+            }
+            return createSqliteDriver(rest);
+        }
+        case "postgres": {
+            const { dialect: _, ...rest } = options;
+            return createPostgresDriver(rest);
+        }
+        default:
+            throw new Error(`Unknown dialect: ${options.dialect}`);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/driver/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/driver/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAcjE,sGAAsG;AACtG,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YACxC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3D,OAAO,kBAAkB,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YACxC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,oBAAqB,OAA+B,CAAC,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;AACH,CAAC"}

package/dist/driver/index.d.ts

@@ -0,0 +1,6 @@
+export type { Driver, ExecuteResult } from "./types.js";
+export { createSqliteDriver } from "./sqlite.js";
+export type { SqliteDriverOptions } from "./sqlite.js";
+export { createDriver } from "./factory.js";
+export type { CreateDriverOptions } from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/driver/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/driver/index.js

@@ -0,0 +1,3 @@
+export { createSqliteDriver } from "./sqlite.js";
+export { createDriver } from "./factory.js";
+//# sourceMappingURL=index.js.map

package/dist/driver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/driver/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/driver/sqlite.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SQLite driver using better-sqlite3.
+ * Serializes Date/boolean so bound params are valid for SQLite (numbers, strings, bigints, buffers, null).
+ */
+import type { Driver } from "./types.js";
+/** Options for `createSqliteDriver`: `path` (or alias `database`) to the SQLite file. */
+export interface SqliteDriverOptions {
+    /** Path to database file or ":memory:". Either `path` or `database` is required. */
+    path?: string;
+    /** Alias for `path`. Useful when reading from a config file. */
+    database?: string;
+}
+/** Creates a SQLite driver backed by `better-sqlite3`. */
+export declare function createSqliteDriver(options: SqliteDriverOptions): Driver;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/driver/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/driver/sqlite.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,MAAM,EAKP,MAAM,YAAY,CAAC;AAyCpB,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAuCvE"}

package/dist/driver/sqlite.js

@@ -0,0 +1,74 @@
+/**
+ * SQLite driver using better-sqlite3.
+ * Serializes Date/boolean so bound params are valid for SQLite (numbers, strings, bigints, buffers, null).
+ */
+import { createRequire } from "node:module";
+import { SqliteTrx } from "../dbs/sqlite/trx.js";
+import { sqliteDialect } from "../dbs/sqlite/dialect.js";
+import { isRecord } from "../utils.js";
+const require = createRequire(import.meta.url);
+/** Convert a value to a type SQLite can bind (number, string, bigint, Buffer, null). */
+function toBindable(value) {
+    if (value === undefined || value === null)
+        return null;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "boolean")
+        return value ? 1 : 0;
+    if (typeof value === "number" ||
+        typeof value === "string" ||
+        typeof value === "bigint" ||
+        Buffer.isBuffer(value))
+        return value;
+    if (isRecord(value))
+        return JSON.stringify(value);
+    return value;
+}
+function bindableParams(params) {
+    return params.map(toBindable);
+}
+/** Execute a statement against the better-sqlite3 Database instance. */
+function executeSql(db, sql, params) {
+    const stmt = db.prepare(sql);
+    if (stmt.reader) {
+        return { rows: stmt.all(...bindableParams(params)), changes: 0 };
+    }
+    const info = stmt.run(...bindableParams(params));
+    return { rows: [], lastID: info.lastInsertRowid, changes: info.changes };
+}
+/** Creates a SQLite driver backed by `better-sqlite3`. */
+export function createSqliteDriver(options) {
+    const path = options.path ?? options.database;
+    if (!path) {
+        throw new Error("createSqliteDriver: `path` (or `database`) is required");
+    }
+    const Database = require("better-sqlite3");
+    const db = new Database(path);
+    function makeConnection() {
+        return {
+            dialect: sqliteDialect,
+            async execute(sql, params = []) {
+                return executeSql(db, sql, params);
+            },
+            async release() {
+                /* no-op for SQLite */
+            },
+        };
+    }
+    return {
+        dialect: sqliteDialect,
+        async execute(sql, params = []) {
+            return executeSql(db, sql, params);
+        },
+        connect() {
+            return Promise.resolve(makeConnection());
+        },
+        createTrx(conn, options) {
+            return new SqliteTrx(conn, options);
+        },
+        async close() {
+            db.close();
+        },
+    };
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/driver/sqlite.js.map

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

package/dist/driver/types.d.ts

@@ -0,0 +1,75 @@
+import type { DialectName } from "../dialect.js";
+import type { Trx } from "../orm/trx.js";
+/** Public dialect metadata exposed by drivers. */
+export interface DialectInfo {
+    readonly name: DialectName;
+}
+/** Options forwarded to the underlying driver when beginning a transaction. */
+export interface TransactionOptions {
+    /** ANSI isolation level. SQLite only supports "SERIALIZABLE" (mapped to BEGIN IMMEDIATE). */
+    isolationLevel?: "READ_UNCOMMITTED" | "READ_COMMITTED" | "REPEATABLE_READ" | "SERIALIZABLE";
+    /**
+     * Open the transaction as read-only (PostgreSQL only).
+     * Generates: BEGIN [ISOLATION LEVEL ...] READ ONLY
+     */
+    readOnly?: boolean;
+    /**
+     * Make the transaction deferrable (PostgreSQL only).
+     * Requires isolationLevel: "SERIALIZABLE" and readOnly: true.
+     * Generates: BEGIN ISOLATION LEVEL SERIALIZABLE READ ONLY DEFERRABLE
+     */
+    deferrable?: boolean;
+    /**
+     * SQLite-native transaction mode. Takes precedence over isolationLevel for SQLite.
+     * "deferred"  = BEGIN DEFERRED  (default — acquire locks lazily)
+     * "immediate" = BEGIN IMMEDIATE (acquire write lock immediately)
+     * "exclusive" = BEGIN EXCLUSIVE (block all other connections)
+     */
+    sqliteMode?: "deferred" | "immediate" | "exclusive";
+}
+/** Result returned by Driver.execute() and Connection.execute(). */
+export interface ExecuteResult {
+    /** Rows returned by the statement (non-empty for SELECT/WITH/PRAGMA/EXPLAIN). */
+    rows: unknown[];
+    /**
+     * Auto-generated primary key from the last INSERT, when applicable.
+     * MySQL: result.insertId  |  PostgreSQL: first RETURNING column  |  SQLite: lastInsertRowid
+     */
+    lastID?: number;
+    /** Number of rows affected (INSERT/UPDATE/DELETE). */
+    changes: number;
+}
+/** A dedicated connection acquired from the pool — used inside transactions. */
+export interface Connection<TDialect extends DialectInfo = DialectInfo> {
+    /** The SQL dialect this connection speaks. */
+    readonly dialect: TDialect;
+    /**
+     * Execute any SQL statement on this dedicated connection.
+     * See Driver.execute() for the implementer mapping guide.
+     */
+    execute(sql: string, params?: unknown[]): Promise<ExecuteResult>;
+    /** Returns this connection to the pool. */
+    release(): Promise<void>;
+}
+/** Thin adapter — raw DB operations only. Transaction logic lives in Db. */
+export interface Driver<TDialect extends DialectInfo = DialectInfo> {
+    /** The SQL dialect this driver targets. */
+    readonly dialect: TDialect;
+    /**
+     * Execute any SQL statement. Returns rows (for SELECT) and mutation
+     * metadata (for INSERT/UPDATE/DELETE).
+     *
+     * Implementer mapping:
+     *   MySQL:      rows = result,       lastID = result.insertId,     changes = result.affectedRows
+     *   PostgreSQL: rows = result.rows,  lastID = first RETURNING col, changes = result.rowCount
+     *   SQLite:     rows = stmt.all(),   lastID = lastInsertRowid,     changes = info.changes
+     */
+    execute(sql: string, params?: unknown[]): Promise<ExecuteResult>;
+    /** Acquire a dedicated connection (e.g. pg.PoolClient, or SQLite db wrapper). */
+    connect(): Promise<Connection<TDialect>>;
+    /** Create a dialect-specific transaction scope for the given connection. */
+    createTrx(conn: Connection<TDialect>, options?: TransactionOptions): Trx;
+    /** Closes all pooled connections and tears down the driver. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/driver/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC,6FAA6F;IAC7F,cAAc,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,cAAc,CAAC;IAC5F;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;CACrD;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,UAAU,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IACpE,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,2CAA2C;IAC3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,4EAA4E;AAC5E,MAAM,WAAW,MAAM,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IAChE,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,iFAAiF;IACjF,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,4EAA4E;IAC5E,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,GAAG,CAAC;IACzE,+DAA+D;IAC/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/driver/types.js

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

package/dist/driver/types.js.map

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

package/dist/entity/entity.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Entity(table, schema, relations) — the only supported way to define entities.
+ * Returns a class whose instances are Row<TSchema, TRels>.
+ */
+import type { Trx } from "../orm/trx.js";
+import type { QueryExecutor } from "../orm/db.js";
+import { QueryBuilder } from "../orm/query-builder.js";
+import type { InferTable, Flatten, Materialized, MaterializeShape } from "./schema-inference.js";
+import type { RelationDef, RelationsMap, RelationQueryable, RelationQueryBuilder, ManyRelation } from "./relations.js";
+import type { TableDef, EntityBase } from "./types.js";
+export { getPkColumnsFromSchema } from "./pk-columns.js";
+/** Resolved relation value type for a `RelationDef` R: an array for to-many, a single instance for to-one. */
+export type RelationLoadedValue<R> = R extends RelationDef<infer E, infer TType> ? E extends AnyEntityClass ? unknown extends E ? TType extends "one-to-many" | "many-to-many" ? RelationQueryBuilder<any> & EntityBase[] : EntityBase : TType extends "one-to-many" | "many-to-many" ? ManyRelation<EntityInstance<E>> : EntityInstance<E> : TType extends "one-to-many" | "many-to-many" ? RelationQueryBuilder<any> & EntityBase[] : EntityBase : never;
+/** Base row type: materialized columns merged with loaded relation values and `EntityBase`. */
+export type Row<TShape extends Record<string, unknown>, TRels extends RelationsMap = {}> = Flatten<MaterializeShape<TShape> & {
+    [K in keyof TRels]: RelationLoadedValue<TRels[K]>;
+}> & EntityBase;
+/** Structural interface satisfied by every entity class returned by `Entity()`. */
+export interface AnyEntityClass {
+    /** The table descriptor: name, schema, and relations. */
+    table: TableDef<Record<string, string>, RelationsMap>;
+    /** Returns a `QueryBuilder` scoped to this entity, optionally within a transaction or `Db` instance. */
+    query<C extends AnyEntityClass>(this: C, executor?: QueryExecutor): QueryBuilder<C, EntityInstance<C>>;
+    /** Runs `fn` inside a transaction on the default (or entity-scoped) database. */
+    transaction<T>(fn: (trx: Trx) => Promise<T>): Promise<T>;
+}
+/** The raw schema record declared on entity E. */
+export type EntitySchema<E extends AnyEntityClass> = E["table"] extends TableDef<infer S, any> ? S : never;
+/** The `RelationsMap` declared on entity E. */
+export type EntityRelations<E extends AnyEntityClass> = E["table"] extends TableDef<any, infer R> ? R : never;
+/** Materialized column types of entity E (e.g. `{ id: number; name: string }`). */
+export type EntityFields<E extends AnyEntityClass> = Materialized<EntitySchema<E>>;
+/** Resolved type for a `RelationDef` R: the related entity instance, or the raw target type. */
+export type RelationTarget<R> = R extends RelationDef<infer E, any> ? (E extends AnyEntityClass ? EntityInstance<E> : E) : never;
+/** Relation properties of E typed as lazy query builders (`RelationQueryable`). */
+export type EntityRelationProps<E extends AnyEntityClass> = {
+    [K in keyof EntityRelations<E>]: RelationQueryable<EntityRelations<E>[K]>;
+};
+/** Relation properties of E typed as loaded values (arrays or single instances). */
+export type EntityRelationPropsLoaded<E extends AnyEntityClass> = {
+    [K in keyof EntityRelations<E>]: RelationLoadedValue<EntityRelations<E>[K]>;
+};
+/** Table-derived instance type (used when E is not a class or as fallback). */
+type EntityInstanceFromTable<E extends AnyEntityClass> = Flatten<EntityFields<E> & EntityRelationPropsLoaded<E>> & EntityBase;
+/** Table-derived select row type. */
+type SelectRowFromTable<E extends AnyEntityClass> = Flatten<EntityFields<E> & EntityRelationProps<E>> & EntityBase;
+/** Loaded entity instance. Uses InstanceType<E> when E is a class so subclass declare (OneToMany etc.) flows through. */
+export type EntityInstance<E extends AnyEntityClass> = E extends new (...args: any[]) => infer R ? R extends EntityBase ? R : EntityInstanceFromTable<E> : EntityInstanceFromTable<E>;
+/** Row type in select(u => ...) callback. Uses InstanceType<E> when E is a class so subclass declare flows through. */
+export type SelectRow<E extends AnyEntityClass> = E extends new (...args: any[]) => infer R ? R extends EntityBase ? R : SelectRowFromTable<E> : SelectRowFromTable<E>;
+/** Alias for `EntityInstance<E>`; resolves to `never` when E is not an entity class. */
+export type EntityRow<E> = E extends AnyEntityClass ? EntityInstance<E> : never;
+/** Extracts the entity class from an entity instance type. */
+export type EntityClassOf<T> = T extends EntityInstance<infer E> ? E : T extends AnyEntityClass ? T : never;
+/** Typed entity class returned by `Entity()`. Extends `AnyEntityClass` with schema-specific types. */
+export interface EntityClass<_TTable extends string, TSchema extends Record<string, string>, TRels extends RelationsMap = {}> extends AnyEntityClass {
+    /** Construct a new (unsaved) entity instance with optional partial data. */
+    new (data?: Partial<InferTable<TSchema>>): Row<Materialized<TSchema>, TRels>;
+    /** Typed table descriptor for this entity. */
+    table: TableDef<TSchema, TRels>;
+}
+/**
+ * Define an entity. Schema keys and SQL-like type strings are inferred so that
+ * instances and create() get correct types (e.g. id: number, name: string).
+ */
+export declare function Entity<TTable extends string, const TSchema extends Record<string, string>, const TRels extends RelationsMap = {}>(tableName: TTable, schema: TSchema, relations?: TRels): EntityClass<TTable, TSchema, TRels>;
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity/entity.d.ts.map

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

package/dist/entity/entity.js

@@ -0,0 +1,139 @@
+/**
+ * Entity(table, schema, relations) — the only supported way to define entities.
+ * Returns a class whose instances are Row<TSchema, TRels>.
+ */
+import { getColumnNames } from "../schema/types.js";
+import { QueryBuilder } from "../orm/query-builder.js";
+import { QueryState } from "../orm/query-state.js";
+import { SingleRowQueryBuilder } from "../orm/single-row-query-builder.js";
+import { getDefaultDb, registerEntity, enqueuePendingJunction } from "./global-driver.js";
+import { getActiveTrx } from "../orm/db.js";
+import { getPkColumns } from "./pk-columns.js";
+export { getPkColumnsFromSchema } from "./pk-columns.js";
+function createTableDef(table, schema, relations) {
+    return {
+        _table: table,
+        _schema: schema,
+        _relations: relations,
+        _selectType: undefined,
+        _insertType: undefined,
+    };
+}
+/**
+ * Define an entity. Schema keys and SQL-like type strings are inferred so that
+ * instances and create() get correct types (e.g. id: number, name: string).
+ */
+export function Entity(tableName, schema, relations) {
+    const rels = (relations ?? {});
+    const tableDef = createTableDef(tableName, schema, rels);
+    const cols = getColumnNames(schema);
+    const pkCols = getPkColumns(schema);
+    function resolveDb() {
+        const resolved = getDefaultDb();
+        if (!resolved)
+            throw new Error(`Entity "${tableName}": no Db. Use new Db(driver) to instantiate typhex.`);
+        return resolved;
+    }
+    function resolveRelationTarget(rel) {
+        try {
+            const target = rel._target();
+            const entityClass = target && typeof target === "function"
+                ? target
+                : target
+                    ?._selectType;
+            const tbl = entityClass?.table;
+            if (tbl) {
+                const schema = tbl._schema;
+                return { table: tbl._table, pk: getPkColumns(schema), schema };
+            }
+            return null;
+        }
+        catch (e) {
+            if (e instanceof TypeError || e instanceof ReferenceError)
+                return null;
+            throw e;
+        }
+    }
+    function baseState(executor) {
+        return new QueryState({
+            tableName,
+            columnNames: cols,
+            qe: executor ?? resolveDb(),
+            pkColumns: pkCols,
+            whereIr: null,
+            whereParams: {},
+            subqueryParams: {},
+            orderBy: [],
+            havingIr: null,
+            havingParams: {},
+            limitNum: null,
+            offsetNum: null,
+            selectIr: null,
+            relations: rels,
+            resolveRelationTarget,
+        });
+    }
+    function runHook(self, name) {
+        return typeof self[name] === "function" ? Promise.resolve(self[name]()) : Promise.resolve();
+    }
+    class EntityClassImpl {
+        static table = tableDef;
+        static async transaction(fn) {
+            const db = resolveDb();
+            return db.transaction(fn);
+        }
+        static _registerJunctions() {
+            for (const rd of Object.values(rels)) {
+                if (rd._relType !== "many-to-many")
+                    continue;
+                const opts = rd._options;
+                enqueuePendingJunction({
+                    sourceTable: tableName,
+                    sourceSchema: schema,
+                    sourcePkCols: pkCols,
+                    options: opts,
+                    resolveTarget: () => resolveRelationTarget(rd),
+                    materialize: (junctionSchema) => {
+                        Entity(opts.junction, junctionSchema);
+                    },
+                });
+            }
+        }
+        static _resolveRelations(Ctor) {
+            const classRels = Ctor.relations;
+            return classRels && Object.keys(classRels).length > 0 ? classRels : rels;
+        }
+        static query(executor) {
+            const Ctor = this;
+            const effectiveRels = EntityClassImpl._resolveRelations(Ctor);
+            return new QueryBuilder({
+                ...baseState(executor),
+                entity: Ctor,
+                relations: effectiveRels,
+                async hydrate(row) {
+                    const inst = new Ctor(row);
+                    inst._isNew = false;
+                    inst._dirty = new Set();
+                    await runHook(inst, "afterLoad");
+                    return inst;
+                },
+            });
+        }
+        constructor(data) {
+            const row = (data ?? {});
+            for (const key of Object.keys(row)) {
+                if (row[key] !== undefined)
+                    this[key] = row[key];
+            }
+            this._isNew = !pkCols.every((c) => this[c] !== undefined);
+            this._dirty = new Set(Object.keys(row).filter((k) => cols.includes(k)));
+        }
+        query(executor) {
+            return new SingleRowQueryBuilder(this, baseState(executor ?? getActiveTrx()), runHook, pkCols, cols);
+        }
+    }
+    const result = EntityClassImpl;
+    registerEntity(result);
+    return result;
+}
+//# sourceMappingURL=entity.js.map

package/dist/entity/entity.js.map

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

package/dist/entity/global-driver.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Global default Db and entity registry.
+ * - Db: set by Db constructor, fallback when entities don't have a per-entity Db.
+ * - Registry: populated by Entity(), used by Db.migrate() / Db.validate().
+ */
+import type { Db } from "../orm/db.js";
+import type { JunctionOptions } from "./relations.js";
+export declare function getDefaultDb(): Db | null;
+export declare function setDefaultDb(db: Db | null): void;
+/** Minimal view of an entity class as held in the global registry. */
+export interface RegisteredEntity {
+    /** Table name and schema, used for migrations and validation. */
+    table: {
+        _table: string;
+        _schema: Record<string, string>;
+    };
+    /** Called once after registration to wire up many-to-many junction relations. */
+    _registerJunctions?: () => void;
+}
+export interface PendingJunction {
+    sourceTable: string;
+    sourceSchema: Record<string, string>;
+    sourcePkCols: string[];
+    options: JunctionOptions;
+    resolveTarget: () => {
+        table: string;
+        pk: string[];
+        schema: Record<string, string>;
+    } | null;
+    /** Materialize the junction entity given a fully-built schema. Captured at enqueue time so finalize doesn't need to import Entity (avoids cycle). */
+    materialize: (junctionSchema: Record<string, string>) => void;
+}
+export declare function enqueuePendingJunction(p: PendingJunction): void;
+export declare function registerEntity(entity: RegisteredEntity): void;
+export declare function getRegisteredEntities(): readonly RegisteredEntity[];
+export declare function getEntityByTableName(tableName: string): RegisteredEntity | undefined;
+export declare function clearRegistry(): void;
+//# sourceMappingURL=global-driver.d.ts.map

package/dist/entity/global-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-driver.d.ts","sourceRoot":"","sources":["../../src/entity/global-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtD,wBAAgB,YAAY,IAAI,EAAE,GAAG,IAAI,CAExC;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,CAEhD;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC3D,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,EAAE,MAAM;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5F,qJAAqJ;IACrJ,WAAW,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CAC/D;AAkGD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAE/D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAG7D;AAED,wBAAgB,qBAAqB,IAAI,SAAS,gBAAgB,EAAE,CAInE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEpF;AAED,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}