@danceroutine/tango-orm 1.6.0 → 1.8.0

package/dist/InternalDialect-ClSaUNso.js

@@ -0,0 +1,10 @@
+
+//#region src/query/domain/internal/InternalDialect.ts
+const InternalDialect = {
+	POSTGRES: "postgres",
+	SQLITE: "sqlite"
+};
+
+//#endregion
+export { InternalDialect };
+//# sourceMappingURL=InternalDialect-ClSaUNso.js.map

package/dist/InternalDialect-ClSaUNso.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalDialect-ClSaUNso.js","names":[],"sources":["../src/query/domain/internal/InternalDialect.ts"],"sourcesContent":["export const InternalDialect = {\n    POSTGRES: 'postgres',\n    SQLITE: 'sqlite',\n} as const;\n"],"mappings":";;MAAa,kBAAkB;CAC3B,UAAU;CACV,QAAQ;AACX"}

package/dist/PostgresAdapter-CXKdKBG-.js

@@ -0,0 +1,4 @@
+import { PostgresAdapter } from "./PostgresAdapter-DySFW6vy.js";
+import "./InternalDialect-ClSaUNso.js";
+
+export { PostgresAdapter };

package/dist/PostgresAdapter-DySFW6vy.js

@@ -0,0 +1,128 @@
+import { InternalDialect } from "./InternalDialect-ClSaUNso.js";
+import pg from "pg";
+
+//#region src/connection/clients/dialects/PostgresClient.ts
+var PostgresClient = class PostgresClient {
+	static BRAND = "tango.orm.postgres_client";
+	__tangoBrand = PostgresClient.BRAND;
+	constructor(client) {
+		this.client = client;
+	}
+	/**
+	* Narrow an unknown value to `PostgresClient`.
+	*/
+	static isPostgresClient(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === PostgresClient.BRAND;
+	}
+	/**
+	* Execute a SQL statement with optional bound parameters.
+	*/
+	async query(sql, params) {
+		const result = await this.client.query(sql, params);
+		return { rows: result.rows };
+	}
+	/**
+	* Begin a database transaction.
+	*/
+	async begin() {
+		await this.client.query("BEGIN");
+	}
+	/**
+	* Commit the active transaction.
+	*/
+	async commit() {
+		await this.client.query("COMMIT");
+	}
+	/**
+	* Roll back the active transaction.
+	*/
+	async rollback() {
+		await this.client.query("ROLLBACK");
+	}
+	/**
+	* Create a savepoint inside the active transaction.
+	*/
+	async createSavepoint(name) {
+		await this.client.query(`SAVEPOINT ${name}`);
+	}
+	/**
+	* Release a previously-created savepoint.
+	*/
+	async releaseSavepoint(name) {
+		await this.client.query(`RELEASE SAVEPOINT ${name}`);
+	}
+	/**
+	* Roll back the active transaction to a savepoint.
+	*/
+	async rollbackToSavepoint(name) {
+		await this.client.query(`ROLLBACK TO SAVEPOINT ${name}`);
+	}
+	/**
+	* Release the leased PostgreSQL client back to its owning pool.
+	*/
+	async close() {
+		this.client.release();
+	}
+};
+
+//#endregion
+//#region src/connection/adapters/dialects/PostgresAdapter.ts
+const { Pool } = pg;
+var PostgresAdapter = class PostgresAdapter {
+	static BRAND = "tango.orm.postgres_adapter";
+	__tangoBrand = PostgresAdapter.BRAND;
+	name = "postgres";
+	dialect = InternalDialect.POSTGRES;
+	/**
+	* 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
+	*/
+	features = {
+		transactionalDDL: true,
+		concurrentIndex: true,
+		validateForeignKeys: true,
+		ignoreDuplicateInsert: true
+	};
+	placeholders = {
+		at(index) {
+			return `$${index}`;
+		},
+		list(count) {
+			return this.listFromOffset(count, 0);
+		},
+		listFromOffset(count, startOffset) {
+			return Array.from({ length: count }, (_value, index) => `$${startOffset + index + 1}`).join(", ");
+		}
+	};
+	/**
+	* Narrow an unknown value to `PostgresAdapter`.
+	*/
+	static isPostgresAdapter(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === PostgresAdapter.BRAND;
+	}
+	/**
+	* Open a Postgres connection pool and return a client-backed DB abstraction.
+	*/
+	async connect(config) {
+		const pool = new Pool({
+			connectionString: config.url,
+			host: config.host,
+			port: config.port,
+			database: config.database,
+			user: config.user,
+			password: config.password,
+			max: config.maxConnections || 10
+		});
+		const client = await pool.connect();
+		return new PostgresClient(client);
+	}
+};
+
+//#endregion
+export { PostgresAdapter, PostgresClient };
+//# sourceMappingURL=PostgresAdapter-DySFW6vy.js.map

