@danceroutine/tango-orm 1.3.0 → 1.4.0

package/dist/{registerModelObjects-CXSI5ndy.js → registerModelObjects-Bva_f-Qh.js}

@@ -1,8 +1,7 @@
-import { connectDB } from "./connection-CVvycXus.js";
-import { InternalRelationKind, OrmSqlSafetyAdapter, QuerySet } from "./query-6GeNOf-w.js";
+import { InternalRelationKind, OrmSqlSafetyAdapter, QuerySet } from "./query-CWZ1cfjo.js";
+import { RuntimeBoundClient, TransactionEngine, getTangoRuntime } from "./defaultRuntime-BPK9kWEW.js";
 import { NotFoundError } from "@danceroutine/tango-core";
 import { ModelRegistry, registerModelAugmentor } from "@danceroutine/tango-schema";
-import { loadConfig, loadConfigFromProjectRoot } from "@danceroutine/tango-config";
 
 //#region src/manager/internal/MutationCompiler.ts
 var MutationCompiler = class {
@@ -48,34 +47,6 @@ var MutationCompiler = class {
 	}
 };
 
-//#endregion
-//#region src/manager/internal/RuntimeBoundClient.ts
-var RuntimeBoundClient = class {
-	constructor(runtime) {
-		this.runtime = runtime;
-	}
-	async query(sql, params) {
-		const client = await this.runtime.getClient();
-		return client.query(sql, params);
-	}
-	async begin() {
-		const client = await this.runtime.getClient();
-		await client.begin();
-	}
-	async commit() {
-		const client = await this.runtime.getClient();
-		await client.commit();
-	}
-	async rollback() {
-		const client = await this.runtime.getClient();
-		await client.rollback();
-	}
-	async close() {
-		const client = await this.runtime.getClient();
-		await client.close();
-	}
-};
-
 //#endregion
 //#region src/manager/ModelManager.ts
 const sqlSafetyAdapter = new OrmSqlSafetyAdapter();
@@ -87,8 +58,10 @@ var ModelManager = class ModelManager {
 	model;
 	client;
 	dialect;
+	runtime;
 	constructor(model, runtime) {
 		this.model = model;
+		this.runtime = runtime;
 		this.client = new RuntimeBoundClient(runtime);
 		this.dialect = runtime.getDialect();
 		this.mutationCompiler = new MutationCompiler(this.dialect);
@@ -174,7 +147,8 @@ var ModelManager = class ModelManager {
 		await this.model.hooks?.afterCreate?.({
 			record: created,
 			model: this.model,
-			manager: this
+			manager: this,
+			transaction: this.getHookTransaction()
 		});
 		return created;
 	}
@@ -197,7 +171,8 @@ var ModelManager = class ModelManager {
 			previous: current,
 			record: updated,
 			model: this.model,
-			manager: this
+			manager: this,
+			transaction: this.getHookTransaction()
 		});
 		return updated;
 	}
