@danceroutine/tango-orm 1.6.0 → 1.8.0

package/dist/defaultRuntime-DzqBQ9Hb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRuntime-DzqBQ9Hb.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","work: () => Promise<T>","release: (() => void) | null","config: AdapterConfig & { adapter: string }","loadLoadedConfig: () => LoadedConfig","value: unknown","sql: string","params?: readonly unknown[]","dialect: Dialect","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    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.d.ts

@@ -12,9 +12,9 @@ export * as transaction from './transaction/index';
 export { AdapterRegistry, connectDB, getDefaultAdapterRegistry } from './connection/index';
 export type { Adapter, AdapterConfig, DBClient } from './connection/index';
 export { PostgresAdapter, SqliteAdapter } from './connection/index';
-export { ModelManager } from './manager/index';
-export type { ManagerLike } from './manager/index';
-export { Q, QBuilder, QueryCompiler, QueryResult, QuerySet } from './query/index';
+export { ManyToManyRelatedManager, ModelManager } from './manager/index';
+export type { ManagerLike, ManyToManyTargetRef, MaterializedModelRecord } from './manager/index';
+export { Q, QBuilder, QueryCompiler, QueryResult, QuerySet, ModelQuerySet } from './query/index';
 export type { QueryExecutor } from './query/index';
 export type { CompiledQuery, Dialect, Direction, FilterInput, FilterKey, FilterValue, LookupType, OrderSpec, OrderToken, QNode, QuerySetState, RelationMeta, TableMeta, WhereClause, } from './query/domain/index';
 export { getTangoRuntime, initializeTangoRuntime, resetTangoRuntime, TangoRuntime } from './runtime/index';

package/dist/index.js

@@ -1,13 +1,12 @@
-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, QueryResult, QuerySet, query_exports } from "./query-C6So1r6H.js";
-import { TangoRuntime, getTangoRuntime, initializeTangoRuntime, resetTangoRuntime } from "./defaultRuntime-BPK9kWEW.js";
-import { ModelManager } from "./registerModelObjects-BKMpfc4Z.js";
-import { manager_exports } from "./manager-C6oJ2tAF.js";
-import { runtime_exports } from "./runtime-ByXbpVBS.js";
-import { UnitOfWork, atomic, transaction_exports } from "./transaction-Cs0Z9tbW.js";
+import { PostgresAdapter } from "./PostgresAdapter-DySFW6vy.js";
+import "./InternalDialect-ClSaUNso.js";
+import { SqliteAdapter } from "./SqliteAdapter-CDdOjRmW.js";
+import { AdapterRegistry, connectDB, connection_exports, getDefaultAdapterRegistry } from "./connection-Dmhgx31M.js";
+import { ModelQuerySet, QBuilder, QueryCompiler, QueryResult, QuerySet, query_exports } from "./query-DUZnBFhf.js";
+import { ManyToManyRelatedManager, ModelManager } from "./registerModelObjects-DxlBfuUN.js";
+import { manager_exports } from "./manager-DrDTiCAz.js";
+import { TangoRuntime, getTangoRuntime, initializeTangoRuntime, resetTangoRuntime } from "./defaultRuntime-DzqBQ9Hb.js";
+import { runtime_exports } from "./runtime-1H88J3nN.js";
+import { UnitOfWork, atomic, transaction_exports } from "./transaction-ZhfDf-f8.js";
 
