@zmdb/orm 1.0.0-beta.1

package/README.md

@@ -0,0 +1,30 @@
+# @zmdb/orm
+
+`@zmdb/orm` provides typed CRUD over a zmdb schema. It includes transactions, relation loading, read replicas, result caching, streaming, seeding, lifecycle hooks, and a transactional outbox. Rows
+stay plain objects; there are no proxies or identity map.
+
+Every driver declares an imported `SqlDialect` object. Repositories derive compilation, parameter limits, retry codes, and returning behavior from that same injected object.
+
+It is part of [zmdb](https://github.com/ambasta/zmdb), where one TypeScript schema drives validation, serialization, SQL, OpenAPI, and CRUD.
+
+## Install
+
+```bash
+yarn add @zmdb/orm@1.0.0-beta.1
+```
+
+> **Prerelease** (`1.0.0-beta.1`). Requires **Node.js 26+** and is **ESM-only**. Ships built ESM `.js` + `.d.ts` under `./dist`.
+
+## Entry points
+
+- Repository APIs: `@zmdb/orm`
+- Application features: `/dto`, `/relations`, `/outbox`, `/seeding`, `/transactions`, `/replicas`, `/entity-modeling`
+- Complete database verticals: `@zmdb/sqlite`, `@zmdb/postgres`, `@zmdb/mysql`, `@zmdb/mssql`, `@zmdb/cockroach`, `@zmdb/singlestore`
+
+## Documentation
+
+Full docs: **https://ambasta.github.io/zmdb/**
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later) — see [LICENSE](./LICENSE).

package/dist/cache/index.d.ts

@@ -0,0 +1,34 @@
+import { type SchemaIR } from '@zmdb/schema/ir';
+import { type CompiledQuery, type DialectTarget } from '@zmdb/sql';
+export interface CacheStore {
+    get(key: string): Promise<unknown | undefined>;
+    set(key: string, value: unknown, ttlMs: number, tags: readonly string[]): Promise<void>;
+    invalidateTags(tags: readonly string[]): Promise<void>;
+}
+export interface CacheOptions {
+    readonly ttlMs: number;
+    readonly tags?: readonly string[];
+}
+export interface CacheInvalidationOptions {
+    readonly invalidateTags?: readonly string[];
+}
+/**
+ * A process-local TTL store with bounded least-recently-used eviction.
+ *
+ * The default is deliberately finite. Expired entries are removed on access;
+ * writes evict the oldest live-or-expired entry until the bound is restored.
+ */
+export declare function memoryStore(options?: {
+    readonly maxEntries?: number;
+}): CacheStore;
+export declare function resultCacheKey(input: {
+    readonly dialect: DialectTarget;
+    readonly schema: SchemaIR;
+    readonly table: string;
+    readonly filters?: readonly string[];
+    readonly query: CompiledQuery;
+}): string;
+export declare function cacheTags(table: string, callerTags?: readonly string[]): readonly string[];
+/** Fresh row and array identities without the cost or promise of a deep clone. */
+export declare function copyCachedRows(value: unknown): unknown;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAwBD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAyClF;AAyED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B,GAAG,MAAM,CAUT;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,MAAM,EAAO,GAAG,SAAS,MAAM,EAAE,CAE9F;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGtD"}

package/dist/cache/index.js