package/dist/PostgresAdapter-DySFW6vy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresAdapter-DySFW6vy.js","names":["client: PostgresPoolClientLike","value: unknown","sql: string","params?: readonly unknown[]","name: string","index: number","count: number","startOffset: number","value: unknown","config: AdapterConfig"],"sources":["../src/connection/clients/dialects/PostgresClient.ts","../src/connection/adapters/dialects/PostgresAdapter.ts"],"sourcesContent":["import type { DBClient } from '../DBClient';\n\nexport interface PostgresPoolClientLike {\n    query(sql: string, params?: readonly unknown[]): Promise<{ rows: unknown[] }>;\n    release(): void;\n}\n\n/**\n * Transaction-capable client backed by a PostgreSQL pool client.\n */\nexport class PostgresClient implements DBClient {\n    static readonly BRAND = 'tango.orm.postgres_client' as const;\n    readonly __tangoBrand: typeof PostgresClient.BRAND = PostgresClient.BRAND;\n\n    constructor(private client: PostgresPoolClientLike) {}\n\n    /**\n     * Narrow an unknown value to `PostgresClient`.\n     */\n    static isPostgresClient(value: unknown): value is PostgresClient {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === PostgresClient.BRAND\n        );\n    }\n\n    /**\n     * Execute a SQL statement with optional bound parameters.\n     */\n    async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n        const result = await this.client.query(sql, params as unknown[]);\n        return { rows: result.rows as T[] };\n    }\n\n    /**\n     * Begin a database transaction.\n     */\n    async begin(): Promise<void> {\n        await this.client.query('BEGIN');\n    }\n\n    /**\n     * Commit the active transaction.\n     */\n    async commit(): Promise<void> {\n        await this.client.query('COMMIT');\n    }\n\n    /**\n     * Roll back the active transaction.\n     */\n    async rollback(): Promise<void> {\n        await this.client.query('ROLLBACK');\n    }\n\n    /**\n     * Create a savepoint inside the active transaction.\n     */\n    async createSavepoint(name: string): Promise<void> {\n        await this.client.query(`SAVEPOINT ${name}`);\n    }\n\n    /**\n     * Release a previously-created savepoint.\n     */\n    async releaseSavepoint(name: string): Promise<void> {\n        await this.client.query(`RELEASE SAVEPOINT ${name}`);\n    }\n\n    /**\n     * Roll back the active transaction to a savepoint.\n     */\n    async rollbackToSavepoint(name: string): Promise<void> {\n        await this.client.query(`ROLLBACK TO SAVEPOINT ${name}`);\n    }\n\n    /**\n     * Release the leased PostgreSQL client back to its owning pool.\n     */\n    async close(): Promise<void> {\n        this.client.release();\n    }\n}\n","import pg from 'pg';\nimport type { Adapter, AdapterConfig, SqlPlaceholders } from '../Adapter';\nimport type { DBClient } from '../../clients/DBClient';\nimport { PostgresClient } from '../../clients/dialects/PostgresClient';\nimport { InternalDialect } from '../../../query/domain/internal/InternalDialect';\n\nconst { Pool } = pg;\n\n/**\n * Postgres adapter that turns adapter config into a transactional `DBClient`.\n */\nexport class PostgresAdapter implements Adapter {\n    static readonly BRAND = 'tango.orm.postgres_adapter' as const;\n    readonly __tangoBrand: typeof PostgresAdapter.BRAND = PostgresAdapter.BRAND;\n    readonly name = 'postgres';\n    readonly dialect: Adapter['dialect'] = InternalDialect.POSTGRES;\n    /**\n     * Declares capabilities of this database adapter.\n     * Used by the migration runner and query compiler to determine which\n     * SQL features can be safely used:\n     * - transactionalDDL: Postgres supports DDL inside transactions (safe rollback of schema changes)\n     * - concurrentIndex: Supports CREATE INDEX CONCURRENTLY (non-blocking index builds)\n     * - validateForeignKeys: Supports deferred FK validation via NOT VALID + VALIDATE CONSTRAINT\n     * - ignoreDuplicateInsert: Supports duplicate-safe insert semantics for manager-owned link writes\n     */\n    readonly features: Adapter['features'] = {\n        transactionalDDL: true,\n        concurrentIndex: true,\n        validateForeignKeys: true,\n        ignoreDuplicateInsert: true,\n    };\n    readonly placeholders: SqlPlaceholders = {\n        at(index: number): string {\n            return `$${index}`;\n        },\n        list(count: number): string {\n            return this.listFromOffset(count, 0);\n        },\n        listFromOffset(count: number, startOffset: number): string {\n            return Array.from({ length: count }, (_value, index) => `$${startOffset + index + 1}`).join(', ');\n        },\n    };\n\n    /**\n     * Narrow an unknown value to `PostgresAdapter`.\n     */\n    static isPostgresAdapter(value: unknown): value is PostgresAdapter {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === PostgresAdapter.BRAND\n        );\n    }\n\n    /**\n     * Open a Postgres connection pool and return a client-backed DB abstraction.\n     */\n    async connect(config: AdapterConfig): Promise<DBClient> {\n        const 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        const client = await pool.connect();\n        return new PostgresClient(client);\n    }\n}\n"],"mappings":";;;;IAUa,iBAAN,MAAM,eAAmC;CAC5C,OAAgB,QAAQ;CACxB,eAAqD,eAAe;CAEpE,YAAoBA,QAAgC;AAAA,OAAhC,SAAA;CAAkC;;;;CAKtD,OAAO,iBAAiBC,OAAyC;AAC7D,gBACW,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB,eAAe;CAE7E;;;;CAKD,MAAM,MAAmBC,KAAaC,QAAqD;EACvF,MAAM,SAAS,MAAM,KAAK,OAAO,MAAM,KAAK,OAAoB;AAChE,SAAO,EAAE,MAAM,OAAO,KAAa;CACtC;;;;CAKD,MAAM,QAAuB;AACzB,QAAM,KAAK,OAAO,MAAM,QAAQ;CACnC;;;;CAKD,MAAM,SAAwB;AAC1B,QAAM,KAAK,OAAO,MAAM,SAAS;CACpC;;;;CAKD,MAAM,WAA0B;AAC5B,QAAM,KAAK,OAAO,MAAM,WAAW;CACtC;;;;CAKD,MAAM,gBAAgBC,MAA6B;AAC/C,QAAM,KAAK,OAAO,OAAO,YAAY,KAAK,EAAE;CAC/C;;;;CAKD,MAAM,iBAAiBA,MAA6B;AAChD,QAAM,KAAK,OAAO,OAAO,oBAAoB,KAAK,EAAE;CACvD;;;;CAKD,MAAM,oBAAoBA,MAA6B;AACnD,QAAM,KAAK,OAAO,OAAO,wBAAwB,KAAK,EAAE;CAC3D;;;;CAKD,MAAM,QAAuB;AACzB,OAAK,OAAO,SAAS;CACxB;AACJ;;;;AC7ED,MAAM,EAAE,MAAM,GAAG;IAKJ,kBAAN,MAAM,gBAAmC;CAC5C,OAAgB,QAAQ;CACxB,eAAsD,gBAAgB;CACtE,OAAgB;CAChB,UAAuC,gBAAgB;;;;;;;;;;CAUvD,WAAyC;EACrC,kBAAkB;EAClB,iBAAiB;EACjB,qBAAqB;EACrB,uBAAuB;CAC1B;CACD,eAAyC;EACrC,GAAGC,OAAuB;AACtB,WAAQ,GAAG,MAAM;EACpB;EACD,KAAKC,OAAuB;AACxB,UAAO,KAAK,eAAe,OAAO,EAAE;EACvC;EACD,eAAeA,OAAeC,aAA6B;AACvD,UAAO,MAAM,KAAK,EAAE,QAAQ,MAAO,GAAE,CAAC,QAAQ,WAAW,GAAG,cAAc,QAAQ,EAAE,EAAE,CAAC,KAAK,KAAK;EACpG;CACJ;;;;CAKD,OAAO,kBAAkBC,OAA0C;AAC/D,gBACW,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB,gBAAgB;CAE9E;;;;CAKD,MAAM,QAAQC,QAA0C;EACpD,MAAM,OAAO,IAAI,KAAK;GAClB,kBAAkB,OAAO;GACzB,MAAM,OAAO;GACb,MAAM,OAAO;GACb,UAAU,OAAO;GACjB,MAAM,OAAO;GACb,UAAU,OAAO;GACjB,KAAK,OAAO,kBAAkB;EACjC;EAED,MAAM,SAAS,MAAM,KAAK,SAAS;AACnC,SAAO,IAAI,eAAe;CAC7B;AACJ"}

