@vibeorm/runtime 2.0.0-alpha.1 → 2.0.0-alpha.10

package/dist/keyset-iterator.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Bounded-memory export: a sequential async iterator over keyset pages.
+ *
+ * One page is held at a time and the next one is fetched only when the
+ * consumer asks for a row the buffer cannot serve. There is no prefetch, no
+ * look-ahead and no unbounded accumulation — `pagesFetched()` is the receipt.
+ *
+ * What this deliberately is NOT:
+ *   - **not a snapshot.** No transaction is opened, so the traversal is a LIVE
+ *     view: concurrent inserts, deletes and sort-key updates change what a
+ *     later page sees. A row that moves behind the position is missed; one
+ *     that moves ahead of it is seen twice. A consistent export means running
+ *     the whole iteration inside `$transaction` at an explicit isolation
+ *     level, paying its connection and deadline cost — never a secretly
+ *     long-lived transaction.
+ *   - **not exactly-once.** `checkpoint()` records the last row the consumer
+ *     came BACK for, so a `break` or an exception leaves the in-flight row
+ *     uncheckpointed and resuming re-delivers it. At-least-once. The consumer
+ *     owns acknowledgement and de-duplication; this is not a durable job
+ *     engine.
+ *   - **not statement cancellation.** Aborting the signal stops FUTURE page
+ *     fetches. A page query already in flight keeps running: per EPIC 6 only
+ *     `adapter-pg` / `adapter-bun` can cancel a running statement, and only
+ *     inside a transaction carrying a deadline — which this iterator does not
+ *     open.
+ */
+import type { SqlDialect } from "@vibeorm/sql";
+import type { KeysetTimestampPrecision } from "./keyset.ts";
+import type { RuntimeMeta } from "./model-meta.ts";
+/** The one method this iterator needs — a model delegate satisfies it. */
+export type KeysetPageSource = {
+    readonly findMany: (args: Record<string, unknown>) => Promise<Record<string, unknown>[]>;
+};
+export type KeysetIterateOptions = {
+    readonly source: KeysetPageSource;
+    readonly meta: RuntimeMeta;
+    readonly dialect: SqlDialect;
+    readonly model: string;
+    readonly orderBy: unknown;
+    /** Bounded and required, 1…{@link KEYSET_MAX_PAGE_SIZE}. There is no unbounded default. */
+    readonly pageSize: number;
+    readonly where?: Record<string, unknown>;
+    readonly select?: Record<string, unknown>;
+    readonly omit?: Record<string, unknown>;
+    readonly include?: Record<string, unknown>;
+    /** Resume from a checkpoint minted by a previous run over the SAME ordering. */
+    readonly after?: string;
+    /** Consumer cancellation: stops future page fetches; ends iteration cleanly. */
+    readonly signal?: AbortSignal;
+    readonly timestampPrecision?: KeysetTimestampPrecision;
+};
+export type KeysetIterator = AsyncIterableIterator<Record<string, unknown>> & {
+    /** Always present: `break` and an exception both have to be able to release the traversal. */
+    readonly return: (value?: unknown) => Promise<IteratorResult<Record<string, unknown>>>;
+    readonly throw: (error?: unknown) => Promise<IteratorResult<Record<string, unknown>>>;
+    /** Token for the last SUCCESSFULLY CONSUMED row; `null` before the first one settles. */
+    readonly checkpoint: () => string | null;
+    /** Pages fetched so far — the bounded-fetch receipt. */
+    readonly pagesFetched: () => number;
+    /** True when the signal aborted the traversal. */
+    readonly cancelled: () => boolean;
+};
+/**
+ * Iterate a model in keyset order, one bounded page at a time.
+ *
+ * @example
+ * const rows = iterateKeyset({ source: db.$models.product, meta, dialect,
+ *   model: "Product", orderBy: [{ price: "asc" }, { id: "asc" }], pageSize: 500 });
+ * for await (const row of rows) { … }
+ * const resumeFrom = rows.checkpoint();
+ */
+export declare function iterateKeyset(options: KeysetIterateOptions): KeysetIterator;
+//# sourceMappingURL=keyset-iterator.d.ts.map