@@ -0,0 +1,149 @@
+import { isRecord } from '@zmdb/schema';
+import {} from '@zmdb/schema/ir';
+import { dialectName } from '@zmdb/sql';
+const DEFAULT_MAX_ENTRIES = 1_000;
+function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new RangeError(`${name} must be a positive safe integer`);
+    }
+    return value;
+}
+function positiveDuration(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new RangeError('cache ttlMs must be a positive finite number');
+    }
+    return value;
+}
+/**
+ * A process-local TTL store with bounded least-recently-used eviction.
+ *
+ * The default is deliberately finite. Expired entries are removed on access;
+ * writes evict the oldest live-or-expired entry until the bound is restored.
+ */
+export function memoryStore(options) {
+    const maxEntries = positiveInteger(options?.maxEntries ?? DEFAULT_MAX_ENTRIES, 'cache maxEntries');
+    const entries = new Map();
+    return {
+        async get(key) {
+            const entry = entries.get(key);
+            if (entry === undefined)
+                return undefined;
+            if (entry.expiresAt <= Date.now()) {
+                entries.delete(key);
+                return undefined;
+            }
+            entries.delete(key);
+            entries.set(key, entry);
+            return entry.value;
+        },
+        async set(key, value, ttlMs, tags) {
+            entries.delete(key);
+            entries.set(key, {
+                value,
+                expiresAt: Date.now() + positiveDuration(ttlMs),
+                tags: [...tags],
+            });
+            while (entries.size > maxEntries) {
+                const oldest = entries.keys().next().value;
+                if (oldest === undefined)
+                    break;
+                entries.delete(oldest);
+            }
+        },
+        async invalidateTags(tags) {
+            if (tags.length === 0)
+                return;
+            const invalidated = new Set(tags);
+            for (const [key, entry] of entries) {
+                if (entry.tags.some(tag => invalidated.has(tag)))
+                    entries.delete(key);
+            }
+        },
+    };
+}
+function frame(tag, payload = '') {
+    return `${tag}:${String(payload.length)}:${payload}`;
+}
+function binary(kind, value) {
+    const encoded = [...value].map(byte => byte.toString(16).padStart(2, '0')).join('');
+    return frame('x', frame('t', kind) + frame('v', encoded));
+}
+function taggedValue(value, ancestors) {
+    if (value === null)
+        return frame('z');
+    if (value === undefined)
+        return frame('u');
+    if (typeof value === 'string')
+        return frame('s', value);
+    if (typeof value === 'number')
+        return frame('n', String(value));
+    if (typeof value === 'bigint')
+        return frame('i', String(value));
+    if (typeof value === 'boolean')
+        return frame('b', String(value));
+    if (typeof value === 'symbol' || typeof value === 'function') {
+        throw new TypeError(`cache keys cannot contain ${typeof value} values`);
+    }
+    if (value instanceof Date)
+        return frame('d', String(value.getTime()));
+    if (value instanceof ArrayBuffer)
+        return binary('ArrayBuffer', new Uint8Array(value));
+    if (ArrayBuffer.isView(value)) {
+        return binary(Object.prototype.toString.call(value), new Uint8Array(value.buffer, value.byteOffset, value.byteLength));
+    }
+    if (ancestors.has(value))
+        throw new TypeError('cache keys cannot contain cyclic values');
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return frame('a', value.map(item => frame('e', taggedValue(item, ancestors))).join(''));
+        }
+        if (value instanceof Map) {
+            const pairs = [...value].map(([key, item]) => frame('k', taggedValue(key, ancestors)) + frame('v', taggedValue(item, ancestors)));
+            return frame('m', pairs.toSorted().join(''));
+        }
+        if (value instanceof Set) {
+            return frame('q', [...value]
+                .map(item => taggedValue(item, ancestors))
+                .toSorted()
+                .map(item => frame('e', item))
+                .join(''));
+        }
+        const kind = Object.prototype.toString.call(value);
+        const properties = Object.keys(value)
+            .toSorted()
+            .map(key => frame('k', taggedValue(key, ancestors)) + frame('v', taggedValue(Reflect.get(value, key), ancestors)))
+            .join('');
+        return frame('o', frame('t', kind) + properties);
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+function stableValue(value) {
+    return taggedValue(value, new Set());
+}
+function segment(name, value) {
+    return frame(name, stableValue(value));
+}
+export function resultCacheKey(input) {
+    return [
+        'z1',
+        segment('dialect', dialectName(input.dialect)),
+        segment('fingerprint', input.schema),
+        segment('table', input.table),
+        segment('filters', input.filters ?? []),
+        segment('text', input.query.text),
+        segment('params', input.query.parameters),
+    ].join('|');
+}
+export function cacheTags(table, callerTags = []) {
+    return [...new Set([`table:${table}`, ...callerTags])];
+}
+/** Fresh row and array identities without the cost or promise of a deep clone. */
+export function copyCachedRows(value) {
+    if (!Array.isArray(value))
+        return value;
+    return value.map(row => (isRecord(row) ? { ...row } : row));
+}
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

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

package/dist/drivers/transactional.d.ts

@@ -0,0 +1,6 @@
+import { type Driver } from '../index.js';
+/** A driver that can pin every query in a callback to one database transaction. */
+export interface TransactionalDriver extends Driver {
+    transaction<Result>(run: (driver: Driver) => Promise<Result>): Promise<Result>;
+}
+//# sourceMappingURL=transactional.d.ts.map

