@danceroutine/tango-orm 1.11.0 → 1.11.2

package/dist/{defaultRuntime-DzqBQ9Hb.js → defaultRuntime-CdTX8cXm.js}

@@ -1,14 +1,15 @@
-import { PostgresAdapter, PostgresClient } from "./PostgresAdapter-DySFW6vy.js";
-import { InternalDialect } from "./InternalDialect-ClSaUNso.js";
-import { SqliteAdapter, SqliteClient } from "./SqliteAdapter-CDdOjRmW.js";
-import pg from "pg";
+import { i as PostgresAdapter, o as PostgresClient, r as SqliteClient, t as SqliteAdapter } from "./SqliteAdapter-6oyUmoJf.js";
+import { t as InternalDialect } from "./InternalDialect-U3mwJjKA.js";
 import { createRequire } from "node:module";
+import pg from "pg";
 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 {
+	engine;
+	state;
+	frame;
 	active = true;
 	constructor(engine, state, frame) {
 		this.engine = engine;
@@ -31,7 +32,6 @@ var FrameBoundTransaction = class {
 		this.active = false;
 	}
 };
-
 //#endregion
 //#region src/transaction/internal/context/AsyncLocalTransactionEngine.ts
 var AsyncLocalTransactionEngine = class {
@@ -42,12 +42,12 @@ var AsyncLocalTransactionEngine = class {
 	}
 	getActiveTransaction(runtime) {
 		const state = this.storage.getStore();
-		if (!state || state.runtime !== runtime) return undefined;
+		if (!state || state.runtime !== runtime) return;
 		return state.frames.at(-1)?.facade;
 	}
 	getActiveLease(runtime) {
 		const state = this.storage.getStore();
-		if (!state || state.runtime !== runtime) return undefined;
+		if (!state || state.runtime !== runtime) return;
 		return state.lease;
 	}
 	async atomic(runtime, work) {
@@ -121,8 +121,7 @@ var AsyncLocalTransactionEngine = class {
 			} catch (rollbackError) {
 				throw this.attachCause(rollbackError, error);
 			} finally {
-				const discarded = this.popFrame(state);
-				discarded.facade.deactivate();
+				this.popFrame(state).facade.deactivate();
 			}
 			throw error;
 		}
@@ -147,10 +146,7 @@ var AsyncLocalTransactionEngine = class {
 		} catch (rollbackError) {
 			throw this.attachCause(rollbackError, error);
 		} finally {
-			while (state.frames.length > 0) {
-				const frame = this.popFrame(state);
-				frame.facade.deactivate();
-			}
+			while (state.frames.length > 0) this.popFrame(state).facade.deactivate();
 		}
 	}
 	async runCommittedCallbacks(callbacks) {
@@ -168,7 +164,7 @@ var AsyncLocalTransactionEngine = class {
 	}
 	attachCause(error, cause) {
 		if (!this.isErrorValue(error)) return error;
-		if ("cause" in error && error.cause !== undefined) return error;
+		if ("cause" in error && error.cause !== void 0) return error;
 		try {
 			return new Error(error.message, { cause });
 		} catch {
@@ -179,10 +175,13 @@ var AsyncLocalTransactionEngine = class {
 		return typeof value === "object" && value !== null && typeof value.message === "string" && typeof value.name === "string";
 	}
 };
-
 //#endregion
 //#region src/transaction/internal/context/TransactionEngine.ts
+/**
+* Runtime-bound transaction facade used by internal ORM/runtime components.
+*/
 var TransactionEngine = class TransactionEngine {
+	runtime;
 	static engine = new AsyncLocalTransactionEngine();
 	constructor(runtime) {
 		this.runtime = runtime;
@@ -203,10 +202,14 @@ var TransactionEngine = class TransactionEngine {
 		return TransactionEngine.engine.atomic(this.runtime, work);
 	}
 };
-
 //#endregion
 //#region src/manager/internal/RuntimeBoundClient.ts
+/**
+* DB client proxy that resolves either the active transaction lease or the
+* runtime autocommit path lazily.
+*/
 var RuntimeBoundClient = class {
+	runtime;
 	constructor(runtime) {
 		this.runtime = runtime;
 	}
@@ -215,8 +218,7 @@ var RuntimeBoundClient = class {
 		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);
+		return (await this.runtime.getClient()).query(sql, params);
 	}
 	async begin() {
 		throw new Error("Runtime-bound clients do not support manual begin(). Use transaction.atomic(...) instead.");
@@ -240,7 +242,6 @@ var RuntimeBoundClient = class {
 		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;
@@ -259,8 +260,7 @@ var PostgresDBClientProvider = class {
 		});
 	}
 	async query(sql, params) {
-		const result = await this.pool.query(sql, params);
-		return { rows: result.rows };
+		return { rows: (await this.pool.query(sql, params)).rows };
 	}
 	async leaseTransactionClient() {
 		const client = await this.pool.connect();
@@ -281,7 +281,6 @@ var PostgresDBClientProvider = class {
 		await this.pool.end();
 	}
 };
-
 //#endregion
 //#region src/runtime/internal/SqliteDBClientProvider.ts
 var SqliteDBClientProvider = class {
@@ -354,15 +353,13 @@ var SqliteDBClientProvider = class {
 		};
 	}
 	getDatabaseCtor() {
-		const require = createRequire(import.meta.url);
-		const moduleValue = require("better-sqlite3");
+		const moduleValue = createRequire(import.meta.url)("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) {
@@ -372,9 +369,12 @@ function createDBClientProvider(config) {
 		default: throw new Error(`Unsupported adapter for Tango runtime provider: ${config.adapter}`);
 	}
 }
-
 //#endregion
 //#region src/runtime/TangoRuntime.ts
+/**
+* Framework-owned database runtime that resolves Tango config and lazily
+* creates the shared connection provider used by manager-backed models.
+*/
 var TangoRuntime = class TangoRuntime {
 	static BRAND = "tango.orm.runtime";
 	__tangoBrand = TangoRuntime.BRAND;
@@ -423,15 +423,13 @@ var TangoRuntime = class TangoRuntime {
 	* Execute SQL through the autocommit path owned by this runtime.
 	*/
 	async query(sql, params) {
-		const provider = await this.getProvider();
-		return provider.query(sql, params);
+		return (await this.getProvider()).query(sql, params);
 	}
 	/**
 	* Lease a transaction-scoped client for `transaction.atomic(...)`.
 	*/
 	async leaseTransactionClient() {
-		const provider = await this.getProvider();
-		return provider.leaseTransactionClient();
+		return (await this.getProvider()).leaseTransactionClient();
 	}
 	/**
 	* Close and clear the cached runtime resources so tests can start fresh.
@@ -470,25 +468,33 @@ var TangoRuntime = class TangoRuntime {
 		return this.providerPromise;
 	}
 };
-
 //#endregion
 //#region src/runtime/defaultRuntime.ts
 let defaultRuntime = null;
+/**
+* Initialize the process-default Tango runtime from a Tango config loader.
+*/
 function initializeTangoRuntime(fromFile) {
 	defaultRuntime = new TangoRuntime(() => loadConfig(fromFile));
 	return defaultRuntime;
 }
+/**
+* Return the process-default Tango runtime, lazily loading Tango config on first access.
+*/
 function getTangoRuntime() {
 	if (!defaultRuntime) defaultRuntime = new TangoRuntime(() => loadConfigFromProjectRoot());
 	return defaultRuntime;
 }
+/**
+* Reset the process-default Tango runtime and release any cached client.
+*/
 async function resetTangoRuntime() {
 	if (!defaultRuntime) return;
 	const runtime = defaultRuntime;
 	defaultRuntime = null;
 	await runtime.reset();
 }
-
 //#endregion
-export { RuntimeBoundClient, TangoRuntime, TransactionEngine, getTangoRuntime, initializeTangoRuntime, resetTangoRuntime };
-//# sourceMappingURL=defaultRuntime-DzqBQ9Hb.js.map
+export { RuntimeBoundClient as a, TangoRuntime as i, initializeTangoRuntime as n, TransactionEngine as o, resetTangoRuntime as r, getTangoRuntime as t };
+
+//# sourceMappingURL=defaultRuntime-CdTX8cXm.js.map

package/dist/defaultRuntime-CdTX8cXm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRuntime-CdTX8cXm.js","names":[],"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    private exclusiveTail: Promise<void> = Promise.resolve();\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.runExclusive(() => 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 releaseExclusive = await this.acquireExclusive();\n        try {\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                    try {\n                        await client.close();\n                    } finally {\n                        releaseExclusive();\n                    }\n                },\n            };\n        } catch (error) {\n            releaseExclusive();\n            throw error;\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 async runExclusive<T>(work: () => Promise<T>): Promise<T> {\n        const release = await this.acquireExclusive();\n        try {\n            return await work();\n        } finally {\n            release();\n        }\n    }\n\n    private async acquireExclusive(): Promise<() => void> {\n        const previous = this.exclusiveTail;\n        let release: (() => void) | null = null;\n        this.exclusiveTail = new Promise<void>((resolve) => {\n            release = resolve;\n        });\n        await previous;\n        return () => {\n            release?.();\n        };\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 { Adapter } from '../connection/adapters/Adapter';\nimport { PostgresAdapter } from '../connection/adapters/dialects/PostgresAdapter';\nimport { SqliteAdapter } from '../connection/adapters/dialects/SqliteAdapter';\nimport type { Dialect } from '../query/domain/index';\nimport { InternalDialect } from '../query/domain/internal/InternalDialect';\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    private cachedAdapter: Adapter | 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 adapter backing the configured dialect. Manager-side\n     * compilers use this to obtain placeholder formatters and dialect\n     * capabilities without branching on the raw dialect string.\n     */\n    getAdapter(): Adapter {\n        if (!this.cachedAdapter) {\n            this.cachedAdapter = this.buildAdapterForDialect(this.getDialect());\n        }\n        return this.cachedAdapter;\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 buildAdapterForDialect(dialect: Dialect): Adapter {\n        switch (dialect) {\n            case InternalDialect.POSTGRES:\n                return new PostgresAdapter();\n            case InternalDialect.SQLITE:\n                return new SqliteAdapter();\n        }\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-B-aibguC.d.ts

@@ -0,0 +1,226 @@
+import { t as DBClient } from "./DBClient-DuYcXolQ.js";
+import { n as AdapterConfig, r as SqlPlaceholders, t as Adapter } from "./Adapter-DKxAaL4l.js";
+import Database from "better-sqlite3";
+
+//#region src/connection/adapters/dialects/PostgresAdapter.d.ts
+/**
+ * Postgres adapter that turns adapter config into a transactional `DBClient`.
+ */
+declare class PostgresAdapter implements Adapter {
+  static readonly BRAND: "tango.orm.postgres_adapter";
+  readonly __tangoBrand: typeof PostgresAdapter.BRAND;
+  readonly name = "postgres";
+  readonly dialect: Adapter['dialect'];
+  /**
+   * Declares capabilities of this database adapter.
+   * Used by the migration runner and query compiler to determine which
+   * SQL features can be safely used:
+   * - transactionalDDL: Postgres supports DDL inside transactions (safe rollback of schema changes)
+   * - concurrentIndex: Supports CREATE INDEX CONCURRENTLY (non-blocking index builds)
+   * - validateForeignKeys: Supports deferred FK validation via NOT VALID + VALIDATE CONSTRAINT
+   * - ignoreDuplicateInsert: Supports duplicate-safe insert semantics for manager-owned link writes
+   */
+  readonly features: Adapter['features'];
+  readonly placeholders: SqlPlaceholders;
+  /**
+   * Narrow an unknown value to `PostgresAdapter`.
+   */
+  static isPostgresAdapter(value: unknown): value is PostgresAdapter;
+  /**
+   * Open a Postgres connection pool and return a client-backed DB abstraction.
+   */
+  connect(config: AdapterConfig): Promise<DBClient>;
+}
+//#endregion
+//#region src/connection/adapters/dialects/SqliteAdapter.d.ts
+/**
+ * SQLite adapter that creates a `better-sqlite3` backed `DBClient`.
+ */
+declare class SqliteAdapter implements Adapter {
+  static readonly BRAND: "tango.orm.sqlite_adapter";
+  readonly __tangoBrand: typeof SqliteAdapter.BRAND;
+  readonly name = "sqlite";
+  readonly dialect: Adapter['dialect'];
+  readonly features: Adapter['features'];
+  readonly placeholders: SqlPlaceholders;
+  /**
+   * Narrow an unknown value to `SqliteAdapter`.
+   */
+  static isSqliteAdapter(value: unknown): value is SqliteAdapter;
+  /**
+   * Open a SQLite database and apply baseline pragmas for durability/safety.
+   */
+  connect(config?: AdapterConfig): Promise<DBClient>;
+  private getDatabaseCtor;
+}
+declare namespace index_d_exports$4 {
+  export { PostgresAdapter, SqliteAdapter };
+}
+//#endregion
+//#region src/connection/adapters/AdapterRegistry.d.ts
+/**
+ * Runtime registry for database adapters.
+ *
+ * Use a custom instance when tests or applications need explicit control
+ * over supported adapters; use `getDefaultRegistry()` for the built-in set.
+ */
+declare class AdapterRegistry {
+  static readonly BRAND: "tango.orm.adapter_registry";
+  private static defaultRegistryInstance;
+  readonly __tangoBrand: typeof AdapterRegistry.BRAND;
+  private adapters;
+  /**
+   * Narrow an unknown value to `AdapterRegistry`.
+   */
+  static isAdapterRegistry(value: unknown): value is AdapterRegistry;
+  /**
+   * Return a lazily-initialized registry preloaded with built-in adapters.
+   */
+  static getDefaultRegistry(): Promise<AdapterRegistry>;
+  /**
+   * Register an adapter under its declared `name`.
+   */
+  register(adapter: Adapter): this;
+  /**
+   * Resolve an adapter by name, or throw a descriptive error.
+   */
+  get(name: string): Adapter;
+  /**
+   * Check whether an adapter has been registered.
+   */
+  has(name: string): boolean;
+}
+/**
+ * Connect to a database by adapter name using the provided (or default) registry.
+ */
+declare function connectDB(config: AdapterConfig & {
+  adapter: string;
+}, registry?: AdapterRegistry): Promise<DBClient>;
+/**
+ * Convenience helper that exposes the singleton default adapter registry.
+ */
+declare function getDefaultAdapterRegistry(): Promise<AdapterRegistry>;
+declare namespace index_d_exports$3 {
+  export { Adapter, AdapterConfig, AdapterRegistry, PostgresAdapter, SqlPlaceholders, SqliteAdapter, connectDB, index_d_exports$4 as dialects, getDefaultAdapterRegistry };
+}
+//#endregion
+//#region src/connection/clients/dialects/PostgresClient.d.ts
+interface PostgresPoolClientLike {
+  query(sql: string, params?: readonly unknown[]): Promise<{
+    rows: unknown[];
+  }>;
+  release(): void;
+}
+/**
+ * Transaction-capable client backed by a PostgreSQL pool client.
+ */
+declare class PostgresClient implements DBClient {
+  private client;
+  static readonly BRAND: "tango.orm.postgres_client";
+  readonly __tangoBrand: typeof PostgresClient.BRAND;
+  constructor(client: PostgresPoolClientLike);
+  /**
+   * Narrow an unknown value to `PostgresClient`.
+   */
+  static isPostgresClient(value: unknown): value is PostgresClient;
+  /**
+   * Execute a SQL statement with optional bound parameters.
+   */
+  query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{
+    rows: T[];
+  }>;
+  /**
+   * Begin a database transaction.
+   */
+  begin(): Promise<void>;
+  /**
+   * Commit the active transaction.
+   */
+  commit(): Promise<void>;
+  /**
+   * Roll back the active transaction.
+   */
+  rollback(): Promise<void>;
+  /**
+   * Create a savepoint inside the active transaction.
+   */
+  createSavepoint(name: string): Promise<void>;
+  /**
+   * Release a previously-created savepoint.
+   */
+  releaseSavepoint(name: string): Promise<void>;
+  /**
+   * Roll back the active transaction to a savepoint.
+   */
+  rollbackToSavepoint(name: string): Promise<void>;
+  /**
+   * Release the leased PostgreSQL client back to its owning pool.
+   */
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/connection/clients/dialects/SqliteClient.d.ts
+/**
+ * Transaction-capable client backed by a synchronous `better-sqlite3` handle.
+ */
+declare class SqliteClient implements DBClient {
+  private db;
+  static readonly BRAND: "tango.orm.sqlite_client";
+  readonly __tangoBrand: typeof SqliteClient.BRAND;
+  private inTransaction;
+  constructor(db: Database.Database);
+  /**
+   * Narrow an unknown value to `SqliteClient`.
+   */
+  static isSqliteClient(value: unknown): value is SqliteClient;
+  /**
+   * Execute a SQL statement with optional parameters.
+   *
+   * `SELECT`/`PRAGMA` statements return row data; write statements return
+   * an empty row list.
+   */
+  query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{
+    rows: T[];
+  }>;
+  /**
+   * Begin a transaction if one is not already active.
+   */
+  begin(): Promise<void>;
+  /**
+   * Commit the active transaction.
+   */
+  commit(): Promise<void>;
+  /**
+   * Roll back the active transaction.
+   */
+  rollback(): Promise<void>;
+  /**
+   * Create a savepoint inside the active transaction.
+   */
+  createSavepoint(name: string): Promise<void>;
+  /**
+   * Release a previously-created savepoint.
+   */
+  releaseSavepoint(name: string): Promise<void>;
+  /**
+   * Roll back the active transaction to a savepoint.
+   */
+  rollbackToSavepoint(name: string): Promise<void>;
+  /**
+   * Close the underlying SQLite handle.
+   */
+  close(): Promise<void>;
+  private normalizeParam;
+}
+declare namespace index_d_exports$2 {
+  export { PostgresClient, SqliteClient };
+}
+declare namespace index_d_exports$1 {
+  export { DBClient, PostgresClient, SqliteClient, index_d_exports$2 as dialects };
+}
+declare namespace index_d_exports {
+  export { Adapter, AdapterConfig, AdapterRegistry, DBClient, PostgresAdapter, PostgresClient, SqlPlaceholders, SqliteAdapter, SqliteClient, index_d_exports$3 as adapters, index_d_exports$1 as clients, connectDB, getDefaultAdapterRegistry };
+}
+//#endregion
+export { index_d_exports$3 as a, getDefaultAdapterRegistry as c, PostgresClient as i, SqliteAdapter as l, index_d_exports$1 as n, AdapterRegistry as o, SqliteClient as r, connectDB as s, index_d_exports as t, PostgresAdapter as u };
+//# sourceMappingURL=index-B-aibguC.d.ts.map

package/dist/index-D9B6gKez.d.ts

@@ -0,0 +1,70 @@
+import { D as ManyToManyRelatedManagerCreateInputs, E as ManyToManyRelatedManager, M as QueryExecutor, N as QuerySet, O as ManyToManyTargetRef, U as QueryResult, t as QuerySetState } from "./QuerySetState-CjyvAUBs.js";
+import { a as MaterializedModelRecord, i as ManagerLike, n as ModelManager, t as registerModelObjects } from "./registerModelObjects-C-MliIiM.js";
+
+//#region src/manager/relations/ManyToManyRelatedQuerySet.d.ts
+/**
+ * Hooks supplied by {@link ManyToManyRelatedManager} so the queryset returned
+ * from `all()` can short-circuit to the prefetch cache, scope the SQL query
+ * to the owner via the join table, and filter targets by the resolved primary
+ * keys.
+ *
+ * Application code does not construct this bridge directly; it is wired by
+ * the related manager when `all()` is called.
+ */
+interface ManyToManyRelatedQuerySetBridge<TTarget extends Record<string, unknown>> {
+  getCache(): readonly TTarget[] | null;
+  fetchTargetIds(): Promise<readonly (string | number)[]>;
+  targetPrimaryKeyField: string;
+}
+type ShapeFunction<TInput, Out> = (row: TInput) => Out;
+type ShapeParser<TInput, Out> = {
+  parse: (row: TInput) => Out;
+};
+/**
+ * {@link QuerySet} returned by `post.tags.all()` on a many-to-many related
+ * manager.
+ *
+ * Behaves like a normal `QuerySet` over the target model from an application
+ * developer's perspective: you can chain `filter`, `exclude`, `orderBy`,
+ * `limit`, `offset`, and terminate with `fetch`, `fetchOne`, or `count`.
+ * Each chainable call returns another `ManyToManyRelatedQuerySet` so the
+ * chain keeps the membership scoping of the owning record.
+ *
+ * Two behaviors differ from a plain `QuerySet` and matter to application
+ * developers:
+ *
+ * - When the relation was loaded by `prefetchRelated(...)` and no chainable
+ *   state has been added (no `filter`, `orderBy`, etc.), `fetch()` and
+ *   `count()` resolve from the prefetch cache without issuing SQL.
+ * - Mutating the membership via `post.tags.add(tag)` or
+ *   `post.tags.remove(tag)` invalidates that cache so follow-up reads go
+ *   back to the database.
+ *
+ * @example
+ * ```ts
+ * const post = await PostModel.objects.getOrThrow(postId);
+ * await post.tags.add(tag);
+ * const tags = await post.tags.all().filter({ color: 'red' }).orderBy('name').fetch();
+ * ```
+ *
+ * @template TTarget - The persisted target record shape (e.g. `Tag`).
+ */
+declare class ManyToManyRelatedQuerySet<TTarget extends Record<string, unknown>> extends QuerySet<TTarget> {
+  private readonly bridge;
+  constructor(executor: QueryExecutor<TTarget>, bridge: ManyToManyRelatedQuerySetBridge<TTarget>, state?: QuerySetState<TTarget>);
+  fetch<Out>(shape?: ShapeFunction<TTarget, Out> | ShapeParser<TTarget, Out>): Promise<QueryResult<TTarget | Out>>;
+  fetchOne<Out>(shape?: ShapeFunction<TTarget, Out> | ShapeParser<TTarget, Out>): Promise<TTarget | Out | null>;
+  count(): Promise<number>;
+  protected spawn<TNextBaseResult extends Record<string, unknown>, TNextHydrated extends Record<string, unknown>>(state: QuerySetState<TTarget>): QuerySet<TTarget, TNextBaseResult, unknown, TNextHydrated>;
+  private isStateTrivial;
+  private scopedState;
+}
+declare namespace index_d_exports$1 {
+  export { ManyToManyRelatedManager, ManyToManyRelatedManagerCreateInputs, ManyToManyRelatedQuerySet, ManyToManyRelatedQuerySetBridge, ManyToManyTargetRef, MaterializedModelRecord };
+}
+declare namespace index_d_exports {
+  export { ManagerLike, ManyToManyRelatedManager, ManyToManyRelatedManagerCreateInputs, ManyToManyRelatedQuerySet, ManyToManyRelatedQuerySetBridge, ManyToManyTargetRef, MaterializedModelRecord, ModelManager, registerModelObjects, index_d_exports$1 as relations };
+}
+//#endregion
+export { ManyToManyRelatedQuerySetBridge as i, index_d_exports$1 as n, ManyToManyRelatedQuerySet as r, index_d_exports as t };
+//# sourceMappingURL=index-D9B6gKez.d.ts.map

package/dist/index-rjKca3U_.d.ts

@@ -0,0 +1,31 @@
+import { a as MaterializedModelRecord, n as ModelManager, r as TangoRuntime, t as registerModelObjects } from "./registerModelObjects-C-MliIiM.js";
+import { z } from "zod";
+import { Model } from "@danceroutine/tango-schema/domain";
+
+//#region src/runtime/defaultRuntime.d.ts
+/**
+ * Initialize the process-default Tango runtime from a Tango config loader.
+ */
+declare function initializeTangoRuntime(fromFile: () => unknown): TangoRuntime;
+/**
+ * Return the process-default Tango runtime, lazily loading Tango config on first access.
+ */
+declare function getTangoRuntime(): TangoRuntime;
+/**
+ * Reset the process-default Tango runtime and release any cached client.
+ */
+declare function resetTangoRuntime(): Promise<void>;
+declare namespace index_d_exports {
+  export { TangoRuntime, getTangoRuntime, initializeTangoRuntime, registerModelObjects, resetTangoRuntime };
+}
+/**
+ * Domain boundary barrel: centralizes Tango runtime ownership APIs.
+ */
+declare global {
+  interface TangoSchemaModelAugmentations<TSchema extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>, TKey extends string = string> {
+    readonly objects: ModelManager<MaterializedModelRecord<TSchema>, Model<TSchema, TKey>>;
+  }
+}
+//#endregion
+export { resetTangoRuntime as i, getTangoRuntime as n, initializeTangoRuntime as r, index_d_exports as t };
+//# sourceMappingURL=index-rjKca3U_.d.ts.map