@zmdb/orm 1.0.0-beta.1

package/dist/relations/index.js

@@ -0,0 +1,164 @@
+import { resolveRelation } from '@zmdb/schema/relations';
+import { dialectName, dialectTraits, formatPlaceholder, quoteIdentifier, renderPredicate, UnsupportedFeatureError, } from '@zmdb/sql';
+function sanitizeKeys(keys) {
+    const result = [];
+    const seen = new Set();
+    for (const k of keys) {
+        if (k !== null && k !== undefined && !seen.has(k)) {
+            seen.add(k);
+            result.push(k);
+        }
+    }
+    return result;
+}
+function sameKeyValue(left, right) {
+    if (left instanceof Date && right instanceof Date)
+        return left.getTime() === right.getTime();
+    return Object.is(left, right);
+}
+function sanitizeCompositeKeys(ir, relationName, keys, arity) {
+    const result = [];
+    for (const key of keys) {
+        if (key === null || key === undefined)
+            continue;
+        if (!Array.isArray(key)) {
+            throw new Error(`${ir.table}.${relationName}: composite-key populate expects a ${String(arity)}-column tuple for every parent`);
+        }
+        if (key.length !== arity) {
+            throw new Error(`${ir.table}.${relationName}: composite-key populate expected ${String(arity)} values, received ${String(key.length)}`);
+        }
+        if (key.some(value => value === null || value === undefined))
+            continue;
+        if (result.some(existing => existing.every((value, index) => sameKeyValue(value, key[index]))))
+            continue;
+        result.push([...key]);
+    }
+    return result;
+}
+/**
+ * Compile a populate hint into SQL: a to-one becomes an `INNER JOIN`, a to-many a batched
+ * `IN (…)` select over the parent keys.
+ *
+ * Takes the declaring table's IR and a relation name rather than a relation object, which is
+ * what makes the two spellings one: the columns on either side of the `ON` come out of
+ * `resolveRelation`, the same call `@zmdb/orm`'s `populate` makes.
+ */
+export function compilePopulate(ir, relationName, dialect, parentIds = [], targetFilters = [], schemas = []) {
+    const rel = resolveRelation(ir, relationName);
+    const q = (name) => quoteIdentifier(dialect, name);
+    const targetIr = schemas.find(schema => schema.table === rel.targetTable);
+    const sourceTable = ir.physicalTable;
+    const targetTable = targetIr?.physicalTable ?? rel.targetTable;
+    const physicalColumn = (schema, declared) => {
+        if (schema === undefined)
+            return declared;
+        const separator = declared.lastIndexOf('.');
+        const property = separator === -1 ? declared : declared.slice(separator + 1);
+        const physical = schema.columns.find(column => column.name === property)?.physicalName;
+        if (physical === undefined)
+            return declared;
+        if (separator === -1)
+            return physical;
+        const qualifier = declared.slice(0, separator);
+        return `${qualifier === schema.table ? schema.physicalTable : qualifier}.${physical}`;
+    };
+    const parentKeys = rel.parentKey.map(column => physicalColumn(ir, column));
+    const targetKeys = rel.targetKey.map(column => physicalColumn(targetIr, column));
+    const physicalFilters = targetFilters.map(predicate => ({
+        ...predicate,
+        col: physicalColumn(targetIr, predicate.col),
+    }));
+    const renderFilters = (parameters) => {
+        if (physicalFilters.length === 0)
+            return '';
+        const body = physicalFilters
+            .map((predicate, index) => {
+            const rendered = renderPredicate(dialect, predicate, parameters);
+            return index === 0 ? rendered : `${predicate.connector ?? 'AND'} ${rendered}`;
+        })
+            .join(' ');
+        const grouped = targetFilters.some((predicate, index) => index > 0 && predicate.connector === 'OR');
+        return `AND ${grouped ? `(${body})` : body}`;
+    };
+    if (!rel.toMany) {
+        const parameters = [];
+        const filtered = physicalFilters.length > 0;
+        const onFilters = renderFilters(parameters);
+        const conditions = parentKeys.map((parentKey, index) => {
+            const targetKey = targetKeys[index];
+            if (targetKey === undefined) {
+                throw new Error(`${ir.table}.${relationName}: resolved relation keys have different lengths`);
+            }
+            return `${q(sourceTable)}.${q(parentKey)} = ${q(targetTable)}.${q(targetKey)}`;
+        });
+        const sql = `SELECT * FROM ${q(sourceTable)} ${filtered ? 'LEFT' : 'INNER'} JOIN ${q(targetTable)} ` +
+            `ON ${conditions.join(' AND ')}` +
+            (onFilters.length === 0 ? '' : ` ${onFilters}`);
+        return { kind: 'join', sql, parameters };
+    }
+    if (parentIds.length === 0) {
+        return { kind: 'batched', sql: `SELECT * FROM ${q(targetTable)} WHERE 1 = 0`, parameters: [] };
+    }
+    if (targetKeys.length === 1) {
+        const sanitized = sanitizeKeys(parentIds);
+        if (sanitized.length === 0) {
+            return { kind: 'batched', sql: `SELECT * FROM ${q(targetTable)} WHERE 1 = 0`, parameters: [] };
+        }
+        const [targetKey] = targetKeys;
+        if (targetKey === undefined) {
+            throw new Error(`${ir.table}.${relationName}: resolved relation has no target key`);
+        }
+        const inList = sanitized.map((_, i) => formatPlaceholder(dialect, i + 1)).join(', ');
+        const parameters = [...sanitized];
+        const filters = renderFilters(parameters);
+        const sql = `SELECT * FROM ${q(targetTable)} WHERE ${q(targetKey)} IN (${inList})` +
+            (filters.length === 0 ? '' : ` ${filters}`);
+        return { kind: 'batched', sql, parameters };
+    }
+    if (!dialectTraits(dialect).rowValueIn) {
+        const name = dialectName(dialect);
+        throw new UnsupportedFeatureError(`composite-key populate for relation "${relationName}"`, name, `${ir.table}.${relationName}: dialect "${name}" does not support row-value IN for a composite-key populate`);
+    }
+    const sanitized = sanitizeCompositeKeys(ir, relationName, parentIds, targetKeys.length);
+    if (sanitized.length === 0) {
+        return { kind: 'batched', sql: `SELECT * FROM ${q(targetTable)} WHERE 1 = 0`, parameters: [] };
+    }
+    const parameters = [];
+    const inList = sanitized
+        .map(tuple => {
+        const placeholders = tuple.map(value => {
+            parameters.push(value);
+            return formatPlaceholder(dialect, parameters.length);
+        });
+        return `(${placeholders.join(', ')})`;
+    })
+        .join(', ');
+    const columns = targetKeys.map(targetKey => q(targetKey)).join(', ');
+    const filters = renderFilters(parameters);
+    const sql = `SELECT * FROM ${q(targetTable)} WHERE (${columns}) IN (${inList})` + (filters.length === 0 ? '' : ` ${filters}`);
+    return { kind: 'batched', sql, parameters };
+}
+/**
+ * Attach a populated relation to a parent row, without mutating it.
+ *
+ * The type widening is `Populated<T, K>` in `../derive/query.ts`, which reads the declared
+ * relation property; this only puts the value there.
+ */
+export function attachPopulated(parent, name, value) {
+    // boundary: a computed key in an object literal widens to `string`, so TS types
+    // this spread as `P & { [x: string]: V }`. `name` is the literal `N` at the call
+    // site, which is what the return type states.
+    return { ...parent, [name]: value };
+}
+/** Rename aliased columns per a { alias: outKey } map (stable, non-mutating). */
+export function aliasRow(row, map) {
+    const out = { ...row };
+    for (const [alias, outKey] of Object.entries(map)) {
+        if (alias in out) {
+            out[outKey] = out[alias];
+            delete out[alias]; // rename: drop the original aliased key
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/relations/index.js.map

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

package/dist/replicas/index.d.ts

@@ -0,0 +1,10 @@
+import { type Driver } from '../index.js';
+export interface ReplicaOptions {
+    primary: Driver;
+    replicas: readonly Driver[];
+    pick?: (replicas: readonly Driver[], nextIndex: number) => Driver;
+}
+export declare function isWrite(sql: string): boolean;
+/** Wrap primary+replicas into a single Driver that routes reads to replicas. */
+export declare function withReplicas(opts: ReplicaOptions): Driver;
+//# sourceMappingURL=index.d.ts.map

package/dist/replicas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/replicas/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACnE;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG5C;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAiCzD"}

package/dist/replicas/index.js

@@ -0,0 +1,42 @@
+import {} from '@zmdb/sql';
+// Read-replica routing — see ./SPEC.md.
+import {} from '../index.js';
+export function isWrite(sql) {
+    const s = sql.trimStart().toUpperCase();
+    return s.startsWith('INSERT') || s.startsWith('UPDATE') || s.startsWith('DELETE');
+}
+/** Wrap primary+replicas into a single Driver that routes reads to replicas. */
+export function withReplicas(opts) {
+    const { primary, replicas } = opts;
+    let rr = 0;
+    const pick = (query) => {
+        if (isWrite(query.text) || replicas.length === 0)
+            return primary;
+        const driver = opts.pick ? opts.pick(replicas, rr) : replicas[rr % replicas.length];
+        rr = (rr + 1) % replicas.length;
+        // `replicas` is non-empty here (checked above), so the modulo index always
+        // hits — but a custom `pick` is caller code, so fall back to the primary
+        // rather than crashing on a bad index.
+        return driver ?? primary;
+    };
+    const canStream = typeof primary.stream === 'function' && replicas.every(driver => typeof driver.stream === 'function');
+    return {
+        dialect: primary.dialect,
+        execute(query, executeOpts) {
+            return pick(query).execute(query, executeOpts);
+        },
+        ...(canStream
+            ? {
+                stream(query, executeOpts) {
+                    const driver = pick(query);
+                    const stream = driver.stream;
+                    if (typeof stream !== 'function') {
+                        throw new Error('replica routing selected a driver without stream support');
+                    }
+                    return stream.call(driver, query, executeOpts);
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/replicas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/replicas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,WAAW,CAAC;AAE/C,wCAAwC;AACxC,OAAO,EAAe,MAAM,aAAa,CAAC;AAQ1C,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,MAAM,CAAC,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACpF,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,IAAoB;IAC/C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACnC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,MAAM,IAAI,GAAG,CAAC,KAAoB,EAAU,EAAE;QAC5C,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpF,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;QAChC,2EAA2E;QAC3E,yEAAyE;QACzE,uCAAuC;QACvC,OAAO,MAAM,IAAI,OAAO,CAAC;IAC3B,CAAC,CAAC;IAEF,MAAM,SAAS,GACb,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IACxG,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,CAAC,KAAK,EAAE,WAAW;YACxB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACjD,CAAC;QACD,GAAG,CAAC,SAAS;YACX,CAAC,CAAC;gBACE,MAAM,CAAC,KAAoB,EAAE,WAA0D;oBACrF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;oBAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;oBAC7B,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;wBACjC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;oBAC9E,CAAC;oBACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;gBACjD,CAAC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

package/dist/seeding/index.d.ts

@@ -0,0 +1,18 @@
+import { type CreateDTO, type DeclaredTable, type TaggedSchema } from '@zmdb/schema';
+/** Deterministic PRNG (mulberry32). Same seed ⇒ same sequence. */
+export declare function makeRng(seed: number): () => number;
+export interface SeedOptions {
+    seed?: number;
+    count: number;
+}
+/**
+ * `count` rows shaped like `T`'s create DTO, reproducible from `seed`.
+ *
+ * Typed as `CreateDTO<T>[]`, which the column-map version could not be: it built its rows
+ * from the lossy projection and had no way to tell the compiler what it had made. `random`'s
+ * type parameter is inferred from the return type here, so there is no assertion — and no
+ * type argument either, which is what keeps the transformer out of a call whose shape is only
+ * known at runtime.
+ */
+export declare function seedRows<T extends DeclaredTable>(schema: TaggedSchema<T>, opts: SeedOptions): CreateDTO<T>[];
+//# sourceMappingURL=index.d.ts.map

package/dist/seeding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seeding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AA2BrF,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CASlD;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAcD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAM5G"}

package/dist/seeding/index.js

@@ -0,0 +1,66 @@
+import {} from '@zmdb/schema';
+import { objectTypeFromIR } from '@zmdb/schema/ir';
+// Deterministic seeding — see ./SPEC.md.
+//
+// This module used to live in `@zmdb/schema/seeding` and generate its values from a
+// walk of its own over `schema.columns`: a `switch` on `col.type` returning a random number
+// for an integer, a random `s…` for anything string-ish, and a member of `flags.enum` for an
+// enum. It was the fifth walker over column metadata, and it had the failure mode all five
+// shared — it read part of what a column says. `Min<18>`, `Max<120>`, `Pattern<…>`,
+// `MinLength`, a `json` payload shape and nullability were all invisible to it, so seeding a
+// table with any of them produced rows the table's own validator rejects.
+//
+// It generates from the IR now, through the same sampler `random<T>()` uses, which reads the
+// whole vocabulary and *refuses* what it cannot satisfy rather than guessing. Two
+// consequences worth stating, because both are visible to a caller:
+//
+//   - The rows honour the constraints. A `Min<18>` column is seeded within its bounds.
+//   - A `Pattern<…>` column is refused, with the column named. Nothing inverts a regular
+//     expression, so the alternative is a value that violates the pattern — which is what
+//     used to happen, silently, and surfaced later as a validation failure in a test whose
+//     subject was something else.
+//
+// Seeding lives in ORM because its sampler ships in `@zmdb/validator`, which
+// depends on `@zmdb/schema/ir`. The dependencies point inward from ORM. That is also the honest home: a seeded row exists to be handed to
+// `repository.create`, and now it type-checks as one.
+import { random } from '@zmdb/validator';
+/** Deterministic PRNG (mulberry32). Same seed ⇒ same sequence. */
+export function makeRng(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a |= 0;
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/**
+ * The create shape with its optional properties dropped — the columns a caller *must* supply.
+ *
+ * The sampler fills every property of an object it is given, including the optional ones, and
+ * that is right for `random<T>()`: a sample of a type is a value of that type. It is wrong
+ * here. A column is optional in `CreateDTO` because the database has a default for it, and
+ * seeding a value over the default is how a seeded row stops resembling an inserted one.
+ */
+function requiredColumns(shape) {
+    return { ...shape, properties: shape.properties.filter(property => !property.optional) };
+}
+/**
+ * `count` rows shaped like `T`'s create DTO, reproducible from `seed`.
+ *
+ * Typed as `CreateDTO<T>[]`, which the column-map version could not be: it built its rows
+ * from the lossy projection and had no way to tell the compiler what it had made. `random`'s
+ * type parameter is inferred from the return type here, so there is no assertion — and no
+ * type argument either, which is what keeps the transformer out of a call whose shape is only
+ * known at runtime.
+ */
+export function seedRows(schema, opts) {
+    const rng = makeRng(opts.seed ?? 1);
+    const shape = requiredColumns(objectTypeFromIR(schema.ir, 'create'));
+    const rows = [];
+    for (let i = 0; i < opts.count; i++)
+        rows.push(random(shape, rng));
+    return rows;
+}
+//# sourceMappingURL=index.js.map

package/dist/seeding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seeding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyD,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAiB,MAAM,iBAAiB,CAAC;AAClE,yCAAyC;AACzC,EAAE;AACF,oFAAoF;AACpF,4FAA4F;AAC5F,6FAA6F;AAC7F,2FAA2F;AAC3F,oFAAoF;AACpF,6FAA6F;AAC7F,0EAA0E;AAC1E,EAAE;AACF,6FAA6F;AAC7F,kFAAkF;AAClF,oEAAoE;AACpE,EAAE;AACF,uFAAuF;AACvF,yFAAyF;AACzF,0FAA0F;AAC1F,2FAA2F;AAC3F,kCAAkC;AAClC,EAAE;AACF,6EAA6E;AAC7E,0IAA0I;AAC1I,sDAAsD;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,kEAAkE;AAClE,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACnB,OAAO,GAAG,EAAE;QACV,CAAC,IAAI,CAAC,CAAC;QACP,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAOD;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,KAAe;IACtC,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAA0B,MAAuB,EAAE,IAAiB;IAC1F,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,eAAe,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrE,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/streaming/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Add repository ergonomics around a driver's deliberately small stream
+ * surface. The driver owns its cursor; this wrapper owns single-shot use,
+ * per-row mapping, and exactly one cleanup path.
+ */
+export declare function createRepositoryStream<Raw, Row>(open: () => AsyncIterable<Raw>, map: (row: Raw) => Row, signal?: AbortSignal): AsyncIterable<Row> & AsyncDisposable;
+//# sourceMappingURL=index.d.ts.map

package/dist/streaming/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAC7C,IAAI,EAAE,MAAM,aAAa,CAAC,GAAG,CAAC,EAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,GAAG,CAAC,GAAG,eAAe,CAyDtC"}

package/dist/streaming/index.js

@@ -0,0 +1,67 @@
+/**
+ * Add repository ergonomics around a driver's deliberately small stream
+ * surface. The driver owns its cursor; this wrapper owns single-shot use,
+ * per-row mapping, and exactly one cleanup path.
+ */
+export function createRepositoryStream(open, map, signal) {
+    let started = false;
+    let disposed = false;
+    let active;
+    let closing;
+    const close = () => {
+        if (closing !== undefined)
+            return closing;
+        disposed = true;
+        const iterator = active;
+        active = undefined;
+        closing = (async () => {
+            if (iterator?.return !== undefined)
+                await iterator.return();
+        })();
+        return closing;
+    };
+    return {
+        [Symbol.asyncIterator]() {
+            if (started)
+                throw new Error('repository stream is single-shot');
+            if (disposed)
+                throw new Error('repository stream has been disposed');
+            started = true;
+            const iterate = async function* () {
+                let completed = false;
+                try {
+                    if (disposed)
+                        throw new Error('repository stream has been disposed');
+                    signal?.throwIfAborted();
+                    active = open()[Symbol.asyncIterator]();
+                    for (;;) {
+                        signal?.throwIfAborted();
+                        const iterator = active;
+                        if (iterator === undefined)
+                            return;
+                        const next = await iterator.next();
+                        if (disposed)
+                            return;
+                        signal?.throwIfAborted();
+                        if (next.done) {
+                            completed = true;
+                            active = undefined;
+                            disposed = true;
+                            return;
+                        }
+                        yield map(next.value);
+                    }
+                }
+                finally {
+                    if (!completed)
+                        await close();
+                }
+            };
+            return iterate();
+        },
+        [Symbol.asyncDispose]() {
+            return close();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/streaming/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAA8B,EAC9B,GAAsB,EACtB,MAAoB;IAEpB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,MAAsC,CAAC;IAC3C,IAAI,OAAkC,CAAC;IAEvC,MAAM,KAAK,GAAG,GAAkB,EAAE;QAChC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC;QAC1C,QAAQ,GAAG,IAAI,CAAC;QAChB,MAAM,QAAQ,GAAG,MAAM,CAAC;QACxB,MAAM,GAAG,SAAS,CAAC;QACnB,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YACpB,IAAI,QAAQ,EAAE,MAAM,KAAK,SAAS;gBAAE,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC9D,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO;QACL,CAAC,MAAM,CAAC,aAAa,CAAC;YACpB,IAAI,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACjE,IAAI,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACrE,OAAO,GAAG,IAAI,CAAC;YAEf,MAAM,OAAO,GAAG,KAAK,SAAS,CAAC;gBAC7B,IAAI,SAAS,GAAG,KAAK,CAAC;gBACtB,IAAI,CAAC;oBACH,IAAI,QAAQ;wBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;oBACrE,MAAM,EAAE,cAAc,EAAE,CAAC;oBACzB,MAAM,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;oBAExC,SAAS,CAAC;wBACR,MAAM,EAAE,cAAc,EAAE,CAAC;wBACzB,MAAM,QAAQ,GAAG,MAAM,CAAC;wBACxB,IAAI,QAAQ,KAAK,SAAS;4BAAE,OAAO;wBACnC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;wBACnC,IAAI,QAAQ;4BAAE,OAAO;wBACrB,MAAM,EAAE,cAAc,EAAE,CAAC;wBACzB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;4BACd,SAAS,GAAG,IAAI,CAAC;4BACjB,MAAM,GAAG,SAAS,CAAC;4BACnB,QAAQ,GAAG,IAAI,CAAC;4BAChB,OAAO;wBACT,CAAC;wBACD,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACxB,CAAC;gBACH,CAAC;wBAAS,CAAC;oBACT,IAAI,CAAC,SAAS;wBAAE,MAAM,KAAK,EAAE,CAAC;gBAChC,CAAC;YACH,CAAC,CAAC;YAEF,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC;QAED,CAAC,MAAM,CAAC,YAAY,CAAC;YACnB,OAAO,KAAK,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/testing/official-dialects.fixture.d.ts

@@ -0,0 +1,16 @@
+export declare const cockroachDialect: import("@zmdb/sql").SqlDialect<"cockroach">;
+export declare const mssqlDialect: import("@zmdb/sql").SqlDialect<"mssql">;
+export declare const mysqlDialect: import("@zmdb/sql").SqlDialect<"mysql">;
+export declare const postgresDialect: import("@zmdb/sql").SqlDialect<"postgres">;
+export declare const singlestoreDialect: import("@zmdb/sql").SqlDialect<"singlestore">;
+export declare const sqliteDialect: import("@zmdb/sql").SqlDialect<"sqlite">;
+export declare const officialDialects: Readonly<{
+    cockroach: import("@zmdb/sql").SqlDialect<"cockroach">;
+    mssql: import("@zmdb/sql").SqlDialect<"mssql">;
+    mysql: import("@zmdb/sql").SqlDialect<"mysql">;
+    postgres: import("@zmdb/sql").SqlDialect<"postgres">;
+    singlestore: import("@zmdb/sql").SqlDialect<"singlestore">;
+    sqlite: import("@zmdb/sql").SqlDialect<"sqlite">;
+}>;
+export type OfficialDialectName = keyof typeof officialDialects;
+//# sourceMappingURL=official-dialects.fixture.d.ts.map

package/dist/testing/official-dialects.fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-dialects.fixture.d.ts","sourceRoot":"","sources":["../../src/testing/official-dialects.fixture.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,gBAAgB,6CAAY,CAAC;AAC1C,eAAO,MAAM,YAAY,yCAAQ,CAAC;AAClC,eAAO,MAAM,YAAY,yCAAQ,CAAC;AAClC,eAAO,MAAM,eAAe,4CAAW,CAAC;AACxC,eAAO,MAAM,kBAAkB,+CAAc,CAAC;AAC9C,eAAO,MAAM,aAAa,0CAAS,CAAC;AAEpC,eAAO,MAAM,gBAAgB;;;;;;;EAO3B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,gBAAgB,CAAC"}

package/dist/testing/official-dialects.fixture.js

@@ -0,0 +1,21 @@
+import { cockroach } from '@zmdb/cockroach';
+import { mssql } from '@zmdb/mssql';
+import { mysql } from '@zmdb/mysql';
+import { postgres } from '@zmdb/postgres';
+import { singlestore } from '@zmdb/singlestore';
+import { sqlite } from '@zmdb/sqlite';
+export const cockroachDialect = cockroach;
+export const mssqlDialect = mssql;
+export const mysqlDialect = mysql;
+export const postgresDialect = postgres;
+export const singlestoreDialect = singlestore;
+export const sqliteDialect = sqlite;
+export const officialDialects = Object.freeze({
+    cockroach: cockroachDialect,
+    mssql: mssqlDialect,
+    mysql: mysqlDialect,
+    postgres: postgresDialect,
+    singlestore: singlestoreDialect,
+    sqlite: sqliteDialect,
+});
+//# sourceMappingURL=official-dialects.fixture.js.map

package/dist/testing/official-dialects.fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"official-dialects.fixture.js","sourceRoot":"","sources":["../../src/testing/official-dialects.fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAClC,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACxC,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AAEpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,gBAAgB;IAC3B,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,eAAe;IACzB,WAAW,EAAE,kBAAkB;IAC/B,MAAM,EAAE,aAAa;CACtB,CAAC,CAAC"}

package/dist/testing/repository.fixture.d.ts

@@ -0,0 +1,11 @@
+import { type ColumnIR } from '@zmdb/schema/ir';
+import { type CompiledQuery } from '@zmdb/sql';
+import { type Driver } from '../index.js';
+export declare function column(name: string, sql: ColumnIR['sql'], overrides?: Partial<ColumnIR>): ColumnIR;
+interface RecordingDriver extends Driver {
+    readonly calls: CompiledQuery[];
+}
+type DriverAnswer = (query: CompiledQuery, call: number) => readonly Record<string, unknown>[] | Promise<readonly Record<string, unknown>[]>;
+export declare function recordingDriver(answer: DriverAnswer): RecordingDriver;
+export {};
+//# sourceMappingURL=repository.fixture.d.ts.map

package/dist/testing/repository.fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.fixture.d.ts","sourceRoot":"","sources":["../../src/testing/repository.fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,QAAQ,CAetG;AAED,UAAU,eAAgB,SAAQ,MAAM;IACtC,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC;CACjC;AAED,KAAK,YAAY,GAAG,CAClB,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,KACT,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;AAEtF,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAWrE"}

package/dist/testing/repository.fixture.js

@@ -0,0 +1,33 @@
+import {} from '@zmdb/schema/ir';
+import {} from '@zmdb/sql';
+import {} from '../index.js';
+import { postgresDialect } from './official-dialects.fixture.js';
+export function column(name, sql, overrides = {}) {
+    return {
+        name,
+        physicalName: name,
+        sql,
+        nullable: false,
+        primaryKey: false,
+        serial: false,
+        unique: false,
+        hasDefault: false,
+        sensitive: false,
+        constraints: {},
+        rules: [],
+        ...overrides,
+    };
+}
+export function recordingDriver(answer) {
+    const calls = [];
+    return {
+        dialect: postgresDialect,
+        calls,
+        async execute(query) {
+            const call = calls.length;
+            calls.push(query);
+            return answer(query, call);
+        },
+    };
+}
+//# sourceMappingURL=repository.fixture.js.map

package/dist/testing/repository.fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.fixture.js","sourceRoot":"","sources":["../../src/testing/repository.fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAsB,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAe,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,GAAoB,EAAE,SAAS,GAAsB,EAAE;IAC1F,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,IAAI;QAClB,GAAG;QACH,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,EAAE;QACT,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAWD,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,KAAK;QACL,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/transactions/index.d.ts

@@ -0,0 +1,40 @@
+import { type CompiledQuery, type DialectTarget } from '@zmdb/sql';
+import { type ExecuteOptions } from '../index.js';
+export type TransactionState = 'active' | 'closed' | 'committed' | 'rolled_back' | string;
+export interface TransactionContext<State extends string = 'active'> {
+    readonly _state?: State | undefined;
+    readonly dialect?: DialectTarget;
+    execute(query: CompiledQuery, opts?: ExecuteOptions): Promise<readonly Record<string, unknown>[]>;
+    stream?(query: CompiledQuery, opts?: ExecuteOptions): AsyncIterable<Record<string, unknown>>;
+    savepoint<R>(fn: (tx: TransactionContext<State>) => Promise<R>): Promise<R>;
+}
+export type ActiveTransactionContext = TransactionContext<'active'>;
+export type ClosedTransactionContext = TransactionContext<'closed'>;
+export declare function markTransactionClosed<State extends string = 'active'>(tx: TransactionContext<State>): ClosedTransactionContext;
+export interface TxConnection {
+    readonly dialect?: DialectTarget;
+    raw(sql: string): Promise<void>;
+    execute(query: CompiledQuery, opts?: ExecuteOptions): Promise<readonly Record<string, unknown>[]>;
+    stream?(query: CompiledQuery, opts?: ExecuteOptions): AsyncIterable<Record<string, unknown>>;
+}
+export interface TransactionalDb {
+    transaction<R, State extends string = 'active'>(fn: (tx: TransactionContext<State>) => Promise<R>, options?: TransactionOptions): Promise<R>;
+}
+export interface TransactionRetryPolicy {
+    /** Retries after the first failed attempt. The transaction body may run `maxRetries + 1` times. */
+    readonly maxRetries: number;
+    /** Exponential-backoff starting delay. Defaults to 10 ms. */
+    readonly baseDelayMs?: number;
+    /** Backoff ceiling. Defaults to 1,000 ms. */
+    readonly maxDelayMs?: number;
+}
+export interface TransactionOptions {
+    /**
+     * Explicit opt-in only: retrying re-runs the callback, including any side effects
+     * outside the database. Keep those effects out of a retrying transaction body.
+     */
+    readonly retry?: TransactionRetryPolicy;
+}
+export declare function createTransactionalDb(conn: TxConnection): TransactionalDb;
+export declare function batch<R, State extends string = 'active'>(db: TransactionalDb, ops: readonly ((tx: TransactionContext<State>) => Promise<R>)[]): Promise<R[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/transactions/index.d.ts.map

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