package/dist/drivers/transactional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.d.ts","sourceRoot":"","sources":["../../src/drivers/transactional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,mFAAmF;AACnF,MAAM,WAAW,mBAAoB,SAAQ,MAAM;IACjD,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChF"}

package/dist/drivers/transactional.js

@@ -0,0 +1,2 @@
+import {} from '../index.js';
+//# sourceMappingURL=transactional.js.map

package/dist/drivers/transactional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.js","sourceRoot":"","sources":["../../src/drivers/transactional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,MAAM,aAAa,CAAC"}

package/dist/dto/index.d.ts

@@ -0,0 +1,41 @@
+import { type DeclaredTable } from '@zmdb/schema';
+import type { WhereDTO, UnknownRow, OrderDir, OrderBySpec, PaginationSpec } from '@zmdb/schema/dto';
+import { type ComparisonPredicate } from '@zmdb/sql';
+/**
+ * Minimal structural view of the query-compiler SelectBuilder we drive.
+ *
+ * The methods return `this` (not `WhereTarget`), so folding a DTO into a builder
+ * preserves the caller's concrete builder type. That is what lets `compileWhere`
+ * return `B` without asserting: previously the chain widened to `WhereTarget` and
+ * every helper ended in `return b as B`.
+ */
+export interface WhereTarget {
+    where(col: string, op: string, value: unknown): this;
+    orWhere(col: string, op: string, value: unknown): this;
+    whereGroup?(predicates: readonly ComparisonPredicate[]): this;
+    orWhereGroup?(predicates: readonly ComparisonPredicate[]): this;
+    whereExists?(subquery: unknown): this;
+    orWhereExists?(subquery: unknown): this;
+    whereNotExists?(subquery: unknown): this;
+    orWhereNotExists?(subquery: unknown): this;
+    whereIn?(col: string, values: readonly unknown[]): this;
+    orWhereIn?(col: string, values: readonly unknown[]): this;
+    whereNotIn?(col: string, values: readonly unknown[]): this;
+    orWhereNotIn?(col: string, values: readonly unknown[]): this;
+}
+/**
+ * Fold a WhereDTO into a query-compiler builder. Bare values become `eq`.
+ * Fields/operators are applied in stable object-key order (golden SQL).
+ * `and`/`or` groups compose; `or` members are ORed.
+ */
+export declare function compileWhere<T extends DeclaredTable, B extends WhereTarget>(builder: B, where: WhereDTO<T> | undefined, resolveColumn?: (column: string) => string): B;
+/** Like {@link WhereTarget}: `this`-returning so folding preserves the builder type. */
+export interface OrderTarget {
+    orderBy(col: string, dir: OrderDir): this;
+    limit(n: number): this;
+    offset(n: number): this;
+}
+export declare function applyOrderBy<B extends OrderTarget>(builder: B, order: OrderBySpec | undefined, pkColumn?: string, resolveColumn?: (column: string) => string): B;
+export declare function applyKeysetFilter<B extends WhereTarget>(builder: B, cursorValues: Record<string, unknown>, orderBy: OrderBySpec, userWhere?: WhereDTO<UnknownRow>, additionalWhere?: (builder: WhereTarget) => void, resolveColumn?: (column: string) => string): B;
+export declare function applyPagination<B extends OrderTarget>(builder: B, page: PaginationSpec | undefined): B;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dto/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAuB,KAAK,mBAAmB,EAAmB,MAAM,WAAW,CAAC;AAG3F;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACrD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvD,UAAU,CAAC,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI,CAAC;IAC9D,YAAY,CAAC,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI,CAAC;IAChE,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,aAAa,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,cAAc,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;IACxD,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1D,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;IAC3D,YAAY,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;CAC9D;AA0ED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,WAAW,EACzE,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,EAC9B,aAAa,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAyB,GAC3D,CAAC,CAkJH;AAED,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAChD,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,WAAW,GAAG,SAAS,EAC9B,QAAQ,CAAC,EAAE,MAAM,EACjB,aAAa,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAyB,GAC3D,CAAC,CAUH;AA2CD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EACrD,OAAO,EAAE,CAAC,EACV,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,EAChC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,EAChD,aAAa,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAyB,GAC3D,CAAC,CA0CH;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,CAAC,CAKtG"}