package/dist/{SqliteClient-CjOK9-ki.js → SqliteAdapter-CDdOjRmW.js}

@@ -1,3 +1,5 @@
+import { InternalDialect } from "./InternalDialect-ClSaUNso.js";
+import { createRequire } from "node:module";
 
 //#region src/connection/clients/dialects/SqliteClient.ts
 var SqliteClient = class SqliteClient {
@@ -36,7 +38,7 @@ else stmt.run();
 	*/
 	async begin() {
 		if (!this.inTransaction) {
-			this.db.prepare("BEGIN").run();
+			this.db.prepare("BEGIN IMMEDIATE").run();
 			this.inTransaction = true;
 		}
 	}
@@ -93,5 +95,57 @@ function isDateValue(value) {
 }
 
 //#endregion
-export { SqliteClient };
-//# sourceMappingURL=SqliteClient-CjOK9-ki.js.map
+//#region src/connection/adapters/dialects/SqliteAdapter.ts
+var SqliteAdapter = class SqliteAdapter {
+	static BRAND = "tango.orm.sqlite_adapter";
+	__tangoBrand = SqliteAdapter.BRAND;
+	name = "sqlite";
+	dialect = InternalDialect.SQLITE;
+	features = {
+		transactionalDDL: true,
+		concurrentIndex: false,
+		validateForeignKeys: false,
+		ignoreDuplicateInsert: true
+	};
+	placeholders = {
+		at() {
+			return "?";
+		},
+		list(count) {
+			return Array.from({ length: count }, () => "?").join(", ");
+		},
+		listFromOffset(count) {
+			return this.list(count);
+		}
+	};
+	/**
+	* Narrow an unknown value to `SqliteAdapter`.
+	*/
+	static isSqliteAdapter(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === SqliteAdapter.BRAND;
+	}
+	/**
+	* Open a SQLite database and apply baseline pragmas for durability/safety.
+	*/
+	async connect(config = {}) {
+		const Database = this.getDatabaseCtor();
+		const filename = typeof config.filename === "string" && config.filename.length > 0 ? config.filename : ":memory:";
+		const db = new Database(filename);
+		db.pragma("journal_mode = WAL");
+		db.pragma("foreign_keys = ON");
+		db.pragma("busy_timeout = 5000");
+		return new SqliteClient(db);
+	}
+	getDatabaseCtor() {
+		const require = createRequire(import.meta.url);
+		const moduleValue = require("better-sqlite3");
+		if (typeof moduleValue === "function") return moduleValue;
+		const defaultExport = moduleValue.default;
+		if (typeof defaultExport === "function") return defaultExport;
+		throw new TypeError("Failed to load better-sqlite3 constructor.");
+	}
+};
+
+//#endregion
+export { SqliteAdapter, SqliteClient };
+//# sourceMappingURL=SqliteAdapter-CDdOjRmW.js.map

package/dist/SqliteAdapter-CDdOjRmW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteAdapter-CDdOjRmW.js","names":["db: Database.Database","value: unknown","sql: string","params?: readonly unknown[]","name: string","count: number","value: unknown","config: AdapterConfig"],"sources":["../src/connection/clients/dialects/SqliteClient.ts","../src/connection/adapters/dialects/SqliteAdapter.ts"],"sourcesContent":["import type Database from 'better-sqlite3';\nimport type { DBClient } from '../DBClient';\n\n/**\n * Transaction-capable client backed by a synchronous `better-sqlite3` handle.\n */\nexport class SqliteClient implements DBClient {\n    static readonly BRAND = 'tango.orm.sqlite_client' as const;\n    readonly __tangoBrand: typeof SqliteClient.BRAND = SqliteClient.BRAND;\n    private inTransaction = false;\n\n    constructor(private db: Database.Database) {}\n\n    /**\n     * Narrow an unknown value to `SqliteClient`.\n     */\n    static isSqliteClient(value: unknown): value is SqliteClient {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === SqliteClient.BRAND\n        );\n    }\n\n    /**\n     * Execute a SQL statement with optional parameters.\n     *\n     * `SELECT`/`PRAGMA` statements return row data; write statements return\n     * an empty row list.\n     */\n    async query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{ rows: T[] }> {\n        const stmt = this.db.prepare(sql);\n        const isPragmaWrite = /^\\s*PRAGMA\\b/i.test(sql) && /=/.test(sql);\n\n        const normalizedParams = params?.map((param) => this.normalizeParam(param));\n\n        if (!isPragmaWrite && stmt.reader) {\n            const rows = normalizedParams ? stmt.all(...(normalizedParams as unknown[])) : stmt.all();\n            return { rows: rows as T[] };\n        }\n\n        if (normalizedParams) {\n            stmt.run(...(normalizedParams as unknown[]));\n        } else {\n            stmt.run();\n        }\n        return { rows: [] };\n    }\n\n    /**\n     * Begin a transaction if one is not already active.\n     */\n    async begin(): Promise<void> {\n        if (!this.inTransaction) {\n            this.db.prepare('BEGIN IMMEDIATE').run();\n            this.inTransaction = true;\n        }\n    }\n\n    /**\n     * Commit the active transaction.\n     */\n    async commit(): Promise<void> {\n        if (this.inTransaction) {\n            this.db.prepare('COMMIT').run();\n            this.inTransaction = false;\n        }\n    }\n\n    /**\n     * Roll back the active transaction.\n     */\n    async rollback(): Promise<void> {\n        if (this.inTransaction) {\n            this.db.prepare('ROLLBACK').run();\n            this.inTransaction = false;\n        }\n    }\n\n    /**\n     * Create a savepoint inside the active transaction.\n     */\n    async createSavepoint(name: string): Promise<void> {\n        this.db.prepare(`SAVEPOINT ${name}`).run();\n    }\n\n    /**\n     * Release a previously-created savepoint.\n     */\n    async releaseSavepoint(name: string): Promise<void> {\n        this.db.prepare(`RELEASE SAVEPOINT ${name}`).run();\n    }\n\n    /**\n     * Roll back the active transaction to a savepoint.\n     */\n    async rollbackToSavepoint(name: string): Promise<void> {\n        this.db.prepare(`ROLLBACK TO SAVEPOINT ${name}`).run();\n    }\n\n    /**\n     * Close the underlying SQLite handle.\n     */\n    async close(): Promise<void> {\n        this.db.close();\n    }\n\n    private normalizeParam(value: unknown): unknown {\n        if (isDateValue(value)) {\n            return value.toISOString();\n        }\n        if (typeof value === 'boolean') {\n            return value ? 1 : 0;\n        }\n        return value;\n    }\n}\n\nfunction isDateValue(value: unknown): value is Date {\n    return (\n        typeof value === 'object' &&\n        value !== null &&\n        typeof (value as { getTime?: unknown }).getTime === 'function' &&\n        typeof (value as { toISOString?: unknown }).toISOString === 'function'\n    );\n}\n","import { createRequire } from 'node:module';\nimport type { Database as BetterSqliteDatabase } from 'better-sqlite3';\nimport type { Adapter, AdapterConfig, SqlPlaceholders } from '../Adapter';\nimport type { DBClient } from '../../clients/DBClient';\nimport { SqliteClient } from '../../clients/dialects/SqliteClient';\nimport { InternalDialect } from '../../../query/domain/internal/InternalDialect';\n\ntype BetterSqliteCtor = new (filename: string, options?: unknown) => BetterSqliteDatabase;\n\n/**\n * SQLite adapter that creates a `better-sqlite3` backed `DBClient`.\n */\nexport class SqliteAdapter implements Adapter {\n    static readonly BRAND = 'tango.orm.sqlite_adapter' as const;\n    readonly __tangoBrand: typeof SqliteAdapter.BRAND = SqliteAdapter.BRAND;\n    readonly name = 'sqlite';\n    readonly dialect: Adapter['dialect'] = InternalDialect.SQLITE;\n    readonly features: Adapter['features'] = {\n        transactionalDDL: true,\n        concurrentIndex: false,\n        validateForeignKeys: false,\n        ignoreDuplicateInsert: true,\n    };\n    readonly placeholders: SqlPlaceholders = {\n        at(): string {\n            return '?';\n        },\n        list(count: number): string {\n            return Array.from({ length: count }, () => '?').join(', ');\n        },\n        listFromOffset(count: number): string {\n            return this.list(count);\n        },\n    };\n\n    /**\n     * Narrow an unknown value to `SqliteAdapter`.\n     */\n    static isSqliteAdapter(value: unknown): value is SqliteAdapter {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === SqliteAdapter.BRAND\n        );\n    }\n\n    /**\n     * Open a SQLite database and apply baseline pragmas for durability/safety.\n     */\n    async connect(config: AdapterConfig = {}): Promise<DBClient> {\n        const Database = this.getDatabaseCtor();\n        const filename =\n            typeof config.filename === 'string' && config.filename.length > 0 ? config.filename : ':memory:';\n        const db = new Database(filename);\n        db.pragma('journal_mode = WAL');\n        db.pragma('foreign_keys = ON');\n        db.pragma('busy_timeout = 5000');\n\n        return new SqliteClient(db);\n    }\n\n    private getDatabaseCtor(): BetterSqliteCtor {\n        const require = createRequire(import.meta.url);\n        const moduleValue = require('better-sqlite3') as unknown;\n        if (typeof moduleValue === 'function') {\n            return moduleValue as BetterSqliteCtor;\n        }\n\n        const defaultExport = (moduleValue as { default?: unknown }).default;\n        if (typeof defaultExport === 'function') {\n            return defaultExport as BetterSqliteCtor;\n        }\n\n        throw new TypeError('Failed to load better-sqlite3 constructor.');\n    }\n}\n"],"mappings":"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"}

