litedbmodel 2.1.0 → 2.2.1

package/dist/scp/tx-options.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * litedbmodel v2 SCP — the **tx-completeness contract** (Phase B-1 / #81): the TransactionOptions
+ * shape, the guard errors, the per-dialect isolation-level SQL, and the retryable-error classifier.
+ *
+ * This module is the **API REFERENCE** for Phase B — the 4 native ports (rust #82 / go #83 / py #84
+ * / php #85) mirror THIS contract exactly (option field names + defaults, guard-error semantics,
+ * isolation-level→SQL mapping per dialect, retryable-error classification, retry-loop policy). It is
+ * dialect-neutral and driver-agnostic on purpose: `withTransactionAsync` (exec-context.ts) consumes
+ * it; nothing here touches a connection.
+ *
+ * It builds ON the Phase A {@link import('./exec-context').ExecutionContext} + owned-connection
+ * ownership (`withTransactionAsync`); it does NOT re-implement connection ownership — it layers the
+ * options/guards/retry/isolation on top of that seam. It mirrors v1 `src/DBModel.ts`
+ * (`transaction` :2787, `checkWriteAllowed` :886, `isRetryableError` :2865) but on the SCP seam.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteInReadOnlyContextError = exports.WriteOutsideTransactionError = void 0;
+exports.isolationPhrase = isolationPhrase;
+exports.beginStatements = beginStatements;
+exports.resolveTxOptions = resolveTxOptions;
+exports.isRetryableTxError = isRetryableTxError;
+exports.sleep = sleep;
+exports.runInTransactionScope = runInTransactionScope;
+exports.withReadOnly = withReadOnly;
+exports.isInTransaction = isInTransaction;
+exports.isReadOnly = isReadOnly;
+exports.checkWriteAllowed = checkWriteAllowed;
+const types_1 = require("../types");
+Object.defineProperty(exports, "WriteOutsideTransactionError", { enumerable: true, get: function () { return types_1.WriteOutsideTransactionError; } });
+Object.defineProperty(exports, "WriteInReadOnlyContextError", { enumerable: true, get: function () { return types_1.WriteInReadOnlyContextError; } });
+/** The canonical SQL phrase for an {@link IsolationLevel} (e.g. `SERIALIZABLE`). */
+function isolationPhrase(level) {
+    switch (level) {
+        case 'read committed':
+            return 'READ COMMITTED';
+        case 'repeatable read':
+            return 'REPEATABLE READ';
+        case 'serializable':
+            return 'SERIALIZABLE';
+        default: {
+            // Fail-CLOSED on an unknown level (a corrupt/forward-incompatible value must NOT silently run
+            // at the engine default — that would hide a mis-set isolation). Mirrors the tx gate's policy.
+            const bad = level;
+            throw new Error(`scp tx: unknown isolation level '${String(bad)}'`);
+        }
+    }
+}
+/**
+ * The tx-start statements for `dialect` at `isolation` (in issue order). Per-dialect because the
+ * three engines express per-transaction isolation DIFFERENTLY:
+ *
+ *   - **postgres**: `BEGIN ISOLATION LEVEL <phrase>` — one statement, the level rides the BEGIN.
+ *   - **mysql**: `SET TRANSACTION ISOLATION LEVEL <phrase>` MUST precede `BEGIN` (it scopes the very
+ *     NEXT transaction only), so this returns TWO statements: the SET, then a bare `BEGIN`.
+ *   - **sqlite**: SQLite has NO per-transaction isolation-level knob. Its isolation is a
+ *     process/PRAGMA-level property (`journal_mode=WAL` gives snapshot reads; the default rollback
+ *     journal serializes writers), NOT something a `BEGIN` clause selects. So an isolation request on
+ *     SQLite is a HARD ERROR here — we do NOT silently drop it (that would fake honoring the level).
+ *     The conformance/bench SQLite path never passes `isolation`, so it always emits a bare `BEGIN`.
+ *
+ * With no `isolation`, every dialect emits a single bare `BEGIN` (the Phase A behavior, byte-identical).
+ */
+function beginStatements(dialect, isolation) {
+    if (isolation === undefined)
+        return ['BEGIN'];
+    const phrase = isolationPhrase(isolation);
+    switch (dialect) {
+        case 'postgres':
+            return [`BEGIN ISOLATION LEVEL ${phrase}`];
+        case 'mysql':
+            // The SET scopes ONLY the next tx; it must be issued before BEGIN, on the SAME connection.
+            return [`SET TRANSACTION ISOLATION LEVEL ${phrase}`, 'BEGIN'];
+        case 'sqlite':
+            throw new Error(`scp tx: SQLite does not support a per-transaction isolation level ('${isolation}'). ` +
+                `SQLite isolation is a connection/PRAGMA property (e.g. journal_mode=WAL for snapshot reads), ` +
+                `not a BEGIN clause — set it on the connection, and omit TransactionOptions.isolation for SQLite.`);
+        default: {
+            const bad = dialect;
+            throw new Error(`scp tx: unknown dialect '${String(bad)}'`);
+        }
+    }
+}
+/** Apply the Phase B defaults (v1-parity: retryOnError=true, retryLimit=3, retryDuration=200). */
+function resolveTxOptions(opts = {}) {
+    return {
+        isolation: opts.isolation,
+        retryOnError: opts.retryOnError ?? true,
+        retryLimit: opts.retryLimit ?? 3,
+        retryDuration: opts.retryDuration ?? 200,
+        rollbackOnly: opts.rollbackOnly ?? false,
+        useWriterAfterTransaction: opts.useWriterAfterTransaction ?? true,
+    };
+}
+// ── Retryable-error classification (per dialect) ──────────────────────────────
+/**
+ * Is `error` a RETRYABLE transaction failure — a deadlock, a serialization failure, or a broken
+ * connection — for which re-running the whole transaction can succeed? Classification is by the
+ * driver's stable error CODE first (PG `SQLSTATE`, MySQL `errno`), with the v1 message substrings as
+ * a fallback (mirrors v1 `DBModel.isRetryableError` :2865). A data conflict (unique/FK/check) is NOT
+ * retryable — re-running would fail identically.
+ *
+ * Codes (per dialect):
+ *   - **postgres** SQLSTATE: `40001` serialization_failure, `40P01` deadlock_detected.
+ *   - **mysql** errno: `1213` ER_LOCK_DEADLOCK, `1205` ER_LOCK_WAIT_TIMEOUT.
+ *   - **connection errors** (either dialect): via {@link isConnectionError} — a dropped/reset/refused
+ *     connection is retryable (reconnect on the next attempt).
+ */
+function isRetryableTxError(error, isConnectionError) {
+    if (!(error instanceof Error))
+        return false;
+    if (isConnectionError(error))
+        return true;
+    // PG: SQLSTATE on `error.code` (5-char string). MySQL: errno on `error.errno` (number) or `code`.
+    const e = error;
+    const pgState = typeof e.code === 'string' ? e.code : typeof e.sqlState === 'string' ? e.sqlState : '';
+    if (pgState === '40001' || pgState === '40P01')
+        return true; // serialization_failure / deadlock_detected
+    const myErrno = typeof e.errno === 'number' ? e.errno : typeof e.code === 'number' ? e.code : undefined;
+    if (myErrno === 1213 || myErrno === 1205)
+        return true; // ER_LOCK_DEADLOCK / ER_LOCK_WAIT_TIMEOUT
+    // Fallback: the v1 message substrings (driver-version-independent phrasing).
+    const message = error.message || '';
+    return (message.includes('The transaction might succeed if retried') ||
+        message.includes('try restarting transaction') ||
+        message.includes('could not serialize access due to concurrent update') ||
+        message.includes('could not serialize access') ||
+        message.includes('Deadlock found') ||
+        message.includes('deadlock detected') ||
+        message.includes('Lock wait timeout exceeded'));
+}
+/** Sleep `ms` (the retry backoff). */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ── write=tx guards (mirror v1 `checkWriteAllowed`, DBModel.ts:886) ────────────
+const node_async_hooks_1 = require("node:async_hooks");
+/**
+ * Ambient "inside an active transaction" marker (§ write=tx guard). Set by the tx runtime while a
+ * transaction body runs — {@link isInTransaction} reads it, {@link checkWriteAllowed} enforces it.
+ * This is the guard-facing mirror of the exec-context ALS connection pin: the pin proves per-
+ * execution ownership; THIS marker proves the write is inside a caller-opened tx scope. The native
+ * ports mark the SAME scope in their task-local / contextvar / `context.Context`.
+ */
+const txActiveStore = new node_async_hooks_1.AsyncLocalStorage();
+/** Ambient "read-only context" marker (mirror v1 `withWriter`): a write here is REJECTED. */
+const readOnlyStore = new node_async_hooks_1.AsyncLocalStorage();
+/** Run `fn` with the "inside a transaction" marker set (called by the tx runtime around the body). */
+function runInTransactionScope(fn) {
+    return txActiveStore.run(true, fn);
+}
+/**
+ * Run `fn` in a READ-ONLY context (mirror v1 `DBModel.withWriter`): reads are allowed, but ANY write
+ * inside `fn` throws {@link WriteInReadOnlyContextError}. Use for a read-your-writes / writer-pinned
+ * read scope that must never accidentally mutate.
+ */
+function withReadOnly(fn) {
+    return readOnlyStore.run(true, fn);
+}
+/** True if the current async scope is inside an active transaction (guard/nested detection). */
+function isInTransaction() {
+    return txActiveStore.getStore() === true;
+}
+/** True if the current async scope is a read-only context ({@link withReadOnly}). */
+function isReadOnly() {
+    return readOnlyStore.getStore() === true;
+}
+/**
+ * Enforce the write=tx guard (mirror v1 `DBModel._checkWriteAllowed`, DBModel.ts:886-896): a write
+ * inside a {@link withReadOnly} scope throws {@link WriteInReadOnlyContextError}; a write with NO
+ * active transaction throws {@link WriteOutsideTransactionError}. Called at every write ENTRY
+ * (create/update/delete/upsert/batch) BEFORE any SQL is issued. The order matches v1: read-only is
+ * checked first (a read-only scope is the more specific rejection).
+ *
+ * @param operation the write op name (INSERT/UPDATE/DELETE/UPSERT/BATCH) — carried in the error.
+ * @param modelName optional model/table name — carried in the error for diagnosis.
+ */
+function checkWriteAllowed(operation, modelName) {
+    if (isReadOnly())
+        throw new types_1.WriteInReadOnlyContextError(operation, modelName);
+    if (!isInTransaction())
+        throw new types_1.WriteOutsideTransactionError(operation, modelName);
+}
+//# sourceMappingURL=tx-options.js.map

package/dist/scp/tx-options.js.map

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

package/dist/scp/write-bundle.d.ts

@@ -0,0 +1,131 @@
+/**
+ * litedbmodel v2 SCP — the WRITE bundle surface (spec §6 / §8 / §13 / §14).
+ *
+ * A write compiles (SYMBOLICALLY — no concrete input) to a {@link SqlBundle}: the base write
+ * statement plus the derived, gate-first {@link TransactionPlan} the tx runtime executes. The bundle
+ * is pure serializable JSON, so ALL FIVE language runtimes execute the SAME plan through the SAME
+ * per-statement tx loop.
+ *
+ * Two shapes, one plan derivation:
+ *  - **Command** ({@link compileWriteBundle} / {@link compileCompositeWriteBundle}) — one (or several
+ *    named) base write(s) + an `entityWrites` save contract; `deriveTransactionPlan` lowers the §6
+ *    effect arrays around them into the ordered, gate-first statement list.
+ *  - **Batch** ({@link compileCreateManyBundle} / {@link compileUpdateManyBundle} /
+ *    {@link compileDeleteManyBundle}) — ONE logical op producing N grouped statements, lowered to a
+ *    gate-free plan by `deriveBatchPlan`. The batch SQL is byte-copied from the v1 builders.
+ *
+ * READS are NOT here. A read is declared on the `@behavior` / `@leaf` authoring surface and lowered by
+ * `bc generate` into a native module per language; the TS runtime seam for such a module is
+ * `bind(leafHandlers(ctx))` (see `./leaves`). There is no runtime read-compile.
+ */
+import type { Scope } from 'behavior-contracts/runtime';
+import type { SqliteDriver } from './exec-context';
+import { SqlFailure } from './errors';
+import type { DialectName } from './dialect';
+import type { ColumnTypeResolver } from './coltype';
+import { type TxOp, type TransactionPlan, type TransactionResult } from './makesql/tx';
+import { type InsertManyBuildOptions } from './makesql/compile-crud';
+import type { UpdateManyBuildOptions } from '../drivers/types';
+import { type EntityWritesDefinition, type LifecycleContract, type WriteLifecyclePhase } from './writes';
+/** The minimal synchronous SQLite driver surface the write runtime needs (better-sqlite3 `Database`). */
+export type SqliteDb = SqliteDriver;
+/** Execute options for a bundle's transaction plan: the synchronous driver. */
+export interface ExecuteOptions {
+    /** The synchronous SQLite driver (better-sqlite3 `Database`). */
+    readonly db: SqliteDb;
+    /** The target SQL dialect (spec §4/§10). Defaults to `'sqlite'` (the in-process runtime seam). */
+    readonly dialect?: DialectName;
+}
+/**
+ * The compiled write bundle of ONE logical operation (spec §8) — pure serializable JSON a thin
+ * per-language runtime can execute WITHOUT re-implementing litedbmodel's compile.
+ *
+ * `dialect` is the target SQL dialect (compiled ONCE, TS-side); a PG bundle's `?`→`$N` conversion is
+ * the render-time final pass, so the bundle stays uniform and dialect-tagged.
+ */
+export interface SqlBundle {
+    readonly dialect: DialectName;
+    /** The operation (component) name. */
+    readonly name: string;
+    /** The base-write statement template (the plan's first body statement). */
+    readonly statement: TxOp;
+    /** The derived transaction plan — gate-first for a Command, gate-free for a batch. */
+    readonly transaction: TransactionPlan;
+    /**
+     * Codegen typed-de-box `outputType` (spec §4.1 / §9): the bc portable type of the write's
+     * {@link TransactionResult} (entity / returnedRows rows typed via the schema SoT). Present ONLY when
+     * a column-type resolver was supplied at compile (additive: absent → un-annotated).
+     */
+    readonly outputType?: unknown;
+}
+/**
+ * Compile a base write + its `entityWrites` save contract into a {@link SqlBundle} carrying the
+ * derived, gate-first write-time-relations {@link TransactionPlan} (spec §6/§8). `base` is the
+ * complete tuned write statement the `makesql` write compiler ({@link
+ * import('./makesql/tx').compileWriteNode}) emits; {@link deriveTransactionPlan} lowers the
+ * lifecycle's §6 effect arrays around it into the ordered statement list. Pure JSON; a per-language
+ * runtime honors the SAME plan.
+ */
+export declare function compileWriteBundle(name: string, base: TxOp, writes: EntityWritesDefinition, phase: WriteLifecyclePhase, dialectName?: DialectName, resolveColumnType?: ColumnTypeResolver): SqlBundle;
+/**
+ * One member of a COMPOSITE (multi-write) Command (WS8a, #28 — spec §6 nested write / §14 tx-DAG):
+ * a named base write carrying its OWN save-contract `effects`. A later member references an earlier
+ * member's RETURNING row via `$.ref.<name>.<field>`.
+ */
+export interface CompositeWriteEntry {
+    /** The member name a later member references as `$.ref.<name>.<field>`. */
+    readonly name: string;
+    /** The member's complete tuned base write statement. */
+    readonly base: TxOp;
+    /** The member's own save-contract effects. */
+    readonly lifecycle: LifecycleContract;
+}
+/**
+ * Compile a COMPOSITE (multi-write) Command into a {@link SqlBundle} carrying ONE derived, gate-first,
+ * TOPOLOGICALLY-ORDERED transaction plan (spec §6 nested write / §14). Each entry contributes a named
+ * base write + its effects; a later member depends on an earlier via `$.ref.<name>.*`.
+ * {@link deriveTransactionPlan} builds the DAG + gate-first constraint and derives the ordered plan; a
+ * cycle / dangling ref is ESCALATED. Pure JSON.
+ */
+export declare function compileCompositeWriteBundle(entries: readonly CompositeWriteEntry[], phase: WriteLifecyclePhase, dialectName?: DialectName): SqlBundle;
+/**
+ * Compile a `createMany` into a batch write {@link SqlBundle} carrying a gate-free
+ * {@link TransactionPlan}. Heterogeneous column-set groups become MULTIPLE ordered INSERT statements —
+ * byte-identical to what `DBModel._insert` emits per group (via `compileInsertMany`).
+ *
+ * `pk` (the target PK descriptor) is REQUIRED when the createMany carries a RETURNING clause on the
+ * MySQL dialect: a batch INSERT persists N rows, so the MySQL RETURNING emulation must re-select ALL
+ * N (a range on the AUTO_INCREMENT column, or the client-supplied PK values), not a single `id`.
+ */
+export declare function compileCreateManyBundle(name: string, options: InsertManyBuildOptions & {
+    pk?: {
+        columns: readonly string[];
+        autoInc: string | null;
+    };
+}, dialectName?: DialectName, resolveColumnType?: ColumnTypeResolver): SqlBundle;
+/**
+ * Compile an `updateMany` into a batch write {@link SqlBundle} (one UNNEST/JSON/CASE statement,
+ * byte-identical to `compileUpdateMany` driving the v1 `buildUpdateMany` / JSON-batch builder).
+ */
+export declare function compileUpdateManyBundle(name: string, options: UpdateManyBuildOptions, dialectName?: DialectName): SqlBundle;
+/**
+ * Compile a `deleteMany` into a batch write {@link SqlBundle} — a PK-set IN-list DELETE (single-key)
+ * or one DELETE per composite-key group, driven by the v1 `DBConditions` builder (`compileDeleteMany`).
+ * An EMPTY key set produces an empty plan (nothing to delete), never a synthesized always-false DELETE.
+ */
+export declare function compileDeleteManyBundle(name: string, options: {
+    tableName: string;
+    keyColumns: string[];
+    keys: Record<string, unknown>[];
+    returning?: string;
+}, dialectName?: DialectName): SqlBundle;
+/**
+ * Execute a {@link SqlBundle}'s derived transaction plan (spec §6/§8) as ONE real SQLite transaction.
+ * The SAME code path a thin per-language runtime follows: it consumes ONLY the serialized
+ * {@link TransactionPlan} (pure JSON) + a SQL driver, never re-deriving the plan.
+ *
+ * @throws {SqlFailure} on a driver failure (the transaction ROLLBACKs first).
+ */
+export declare function executeTransactionBundle(bundle: SqlBundle, input: Scope, options: ExecuteOptions): TransactionResult;
+export { SqlFailure };
+//# sourceMappingURL=write-bundle.d.ts.map

package/dist/scp/write-bundle.d.ts.map

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

package/dist/scp/write-bundle.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * litedbmodel v2 SCP — the WRITE bundle surface (spec §6 / §8 / §13 / §14).
+ *
+ * A write compiles (SYMBOLICALLY — no concrete input) to a {@link SqlBundle}: the base write
+ * statement plus the derived, gate-first {@link TransactionPlan} the tx runtime executes. The bundle
+ * is pure serializable JSON, so ALL FIVE language runtimes execute the SAME plan through the SAME
+ * per-statement tx loop.
+ *
+ * Two shapes, one plan derivation:
+ *  - **Command** ({@link compileWriteBundle} / {@link compileCompositeWriteBundle}) — one (or several
+ *    named) base write(s) + an `entityWrites` save contract; `deriveTransactionPlan` lowers the §6
+ *    effect arrays around them into the ordered, gate-first statement list.
+ *  - **Batch** ({@link compileCreateManyBundle} / {@link compileUpdateManyBundle} /
+ *    {@link compileDeleteManyBundle}) — ONE logical op producing N grouped statements, lowered to a
+ *    gate-free plan by `deriveBatchPlan`. The batch SQL is byte-copied from the v1 builders.
+ *
+ * READS are NOT here. A read is declared on the `@behavior` / `@leaf` authoring surface and lowered by
+ * `bc generate` into a native module per language; the TS runtime seam for such a module is
+ * `bind(leafHandlers(ctx))` (see `./leaves`). There is no runtime read-compile.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqlFailure = void 0;
+exports.compileWriteBundle = compileWriteBundle;
+exports.compileCompositeWriteBundle = compileCompositeWriteBundle;
+exports.compileCreateManyBundle = compileCreateManyBundle;
+exports.compileUpdateManyBundle = compileUpdateManyBundle;
+exports.compileDeleteManyBundle = compileDeleteManyBundle;
+exports.executeTransactionBundle = executeTransactionBundle;
+const errors_1 = require("./errors");
+Object.defineProperty(exports, "SqlFailure", { enumerable: true, get: function () { return errors_1.SqlFailure; } });
+const tx_1 = require("./makesql/tx");
+const compile_crud_1 = require("./makesql/compile-crud");
+const mysql_returning_1 = require("./makesql/mysql-returning");
+const makesql_1 = require("./makesql/makesql");
+const writeouttype_1 = require("./makesql/writeouttype");
+const writes_1 = require("./writes");
+/** Diagnostics label for a base write (its SQL verb). */
+function writeLabelOf(sql) {
+    const m = /^\s*(INSERT|UPDATE|DELETE)/i.exec(sql);
+    return m === null ? 'Write' : m[1][0].toUpperCase() + m[1].slice(1).toLowerCase();
+}
+// ── Write-time relations: the Command bundle (WS5, #25 — spec §6) ──────────────
+/**
+ * Compile a base write + its `entityWrites` save contract into a {@link SqlBundle} carrying the
+ * derived, gate-first write-time-relations {@link TransactionPlan} (spec §6/§8). `base` is the
+ * complete tuned write statement the `makesql` write compiler ({@link
+ * import('./makesql/tx').compileWriteNode}) emits; {@link deriveTransactionPlan} lowers the
+ * lifecycle's §6 effect arrays around it into the ordered statement list. Pure JSON; a per-language
+ * runtime honors the SAME plan.
+ */
+function compileWriteBundle(name, base, writes, phase, dialectName = 'sqlite', resolveColumnType) {
+    const lifecycle = (0, writes_1.lifecycleFor)(writes, phase);
+    if (lifecycle === undefined) {
+        throw new Error(`scp write: the '${phase}' lifecycle is not declared in the entityWrites save contract`);
+    }
+    const plan = (0, tx_1.deriveTransactionPlan)(phase, [{ op: base, label: writeLabelOf(base.sql) }], lifecycle, dialectName);
+    const bundle = { dialect: dialectName, name, statement: base, transaction: plan };
+    // Codegen typed de-box (spec §4.1/§9): when the schema/DDL column-type SoT is supplied, annotate the
+    // bundle with the TransactionResult `outputType` so the typed emitters materialize a concrete struct
+    // for the result. Fail-closed inside `annotateWriteBundleOutType`.
+    return resolveColumnType === undefined ? bundle : (0, writeouttype_1.annotateWriteBundleOutType)(bundle, resolveColumnType);
+}
+/**
+ * Compile a COMPOSITE (multi-write) Command into a {@link SqlBundle} carrying ONE derived, gate-first,
+ * TOPOLOGICALLY-ORDERED transaction plan (spec §6 nested write / §14). Each entry contributes a named
+ * base write + its effects; a later member depends on an earlier via `$.ref.<name>.*`.
+ * {@link deriveTransactionPlan} builds the DAG + gate-first constraint and derives the ordered plan; a
+ * cycle / dangling ref is ESCALATED. Pure JSON.
+ */
+function compileCompositeWriteBundle(entries, phase, dialectName = 'sqlite') {
+    if (entries.length < 2) {
+        throw new Error('scp write: a composite write bundle needs at least 2 named write members (use compileWriteBundle for a single write).');
+    }
+    const bases = entries.map((e) => ({ op: e.base, label: `${writeLabelOf(e.base.sql)} ${e.name}`, name: e.name, effects: e.lifecycle.effects }));
+    const plan = (0, tx_1.deriveTransactionPlan)(phase, bases, { effects: {} }, dialectName);
+    return { dialect: dialectName, name: entries[0].name, statement: entries[0].base, transaction: plan };
+}
+// ── Batch writes: createMany / updateMany / deleteMany ─────────────────────────
+//
+// A batch write is ONE LOGICAL operation that produces N grouped SQL statements (createMany with a
+// heterogeneous column-set groups records into one INSERT per group, mirroring `DBModel._insert`;
+// updateMany is one UNNEST/JSON/CASE statement; deleteMany is a PK-set IN-list DELETE). The batch
+// compilers (`compileInsertMany`/`compileUpdateMany`/`compileDeleteMany`) copy the v1 builders
+// byte-for-byte; here they are lowered into a gate-free {@link TransactionPlan} of body statements
+// ({@link deriveBatchPlan}), so ALL FIVE runtimes execute the multi-statement batch through the SAME
+// per-statement tx loop with no runtime change.
+/** Flatten a batch compiler's `MakeSQL` component to a concrete `{ sql, params }` op. */
+function flattenBatchOp(node, label) {
+    const assembled = (0, makesql_1.assembleMakeSQL)(node);
+    return { sql: assembled.sql, params: assembled.params, label };
+}
+/**
+ * Compile a `createMany` into a batch write {@link SqlBundle} carrying a gate-free
+ * {@link TransactionPlan}. Heterogeneous column-set groups become MULTIPLE ordered INSERT statements —
+ * byte-identical to what `DBModel._insert` emits per group (via `compileInsertMany`).
+ *
+ * `pk` (the target PK descriptor) is REQUIRED when the createMany carries a RETURNING clause on the
+ * MySQL dialect: a batch INSERT persists N rows, so the MySQL RETURNING emulation must re-select ALL
+ * N (a range on the AUTO_INCREMENT column, or the client-supplied PK values), not a single `id`.
+ */
+function compileCreateManyBundle(name, options, dialectName = 'sqlite', resolveColumnType) {
+    const components = (0, compile_crud_1.compileInsertMany)(dialectName, options);
+    const ops = components.map((c, i) => {
+        const flat = flattenBatchOp(c, `createMany group ${i}`);
+        // On MySQL, annotate a RETURNING batch INSERT with the PK hint so the driver emulation re-selects
+        // every inserted row of the group by the real PK.
+        if (dialectName === 'mysql' && options.pk !== undefined && options.returning !== undefined) {
+            // The batch TxOp carries no writeMeta, so pass the upsert conflict key (upsertMany) explicitly —
+            // the driver re-selects the upserted rows by it (the AUTO_INCREMENT range is wrong on a conflict).
+            const onConflict = options.onConflict !== undefined && options.onConflict.length > 0 ? options.onConflict.join(',') : undefined;
+            return { ...flat, ...(0, mysql_returning_1.mysqlPkHint)({ sql: flat.sql, params: flat.params, pk: options.pk }, onConflict) };
+        }
+        return flat;
+    });
+    const plan = (0, tx_1.deriveBatchPlan)('create', ops);
+    // `ops` is never empty here: `deriveBatchPlan` throws on zero ops, and a `createMany` always groups
+    // into >=1 INSERT. Fail LOUDLY rather than emitting an empty `sql` fallback (an empty-ops batch bundle
+    // is a compile bug, not a default — 'defaults in schema, not code').
+    const head = ops[0];
+    if (head === undefined) {
+        throw new Error(`scp write: compileCreateManyBundle('${name}') produced no INSERT statements (empty createMany grouping) — an empty-ops batch bundle is a compile bug, not a silent empty-SQL default.`);
+    }
+    const bundle = { dialect: dialectName, name, statement: { sql: head.sql, params: head.params }, transaction: plan };
+    return resolveColumnType === undefined ? bundle : (0, writeouttype_1.annotateWriteBundleOutType)(bundle, resolveColumnType);
+}
+/**
+ * Compile an `updateMany` into a batch write {@link SqlBundle} (one UNNEST/JSON/CASE statement,
+ * byte-identical to `compileUpdateMany` driving the v1 `buildUpdateMany` / JSON-batch builder).
+ */
+function compileUpdateManyBundle(name, options, dialectName = 'sqlite') {
+    const op = flattenBatchOp((0, compile_crud_1.compileUpdateMany)(dialectName, options), 'updateMany');
+    const plan = (0, tx_1.deriveBatchPlan)('update', [op]);
+    return { dialect: dialectName, name, statement: { sql: op.sql, params: op.params }, transaction: plan };
+}
+/**
+ * Compile a `deleteMany` into a batch write {@link SqlBundle} — a PK-set IN-list DELETE (single-key)
+ * or one DELETE per composite-key group, driven by the v1 `DBConditions` builder (`compileDeleteMany`).
+ * An EMPTY key set produces an empty plan (nothing to delete), never a synthesized always-false DELETE.
+ */
+function compileDeleteManyBundle(name, options, dialectName = 'sqlite') {
+    const components = (0, compile_crud_1.compileDeleteMany)({ dialect: dialectName, ...options });
+    const ops = components.map((c, i) => flattenBatchOp(c, `deleteMany group ${i}`));
+    if (ops.length === 0) {
+        return { dialect: dialectName, name, statement: { sql: '', params: [] }, transaction: { phase: 'remove', entityFrom: null, statements: [], onIdempotentHit: 'rollback' } };
+    }
+    const plan = (0, tx_1.deriveBatchPlan)('remove', ops);
+    return { dialect: dialectName, name, statement: { sql: ops[0].sql, params: ops[0].params }, transaction: plan };
+}
+/**
+ * Execute a {@link SqlBundle}'s derived transaction plan (spec §6/§8) as ONE real SQLite transaction.
+ * The SAME code path a thin per-language runtime follows: it consumes ONLY the serialized
+ * {@link TransactionPlan} (pure JSON) + a SQL driver, never re-deriving the plan.
+ *
+ * @throws {SqlFailure} on a driver failure (the transaction ROLLBACKs first).
+ */
+function executeTransactionBundle(bundle, input, options) {
+    return (0, tx_1.executeTransaction)(options.db, bundle.transaction, input, bundle.dialect);
+}
+//# sourceMappingURL=write-bundle.js.map

package/dist/scp/write-bundle.js.map

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

package/dist/types.d.ts

@@ -93,7 +93,14 @@ export interface SelectOptions {
     group?: string;
     tableName?: string;
     append?: string;
+    /** Lock the selected rows EXCLUSIVELY (` FOR UPDATE`). Mutually exclusive with {@link forShare}. */
     forUpdate?: boolean;
+    /**
+     * Lock the selected rows for SHARE (` FOR SHARE`): concurrent readers may take the same shared
+     * lock, writers block until this transaction ends. The read-side twin of {@link forUpdate} (and
+     * mutually exclusive with it). PostgreSQL / MySQL only — SQLite parses no locking clause.
+     */
+    forShare?: boolean;
     /**
      * JOIN clause to add to the query.
      * Can include parameters using ? placeholders.

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAqVH;;;;GAIG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAEzB;IAKA;IACA;IACA;IACA;IATlB,YACkB,KAAa;IAC7B;;;OAGG;IACa,WAAmB,EACnB,OAA4B,EAC5B,SAAkB,EAClB,YAAqB;QAErC,MAAM,UAAU,GAAG,OAAO,KAAK,MAAM;YACnC,CAAC,CAAC,aAAa,SAAS,IAAI,SAAS,EAAE;YACvC,CAAC,CAAC,aAAa,YAAY,QAAQ,SAAS,IAAI,SAAS,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,OAAO,KAAK,MAAM;YACjC,CAAC,CAAC,aAAa,KAAK,EAAE,CAAE,qDAAqD;YAC7E,CAAC,CAAC,GAAG,WAAW,EAAE,CAAC,CAAK,8DAA8D;QACxF,KAAK,CACH,yBAAyB,UAAU,aAAa,QAAQ,YAAY;YACpE,gBAAgB,KAAK,qDAAqD;YAC1E,6DAA6D,CAC9D,CAAC;QApBc,UAAK,GAAL,KAAK,CAAQ;QAKb,gBAAW,GAAX,WAAW,CAAQ;QACnB,YAAO,GAAP,OAAO,CAAqB;QAC5B,cAAS,GAAT,SAAS,CAAS;QAClB,iBAAY,GAAZ,YAAY,CAAS;QAarC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAzBD,gDAyBC;AAED;;;;GAIG;AACH,MAAa,4BAA6B,SAAQ,KAAK;IAEnC;IACA;IAFlB,YACkB,SAAiB,EACjB,SAAkB;QAElC,KAAK,CACH,oBAAoB,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,2BAA2B;YAC/F,qDAAqD,CACtD,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAS;QAMlC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAXD,oEAWC;AAED;;;;GAIG;AACH,MAAa,2BAA4B,SAAQ,KAAK;IAElC;IACA;IAFlB,YACkB,SAAiB,EACjB,SAAkB;QAElC,KAAK,CACH,oBAAoB,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,2CAA2C;YAC/G,iDAAiD,CAClD,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAS;QAMlC,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAXD,kEAWC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA4VH;;;;GAIG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAEzB;IAKA;IACA;IACA;IACA;IATlB,YACkB,KAAa;IAC7B;;;OAGG;IACa,WAAmB,EACnB,OAA4B,EAC5B,SAAkB,EAClB,YAAqB;QAErC,MAAM,UAAU,GAAG,OAAO,KAAK,MAAM;YACnC,CAAC,CAAC,aAAa,SAAS,IAAI,SAAS,EAAE;YACvC,CAAC,CAAC,aAAa,YAAY,QAAQ,SAAS,IAAI,SAAS,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,OAAO,KAAK,MAAM;YACjC,CAAC,CAAC,aAAa,KAAK,EAAE,CAAE,qDAAqD;YAC7E,CAAC,CAAC,GAAG,WAAW,EAAE,CAAC,CAAK,8DAA8D;QACxF,KAAK,CACH,yBAAyB,UAAU,aAAa,QAAQ,YAAY;YACpE,gBAAgB,KAAK,qDAAqD;YAC1E,6DAA6D,CAC9D,CAAC;QApBc,UAAK,GAAL,KAAK,CAAQ;QAKb,gBAAW,GAAX,WAAW,CAAQ;QACnB,YAAO,GAAP,OAAO,CAAqB;QAC5B,cAAS,GAAT,SAAS,CAAS;QAClB,iBAAY,GAAZ,YAAY,CAAS;QAarC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAzBD,gDAyBC;AAED;;;;GAIG;AACH,MAAa,4BAA6B,SAAQ,KAAK;IAEnC;IACA;IAFlB,YACkB,SAAiB,EACjB,SAAkB;QAElC,KAAK,CACH,oBAAoB,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,2BAA2B;YAC/F,qDAAqD,CACtD,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAS;QAMlC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAXD,oEAWC;AAED;;;;GAIG;AACH,MAAa,2BAA4B,SAAQ,KAAK;IAElC;IACA;IAFlB,YACkB,SAAiB,EACjB,SAAkB;QAElC,KAAK,CACH,oBAAoB,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,2CAA2C;YAC/G,iDAAiD,CAClD,CAAC;QANc,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAS;QAMlC,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAXD,kEAWC"}