@@ -207,7 +182,8 @@ var ModelManager = class ModelManager {
 			id,
 			current,
 			model: this.model,
-			manager: this
+			manager: this,
+			transaction: this.getHookTransaction()
 		});
 		const validatedPlan = sqlSafetyAdapter.validate({
 			kind: "delete",
@@ -219,7 +195,8 @@ var ModelManager = class ModelManager {
 			id,
 			previous: current,
 			model: this.model,
-			manager: this
+			manager: this,
+			transaction: this.getHookTransaction()
 		});
 	}
 	async bulkCreate(inputs) {
@@ -228,7 +205,8 @@ var ModelManager = class ModelManager {
 		const batchPrepared = await this.model.hooks?.beforeBulkCreate?.({
 			rows: perRowPrepared,
 			model: this.model,
-			manager: this
+			manager: this,
+			transaction: this.getHookTransaction()
 		}) ?? perRowPrepared;
 		const preparedKeys = Object.keys(batchPrepared[0] ?? {});
 		if (preparedKeys.length === 0) throw new Error(`Cannot create ${this.model.metadata.name} without any values.`);
@@ -243,12 +221,14 @@ var ModelManager = class ModelManager {
 		await Promise.all(result.rows.map((record) => this.model.hooks?.afterCreate?.({
 			record,
 			model: this.model,
-			manager: this
+			manager: this,
+			transaction: this.getHookTransaction()
 		})));
 		await this.model.hooks?.afterBulkCreate?.({
 			records: result.rows,
 			model: this.model,
-			manager: this
+			manager: this,
+			transaction: this.getHookTransaction()
 		});
 		return result.rows;
 	}
@@ -256,7 +236,8 @@ var ModelManager = class ModelManager {
 		return await this.model.hooks?.beforeCreate?.({
 			data,
 			model: this.model,
-			manager: this
+			manager: this,
+			transaction: this.getHookTransaction()
 		}) ?? data;
 	}
 	async runBeforeUpdate(id, patch, current) {
@@ -265,88 +246,15 @@ var ModelManager = class ModelManager {
 			patch,
 			current,
 			model: this.model,
-			manager: this
+			manager: this,
+			transaction: this.getHookTransaction()
 		}) ?? patch;
 	}
-};
-
-//#endregion
-//#region src/runtime/TangoRuntime.ts
-var TangoRuntime = class TangoRuntime {
-	static BRAND = "tango.orm.runtime";
-	__tangoBrand = TangoRuntime.BRAND;
-	loadedConfig;
-	clientPromise = null;
-	constructor(loadLoadedConfig) {
-		this.loadedConfig = loadLoadedConfig();
-	}
-	/**
-	* Narrow an unknown value to `TangoRuntime`.
-	*/
-	static isTangoRuntime(value) {
-		return typeof value === "object" && value !== null && value.__tangoBrand === TangoRuntime.BRAND;
-	}
-	/**
-	* Return the loaded Tango config snapshot for the active environment.
-	*/
-	getConfig() {
-		return this.loadedConfig;
-	}
-	/**
-	* Return the configured SQL dialect for the current runtime.
-	*/
-	getDialect() {
-		return this.loadedConfig.current.db.adapter;
-	}
-	/**
-	* Return the shared DB client, creating it once on first access.
-	*/
-	async getClient() {
-		if (!this.clientPromise) {
-			const db = this.loadedConfig.current.db;
-			this.clientPromise = connectDB({
-				adapter: db.adapter,
-				url: db.url,
-				host: db.host,
-				port: db.port,
-				database: db.database,
-				user: db.user,
-				password: db.password,
-				filename: db.filename,
-				maxConnections: db.maxConnections
-			});
-		}
-		return this.clientPromise;
-	}
-	/**
-	* Close and clear the cached DB client so tests can start fresh.
-	*/
-	async reset() {
-		if (!this.clientPromise) return;
-		const client = await this.clientPromise;
-		this.clientPromise = null;
-		await client.close();
+	getHookTransaction() {
+		return TransactionEngine.forRuntime(this.runtime).getActiveTransaction();
 	}
 };
 
-//#endregion
-//#region src/runtime/defaultRuntime.ts
-let defaultRuntime = null;
-function initializeTangoRuntime(fromFile) {
-	defaultRuntime = new TangoRuntime(() => loadConfig(fromFile));
-	return defaultRuntime;
-}
-function getTangoRuntime() {
-	if (!defaultRuntime) defaultRuntime = new TangoRuntime(() => loadConfigFromProjectRoot());
-	return defaultRuntime;
-}
-async function resetTangoRuntime() {
-	if (!defaultRuntime) return;
-	const runtime = defaultRuntime;
-	defaultRuntime = null;
-	await runtime.reset();
-}
-
 //#endregion
 //#region src/manager/registerModelObjects.ts
 const managerCache = new WeakMap();
@@ -375,5 +283,5 @@ function registerModelObjects() {
 }
 
 //#endregion
-export { ModelManager, TangoRuntime, getTangoRuntime, initializeTangoRuntime, registerModelObjects, resetTangoRuntime };
-//# sourceMappingURL=registerModelObjects-CXSI5ndy.js.map
+export { ModelManager, registerModelObjects };
+//# sourceMappingURL=registerModelObjects-Bva_f-Qh.js.map

package/dist/registerModelObjects-Bva_f-Qh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerModelObjects-Bva_f-Qh.js","names":["dialect: Dialect","plan: ValidatedInsertSqlPlan","values: readonly unknown[]","plan: ValidatedUpdateSqlPlan","id: unknown","plan: ValidatedDeleteSqlPlan","valueRows: ReadonlyArray<ReadonlyArray<unknown>>","count: number","index: number","model: ModelLike<TModelRow>","runtime: TangoRuntime","value: unknown","rawMeta: TableMeta","id: TModelRow[keyof TModelRow]","input: Partial<TModelRow>","patch: Partial<TModelRow>","inputs: Partial<TModelRow>[]","batchPrepared: Partial<TModelRow>[]","data: Partial<TModelRow>","current: TModelRow","model: SchemaModel<TSchema, TKey>"],"sources":["../src/manager/internal/MutationCompiler.ts","../src/manager/ModelManager.ts","../src/manager/registerModelObjects.ts"],"sourcesContent":["import type { CompiledQuery, Dialect } from '../../query/domain/index';\nimport type {\n    ValidatedDeleteSqlPlan,\n    ValidatedInsertSqlPlan,\n    ValidatedUpdateSqlPlan,\n} from '../../validation/SQLValidationEngine';\n\n/**\n * Internal compiler for manager-owned INSERT/UPDATE/DELETE statements.\n */\nexport class MutationCompiler {\n    constructor(private readonly dialect: Dialect) {}\n\n    compileInsert(plan: ValidatedInsertSqlPlan, values: readonly unknown[]): CompiledQuery {\n        return {\n            sql: `INSERT INTO ${plan.meta.table} (${plan.writeKeys.join(', ')}) VALUES (${this.buildValuePlaceholders(plan.writeKeys.length)}) RETURNING *`,\n            params: values,\n        };\n    }\n\n    compileUpdate(plan: ValidatedUpdateSqlPlan, values: readonly unknown[], id: unknown): CompiledQuery {\n        const sets = plan.writeKeys.map((key, index) => `${key} = ${this.placeholder(index + 1)}`).join(', ');\n        const whereParam = this.placeholder(plan.writeKeys.length + 1);\n\n        return {\n            sql: `UPDATE ${plan.meta.table} SET ${sets} WHERE ${plan.meta.pk} = ${whereParam} RETURNING *`,\n            params: [...values, id],\n        };\n    }\n\n    compileDelete(plan: ValidatedDeleteSqlPlan, id: unknown): CompiledQuery {\n        return {\n            sql: `DELETE FROM ${plan.meta.table} WHERE ${plan.meta.pk} = ${this.placeholder(1)}`,\n            params: [id],\n        };\n    }\n\n    compileBulkInsert(plan: ValidatedInsertSqlPlan, valueRows: ReadonlyArray<ReadonlyArray<unknown>>): CompiledQuery {\n        const columnCount = plan.writeKeys.length;\n        const placeholders = valueRows\n            .map((_row, rowIndex) => {\n                const offset = rowIndex * columnCount;\n                return `(${plan.writeKeys.map((_, colIndex) => this.placeholder(offset + colIndex + 1)).join(', ')})`;\n            })\n            .join(', ');\n\n        return {\n            sql: `INSERT INTO ${plan.meta.table} (${plan.writeKeys.join(', ')}) VALUES ${placeholders} RETURNING *`,\n            params: valueRows.flat(),\n        };\n    }\n\n    private buildValuePlaceholders(count: number): string {\n        return Array.from({ length: count }, (_value, index) => this.placeholder(index + 1)).join(', ');\n    }\n\n    private placeholder(index: number): string {\n        return this.dialect === 'postgres' ? `$${index}` : '?';\n    }\n}\n","import { NotFoundError } from '@danceroutine/tango-core';\nimport { ModelRegistry, type ModelWriteHooks } from '@danceroutine/tango-schema';\nimport type { FilterInput, RelationMeta, TableMeta } from '../query/domain/index';\nimport { InternalRelationKind } from '../query/domain/internal/InternalRelationKind';\nimport type { QuerySet } from '../query/index';\nimport { QuerySet as QuerySetClass } from '../query/index';\nimport type { Dialect, QueryExecutor } from '../query/index';\nimport type { TangoRuntime } from '../runtime/TangoRuntime';\nimport { OrmSqlSafetyAdapter } from '../validation';\nimport { TransactionEngine } from '../transaction/internal/context';\nimport type { ManagerLike } from './ManagerLike';\nimport { MutationCompiler } from './internal/MutationCompiler';\nimport { RuntimeBoundClient } from './internal/RuntimeBoundClient';\n\nconst sqlSafetyAdapter = new OrmSqlSafetyAdapter();\n\ntype FieldLike = {\n    name: string;\n    type: string;\n    primaryKey?: boolean;\n};\n\ntype ModelLike<TModelRow extends Record<string, unknown>> = {\n    metadata: {\n        key?: string;\n        name: string;\n        table: string;\n        fields: FieldLike[];\n    };\n    schema: {\n        parse(input: unknown): TModelRow;\n    };\n    hooks?: ModelWriteHooks<TModelRow>;\n};\n\n/**\n * Model-backed data access API exposed as `Model.objects`.\n */\nexport class ModelManager<TModelRow extends Record<string, unknown>, TSourceModel = unknown>\n    implements ManagerLike<TModelRow, TSourceModel>\n{\n    static readonly BRAND = 'tango.orm.model_manager' as const;\n    readonly __tangoBrand: typeof ModelManager.BRAND = ModelManager.BRAND;\n    private readonly queryExecutor: QueryExecutor<TModelRow>;\n    private readonly mutationCompiler: MutationCompiler;\n    private readonly model: ModelLike<TModelRow>;\n    private readonly client: RuntimeBoundClient;\n    private readonly dialect: Dialect;\n    private readonly runtime: TangoRuntime;\n\n    constructor(model: ModelLike<TModelRow>, runtime: TangoRuntime) {\n        this.model = model;\n        this.runtime = runtime;\n        this.client = new RuntimeBoundClient(runtime);\n        this.dialect = runtime.getDialect() as Dialect;\n        this.mutationCompiler = new MutationCompiler(this.dialect);\n        this.queryExecutor = {\n            get meta() {\n                return ModelManager.createTableMeta(model);\n            },\n            client: this.client,\n            dialect: this.dialect,\n            run: async (compiled) => {\n                const result = await this.client.query<TModelRow>(compiled.sql, compiled.params);\n                return result.rows;\n            },\n        };\n    }\n\n    get meta(): TableMeta {\n        return ModelManager.createTableMeta(this.model);\n    }\n\n    /**\n     * Narrow an unknown value to `ModelManager`.\n     */\n    static isModelManager<TModelRow extends Record<string, unknown>>(value: unknown): value is ModelManager<TModelRow> {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === ModelManager.BRAND\n        );\n    }\n\n    private static createTableMeta<TModelRow extends Record<string, unknown>>(model: ModelLike<TModelRow>): TableMeta {\n        const pkField = model.metadata.fields.find((field) => field.primaryKey);\n        if (!pkField) {\n            throw new Error(`Model '${model.metadata.name}' cannot attach a manager without a primary key field.`);\n        }\n\n        const rawMeta: TableMeta = {\n            table: model.metadata.table,\n            pk: pkField.name,\n            columns: Object.fromEntries(model.metadata.fields.map((field) => [field.name, field.type])),\n        };\n\n        if (model.metadata.key) {\n            const owner = ModelRegistry.getOwner(model as never);\n            const relations = owner.getResolvedRelationGraph().byModel.get(model.metadata.key);\n            if (relations && relations.size > 0) {\n                // This metadata is recomputed on access today. Most application tables have a small relation set, so\n                // keeping this path direct is acceptable until profiling points to a dedicated manager-meta cache.\n                rawMeta.relations = Object.fromEntries(\n                    Array.from(relations.entries())\n                        .filter(([, relation]) => relation.kind !== InternalRelationKind.MANY_TO_MANY)\n                        .map(([name, relation]) => {\n                            const targetModel = owner.getByKey(relation.targetModelKey)!;\n                            // Query planning needs the target model's SQL-facing shape so joined and prefetched rows can be\n                            // selected, normalized, and attached without leaking internal alias columns.\n                            const targetColumns = Object.fromEntries(\n                                targetModel.metadata.fields.map((field) => [field.name, field.type])\n                            );\n                            // Forward relations join from this table's FK to the target key. Reverse relations flip that:\n                            // this table's primary key matches the target model's FK back to this model.\n                            const sourceKey =\n                                relation.kind === InternalRelationKind.BELONGS_TO\n                                    ? relation.localFieldName\n                                    : relation.targetFieldName;\n                            const targetKey =\n                                relation.kind === InternalRelationKind.BELONGS_TO\n                                    ? relation.targetFieldName\n                                    : relation.localFieldName;\n\n                            return [\n                                name,\n                                {\n                                    kind: relation.kind as RelationMeta['kind'],\n                                    table: targetModel.metadata.table,\n                                    sourceKey: sourceKey as string,\n                                    targetKey: targetKey as string,\n                                    targetColumns,\n                                    alias: relation.alias,\n                                },\n                            ];\n                        })\n                );\n            }\n        }\n\n        const validatedMeta = sqlSafetyAdapter.validate({\n            kind: 'insert',\n            meta: rawMeta,\n            writeKeys: Object.keys(rawMeta.columns),\n        }).meta;\n\n        if (rawMeta.relations) {\n            validatedMeta.relations = rawMeta.relations;\n        }\n\n        return validatedMeta;\n    }\n\n    query(): QuerySet<TModelRow, TModelRow, TSourceModel> {\n        return new QuerySetClass<TModelRow, TModelRow, TSourceModel>(this.queryExecutor, {});\n    }\n\n    async findById(id: TModelRow[keyof TModelRow]): Promise<TModelRow | null> {\n        const filter = { [this.meta.pk]: id } as unknown as FilterInput<TModelRow>;\n        return this.query().filter(filter).fetchOne();\n    }\n\n    async getOrThrow(id: TModelRow[keyof TModelRow]): Promise<TModelRow> {\n        const result = await this.findById(id);\n        if (!result) {\n            throw new NotFoundError(`${this.model.metadata.name} with ${this.meta.pk}=${String(id)} not found`);\n        }\n        return result;\n    }\n\n    async create(input: Partial<TModelRow>): Promise<TModelRow> {\n        const prepared = await this.runBeforeCreate(input);\n        const preparedKeys = Object.keys(prepared);\n        if (preparedKeys.length === 0) {\n            throw new Error(`Cannot create ${this.model.metadata.name} without any values.`);\n        }\n\n        const validatedPlan = sqlSafetyAdapter.validate({\n            kind: 'insert',\n            meta: this.meta,\n            writeKeys: preparedKeys,\n        });\n        const compiled = this.mutationCompiler.compileInsert(\n            validatedPlan,\n            preparedKeys.map((key) => prepared[key as keyof TModelRow])\n        );\n        const result = await this.queryExecutor.client.query<TModelRow>(compiled.sql, compiled.params);\n        const created = result.rows[0]!;\n        await this.model.hooks?.afterCreate?.({\n            record: created,\n            model: this.model,\n            manager: this,\n            transaction: this.getHookTransaction(),\n        });\n        return created;\n    }\n\n    async update(id: TModelRow[keyof TModelRow], patch: Partial<TModelRow>): Promise<TModelRow> {\n        const current = await this.getOrThrow(id);\n        const prepared = await this.runBeforeUpdate(id, patch, current);\n        const preparedKeys = Object.keys(prepared);\n        if (preparedKeys.length === 0) {\n            throw new Error(`Cannot update ${this.model.metadata.name} without any values.`);\n        }\n\n        const validatedPlan = sqlSafetyAdapter.validate({\n            kind: 'update',\n            meta: this.meta,\n            writeKeys: preparedKeys,\n        });\n        const compiled = this.mutationCompiler.compileUpdate(\n            validatedPlan,\n            preparedKeys.map((key) => prepared[key as keyof TModelRow]),\n            id\n        );\n        const result = await this.queryExecutor.client.query<TModelRow>(compiled.sql, compiled.params);\n        const updated = result.rows[0]!;\n        await this.model.hooks?.afterUpdate?.({\n            id,\n            patch: prepared,\n            previous: current,\n            record: updated,\n            model: this.model,\n            manager: this,\n            transaction: this.getHookTransaction(),\n        });\n        return updated;\n    }\n\n    async delete(id: TModelRow[keyof TModelRow]): Promise<void> {\n        const current = await this.getOrThrow(id);\n        await this.model.hooks?.beforeDelete?.({\n            id,\n            current,\n            model: this.model,\n            manager: this,\n            transaction: this.getHookTransaction(),\n        });\n        const validatedPlan = sqlSafetyAdapter.validate({\n            kind: 'delete',\n            meta: this.meta,\n        });\n        const compiled = this.mutationCompiler.compileDelete(validatedPlan, id);\n        await this.queryExecutor.client.query(compiled.sql, compiled.params);\n        await this.model.hooks?.afterDelete?.({\n            id,\n            previous: current,\n            model: this.model,\n            manager: this,\n            transaction: this.getHookTransaction(),\n        });\n    }\n\n    async bulkCreate(inputs: Partial<TModelRow>[]): Promise<TModelRow[]> {\n        if (inputs.length === 0) {\n            return [];\n        }\n\n        const perRowPrepared = await Promise.all(inputs.map((input) => this.runBeforeCreate(input)));\n        const batchPrepared: Partial<TModelRow>[] =\n            (await this.model.hooks?.beforeBulkCreate?.({\n                rows: perRowPrepared,\n                model: this.model,\n                manager: this,\n                transaction: this.getHookTransaction(),\n            })) ?? perRowPrepared;\n        const preparedKeys = Object.keys(batchPrepared[0] ?? {});\n        if (preparedKeys.length === 0) {\n            throw new Error(`Cannot create ${this.model.metadata.name} without any values.`);\n        }\n\n        const validatedPlan = sqlSafetyAdapter.validate({\n            kind: 'insert',\n            meta: this.meta,\n            writeKeys: preparedKeys,\n        });\n        const valueRows = batchPrepared.map((input) => preparedKeys.map((key) => input[key as keyof TModelRow]));\n        const compiled = this.mutationCompiler.compileBulkInsert(validatedPlan, valueRows);\n        const result = await this.queryExecutor.client.query<TModelRow>(compiled.sql, compiled.params);\n        await Promise.all(\n            result.rows.map((record) =>\n                this.model.hooks?.afterCreate?.({\n                    record,\n                    model: this.model,\n                    manager: this,\n                    transaction: this.getHookTransaction(),\n                })\n            )\n        );\n        await this.model.hooks?.afterBulkCreate?.({\n            records: result.rows,\n            model: this.model,\n            manager: this,\n            transaction: this.getHookTransaction(),\n        });\n        return result.rows;\n    }\n\n    private async runBeforeCreate(data: Partial<TModelRow>): Promise<Partial<TModelRow>> {\n        return (\n            (await this.model.hooks?.beforeCreate?.({\n                data,\n                model: this.model,\n                manager: this,\n                transaction: this.getHookTransaction(),\n            })) ?? data\n        );\n    }\n\n    private async runBeforeUpdate(\n        id: TModelRow[keyof TModelRow],\n        patch: Partial<TModelRow>,\n        current: TModelRow\n    ): Promise<Partial<TModelRow>> {\n        return (\n            (await this.model.hooks?.beforeUpdate?.({\n                id,\n                patch,\n                current,\n                model: this.model,\n                manager: this,\n                transaction: this.getHookTransaction(),\n            })) ?? patch\n        );\n    }\n\n    private getHookTransaction() {\n        return TransactionEngine.forRuntime(this.runtime).getActiveTransaction();\n    }\n}\n","import type { z } from 'zod';\nimport type { Model as SchemaModel, PersistedModelOutput } from '@danceroutine/tango-schema/domain';\nimport { registerModelAugmentor } from '@danceroutine/tango-schema';\nimport { ModelManager } from './ModelManager';\nimport type { TangoRuntime } from '../runtime/TangoRuntime';\nimport { getTangoRuntime } from '../runtime/defaultRuntime';\n\nconst managerCache = new WeakMap<object, { runtime: TangoRuntime; manager: ModelManager<Record<string, unknown>> }>();\nlet hasRegisteredModelObjects = false;\n\ntype AugmentableSchemaModel<TSchema extends z.ZodObject<z.ZodRawShape>> = {\n    metadata: {\n        key?: string;\n        name: string;\n        table: string;\n        fields: Array<{ name: string; type: string; primaryKey?: boolean }>;\n    };\n    schema: {\n        parse(input: unknown): PersistedModelOutput<TSchema>;\n    };\n    hooks?: SchemaModel<TSchema>['hooks'];\n};\n\nfunction defineObjectsProperty<TSchema extends z.ZodObject<z.ZodRawShape>, TKey extends string>(\n    model: SchemaModel<TSchema, TKey>\n): void {\n    Object.defineProperty(model, 'objects', {\n        configurable: true,\n        enumerable: true,\n        get() {\n            const runtime = getTangoRuntime();\n            const cached = managerCache.get(model);\n            if (cached && cached.runtime === runtime) {\n                return cached.manager;\n            }\n\n            const manager = new ModelManager<PersistedModelOutput<TSchema>, SchemaModel<TSchema, TKey>>(\n                model as unknown as AugmentableSchemaModel<TSchema>,\n                runtime\n            );\n            managerCache.set(model, {\n                runtime,\n                manager: manager as ModelManager<Record<string, unknown>>,\n            });\n            return manager;\n        },\n    });\n}\n\n/**\n * Install the schema model augmentor that exposes `Model.objects`.\n * This registration is idempotent so multiple Tango entrypoints can safely call it.\n */\nexport function registerModelObjects(): void {\n    if (hasRegisteredModelObjects) {\n        return;\n    }\n\n    registerModelAugmentor(defineObjectsProperty);\n    hasRegisteredModelObjects = true;\n}\n"],"mappings":"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"}

package/dist/runtime/TangoRuntime.d.ts

@@ -1,15 +1,17 @@
 import type { LoadedConfig } from '@danceroutine/tango-config';
 import type { DBClient } from '../connection/index';
 import type { Dialect } from '../query/domain/index';
+import type { TransactionClientLease } from './internal/DBClientProvider';
 /**
  * Framework-owned database runtime that resolves Tango config and lazily
- * creates the shared DB client used by manager-backed models.
+ * creates the shared connection provider used by manager-backed models.
  */
 export declare class TangoRuntime {
     static readonly BRAND: "tango.orm.runtime";
     readonly __tangoBrand: typeof TangoRuntime.BRAND;
     private readonly loadedConfig;
-    private clientPromise;
+    private providerPromise;
+    private runtimeClientPromise;
     constructor(loadLoadedConfig: () => LoadedConfig);
     /**
      * Narrow an unknown value to `TangoRuntime`.
@@ -24,11 +26,22 @@ export declare class TangoRuntime {
      */
     getDialect(): Dialect;
     /**
-     * Return the shared DB client, creating it once on first access.
+     * Return the runtime-bound DB client facade used by manager-backed code.
      */
     getClient(): Promise<DBClient>;
     /**
-     * Close and clear the cached DB client so tests can start fresh.
+     * Execute SQL through the autocommit path owned by this runtime.
+     */
+    query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{
+        rows: T[];
+    }>;
+    /**
+     * Lease a transaction-scoped client for `transaction.atomic(...)`.
+     */
+    leaseTransactionClient(): Promise<TransactionClientLease>;
+    /**
+     * Close and clear the cached runtime resources so tests can start fresh.
      */
     reset(): Promise<void>;
+    private getProvider;
 }

package/dist/runtime/index.js

@@ -1,8 +1,8 @@
-import "../PostgresAdapter-C9a1XJRx.js";
-import "../SqliteAdapter-Dp6VRXmz.js";
-import "../connection-CVvycXus.js";
-import "../query-6GeNOf-w.js";
-import { TangoRuntime, getTangoRuntime, initializeTangoRuntime, registerModelObjects, resetTangoRuntime } from "../registerModelObjects-CXSI5ndy.js";
-import "../runtime-7U5_XDad.js";
+import "../PostgresClient-BQJZfEOT.js";
+import "../SqliteClient-CjOK9-ki.js";
+import "../query-CWZ1cfjo.js";
+import { TangoRuntime, getTangoRuntime, initializeTangoRuntime, resetTangoRuntime } from "../defaultRuntime-BPK9kWEW.js";
+import { registerModelObjects } from "../registerModelObjects-Bva_f-Qh.js";
+import "../runtime-ByXbpVBS.js";
 
 export { TangoRuntime, getTangoRuntime, initializeTangoRuntime, registerModelObjects, resetTangoRuntime };

package/dist/runtime/internal/DBClientProvider.d.ts

@@ -0,0 +1,12 @@
+import type { DBClient } from '../../connection/clients/DBClient';
+export interface TransactionClientLease {
+    readonly client: DBClient;
+    release(): Promise<void>;
+}
+export interface DBClientProvider {
+    query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{
+        rows: T[];
+    }>;
+    leaseTransactionClient(): Promise<TransactionClientLease>;
+    reset(): Promise<void>;
+}

package/dist/runtime/internal/PostgresDBClientProvider.d.ts

@@ -0,0 +1,12 @@
+import type { AdapterConfig } from '../../connection/adapters/Adapter';
+import type { DBClientProvider, TransactionClientLease } from './DBClientProvider';
+export declare class PostgresDBClientProvider implements DBClientProvider {
+    private readonly pool;
+    private activeLeaseCount;
+    constructor(config: AdapterConfig);
+    query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{
+        rows: T[];
+    }>;
+    leaseTransactionClient(): Promise<TransactionClientLease>;
+    reset(): Promise<void>;
+}

package/dist/runtime/internal/SqliteDBClientProvider.d.ts

@@ -0,0 +1,16 @@
+import type { AdapterConfig } from '../../connection/adapters/Adapter';
+import type { DBClientProvider, TransactionClientLease } from './DBClientProvider';
+export declare class SqliteDBClientProvider implements DBClientProvider {
+    private readonly filename;
+    private readonly Database;
+    private readonly autocommitClient;
+    private activeLeaseCount;
+    constructor(config?: AdapterConfig);
+    query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{
+        rows: T[];
+    }>;
+    leaseTransactionClient(): Promise<TransactionClientLease>;
+    reset(): Promise<void>;
+    private openClient;
+    private getDatabaseCtor;
+}

package/dist/runtime/internal/createDBClientProvider.d.ts

@@ -0,0 +1,5 @@
+import type { AdapterConfig } from '../../connection/adapters/Adapter';
+import type { DBClientProvider } from './DBClientProvider';
+export declare function createDBClientProvider(config: AdapterConfig & {
+    adapter: string;
+}): DBClientProvider;

package/dist/{runtime-7U5_XDad.js → runtime-ByXbpVBS.js}

@@ -1,5 +1,6 @@
 import { __export } from "./chunk-DLY2FNSh.js";
-import { TangoRuntime, getTangoRuntime, initializeTangoRuntime, registerModelObjects, resetTangoRuntime } from "./registerModelObjects-CXSI5ndy.js";
+import { TangoRuntime, getTangoRuntime, initializeTangoRuntime, resetTangoRuntime } from "./defaultRuntime-BPK9kWEW.js";
+import { registerModelObjects } from "./registerModelObjects-Bva_f-Qh.js";
 
 //#region src/runtime/index.ts
 var runtime_exports = {};
@@ -14,4 +15,4 @@ registerModelObjects();
 
 //#endregion
 export { runtime_exports };
-//# sourceMappingURL=runtime-7U5_XDad.js.map
+//# sourceMappingURL=runtime-ByXbpVBS.js.map

package/dist/{runtime-7U5_XDad.js.map → runtime-ByXbpVBS.js.map}

@@ -1 +1 @@
-{"version":3,"file":"runtime-7U5_XDad.js","names":[],"sources":["../src/runtime/index.ts"],"sourcesContent":["import type { z } from 'zod';\nimport type { ModelManager } from '../manager/ModelManager';\nimport type { Model, PersistedModelOutput } from '@danceroutine/tango-schema/domain';\nimport { registerModelObjects } from '../manager/registerModelObjects';\n\n/**\n * Domain boundary barrel: centralizes Tango runtime ownership APIs.\n */\n\ndeclare global {\n    interface TangoSchemaModelAugmentations<\n        TSchema extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>,\n        TKey extends string = string,\n    > {\n        readonly objects: ModelManager<PersistedModelOutput<TSchema>, Model<TSchema, TKey>>;\n    }\n}\n\nregisterModelObjects();\n\nexport { registerModelObjects } from '../manager/registerModelObjects';\nexport { TangoRuntime } from './TangoRuntime';\nexport { getTangoRuntime, initializeTangoRuntime, resetTangoRuntime } from './defaultRuntime';\n"],"mappings":";;;;;;;;;;;;AAkBA,sBAAsB"}
+{"version":3,"file":"runtime-ByXbpVBS.js","names":[],"sources":["../src/runtime/index.ts"],"sourcesContent":["import type { z } from 'zod';\nimport type { ModelManager } from '../manager/ModelManager';\nimport type { Model, PersistedModelOutput } from '@danceroutine/tango-schema/domain';\nimport { registerModelObjects } from '../manager/registerModelObjects';\n\n/**\n * Domain boundary barrel: centralizes Tango runtime ownership APIs.\n */\n\ndeclare global {\n    interface TangoSchemaModelAugmentations<\n        TSchema extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>,\n        TKey extends string = string,\n    > {\n        readonly objects: ModelManager<PersistedModelOutput<TSchema>, Model<TSchema, TKey>>;\n    }\n}\n\nregisterModelObjects();\n\nexport { registerModelObjects } from '../manager/registerModelObjects';\nexport { TangoRuntime } from './TangoRuntime';\nexport { getTangoRuntime, initializeTangoRuntime, resetTangoRuntime } from './defaultRuntime';\n"],"mappings":";;;;;;;;;;;;;AAkBA,sBAAsB"}

package/dist/transaction/AtomicTransaction.d.ts

@@ -0,0 +1,32 @@
+export interface OnCommitOptions {
+    robust?: boolean;
+}
+export interface SavepointOptions {
+    throwOnError?: boolean;
+}
+/**
+ * Result returned by `tx.savepoint(...)`.
+ */
+export type SavepointResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: unknown;
+};
+export interface AtomicTransaction {
+    /**
+     * Register a callback that should run only after the outermost transaction commit succeeds.
+     */
+    onCommit(callback: () => void, options?: OnCommitOptions): void;
+    /**
+     * Run work inside a nested savepoint and, by default, capture rollback as a result object instead of throwing.
+     */
+    savepoint<T>(work: (tx: AtomicTransaction) => Promise<T> | T): Promise<SavepointResult<T>>;
+    savepoint<T>(work: (tx: AtomicTransaction) => Promise<T> | T, options: {
+        throwOnError: false;
+    }): Promise<SavepointResult<T>>;
+    savepoint<T>(work: (tx: AtomicTransaction) => Promise<T> | T, options: {
+        throwOnError: true;
+    }): Promise<T>;
+}

package/dist/transaction/UnitOfWork.d.ts

@@ -15,6 +15,9 @@ import type { DBClient } from '../connection/clients/DBClient';
  *   throw error;
  * }
  * ```
+ *
+ * @deprecated Use `transaction.atomic(async (tx) => { ... })` for application
+ * transaction workflows. `UnitOfWork` remains exported only for compatibility.
  */
 export declare class UnitOfWork {
     static readonly BRAND: "tango.orm.unit_of_work";

package/dist/transaction/atomic.d.ts

@@ -0,0 +1,2 @@
+import type { AtomicTransaction } from './AtomicTransaction';
+export declare function atomic<T>(work: (tx: AtomicTransaction) => Promise<T> | T): Promise<T>;

package/dist/transaction/index.d.ts

@@ -1,4 +1,6 @@
 /**
  * Domain boundary barrel: centralizes this subdomain's public contract.
  */
+export { atomic } from './atomic';
+export type { AtomicTransaction, OnCommitOptions, SavepointOptions, SavepointResult } from './AtomicTransaction';
 export { UnitOfWork } from './UnitOfWork';

package/dist/transaction/index.js

@@ -1,3 +1,6 @@
-import { UnitOfWork } from "../transaction-DooTMuAl.js";
+import "../PostgresClient-BQJZfEOT.js";
+import "../SqliteClient-CjOK9-ki.js";
+import "../defaultRuntime-BPK9kWEW.js";
+import { UnitOfWork, atomic } from "../transaction-Cs0Z9tbW.js";
 
-export { UnitOfWork };
+export { UnitOfWork, atomic };

package/dist/transaction/internal/context/AsyncLocalTransactionEngine.d.ts

@@ -0,0 +1,21 @@
+import type { TangoRuntime } from '../../../runtime/TangoRuntime';
+import type { TransactionClientLease } from '../../../runtime/internal/DBClientProvider';
+import type { AtomicTransaction, SavepointOptions, SavepointResult } from '../../AtomicTransaction';
+import type { TransactionState } from './TransactionState';
+export declare class AsyncLocalTransactionEngine {
+    private readonly logger;
+    private readonly storage;
+    assertNoActiveAtomicTransaction(): void;
+    getActiveTransaction(runtime: TangoRuntime): AtomicTransaction | undefined;
+    getActiveLease(runtime: TangoRuntime): TransactionClientLease | undefined;
+    atomic<T>(runtime: TangoRuntime, work: (tx: AtomicTransaction) => Promise<T> | T): Promise<T>;
+    runSavepoint<T>(state: TransactionState, work: (tx: AtomicTransaction) => Promise<T> | T, options: SavepointOptions): Promise<T | SavepointResult<T>>;
+    private runNested;
+    private pushFrame;
+    private popFrame;
+    private rollbackOuter;
+    private runCommittedCallbacks;
+    private deactivateAllFrames;
+    private attachCause;
+    private isErrorValue;
+}

package/dist/transaction/internal/context/CallbackRecord.d.ts

@@ -0,0 +1,5 @@
+export type CallbackRecord = {
+    order: number;
+    callback: () => void;
+    robust: boolean;
+};

package/dist/transaction/internal/context/FrameBoundTransaction.d.ts

@@ -0,0 +1,20 @@
+import type { AtomicTransaction, OnCommitOptions, SavepointResult } from '../../AtomicTransaction';
+import type { AsyncLocalTransactionEngine } from './AsyncLocalTransactionEngine';
+import type { TransactionFrame } from './TransactionFrame';
+import type { TransactionState } from './TransactionState';
+export declare class FrameBoundTransaction implements AtomicTransaction {
+    private readonly engine;
+    private readonly state;
+    private readonly frame;
+    private active;
+    constructor(engine: AsyncLocalTransactionEngine, state: TransactionState, frame: TransactionFrame);
+    onCommit(callback: () => void, options?: OnCommitOptions): void;
+    savepoint<T>(work: (tx: AtomicTransaction) => Promise<T> | T): Promise<SavepointResult<T>>;
+    savepoint<T>(work: (tx: AtomicTransaction) => Promise<T> | T, options: {
+        throwOnError: false;
+    }): Promise<SavepointResult<T>>;
+    savepoint<T>(work: (tx: AtomicTransaction) => Promise<T> | T, options: {
+        throwOnError: true;
+    }): Promise<T>;
+    deactivate(): void;
+}

package/dist/transaction/internal/context/FrameTransactionHandle.d.ts

@@ -0,0 +1,4 @@
+import type { AtomicTransaction } from '../../AtomicTransaction';
+export interface FrameTransactionHandle extends AtomicTransaction {
+    deactivate(): void;
+}

package/dist/transaction/internal/context/TransactionEngine.d.ts

@@ -0,0 +1,16 @@
+import type { TangoRuntime } from '../../../runtime/TangoRuntime';
+import type { TransactionClientLease } from '../../../runtime/internal/DBClientProvider';
+import type { AtomicTransaction } from '../../AtomicTransaction';
+/**
+ * Runtime-bound transaction facade used by internal ORM/runtime components.
+ */
+export declare class TransactionEngine {
+    private readonly runtime;
+    private static readonly engine;
+    private constructor();
+    static forRuntime(runtime: TangoRuntime): TransactionEngine;
+    static assertNoActiveAtomicTransaction(): void;
+    getActiveTransaction(): AtomicTransaction | undefined;
+    getActiveLease(): TransactionClientLease | undefined;
+    atomic<T>(work: (tx: AtomicTransaction) => Promise<T> | T): Promise<T>;
+}

package/dist/transaction/internal/context/TransactionFrame.d.ts

@@ -0,0 +1,7 @@
+import type { CallbackRecord } from './CallbackRecord';
+import type { FrameTransactionHandle } from './FrameTransactionHandle';
+export type TransactionFrame = {
+    callbacks: CallbackRecord[];
+    facade: FrameTransactionHandle;
+    savepointName?: string;
+};

package/dist/transaction/internal/context/TransactionState.d.ts

@@ -0,0 +1,10 @@
+import type { TangoRuntime } from '../../../runtime/TangoRuntime';
+import type { TransactionClientLease } from '../../../runtime/internal/DBClientProvider';
+import type { TransactionFrame } from './TransactionFrame';
+export type TransactionState = {
+    runtime: TangoRuntime;
+    lease: TransactionClientLease;
+    frames: TransactionFrame[];
+    nextCallbackOrder: number;
+    nextSavepointId: number;
+};

package/dist/transaction/internal/context/index.d.ts

@@ -0,0 +1 @@
+export { TransactionEngine } from './TransactionEngine';

package/dist/{transaction-DooTMuAl.js → transaction-Cs0Z9tbW.js}

@@ -1,5 +1,12 @@
 import { __export } from "./chunk-DLY2FNSh.js";
+import { TransactionEngine, getTangoRuntime } from "./defaultRuntime-BPK9kWEW.js";
 
+//#region src/transaction/atomic.ts
+async function atomic(work) {
+	return TransactionEngine.forRuntime(getTangoRuntime()).atomic(work);
+}
+
+//#endregion
 //#region src/transaction/UnitOfWork.ts
 var UnitOfWork = class UnitOfWork {
 	static BRAND = "tango.orm.unit_of_work";
@@ -19,6 +26,7 @@ var UnitOfWork = class UnitOfWork {
 	* Convenience factory that constructs and begins a unit of work.
 	*/
 	static async start(client) {
+		TransactionEngine.assertNoActiveAtomicTransaction();
 		const uow = new UnitOfWork(client);
 		await uow.begin();
 		return uow;
@@ -27,6 +35,7 @@ var UnitOfWork = class UnitOfWork {
 	* Begin a transaction if one is not already active.
 	*/
 	async begin() {
+		TransactionEngine.assertNoActiveAtomicTransaction();
 		if (!this.isActive) {
 			await this.client.begin();
 			this.isActive = true;
@@ -61,8 +70,11 @@ var UnitOfWork = class UnitOfWork {
 //#endregion
 //#region src/transaction/index.ts
 var transaction_exports = {};
-__export(transaction_exports, { UnitOfWork: () => UnitOfWork });
+__export(transaction_exports, {
+	UnitOfWork: () => UnitOfWork,
+	atomic: () => atomic
+});
 
 //#endregion
-export { UnitOfWork, transaction_exports };
-//# sourceMappingURL=transaction-DooTMuAl.js.map
+export { UnitOfWork, atomic, transaction_exports };
+//# sourceMappingURL=transaction-Cs0Z9tbW.js.map

package/dist/transaction-Cs0Z9tbW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-Cs0Z9tbW.js","names":["work: (tx: AtomicTransaction) => Promise<T> | T","client: DBClient","value: unknown"],"sources":["../src/transaction/atomic.ts","../src/transaction/UnitOfWork.ts","../src/transaction/index.ts"],"sourcesContent":["import { getTangoRuntime } from '../runtime/defaultRuntime';\nimport type { AtomicTransaction } from './AtomicTransaction';\nimport { TransactionEngine } from './internal/context';\n\nexport async function atomic<T>(work: (tx: AtomicTransaction) => Promise<T> | T): Promise<T> {\n    return TransactionEngine.forRuntime(getTangoRuntime()).atomic(work);\n}\n","import type { DBClient } from '../connection/clients/DBClient';\nimport { TransactionEngine } from './internal/context';\n\n/**\n * Unit of Work pattern implementation for managing database transactions.\n * Ensures that a set of operations either all succeed or all fail together.\n *\n * @example\n * ```typescript\n * const uow = await UnitOfWork.start(dbClient);\n * try {\n *   await userRepo.create({ email: 'test@example.com' });\n *   await postRepo.create({ title: 'Hello' });\n *   await uow.commit();\n * } catch (error) {\n *   await uow.rollback();\n *   throw error;\n * }\n * ```\n *\n * @deprecated Use `transaction.atomic(async (tx) => { ... })` for application\n * transaction workflows. `UnitOfWork` remains exported only for compatibility.\n */\nexport class UnitOfWork {\n    static readonly BRAND = 'tango.orm.unit_of_work' as const;\n    readonly __tangoBrand: typeof UnitOfWork.BRAND = UnitOfWork.BRAND;\n    protected client: DBClient;\n    protected isActive = false;\n\n    constructor(client: DBClient) {\n        this.client = client;\n    }\n\n    /**\n     * Narrow an unknown value to `UnitOfWork`.\n     */\n    static isUnitOfWork(value: unknown): value is UnitOfWork {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === UnitOfWork.BRAND\n        );\n    }\n\n    /**\n     * Convenience factory that constructs and begins a unit of work.\n     */\n    static async start(client: DBClient): Promise<UnitOfWork> {\n        TransactionEngine.assertNoActiveAtomicTransaction();\n        const uow = new UnitOfWork(client);\n        await uow.begin();\n        return uow;\n    }\n\n    /**\n     * Begin a transaction if one is not already active.\n     */\n    async begin(): Promise<void> {\n        TransactionEngine.assertNoActiveAtomicTransaction();\n        if (!this.isActive) {\n            await this.client.begin();\n            this.isActive = true;\n        }\n    }\n\n    /**\n     * Commit the active transaction.\n     */\n    async commit(): Promise<void> {\n        if (this.isActive) {\n            await this.client.commit();\n            this.isActive = false;\n        }\n    }\n\n    /**\n     * Return the underlying database client.\n     */\n    getClient(): DBClient {\n        return this.client;\n    }\n\n    /**\n     * Roll back the active transaction.\n     */\n    async rollback(): Promise<void> {\n        if (this.isActive) {\n            await this.client.rollback();\n            this.isActive = false;\n        }\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { atomic } from './atomic';\nexport type { AtomicTransaction, OnCommitOptions, SavepointOptions, SavepointResult } from './AtomicTransaction';\nexport { UnitOfWork } from './UnitOfWork';\n"],"mappings":";;;;AAIO,eAAe,OAAUA,MAA6D;AACzF,QAAO,kBAAkB,WAAW,iBAAiB,CAAC,CAAC,OAAO,KAAK;AACtE;;;;ICiBY,aAAN,MAAM,WAAW;CACpB,OAAgB,QAAQ;CACxB,eAAiD,WAAW;CAC5D;CACA,WAAqB;CAErB,YAAYC,QAAkB;AAC1B,OAAK,SAAS;CACjB;;;;CAKD,OAAO,aAAaC,OAAqC;AACrD,gBACW,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB,WAAW;CAEzE;;;;CAKD,aAAa,MAAMD,QAAuC;AACtD,oBAAkB,iCAAiC;EACnD,MAAM,MAAM,IAAI,WAAW;AAC3B,QAAM,IAAI,OAAO;AACjB,SAAO;CACV;;;;CAKD,MAAM,QAAuB;AACzB,oBAAkB,iCAAiC;AACnD,OAAK,KAAK,UAAU;AAChB,SAAM,KAAK,OAAO,OAAO;AACzB,QAAK,WAAW;EACnB;CACJ;;;;CAKD,MAAM,SAAwB;AAC1B,MAAI,KAAK,UAAU;AACf,SAAM,KAAK,OAAO,QAAQ;AAC1B,QAAK,WAAW;EACnB;CACJ;;;;CAKD,YAAsB;AAClB,SAAO,KAAK;CACf;;;;CAKD,MAAM,WAA0B;AAC5B,MAAI,KAAK,UAAU;AACf,SAAM,KAAK,OAAO,UAAU;AAC5B,QAAK,WAAW;EACnB;CACJ;AACJ"}