package/dist/SqliteAdapter-mjtXuVTg.js

@@ -0,0 +1,4 @@
+import "./InternalDialect-ClSaUNso.js";
+import { SqliteAdapter } from "./SqliteAdapter-CDdOjRmW.js";
+
+export { SqliteAdapter };

package/dist/connection/adapters/Adapter.d.ts

@@ -1,4 +1,5 @@
 import type { DBClient } from '../clients/DBClient';
+import type { Dialect } from '../../query/domain/Dialect';
 /**
  * Connection options shared by built-in DB adapters.
  */
@@ -13,11 +14,38 @@ export interface AdapterConfig {
     maxConnections?: number;
 }
 /**
- * Runtime adapter contract for establishing `DBClient` connections.
+ * Dialect-aware SQL parameter placeholder generator supplied by an
+ * {@link Adapter}. Consolidates the `$N` vs `?` decision on the adapter so
+ * compilers and manager-side SQL builders do not branch on dialect to emit
+ * parameter placeholders.
+ */
+export interface SqlPlaceholders {
+    /** Placeholder for a single parameter at the given 1-based index. */
+    at(index: number): string;
+    /** Comma-joined placeholder list for `count` parameters numbered starting at 1. */
+    list(count: number): string;
+    /**
+     * Comma-joined placeholder list for `count` parameters, skipping the
+     * first `startOffset` placeholder positions. Used when a statement
+     * already bound some parameters before the list (for example, an
+     * `UPDATE ... WHERE` clause).
+     */
+    listFromOffset(count: number, startOffset: number): string;
+}
+/**
+ * Runtime adapter contract for establishing `DBClient` connections and
+ * supplying dialect-specific SQL primitives (placeholders, feature flags)
+ * to manager-side compilers.
  */
 export interface Adapter {
     /** Stable adapter name used in configuration and registry lookup. */
     name: string;
+    /**
+     * Declared SQL dialect this adapter targets. Consumers branch on the
+     * adapter, not on a free-standing dialect string, so dialect-awareness
+     * is funnelled through the adapter interface.
+     */
+    dialect: Dialect;
     /** Open a database connection and return a client abstraction. */
     connect(config: AdapterConfig): Promise<DBClient>;
     /** SQL capability flags used by migrations/query orchestration. */
@@ -25,5 +53,8 @@ export interface Adapter {
         transactionalDDL: boolean;
         concurrentIndex: boolean;
         validateForeignKeys: boolean;
+        ignoreDuplicateInsert: boolean;
     };
+    /** Dialect-aware SQL parameter placeholder generator. */
+    placeholders: SqlPlaceholders;
 }

