litedbmodel 2.1.0 → 2.2.0

package/dist/index.d.cts

@@ -0,0 +1 @@
+export * from './index.js';

package/dist/scp/coltype.d.ts

@@ -10,6 +10,20 @@
  */
 /** bc typed outType のスカラ型（bc 0.3.0 の portable notation と一致；date 型は無い）。 */
 export type BcScalar = 'string' | 'int' | 'float' | 'bool' | 'null';
+/**
+ * SQL 型トークンを基底型名へ正規化する SSoT（`sqlTypeToBcScalar` / `sqlTypeToMaterializeClass` が共有）。
+ * 括弧のサイズ/精度と、型判定に無関係な列修飾（`UNSIGNED`/`ZEROFILL`/`PRECISION` と NULL 可否
+ * `NOT NULL`/`NULL`）を落として基底型名だけを残す。NULL 可否は {@link sqlTypeIsNotNull} が別に読む
+ * （型スカラと直交する — nullability は outType の `opt` ラップの有無、基底スカラではない）。
+ */
+export declare function normalizeSqlTypeToken(sqlType: string): string;
+/**
+ * 宣言された SQL 型が `NOT NULL` 制約を持つか（`static columns` は列制約を型トークンに書ける）。
+ * `true` の列は読み出しセルが非 null 確定 → 読み outType は `opt` ラップ無しの生スカラ（RETURNING の
+ * 主キーのような非 null 値を value 位置で消費できる — spec §4.1 の nullability）。既定（無指定）は
+ * nullable（ドライバ列は NULL を返し得る）。
+ */
+export declare function sqlTypeIsNotNull(sqlType: string): boolean;
 /**
  * SQL 型（DDL のトークン。`DECIMAL(10,2)` 等の括弧やサイズは無視）→ bc outType スカラ。
  * spec §4.1 の正規表に一致。未知/曖昧は throw（fail-closed）。
@@ -48,7 +62,18 @@ export type MaterializeClass = 'int32' | 'int64' | 'date' | 'bool' | 'passthroug
  * `int` scalar splits int32/int64 by width; `date`/`bool` get their own class; everything else is
  * `passthrough`.
  */
+export declare function arrayElementType(sqlType: string): string | null;
 export declare function sqlTypeToMaterializeClass(sqlType: string): MaterializeClass;
+/**
+ * The bc scalar of a de-boxed READ KEY value — the element type a relation key-array (`pluck` → `.as`)
+ * carries when it is bound to `= ANY($1)` / `json_each(?)` (#141, spec §4.1). A key array is an opaque
+ * transport value list, so its bc element tag is the JS type of the READ-materialized key cell, NOT the
+ * column's `sqlTypeToBcScalar` outType: an `int32` column materializes to a JS `number` (bc `float`),
+ * a `BIGINT`/`int64` to a decimal STRING (bc `string`), a `date` to a string, a `bool` to a boolean.
+ * Derived by composing {@link sqlTypeToMaterializeClass} (the read de-box class) with the base scalar,
+ * so it stays the SINGLE type-system SoT — no hand-rolled type table at the relation call site.
+ */
+export declare function keyArrayElemScalar(sqlType: string): BcScalar;
 /**
  * Coerce ONE raw driver cell to the JS form its {@link MaterializeClass} declares (issue #59 TS
  * read-path de-box). NULL passes through (nullable columns). This is driver-agnostic: it accepts
@@ -100,7 +125,7 @@ export declare function failClosedMaterializeResolverFromColumnMap(columnTypes:
  * `outType` SoT). THROWS for an unknown `table`/`column` (no-assume, no-fallback — a typed-native
  * read must not silently box an untyped column). Built from the model's INLINE `columns` declaration
  * at registration, it replaces the external `schemaColumnTypeResolver(ddl)` as the codegen type
- * source, so `deriveReadOutTypes` reads the declared types.
+ * source, so `deriveReadRow` (the read de-box SSoT) reads the declared types.
  */
 export declare function columnTypeResolverFromColumnMap(columnTypes: ReadonlyMap<string, ReadonlyMap<string, string>>): ColumnTypeResolver;
 /** {@link sqlTypeToMaterializeClass} but TOLERANT: returns `undefined` for an unknown SQL type. */

