@danceroutine/tango-orm 1.2.0 → 1.4.0

package/dist/defaultRuntime-BPK9kWEW.js

@@ -0,0 +1,447 @@
+import { PostgresClient } from "./PostgresClient-BQJZfEOT.js";
+import { SqliteClient } from "./SqliteClient-CjOK9-ki.js";
+import pg from "pg";
+import { createRequire } from "node:module";
+import { getLogger } from "@danceroutine/tango-core";
+import { AsyncLocalStorage } from "node:async_hooks";
+import { loadConfig, loadConfigFromProjectRoot } from "@danceroutine/tango-config";
+
+//#region src/transaction/internal/context/FrameBoundTransaction.ts
+var FrameBoundTransaction = class {
+	active = true;
+	constructor(engine, state, frame) {
+		this.engine = engine;
+		this.state = state;
+		this.frame = frame;
+	}
+	onCommit(callback, options = {}) {
+		if (!this.active) throw new Error("Cannot register an on-commit callback on an inactive transaction frame.");
+		this.frame.callbacks.push({
+			order: this.state.nextCallbackOrder++,
+			callback,
+			robust: options.robust ?? false
+		});
+	}
+	async savepoint(work, options = {}) {
+		if (!this.active) throw new Error("Cannot open a savepoint from an inactive transaction frame.");
+		return this.engine.runSavepoint(this.state, work, options);
+	}
+	deactivate() {
+		this.active = false;
+	}
+};
+
+//#endregion
+//#region src/transaction/internal/context/AsyncLocalTransactionEngine.ts
+var AsyncLocalTransactionEngine = class {
+	logger = getLogger("tango.orm.transaction");
+	storage = new AsyncLocalStorage();
+	assertNoActiveAtomicTransaction() {
+		if (this.storage.getStore()) throw new Error("UnitOfWork is unsupported inside transaction.atomic(...).");
+	}
+	getActiveTransaction(runtime) {
+		const state = this.storage.getStore();
+		if (!state || state.runtime !== runtime) return undefined;
+		return state.frames.at(-1)?.facade;
+	}
+	getActiveLease(runtime) {
+		const state = this.storage.getStore();
+		if (!state || state.runtime !== runtime) return undefined;
+		return state.lease;
+	}
+	async atomic(runtime, work) {
+		const existing = this.storage.getStore();
+		if (existing) {
+			if (existing.runtime !== runtime) throw new Error("Cannot open a transaction for one Tango runtime while another runtime transaction is active.");
+			return this.runNested(existing, work);
+		}
+		const lease = await runtime.leaseTransactionClient();
+		const state = {
+			runtime,
+			lease,
+			frames: [],
+			nextCallbackOrder: 0,
+			nextSavepointId: 0
+		};
+		try {
+			return await this.storage.run(state, async () => {
+				await lease.client.begin();
+				const frame = this.pushFrame(state);
+				try {
+					const result = await work(frame.facade);
+					await lease.client.commit();
+					const root = this.popFrame(state);
+					root.facade.deactivate();
+					await this.runCommittedCallbacks(root.callbacks);
+					return result;
+				} catch (error) {
+					await this.rollbackOuter(state, error);
+					throw error;
+				}
+			});
+		} finally {
+			this.deactivateAllFrames(state);
+			await lease.release();
+		}
+	}
+	async runSavepoint(state, work, options) {
+		try {
+			const value = await this.runNested(state, work);
+			if (options.throwOnError) return value;
+			return {
+				ok: true,
+				value
+			};
+		} catch (error) {
+			if (options.throwOnError) throw error;
+			return {
+				ok: false,
+				error
+			};
+		}
+	}
+	async runNested(state, work) {
+		const savepointName = `tango_sp_${state.nextSavepointId++}`;
+		await state.lease.client.createSavepoint(savepointName);
+		const frame = this.pushFrame(state, savepointName);
+		try {
+			const result = await work(frame.facade);
+			await state.lease.client.releaseSavepoint(savepointName);
+			const completed = this.popFrame(state);
+			completed.facade.deactivate();
+			const parent = state.frames.at(-1);
+			if (!parent) throw new Error("Nested transaction frame completed without a parent frame.");
+			parent.callbacks.push(...completed.callbacks);
+			parent.callbacks.sort((left, right) => left.order - right.order);
+			return result;
+		} catch (error) {
+			try {
+				await state.lease.client.rollbackToSavepoint(savepointName);
+			} catch (rollbackError) {
+				throw this.attachCause(rollbackError, error);
+			} finally {
+				const discarded = this.popFrame(state);
+				discarded.facade.deactivate();
+			}
+			throw error;
+		}
+	}
+	pushFrame(state, savepointName) {
+		const frame = {};
+		const facade = new FrameBoundTransaction(this, state, frame);
+		frame.callbacks = [];
+		frame.facade = facade;
+		frame.savepointName = savepointName;
+		state.frames.push(frame);
+		return frame;
+	}
+	popFrame(state) {
+		const frame = state.frames.pop();
+		if (!frame) throw new Error("Transaction frame stack underflow.");
+		return frame;
+	}
+	async rollbackOuter(state, error) {
+		try {
+			await state.lease.client.rollback();
+		} catch (rollbackError) {
+			throw this.attachCause(rollbackError, error);
+		} finally {
+			while (state.frames.length > 0) {
+				const frame = this.popFrame(state);
+				frame.facade.deactivate();
+			}
+		}
+	}
+	async runCommittedCallbacks(callbacks) {
+		for (const record of callbacks) try {
+			await record.callback();
+		} catch (error) {
+			if (!record.robust) throw error;
+			try {
+				this.logger.error("Post-commit callback failed.", error);
+			} catch {}
+		}
+	}
+	deactivateAllFrames(state) {
+		state.frames.length = 0;
+	}
+	attachCause(error, cause) {
+		if (!this.isErrorValue(error)) return error;
+		if ("cause" in error && error.cause !== undefined) return error;
+		try {
+			return new Error(error.message, { cause });
+		} catch {
+			return error;
+		}
+	}
+	isErrorValue(value) {
+		return typeof value === "object" && value !== null && typeof value.message === "string" && typeof value.name === "string";
+	}
+};
+
+//#endregion
+//#region src/transaction/internal/context/TransactionEngine.ts
+var TransactionEngine = class TransactionEngine {
+	static engine = new AsyncLocalTransactionEngine();
+	constructor(runtime) {
+		this.runtime = runtime;
+	}
+	static forRuntime(runtime) {
+		return new TransactionEngine(runtime);
+	}
+	static assertNoActiveAtomicTransaction() {
+		this.engine.assertNoActiveAtomicTransaction();
+	}
+	getActiveTransaction() {
+		return TransactionEngine.engine.getActiveTransaction(this.runtime);
+	}
+	getActiveLease() {
+		return TransactionEngine.engine.getActiveLease(this.runtime);
+	}
+	async atomic(work) {
+		return TransactionEngine.engine.atomic(this.runtime, work);
+	}
+};
+
+//#endregion
+//#region src/manager/internal/RuntimeBoundClient.ts
+var RuntimeBoundClient = class {
+	constructor(runtime) {
+		this.runtime = runtime;
+	}
+	async query(sql, params) {
+		const lease = TransactionEngine.forRuntime(this.runtime).getActiveLease();
+		if (lease) return lease.client.query(sql, params);
+		const runtimeWithQuery = this.runtime;
+		if (typeof runtimeWithQuery.query === "function") return runtimeWithQuery.query(sql, params);
+		const client = await this.runtime.getClient();
+		return client.query(sql, params);
+	}
+	async begin() {
+		throw new Error("Runtime-bound clients do not support manual begin(). Use transaction.atomic(...) instead.");
+	}
+	async commit() {
+		throw new Error("Runtime-bound clients do not support manual commit(). Use transaction.atomic(...) instead.");
+	}
+	async rollback() {
+		throw new Error("Runtime-bound clients do not support manual rollback(). Use transaction.atomic(...) instead.");
+	}
+	async createSavepoint(_name) {
+		throw new Error("Runtime-bound clients do not support manual savepoints. Use transaction.atomic(...) or tx.savepoint(...) instead.");
+	}
+	async releaseSavepoint(_name) {
+		throw new Error("Runtime-bound clients do not support manual savepoint release. Use transaction.atomic(...) or tx.savepoint(...) instead.");
+	}
+	async rollbackToSavepoint(_name) {
+		throw new Error("Runtime-bound clients do not support manual savepoint rollback. Use transaction.atomic(...) or tx.savepoint(...) instead.");
+	}
+	async close() {
+		throw new Error("Runtime-bound clients do not support manual close(). Use TangoRuntime.reset() instead.");
+	}
+};
+
+//#endregion
+//#region src/runtime/internal/PostgresDBClientProvider.ts
+const { Pool } = pg;
+var PostgresDBClientProvider = class {
+	pool;
+	activeLeaseCount = 0;
+	constructor(config) {
+		this.pool = new Pool({
+			connectionString: config.url,
+			host: config.host,
+			port: config.port,
+			database: config.database,
+			user: config.user,
+			password: config.password,
+			max: config.maxConnections || 10
+		});
+	}
+	async query(sql, params) {
+		const result = await this.pool.query(sql, params);
+		return { rows: result.rows };
+	}
+	async leaseTransactionClient() {
+		const client = await this.pool.connect();
+		this.activeLeaseCount += 1;
+		let released = false;
+		return {
+			client: new PostgresClient(client),
+			release: async () => {
+				if (released) return;
+				released = true;
+				this.activeLeaseCount -= 1;
+				client.release();
+			}
+		};
+	}
+	async reset() {
+		if (this.activeLeaseCount > 0) throw new Error("Cannot reset Tango runtime while transaction leases are still active.");
+		await this.pool.end();
+	}
+};
+
+//#endregion
+//#region src/runtime/internal/SqliteDBClientProvider.ts
+var SqliteDBClientProvider = class {
+	filename;
+	Database;
+	autocommitClient;
+	activeLeaseCount = 0;
+	constructor(config = {}) {
+		this.Database = this.getDatabaseCtor();
+		this.filename = typeof config.filename === "string" && config.filename.length > 0 ? config.filename : ":memory:";
+		this.autocommitClient = this.openClient(this.filename);
+	}
+	async query(sql, params) {
+		return this.autocommitClient.query(sql, params);
+	}
+	async leaseTransactionClient() {
+		if (this.filename === ":memory:") throw new Error("transaction.atomic(...) requires a file-backed SQLite database. :memory: is unsupported.");
+		const client = this.openClient(this.filename);
+		this.activeLeaseCount += 1;
+		let released = false;
+		return {
+			client,
+			release: async () => {
+				if (released) return;
+				released = true;
+				this.activeLeaseCount -= 1;
+				await client.close();
+			}
+		};
+	}
+	async reset() {
+		if (this.activeLeaseCount > 0) throw new Error("Cannot reset Tango runtime while transaction leases are still active.");
+		await this.autocommitClient.close();
+	}
+	openClient(filename) {
+		const db = new this.Database(filename);
+		db.pragma("journal_mode = WAL");
+		db.pragma("foreign_keys = ON");
+		db.pragma("busy_timeout = 5000");
+		return new SqliteClient(db);
+	}
+	getDatabaseCtor() {
+		const require = createRequire(import.meta.url);
+		const moduleValue = require("better-sqlite3");
+		if (typeof moduleValue === "function") return moduleValue;
+		const defaultExport = moduleValue.default;
+		if (typeof defaultExport === "function") return defaultExport;
+		throw new TypeError("Failed to load better-sqlite3 constructor.");
+	}
+};
+
+//#endregion
+//#region src/runtime/internal/createDBClientProvider.ts
+function createDBClientProvider(config) {
+	switch (config.adapter) {
+		case "postgres": return new PostgresDBClientProvider(config);
+		case "sqlite": return new SqliteDBClientProvider(config);
+		default: throw new Error(`Unsupported adapter for Tango runtime provider: ${config.adapter}`);
+	}
+}
+
+//#endregion
+//#region src/runtime/TangoRuntime.ts
+var TangoRuntime = class TangoRuntime {
+	static BRAND = "tango.orm.runtime";
+	__tangoBrand = TangoRuntime.BRAND;
+	loadedConfig;
+	providerPromise = null;
+	runtimeClientPromise = 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 runtime-bound DB client facade used by manager-backed code.
+	*/
+	async getClient() {
+		if (!this.runtimeClientPromise) this.runtimeClientPromise = Promise.resolve(new RuntimeBoundClient(this));
+		return this.runtimeClientPromise;
+	}
+	/**
+	* Execute SQL through the autocommit path owned by this runtime.
+	*/
+	async query(sql, params) {
+		const provider = await this.getProvider();
+		return provider.query(sql, params);
+	}
+	/**
+	* Lease a transaction-scoped client for `transaction.atomic(...)`.
+	*/
+	async leaseTransactionClient() {
+		const provider = await this.getProvider();
+		return provider.leaseTransactionClient();
+	}
+	/**
+	* Close and clear the cached runtime resources so tests can start fresh.
+	*/
+	async reset() {
+		if (!this.providerPromise) {
+			this.runtimeClientPromise = null;
+			return;
+		}
+		const provider = await this.providerPromise;
+		this.providerPromise = null;
+		this.runtimeClientPromise = null;
+		await provider.reset();
+	}
+	async getProvider() {
+		if (!this.providerPromise) {
+			const db = this.loadedConfig.current.db;
+			this.providerPromise = Promise.resolve(createDBClientProvider({
+				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.providerPromise;
+	}
+};
+
+//#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
+export { RuntimeBoundClient, TangoRuntime, TransactionEngine, getTangoRuntime, initializeTangoRuntime, resetTangoRuntime };
+//# sourceMappingURL=defaultRuntime-BPK9kWEW.js.map

package/dist/defaultRuntime-BPK9kWEW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRuntime-BPK9kWEW.js","names":["engine: AsyncLocalTransactionEngine","state: TransactionState","frame: TransactionFrame","callback: () => void","options: OnCommitOptions","work: (tx: AtomicTransaction) => Promise<T> | T","options: SavepointOptions","runtime: TangoRuntime","work: (tx: AtomicTransaction) => Promise<T> | T","state: TransactionState","options: SavepointOptions","savepointName?: string","error: unknown","callbacks: readonly CallbackRecord[]","cause: unknown","value: unknown","runtime: TangoRuntime","work: (tx: AtomicTransaction) => Promise<T> | T","runtime: TangoRuntime","sql: string","params?: readonly unknown[]","_name: string","config: AdapterConfig","sql: string","params?: readonly unknown[]","config: AdapterConfig","sql: string","params?: readonly unknown[]","filename: string","config: AdapterConfig & { adapter: string }","loadLoadedConfig: () => LoadedConfig","value: unknown","sql: string","params?: readonly unknown[]","defaultRuntime: TangoRuntime | null","fromFile: () => unknown"],"sources":["../src/transaction/internal/context/FrameBoundTransaction.ts","../src/transaction/internal/context/AsyncLocalTransactionEngine.ts","../src/transaction/internal/context/TransactionEngine.ts","../src/manager/internal/RuntimeBoundClient.ts","../src/runtime/internal/PostgresDBClientProvider.ts","../src/runtime/internal/SqliteDBClientProvider.ts","../src/runtime/internal/createDBClientProvider.ts","../src/runtime/TangoRuntime.ts","../src/runtime/defaultRuntime.ts"],"sourcesContent":["import type { AtomicTransaction, OnCommitOptions, SavepointOptions, SavepointResult } from '../../AtomicTransaction';\nimport type { AsyncLocalTransactionEngine } from './AsyncLocalTransactionEngine';\nimport type { TransactionFrame } from './TransactionFrame';\nimport type { TransactionState } from './TransactionState';\n\nexport class FrameBoundTransaction implements AtomicTransaction {\n    private active = true;\n\n    constructor(\n        private readonly engine: AsyncLocalTransactionEngine,\n        private readonly state: TransactionState,\n        private readonly frame: TransactionFrame\n    ) {}\n\n    onCommit(callback: () => void, options: OnCommitOptions = {}): void {\n        if (!this.active) {\n            throw new Error('Cannot register an on-commit callback on an inactive transaction frame.');\n        }\n\n        this.frame.callbacks.push({\n            order: this.state.nextCallbackOrder++,\n            callback,\n            robust: options.robust ?? false,\n        });\n    }\n\n    savepoint<T>(work: (tx: AtomicTransaction) => Promise<T> | T): Promise<SavepointResult<T>>;\n    savepoint<T>(\n        work: (tx: AtomicTransaction) => Promise<T> | T,\n        options: { throwOnError: false }\n    ): Promise<SavepointResult<T>>;\n    savepoint<T>(work: (tx: AtomicTransaction) => Promise<T> | T, options: { throwOnError: true }): Promise<T>;\n    async savepoint<T>(\n        work: (tx: AtomicTransaction) => Promise<T> | T,\n        options: SavepointOptions = {}\n    ): Promise<T | SavepointResult<T>> {\n        if (!this.active) {\n            throw new Error('Cannot open a savepoint from an inactive transaction frame.');\n        }\n\n        return this.engine.runSavepoint(this.state, work, options);\n    }\n\n    deactivate(): void {\n        this.active = false;\n    }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\nimport { getLogger } from '@danceroutine/tango-core';\nimport type { TangoRuntime } from '../../../runtime/TangoRuntime';\nimport type { TransactionClientLease } from '../../../runtime/internal/DBClientProvider';\nimport type { AtomicTransaction, SavepointOptions, SavepointResult } from '../../AtomicTransaction';\nimport type { CallbackRecord } from './CallbackRecord';\nimport { FrameBoundTransaction } from './FrameBoundTransaction';\nimport type { TransactionFrame } from './TransactionFrame';\nimport type { TransactionState } from './TransactionState';\n\nexport class AsyncLocalTransactionEngine {\n    private readonly logger = getLogger('tango.orm.transaction');\n    private readonly storage = new AsyncLocalStorage<TransactionState>();\n\n    assertNoActiveAtomicTransaction(): void {\n        if (this.storage.getStore()) {\n            throw new Error('UnitOfWork is unsupported inside transaction.atomic(...).');\n        }\n    }\n\n    getActiveTransaction(runtime: TangoRuntime): AtomicTransaction | undefined {\n        const state = this.storage.getStore();\n        if (!state || state.runtime !== runtime) {\n            return undefined;\n        }\n\n        return state.frames.at(-1)?.facade;\n    }\n\n    getActiveLease(runtime: TangoRuntime): TransactionClientLease | undefined {\n        const state = this.storage.getStore();\n        if (!state || state.runtime !== runtime) {\n            return undefined;\n        }\n\n        return state.lease;\n    }\n\n    async atomic<T>(runtime: TangoRuntime, work: (tx: AtomicTransaction) => Promise<T> | T): Promise<T> {\n        const existing = this.storage.getStore();\n        if (existing) {\n            if (existing.runtime !== runtime) {\n                throw new Error(\n                    'Cannot open a transaction for one Tango runtime while another runtime transaction is active.'\n                );\n            }\n\n            return this.runNested(existing, work);\n        }\n\n        const lease = await runtime.leaseTransactionClient();\n        const state: TransactionState = {\n            runtime,\n            lease,\n            frames: [],\n            nextCallbackOrder: 0,\n            nextSavepointId: 0,\n        };\n\n        try {\n            return await this.storage.run(state, async () => {\n                await lease.client.begin();\n                const frame = this.pushFrame(state);\n\n                try {\n                    const result = await work(frame.facade);\n                    await lease.client.commit();\n                    const root = this.popFrame(state);\n                    root.facade.deactivate();\n                    await this.runCommittedCallbacks(root.callbacks);\n                    return result;\n                } catch (error) {\n                    await this.rollbackOuter(state, error);\n                    throw error;\n                }\n            });\n        } finally {\n            this.deactivateAllFrames(state);\n            await lease.release();\n        }\n    }\n\n    async runSavepoint<T>(\n        state: TransactionState,\n        work: (tx: AtomicTransaction) => Promise<T> | T,\n        options: SavepointOptions\n    ): Promise<T | SavepointResult<T>> {\n        try {\n            const value = await this.runNested(state, work);\n            if (options.throwOnError) {\n                return value;\n            }\n\n            return {\n                ok: true,\n                value,\n            };\n        } catch (error) {\n            if (options.throwOnError) {\n                throw error;\n            }\n\n            return {\n                ok: false,\n                error,\n            };\n        }\n    }\n\n    private async runNested<T>(state: TransactionState, work: (tx: AtomicTransaction) => Promise<T> | T): Promise<T> {\n        const savepointName = `tango_sp_${state.nextSavepointId++}`;\n        await state.lease.client.createSavepoint(savepointName);\n        const frame = this.pushFrame(state, savepointName);\n\n        try {\n            const result = await work(frame.facade);\n            await state.lease.client.releaseSavepoint(savepointName);\n            const completed = this.popFrame(state);\n            completed.facade.deactivate();\n            const parent = state.frames.at(-1);\n            if (!parent) {\n                throw new Error('Nested transaction frame completed without a parent frame.');\n            }\n\n            parent.callbacks.push(...completed.callbacks);\n            parent.callbacks.sort((left, right) => left.order - right.order);\n            return result;\n        } catch (error) {\n            try {\n                await state.lease.client.rollbackToSavepoint(savepointName);\n            } catch (rollbackError) {\n                throw this.attachCause(rollbackError, error);\n            } finally {\n                const discarded = this.popFrame(state);\n                discarded.facade.deactivate();\n            }\n\n            throw error;\n        }\n    }\n\n    private pushFrame(state: TransactionState, savepointName?: string): TransactionFrame {\n        const frame = {} as TransactionFrame;\n        const facade = new FrameBoundTransaction(this, state, frame);\n        frame.callbacks = [];\n        frame.facade = facade;\n        frame.savepointName = savepointName;\n        state.frames.push(frame);\n        return frame;\n    }\n\n    private popFrame(state: TransactionState): TransactionFrame {\n        const frame = state.frames.pop();\n        if (!frame) {\n            throw new Error('Transaction frame stack underflow.');\n        }\n\n        return frame;\n    }\n\n    private async rollbackOuter(state: TransactionState, error: unknown): Promise<void> {\n        try {\n            await state.lease.client.rollback();\n        } catch (rollbackError) {\n            throw this.attachCause(rollbackError, error);\n        } finally {\n            while (state.frames.length > 0) {\n                const frame = this.popFrame(state);\n                frame.facade.deactivate();\n            }\n        }\n    }\n\n    private async runCommittedCallbacks(callbacks: readonly CallbackRecord[]): Promise<void> {\n        for (const record of callbacks) {\n            try {\n                await record.callback();\n            } catch (error) {\n                if (!record.robust) {\n                    throw error;\n                }\n\n                try {\n                    this.logger.error('Post-commit callback failed.', error);\n                } catch {\n                    // A logging backend failure cannot change the already-committed outcome.\n                }\n            }\n        }\n    }\n\n    private deactivateAllFrames(state: TransactionState): void {\n        state.frames.length = 0;\n    }\n\n    private attachCause(error: unknown, cause: unknown): unknown {\n        if (!this.isErrorValue(error)) {\n            return error;\n        }\n\n        if ('cause' in error && error.cause !== undefined) {\n            return error;\n        }\n\n        try {\n            return new Error(error.message, { cause });\n        } catch {\n            return error;\n        }\n    }\n\n    private isErrorValue(value: unknown): value is Error {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            typeof (value as { message?: unknown }).message === 'string' &&\n            typeof (value as { name?: unknown }).name === 'string'\n        );\n    }\n}\n","import type { TangoRuntime } from '../../../runtime/TangoRuntime';\nimport type { TransactionClientLease } from '../../../runtime/internal/DBClientProvider';\nimport type { AtomicTransaction } from '../../AtomicTransaction';\nimport { AsyncLocalTransactionEngine } from './AsyncLocalTransactionEngine';\n\n/**\n * Runtime-bound transaction facade used by internal ORM/runtime components.\n */\nexport class TransactionEngine {\n    private static readonly engine = new AsyncLocalTransactionEngine();\n\n    private constructor(private readonly runtime: TangoRuntime) {}\n\n    static forRuntime(runtime: TangoRuntime): TransactionEngine {\n        return new TransactionEngine(runtime);\n    }\n\n    static assertNoActiveAtomicTransaction(): void {\n        this.engine.assertNoActiveAtomicTransaction();\n    }\n\n    getActiveTransaction(): AtomicTransaction | undefined {\n        return TransactionEngine.engine.getActiveTransaction(this.runtime);\n    }\n\n    getActiveLease(): TransactionClientLease | undefined {\n        return TransactionEngine.engine.getActiveLease(this.runtime);\n    }\n\n    async atomic<T>(work: (tx: AtomicTransaction) => Promise<T> | T): Promise<T> {\n        return TransactionEngine.engine.atomic(this.runtime, work);\n    }\n}\n","import type { DBClient } from '../../connection/index';\nimport type { TangoRuntime } from '../../runtime/index';\nimport { TransactionEngine } from '../../transaction/internal/context';\n\n/**\n * DB client proxy that resolves either the active transaction lease or the\n * runtime autocommit path lazily.\n */\nexport class RuntimeBoundClient implements DBClient {\n    constructor(private readonly runtime: TangoRuntime) {}\n\n    async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n        const lease = TransactionEngine.forRuntime(this.runtime).getActiveLease();\n        if (lease) {\n            return lease.client.query<T>(sql, params);\n        }\n\n        const runtimeWithQuery = this.runtime as TangoRuntime & {\n            query?: <TResult = unknown>(sql: string, params?: readonly unknown[]) => Promise<{ rows: TResult[] }>;\n        };\n        if (typeof runtimeWithQuery.query === 'function') {\n            return runtimeWithQuery.query<T>(sql, params);\n        }\n\n        const client = await this.runtime.getClient();\n        return client.query<T>(sql, params);\n    }\n\n    async begin(): Promise<void> {\n        throw new Error('Runtime-bound clients do not support manual begin(). Use transaction.atomic(...) instead.');\n    }\n\n    async commit(): Promise<void> {\n        throw new Error('Runtime-bound clients do not support manual commit(). Use transaction.atomic(...) instead.');\n    }\n\n    async rollback(): Promise<void> {\n        throw new Error('Runtime-bound clients do not support manual rollback(). Use transaction.atomic(...) instead.');\n    }\n\n    async createSavepoint(_name: string): Promise<void> {\n        throw new Error(\n            'Runtime-bound clients do not support manual savepoints. Use transaction.atomic(...) or tx.savepoint(...) instead.'\n        );\n    }\n\n    async releaseSavepoint(_name: string): Promise<void> {\n        throw new Error(\n            'Runtime-bound clients do not support manual savepoint release. Use transaction.atomic(...) or tx.savepoint(...) instead.'\n        );\n    }\n\n    async rollbackToSavepoint(_name: string): Promise<void> {\n        throw new Error(\n            'Runtime-bound clients do not support manual savepoint rollback. Use transaction.atomic(...) or tx.savepoint(...) instead.'\n        );\n    }\n\n    async close(): Promise<void> {\n        throw new Error('Runtime-bound clients do not support manual close(). Use TangoRuntime.reset() instead.');\n    }\n}\n","import pg from 'pg';\nimport type { AdapterConfig } from '../../connection/adapters/Adapter';\nimport { PostgresClient } from '../../connection/clients/dialects/PostgresClient';\nimport type { DBClientProvider, TransactionClientLease } from './DBClientProvider';\n\nconst { Pool } = pg;\n\nexport class PostgresDBClientProvider implements DBClientProvider {\n    private readonly pool: pg.Pool;\n    private activeLeaseCount = 0;\n\n    constructor(config: AdapterConfig) {\n        this.pool = new Pool({\n            connectionString: config.url,\n            host: config.host,\n            port: config.port,\n            database: config.database,\n            user: config.user,\n            password: config.password,\n            max: config.maxConnections || 10,\n        });\n    }\n\n    async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n        const result = await this.pool.query(sql, params as unknown[]);\n        return { rows: result.rows as T[] };\n    }\n\n    async leaseTransactionClient(): Promise<TransactionClientLease> {\n        const client = await this.pool.connect();\n        this.activeLeaseCount += 1;\n        let released = false;\n\n        return {\n            client: new PostgresClient(client),\n            release: async () => {\n                if (released) {\n                    return;\n                }\n\n                released = true;\n                this.activeLeaseCount -= 1;\n                client.release();\n            },\n        };\n    }\n\n    async reset(): Promise<void> {\n        if (this.activeLeaseCount > 0) {\n            throw new Error('Cannot reset Tango runtime while transaction leases are still active.');\n        }\n\n        await this.pool.end();\n    }\n}\n","import { createRequire } from 'node:module';\nimport type { Database as BetterSqliteDatabase } from 'better-sqlite3';\nimport type { AdapterConfig } from '../../connection/adapters/Adapter';\nimport { SqliteClient } from '../../connection/clients/dialects/SqliteClient';\nimport type { DBClientProvider, TransactionClientLease } from './DBClientProvider';\n\ntype BetterSqliteCtor = new (filename: string, options?: unknown) => BetterSqliteDatabase;\n\nexport class SqliteDBClientProvider implements DBClientProvider {\n    private readonly filename: string;\n    private readonly Database: BetterSqliteCtor;\n    private readonly autocommitClient: SqliteClient;\n    private activeLeaseCount = 0;\n\n    constructor(config: AdapterConfig = {}) {\n        this.Database = this.getDatabaseCtor();\n        this.filename =\n            typeof config.filename === 'string' && config.filename.length > 0 ? config.filename : ':memory:';\n        this.autocommitClient = this.openClient(this.filename);\n    }\n\n    async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n        return this.autocommitClient.query<T>(sql, params);\n    }\n\n    async leaseTransactionClient(): Promise<TransactionClientLease> {\n        if (this.filename === ':memory:') {\n            throw new Error('transaction.atomic(...) requires a file-backed SQLite database. :memory: is unsupported.');\n        }\n\n        const client = this.openClient(this.filename);\n        this.activeLeaseCount += 1;\n        let released = false;\n\n        return {\n            client,\n            release: async () => {\n                if (released) {\n                    return;\n                }\n\n                released = true;\n                this.activeLeaseCount -= 1;\n                await client.close();\n            },\n        };\n    }\n\n    async reset(): Promise<void> {\n        if (this.activeLeaseCount > 0) {\n            throw new Error('Cannot reset Tango runtime while transaction leases are still active.');\n        }\n\n        await this.autocommitClient.close();\n    }\n\n    private openClient(filename: string): SqliteClient {\n        const db = new this.Database(filename);\n        db.pragma('journal_mode = WAL');\n        db.pragma('foreign_keys = ON');\n        db.pragma('busy_timeout = 5000');\n        return new SqliteClient(db);\n    }\n\n    private getDatabaseCtor(): BetterSqliteCtor {\n        const require = createRequire(import.meta.url);\n        const moduleValue = require('better-sqlite3') as unknown;\n        if (typeof moduleValue === 'function') {\n            return moduleValue as BetterSqliteCtor;\n        }\n\n        const defaultExport = (moduleValue as { default?: unknown }).default;\n        if (typeof defaultExport === 'function') {\n            return defaultExport as BetterSqliteCtor;\n        }\n\n        throw new TypeError('Failed to load better-sqlite3 constructor.');\n    }\n}\n","import type { AdapterConfig } from '../../connection/adapters/Adapter';\nimport type { DBClientProvider } from './DBClientProvider';\nimport { PostgresDBClientProvider } from './PostgresDBClientProvider';\nimport { SqliteDBClientProvider } from './SqliteDBClientProvider';\n\nexport function createDBClientProvider(config: AdapterConfig & { adapter: string }): DBClientProvider {\n    switch (config.adapter) {\n        case 'postgres':\n            return new PostgresDBClientProvider(config);\n        case 'sqlite':\n            return new SqliteDBClientProvider(config);\n        default:\n            throw new Error(`Unsupported adapter for Tango runtime provider: ${config.adapter}`);\n    }\n}\n","import type { LoadedConfig } from '@danceroutine/tango-config';\nimport type { DBClient } from '../connection/index';\nimport type { Dialect } from '../query/domain/index';\nimport { RuntimeBoundClient } from '../manager/internal/RuntimeBoundClient';\nimport type { DBClientProvider, TransactionClientLease } from './internal/DBClientProvider';\nimport { createDBClientProvider } from './internal/createDBClientProvider';\n\n/**\n * Framework-owned database runtime that resolves Tango config and lazily\n * creates the shared connection provider used by manager-backed models.\n */\nexport class TangoRuntime {\n    static readonly BRAND = 'tango.orm.runtime' as const;\n    readonly __tangoBrand: typeof TangoRuntime.BRAND = TangoRuntime.BRAND;\n    private readonly loadedConfig: LoadedConfig;\n    private providerPromise: Promise<DBClientProvider> | null = null;\n    private runtimeClientPromise: Promise<DBClient> | null = null;\n\n    constructor(loadLoadedConfig: () => LoadedConfig) {\n        this.loadedConfig = loadLoadedConfig();\n    }\n\n    /**\n     * Narrow an unknown value to `TangoRuntime`.\n     */\n    static isTangoRuntime(value: unknown): value is TangoRuntime {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === TangoRuntime.BRAND\n        );\n    }\n\n    /**\n     * Return the loaded Tango config snapshot for the active environment.\n     */\n    getConfig(): LoadedConfig {\n        return this.loadedConfig;\n    }\n\n    /**\n     * Return the configured SQL dialect for the current runtime.\n     */\n    getDialect(): Dialect {\n        return this.loadedConfig.current.db.adapter;\n    }\n\n    /**\n     * Return the runtime-bound DB client facade used by manager-backed code.\n     */\n    async getClient(): Promise<DBClient> {\n        if (!this.runtimeClientPromise) {\n            this.runtimeClientPromise = Promise.resolve(new RuntimeBoundClient(this));\n        }\n\n        return this.runtimeClientPromise;\n    }\n\n    /**\n     * Execute SQL through the autocommit path owned by this runtime.\n     */\n    async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n        const provider = await this.getProvider();\n        return provider.query<T>(sql, params);\n    }\n\n    /**\n     * Lease a transaction-scoped client for `transaction.atomic(...)`.\n     */\n    async leaseTransactionClient(): Promise<TransactionClientLease> {\n        const provider = await this.getProvider();\n        return provider.leaseTransactionClient();\n    }\n\n    /**\n     * Close and clear the cached runtime resources so tests can start fresh.\n     */\n    async reset(): Promise<void> {\n        if (!this.providerPromise) {\n            this.runtimeClientPromise = null;\n            return;\n        }\n\n        const provider = await this.providerPromise;\n        this.providerPromise = null;\n        this.runtimeClientPromise = null;\n        await provider.reset();\n    }\n\n    private async getProvider(): Promise<DBClientProvider> {\n        if (!this.providerPromise) {\n            const db = this.loadedConfig.current.db;\n            this.providerPromise = Promise.resolve(\n                createDBClientProvider({\n                    adapter: db.adapter,\n                    url: db.url,\n                    host: db.host,\n                    port: db.port,\n                    database: db.database,\n                    user: db.user,\n                    password: db.password,\n                    filename: db.filename,\n                    maxConnections: db.maxConnections,\n                })\n            );\n        }\n\n        return this.providerPromise;\n    }\n}\n","import { loadConfig, loadConfigFromProjectRoot } from '@danceroutine/tango-config';\nimport { TangoRuntime } from './TangoRuntime';\n\nlet defaultRuntime: TangoRuntime | null = null;\n\n/**\n * Initialize the process-default Tango runtime from a Tango config loader.\n */\nexport function initializeTangoRuntime(fromFile: () => unknown): TangoRuntime {\n    defaultRuntime = new TangoRuntime(() => loadConfig(fromFile));\n    return defaultRuntime;\n}\n\n/**\n * Return the process-default Tango runtime, lazily loading Tango config on first access.\n */\nexport function getTangoRuntime(): TangoRuntime {\n    if (!defaultRuntime) {\n        defaultRuntime = new TangoRuntime(() => loadConfigFromProjectRoot());\n    }\n\n    return defaultRuntime;\n}\n\n/**\n * Reset the process-default Tango runtime and release any cached client.\n */\nexport async function resetTangoRuntime(): Promise<void> {\n    if (!defaultRuntime) {\n        return;\n    }\n\n    const runtime = defaultRuntime;\n    defaultRuntime = null;\n    await runtime.reset();\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -18,4 +18,5 @@ export { Q, QBuilder, QueryCompiler, QuerySet } from './query/index';
 export type { QueryExecutor } from './query/index';
 export type { CompiledQuery, Dialect, Direction, FilterInput, FilterKey, FilterValue, LookupType, OrderSpec, OrderToken, QNode, QueryResult, QuerySetState, RelationMeta, TableMeta, WhereClause, } from './query/domain/index';
 export { getTangoRuntime, initializeTangoRuntime, resetTangoRuntime, TangoRuntime } from './runtime/index';
-export { UnitOfWork } from './transaction/index';
+export { atomic, UnitOfWork } from './transaction/index';
+export type { AtomicTransaction, OnCommitOptions, SavepointOptions, SavepointResult } from './transaction/index';

package/dist/index.js

@@ -1,10 +1,13 @@
-import { PostgresAdapter } from "./PostgresAdapter-C9a1XJRx.js";
-import { SqliteAdapter } from "./SqliteAdapter-Dp6VRXmz.js";
-import { AdapterRegistry, connectDB, connection_exports, getDefaultAdapterRegistry } from "./connection-CVvycXus.js";
-import { ModelManager, TangoRuntime, getTangoRuntime, initializeTangoRuntime, resetTangoRuntime } from "./registerModelObjects-vsX6GzCN.js";
-import { QBuilder, QueryCompiler, QuerySet, query_exports } from "./query-BKt2nKIt.js";
-import { manager_exports } from "./manager-CKUy1CIt.js";
-import { runtime_exports } from "./runtime-BUpil272.js";
-import { UnitOfWork, transaction_exports } from "./transaction-DooTMuAl.js";
+import "./PostgresClient-BQJZfEOT.js";
+import { PostgresAdapter } from "./PostgresAdapter-CMiEpHya.js";
+import "./SqliteClient-CjOK9-ki.js";
+import { SqliteAdapter } from "./SqliteAdapter-CeqhyrPC.js";
+import { AdapterRegistry, connectDB, connection_exports, getDefaultAdapterRegistry } from "./connection-B_K2ZAf7.js";
+import { QBuilder, QueryCompiler, QuerySet, query_exports } from "./query-CWZ1cfjo.js";
+import { TangoRuntime, getTangoRuntime, initializeTangoRuntime, resetTangoRuntime } from "./defaultRuntime-BPK9kWEW.js";
+import { ModelManager } from "./registerModelObjects-Bva_f-Qh.js";
+import { manager_exports } from "./manager-C6oJ2tAF.js";
+import { runtime_exports } from "./runtime-ByXbpVBS.js";
+import { UnitOfWork, atomic, transaction_exports } from "./transaction-Cs0Z9tbW.js";
 
-export { AdapterRegistry, ModelManager, PostgresAdapter, QBuilder as Q, QBuilder, QueryCompiler, QuerySet, SqliteAdapter, TangoRuntime, UnitOfWork, connectDB, connection_exports as connection, getDefaultAdapterRegistry, getTangoRuntime, initializeTangoRuntime, manager_exports as manager, query_exports as query, resetTangoRuntime, runtime_exports as runtime, transaction_exports as transaction };
+export { AdapterRegistry, ModelManager, PostgresAdapter, QBuilder as Q, QBuilder, QueryCompiler, QuerySet, SqliteAdapter, TangoRuntime, UnitOfWork, atomic, connectDB, connection_exports as connection, getDefaultAdapterRegistry, getTangoRuntime, initializeTangoRuntime, manager_exports as manager, query_exports as query, resetTangoRuntime, runtime_exports as runtime, transaction_exports as transaction };

package/dist/manager/ManagerLike.d.ts

@@ -3,13 +3,13 @@ import type { TableMeta } from '../query/domain/index';
 /**
  * Public manager contract consumed by Tango resources and applications.
  */
-export interface ManagerLike<T extends Record<string, unknown>> {
+export interface ManagerLike<TModelRow extends Record<string, unknown>, TSourceModel = unknown> {
     readonly meta: TableMeta;
-    query(): QuerySet<T>;
-    findById(id: T[keyof T]): Promise<T | null>;
-    getOrThrow(id: T[keyof T]): Promise<T>;
-    create(input: Partial<T>): Promise<T>;
-    update(id: T[keyof T], patch: Partial<T>): Promise<T>;
-    delete(id: T[keyof T]): Promise<void>;
-    bulkCreate(inputs: Partial<T>[]): Promise<T[]>;
+    query(): QuerySet<TModelRow, TModelRow, TSourceModel>;
+    findById(id: TModelRow[keyof TModelRow]): Promise<TModelRow | null>;
+    getOrThrow(id: TModelRow[keyof TModelRow]): Promise<TModelRow>;
+    create(input: Partial<TModelRow>): Promise<TModelRow>;
+    update(id: TModelRow[keyof TModelRow], patch: Partial<TModelRow>): Promise<TModelRow>;
+    delete(id: TModelRow[keyof TModelRow]): Promise<void>;
+    bulkCreate(inputs: Partial<TModelRow>[]): Promise<TModelRow[]>;
 }

package/dist/manager/ModelManager.d.ts

@@ -8,7 +8,7 @@ type FieldLike = {
     type: string;
     primaryKey?: boolean;
 };
-type ModelLike<T extends Record<string, unknown>> = {
+type ModelLike<TModelRow extends Record<string, unknown>> = {
     metadata: {
         key?: string;
         name: string;
@@ -16,14 +16,14 @@ type ModelLike<T extends Record<string, unknown>> = {
         fields: FieldLike[];
     };
     schema: {
-        parse(input: unknown): T;
+        parse(input: unknown): TModelRow;
     };
-    hooks?: ModelWriteHooks<T>;
+    hooks?: ModelWriteHooks<TModelRow>;
 };
 /**
  * Model-backed data access API exposed as `Model.objects`.
  */
-export declare class ModelManager<T extends Record<string, unknown>> implements ManagerLike<T> {
+export declare class ModelManager<TModelRow extends Record<string, unknown>, TSourceModel = unknown> implements ManagerLike<TModelRow, TSourceModel> {
     static readonly BRAND: "tango.orm.model_manager";
     readonly __tangoBrand: typeof ModelManager.BRAND;
     private readonly queryExecutor;
@@ -31,21 +31,23 @@ export declare class ModelManager<T extends Record<string, unknown>> implements
     private readonly model;
     private readonly client;
     private readonly dialect;
-    constructor(model: ModelLike<T>, runtime: TangoRuntime);
+    private readonly runtime;
+    constructor(model: ModelLike<TModelRow>, runtime: TangoRuntime);
     get meta(): TableMeta;
     /**
      * Narrow an unknown value to `ModelManager`.
      */
-    static isModelManager<T extends Record<string, unknown>>(value: unknown): value is ModelManager<T>;
+    static isModelManager<TModelRow extends Record<string, unknown>>(value: unknown): value is ModelManager<TModelRow>;
     private static createTableMeta;
-    query(): QuerySet<T>;
-    findById(id: T[keyof T]): Promise<T | null>;
-    getOrThrow(id: T[keyof T]): Promise<T>;
-    create(input: Partial<T>): Promise<T>;
-    update(id: T[keyof T], patch: Partial<T>): Promise<T>;
-    delete(id: T[keyof T]): Promise<void>;
-    bulkCreate(inputs: Partial<T>[]): Promise<T[]>;
+    query(): QuerySet<TModelRow, TModelRow, TSourceModel>;
+    findById(id: TModelRow[keyof TModelRow]): Promise<TModelRow | null>;
+    getOrThrow(id: TModelRow[keyof TModelRow]): Promise<TModelRow>;
+    create(input: Partial<TModelRow>): Promise<TModelRow>;
+    update(id: TModelRow[keyof TModelRow], patch: Partial<TModelRow>): Promise<TModelRow>;
+    delete(id: TModelRow[keyof TModelRow]): Promise<void>;
+    bulkCreate(inputs: Partial<TModelRow>[]): Promise<TModelRow[]>;
     private runBeforeCreate;
     private runBeforeUpdate;
+    private getHookTransaction;
 }
 export {};

package/dist/manager/index.js

@@ -1,8 +1,8 @@
-import "../PostgresAdapter-C9a1XJRx.js";
-import "../SqliteAdapter-Dp6VRXmz.js";
-import "../connection-CVvycXus.js";
-import { ModelManager, registerModelObjects } from "../registerModelObjects-vsX6GzCN.js";
-import "../query-BKt2nKIt.js";
-import "../manager-CKUy1CIt.js";
+import "../PostgresClient-BQJZfEOT.js";
+import "../SqliteClient-CjOK9-ki.js";
+import "../query-CWZ1cfjo.js";
+import "../defaultRuntime-BPK9kWEW.js";
+import { ModelManager, registerModelObjects } from "../registerModelObjects-Bva_f-Qh.js";
+import "../manager-C6oJ2tAF.js";
 
 export { ModelManager, registerModelObjects };