package/dist/connection/adapters/dialects/PostgresAdapter.d.ts

@@ -1,4 +1,4 @@
-import type { Adapter, AdapterConfig } from '../Adapter';
+import type { Adapter, AdapterConfig, SqlPlaceholders } from '../Adapter';
 import type { DBClient } from '../../clients/DBClient';
 /**
  * Postgres adapter that turns adapter config into a transactional `DBClient`.
@@ -7,6 +7,7 @@ export 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
@@ -14,12 +15,10 @@ export declare class PostgresAdapter implements Adapter {
      * - 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: {
-        transactionalDDL: boolean;
-        concurrentIndex: boolean;
-        validateForeignKeys: boolean;
-    };
+    readonly features: Adapter['features'];
+    readonly placeholders: SqlPlaceholders;
     /**
      * Narrow an unknown value to `PostgresAdapter`.
      */

package/dist/connection/adapters/dialects/SqliteAdapter.d.ts

@@ -1,4 +1,4 @@
-import type { Adapter, AdapterConfig } from '../Adapter';
+import type { Adapter, AdapterConfig, SqlPlaceholders } from '../Adapter';
 import type { DBClient } from '../../clients/DBClient';
 /**
  * SQLite adapter that creates a `better-sqlite3` backed `DBClient`.
@@ -7,11 +7,9 @@ export declare class SqliteAdapter implements Adapter {
     static readonly BRAND: "tango.orm.sqlite_adapter";
     readonly __tangoBrand: typeof SqliteAdapter.BRAND;
     readonly name = "sqlite";
-    readonly features: {
-        transactionalDDL: boolean;
-        concurrentIndex: boolean;
-        validateForeignKeys: boolean;
-    };
+    readonly dialect: Adapter['dialect'];
+    readonly features: Adapter['features'];
+    readonly placeholders: SqlPlaceholders;
     /**
      * Narrow an unknown value to `SqliteAdapter`.
      */

package/dist/connection/adapters/index.d.ts

@@ -4,5 +4,5 @@
  */
 export * as dialects from './dialects/index';
 export { AdapterRegistry, connectDB, getDefaultAdapterRegistry } from './AdapterRegistry';
-export type { Adapter, AdapterConfig } from './Adapter';
+export type { Adapter, AdapterConfig, SqlPlaceholders } from './Adapter';
 export { PostgresAdapter, SqliteAdapter } from './dialects/index';

package/dist/connection/index.d.ts

@@ -5,7 +5,7 @@
 export * as adapters from './adapters/index';
 export * as clients from './clients/index';
 export { AdapterRegistry, connectDB, getDefaultAdapterRegistry } from './adapters/index';
-export type { Adapter, AdapterConfig } from './adapters/index';
+export type { Adapter, AdapterConfig, SqlPlaceholders } from './adapters/index';
 export type { DBClient } from './clients/DBClient';
 export { PostgresAdapter, SqliteAdapter } from './adapters/index';
 export { PostgresClient, SqliteClient } from './clients/index';

package/dist/connection/index.js

@@ -1,7 +1,6 @@
-import { PostgresClient } from "../PostgresClient-BQJZfEOT.js";
-import { PostgresAdapter } from "../PostgresAdapter-CMiEpHya.js";
-import { SqliteClient } from "../SqliteClient-CjOK9-ki.js";
-import { SqliteAdapter } from "../SqliteAdapter-CeqhyrPC.js";
-import { AdapterRegistry, adapters_exports, clients_exports, connectDB, getDefaultAdapterRegistry } from "../connection-B_K2ZAf7.js";
+import { PostgresAdapter, PostgresClient } from "../PostgresAdapter-DySFW6vy.js";
+import "../InternalDialect-ClSaUNso.js";
+import { SqliteAdapter, SqliteClient } from "../SqliteAdapter-CDdOjRmW.js";
+import { AdapterRegistry, adapters_exports, clients_exports, connectDB, getDefaultAdapterRegistry } from "../connection-Dmhgx31M.js";
 
 export { AdapterRegistry, PostgresAdapter, PostgresClient, SqliteAdapter, SqliteClient, adapters_exports as adapters, clients_exports as clients, connectDB, getDefaultAdapterRegistry };

package/dist/{connection-B_K2ZAf7.js → connection-Dmhgx31M.js}

@@ -1,8 +1,6 @@
 import { __export } from "./chunk-DLY2FNSh.js";
-import { PostgresClient } from "./PostgresClient-BQJZfEOT.js";
-import { PostgresAdapter } from "./PostgresAdapter-CMiEpHya.js";
-import { SqliteClient } from "./SqliteClient-CjOK9-ki.js";
-import { SqliteAdapter } from "./SqliteAdapter-CeqhyrPC.js";
+import { PostgresAdapter, PostgresClient } from "./PostgresAdapter-DySFW6vy.js";
+import { SqliteAdapter, SqliteClient } from "./SqliteAdapter-CDdOjRmW.js";
 
 //#region src/connection/adapters/dialects/index.ts
 var dialects_exports$1 = {};
