litedbmodel 2.1.0 → 2.2.0

package/dist/scp/makesql/pool-executor.js

@@ -1,12 +1,12 @@
 "use strict";
 /**
- * litedbmodel v2 SCP — pooled async `SqlExecutorAsync` factories for PG / MySQL (#40).
+ * litedbmodel v2 SCP — pooled async `SqlExecutor` factories for PG / MySQL (#40).
  *
  * The read-graph async execution model (`executeReadGraphAsync`) dispatches independent sibling
  * relations in bounded parallel via bc `runBehaviorAsync`. For that concurrency to become REAL
  * parallel DB I/O the driver seam must be an async CONNECTION POOL — each concurrent `exec` call
  * checks out a DISTINCT pooled connection. These factories adapt a `pg.Pool` / `mysql2` pool to the
- * {@link SqlExecutorAsync} seam.
+ * {@link SqlExecutor} seam.
  *
  * The read graph already renders the dialect placeholder form (`$N` for postgres, `?` for
  * MySQL/SQLite, via `renderPlaceholders`) and flattens params 1:1, so each executor is a THIN
@@ -20,10 +20,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mysqlDeboxPoolOptions = void 0;
 exports.configurePgDeboxTypeParsers = configurePgDeboxTypeParsers;
-exports.pgPoolExecutor = pgPoolExecutor;
-exports.pgDeboxExecutor = pgDeboxExecutor;
-exports.mysqlDeboxExecutor = mysqlDeboxExecutor;
-exports.mysqlPoolExecutor = mysqlPoolExecutor;
+exports.pgConnectionPool = pgConnectionPool;
+exports.mysqlConnectionPool = mysqlConnectionPool;
+exports.pgPoolFactory = pgPoolFactory;
+exports.mysqlPoolFactory = mysqlPoolFactory;
+// MySQL parses no RETURNING — the write→re-select derivation lives in ONE place for all five runtimes.
+const mysql_returning_1 = require("./mysql-returning");
 // ── TS read-path driver de-box config (issue #59) ─────────────────────────────
 // The read-path materializer (`materializeCell`) coerces each driver cell to the JS form its SQL
 // column type declares (BIGINT→bigint, DATE→string, …). For that to be LOSSLESS the driver must
@@ -36,13 +38,13 @@ exports.mysqlPoolExecutor = mysqlPoolExecutor;
 //   - MySQL: BIGINT arrives as a rounded JS number by default (LOSSY). The pool MUST be built with
 //     `mysqlDeboxPoolOptions` (`supportBigNumbers + bigNumberStrings` so BIGINT→string, and
 //     `dateStrings` so the date family→string). `mysqlDeboxPoolOptions` is those options.
-/** PG type OIDs for the date/time family + int8 (bigint). */
-const PG_OID = { INT8: 20, DATE: 1082, TIMESTAMP: 1114, TIMESTAMPTZ: 1184, TIME: 1083, TIMETZ: 1266 };
+/** PG type OIDs for the integer family + the date/time family. */
+const PG_OID = { INT2: 21, INT4: 23, INT8: 20, DATE: 1082, TIMESTAMP: 1114, TIMESTAMPTZ: 1184, TIME: 1083, TIMETZ: 1266 };
 /**
  * Register `pg` type parsers so the read-path de-box (issue #59) gets coercible values: the
  * DATE/TIMESTAMP/TIMESTAMPTZ/TIME family is returned as its NATIVE TEXTUAL string (NOT a JS Date),
- * honoring the `date→string` outType and carrying the TZ for timestamptz. int8 already arrives as a
- * string (pg default), so it needs no parser. Idempotent. Call ONCE, before building the pool, from
+ * honoring the `date→string` outType and carrying the TZ for timestamptz; and the int2/int4/int8 family
+ * as a BigInt, the TS plane's `int` value model. Idempotent. Call ONCE, before building the pool, from
  * the consumer that owns the `pg` module (`import { types } from 'pg'; configurePgDeboxTypeParsers(types)`).
  *
  * WHY the GLOBAL parser (a documented, deliberate exception): `pg`'s default DATE parser builds a JS
@@ -56,6 +58,16 @@ const PG_OID = { INT8: 20, DATE: 1082, TIMESTAMP: 1114, TIMESTAMPTZ: 1184, TIME:
  */
 function configurePgDeboxTypeParsers(types) {
     const asString = (v) => v; // identity: keep the driver's native textual form
+    // An INTEGER column must arrive in bc's `int` value model, which on the TS plane is a BigInt. `pg`'s
+    // defaults hand back a JS number for int2/int4 and a string for int8, and bc classifies a JS number as
+    // FLOAT — so a column declared `Int` failed its outType check with `expected int, got float` on every
+    // read. The OID says the column is an integer, so nothing is guessed from the value: a REAL column
+    // whose value happens to be integral still arrives as a float. sqlite gets the same guarantee from
+    // better-sqlite3's `safeIntegers`, MySQL from {@link mysqlDeboxPoolOptions}'s integer typeCast.
+    const asBigInt = (v) => BigInt(v);
+    types.setTypeParser(PG_OID.INT2, asBigInt);
+    types.setTypeParser(PG_OID.INT4, asBigInt);
+    types.setTypeParser(PG_OID.INT8, asBigInt);
     types.setTypeParser(PG_OID.DATE, asString);
     types.setTypeParser(PG_OID.TIMESTAMP, asString);
     types.setTypeParser(PG_OID.TIMESTAMPTZ, asString);
@@ -72,47 +84,175 @@ exports.mysqlDeboxPoolOptions = {
     supportBigNumbers: true,
     bigNumberStrings: true,
     dateStrings: true,
+    /**
+     * An INTEGER column must arrive in bc's `int` value model — a BigInt on the TS plane. `mysql2` hands
+     * back a JS number for TINY/SHORT/INT24/LONG (only BIGINT becomes a string, via `bigNumberStrings`),
+     * and bc classifies a JS number as FLOAT, so a column declared `Int` failed its outType check with
+     * `expected int, got float`. The FIELD TYPE decides, never the value: a DOUBLE/DECIMAL column whose
+     * value happens to be integral still arrives as a float. sqlite gets the same guarantee from
+     * better-sqlite3's `safeIntegers`, PostgreSQL from {@link configurePgDeboxTypeParsers}'s int OIDs.
+     */
+    typeCast(field, next) {
+        if (MYSQL_INT_TYPES.has(field.type)) {
+            const raw = field.string();
+            return raw === null ? null : BigInt(raw);
+        }
+        return next();
+    },
 };
 /**
- * Adapt a `pg.Pool` to the async executor seam. Each `exec` runs `pool.query`, which acquires a
- * pooled connection, runs the query, and releases it — so N concurrent siblings run on N pooled
- * connections in parallel. The graph renders `$N` placeholders for the `postgres` dialect, so the
- * `sql` is already in `pg`'s native form.
+ * `mysql2`'s field-type names for the INTEGER family. NEWDECIMAL / DOUBLE / FLOAT are deliberately
+ * absent — they are float columns, whatever their values look like.
+ */
+const MYSQL_INT_TYPES = new Set(['TINY', 'SHORT', 'INT24', 'LONG', 'LONGLONG']);
+/** Adapt a pg `PoolClient` to the {@link AsyncConnection} seam (one owned connection). */
+function pgConnection(client) {
+    return {
+        async execute(sql, params) {
+            const r = await client.query(sql, params);
+            return r.rows;
+        },
+        async run(sql, params) {
+            const r = await client.query(sql, params);
+            return { changes: r.rowCount ?? 0, lastInsertRowid: 0 };
+        },
+    };
+}
+/**
+ * Adapt a pg `Pool` to the {@link AsyncConnectionPool} contract — `acquire` checks out an owned
+ * `PoolClient`, `release` returns it (destroyed on a poisoned tx). Feed this to
+ * `withTransactionAsync` for per-execution connection ownership.
+ */
+function pgConnectionPool(pool) {
+    const handles = new WeakMap();
+    return {
+        async acquire() {
+            const client = await pool.connect();
+            const conn = pgConnection(client);
+            handles.set(conn, client);
+            return conn;
+        },
+        async release(conn, destroy) {
+            handles.get(conn)?.release(destroy === true);
+        },
+    };
+}
+/**
+ * Adapt a mysql2 pooled connection to the {@link AsyncConnection} seam (one owned connection).
  *
- * Recommend constructing the pool with `max` ≥ the plan's `concurrency` (default 16).
+ * `execute` also carries the **MySQL RETURNING emulation** ({@link buildMysqlReselect}): MySQL parses
+ * no `RETURNING`, so a write that declares one is run stripped and its written rows recovered by a
+ * SELECT on THIS connection (before the write for a DELETE, after it otherwise). Placing it on the
+ * connection — the mysql analogue of the rust/go/py/php driver wrappers — is what makes the mode-2
+ * plan executor and a generated (codegen) write return the SAME rows: both reach the DB here.
  */
-function pgPoolExecutor(pool) {
-    return async (sql, params) => {
-        const result = await pool.query(sql, params);
-        return result.rows;
+function mysqlConnection(conn) {
+    const rowsOf = (raw) => (Array.isArray(raw) ? raw : []);
+    return {
+        async execute(sql, params) {
+            const reselect = (0, mysql_returning_1.buildMysqlReselect)(sql);
+            if (reselect === null)
+                return rowsOf((await conn.query(sql, params))[0]);
+            const bound = params;
+            if (reselect.before) {
+                // DELETE…RETURNING: the pre-image IS the written row set — capture it, THEN delete.
+                const [pre] = await conn.query(reselect.selectSql, (0, mysql_returning_1.bindReselect)(reselect.binds, bound, 0, 0));
+                await conn.query(reselect.writeSql, bound);
+                return rowsOf(pre);
+            }
+            const [res] = await conn.query(reselect.writeSql, bound);
+            const h = res;
+            const [rows] = await conn.query(reselect.selectSql, (0, mysql_returning_1.bindReselect)(reselect.binds, bound, Number(h?.insertId ?? 0), Number(h?.affectedRows ?? 0)));
+            return rowsOf(rows);
+        },
+        async run(sql, params) {
+            const [res] = await conn.query(sql, params);
+            const h = res;
+            return { changes: h?.affectedRows ?? 0, lastInsertRowid: h?.insertId ?? 0 };
+        },
     };
 }
 /**
- * Build a PG pool + executor with the read-path de-box wired IN (issue #59): registers the pg date
- * type parsers (DATE/TIMESTAMP family → native textual string) globally, then builds the pool.
- * int8 already arrives as a string on pg. Returns `{ pool, exec }` — pass `exec` to
- * `executeBehaviorAsync`. This is the production async path's de-box-correct entry (no hand-spread
- * options).
+ * Adapt a mysql2/promise `Pool` to the {@link AsyncConnectionPool} contract — `acquire` checks out
+ * an owned connection, `release` returns it (or `destroy`s a poisoned one). Feed this to
+ * `withTransactionAsync` for per-execution connection ownership.
  */
-function pgDeboxExecutor(pg, config) {
-    configurePgDeboxTypeParsers(pg.types);
-    const pool = new pg.Pool(config);
-    return { pool, exec: pgPoolExecutor(pool) };
+function mysqlConnectionPool(pool) {
+    const handles = new WeakMap();
+    return {
+        async acquire() {
+            const raw = await pool.getConnection();
+            const conn = mysqlConnection(raw);
+            handles.set(conn, raw);
+            return conn;
+        },
+        async release(conn, destroy) {
+            const raw = handles.get(conn);
+            if (raw === undefined)
+                return;
+            if (destroy === true)
+                raw.destroy();
+            else
+                raw.release();
+        },
+    };
 }
 /**
- * Build a MySQL pool + executor with the read-path de-box wired IN (issue #59): the pool carries
- * {@link mysqlDeboxPoolOptions} (`supportBigNumbers + bigNumberStrings` so BIGINT → exact string,
- * `dateStrings` so the date family → string) — options that MUST be set at pool construction (a
- * rounded BIGINT cannot be un-rounded post-hoc). Returns `{ pool, exec }` for `executeBehaviorAsync`.
+ * A {@link PoolFactory} for `pg`: constructs a `new pg.Pool(...)` from a {@link ResolvedConnectionConfig},
+ * applying the pool SIZING (`max` = `maxPool`, `min` = `minPool`) and `keepAlive` /
+ * `keepAliveInitialDelayMillis` AT CONSTRUCTION — the config is the sole source of the cap. Connection
+ * params (host/port/database/user/password) also flow from the config. Registers the read-path de-box
+ * type parsers (issue #59, global, idempotent) once. Returns the owned-connection adapter + closer.
+ *
+ * `role` is accepted for the reader/writer replica split; the caller may vary host per role via the
+ * config it passes. `Pool` is the `pg.Pool` ctor (peer dep, passed in — this module imports no driver).
  */
-function mysqlDeboxExecutor(mysql2, config) {
-    const pool = mysql2.createPool({ ...config, ...exports.mysqlDeboxPoolOptions });
-    return { pool, exec: mysqlPoolExecutor(pool) };
+function pgPoolFactory(pg) {
+    return (config, _role) => {
+        configurePgDeboxTypeParsers(pg.types);
+        const pool = new pg.Pool({
+            ...(config.host !== undefined ? { host: config.host } : {}),
+            ...(config.port !== undefined ? { port: config.port } : {}),
+            ...(config.database !== undefined ? { database: config.database } : {}),
+            ...(config.user !== undefined ? { user: config.user } : {}),
+            ...(config.password !== undefined ? { password: config.password } : {}),
+            // SIZING (construction knob): the config is the sole source of the cap.
+            max: config.maxPool,
+            min: config.minPool,
+            // keepAlive (construction knob): TCP keepalive for serverless/long-idle connections.
+            keepAlive: config.keepAlive,
+            ...(config.keepAlive ? { keepAliveInitialDelayMillis: config.keepAliveInitialDelayMillis } : {}),
+        });
+        return { pool: pgConnectionPool(pool), close: () => pool.end() };
+    };
 }
-function mysqlPoolExecutor(pool) {
-    return async (sql, params) => {
-        const [rows] = await pool.query(sql, params);
-        return rows;
+/**
+ * A {@link PoolFactory} for `mysql2/promise`: constructs a `mysql2.createPool(...)` from a
+ * {@link ResolvedConnectionConfig}, applying the pool SIZING (`connectionLimit` = `maxPool`) +
+ * `enableKeepAlive` / `keepAliveInitialDelay` AT CONSTRUCTION (the config is the sole source of the
+ * cap) plus the read-path de-box options ({@link mysqlDeboxPoolOptions}). Connection params flow from
+ * the config. Returns the owned-connection adapter + closer.
+ *
+ * NB: mysql2 has no `min` idle floor — `minPool` is a no-op there (a documented per-driver deviation;
+ * the SIZING CAP that matters — `maxPool` → `connectionLimit` — is honored). `createPool` is the
+ * `mysql2/promise` factory (peer dep, passed in).
+ */
+function mysqlPoolFactory(mysql2) {
+    return (config, _role) => {
+        const pool = mysql2.createPool({
+            ...(config.host !== undefined ? { host: config.host } : {}),
+            ...(config.port !== undefined ? { port: config.port } : {}),
+            ...(config.database !== undefined ? { database: config.database } : {}),
+            ...(config.user !== undefined ? { user: config.user } : {}),
+            ...(config.password !== undefined ? { password: config.password } : {}),
+            // SIZING (construction knob): connectionLimit = maxPool (the sole source of the cap).
+            connectionLimit: config.maxPool,
+            // keepAlive (construction knob).
+            enableKeepAlive: config.keepAlive,
+            ...(config.keepAlive ? { keepAliveInitialDelay: config.keepAliveInitialDelayMillis } : {}),
+            ...exports.mysqlDeboxPoolOptions,
+        });
+        return { pool: mysqlConnectionPool(pool), close: () => pool.end() };
     };
 }
 //# sourceMappingURL=pool-executor.js.map

package/dist/scp/makesql/pool-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool-executor.js","sourceRoot":"","sources":["../../../src/scp/makesql/pool-executor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAyCH,kEAOC;AAgCD,wCAKC;AAkCD,0CAIC;AAQD,gDAGC;AAED,8CAKC;AAzID,iFAAiF;AACjF,iGAAiG;AACjG,gGAAgG;AAChG,2CAA2C;AAC3C,+FAA+F;AAC/F,iGAAiG;AACjG,6FAA6F;AAC7F,iGAAiG;AACjG,8EAA8E;AAC9E,mGAAmG;AACnG,4FAA4F;AAC5F,0FAA0F;AAE1F,6DAA6D;AAC7D,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAW,CAAC;AAO/G;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,2BAA2B,CAAC,KAAkB;IAC5D,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,kDAAkD;IAC7F,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChD,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACU,QAAA,qBAAqB,GAAG;IACnC,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,WAAW,EAAE,IAAI;CACT,CAAC;AAYX;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,IAAgB;IAC7C,OAAO,KAAK,EAAE,GAAW,EAAE,MAAiB,EAAsC,EAAE;QAClF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AA2BD;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,EAAgB,EAAE,MAA+B;IAC/E,2BAA2B,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,MAAwB,EAAE,MAA+B;IAC1F,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,6BAAqB,EAAE,CAAC,CAAC;IACxE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAmB;IACnD,OAAO,KAAK,EAAE,GAAW,EAAE,MAAiB,EAAsC,EAAE;QAClF,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"pool-executor.js","sourceRoot":"","sources":["../../../src/scp/makesql/pool-executor.ts"],"names":[],"mappings":"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"}

package/dist/scp/makesql/tx.d.ts

@@ -31,8 +31,11 @@
  * Underivable shapes (cycle, dangling `$.ref`, referenced write without RETURNING, duplicate
  * bind, composite `$.entity`) are LOUD rejects — never a silently mis-ordered plan.
  */
-import { type Scope } from 'behavior-contracts';
+import { type Scope } from 'behavior-contracts/runtime';
+import { type ColumnTypeResolver } from '../coltype';
 import { type Dialect as MakeSQLDialect } from './handler';
+import { type ExecutionContext, type PooledAsyncContext, type SqliteDriver } from '../exec-context';
+import { type TransactionOptions } from '../tx-options';
 import { type LifecycleContract, type LifecycleEffects, type WriteLifecyclePhase } from '../writes';
 /** A closed-set bc Expression IR node used as a `makeSQL` deferred param (ref / literal / obj). */
 export type TxExpr = unknown;
@@ -79,6 +82,29 @@ export interface TxOp {
         readonly columns: readonly string[];
         readonly autoInc: string | null;
     };
+    /**
+     * NATIVE-CODEGEN typing metadata (E5/#120 — the RETURNING-chained tx chain). Additive: the runtime
+     * tx ({@link executeTransaction}) IGNORES it; the bc native-codegen chain lowering
+     * (bc's rust/go typed-native emitter) reads it to type each statement's
+     * native param ports + its produced-row struct WITHOUT re-parsing the rendered SQL. The SHARED
+     * {@link compileWriteNode} emits it from the structured ports it already has (one compiler feeds both
+     * the runtime and the codegen chain). Present on a single-statement Insert/Update/Delete op; absent
+     * on a batch op (its `?` binds a `{__batchRows}` marker, not a column). `bindColumns[i]` is the table
+     * column the i-th `?` binds (parallel to `params`; `null` when the param is not a plain column value).
+     */
+    readonly writeMeta?: {
+        readonly table: string;
+        readonly bindColumns: readonly (string | null)[];
+        readonly returning: readonly string[];
+        /** The upsert conflict-target column list (`onConflict` port), when this write is an upsert — lets a
+         * downstream mysql RETURNING re-select recover the upserted row by its conflict key. Absent otherwise. */
+        readonly onConflict?: string;
+        /** True for a batch op (createMany/updateMany/upsertMany — its `?` binds a `{__batchRows}` marker,
+         * not per-column values). The native tx-chain lowering rejects a batch op (it types per-column); the
+         * flag lets it detect batch even though the op now carries `pk`/`onConflict` for the mysql RETURNING
+         * re-select (which the batch write, like the single write, must honor). */
+        readonly batch?: boolean;
+    };
 }
 /** The role a transaction statement plays (drives the runtime's gate-first interpretation). */
 export type StatementRole = 'gate:requires' | 'gate:idempotency' | 'gate:unique' | 'body' | 'derive' | 'edge' | 'emit';
@@ -117,22 +143,34 @@ interface WriteNodeLike {
     readonly ports: Record<string, unknown>;
 }
 /**
- * Serialize a {@link TxOp.pk} descriptor into a strip-before-execute SQL comment appended to an
- * INSERT…RETURNING op, so the MySQL driver emulation can re-select by the REAL primary key. The
- * comment is STRIPPED (with the RETURNING clause) before the INSERT executes, so the executed SQL
- * stays byte-clean; it is emitted ONLY into the mysql-dialect bundle (PG/SQLite keep native
- * RETURNING and never see it). Format: ` /*scp:pk=col1,col2;ai=<autoIncCol|>* /`.
+ * A per-column raw VALUE SPECIMEN whose {@link import('../../drivers/PostgresSqlBuilder').inferPgType}
+ * matches the column's SCHEMA SQL type, so the PG batch UNNEST cast (`?::<pgType>[]`) the original
+ * `buildInsert`/`buildUpdateMany` emits is derived from the schema SoT — NOT from the runtime values
+ * the symbolic codegen path never sees. int32→number / int64→bigint / bool→boolean / date→Date /
+ * float→non-integer number / string(+decimal/uuid/json)→string, reproducing each `inferPgType` branch.
+ * Ambiguous only for a REAL column whose live value is integer-valued (v1 would infer `int`, not
+ * `numeric`); the bench columns (text/int/bigint) are unambiguous. Unknown SQL types are a hard error
+ * (fail-closed) via the §4.1 classifiers.
  */
-export declare function mysqlPkHint(op: TxOp): TxOp;
-/** Strip a trailing MySQL PK-hint comment from a rendered SQL (defensive; runtimes strip too). */
-export declare function stripMysqlPkHint(sql: string): string;
+export declare function pgTypeSpecimen(sqlType: string): unknown;
+/**
+ * Read the optional PRIMARY KEY descriptor ports of an Insert node (for the MySQL RETURNING
+ * emulation). `pk` is a comma-separated column list (`'doc_id'` / `'order_id,line_no'`); `autoInc`
+ * names the single AUTO_INCREMENT column, or is absent for a client-supplied PK. Absent `pk`
+ * defaults to null (the emulation then keeps its legacy `WHERE id`/`LAST_INSERT_ID` path, so the
+ * existing auto-increment-`id` corpus is unchanged).
+ */
+export declare function pkPort(ports: Record<string, unknown>): {
+    columns: readonly string[];
+    autoInc: string | null;
+} | undefined;
 /**
  * Compile ONE authored catalog write node (`Insert`/`Update`/`Delete`) into a makeSQL {@link TxOp}
  * — complete tuned SQL text + DEFERRED Expression-IR params. This is the makeSQL re-expression of
  * the reduced bridge's `compileNode` for the write path (the tx-DAG base writes). INSERT columns
  * are CANONICAL (alphabetical) sorted — the v2 write-path SSoT (matches `DBModel._insert`).
  */
-export declare function compileWriteNode(node: WriteNodeLike, dialect?: MakeSQLDialect): TxOp;
+export declare function compileWriteNode(node: WriteNodeLike, dialect?: MakeSQLDialect, resolveColumnType?: ColumnTypeResolver): TxOp;
 /** The base write op the Command declares (`Insert`/`Update`/`Delete` with `onWrite`). */
 export interface BaseWrite {
     /** The compiled base write makeSQL op (complete `sql` + deferred Expression-IR `params`). */
@@ -167,16 +205,15 @@ export declare function deriveBatchPlan(phase: WriteLifecyclePhase, ops: readonl
     params: readonly unknown[];
     label?: string;
 }[]): TransactionPlan;
-/** The minimal synchronous SQLite driver surface the tx runtime needs (better-sqlite3). */
-export interface SqliteDb {
-    prepare(sql: string): {
-        all(...params: unknown[]): unknown[];
-        run(...params: unknown[]): {
-            changes: number;
-            lastInsertRowid: number | bigint;
-        };
-    };
-}
+/**
+ * The minimal synchronous SQLite driver surface the tx runtime needs (better-sqlite3) — the
+ * backward-compat public seam. Internally the tx runs through the {@link ExecutionContext} seam
+ * (`../exec-context`); a raw driver passed here is wrapped via {@link contextForDriver}. Aliased to
+ * {@link SqliteDriver}.
+ */
+export type SqliteDb = SqliteDriver;
+/** A tx entry accepts either a raw {@link SqliteDb} or a full {@link ExecutionContext}. */
+export type DbOrContext = SqliteDb | ExecutionContext;
 /** Why a transaction did not commit (a gate short-circuit outcome; not a driver error). */
 export type ShortCircuitReason = 'requires_absent' | 'unique_collision' | 'idempotent_duplicate';
 /** The structured outcome of executing a {@link TransactionPlan}. */
@@ -197,8 +234,16 @@ export interface TransactionResult {
      */
     readonly returnedRows?: readonly (readonly Record<string, unknown>[])[];
 }
-/** Execute a derived {@link TransactionPlan} as ONE real SQLite transaction with gate-first. */
-export declare function executeTransaction(db: SqliteDb, plan: TransactionPlan, input: Scope, dialect?: MakeSQLDialect): TransactionResult;
+/**
+ * Execute a derived {@link TransactionPlan} as ONE real SQLite transaction with gate-first
+ * short-circuit. Accepts a raw {@link SqliteDb} (wrapped via {@link contextForDriver}) or a full
+ * {@link ExecutionContext}. The transaction derives a tx-scoped ctx (`withConnection(conn, true)`)
+ * that PINS one connection so BEGIN, every body statement, and COMMIT/ROLLBACK all run on the SAME
+ * connection (§3, per-execution ownership). For the single-DB SQLite driver the pinned connection
+ * is the sole connection; the ownership shows its teeth on the pooled async path
+ * ({@link import('../exec-context').withTransactionAsync}), which this mirrors.
+ */
+export declare function executeTransaction(db: DbOrContext, plan: TransactionPlan, input: Scope, dialect?: MakeSQLDialect): TransactionResult;
 /**
  * A counting {@link SqliteDb} wrapper: forwards every call to the wrapped driver but records
  * each PREPARED SQL string. Tests use it to PROVE gate-first short-circuit.
@@ -212,5 +257,45 @@ export declare function renderTxStatement(op: TxOp, scope: Scope, dialect?: Make
     sql: string;
     params: unknown[];
 };
+/**
+ * Options for the live async write entry {@link executeTransactionAsync} — the tx {@link
+ * TransactionOptions} plus the write=tx `guard` policy (#86).
+ */
+export interface WriteExecOptions extends TransactionOptions {
+    /**
+     * Enforce the write=tx guard (#86 / #81 `checkWriteAllowed`): a write issued OUTSIDE a user
+     * `transaction(fn)` throws {@link WriteOutsideTransactionError}; a write in a {@link
+     * import('../tx-options').withReadOnly} scope throws {@link WriteInReadOnlyContextError}. This is
+     * the DEFAULT for the public write path — writes require an explicit transaction (v1 parity,
+     * `DBModel.ts:886`). Set `false` ONLY for the internal per-execution-ownership plane (the Phase A
+     * ownership proofs that drive the plan executor as its OWN auto-tx). @default true
+     */
+    readonly guard?: boolean;
+}
+/**
+ * Execute a derived {@link TransactionPlan} on a live PG / MySQL connection with gate-first
+ * short-circuit and **per-execution connection ownership** (§3). The live-DB WRITE entry (#86).
+ *
+ * ## Ambient-tx JOIN vs. its own envelope (the #86 core)
+ *
+ * `withTransactionAsync` (:495) decides the envelope:
+ *   - **inside a user `transaction(fn)`** (an outer connection is pinned in the ALS) → the write
+ *     JOINS the outer: its statements run on the outer's owned connection with NO new BEGIN/COMMIT,
+ *     so N writes in one boundary are ONE physical transaction (one BEGIN, one COMMIT, one conn);
+ *   - **outside any transaction** → it opens its OWN BEGIN…COMMIT on a freshly-acquired owned
+ *     connection (the per-execution auto-tx; concurrent calls each own a DISTINCT connection ⇒
+ *     isolated).
+ *
+ * ## write=tx guard (#86, wired here — fires at runtime, not a standalone helper)
+ *
+ * With `options.guard` (DEFAULT true), a write with NO ambient user tx is REJECTED via {@link
+ * checkWriteAllowed} BEFORE any SQL: `WriteOutsideTransactionError` (no active tx) /
+ * `WriteInReadOnlyContextError` (read-only scope). The check runs at ENTRY — before
+ * `withTransactionAsync` would open the write's own envelope — so it sees the CALLER's scope, exactly
+ * mirroring v1 `DBModel._checkWriteAllowed` (:886, called at the public write entry, not the plan
+ * executor). Inside a `transaction(fn)` the ambient marker is set ⇒ the guard passes and the write
+ * joins. The structured {@link TransactionResult} is identical to the sync {@link executeTransaction}.
+ */
+export declare function executeTransactionAsync(ctx: PooledAsyncContext, plan: TransactionPlan, input: Scope, dialect?: MakeSQLDialect, options?: WriteExecOptions): Promise<TransactionResult>;
 export {};
 //# sourceMappingURL=tx.d.ts.map

package/dist/scp/makesql/tx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tx.d.ts","sourceRoot":"","sources":["../../../src/scp/makesql/tx.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tx.d.ts","sourceRoot":"","sources":["../../../src/scp/makesql/tx.ts"],"names":[],"mappings":"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"}