package/dist/keyset-iterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyset-iterator.d.ts","sourceRoot":"","sources":["../src/keyset-iterator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAS/C,OAAO,KAAK,EAAmB,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CAC1F,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;IAC5E,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACvF,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACtF,yFAAyF;IACzF,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACzC,wDAAwD;IACxD,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,CAAC;IACpC,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;CACnC,CAAC;AAuCF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,CA2I3E"}

package/dist/keyset.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Sort-aware keyset pagination — the order plan and the opaque position token.
+ *
+ * A keyset position describes ORDERING VALUES plus a unique tie-breaker, not
+ * the identity of one row: the row a token was minted from may since have been
+ * deleted or had its sort key changed, and traversal still continues from the
+ * right place. That is the whole difference from the legacy `cursor`, which
+ * addresses a row by a unique key and is left untouched by this module.
+ *
+ * Two rules this module exists to enforce:
+ *   - a position is only meaningful against ONE effective ordering, so the
+ *     token carries that ordering's signature and a mismatch is refused loudly
+ *     rather than silently paginating the wrong sequence;
+ *   - a position's values are encoded LOSSLESSLY per scalar type — never
+ *     through a float64 detour and never from a rounded display value.
+ *
+ * The token is ENCODED, not encrypted: anyone holding it can read the ordering
+ * values inside. It is also NOT an authorization credential — it selects a
+ * position, never a row; every query consuming one still compiles the caller's
+ * own `where` and keeps its `$scoped` / `$withPolicy` / RLS filters.
+ */
+import type { SqlDialect } from "@vibeorm/sql";
+import type { FieldMeta, ModelMeta } from "./model-meta.ts";
+export type KeysetDirection = "asc" | "desc";
+export type KeysetNulls = "first" | "last";
+/**
+ * The caller's assertion that every `DateTime` ordering column holds
+ * millisecond-exact values. See {@link compileKeysetOrderPlan}.
+ */
+export type KeysetTimestampPrecision = "milliseconds";
+/** One order term, already resolved by the query builder. */
+export type KeysetOrderInput = {
+    readonly field: FieldMeta;
+    readonly direction: KeysetDirection;
+    /** Resolved NULL placement: the explicit request, else the dialect's native one. */
+    readonly nulls: KeysetNulls;
+};
+/** One key of the effective keyset order. */
+export type KeysetOrderKey = {
+    readonly field: FieldMeta;
+    readonly direction: KeysetDirection;
+    readonly nulls: KeysetNulls;
+    readonly tag: KeysetValueTag;
+};
+/** The effective order a token is bound to. */
+export type KeysetOrderPlan = {
+    readonly model: string;
+    readonly keys: readonly KeysetOrderKey[];
+    /** Plain-text order signature carried inside the token. */
+    readonly signature: string;
+};
+/** Per-scalar lossless encoding tag stored in the token. */
+export type KeysetValueTag = "s" | "i" | "b" | "f" | "c" | "t" | "o" | "y";
+/** Token version. A token from another version is refused, never guessed at. */
+export declare const KEYSET_TOKEN_VERSION: number;
+/** Token prefix — `vk` for "vibe keyset", then the version. */
+export declare const KEYSET_TOKEN_PREFIX: string;
+/** Upper bound on an iterator page — memory is bounded by construction, not by hope. */
+export declare const KEYSET_MAX_PAGE_SIZE: number;
+/**
+ * Compile and VALIDATE the effective keyset order.
+ *
+ * Refuses, at build time and before any statement runs: list/Json/Bytes order
+ * keys, an order with no unique tie-breaker, and a `DateTime` key on a dialect
+ * that may store sub-millisecond values unless the caller passes
+ * `timestampPrecision: "milliseconds"` — the caller's explicit assertion that
+ * the column is millisecond-exact. That assertion is NOT safe for a
+ * `@default(now())` column on postgres, which is microsecond-precise: a
+ * truncated cursor value re-admits rows already delivered in that same
+ * millisecond, i.e. duplicates.
+ */
+export declare function compileKeysetOrderPlan(params: {
+    model: ModelMeta;
+    dialect: SqlDialect;
+    terms: readonly KeysetOrderInput[];
+    timestampPrecision?: KeysetTimestampPrecision;
+}): KeysetOrderPlan;
+/**
+ * Is `row` strictly after `position` in this ordering? `null` means the
+ * comparison is inconclusive in JavaScript (a collated string key), never
+ * "yes".
+ *
+ * Used as a LIVENESS guard, not as a filter: the SQL bound does the real work,
+ * and this only catches a traversal that fails to advance — which happens when
+ * an ordering is not actually total, or when a cursor value was lossy (a
+ * truncated sub-millisecond timestamp being the case this codebase can
+ * demonstrate). Without it that situation is an infinite page loop.
+ */
+export declare function keysetRowIsAfter(params: {
+    keys: readonly KeysetOrderKey[];
+    row: readonly unknown[];
+    position: readonly unknown[];
+}): boolean | null;
+/** Read a row's ordering values in plan order. */
+export declare function keysetRowValues(params: {
+    plan: KeysetOrderPlan;
+    row: Readonly<Record<string, unknown>>;
+}): readonly unknown[];
+/**
+ * Mint a continuation token from a row that carries every ordering value.
+ *
+ * The row must contain each ordering field — a missing one is refused rather
+ * than encoded as a null, because a silently null position paginates the wrong
+ * sequence. Callers that project a subset (`select`) fetch the ordering
+ * columns HIDDEN and strip them from the payload; see `keyset-iterator.ts`.
+ */
+export declare function encodeKeysetToken(params: {
+    plan: KeysetOrderPlan;
+    row: Readonly<Record<string, unknown>>;
+}): string;
+/**
+ * Read a token back into ordering values, validating version, model and the
+ * effective order. A token minted under a different ordering (or for another
+ * model, or by a future version) is refused with a precise, non-guessing
+ * error — never used to paginate a sequence it does not describe.
+ */
+export declare function decodeKeysetToken(params: {
+    plan: KeysetOrderPlan;
+    token: string;
+}): readonly unknown[];
+//# sourceMappingURL=keyset.d.ts.map