@@ -30,8 +28,8 @@ var AdapterRegistry = class AdapterRegistry {
 	static async getDefaultRegistry() {
 		if (AdapterRegistry.defaultRegistryInstance) return AdapterRegistry.defaultRegistryInstance;
 		AdapterRegistry.defaultRegistryInstance = new AdapterRegistry();
-		const { PostgresAdapter: PostgresAdapter$1 } = await import("./PostgresAdapter-BFdo_nIt.js");
-		const { SqliteAdapter: SqliteAdapter$1 } = await import("./SqliteAdapter-A-P9zUhP.js");
+		const { PostgresAdapter: PostgresAdapter$1 } = await import("./PostgresAdapter-CXKdKBG-.js");
+		const { SqliteAdapter: SqliteAdapter$1 } = await import("./SqliteAdapter-mjtXuVTg.js");
 		AdapterRegistry.defaultRegistryInstance.register(new PostgresAdapter$1());
 		AdapterRegistry.defaultRegistryInstance.register(new SqliteAdapter$1());
 		return AdapterRegistry.defaultRegistryInstance;
@@ -116,4 +114,4 @@ __export(connection_exports, {
 
 //#endregion
 export { AdapterRegistry, adapters_exports, clients_exports, connectDB, connection_exports, getDefaultAdapterRegistry };
-//# sourceMappingURL=connection-B_K2ZAf7.js.map
+//# sourceMappingURL=connection-Dmhgx31M.js.map

package/dist/{connection-B_K2ZAf7.js.map → connection-Dmhgx31M.js.map}

@@ -1 +1 @@
-{"version":3,"file":"connection-B_K2ZAf7.js","names":["value: unknown","adapter: Adapter","name: string","config: AdapterConfig & { adapter: string }","registry?: AdapterRegistry"],"sources":["../src/connection/adapters/dialects/index.ts","../src/connection/adapters/AdapterRegistry.ts","../src/connection/adapters/index.ts","../src/connection/clients/dialects/index.ts","../src/connection/clients/index.ts","../src/connection/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { PostgresAdapter } from './PostgresAdapter';\nexport { SqliteAdapter } from './SqliteAdapter';\n","import type { Adapter, AdapterConfig } from './Adapter';\nimport type { DBClient } from '../clients/DBClient';\n\n/**\n * Runtime registry for database adapters.\n *\n * Use a custom instance when tests or applications need explicit control\n * over supported adapters; use `getDefaultRegistry()` for the built-in set.\n */\nexport class AdapterRegistry {\n    static readonly BRAND = 'tango.orm.adapter_registry' as const;\n    private static defaultRegistryInstance: AdapterRegistry | undefined;\n    readonly __tangoBrand: typeof AdapterRegistry.BRAND = AdapterRegistry.BRAND;\n    private adapters = new Map<string, Adapter>();\n\n    /**\n     * Narrow an unknown value to `AdapterRegistry`.\n     */\n    static isAdapterRegistry(value: unknown): value is AdapterRegistry {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === AdapterRegistry.BRAND\n        );\n    }\n\n    /**\n     * Return a lazily-initialized registry preloaded with built-in adapters.\n     */\n    static async getDefaultRegistry(): Promise<AdapterRegistry> {\n        if (AdapterRegistry.defaultRegistryInstance) {\n            return AdapterRegistry.defaultRegistryInstance;\n        }\n\n        AdapterRegistry.defaultRegistryInstance = new AdapterRegistry();\n\n        const { PostgresAdapter } = await import('./dialects/PostgresAdapter');\n        const { SqliteAdapter } = await import('./dialects/SqliteAdapter');\n\n        AdapterRegistry.defaultRegistryInstance.register(new PostgresAdapter());\n        AdapterRegistry.defaultRegistryInstance.register(new SqliteAdapter());\n\n        return AdapterRegistry.defaultRegistryInstance;\n    }\n\n    /**\n     * Register an adapter under its declared `name`.\n     */\n    register(adapter: Adapter): this {\n        this.adapters.set(adapter.name, adapter);\n        return this;\n    }\n\n    /**\n     * Resolve an adapter by name, or throw a descriptive error.\n     */\n    get(name: string): Adapter {\n        const adapter = this.adapters.get(name);\n        if (!adapter) {\n            const available = [...this.adapters.keys()].join(', ');\n            throw new Error(`Unknown adapter: ${name}. Available adapters: ${available || 'none'}`);\n        }\n        return adapter;\n    }\n\n    /**\n     * Check whether an adapter has been registered.\n     */\n    has(name: string): boolean {\n        return this.adapters.has(name);\n    }\n}\n\n/**\n * Connect to a database by adapter name using the provided (or default) registry.\n */\nexport async function connectDB(\n    config: AdapterConfig & { adapter: string },\n    registry?: AdapterRegistry\n): Promise<DBClient> {\n    const effectiveRegistry = registry ?? (await AdapterRegistry.getDefaultRegistry());\n    const adapter = effectiveRegistry.get(config.adapter);\n    return adapter.connect(config);\n}\n\n/**\n * Convenience helper that exposes the singleton default adapter registry.\n */\nexport async function getDefaultAdapterRegistry(): Promise<AdapterRegistry> {\n    return AdapterRegistry.getDefaultRegistry();\n}\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as dialects from './dialects/index';\n\nexport { AdapterRegistry, connectDB, getDefaultAdapterRegistry } from './AdapterRegistry';\nexport type { Adapter, AdapterConfig } from './Adapter';\nexport { PostgresAdapter, SqliteAdapter } from './dialects/index';\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { PostgresClient } from './PostgresClient';\nexport { SqliteClient } from './SqliteClient';\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as dialects from './dialects/index';\n\nexport type { DBClient } from './DBClient';\nexport { PostgresClient, SqliteClient } from './dialects/index';\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as adapters from './adapters/index';\nexport * as clients from './clients/index';\n\nexport { AdapterRegistry, connectDB, getDefaultAdapterRegistry } from './adapters/index';\nexport type { Adapter, AdapterConfig } from './adapters/index';\nexport type { DBClient } from './clients/DBClient';\nexport { PostgresAdapter, SqliteAdapter } from './adapters/index';\nexport { PostgresClient, SqliteClient } from './clients/index';\n"],"mappings":";;;;;;;;;;;;;;;ICSa,kBAAN,MAAM,gBAAgB;CACzB,OAAgB,QAAQ;CACxB,OAAe;CACf,eAAsD,gBAAgB;CACtE,WAAmB,IAAI;;;;CAKvB,OAAO,kBAAkBA,OAA0C;AAC/D,gBACW,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB,gBAAgB;CAE9E;;;;CAKD,aAAa,qBAA+C;AACxD,MAAI,gBAAgB,wBAChB,QAAO,gBAAgB;AAG3B,kBAAgB,0BAA0B,IAAI;EAE9C,MAAM,EAAE,oCAAiB,GAAG,MAAM,OAAO;EACzC,MAAM,EAAE,gCAAe,GAAG,MAAM,OAAO;AAEvC,kBAAgB,wBAAwB,SAAS,IAAI,oBAAkB;AACvE,kBAAgB,wBAAwB,SAAS,IAAI,kBAAgB;AAErE,SAAO,gBAAgB;CAC1B;;;;CAKD,SAASC,SAAwB;AAC7B,OAAK,SAAS,IAAI,QAAQ,MAAM,QAAQ;AACxC,SAAO;CACV;;;;CAKD,IAAIC,MAAuB;EACvB,MAAM,UAAU,KAAK,SAAS,IAAI,KAAK;AACvC,OAAK,SAAS;GACV,MAAM,YAAY,CAAC,GAAG,KAAK,SAAS,MAAM,AAAC,EAAC,KAAK,KAAK;AACtD,SAAM,IAAI,OAAO,mBAAmB,KAAK,wBAAwB,aAAa,OAAO;EACxF;AACD,SAAO;CACV;;;;CAKD,IAAIA,MAAuB;AACvB,SAAO,KAAK,SAAS,IAAI,KAAK;CACjC;AACJ;AAKM,eAAe,UAClBC,QACAC,UACiB;CACjB,MAAM,oBAAoB,YAAa,MAAM,gBAAgB,oBAAoB;CACjF,MAAM,UAAU,kBAAkB,IAAI,OAAO,QAAQ;AACrD,QAAO,QAAQ,QAAQ,OAAO;AACjC;AAKM,eAAe,4BAAsD;AACxE,QAAO,gBAAgB,oBAAoB;AAC9C"}
+{"version":3,"file":"connection-Dmhgx31M.js","names":["value: unknown","adapter: Adapter","name: string","config: AdapterConfig & { adapter: string }","registry?: AdapterRegistry"],"sources":["../src/connection/adapters/dialects/index.ts","../src/connection/adapters/AdapterRegistry.ts","../src/connection/adapters/index.ts","../src/connection/clients/dialects/index.ts","../src/connection/clients/index.ts","../src/connection/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { PostgresAdapter } from './PostgresAdapter';\nexport { SqliteAdapter } from './SqliteAdapter';\n","import type { Adapter, AdapterConfig } from './Adapter';\nimport type { DBClient } from '../clients/DBClient';\n\n/**\n * Runtime registry for database adapters.\n *\n * Use a custom instance when tests or applications need explicit control\n * over supported adapters; use `getDefaultRegistry()` for the built-in set.\n */\nexport class AdapterRegistry {\n    static readonly BRAND = 'tango.orm.adapter_registry' as const;\n    private static defaultRegistryInstance: AdapterRegistry | undefined;\n    readonly __tangoBrand: typeof AdapterRegistry.BRAND = AdapterRegistry.BRAND;\n    private adapters = new Map<string, Adapter>();\n\n    /**\n     * Narrow an unknown value to `AdapterRegistry`.\n     */\n    static isAdapterRegistry(value: unknown): value is AdapterRegistry {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === AdapterRegistry.BRAND\n        );\n    }\n\n    /**\n     * Return a lazily-initialized registry preloaded with built-in adapters.\n     */\n    static async getDefaultRegistry(): Promise<AdapterRegistry> {\n        if (AdapterRegistry.defaultRegistryInstance) {\n            return AdapterRegistry.defaultRegistryInstance;\n        }\n\n        AdapterRegistry.defaultRegistryInstance = new AdapterRegistry();\n\n        const { PostgresAdapter } = await import('./dialects/PostgresAdapter');\n        const { SqliteAdapter } = await import('./dialects/SqliteAdapter');\n\n        AdapterRegistry.defaultRegistryInstance.register(new PostgresAdapter());\n        AdapterRegistry.defaultRegistryInstance.register(new SqliteAdapter());\n\n        return AdapterRegistry.defaultRegistryInstance;\n    }\n\n    /**\n     * Register an adapter under its declared `name`.\n     */\n    register(adapter: Adapter): this {\n        this.adapters.set(adapter.name, adapter);\n        return this;\n    }\n\n    /**\n     * Resolve an adapter by name, or throw a descriptive error.\n     */\n    get(name: string): Adapter {\n        const adapter = this.adapters.get(name);\n        if (!adapter) {\n            const available = [...this.adapters.keys()].join(', ');\n            throw new Error(`Unknown adapter: ${name}. Available adapters: ${available || 'none'}`);\n        }\n        return adapter;\n    }\n\n    /**\n     * Check whether an adapter has been registered.\n     */\n    has(name: string): boolean {\n        return this.adapters.has(name);\n    }\n}\n\n/**\n * Connect to a database by adapter name using the provided (or default) registry.\n */\nexport async function connectDB(\n    config: AdapterConfig & { adapter: string },\n    registry?: AdapterRegistry\n): Promise<DBClient> {\n    const effectiveRegistry = registry ?? (await AdapterRegistry.getDefaultRegistry());\n    const adapter = effectiveRegistry.get(config.adapter);\n    return adapter.connect(config);\n}\n\n/**\n * Convenience helper that exposes the singleton default adapter registry.\n */\nexport async function getDefaultAdapterRegistry(): Promise<AdapterRegistry> {\n    return AdapterRegistry.getDefaultRegistry();\n}\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as dialects from './dialects/index';\n\nexport { AdapterRegistry, connectDB, getDefaultAdapterRegistry } from './AdapterRegistry';\nexport type { Adapter, AdapterConfig, SqlPlaceholders } from './Adapter';\nexport { PostgresAdapter, SqliteAdapter } from './dialects/index';\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { PostgresClient } from './PostgresClient';\nexport { SqliteClient } from './SqliteClient';\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as dialects from './dialects/index';\n\nexport type { DBClient } from './DBClient';\nexport { PostgresClient, SqliteClient } from './dialects/index';\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as adapters from './adapters/index';\nexport * as clients from './clients/index';\n\nexport { AdapterRegistry, connectDB, getDefaultAdapterRegistry } from './adapters/index';\nexport type { Adapter, AdapterConfig, SqlPlaceholders } from './adapters/index';\nexport type { DBClient } from './clients/DBClient';\nexport { PostgresAdapter, SqliteAdapter } from './adapters/index';\nexport { PostgresClient, SqliteClient } from './clients/index';\n"],"mappings":";;;;;;;;;;;;;ICSa,kBAAN,MAAM,gBAAgB;CACzB,OAAgB,QAAQ;CACxB,OAAe;CACf,eAAsD,gBAAgB;CACtE,WAAmB,IAAI;;;;CAKvB,OAAO,kBAAkBA,OAA0C;AAC/D,gBACW,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB,gBAAgB;CAE9E;;;;CAKD,aAAa,qBAA+C;AACxD,MAAI,gBAAgB,wBAChB,QAAO,gBAAgB;AAG3B,kBAAgB,0BAA0B,IAAI;EAE9C,MAAM,EAAE,oCAAiB,GAAG,MAAM,OAAO;EACzC,MAAM,EAAE,gCAAe,GAAG,MAAM,OAAO;AAEvC,kBAAgB,wBAAwB,SAAS,IAAI,oBAAkB;AACvE,kBAAgB,wBAAwB,SAAS,IAAI,kBAAgB;AAErE,SAAO,gBAAgB;CAC1B;;;;CAKD,SAASC,SAAwB;AAC7B,OAAK,SAAS,IAAI,QAAQ,MAAM,QAAQ;AACxC,SAAO;CACV;;;;CAKD,IAAIC,MAAuB;EACvB,MAAM,UAAU,KAAK,SAAS,IAAI,KAAK;AACvC,OAAK,SAAS;GACV,MAAM,YAAY,CAAC,GAAG,KAAK,SAAS,MAAM,AAAC,EAAC,KAAK,KAAK;AACtD,SAAM,IAAI,OAAO,mBAAmB,KAAK,wBAAwB,aAAa,OAAO;EACxF;AACD,SAAO;CACV;;;;CAKD,IAAIA,MAAuB;AACvB,SAAO,KAAK,SAAS,IAAI,KAAK;CACjC;AACJ;AAKM,eAAe,UAClBC,QACAC,UACiB;CACjB,MAAM,oBAAoB,YAAa,MAAM,gBAAgB,oBAAoB;CACjF,MAAM,UAAU,kBAAkB,IAAI,OAAO,QAAQ;AACrD,QAAO,QAAQ,QAAQ,OAAO;AACjC;AAKM,eAAe,4BAAsD;AACxE,QAAO,gBAAgB,oBAAoB;AAC9C"}

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

@@ -1,5 +1,6 @@
-import { PostgresClient } from "./PostgresClient-BQJZfEOT.js";
-import { SqliteClient } from "./SqliteClient-CjOK9-ki.js";
+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 { createRequire } from "node:module";
 import { getLogger } from "@danceroutine/tango-core";
@@ -288,28 +289,39 @@ var SqliteDBClientProvider = class {
 	Database;
 	autocommitClient;
 	activeLeaseCount = 0;
+	exclusiveTail = Promise.resolve();
 	constructor(config = {}) {
 		this.Database = this.getDatabaseCtor();
 		this.filename = typeof config.filename === "string" && config.filename.length > 0 ? config.filename : ":memory:";
 		this.autocommitClient = this.openClient(this.filename);
 	}
 	async query(sql, params) {
-		return this.autocommitClient.query(sql, params);
+		return this.runExclusive(() => this.autocommitClient.query(sql, params));
 	}
 	async leaseTransactionClient() {
 		if (this.filename === ":memory:") throw new Error("transaction.atomic(...) requires a file-backed SQLite database. :memory: is unsupported.");
-		const client = this.openClient(this.filename);
-		this.activeLeaseCount += 1;
-		let released = false;
-		return {
-			client,
-			release: async () => {
-				if (released) return;
-				released = true;
-				this.activeLeaseCount -= 1;
-				await client.close();
-			}
-		};
+		const releaseExclusive = await this.acquireExclusive();
+		try {
+			const client = this.openClient(this.filename);
+			this.activeLeaseCount += 1;
+			let released = false;
+			return {
+				client,
+				release: async () => {
+					if (released) return;
+					released = true;
+					this.activeLeaseCount -= 1;
+					try {
+						await client.close();
+					} finally {
+						releaseExclusive();
+					}
+				}
+			};
+		} catch (error) {
+			releaseExclusive();
+			throw error;
+		}
 	}
 	async reset() {
 		if (this.activeLeaseCount > 0) throw new Error("Cannot reset Tango runtime while transaction leases are still active.");
@@ -322,6 +334,25 @@ var SqliteDBClientProvider = class {
 		db.pragma("busy_timeout = 5000");
 		return new SqliteClient(db);
 	}
+	async runExclusive(work) {
+		const release = await this.acquireExclusive();
+		try {
+			return await work();
+		} finally {
+			release();
+		}
+	}
+	async acquireExclusive() {
+		const previous = this.exclusiveTail;
+		let release = null;
+		this.exclusiveTail = new Promise((resolve) => {
+			release = resolve;
+		});
+		await previous;
+		return () => {
+			release?.();
+		};
+	}
 	getDatabaseCtor() {
 		const require = createRequire(import.meta.url);
 		const moduleValue = require("better-sqlite3");
@@ -350,6 +381,7 @@ var TangoRuntime = class TangoRuntime {
 	loadedConfig;
 	providerPromise = null;
 	runtimeClientPromise = null;
+	cachedAdapter = null;
 	constructor(loadLoadedConfig) {
 		this.loadedConfig = loadLoadedConfig();
 	}
@@ -372,6 +404,15 @@ var TangoRuntime = class TangoRuntime {
 		return this.loadedConfig.current.db.adapter;
 	}
 	/**
+	* Return the adapter backing the configured dialect. Manager-side
+	* compilers use this to obtain placeholder formatters and dialect
+	* capabilities without branching on the raw dialect string.
+	*/
+	getAdapter() {
+		if (!this.cachedAdapter) this.cachedAdapter = this.buildAdapterForDialect(this.getDialect());
+		return this.cachedAdapter;
+	}
+	/**
 	* Return the runtime-bound DB client facade used by manager-backed code.
 	*/
 	async getClient() {
@@ -405,6 +446,12 @@ var TangoRuntime = class TangoRuntime {
 		this.runtimeClientPromise = null;
 		await provider.reset();
 	}
+	buildAdapterForDialect(dialect) {
+		switch (dialect) {
+			case InternalDialect.POSTGRES: return new PostgresAdapter();
+			case InternalDialect.SQLITE: return new SqliteAdapter();
+		}
+	}
 	async getProvider() {
 		if (!this.providerPromise) {
 			const db = this.loadedConfig.current.db;
@@ -444,4 +491,4 @@ async function resetTangoRuntime() {
 
 //#endregion
 export { RuntimeBoundClient, TangoRuntime, TransactionEngine, getTangoRuntime, initializeTangoRuntime, resetTangoRuntime };
-//# sourceMappingURL=defaultRuntime-BPK9kWEW.js.map
+//# sourceMappingURL=defaultRuntime-DzqBQ9Hb.js.map