-export { AdapterRegistry, ModelManager, PostgresAdapter, QBuilder as Q, QBuilder, QueryCompiler, QueryResult, 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 };
+export { AdapterRegistry, ManyToManyRelatedManager, ModelManager, ModelQuerySet, PostgresAdapter, QBuilder as Q, QBuilder, QueryCompiler, QueryResult, 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

@@ -1,3 +1,5 @@
+import type { QNode } from '../query/domain/QNode';
+import type { FilterInput } from '../query/domain/FilterInput';
 import type { QuerySet } from '../query/index';
 import type { TableMeta } from '../query/domain/index';
 /**
@@ -6,6 +8,23 @@ import type { TableMeta } from '../query/domain/index';
 export interface ManagerLike<TModelRow extends Record<string, unknown>, TSourceModel = unknown> {
     readonly meta: TableMeta;
     query(): QuerySet<TModelRow, TModelRow, TSourceModel>;
+    all(): QuerySet<TModelRow, TModelRow, TSourceModel>;
+    getOrCreate(args: {
+        where: FilterInput<TModelRow> | QNode<TModelRow>;
+        defaults?: Partial<TModelRow>;
+    }): Promise<{
+        record: TModelRow;
+        created: boolean;
+    }>;
+    updateOrCreate(args: {
+        where: FilterInput<TModelRow> | QNode<TModelRow>;
+        defaults?: Partial<TModelRow>;
+        update?: Partial<TModelRow>;
+    }): Promise<{
+        record: TModelRow;
+        created: boolean;
+        updated: boolean;
+    }>;
     findById(id: TModelRow[keyof TModelRow]): Promise<TModelRow | null>;
     getOrThrow(id: TModelRow[keyof TModelRow]): Promise<TModelRow>;
     create(input: Partial<TModelRow>): Promise<TModelRow>;

package/dist/manager/ModelManager.d.ts

@@ -1,9 +1,11 @@
 import type { ModelWriteHooks } from '@danceroutine/tango-schema';
 import type { Model as SchemaModel } from '@danceroutine/tango-schema/domain';
-import type { TableMeta } from '../query/domain/index';
+import type { QNode } from '../query/domain/QNode';
+import type { FilterInput, TableMeta } from '../query/domain/index';
 import type { QuerySet } from '../query/index';
 import type { TangoRuntime } from '../runtime/TangoRuntime';
 import type { ManagerLike } from './ManagerLike';
+import { ManyToManyRelatedManager } from './relations/ManyToManyRelatedManager';
 type ModelMetadataLike = Omit<SchemaModel['metadata'], 'key' | 'namespace' | 'fields'> & {
     key?: string;
     namespace?: string;
@@ -30,7 +32,7 @@ export declare class ModelManager<TModelRow extends Record<string, unknown>, TSo
     private readonly mutationCompiler;
     private readonly model;
     private readonly client;
-    private readonly dialect;
+    private readonly adapter;
     private readonly runtime;
     constructor(model: ModelLike<TModelRow>, runtime: TangoRuntime);
     get meta(): TableMeta;
@@ -39,13 +41,54 @@ export declare class ModelManager<TModelRow extends Record<string, unknown>, TSo
      */
     static isModelManager<TModelRow extends Record<string, unknown>>(value: unknown): value is ModelManager<TModelRow>;
     private static createTableMeta;
+    private static mergeCreatePayloadFromWhere;
+    private static countDefinedValues;
+    private static collectPlainFieldsFromQNode;
+    private static omitLookupKeysFromAtom;
+    private static mergeCompatiblePartials;
     query(): QuerySet<TModelRow, TModelRow, TSourceModel>;
+    all(): QuerySet<TModelRow, TModelRow, TSourceModel>;
     findById(id: TModelRow[keyof TModelRow]): Promise<TModelRow | null>;
     getOrThrow(id: TModelRow[keyof TModelRow]): Promise<TModelRow>;
+    getOrCreate(args: {
+        where: FilterInput<TModelRow> | QNode<TModelRow>;
+        defaults?: Partial<TModelRow>;
+    }): Promise<{
+        record: TModelRow;
+        created: boolean;
+    }>;
+    updateOrCreate(args: {
+        where: FilterInput<TModelRow> | QNode<TModelRow>;
+        defaults?: Partial<TModelRow>;
+        update?: Partial<TModelRow>;
+    }): Promise<{
+        record: TModelRow;
+        created: boolean;
+        updated: boolean;
+    }>;
     create(input: Partial<TModelRow>): Promise<TModelRow>;
     update(id: TModelRow[keyof TModelRow], patch: Partial<TModelRow>): Promise<TModelRow>;
     delete(id: TModelRow[keyof TModelRow]): Promise<void>;
+    /**
+     * Build a {@link ManyToManyRelatedManager} bound to a single owner record
+     * for the supplied many-to-many relation. The returned manager performs
+     * its INSERT/DELETE writes through the shared runtime-bound client, so
+     * mutations enroll in any active `transaction.atomic(...)` boundary.
+     */
+    createManyToManyRelatedManager<TTarget extends Record<string, unknown>>(relationName: string, ownerPrimaryKey: unknown): ManyToManyRelatedManager<TTarget>;
     bulkCreate(inputs: Partial<TModelRow>[]): Promise<TModelRow[]>;
+    /**
+     * Attach a {@link ManyToManyRelatedManager} as a non-enumerable property
+     * for every persisted many-to-many relation declared on the supplied
+     * record's model. Existing properties are left untouched so that prior
+     * hydration writes (such as prefetched arrays) survive the attach pass
+     * during the incremental rollout of related-manager hydration.
+     */
+    private attachOwnRelatedManagers;
+    private attachManyToManyRelatedManagers;
+    private resolveManagerForModelKey;
+    private resolveTargetExecutor;
+    private requireManyToManyEdge;
     private runBeforeCreate;
     private runBeforeUpdate;
     private getHookTransaction;

package/dist/manager/index.d.ts

@@ -1,6 +1,12 @@
 /**
  * Domain boundary barrel: centralizes manager-first ORM APIs.
  */
+export * as relations from './relations/index';
 export type { ManagerLike } from './ManagerLike';
 export { ModelManager } from './ModelManager';
 export { registerModelObjects } from './registerModelObjects';
+export { ManyToManyRelatedQuerySet } from './relations/ManyToManyRelatedQuerySet';
+export type { ManyToManyRelatedQuerySetBridge } from './relations/ManyToManyRelatedQuerySet';
+export { ManyToManyRelatedManager } from './relations/ManyToManyRelatedManager';
+export type { ManyToManyRelatedManagerCreateInputs, ManyToManyTargetRef } from './relations/ManyToManyRelatedManager';
+export type { MaterializedModelRecord } from './relations/MaterializedModelRecord';

package/dist/manager/index.js

@@ -1,8 +1,9 @@
-import "../PostgresClient-BQJZfEOT.js";
-import "../SqliteClient-CjOK9-ki.js";
-import "../query-C6So1r6H.js";
-import "../defaultRuntime-BPK9kWEW.js";
-import { ModelManager, registerModelObjects } from "../registerModelObjects-BKMpfc4Z.js";
-import "../manager-C6oJ2tAF.js";
+import "../PostgresAdapter-DySFW6vy.js";
+import "../InternalDialect-ClSaUNso.js";
+import "../SqliteAdapter-CDdOjRmW.js";
+import "../query-DUZnBFhf.js";
+import { ManyToManyRelatedManager, ManyToManyRelatedQuerySet, ModelManager, registerModelObjects } from "../registerModelObjects-DxlBfuUN.js";
+import { relations_exports } from "../manager-DrDTiCAz.js";
+import "../defaultRuntime-DzqBQ9Hb.js";
 
-export { ModelManager, registerModelObjects };
+export { ManyToManyRelatedManager, ManyToManyRelatedQuerySet, ModelManager, registerModelObjects, relations_exports as relations };

package/dist/manager/internal/MutationCompiler.d.ts

@@ -1,15 +1,23 @@
-import type { CompiledQuery, Dialect } from '../../query/domain/index';
-import type { ValidatedDeleteSqlPlan, ValidatedInsertSqlPlan, ValidatedUpdateSqlPlan } from '../../validation/SQLValidationEngine';
+import type { CompiledQuery } from '../../query/domain/index';
+import type { Adapter } from '../../connection/adapters/Adapter';
+import type { ValidatedDeleteSqlPlan, ValidatedInsertSqlPlan, ValidatedSelectSqlPlan, ValidatedUpdateSqlPlan } from '../../validation/SQLValidationEngine';
+export declare const InternalDuplicateInsertPolicy: {
+    readonly ERROR: "error";
+    readonly IGNORE: "ignore";
+};
+export type DuplicateInsertPolicy = (typeof InternalDuplicateInsertPolicy)[keyof typeof InternalDuplicateInsertPolicy];
 /**
  * Internal compiler for manager-owned INSERT/UPDATE/DELETE statements.
  */
 export declare class MutationCompiler {
-    private readonly dialect;
-    constructor(dialect: Dialect);
+    private readonly adapter;
+    private readonly placeholders;
+    constructor(adapter: Adapter);
     compileInsert(plan: ValidatedInsertSqlPlan, values: readonly unknown[]): CompiledQuery;
     compileUpdate(plan: ValidatedUpdateSqlPlan, values: readonly unknown[], id: unknown): CompiledQuery;
     compileDelete(plan: ValidatedDeleteSqlPlan, id: unknown): CompiledQuery;
+    compileDeleteByJoinKeys(plan: ValidatedSelectSqlPlan, leftFilterKey: string, rightFilterKey: string, leftValue: unknown, rightValue: unknown): CompiledQuery;
     compileBulkInsert(plan: ValidatedInsertSqlPlan, valueRows: ReadonlyArray<ReadonlyArray<unknown>>): CompiledQuery;
-    private buildValuePlaceholders;
-    private placeholder;
+    compileInsertJoinLinks(plan: ValidatedInsertSqlPlan, sourceKey: string, targetKey: string, ownerValue: unknown, targetValues: readonly unknown[], duplicatePolicy: DuplicateInsertPolicy): CompiledQuery;
+    compileDeleteJoinLinks(plan: ValidatedSelectSqlPlan, leftFilterKey: string, rightFilterKey: string, leftValue: unknown, rightValues: readonly unknown[]): CompiledQuery;
 }

package/dist/manager/relations/ManyToManyRelatedManager.d.ts

@@ -0,0 +1,147 @@
+import type { DBClient } from '../../connection/clients/DBClient';
+import type { TableMeta } from '../../query/domain/index';
+import type { Adapter } from '../../connection/adapters/Adapter';
+import type { QueryExecutor, QuerySet } from '../../query/index';
+import type { OrmSqlSafetyAdapter } from '../../validation/OrmSqlSafetyAdapter';
+import type { MutationCompiler } from '../internal/MutationCompiler';
+import { ThroughTableManager } from './internal/ThroughTableManager';
+/**
+ * Accepted target reference shapes for {@link ManyToManyRelatedManager.add} and
+ * {@link ManyToManyRelatedManager.remove}.
+ *
+ * Application code may pass a target record, a primary-key carrier object, or
+ * a bare primary-key value.
+ *
+ * @template TTarget - The persisted target record shape.
+ */
+export type ManyToManyTargetRef<TTarget extends Record<string, unknown>> = TTarget | {
+    readonly [pk: string]: unknown;
+} | string | number;
+/**
+ * Inputs accepted by the {@link ManyToManyRelatedManager.create} factory. The
+ * factory owns the wiring between relation metadata, the SQL safety adapter,
+ * and the {@link ThroughTableManager}, so callers only supply context they
+ * already have on hand.
+ */
+export interface ManyToManyRelatedManagerCreateInputs<TTarget extends Record<string, unknown>> {
+    /** Persisted primary-key value of the owning record. */
+    ownerPrimaryKey: unknown;
+    /** Relation name on the owning model (for error messages). */
+    relationName: string;
+    /** Display name of the owning model (for error messages). */
+    ownerModelLabel: string;
+    /** Resolved relation edge metadata for the many-to-many relation. */
+    relation: NonNullable<TableMeta['relations']>[string];
+    /** Through-model column metadata used to derive the join-table descriptor. */
+    throughModelFields: ReadonlyArray<{
+        name: string;
+        type: string;
+        primaryKey?: boolean;
+    }>;
+    /** Runtime-bound database client shared with the owning manager. */
+    client: DBClient;
+    /** Shared {@link MutationCompiler} configured for the active dialect. */
+    mutationCompiler: MutationCompiler;
+    /** Active database adapter. Supplies placeholder formatting and dialect flags. */
+    adapter: Adapter;
+    /** SQL safety adapter shared with the owning manager. */
+    sqlSafetyAdapter: OrmSqlSafetyAdapter;
+    /** Lazy resolver returning the target model's {@link QueryExecutor}. */
+    targetExecutorProvider: () => QueryExecutor<TTarget> | null;
+    /** Internal transaction runner used for multi-target membership writes. */
+    runAtomic: <T>(work: () => Promise<T>) => Promise<T>;
+}
+interface ManyToManyRelatedManagerInternalInputs<TTarget extends Record<string, unknown>> {
+    ownerPrimaryKey: unknown;
+    relationName: string;
+    ownerModelLabel: string;
+    targetPrimaryKeyField: string;
+    throughTableManager: ThroughTableManager;
+    targetExecutorProvider: () => QueryExecutor<TTarget> | null;
+    runAtomic: <T>(work: () => Promise<T>) => Promise<T>;
+}
+/**
+ * Django-style related manager exposed on materialized model records for each
+ * many-to-many relation.
+ *
+ * Use the manager to add or remove join-table membership and to query the
+ * related target rows. The owning record's primary key and the relation name
+ * are bound when the manager is attached, so application code does not need
+ * to pass them on every call.
+ *
+ * Prefetched memberships seed an internal cache that the queryset returned
+ * from `all()` short-circuits to without re-querying. Mutations through
+ * `add` and `remove` invalidate the cache so subsequent reads observe the
+ * updated membership.
+ *
+ * @template TTarget - The persisted target record shape returned by `all()`.
+ */
+export declare class ManyToManyRelatedManager<TTarget extends Record<string, unknown>> {
+    private readonly inputs;
+    private static readonly BRAND;
+    readonly __tangoBrand: typeof ManyToManyRelatedManager.BRAND;
+    private prefetchCache;
+    /**
+     * Constructor is internal. Application and ORM code must build instances
+     * through {@link ManyToManyRelatedManager.create}, which owns the wiring
+     * between relation metadata and the backing through-table mutator. The
+     * testing package exposes a fixture for unit tests that need a custom
+     * mutator.
+     */
+    constructor(inputs: ManyToManyRelatedManagerInternalInputs<TTarget>);
+    /**
+     * Narrow an unknown value to {@link ManyToManyRelatedManager}.
+     */
+    static isManyToManyRelatedManager<TTarget extends Record<string, unknown>>(value: unknown): value is ManyToManyRelatedManager<TTarget>;
+    /**
+     * Build a {@link ManyToManyRelatedManager} bound to a single owner record.
+     * The factory derives the join-table descriptor from the relation edge and
+     * through-model fields, wires a {@link ThroughTableManager} against the
+     * supplied runtime-bound client, and returns a manager whose `add`,
+     * `remove`, and `all` methods enroll in any active
+     * `transaction.atomic(...)` boundary.
+     */
+    static create<TTarget extends Record<string, unknown>>(inputs: ManyToManyRelatedManagerCreateInputs<TTarget>): ManyToManyRelatedManager<TTarget>;
+    /**
+     * Insert join-table rows linking the owning record to the supplied
+     * targets. Duplicate links are ignored so repeated `add(...)` calls are
+     * idempotent. When multiple targets are supplied, Tango performs the
+     * membership write inside one `transaction.atomic(...)` boundary.
+     */
+    add(...targets: ManyToManyTargetRef<TTarget>[]): Promise<void>;
+    /**
+     * Delete join-table rows linking the owning record to the supplied
+     * targets. When multiple targets are supplied, Tango performs the
+     * membership write inside one `transaction.atomic(...)` boundary.
+     */
+    remove(...targets: ManyToManyTargetRef<TTarget>[]): Promise<void>;
+    /**
+     * Return a {@link QuerySet} for the related target rows of this many-to-many
+     * relation. When the relation was already loaded by `prefetchRelated(...)`,
+     * the first `fetch()` resolves with the cached materialization without
+     * re-querying. Mutating the membership through `add`/`remove` invalidates
+     * that cache.
+     */
+    all(): QuerySet<TTarget>;
+    /**
+     * Replace the prefetch cache with the supplied target rows. Called by the
+     * many-to-many prefetch path so a follow-up `all()` resolves without an
+     * extra database round-trip.
+     */
+    primePrefetchCache(targets: readonly TTarget[]): void;
+    /**
+     * Drop any cached prefetch results. Mutating helpers call this so reads
+     * after an `add`/`remove` go back to the database.
+     */
+    invalidateCache(): void;
+    /**
+     * Snapshot of the current prefetch cache, exposed for diagnostics and
+     * focused unit testing. Returns a fresh array copy so callers cannot
+     * mutate the manager's internal state.
+     */
+    snapshotCache(): readonly TTarget[] | null;
+    private resolveTargetPrimaryKeys;
+    private resolveTargetPrimaryKey;
+    private canonicalizePrimaryKey;
+}
+export {};

package/dist/manager/relations/ManyToManyRelatedQuerySet.d.ts

@@ -0,0 +1,62 @@
+import type { QueryResult } from '../../query/domain/QueryResult';
+import type { QuerySetState } from '../../query/domain/QuerySetState';
+import type { QueryExecutor } from '../../query/index';
+import { QuerySet } from '../../query/index';
+/**
+ * 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.
+ */
+export 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`).
+ */
+export 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;
+}
+export {};

package/dist/manager/relations/MaterializedModelRecord.d.ts

@@ -0,0 +1,28 @@
+import type { z } from 'zod';
+import type { Model, PersistedModelOutput } from '@danceroutine/tango-schema/domain';
+import type { DecoratedFieldKind, InternalDecoratedFieldKind, RelationDecoratedSchema } from '@danceroutine/tango-schema/model';
+import type { ManyToManyRelatedManager } from './ManyToManyRelatedManager';
+type IsAny<TValue> = 0 extends 1 & TValue ? true : false;
+type AnyModel = Model<z.ZodObject<z.ZodRawShape>, string>;
+type SchemaShape<TSchema> = TSchema extends z.ZodObject<infer TShape> ? TShape : never;
+type RelationKindOf<TField> = TField extends RelationDecoratedSchema<z.ZodTypeAny, infer TKind extends DecoratedFieldKind, AnyModel, string | undefined, string | undefined> ? TKind : never;
+type RelationTarget<TField> = TField extends RelationDecoratedSchema<z.ZodTypeAny, DecoratedFieldKind, infer TTarget, string | undefined, string | undefined> ? TTarget : never;
+type RelationPublishedName<TField, TFallback extends string> = TField extends RelationDecoratedSchema<z.ZodTypeAny, DecoratedFieldKind, AnyModel, infer TName extends string | undefined, string | undefined> ? TName extends string ? TName : TFallback : TFallback;
+type ModelRow<TTarget> = TTarget extends Model<infer TSchema extends z.ZodObject<z.ZodRawShape>, string> ? PersistedModelOutput<TSchema> : never;
+type ManyToManyKeysOfShape<TShape extends z.ZodRawShape> = Extract<{
+    [K in keyof TShape]: IsAny<TShape[K]> extends true ? never : [RelationKindOf<TShape[K]>] extends [never] ? never : [RelationKindOf<TShape[K]>] extends [typeof InternalDecoratedFieldKind.MANY_TO_MANY] ? K : never;
+}[keyof TShape], string>;
+type ManyToManyManagers<TShape extends z.ZodRawShape> = {
+    readonly [K in ManyToManyKeysOfShape<TShape> as K extends keyof TShape ? RelationPublishedName<TShape[K], K> : never]: K extends keyof TShape ? RelationTarget<TShape[K]> extends AnyModel ? ManyToManyRelatedManager<ModelRow<RelationTarget<TShape[K]>>> : never : never;
+};
+/**
+ * Persisted model record shape returned by ORM read and write paths.
+ *
+ * Combines the column-level {@link PersistedModelOutput} with a per-relation
+ * {@link ManyToManyRelatedManager} for every many-to-many field declared on the
+ * source schema. The manager properties are attached as non-enumerable accessors
+ * at runtime, so `JSON.stringify` and structural equality checks only see the
+ * column data.
+ */
+export type MaterializedModelRecord<TSchema extends z.ZodObject<z.ZodRawShape>> = PersistedModelOutput<TSchema> & ManyToManyManagers<SchemaShape<TSchema>>;
+export {};

package/dist/manager/relations/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Domain boundary barrel: centralizes ORM relation managers attached to
+ * materialized model records.
+ */
+export { ManyToManyRelatedQuerySet } from './ManyToManyRelatedQuerySet';
+export type { ManyToManyRelatedQuerySetBridge } from './ManyToManyRelatedQuerySet';
+export { ManyToManyRelatedManager } from './ManyToManyRelatedManager';
+export type { ManyToManyRelatedManagerCreateInputs, ManyToManyTargetRef } from './ManyToManyRelatedManager';
+export type { MaterializedModelRecord } from './MaterializedModelRecord';

package/dist/manager/relations/internal/ThroughTableManager.d.ts

@@ -0,0 +1,79 @@
+import type { DBClient } from '../../../connection/clients/DBClient';
+import type { TableMeta } from '../../../query/domain/index';
+import type { Adapter } from '../../../connection/adapters/Adapter';
+import { OrmSqlSafetyAdapter } from '../../../validation/OrmSqlSafetyAdapter';
+import { MutationCompiler, type DuplicateInsertPolicy } from '../../internal/MutationCompiler';
+/**
+ * Resolved through-table descriptor used by {@link ThroughTableManager}. The
+ * descriptor is derived once from a relation edge plus its through-model
+ * metadata, then reused for every link insert, delete, and read.
+ */
+export interface ThroughTableLinkDescriptor {
+    /** Physical join-table name validated against SQL identifier safety rules. */
+    table: string;
+    /** Primary-key column name on the join table. */
+    primaryKey: string;
+    /** Full column map for the join table, used by the SQL safety adapter. */
+    columns: Record<string, string>;
+    /** Join-table column that stores the owner-side primary-key value. */
+    sourceColumn: string;
+    /** Join-table column that stores the target-side primary-key value. */
+    targetColumn: string;
+}
+/**
+ * Inputs accepted by {@link ThroughTableManager.fromRelation}.
+ */
+export interface ThroughTableManagerFromRelationInputs {
+    relation: NonNullable<TableMeta['relations']>[string];
+    throughModelFields: ReadonlyArray<{
+        name: string;
+        type: string;
+        primaryKey?: boolean;
+    }>;
+    client: DBClient;
+    mutationCompiler: MutationCompiler;
+    adapter: Adapter;
+    sqlSafetyAdapter: OrmSqlSafetyAdapter;
+}
+export interface InsertLinkOptions {
+    onDuplicate?: DuplicateInsertPolicy;
+}
+/**
+ * Internal helper that issues the INSERT, DELETE, and SELECT statements for
+ * a single many-to-many join table. Centralizes SQL safety validation and
+ * compilation so {@link ManyToManyRelatedManager} implementations only deal
+ * in primary-key values.
+ */
+export declare class ThroughTableManager {
+    private readonly client;
+    private readonly mutationCompiler;
+    private readonly descriptor;
+    private readonly adapter;
+    private readonly sqlSafetyAdapter;
+    constructor(client: DBClient, mutationCompiler: MutationCompiler, descriptor: ThroughTableLinkDescriptor, adapter: Adapter, sqlSafetyAdapter?: OrmSqlSafetyAdapter);
+    /**
+     * Derive a {@link ThroughTableLinkDescriptor} from the through-model
+     * metadata exposed by a many-to-many relation edge.
+     */
+    static buildLinkDescriptor(relation: NonNullable<TableMeta['relations']>[string], throughModelFields: ReadonlyArray<{
+        name: string;
+        type: string;
+        primaryKey?: boolean;
+    }>): ThroughTableLinkDescriptor;
+    /**
+     * Convenience factory that derives the join-table descriptor from the
+     * relation edge and instantiates a {@link ThroughTableManager} in one
+     * step.
+     */
+    static fromRelation(inputs: ThroughTableManagerFromRelationInputs): ThroughTableManager;
+    /**
+     * Read every target primary-key value linked to the supplied owner via
+     * the join table. Used by ManyToManyRelatedManager.all to scope
+     * follow-up target queries to the current owner.
+     */
+    selectTargetIdsForOwner(ownerPrimaryKey: unknown): Promise<readonly (string | number)[]>;
+    insertLink(ownerPrimaryKey: unknown, targetPrimaryKey: unknown, options?: InsertLinkOptions): Promise<void>;
+    insertLinks(ownerPrimaryKey: unknown, targetPrimaryKeys: readonly unknown[], options?: InsertLinkOptions): Promise<void>;
+    deleteLink(ownerPrimaryKey: unknown, targetPrimaryKey: unknown): Promise<void>;
+    deleteLinks(ownerPrimaryKey: unknown, targetPrimaryKeys: readonly unknown[]): Promise<void>;
+}