package/dist/keyset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyset.d.ts","sourceRoot":"","sources":["../src/keyset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5D,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,CAAC;AAC7C,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAC;AAEtD,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;CAC9B,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAI3E,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,EAAE,MAAU,CAAC;AAE9C,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,EAAE,MAAe,CAAC;AAElD,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,EAAE,MAAe,CAAC;AAuHnD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CAC/C,GAAG,eAAe,CA+ClB;AA0ID;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAC;IAChC,GAAG,EAAE,SAAS,OAAO,EAAE,CAAC;IACxB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CAC9B,GAAG,OAAO,GAAG,IAAI,CAmBjB;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,IAAI,EAAE,eAAe,CAAC;IACtB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxC,GAAG,SAAS,OAAO,EAAE,CAGrB;AAID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,eAAe,CAAC;IACtB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxC,GAAG,MAAM,CAcT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,OAAO,EAAE,CA8EtG"}

package/dist/model-meta.d.ts

@@ -11,8 +11,8 @@
  * which is dialect-free by design: the id exists before the INSERT, which is
  * what lets dialects without RETURNING re-select the row they just wrote.
  */
-import type { DefaultValueIR, FieldType, RelationIR, ScalarType, SchemaIR } from "@vibeorm/schema";
-import type { SqlExpr } from "@vibeorm/sql";
+import type { ComputedConfig, DefaultValueIR, EnumStorage, FieldType, RelationIR, ScalarType, SchemaIR } from "@vibeorm/schema";
+import type { ScalarCodec, SqlExpr } from "@vibeorm/sql";
 /** Where a field's default value is produced. */
 export type DefaultOrigin = "app" | "database" | "none";
 /** A scalar or enum column, resolved for the runtime. */
