@metaobjectsdev/runtime-ts 1.0.5-rc.7 → 1.0.5-rc.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/runtime-ts",
-  "version": "1.0.5-rc.7",
+  "version": "1.0.5-rc.9",
   "description": "Node-side runtime helpers for MetaObjects: Fastify route builders, Drizzle filter/sort integration, Kysely drivers.",
   "type": "module",
   "main": "./dist/index.js",
@@ -64,8 +64,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@metaobjectsdev/metadata": "1.0.5-rc.7",
-    "@metaobjectsdev/render": "1.0.5-rc.7",
+    "@metaobjectsdev/metadata": "1.0.5-rc.9",
+    "@metaobjectsdev/render": "1.0.5-rc.9",
     "qs": "^6.13.0"
   },
   "peerDependencies": {

package/src/drizzle-fastify/index.ts

@@ -22,8 +22,10 @@ import qs from "qs";
 import type { FilterAllowlist, SortAllowlist } from "./filter-allowlist.js";
 export type { FilterAllowlist, SortAllowlist } from "./filter-allowlist.js";
 import { parseFilterParams, FilterParseError } from "./filter-parser.js";
-import { isTruthyFlag, contractErrorCode, coerceIdForColumn } from "./util.js";
+import { isTruthyFlag, contractErrorCode, coerceIdForColumn, firstRow } from "./util.js";
+import { timestampWire } from "../timestamp-wire.js";
 export { isTruthyFlag, contractErrorCode, parseId, coerceIdForColumn } from "./util.js";
+export { timestampWire, canonicalTimestamp } from "../timestamp-wire.js";
 
 // ---------------------------------------------------------------------------
 // Loose types — we don't bind to a specific Drizzle backend so the helper
@@ -106,6 +108,24 @@ function readSource(opts: VerbOptions): AnyTable {
   return opts.readView ?? opts.table;
 }
 
+/**
+ * Wire mapper for rows READ through `readSource` — canonicalized against
+ * exactly that source, since a view may shadow a table column with a
+ * non-timestamp of the same name.
+ */
+function readWire(opts: VerbOptions): (row: unknown) => unknown {
+  return timestampWire(readSource(opts));
+}
+
+/**
+ * Wire mapper for a WRITE ECHO: `reReadThroughView` answers with the replica
+ * view's row but falls back to the table row, so the echo is canonicalized
+ * against the union of both sources.
+ */
+function echoWire(opts: VerbOptions): (row: unknown) => unknown {
+  return timestampWire(opts.table, opts.readView);
+}
+
 /** #214 — after a write to the base table, re-read the row THROUGH the replica
  *  view by PK so the response carries derived (origin.passthrough) columns. When
  *  there is no `readView`, return the write row unchanged (current behaviour). */
@@ -141,6 +161,7 @@ function routeOpts(opts: VerbOptions): RouteShorthandOptions {
 }
 
 export function mountListRoute(opts: VerbOptions): void {
+  const toWire = readWire(opts);
   opts.fastify.get(opts.path, routeOpts(opts), async (req, reply) => {
     try {
       // #214 — a write-through entity reads through its replica view.
@@ -196,7 +217,7 @@ export function mountListRoute(opts: VerbOptions): void {
       // drizzle-orm node-postgres query builder is thenable but has no `.all()`
       // method (that is a libsql/better-sqlite3-only API). Awaiting works on
       // both dialects and is what makes this helper genuinely Postgres-capable.
-      const rows = await q;
+      const rows = (await q as unknown[]).map(toWire);
 
       if (!withCount) return rows;
 
@@ -216,6 +237,7 @@ export function mountListRoute(opts: VerbOptions): void {
 }
 
 export function mountGetRoute(opts: VerbOptions): void {
+  const toWire = readWire(opts);
   opts.fastify.get(`${opts.path}/:id`, routeOpts(opts), async (req, reply) => {
     const { id } = req.params as { id: string };
     const discCond = discriminatorCond(opts);
@@ -228,20 +250,13 @@ export function mountGetRoute(opts: VerbOptions): void {
       return reply.code(400).send({ error: "invalid_id" });
     }
     const idCond = eq(src.id, idValue);
-    // Await + take the first row rather than `.get()` — `.get()` is a
-    // libsql/better-sqlite3-only method; the node-postgres builder is thenable
-    // but has no `.get()`. Awaiting works on both dialects.
-    const rows = await opts.db
-      .select()
-      .from(src)
-      .where(discCond ? and(idCond, discCond) : idCond)
-      .limit(1);
-    const row = (rows as unknown[])[0];
-    return row ?? reply.code(404).send({ error: "not_found" });
+    const row = await firstRow(opts.db, src, discCond ? and(idCond, discCond) : idCond);
+    return row ? toWire(row) : reply.code(404).send({ error: "not_found" });
   });
 }
 
 export function mountCreateRoute(opts: VerbOptions): void {
+  const toWire = echoWire(opts);
   opts.fastify.post(opts.path, routeOpts(opts), async (req, reply) => {
     const parsed = opts.insertSchema.safeParse(req.body);
     if (!parsed.success) {
@@ -265,11 +280,12 @@ export function mountCreateRoute(opts: VerbOptions): void {
     const row = (result as unknown[])[0];
     // #214 — read-your-writes: re-read through the replica view so the response
     // carries derived (origin.passthrough) columns the base table excludes.
-    return reply.code(201).send(await reReadThroughView(opts, row));
+    return reply.code(201).send(toWire(await reReadThroughView(opts, row)));
   });
 }
 
 export function mountUpdateRoute(opts: VerbOptions): void {
+  const toWire = echoWire(opts);
   const handler = async (
     req: { params: unknown; body: unknown },
     reply: { code: (n: number) => { send: (b: unknown) => unknown } },
@@ -304,13 +320,8 @@ export function mountUpdateRoute(opts: VerbOptions): void {
         return reply.code(400).send({ error: "invalid_id" });
       }
       const noopCond = eq(src.id, noopId);
-      const rows = await opts.db
-        .select()
-        .from(src)
-        .where(discCond ? and(noopCond, discCond) : noopCond)
-        .limit(1);
-      const row = (rows as unknown[])[0];
-      return row ?? reply.code(404).send({ error: "not_found" });
+      const row = await firstRow(opts.db, src, discCond ? and(noopCond, discCond) : noopCond);
+      return row ? toWire(row) : reply.code(404).send({ error: "not_found" });
     }
     // Compare against the PK's real type (see mountGetRoute) — a numeric-
     // LOOKING id on a TEXT pk would otherwise UPDATE the wrong row.
@@ -334,7 +345,7 @@ export function mountUpdateRoute(opts: VerbOptions): void {
     const row = (result as unknown[])[0];
     if (row == null) return reply.code(404).send({ error: "not_found" });
     // #214 — re-read through the replica view so the response carries derived columns.
-    return await reReadThroughView(opts, row);
+    return toWire(await reReadThroughView(opts, row));
   };
   const path = `${opts.path}/:id`;
   const ro = routeOpts(opts);

package/src/drizzle-fastify/mount-m2m.ts

@@ -33,6 +33,7 @@
 import type { FastifyInstance, RouteShorthandOptions } from "fastify";
 import { and, eq, or, inArray } from "drizzle-orm";
 import { coerceIdForColumn } from "./util.js";
+import { timestampWire } from "../timestamp-wire.js";
 
 // Loose Drizzle types — the helper works across libsql / better-sqlite3 / pg.
 // biome-ignore lint/suspicious/noExplicitAny: dynamic dispatch over user's Drizzle instance
@@ -84,6 +85,7 @@ export function mountM2mRoute(opts: M2mRouteOptions): void {
   const targetPk = opts.targetPkColumn ?? "id";
   const route = `${opts.path}/:id/${opts.relationName}`;
   const ro = opts.routeOptions ?? {};
+  const toWire = timestampWire(opts.targetTable);
 
   opts.fastify.get(route, ro, async (req, reply) => {
     const { id } = req.params as { id: string };
@@ -148,10 +150,11 @@ export function mountM2mRoute(opts: M2mRouteOptions): void {
     const pkCol = columnRef(opts.targetTable, targetPk);
     const byPk = inArray(pkCol, [...relatedIds]);
     const disc = opts.targetDiscriminator;
-    return await opts.db
+    const rows = await opts.db
       .select()
       .from(opts.targetTable)
       .where(disc ? and(byPk, eq(columnRef(opts.targetTable, disc.column), disc.value)) : byPk);
+    return (rows as unknown[]).map(toWire);
   });
 }
 

package/src/drizzle-fastify/mount-read-only.ts

@@ -3,19 +3,12 @@ import { sql, eq, and, count } from "drizzle-orm";
 import qs from "qs";
 import { parseFilterParams, FilterParseError } from "./filter-parser.js";
 import type { FilterAllowlist, SortAllowlist } from "./filter-allowlist.js";
-import { isTruthyFlag, contractErrorCode, coerceIdForColumn, rawIdLiteral } from "./util.js";
+import { isTruthyFlag, contractErrorCode, coerceIdForColumn, rawIdLiteral, viewBaseConfig } from "./util.js";
+import { timestampWire } from "../timestamp-wire.js";
 
 // biome-ignore lint/suspicious/noExplicitAny: dynamic dispatch over user-supplied views
 type AnyView = any;
 
-/**
- * Drizzle v0.45 stores view config under this well-known Symbol.
- * Accessing `view._` on a proxy-wrapped view (empty-column .existing()) throws
- * because the proxy tries to spread `subquery._.selectedFields` which is undefined.
- * Using the symbol bypasses the proxy entirely.
- */
-const VIEW_BASE_CONFIG = Symbol.for("drizzle:ViewBaseConfig");
-
 export interface MountReadOnlyOptions {
   readonly fastify: FastifyInstance;
   readonly path: string;
@@ -49,18 +42,8 @@ const REJECT_MUTATION = async (
     .send({ error: "method_not_allowed", message: `${request.method} is not supported on a projection (read-only).` });
 };
 
-function getViewConfig(view: AnyView): Record<string, unknown> | undefined {
-  try {
-    const cfg = (view as Record<symbol, unknown>)[VIEW_BASE_CONFIG];
-    if (cfg && typeof cfg === "object") return cfg as Record<string, unknown>;
-  } catch {
-    // ignore — proxy handler may throw on unexpected shapes
-  }
-  return undefined;
-}
-
 function resolveViewName(view: AnyView): string | undefined {
-  const cfg = getViewConfig(view);
+  const cfg = viewBaseConfig(view);
   if (cfg) {
     if (typeof cfg["name"] === "string") return cfg["name"] as string;
   }
@@ -78,7 +61,7 @@ function resolveViewName(view: AnyView): string | undefined {
  * `SELECT  FROM ...` (invalid SQL), and we must fall back to raw SQL.
  */
 function isEmptyColumnView(view: AnyView): boolean {
-  const cfg = getViewConfig(view);
+  const cfg = viewBaseConfig(view);
   if (cfg) {
     const fields = cfg["selectedFields"] as Record<string, unknown> | undefined;
     return fields !== undefined && Object.keys(fields).length === 0;
@@ -139,6 +122,8 @@ export function mountReadOnlyCrudRoutes(opts: MountReadOnlyOptions): void {
 
   const viewName = resolveViewName(view);
   const useRawSql = isEmptyColumnView(view) && !!viewName;
+  // The raw-SQL branch has no declared columns, so nothing names a timestamp there.
+  const toWire = timestampWire(view);
 
   // ── List ──────────────────────────────────────────────────────────────────
   fastify.get(path, ro, async (req, reply) => {
@@ -189,7 +174,7 @@ export function mountReadOnlyCrudRoutes(opts: MountReadOnlyOptions): void {
       // node-postgres builder is thenable. (The useRawSql branch above keeps
       // db.all(sql.raw(...)) because that is the libsql raw-exec API, only
       // reachable for `.existing()` empty-column views which are sqlite-only.)
-      const rows = await q;
+      const rows = (await q as unknown[]).map(toWire);
 
       if (!withCount) return rows;
 
@@ -231,7 +216,7 @@ export function mountReadOnlyCrudRoutes(opts: MountReadOnlyOptions): void {
       colRef !== undefined ? eq(colRef, idValue) : undefined
     ).limit(1);
     const row = (rows as unknown[])[0];
-    return row ?? reply.code(404).send({ error: "not_found" });
+    return row ? toWire(row) : reply.code(404).send({ error: "not_found" });
   });
 
   // ── Mutations explicitly rejected (405) ───────────────────────────────────

package/src/drizzle-fastify/util.ts

@@ -81,3 +81,36 @@ export function contractErrorCode(internal: string): string {
       return internal;
   }
 }
+
+/**
+ * Drizzle v0.45 stores view config under this well-known Symbol. Accessing
+ * `view._` on a proxy-wrapped view (empty-column `.existing()`) throws because
+ * the proxy tries to spread `subquery._.selectedFields` which is undefined; the
+ * symbol read bypasses the proxy. The proxy handler can still throw on
+ * unexpected shapes, so the read is guarded. One reader for the private shape —
+ * the two read-only mounts and the timestamp-wire column lookup share it.
+ */
+const VIEW_BASE_CONFIG = Symbol.for("drizzle:ViewBaseConfig");
+
+export function viewBaseConfig(view: unknown): Record<string, unknown> | undefined {
+  try {
+    const cfg = (view as Record<symbol, unknown>)[VIEW_BASE_CONFIG];
+    if (cfg && typeof cfg === "object") return cfg as Record<string, unknown>;
+  } catch {
+    // ignore — proxy handler may throw on unexpected shapes
+  }
+  return undefined;
+}
+
+/**
+ * The portable one-row read: `.limit(1)` + await + first element. Awaiting is
+ * what makes this work on both dialects — the node-postgres query builder is
+ * thenable but has no `.get()` (that is a libsql/better-sqlite3-only API, #286).
+ * The caller builds the WHERE (including any TPH discriminator), so the
+ * condition stays with the mount that owns it.
+ */
+export async function firstRow(db: unknown, src: unknown, cond: unknown): Promise<unknown> {
+  // biome-ignore lint/suspicious/noExplicitAny: dynamic dispatch over the user's Drizzle client
+  const rows: unknown = await (db as any).select().from(src).where(cond).limit(1);
+  return (rows as unknown[])[0];
+}

package/src/hono/index.ts

@@ -35,10 +35,12 @@ export type {
   FilterAllowlist,
   SortAllowlist,
 } from "../drizzle-fastify/filter-allowlist.js";
-import { isTruthyFlag, coerceIdForColumn } from "../drizzle-fastify/util.js";
+import { isTruthyFlag, coerceIdForColumn, firstRow } from "../drizzle-fastify/util.js";
+import { timestampWire } from "../timestamp-wire.js";
 // Back-compat re-export — the unsafe local copy was consolidated onto the one
 // shared (deprecated) helper so the three adapters can't silently diverge.
 export { parseId } from "../drizzle-fastify/util.js";
+export { timestampWire, canonicalTimestamp } from "../timestamp-wire.js";
 
 // ---------------------------------------------------------------------------
 // Loose types — we don't bind to a specific Drizzle backend so the helper
@@ -130,6 +132,24 @@ function readSource(opts: VerbOptions): AnyTable {
   return opts.readView ?? opts.table;
 }
 
+/**
+ * Wire mapper for rows READ through `readSource` — canonicalized against
+ * exactly that source, since a view may shadow a table column with a
+ * non-timestamp of the same name.
+ */
+function readWire(opts: VerbOptions): (row: unknown) => unknown {
+  return timestampWire(readSource(opts));
+}
+
+/**
+ * Wire mapper for a WRITE ECHO: `reReadThroughView` answers with the replica
+ * view's row but falls back to the table row, so the echo is canonicalized
+ * against the union of both sources.
+ */
+function echoWire(opts: VerbOptions): (row: unknown) => unknown {
+  return timestampWire(opts.table, opts.readView);
+}
+
 /** Re-read a just-written row through the replica view so the response carries the
  *  derived columns. Writes always target the TABLE; only the echo changes. With no
  *  `readView`, returns the write row unchanged. */
@@ -149,6 +169,7 @@ async function reReadThroughView(
 }
 
 export function mountListRoute(opts: VerbOptions): void {
+  const toWire = readWire(opts);
   opts.app.get(opts.path, async (c) => {
     try {
       const listSrc = readSource(opts);
@@ -184,7 +205,7 @@ export function mountListRoute(opts: VerbOptions): void {
       // better-sqlite3-only API). Awaiting works on BOTH dialects — this is what
       // makes the Hono helpers genuinely Postgres-capable, matching the Fastify
       // adapter, which carried this fix while Hono did not (#286).
-      const rows = await q;
+      const rows = (await q as unknown[]).map(toWire);
 
       if (!withCount) return c.json(rows);
 
@@ -208,6 +229,7 @@ export function mountListRoute(opts: VerbOptions): void {
 }
 
 export function mountGetRoute(opts: VerbOptions): void {
+  const toWire = readWire(opts);
   opts.app.get(`${opts.path}/:id`, async (c) => {
     const id = c.req.param("id") ?? "";
     // Compare against the PK's real type — a numeric-LOOKING id on a TEXT pk
@@ -215,19 +237,13 @@ export function mountGetRoute(opts: VerbOptions): void {
     const getSrc = readSource(opts);
     const idValue = coerceIdForColumn(getSrc.id, id);
     if (idValue === undefined) return c.json({ error: "invalid_id" }, 400);
-    // `.get()` is likewise libsql/better-sqlite3-only; `.limit(1)` + await + [0]
-    // is the portable single-row read (#286).
-    const rows = await opts.db
-      .select()
-      .from(getSrc)
-      .where(eq(getSrc.id, idValue))
-      .limit(1);
-    const row = (rows as unknown[])[0];
-    return row ? c.json(row) : c.json({ error: "not_found" }, 404);
+    const row = await firstRow(opts.db, getSrc, eq(getSrc.id, idValue));
+    return row ? c.json(toWire(row)) : c.json({ error: "not_found" }, 404);
   });
 }
 
 export function mountCreateRoute(opts: VerbOptions): void {
+  const toWire = echoWire(opts);
   opts.app.post(opts.path, async (c) => {
     const body = await c.req.json().catch(() => undefined);
     const parsed = opts.insertSchema.safeParse(body);
@@ -247,11 +263,12 @@ export function mountCreateRoute(opts: VerbOptions): void {
     }
     const row = (result as unknown[])[0];
     // Echo the row through the replica view so derived columns are present (#214).
-    return c.json(await reReadThroughView(opts, row), 201);
+    return c.json(toWire(await reReadThroughView(opts, row)), 201);
   });
 }
 
 export function mountUpdateRoute(opts: VerbOptions): void {
+  const toWire = echoWire(opts);
   const handler = async (c: Context) => {
     const id = c.req.param("id") ?? "";
     const body = await c.req.json().catch(() => undefined);
@@ -259,6 +276,15 @@ export function mountUpdateRoute(opts: VerbOptions): void {
     if (!parsed.success) {
       return c.json({ error: "validation", issues: parsed.error.issues }, 400);
     }
+    // An empty patch is a no-op update, answered as a read — the Fastify mount's
+    // rule; its block in drizzle-fastify/index.ts carries the full rationale.
+    if (Object.keys(parsed.data as Record<string, unknown>).length === 0) {
+      const src = readSource(opts);
+      const noopId = coerceIdForColumn(src.id, id);
+      if (noopId === undefined) return c.json({ error: "invalid_id" }, 400);
+      const row = await firstRow(opts.db, src, eq(src.id, noopId));
+      return row ? c.json(toWire(row)) : c.json({ error: "not_found" }, 404);
+    }
     // Compare against the PK's real type (see mountGetRoute) — a numeric-
     // LOOKING id on a TEXT pk would otherwise UPDATE the wrong row.
     const idValue = coerceIdForColumn(opts.table.id, id);
@@ -276,7 +302,7 @@ export function mountUpdateRoute(opts: VerbOptions): void {
       return c.json(f.body, f.status as 400 | 409);
     }
     const row = (result as unknown[])[0];
-    return row ? c.json(await reReadThroughView(opts, row)) : c.json({ error: "not_found" }, 404);
+    return row ? c.json(toWire(await reReadThroughView(opts, row))) : c.json({ error: "not_found" }, 404);
   };
   const path = `${opts.path}/:id`;
   // Cross-port REST contract (FR-008): the update verb is reachable via BOTH PATCH

package/src/hono/mount-read-only.ts

@@ -10,20 +10,14 @@ import type {
   FilterAllowlist,
   SortAllowlist,
 } from "../drizzle-fastify/filter-allowlist.js";
-import { isTruthyFlag, coerceIdForColumn, rawIdLiteral, contractErrorCode } from "../drizzle-fastify/util.js";
+import { isTruthyFlag, coerceIdForColumn, rawIdLiteral, contractErrorCode, viewBaseConfig } from "../drizzle-fastify/util.js";
+import { timestampWire } from "../timestamp-wire.js";
 
 // biome-ignore lint/suspicious/noExplicitAny: dynamic dispatch over user-supplied views
 type AnyView = any;
 // biome-ignore lint/suspicious/noExplicitAny: generic Hono app
 type AnyHono = Hono<any, any, any>;
 
-/**
- * Drizzle v0.45 stores view config under this well-known Symbol. Mirrors
- * the same workaround the Fastify mount uses — accessing `view._` on a
- * proxy-wrapped view throws.
- */
-const VIEW_BASE_CONFIG = Symbol.for("drizzle:ViewBaseConfig");
-
 export interface MountReadOnlyOptions {
   readonly app: AnyHono;
   readonly path: string;
@@ -37,18 +31,8 @@ export interface MountReadOnlyOptions {
   readonly idColumn?: string;
 }
 
-function getViewConfig(view: AnyView): Record<string, unknown> | undefined {
-  try {
-    const cfg = (view as Record<symbol, unknown>)[VIEW_BASE_CONFIG];
-    if (cfg && typeof cfg === "object") return cfg as Record<string, unknown>;
-  } catch {
-    // ignore — proxy handler may throw on unexpected shapes
-  }
-  return undefined;
-}
-
 function resolveViewName(view: AnyView): string | undefined {
-  const cfg = getViewConfig(view);
+  const cfg = viewBaseConfig(view);
   if (cfg) {
     if (typeof cfg["name"] === "string") return cfg["name"] as string;
   }
@@ -60,7 +44,7 @@ function resolveViewName(view: AnyView): string | undefined {
 }
 
 function isEmptyColumnView(view: AnyView): boolean {
-  const cfg = getViewConfig(view);
+  const cfg = viewBaseConfig(view);
   if (cfg) {
     const fields = cfg["selectedFields"] as Record<string, unknown> | undefined;
     return fields !== undefined && Object.keys(fields).length === 0;
@@ -119,6 +103,8 @@ export function mountReadOnlyCrudRoutes(opts: MountReadOnlyOptions): void {
 
   const viewName = resolveViewName(view);
   const useRawSql = isEmptyColumnView(view) && !!viewName;
+  // The raw-SQL branch has no declared columns, so nothing names a timestamp there.
+  const toWire = timestampWire(view);
 
   // ── List ──────────────────────────────────────────────────────────────────
   app.get(path, async (c) => {
@@ -172,7 +158,7 @@ export function mountReadOnlyCrudRoutes(opts: MountReadOnlyOptions): void {
       // better-sqlite3-only API). Awaiting works on BOTH dialects — this is what
       // makes the Hono helpers genuinely Postgres-capable, matching the Fastify
       // adapter, which carried this fix while Hono did not (#286).
-      const rows = await q;
+      const rows = (await q as unknown[]).map(toWire);
 
       if (!withCount) return c.json(rows);
 
@@ -215,7 +201,7 @@ export function mountReadOnlyCrudRoutes(opts: MountReadOnlyOptions): void {
       .where(colRef !== undefined ? eq(colRef, idValue) : undefined)
       .limit(1);
     const row = (rows as unknown[])[0];
-    return row ? c.json(row) : c.json({ error: "not_found" }, 404);
+    return row ? c.json(toWire(row)) : c.json({ error: "not_found" }, 404);
   });
 
   // ── Mutations explicitly rejected (405) ───────────────────────────────────

package/src/identity-strategy.ts

@@ -13,7 +13,8 @@ import {
 import { MetadataError, ValidationError } from "./errors.js";
 
 export type IdentityResolution =
-  | { kind: "driver-generated"; values: Record<string, unknown> }
+  /** `fields` are the PK fields the store fills on insert — absent from `values` by design. */
+  | { kind: "driver-generated"; values: Record<string, unknown>; fields: readonly string[] }
   | { kind: "preset"; values: Record<string, unknown> };
 
 export function resolveIdentity(entity: MetaData, data: Record<string, unknown>): IdentityResolution {
@@ -67,7 +68,7 @@ export function resolveIdentity(entity: MetaData, data: Record<string, unknown>)
       for (const f of pkFields) values[f] = data[f];
       return { kind: "preset", values };
     }
-    return { kind: "driver-generated", values: {} };
+    return { kind: "driver-generated", values: {}, fields: pkFields };
   }
 
   if (generation === GENERATION_UUID) {

package/src/object-manager.ts

@@ -21,7 +21,7 @@ import {
 import { coerceRowOnRead, coerceRowOnWrite } from "./type-coercer.js";
 import { decodeRef, encodeRef } from "./ref-codec.js";
 import { runValidators } from "./validator-runner.js";
-import { resolveIdentity } from "./identity-strategy.js";
+import { resolveIdentity, type IdentityResolution } from "./identity-strategy.js";
 import {
   viewFieldNames,
   fieldViewSpec, entityViewSpec,
@@ -185,7 +185,7 @@ export class ObjectManager {
     const ident = resolveIdentity(entity, restricted);
     const merged: Row = { ...restricted, ...ident.values };
 
-    const validation = runValidators(entity, merged);
+    const validation = runValidators(entity, merged, storeFilledOpts(ident));
     if (!validation.ok) {
       throw new ValidationError(formatValidationMessage(entityName, validation.errors), { entity: entityName, errors: validation.errors });
     }
@@ -252,7 +252,7 @@ export class ObjectManager {
       const restricted = this.applyViewRestriction(entity, data, opts.view);
       const ident = resolveIdentity(entity, restricted);
       const merged: Row = { ...restricted, ...ident.values };
-      const v = runValidators(entity, merged);
+      const v = runValidators(entity, merged, storeFilledOpts(ident));
       if (!v.ok) {
         throw new ValidationError(formatValidationMessage(entityName, v.errors), { entity: entityName, errors: v.errors });
       }
@@ -502,6 +502,11 @@ function requireNonEmptyFilter(
   return where;
 }
 
+/** A driver-generated key is filled by the store on insert, so an absent one is not a required failure. */
+function storeFilledOpts(ident: IdentityResolution): { storeFilled?: readonly string[] } {
+  return ident.kind === "driver-generated" ? { storeFilled: ident.fields } : {};
+}
+
 function formatValidationMessage(entityName: string, errors: { field: string; rule: string }[]): string {
   const summary = errors.map((e) => `${e.field}: ${e.rule}`).join("; ");
   return `Validation failed for ${entityName} (${summary})`;