package/dist/dto/index.js

@@ -0,0 +1,334 @@
+import { isRecord } from '@zmdb/schema';
+import { createQueryCompiler } from '@zmdb/sql';
+import { ValidationError } from '@zmdb/validator';
+/**
+ * Record view of a value, or `undefined` if it is not a plain object.
+ *
+ * Taking `unknown` is deliberate: narrowing a *generic* DTO (`WhereDTO<T>`) in
+ * place leaves the mapped type, which has no string index signature, so keyed
+ * reads would need `as Record<string, unknown>`. Routing through `unknown` lets
+ * the guard do the widening instead of an assertion.
+ */
+function asRecord(value) {
+    return isRecord(value) ? value : undefined;
+}
+const OP_SQL = {
+    eq: '=',
+    ne: '!=',
+    lt: '<',
+    lte: '<=',
+    gt: '>',
+    gte: '>=',
+    in: 'in',
+    nin: 'not in',
+    like: 'like',
+    ilike: 'ilike',
+    l2: 'l2',
+    cosine: 'cosine',
+    ip: 'ip',
+};
+// Every operator `applyField` accepts, for the error an unrecognised one raises.
+// `isNull`/`notNull` are handled ahead of the map, so they are not keys of it.
+const KNOWN_OPERATORS = [...Object.keys(OP_SQL), 'isNull', 'notNull'];
+/**
+ * A `{ table, select?, where? }` literal in a DTO, compiled into a subquery builder.
+ *
+ * boundary: the input is `unknown` because a DTO arrives from outside the process, and what
+ * establishes the shape is the `in` checks in the `if`, not the two casts. The first reads
+ * the one property those checks have just proven is a string; the second names the rest of
+ * the shape, and each optional field is tested again before it is used — `select` for a
+ * non-zero length, `where` for presence — so the only thing a wrong payload can produce is
+ * a narrower subquery, never a call with a value of the wrong kind in it.
+ */
+function resolveSubqueryTarget(target, dialect) {
+    if (target !== null &&
+        typeof target === 'object' &&
+        !('compile' in target) &&
+        'table' in target &&
+        typeof target.table === 'string') {
+        const spec = target;
+        if (dialect === undefined) {
+            throw new ValidationError('compileWhere: a table subquery requires the builder dialect object');
+        }
+        // Both clauses, not either: `{ table, select, where }` means a projection *and* a
+        // filter, and a subquery that dropped the filter would match every row.
+        let sub = createQueryCompiler(dialect).selectFrom(spec.table);
+        if (spec.select && spec.select.length > 0) {
+            sub = sub.select(spec.select);
+        }
+        if (spec.where) {
+            sub = compileWhere(sub, spec.where);
+        }
+        return sub;
+    }
+    return target;
+}
+/**
+ * Fold a WhereDTO into a query-compiler builder. Bare values become `eq`.
+ * Fields/operators are applied in stable object-key order (golden SQL).
+ * `and`/`or` groups compose; `or` members are ORed.
+ */
+export function compileWhere(builder, where, resolveColumn = column => column) {
+    if (!where)
+        return builder;
+    let b = builder;
+    // boundary: `WhereTarget` is the structural minimum this function calls — `where`, `and`,
+    // `or` — and deliberately does not require a `dialect`, so that a caller's own builder
+    // qualifies. Reading one off it is therefore a probe for an optional property rather than
+    // a claim about the type, and the `??` is what handles the builder that has none.
+    const dialect = builder.dialect;
+    const applyField = (col, spec, connector) => {
+        const resolvedColumn = resolveColumn(col);
+        const add = (op, rawVal) => {
+            const value = resolveSubqueryTarget(rawVal, dialect);
+            if (connector === 'or') {
+                b = b.orWhere(resolvedColumn, op, value);
+            }
+            else {
+                b = b.where(resolvedColumn, op, value);
+            }
+        };
+        if (spec !== null &&
+            typeof spec === 'object' &&
+            !Array.isArray(spec) &&
+            !('compile' in spec) &&
+            !('table' in spec)) {
+            const ops = asRecord(spec);
+            if (ops) {
+                if (Object.keys(ops).length === 0) {
+                    // `FieldOps`' keys are all optional, so `{ age: {} }` is type-legal, and it is
+                    // what building a filter conditionally produces: `{ age: min === undefined ? {}
+                    // : { gte: min } }`. Folding it to nothing means the query looks filtered and is
+                    // not — over-disclosure on a SELECT, the whole table on an UPDATE or DELETE. An
+                    // empty operator map is not a filter, and "match everything" is the least likely
+                    // thing the caller meant (#608).
+                    throw new ValidationError(`compileWhere: column "${col}" has an empty operator map, which would match every row`, [{ path: col, message: 'empty operator map', expected: KNOWN_OPERATORS.join(' | ') }]);
+                }
+                for (const [op, value] of Object.entries(ops)) {
+                    if (op === 'isNull') {
+                        if (value)
+                            add('is null', null);
+                        else
+                            add('is not null', null);
+                    }
+                    else if (op === 'notNull') {
+                        add(value ? 'is not null' : 'is null', null);
+                    }
+                    else if (op === 'in' && Array.isArray(value)) {
+                        if (connector === 'or' && b.orWhereIn)
+                            b = b.orWhereIn(resolvedColumn, value);
+                        else if (connector !== 'or' && b.whereIn)
+                            b = b.whereIn(resolvedColumn, value);
+                        else
+                            add('in', value);
+                    }
+                    else if (op === 'nin' && Array.isArray(value)) {
+                        if (connector === 'or' && b.orWhereNotIn)
+                            b = b.orWhereNotIn(resolvedColumn, value);
+                        else if (connector !== 'or' && b.whereNotIn)
+                            b = b.whereNotIn(resolvedColumn, value);
+                        else
+                            add('not in', value);
+                    }
+                    else {
+                        // `Object.hasOwn`, not a truthy read: `OP_SQL` is an object literal, so an
+                        // operator named `toString`, `constructor`, `valueOf` or `__proto__` resolves
+                        // through `Object.prototype` and passes a truthiness check as a function or an
+                        // object. A where-DTO is the path user JSON takes into the builder, so those
+                        // keys arrive from outside the process (#364).
+                        const sql = Object.hasOwn(OP_SQL, op) ? OP_SQL[op] : undefined;
+                        if (sql === undefined) {
+                            // Fail closed. Skipping the key emitted a statement with one predicate
+                            // fewer than the caller wrote, which on an UPDATE or DELETE is the whole
+                            // table.
+                            throw new ValidationError(`compileWhere: unknown operator "${op}" on column "${col}"`, [
+                                {
+                                    path: col,
+                                    message: `unknown operator "${op}"`,
+                                    expected: KNOWN_OPERATORS.join(' | '),
+                                    value,
+                                },
+                            ]);
+                        }
+                        add(sql, value);
+                    }
+                }
+            }
+        }
+        else {
+            // bare value or direct subquery spec ⇒ eq
+            add('=', spec);
+        }
+    };
+    const applyExists = (spec, isNot, connector) => {
+        const items = Array.isArray(spec) ? spec : [spec];
+        for (const item of items) {
+            const resolved = resolveSubqueryTarget(item, dialect);
+            if (connector === 'or') {
+                if (isNot) {
+                    if (!b.orWhereNotExists) {
+                        throw new Error('Builder does not support orWhereNotExists');
+                    }
+                    b = b.orWhereNotExists(resolved);
+                }
+                else {
+                    if (!b.orWhereExists) {
+                        throw new Error('Builder does not support orWhereExists');
+                    }
+                    b = b.orWhereExists(resolved);
+                }
+            }
+            else {
+                if (isNot) {
+                    if (!b.whereNotExists) {
+                        throw new Error('Builder does not support whereNotExists');
+                    }
+                    b = b.whereNotExists(resolved);
+                }
+                else {
+                    if (!b.whereExists) {
+                        throw new Error('Builder does not support whereExists');
+                    }
+                    b = b.whereExists(resolved);
+                }
+            }
+        }
+    };
+    const { and, or } = where;
+    const fields = asRecord(where);
+    if (!fields)
+        return b;
+    for (const key of Object.keys(fields)) {
+        if (key === 'and') {
+            if (and)
+                for (const sub of and)
+                    b = compileWhere(b, sub, resolveColumn);
+        }
+        else if (key === 'or') {
+            for (const sub of or ?? []) {
+                const group = asRecord(sub);
+                if (group) {
+                    for (const [col, spec] of Object.entries(group)) {
+                        if (col === 'exists') {
+                            applyExists(spec, false, 'or');
+                        }
+                        else if (col === 'notExists') {
+                            applyExists(spec, true, 'or');
+                        }
+                        else {
+                            applyField(col, spec, 'or');
+                        }
+                    }
+                }
+            }
+        }
+        else if (key === 'exists') {
+            applyExists(fields[key], false, 'and');
+        }
+        else if (key === 'notExists') {
+            applyExists(fields[key], true, 'and');
+        }
+        else {
+            applyField(key, fields[key], 'and');
+        }
+    }
+    return b;
+}
+export function applyOrderBy(builder, order, pkColumn, resolveColumn = column => column) {
+    if (!order && !pkColumn)
+        return builder;
+    let b = builder;
+    const cols = order ? [...order] : [];
+    if (pkColumn && !cols.some(item => String(item.column) === pkColumn)) {
+        cols.push({ column: pkColumn, dir: 'asc' });
+    }
+    if (cols.length === 0)
+        return builder;
+    for (const { column, dir } of cols)
+        b = b.orderBy(resolveColumn(String(column)), dir ?? 'asc');
+    return b;
+}
+class BranchTarget {
+    b;
+    firstCallInBranch;
+    constructor(b, isFirstBranch) {
+        this.b = b;
+        this.firstCallInBranch = !isFirstBranch;
+    }
+    where(col, op, value) {
+        if (this.firstCallInBranch) {
+            this.firstCallInBranch = false;
+            this.b = this.b.orWhere(col, op, value);
+        }
+        else {
+            this.b = this.b.where(col, op, value);
+        }
+        return this;
+    }
+    // A keyset branch is a conjunction that is OR'd onto the branches before it,
+    // so the branch spends its OR on the first predicate and conjoins the rest.
+    // Repository filters use `whereGroup` below to preserve their own OR boundary;
+    // compileWhere's user-authored `or` tree is still flat and remains a separate
+    // predicate-tree problem.
+    orWhere(col, op, value) {
+        return this.where(col, op, value);
+    }
+    whereGroup(predicates) {
+        const method = this.firstCallInBranch ? this.b.orWhereGroup : this.b.whereGroup;
+        if (method === undefined)
+            throw new Error('keyset filters require predicate-group support');
+        this.firstCallInBranch = false;
+        this.b = method.call(this.b, predicates);
+        return this;
+    }
+    getBuilder() {
+        return this.b;
+    }
+}
+export function applyKeysetFilter(builder, cursorValues, orderBy, userWhere, additionalWhere, resolveColumn = column => column) {
+    if (orderBy.length === 0)
+        return builder;
+    for (const item of orderBy) {
+        if (!item)
+            continue;
+        const colStr = String(item.column);
+        if (cursorValues[colStr] === undefined) {
+            throw new Error(`Invalid cursor: missing value for column "${colStr}"`);
+        }
+    }
+    let currentBuilder = builder;
+    const k = orderBy.length;
+    for (let i = 0; i < k; i++) {
+        const itemI = orderBy[i];
+        if (!itemI)
+            continue;
+        const target = new BranchTarget(currentBuilder, i === 0);
+        if (userWhere) {
+            compileWhere(target, userWhere, resolveColumn);
+        }
+        additionalWhere?.(target);
+        for (let j = 0; j < i; j++) {
+            const itemJ = orderBy[j];
+            if (!itemJ)
+                continue;
+            const col = String(itemJ.column);
+            target.where(resolveColumn(col), '=', cursorValues[col]);
+        }
+        const curCol = String(itemI.column);
+        const dir = itemI.dir ?? 'asc';
+        const op = dir === 'desc' ? '<' : '>';
+        target.where(resolveColumn(curCol), op, cursorValues[curCol]);
+        currentBuilder = target.getBuilder();
+    }
+    // boundary: BranchTarget wraps B (implementing WhereTarget); getBuilder() returns the mutated query builder B.
+    return currentBuilder;
+}
+export function applyPagination(builder, page) {
+    if (!page)
+        return builder;
+    let b = builder.limit(page.limit);
+    if (typeof page.offset === 'number')
+        b = b.offset(page.offset);
+    return b;
+}
+//# sourceMappingURL=index.js.map

package/dist/dto/index.js.map

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