@@ -21,11 +21,29 @@ export type FieldMeta = {
     readonly name: string;
     /** Database column name (`dbName ?? name`). */
     readonly columnName: string;
+    /** Explicit column collation (@collation, board #36) — mysql insensitive-filter rendering reads it. */
+    readonly collation?: string;
+    /**
+     * The declared `@db.*` native column type, verbatim as Prisma writes it
+     * (`Uuid`, `VarChar(191)`, `Char(10)`, `Decimal(10, 2)`), or `undefined`
+     * when the field takes the dialect's canonical mapping.
+     *
+     * Carried because the physical type decides value equality on its own,
+     * before any collation: `char(n)` pads, `uuid` folds case, `timestamp(0)`
+     * truncates, `real` narrows a Float. `upsertMany`'s duplicate rule reads it
+     * (`conflictKeyComparisonOf` in bulk-upsert.ts). It is a schema claim, not a
+     * reading of the live column.
+     */
+    readonly nativeType?: string;
     readonly type: FieldType;
     /** The scalar type, or `null` when the field is an enum reference. */
     readonly scalarType: ScalarType | null;
     /** The enum name, or `null` when the field is a scalar. */
     readonly enumName: string | null;
+    /** Physical enum storage, or `null` for ordinary scalar fields. */
+    readonly enumStorage: EnumStorage | null;
+    /** Precomputed membership codec for string-backed enums only. */
+    readonly enumCodec: ScalarCodec | null;
     readonly isList: boolean;
     readonly isOptional: boolean;
     readonly isId: boolean;
@@ -39,6 +57,15 @@ export type FieldMeta = {
      */
     readonly defaultOrigin: DefaultOrigin;
 };
+/** One computed field, resolved for the runtime (config-declared, see @vibeorm/schema computed.ts). */
+export type ComputedFieldMeta = {
+    readonly name: string;
+    /** The declared TypeScript type (informational at runtime; the generator wrote it into the .d.ts). */
+    readonly type: string;
+    /** Scalar fields the compute reads — fetched with the computed field, stripped unless selected. */
+    readonly needs: readonly string[];
+    readonly compute: (row: Record<string, unknown>) => unknown;
+};
 /** A model, resolved for the runtime. */
 export type ModelMeta = {
     /** IR model name, e.g. `"User"`. */
@@ -57,15 +84,30 @@ export type ModelMeta = {
     readonly uniqueFields: readonly FieldMeta[];
     /**
      * COMPOSITE ways to address one row, keyed exactly like the generated
-     * `…WhereUniqueInput` property — member field names joined with `_`
-     * (`projectId_userId`). The composite `@@id` comes first, then every
-     * multi-field `@@unique`, in schema order. Empty for models without one.
+     * `…WhereUniqueInput` property — the declared client selector name
+     * (`@@unique`/`@@id` `name:`) when present, else member field names joined
+     * with `_` (`projectId_userId`). The composite `@@id` comes first, then
+     * every multi-field `@@unique`, in schema order. Empty for models without
+     * one.
+     */
+    readonly compoundUniques: ReadonlyMap<string, UniqueGroupMeta>;
+    /**
+     * Single-field unique INDEXES that are addressable but not folded into
+     * `field.isUnique` (today: NULLS NOT DISTINCT singles) — mirrors the
+     * generator's WhereUniqueInput surface.
      */
-    readonly compoundUniques: ReadonlyMap<string, readonly FieldMeta[]>;
+    readonly singleIndexUniques: readonly UniqueGroupMeta[];
     /** Carried verbatim from the IR — consumed by relation loading in P3. */
     readonly relations: readonly RelationIR[];
     readonly relationByName: ReadonlyMap<string, RelationIR>;
     readonly isView: boolean;
+    /** Row-scoping policy (@@policy) — the client fails closed on it ($withPolicy). */
+    readonly policy?: {
+        readonly field: string;
+        readonly context: string;
+    };
+    /** Computed fields configured for this model, or `null` (the common case). */
+    readonly computed: ReadonlyMap<string, ComputedFieldMeta> | null;
 };
 /**
  * A pre-bound extension where-operator: compiles one use (`{ similarTo: … }`)
@@ -79,6 +121,19 @@ export type ExtensionOperatorFn = (params: {
     readonly model: string;
     readonly field: string;
 }) => SqlExpr;
+/**
+ * One addressable unique group beyond the flat `@id`/`@unique` fields: a
+ * composite `@@id`/`@@unique`, or a single-field unique INDEX that does not
+ * fold into `field.isUnique` (today: `nullsNotDistinct` uniques). Under
+ * NULLS NOT DISTINCT the database keeps at most one row per key INCLUDING
+ * null dimensions, so a `null` member addresses exactly one row — those
+ * groups accept `null` where members; default (nulls-distinct) groups never
+ * do.
+ */
+export type UniqueGroupMeta = {
+    readonly fields: readonly FieldMeta[];
+    readonly nullsNotDistinct: boolean;
+};
 /** All runtime metadata for one schema. */
 export type RuntimeMeta = {
     readonly models: readonly ModelMeta[];
@@ -129,6 +184,7 @@ export declare function generateDefaultValue(params: {
 /** Resolve a whole schema into the runtime's read-only metadata. */
 export declare function buildRuntimeMeta(params: {
     schema: SchemaIR;
+    computed?: ComputedConfig;
 }): RuntimeMeta;
 /** Look a model up by client name or model name; unknown names are a caller error. */
 export declare function getModelMeta(params: {

package/dist/model-meta.d.ts.map

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

package/dist/nested-writes.d.ts

@@ -1,36 +1,3 @@
-/**
- * Nested writes (Prisma-shaped, v1 parity plus implicit-M2M support):
- *
- *   create data:  relation: { create | connect | connectOrCreate }
- *   update data:  … plus { update | updateMany | upsert | set | disconnect |
- *                  delete | deleteMany }
- *
- * STATEMENT ORDER (deterministic, pinned by unit tests):
- *   create:  [owner-side to-one resolutions: SELECT/INSERT per verb] →
- *            parent INSERT → [list/M2M ops in data-key order, item order;
- *            each M2M child op is followed immediately by its join-row INSERT].
- *            PLAIN multi-item FK-side `create` lists collapse into ONE
- *            multi-row INSERT (v1 parity — one fewer round-trip per item) when
- *            no item carries nested ops of its own and all items write the
- *            same columns (so no NULL-vs-database-default drift can appear).
- *   update:  parent pre-SELECT (findUnique) → [owner-side to-one resolutions]
- *            → parent UPDATE (scalars + FK changes, skipped when empty) →
- *            [deferred owner-side child DELETEs] → [list/M2M ops in data-key
- *            order] — the returned row is the UPDATE's result (or the
- *            pre-SELECT when nothing on the parent changed).
- *
- * TRANSACTIONS: any nested write that produces more than one statement wraps
- * in `adapter.transaction` automatically; inside an outer `$transaction` that
- * nests as a savepoint (the adapter contract). A mid-write failure therefore
- * rolls the whole write back.
- *
- * Implicit M2M goes through the ONE shared join-table rule (`implicitJoinTable`
- * via relation-plan's link resolution); `connect` writes join rows with
- * conflict-skip, so re-connecting an existing pair is a no-op.
- *
- * Unknown verbs are loud: VIBE_VALIDATION naming the verb (v1 silently
- * ignored them — that was a bug class, not a feature).
- */
 import type { SqlDialect, SqlStatement } from "@vibeorm/sql";
 import type { ModelMeta, RuntimeMeta } from "./model-meta.ts";
 import type { QueryMethod } from "./query-builder.ts";

package/dist/nested-writes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nested-writes.d.ts","sourceRoot":"","sources":["../src/nested-writes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMtD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE;QAC3B,SAAS,EAAE,YAAY,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAChC,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACrF,CAAC;AAmCF,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAQpF;AAgcD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,GAAG,EAAE,YAAY,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GAAG,OAAO,CAAC,aAAa,CAAC,CAOzB;AAoeD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,GAAG,EAAE,YAAY,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GAAG,OAAO,CAAC,aAAa,CAAC,CAoCzB"}
+{"version":3,"file":"nested-writes.d.ts","sourceRoot":"","sources":["../src/nested-writes.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgFtD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE;QAC3B,SAAS,EAAE,YAAY,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAChC,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACrF,CAAC;AAmCF,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAQpF;AA4eD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,GAAG,EAAE,YAAY,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GAAG,OAAO,CAAC,aAAa,CAAC,CAOzB;AA0hBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,GAAG,EAAE,YAAY,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GAAG,OAAO,CAAC,aAAa,CAAC,CAqCzB"}

package/dist/policy-operation.d.ts

@@ -0,0 +1,14 @@
+import type { DynamicClient } from "./client.ts";
+type PolicyOperationFactory = <T>(run: (client: DynamicClient) => Promise<T>) => Promise<T>;
+/** Register the engine-owned deferred-operation factory without exposing it on clients. */
+export declare function registerPolicyOperations(params: {
+    client: DynamicClient;
+    factory: PolicyOperationFactory;
+}): void;
+/** Defer the whole policy flow; its client is selected by the ordinary array-transaction runner. */
+export declare function deferPolicyOperation<T>(params: {
+    client: DynamicClient;
+    run: (client: DynamicClient) => Promise<T>;
+}): Promise<T>;
+export {};
+//# sourceMappingURL=policy-operation.d.ts.map

package/dist/policy-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-operation.d.ts","sourceRoot":"","sources":["../src/policy-operation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,KAAK,sBAAsB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAG5F,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,GAAG,IAAI,CAEjH;AAED,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAIjI"}

package/dist/policy.d.ts

@@ -0,0 +1,17 @@
+import type { RuntimeMeta } from "./model-meta.ts";
+import type { DynamicClient, ModelDelegate } from "./client.ts";
+/** Values a policy context may bind — the scoping column's scalar shape. */
+export type PolicyContextValue = string | number | bigint;
+/**
+ * Attach `$withPolicy`/`$bypassPolicy` and fail-close the base delegates of
+ * policied models. No-op on schemas without @@policy.
+ */
+export declare function attachPolicy(params: {
+    client: DynamicClient;
+    meta: RuntimeMeta;
+    wrapDelegate?: (params: {
+        model: string;
+        delegate: ModelDelegate;
+    }) => ModelDelegate;
+}): void;
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAA0B,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGxF,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAkrB1D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,aAAa,CAAA;KAAE,KAAK,aAAa,CAAC;CAAE,GAAG,IAAI,CAmK9K"}

package/dist/query-builder.d.ts

@@ -14,10 +14,11 @@
  *   - bad input becomes VIBE_VALIDATION naming the model, field and operator.
  */
 import type { OrderByColumn, SqlDialect, SqlExpr, SqlStatement } from "@vibeorm/sql";
+import type { KeysetOrderInput } from "./keyset.ts";
 import type { ModelMeta, RuntimeMeta } from "./model-meta.ts";
 import type { RelationSelection, RelationTreeNode } from "./relation-plan.ts";
 /** Every ORM method the query builder builds SQL for. */
-export type QueryMethod = "findMany" | "findFirst" | "findUnique" | "create" | "createMany" | "createManyAndReturn" | "update" | "updateMany" | "upsert" | "delete" | "deleteMany" | "count" | "aggregate" | "groupBy";
+export type QueryMethod = "findMany" | "findFirst" | "findUnique" | "create" | "createMany" | "createManyAndReturn" | "update" | "updateMany" | "updateManyAndReturn" | "upsert" | "upsertMany" | "delete" | "deleteMany" | "count" | "aggregate" | "groupBy";
 /** Client-level options that shape SQL (subset of ClientOptions the builder needs). */
 export type BuilderClientOptions = {
     /** Append the primary key to ORDER BY when no explicit orderBy was given (default false). */
@@ -66,6 +67,13 @@ export type QueryPlan = {
      * projection — the client narrows back down to this after relation loading.
      */
     readonly resultFields: readonly string[] | null;
+    /**
+     * Computed fields to attach to result rows (config-declared), resolved from
+     * select/omit — always a concrete name list, `null` when none apply. Their
+     * `needs` ride `selectedFields` like stitch keys and are narrowed away by
+     * `resultFields` unless selected themselves.
+     */
+    readonly computed: readonly string[] | null;
     /** Relations to load after the base rows, or `null` when none were asked for. */
     readonly relations: RelationSelection | null;
     /**
@@ -99,6 +107,15 @@ export type QueryPlan = {
      * concatenating returned rows. Absent for single-statement calls.
      */
     readonly batch?: readonly SqlStatement[];
+    /**
+     * upsertMany only (EPIC 10): the number of rows this plan submits, summed
+     * across chunks. It IS the operation's affected count under the one
+     * cross-dialect definition — every submitted row is inserted or updated —
+     * and it is computed here because the drivers do not agree: mysql's ON
+     * DUPLICATE KEY scores an insert 1, a changed update 2 and an unchanged
+     * update 0, so its number is not a row count at all.
+     */
+    readonly upsertRowCount?: number;
     /** The caller's `select`, replayed on that re-select. */
     readonly selectArg: Readonly<Record<string, unknown>> | null;
     /** How to decode aggregate/groupBy/count-select rows; `null` elsewhere. */
@@ -192,6 +209,17 @@ export declare function upsertUsesNativeStatement(params: {
     model: ModelMeta;
     args: Record<string, unknown>;
 }): boolean;
+/**
+ * Compile a raw `orderBy` argument into keyset order inputs — the ONE parsing
+ * path the iterator and the `after` bound share, so a token's signature can
+ * never drift from the ordering the statement carries.
+ */
+export declare function compileKeysetOrderInputs(params: {
+    dialect: SqlDialect;
+    meta: RuntimeMeta;
+    model: ModelMeta;
+    orderBy: unknown;
+}): KeysetOrderInput[];
 /** The column a relation's JSON payload is exposed under in the outer row. */
 export declare function lateralColumnAlias(params: {
     relation: string;
@@ -221,6 +249,7 @@ export declare function resolveResultShape(params: {
 }): {
     relations: RelationSelection | null;
     resultFields: readonly string[] | null;
+    computed: readonly string[] | null;
 };
 /**
  * Build the SQL plan for one ORM call. Pure: same inputs, same statement —

package/dist/query-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../src/query-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,OAAO,KAAK,EAMV,aAAa,EAKb,UAAU,EACV,OAAO,EACP,YAAY,EACb,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAa,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,KAAK,EAAgB,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI5F,yDAAyD;AACzD,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,YAAY,GACZ,qBAAqB,GACrB,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,WAAW,GACX,SAAS,CAAC;AAEd,uFAAuF;AACvF,MAAM,MAAM,oBAAoB,GAAG;IACjC,6FAA6F;IAC7F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,yFAAyF;IACzF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC;AAIF,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAChD,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAChE;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IACpE;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7D,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACjD,kFAAkF;IAClF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAAC;CAChD,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAIF,2FAA2F;AAC3F,eAAO,MAAM,WAAW,EAAE,MAAiB,CAAC;AAo9B5C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B,GAAG,OAAO,GAAG,SAAS,CAItB;AA2CD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB,GAAG,aAAa,EAAE,CAqBlB;AA6JD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CAsB3G;AAgJD;;;;;;;;GAQG;AACH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GAAG,OAAO,CAiBV;AAssBD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG,MAAM,EAAE,CAgBrF;AAymBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GAAG;IAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CAYlF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,uBAAuB,CAAC,EAAE,gBAAgB,CAAC;IAC3C,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC,GAAG,SAAS,CA8fZ"}
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../src/query-builder.ts"],"names":[],"mappings":"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"}

package/dist/relation-key.d.ts

@@ -0,0 +1,23 @@
+/** Compare decoded relation keys by value, including DateTime milliseconds and binary bytes. */
+export declare function relationValueKey(params: {
+    value: unknown;
+}): unknown;
+/**
+ * A collision-safe Map key for an ORDERED key tuple, or `null` when the tuple
+ * is INCOMPLETE (any member null/undefined) — an incomplete foreign key must
+ * never attach a parent, so it gets no key at all rather than a key that could
+ * collide with another incomplete tuple.
+ *
+ * The encoding is `JSON.stringify` over the per-member {@link relationValueKey}
+ * tags, NOT a separator join: JSON string escaping is injective, so a member
+ * containing the separator of a naive `a + "\u0000" + b` scheme (or `","`, or
+ * `"|"`) cannot forge another tuple's key.
+ *
+ * A member whose equality cannot be implemented faithfully — any object that is
+ * neither `Date` nor `Uint8Array`, where `String(value)` would be a lossy stand-in
+ * — is refused rather than silently mis-grouped.
+ */
+export declare function relationTupleKey(params: {
+    values: readonly unknown[];
+}): string | null;
+//# sourceMappingURL=relation-key.d.ts.map

package/dist/relation-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-key.d.ts","sourceRoot":"","sources":["../src/relation-key.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAqBpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAgBtF"}

package/dist/relation-loader.d.ts

@@ -1,32 +1,3 @@
-/**
- * Relation LOADING: attach included relations onto already-materialized rows.
- *
- * The portable "query" strategy (default, all dialects): one batched statement
- * per relation per level (`WHERE childKey IN (parent keys)`), grouped and
- * stitched in memory — never one query per parent. Implicit M2M loads in ONE
- * statement per level (board #12, v1's shape): children INNER JOINed to their
- * join-table membership rows, the join table's parent-key column projected
- * under a reserved alias and decoded through the PARENT key's codec (rule 6).
- * Deeper levels recurse over the level's loaded children.
- *
- * PER-PARENT take/skip MECHANISM (differs from v1's SQL, matches its
- * semantics): v1 windowed with `ROW_NUMBER() OVER (PARTITION BY fk)`; v2 loads
- * the batch fully ordered (the user's orderBy, or the child PK when paginating
- * without one) and applies each parent's skip/take at stitch time. Same
- * observable result for any deterministic ordering, no window functions in the
- * AST. The trade-off — overfetching children that fall outside a page — is
- * accepted for 2.0 and confined to this module.
- *
- * The "join" strategy's rows arrive with `__rel_<name>` JSON columns (built by
- * the query builder's lateral statement); `attachLateralRelations` parses,
- * DECODES (codecs on every child row — to_jsonb strings timestamps and drops
- * BigInt-ness, LEARNINGS) and stitches them, then recurses deeper levels
- * through the query strategy exactly like v1.
- *
- * Statements run SEQUENTIALLY in relation-declaration order, so the statement
- * stream is deterministic (scripted-adapter tests pin it; real adapters get
- * predictable logs).
- */
 import type { SelectStatement, SqlDialect, WireFidelity } from "@vibeorm/sql";
 import type { ModelMeta, RuntimeMeta } from "./model-meta.ts";
 import type { RelationSelection } from "./relation-plan.ts";

package/dist/relation-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relation-loader.d.ts","sourceRoot":"","sources":["../src/relation-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAW,YAAY,EAAE,MAAM,cAAc,CAAC;AAEvF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,KAAK,EAAgB,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AAI5F,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE;IACtC,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;AAqczC;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,+GAA+G;IAC/G,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DhB"}
+{"version":3,"file":"relation-loader.d.ts","sourceRoot":"","sources":["../src/relation-loader.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAU,eAAe,EAAE,UAAU,EAAW,YAAY,EAAE,MAAM,cAAc,CAAC;AAG/F,OAAO,KAAK,EAAa,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGzE,OAAO,KAAK,EAAmC,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AAI/G,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE;IACtC,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;AA6wBzC;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,+GAA+G;IAC/G,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DhB"}