package/dist/scp/coltype.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coltype.d.ts","sourceRoot":"","sources":["../../src/scp/coltype.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CA+D3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAyD3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAsDhF;AAaD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;AAElG;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC5D,mBAAmB,CAKrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,0CAA0C,CACxD,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC5D,mBAAmB,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC5D,kBAAkB,CAmBpB;AAED,mGAAmG;AACnG,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAMzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwB/F;AAyCD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CAqBnF"}
+{"version":3,"file":"coltype.d.ts","sourceRoot":"","sources":["../../src/scp/coltype.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAgE3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG/D;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAoE3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAa5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAsDhF;AAaD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;AAElG;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC5D,mBAAmB,CAKrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,0CAA0C,CACxD,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC5D,mBAAmB,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC5D,kBAAkB,CAmBpB;AAED,mGAAmG;AACnG,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAMzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwB/F;AAyCD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CAqBnF"}

package/dist/scp/coltype.js

@@ -10,8 +10,12 @@
  * 行/リレーションの構造型（`obj`/`arr`/`opt`）は列型ではなくクエリ由来なので本変換の対象外。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeSqlTypeToken = normalizeSqlTypeToken;
+exports.sqlTypeIsNotNull = sqlTypeIsNotNull;
 exports.sqlTypeToBcScalar = sqlTypeToBcScalar;
+exports.arrayElementType = arrayElementType;
 exports.sqlTypeToMaterializeClass = sqlTypeToMaterializeClass;
+exports.keyArrayElemScalar = keyArrayElemScalar;
 exports.materializeCell = materializeCell;
 exports.materializeResolverFromColumnMap = materializeResolverFromColumnMap;
 exports.failClosedMaterializeResolverFromColumnMap = failClosedMaterializeResolverFromColumnMap;
@@ -20,20 +24,39 @@ exports.materializeClassOrUndefined = materializeClassOrUndefined;
 exports.parseSchemaColumnTypes = parseSchemaColumnTypes;
 exports.schemaColumnTypeResolver = schemaColumnTypeResolver;
 /**
- * SQL 型（DDL のトークン。`DECIMAL(10,2)` 等の括弧やサイズは無視）→ bc outType スカラ。
- * spec §4.1 の正規表に一致。未知/曖昧は throw（fail-closed）。
+ * SQL 型トークンを基底型名へ正規化する SSoT（`sqlTypeToBcScalar` / `sqlTypeToMaterializeClass` が共有）。
+ * 括弧のサイズ/精度と、型判定に無関係な列修飾（`UNSIGNED`/`ZEROFILL`/`PRECISION` と NULL 可否
+ * `NOT NULL`/`NULL`）を落として基底型名だけを残す。NULL 可否は {@link sqlTypeIsNotNull} が別に読む
+ * （型スカラと直交する — nullability は outType の `opt` ラップの有無、基底スカラではない）。
  */
-function sqlTypeToBcScalar(sqlType) {
-    // 括弧のサイズ/精度・`UNSIGNED` 等の修飾を落として基底型名で判定。
-    const t = sqlType
+function normalizeSqlTypeToken(sqlType) {
+    return sqlType
         .trim()
         .toUpperCase()
         .replace(/\(.*\)/, '')
-        .replace(/\b(UNSIGNED|ZEROFILL|PRECISION)\b/g, '')
+        .replace(/\b(UNSIGNED|ZEROFILL|PRECISION|NOT\s+NULL|NULL)\b/g, '')
         .replace(/\s+/g, ' ')
         .trim();
+}
+/**
+ * 宣言された SQL 型が `NOT NULL` 制約を持つか（`static columns` は列制約を型トークンに書ける）。
+ * `true` の列は読み出しセルが非 null 確定 → 読み outType は `opt` ラップ無しの生スカラ（RETURNING の
+ * 主キーのような非 null 値を value 位置で消費できる — spec §4.1 の nullability）。既定（無指定）は
+ * nullable（ドライバ列は NULL を返し得る）。
+ */
+function sqlTypeIsNotNull(sqlType) {
+    return /\bNOT\s+NULL\b/i.test(sqlType);
+}
+/**
+ * SQL 型（DDL のトークン。`DECIMAL(10,2)` 等の括弧やサイズは無視）→ bc outType スカラ。
+ * spec §4.1 の正規表に一致。未知/曖昧は throw（fail-closed）。
+ */
+function sqlTypeToBcScalar(sqlType) {
+    const t = normalizeSqlTypeToken(sqlType);
     switch (t) {
         // int は既定 64bit(i64)。INTEGER も BIGINT も int（bigint を別型にしない — サイズ制限は列制約で表現）。
+        // PostgreSQL の SERIAL/SERIAL4/BIGSERIAL/SERIAL8/SMALLSERIAL/SERIAL2（auto-increment 疑似型）も
+        // 基底は整数（int4 / int8）で、read 型は plain integer。
         case 'INTEGER':
         case 'INT':
         case 'BIGINT':
@@ -43,6 +66,12 @@ function sqlTypeToBcScalar(sqlType) {
         case 'INT2':
         case 'INT4':
         case 'INT8':
+        case 'SERIAL':
+        case 'SERIAL4':
+        case 'BIGSERIAL':
+        case 'SERIAL8':
+        case 'SMALLSERIAL':
+        case 'SERIAL2':
             return 'int';
         // int と real は明確に分離。
         case 'REAL':
@@ -92,16 +121,25 @@ function sqlTypeToBcScalar(sqlType) {
  * `int` scalar splits int32/int64 by width; `date`/`bool` get their own class; everything else is
  * `passthrough`.
  */
+function arrayElementType(sqlType) {
+    const m = /^(.+?)\s*\[\s*\]$/.exec(normalizeSqlTypeToken(sqlType));
+    return m === null ? null : m[1].trim();
+}
 function sqlTypeToMaterializeClass(sqlType) {
-    const t = sqlType
-        .trim()
-        .toUpperCase()
-        .replace(/\(.*\)/, '')
-        .replace(/\b(UNSIGNED|ZEROFILL|PRECISION)\b/g, '')
-        .replace(/\s+/g, ' ')
-        .trim();
+    const t = normalizeSqlTypeToken(sqlType);
+    // An ARRAY column (`TEXT[]` / `INT[]` / `NUMERIC[]` / `BOOLEAN[]` / `TIMESTAMP[]` / …) de-boxes as
+    // `passthrough`: the driver's own array typeCast already parses the wire form into a JS array whose
+    // ELEMENTS match the declared element outType, so the read path leaves the value unchanged (no
+    // per-cell coercion — a scalar materialize class does not apply to a whole list). The element base
+    // type is still validated (an unknown element type on a DECLARED array column is a hard error too).
+    const element = arrayElementType(t);
+    if (element !== null) {
+        sqlTypeToMaterializeClass(element); // validate the element base type (throws if unknown)
+        return 'passthrough';
+    }
     switch (t) {
-        // 32-bit int family: JS number holds the full range exactly.
+        // 32-bit int family: JS number holds the full range exactly. The PostgreSQL SERIAL family maps to
+        // its underlying int width (SERIAL/SERIAL4=int4, SMALLSERIAL/SERIAL2=int2).
         case 'INTEGER':
         case 'INT':
         case 'SMALLINT':
@@ -109,10 +147,16 @@ function sqlTypeToMaterializeClass(sqlType) {
         case 'MEDIUMINT':
         case 'INT2':
         case 'INT4':
+        case 'SERIAL':
+        case 'SERIAL4':
+        case 'SMALLSERIAL':
+        case 'SERIAL2':
             return 'int32';
         // 64-bit int: needs JS bigint for exactness.
         case 'BIGINT':
         case 'INT8':
+        case 'BIGSERIAL':
+        case 'SERIAL8':
             return 'int64';
         case 'BOOLEAN':
         case 'BOOL':
@@ -148,6 +192,29 @@ function sqlTypeToMaterializeClass(sqlType) {
                 `are a hard error (no-assume, no-fallback), never defaulted.`);
     }
 }
+/**
+ * The bc scalar of a de-boxed READ KEY value — the element type a relation key-array (`pluck` → `.as`)
+ * carries when it is bound to `= ANY($1)` / `json_each(?)` (#141, spec §4.1). A key array is an opaque
+ * transport value list, so its bc element tag is the JS type of the READ-materialized key cell, NOT the
+ * column's `sqlTypeToBcScalar` outType: an `int32` column materializes to a JS `number` (bc `float`),
+ * a `BIGINT`/`int64` to a decimal STRING (bc `string`), a `date` to a string, a `bool` to a boolean.
+ * Derived by composing {@link sqlTypeToMaterializeClass} (the read de-box class) with the base scalar,
+ * so it stays the SINGLE type-system SoT — no hand-rolled type table at the relation call site.
+ */
+function keyArrayElemScalar(sqlType) {
+    switch (sqlTypeToMaterializeClass(sqlType)) {
+        case 'int32':
+            return 'float'; // materializes to a JS number → bc float
+        case 'int64':
+        case 'date':
+            return 'string'; // materializes to a decimal / TZ string → bc string
+        case 'bool':
+            return 'bool';
+        case 'passthrough':
+            // float stays a JS number (bc float); text / uuid / decimal-as-string / json are all bc string.
+            return sqlTypeToBcScalar(sqlType) === 'float' ? 'float' : 'string';
+    }
+}
 /**
  * Coerce ONE raw driver cell to the JS form its {@link MaterializeClass} declares (issue #59 TS
  * read-path de-box). NULL passes through (nullable columns). This is driver-agnostic: it accepts
@@ -272,7 +339,7 @@ function failClosedMaterializeResolverFromColumnMap(columnTypes) {
  * `outType` SoT). THROWS for an unknown `table`/`column` (no-assume, no-fallback — a typed-native
  * read must not silently box an untyped column). Built from the model's INLINE `columns` declaration
  * at registration, it replaces the external `schemaColumnTypeResolver(ddl)` as the codegen type
- * source, so `deriveReadOutTypes` reads the declared types.
+ * source, so `deriveReadRow` (the read de-box SSoT) reads the declared types.
  */
 function columnTypeResolverFromColumnMap(columnTypes) {
     return (table, column) => {

package/dist/scp/coltype.js.map

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

package/dist/scp/connection-routing.d.ts

@@ -0,0 +1,312 @@
+/**
+ * litedbmodel v2 SCP — the **connection routing + config contract** (Phase C / #87).
+ *
+ * This module is the **API REFERENCE** for Phase C — the 4 native ports (rust #88 / go #89 / py #90
+ * / php #91) mirror THIS contract exactly (config field names + defaults, the connection-registry
+ * shape, `withWriter` semantics, and the `connectionFor(intent)` resolution ORDER). It builds ON the
+ * Phase A {@link import('./exec-context').ExecutionContext} seam and the Phase A/B owned-connection
+ * transaction runtime; it does NOT re-implement the seam — it supplies the pieces
+ * {@link import('./exec-context').PooledAsyncContext.connectionFor} uses to complete its resolution.
+ *
+ * ## The `connectionFor(intent)` resolution order (design §3, v1 `DBModel.ts:313` parity)
+ *
+ * A statement's connection is resolved in THIS priority (first match wins):
+ *   1. **active tx connection** — inside a transaction, always the tx-owned connection (Phase A).
+ *   2. **writer scope / writer-sticky** — inside {@link withWriter}, or within `writerStickyDuration`
+ *      after a transaction (read-your-writes), a READ goes to the WRITER pool (Phase C — here).
+ *   3. **read=reader / write=writer** — otherwise a read goes to the reader pool, a write to the
+ *      writer pool (reader/writer separation; single-pool config ⇒ reader === writer, Phase C).
+ *   4. **named-DB routing** — the target pool is selected by `intent.db` (the connection NAME carried
+ *      by the bundle/model metadata) against the {@link ConnectionRegistry}; absent ⇒ the DEFAULT
+ *      connection. Named-DB selection happens FIRST (it picks WHICH connection's reader/writer split
+ *      steps 2-3 then apply to), so the order above is really: pick the named connection, then within
+ *      it apply tx-pin / writer-sticky / reader-writer. (Phase C, decorator-free — the routing key is
+ *      config + bundle/model metadata; decorator wiring is Phase F.)
+ *
+ * ## Backward-compat (the hard constraint)
+ *
+ * Single DB, `reader === writer` (one pool), empty config, unnamed connection ⇒ BYTE-IDENTICAL to the
+ * Phase A/B single-pool behavior. A {@link ConnectionRegistry} built from ONE pool routes every
+ * intent to that ONE pool, and the writer-sticky clock only ever diverts to a pool that is the SAME
+ * object — so nothing observable changes. The existing `new PooledAsyncContext(pool)` /
+ * `new PooledAsyncContext(pool, middleware)` constructors keep working unchanged.
+ */
+import type { AsyncConnectionPool } from './exec-context';
+/**
+ * Per-connection database config (C3) — the knobs a pool is built with. Mirrors v1
+ * `DBConfig`/`DBHandler` (`src/DBHandler.ts`, `src/types.ts`): connection target + pool sizing +
+ * per-statement/keepalive/session knobs. Every field is optional with a documented default; the 4
+ * native ports MUST expose the SAME field names + defaults. This is a DATA contract — it describes
+ * how to BUILD a pool; the actual `pg.Pool` / `mysql2.createPool` construction lives in the driver
+ * adapters (`makesql/pool-executor.ts`), which read these fields.
+ */
+export interface ConnectionConfig {
+    /** Driver dialect for this connection. @default 'postgres' */
+    readonly driver?: 'postgres' | 'mysql' | 'sqlite';
+    /** DB host (server-based dialects). */
+    readonly host?: string;
+    /** DB port. */
+    readonly port?: number;
+    /** DB name (or file path for sqlite). */
+    readonly database?: string;
+    /** Username. */
+    readonly user?: string;
+    /** Password. */
+    readonly password?: string;
+    /**
+     * Per-statement timeout in MILLISECONDS. Applied as a session `statement_timeout` (PG) /
+     * `max_execution_time` (MySQL) so a runaway query is aborted by the SERVER. `0`/absent ⇒ no
+     * statement timeout (the engine default). v1 exposed this as `queryTimeout` in SECONDS on the pg
+     * CLIENT (`query_timeout`); the v2 contract is server-side ms so it fires uniformly across drivers.
+     * @default 0 (no timeout)
+     */
+    readonly queryTimeout?: number;
+    /** Enable TCP keepalive on pooled connections (recommended for serverless). @default false */
+    readonly keepAlive?: boolean;
+    /** ms before the first keepalive probe. @default 10000 (when keepAlive) */
+    readonly keepAliveInitialDelayMillis?: number;
+    /** Minimum pooled connections kept warm. @default 0 */
+    readonly minPool?: number;
+    /** Maximum pooled connections. @default 10 */
+    readonly maxPool?: number;
+    /** PG `search_path` set on each pooled connection at checkout (schema routing). */
+    readonly searchPath?: string;
+    /** MySQL connection charset / PG client_encoding set on each pooled connection. */
+    readonly charset?: string;
+}
+/** The resolved (defaults-applied) config the pool builder consumes — no `undefined` holes on the knobs. */
+export interface ResolvedConnectionConfig {
+    readonly driver: 'postgres' | 'mysql' | 'sqlite';
+    readonly host?: string;
+    readonly port?: number;
+    readonly database?: string;
+    readonly user?: string;
+    readonly password?: string;
+    readonly queryTimeout: number;
+    readonly keepAlive: boolean;
+    readonly keepAliveInitialDelayMillis: number;
+    readonly minPool: number;
+    readonly maxPool: number;
+    readonly searchPath?: string;
+    readonly charset?: string;
+}
+/** Apply the C3 defaults (queryTimeout=0, keepAlive=false, minPool=0, maxPool=10). */
+export declare function resolveConnectionConfig(config?: ConnectionConfig): ResolvedConnectionConfig;
+/**
+ * The SESSION statements a connection must run at checkout to honor a {@link ResolvedConnectionConfig}
+ * (issued once per acquired connection, in order). This is the per-dialect mapping the port agents
+ * mirror; it is pure (no connection contact) so it is testable in isolation:
+ *
+ *   - **statement timeout** (`queryTimeout` > 0): PG `SET statement_timeout = <ms>`; MySQL
+ *     `SET SESSION max_execution_time = <ms>` (both server-side, ms).
+ *   - **searchPath**: PG `SET search_path TO <path>`; MySQL has no schema search path ⇒ ignored.
+ *   - **charset**: MySQL `SET NAMES <charset>`; PG `SET client_encoding TO <charset>`.
+ *
+ * A key with no value emits nothing (⇒ empty array for an all-default config ⇒ the session is
+ * untouched, backward-compatible). sqlite has no server session ⇒ empty.
+ */
+export declare function sessionStatements(config: ResolvedConnectionConfig): readonly string[];
+/**
+ * A reader/writer pool PAIR for ONE named connection (C1). `reader` serves read-intent statements;
+ * `writer` serves write-intent statements, `withWriter` reads, and writer-sticky reads. When a
+ * connection has no separate replica, `reader === writer` is the SAME pool object — reader/writer
+ * routing then always lands on that one pool (the single-pool backward-compat case).
+ */
+export interface ReaderWriterPools {
+    readonly reader: AsyncConnectionPool;
+    readonly writer: AsyncConnectionPool;
+}
+/** Build a {@link ReaderWriterPools} where reader === writer (single-pool, backward-compat). */
+export declare function singlePoolPair(pool: AsyncConnectionPool): ReaderWriterPools;
+/** Build a {@link ReaderWriterPools} from a distinct reader + writer pool (reader/writer separation). */
+export declare function readerWriterPair(reader: AsyncConnectionPool, writer: AsyncConnectionPool): ReaderWriterPools;
+/** The reserved name of the DEFAULT (unnamed) connection. An `intent.db` of `undefined` uses this. */
+export declare const DEFAULT_CONNECTION = "default";
+/**
+ * The multi-DB connection registry (C2): a map from a connection NAME → its {@link ReaderWriterPools}.
+ * `connectionFor(intent)` selects the pair by `intent.db` (the connection name the bundle/model
+ * metadata carries — decorator-free, from config + metadata; decorator wiring is Phase F), falling
+ * back to {@link DEFAULT_CONNECTION} when unnamed. Selecting a name that was never registered is a
+ * LOUD error (a real wiring bug — never a silent default fallback, which would run a query on the
+ * wrong DB; mirrors the V0 cross-DB relation registry's loud-fail policy).
+ *
+ * A single-DB deployment registers exactly one connection under {@link DEFAULT_CONNECTION} with
+ * `reader === writer` ⇒ every intent routes to that one pool ⇒ byte-identical to Phase A/B.
+ */
+export declare class ConnectionRegistry {
+    /** name → reader/writer pools. */
+    private readonly connections;
+    constructor(connections: ReadonlyMap<string, ReaderWriterPools>);
+    /**
+     * Build a registry from ONE pool as the default connection (reader === writer). This is the
+     * backward-compat path: {@link import('./exec-context').PooledAsyncContext} built from a single
+     * pool wraps it here so its `connectionFor` routes every intent to that one pool.
+     */
+    static singleDefault(pool: AsyncConnectionPool): ConnectionRegistry;
+    /** Fluent builder: start from a default connection's pools, then `.add(name, pools)` more. */
+    static fromDefault(pools: ReaderWriterPools): ConnectionRegistryBuilder;
+    /** The reader/writer pair for `name` (or {@link DEFAULT_CONNECTION} when `undefined`). Loud on a missing name. */
+    pairFor(name: string | undefined): ReaderWriterPools;
+    /** The registered connection names (for diagnostics / `closeAllPools`). */
+    names(): readonly string[];
+    /** Every DISTINCT pool object across all connections (a shared reader===writer counts once). */
+    distinctPools(): readonly AsyncConnectionPool[];
+}
+/** Incremental {@link ConnectionRegistry} builder (name → pools). */
+export declare class ConnectionRegistryBuilder {
+    private readonly connections;
+    /** Register `name` → its reader/writer pools (chainable). Re-adding a name overwrites it. */
+    add(name: string, pools: ReaderWriterPools): this;
+    /** Finalize into an immutable {@link ConnectionRegistry}. */
+    build(): ConnectionRegistry;
+}
+/** True if the current async scope is inside a {@link withWriter} scope. */
+export declare function inWriterScope(): boolean;
+/**
+ * Run `fn` with reads pinned to the WRITER pool (mirror v1 `DBModel.withWriter`): every read `fn`
+ * issues resolves the writer pool (read-your-writes without replication lag), and — because this ALSO
+ * enters a {@link import('./tx-options').withReadOnly} scope — ANY write inside `fn` throws
+ * {@link import('../types').WriteInReadOnlyContextError}. Nested `withWriter` is idempotent (already
+ * in a writer scope ⇒ just run `fn`). Inside a transaction the tx-owned connection already wins in
+ * `connectionFor`, so a `withWriter` there is a no-op on routing (matches v1 :2941).
+ *
+ * @param fn the read-your-writes scope body.
+ */
+export declare function withWriter<R>(fn: () => Promise<R>): Promise<R>;
+/**
+ * A writer-sticky CLOCK (C1, read-your-writes; v1 `_shouldUseWriterSticky` :344 + `_lastTransactionTime`).
+ * After a transaction (or a bare write) COMMITs, reads within `stickyDurationMs` route to the WRITER
+ * pool so a just-committed row is visible despite reader-replica lag. The ctx owns ONE clock instance;
+ * the tx runtime `.mark()`s it on every successful write/commit; `connectionFor` reads `.isSticky()`.
+ *
+ * `useWriterAfterTransaction=false` disables it entirely (`.isSticky()` always false). A single-pool
+ * deployment (reader === writer) is unaffected by stickiness — the diverted pool is the same object.
+ */
+export declare class WriterStickyClock {
+    private lastWriteAt;
+    private readonly enabled;
+    private readonly stickyDurationMs;
+    /** Injectable clock (tests advance it); defaults to `Date.now`. */
+    private readonly now;
+    constructor(opts?: {
+        useWriterAfterTransaction?: boolean;
+        writerStickyDuration?: number;
+        now?: () => number;
+    });
+    /** Record that a write/commit just happened (the tx runtime calls this on success). */
+    mark(): void;
+    /** Is a read currently sticky-to-writer (within `writerStickyDuration` of the last write)? */
+    isSticky(): boolean;
+    /** Reset the clock (e.g. between tests / on `closeAllPools`). */
+    reset(): void;
+}
+/**
+ * The routing configuration a {@link import('./exec-context').PooledAsyncContext} carries to complete
+ * its `connectionFor(intent)` resolution (steps 2-4): the multi-DB {@link ConnectionRegistry}, the
+ * {@link WriterStickyClock}, and the resolved per-connection {@link ResolvedConnectionConfig} (for the
+ * session statements the pool applies). Absent ⇒ the ctx falls back to its single default pool with
+ * an always-false sticky clock — the byte-identical Phase A/B path.
+ */
+export interface RoutingConfig {
+    readonly registry: ConnectionRegistry;
+    readonly sticky: WriterStickyClock;
+}
+/**
+ * Resolve WHICH pool serves a statement given its {@link import('./exec-context').StatementIntent}
+ * and the routing config — the completion of `connectionFor`'s steps 2-4 (step 1, the tx-pin, is
+ * handled by the ctx BEFORE calling this, since only the ctx holds the ALS pin). The order:
+ *
+ *   1. **named-DB** (`intent.db`) selects the {@link ReaderWriterPools} pair (loud on unknown name).
+ *   2. within that pair: a WRITE ⇒ the writer pool.
+ *   3. a READ in a {@link withWriter} scope OR within writer-sticky ⇒ the writer pool (read-your-writes).
+ *   4. otherwise a READ ⇒ the reader pool.
+ *
+ * Single-pool (reader === writer) ⇒ every branch returns the same pool (backward-compat).
+ */
+export declare function resolvePool(intent: {
+    readonly write: boolean;
+    readonly db?: string;
+}, routing: RoutingConfig): AsyncConnectionPool;
+/**
+ * The RESET statements that undo {@link sessionStatements} on release (per dialect), so a session
+ * knob (`statement_timeout` / `search_path` / `client_encoding` / `max_execution_time` / charset)
+ * set for THIS configured connection does NOT leak to the next caller that draws the SAME underlying
+ * pooled connection — pg/mysql2 do NOT auto-reset session state on release. `RESET`/`SET … DEFAULT`
+ * restores the server default. Only the knobs `config` actually set are reset (an all-default config
+ * ⇒ nothing to reset).
+ */
+export declare function sessionResetStatements(config: ResolvedConnectionConfig): readonly string[];
+/**
+ * Wrap an {@link AsyncConnectionPool} so every acquired connection first runs the
+ * {@link sessionStatements} for `config` (statement timeout / search_path / charset) and, on release,
+ * runs {@link sessionResetStatements} to restore the server defaults (so a pooled connection never
+ * leaks THIS config's session state to the next caller — pg/mysql2 don't auto-reset on release). A
+ * config with no session knobs (all defaults) ⇒ ZERO extra statements ⇒ the wrapper is a transparent
+ * passthrough (backward-compat). This is where C3's `queryTimeout`/`searchPath`/`charset` become REAL
+ * per-server effects — the acquired connection carries them for the statement(s) that run on it.
+ *
+ * If a session statement itself fails (e.g. an invalid search_path), the connection is released back
+ * as DESTROYED so a mis-configured connection never re-enters the pool. On release, if a statement
+ * ERRORED (the connection is possibly aborted — e.g. a fired statement timeout), the reset is SKIPPED
+ * and the connection is DESTROYED (a poisoned connection must not re-enter the pool anyway).
+ */
+export declare function configuredPool(pool: AsyncConnectionPool, config: ResolvedConnectionConfig): AsyncConnectionPool;
+/** A pool CLOSER — closes a pool's underlying connections (pg `pool.end()` / mysql2 `pool.end()`). */
+export type PoolCloser = () => Promise<void>;
+/**
+ * A driver's pool factory: BUILD a pool from a {@link ResolvedConnectionConfig}, returning the
+ * {@link AsyncConnectionPool} seam adapter plus a {@link PoolCloser}. This is where the CONSTRUCTION
+ * knobs — pool sizing (`minPool`/`maxPool`) + `keepAlive`/`keepAliveInitialDelayMillis` — reach the
+ * real driver (`new pg.Pool({ max, keepAlive, … })` / `mysql2.createPool({ connectionLimit, … })`),
+ * because those are pool-CONSTRUCTION options a pre-built pool can no longer accept.
+ *
+ * `buildRoutingConfig` OWNS the call to this factory with the RESOLVED config, so the configured
+ * sizing/keepAlive is the SOLE source of the pool's cap — there is no second raw `new Pool({max})`
+ * path. `role` lets a factory build a distinct replica pool for the reader vs. the writer (e.g. a
+ * different host) while sharing the same sizing config; a factory that returns the SAME pool for both
+ * roles collapses to single-pool (reader === writer).
+ *
+ * The module stays driver-AGNOSTIC: the factory is supplied by the peer-dep-owning caller (this file
+ * imports no driver). The pool-executor adapters (`makesql/pool-executor.ts`) provide the concrete
+ * pg/mysql2 factories; the port agents (#88-91) supply their language's equivalent — the SAME shape.
+ */
+export type PoolFactory = (config: ResolvedConnectionConfig, role: 'reader' | 'writer') => {
+    pool: AsyncConnectionPool;
+    close: PoolCloser;
+};
+/**
+ * One connection's inputs to {@link buildRoutingConfig}: its NAME (default when absent), its
+ * {@link ConnectionConfig} (connection params + sizing + keepAlive + session knobs), and a
+ * {@link PoolFactory} that `buildRoutingConfig` CALLS with the resolved config to construct the
+ * pool(s) — so sizing/keepAlive are applied at construction and the config is the sole cap source.
+ *
+ * `separateWriter: true` asks the factory for a DISTINCT writer pool (reader/writer replica split);
+ * otherwise the factory's reader pool is reused as the writer (single-pool, reader === writer).
+ */
+export interface ConnectionSetup {
+    readonly name?: string;
+    readonly config?: ConnectionConfig;
+    /** The driver pool factory (built by `buildRoutingConfig` with the resolved config — sizing/keepAlive land here). */
+    readonly poolFactory: PoolFactory;
+    /** Build a distinct writer pool via the factory (replica split). Default false ⇒ reader === writer. */
+    readonly separateWriter?: boolean;
+}
+/**
+ * The C3 `setConfig` result: the {@link RoutingConfig} a {@link import('./exec-context').PooledAsyncContext}
+ * runs on, plus a `close()` that shuts every constructed pool ({@link closeAllPools}). Build it from
+ * one or more {@link ConnectionSetup}s (the one named `default`, or the first unnamed, is the default
+ * connection).
+ *
+ * For each setup: resolve the config, CALL its {@link PoolFactory} to construct the pool(s) — so
+ * `minPool`/`maxPool`/`keepAlive`/`keepAliveInitialDelayMillis` are applied at `new Pool()` /
+ * `createPool()` time (the config is the SOLE source of the cap) — then wrap each pool with
+ * {@link configuredPool} so the SESSION knobs (queryTimeout/searchPath/charset) apply on checkout.
+ */
+export declare function buildRoutingConfig(setups: readonly ConnectionSetup[], stickyOpts?: {
+    useWriterAfterTransaction?: boolean;
+    writerStickyDuration?: number;
+}): {
+    routing: RoutingConfig;
+    close: PoolCloser;
+};
+//# sourceMappingURL=connection-routing.d.ts.map

package/dist/scp/connection-routing.d.ts.map

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