@murumets-ee/entity 0.11.0 → 0.12.0

package/dist/admin/index.d.mts

@@ -184,6 +184,122 @@ type InferCreateInput<Fields extends Record<string, FieldConfig>> = Omit<{ [K in
 type ImmutableFields = 'id' | 'createdAt' | 'createdBy';
 type InferUpdateInput<Fields extends Record<string, FieldConfig>> = { [K in keyof Fields as K extends ImmutableFields ? never : K]?: FieldToTS<Fields[K]> | null };
 //#endregion
+//#region src/behaviors/types.d.ts
+/**
+ * Structural shape of a queue `JobDefinition` as seen by behaviors.
+ *
+ * The entity package CANNOT import `@murumets-ee/queue` (would form a
+ * cycle through `@murumets-ee/core`'s registry — see CLAUDE.md
+ * "Package boundaries"). Instead, behaviors receive an `EnqueueOnCommit`
+ * function via `BehaviorContext`, and the queue's `JobDefinition<T>`
+ * is structurally compatible with this minimal shape. The actual
+ * payload validation runs inside the queue when the wrapped resolver
+ * forwards the call.
+ */
+interface JobLike {
+  readonly name: string;
+}
+/**
+ * Resolver shape for `BehaviorContext.enqueueOnCommit`. Synchronous,
+ * fire-and-forget — the resolver writes the row in the background and
+ * logs failures; behaviors do NOT await.
+ *
+ * Intended semantics (PLAN-OUTBOX §4.2): the row INSERT participates
+ * in the AdminClient operation's transaction — commit makes the job
+ * visible to the worker, rollback removes it. As of PR D this is the
+ * actual semantics: AdminClient threads its tx into the
+ * `EnqueueOnCommitFactory` once per call and passes the result through
+ * to behaviors. When the queue plugin is not loaded the field is
+ * `undefined` and behaviors no-op (per §6 Q6).
+ */
+type EnqueueOnCommit = (job: JobLike, payload: unknown) => void;
+/**
+ * Factory that returns an {@link EnqueueOnCommit} resolver bound to an
+ * optional Drizzle transaction handle. AdminClient invokes this once
+ * per CRUD operation, passing the active tx so behaviors firing inside
+ * the operation enqueue rows that commit (or roll back) atomically
+ * with the entity write.
+ *
+ * The `tx` parameter is intentionally typed as `unknown` here — the
+ * entity package CANNOT import `drizzle-orm/postgres-js` types without
+ * pulling in the database stack and breaking its leaf-package contract.
+ * The queue plugin (which writes the slot) and AdminClient (which
+ * supplies the tx) both work with the precise `PostgresJsDatabase`
+ * shape; the interior of the factory casts as needed.
+ *
+ * **Mirror definition** lives in
+ * `packages/queue/src/enqueue-on-commit-slot.ts` with `tx?:
+ * PostgresJsDatabase`. The two are structurally compatible by design;
+ * if you rename or change one, change both. The runtime contract is
+ * the same — only the type-time visibility of the parameter differs.
+ */
+type EnqueueOnCommitFactory = (tx?: unknown) => EnqueueOnCommit;
+/**
+ * Context passed to behavior hooks. Resolved once per request by AdminClient
+ * from its `contextResolver` and forwarded into every hook so behaviors never
+ * have to reach into AsyncLocalStorage themselves — that pattern breaks under
+ * bundlers (e.g. Turbopack) that duplicate module instances across boundaries.
+ *
+ * `loadCurrent` returns the *pre-update* entity row. It is eagerly loaded
+ * by AdminClient before any hooks fire on the **update** codepath and
+ * cached for the rest of that call — so calling it from `beforeUpdate`
+ * or `afterUpdate` returns the SAME snapshot regardless of whether a
+ * sibling hook touched it. Returns `null` when no entity matches the id
+ * (rare — usually means the row was deleted concurrently). On `create`
+ * AND `delete` codepaths, `loadCurrent` is undefined: create has no
+ * pre-state, and delete hooks receive the entity id directly via their
+ * first argument so a separate snapshot is unnecessary.
+ *
+ * `afterUpdate` always receives the post-update row as its first argument,
+ * so the (`row`, `loadCurrent()`) pair gives hooks a complete (after, before)
+ * view without per-call Map state. The eager load costs one extra
+ * `findById` per update; updates are not a hot path in this codebase, and
+ * the consistency win — no foot-gun for hook authors — is worth it.
+ *
+ * `viaInternal` is `true` when the hook is running on an `AdminClient.updateInternal`
+ * call (the trusted server-side path; public PATCH always sets it false).
+ * Hooks SHOULD treat this as informational only — the route layer has
+ * authorized the *capability*, but the hook is still responsible for
+ * enforcing structural invariants. Workflowable, for example, validates
+ * the `_workflowStatus` transition table on every update regardless of
+ * `viaInternal` so that even a route-layer bug cannot push the workflow
+ * row into an illegal state. Use `viaInternal` when a hook genuinely
+ * needs to differentiate (e.g. side effects that should only fire when
+ * a real user — not the seed loader — initiates the change).
+ *
+ * `enqueueOnCommit` is the outbox entry point for projection-style hooks
+ * (PR C of PLAN-OUTBOX). When wired (the queue plugin is available in
+ * the running app), behaviors can enqueue side-effect jobs without
+ * importing the queue package directly, keeping entity-as-leaf invariant
+ * intact. Synchronous + fire-and-forget — no await needed in hooks.
+ * Undefined when the AdminClient was constructed without an
+ * `enqueueOnCommit` resolver (e.g. CLI scripts that don't load the
+ * queue plugin); behaviors that depend on it must guard with `if
+ * (ctx.enqueueOnCommit) { ... }` or document the dependency loudly.
+ */
+interface BehaviorContext {
+  user?: {
+    id: string;
+    name?: string;
+    email?: string;
+  };
+  loadCurrent?: () => Promise<Record<string, unknown> | null>;
+  viaInternal?: boolean;
+  enqueueOnCommit?: EnqueueOnCommit;
+}
+interface Behavior<F extends Record<string, FieldConfig> = {}> {
+  name: string;
+  fields?: F;
+  hooks?: {
+    beforeCreate?: (data: Record<string, unknown>, ctx?: BehaviorContext) => Promise<Record<string, unknown>>;
+    afterCreate?: (entity: Record<string, unknown>, ctx?: BehaviorContext) => Promise<void>;
+    beforeUpdate?: (id: string, data: Record<string, unknown>, ctx?: BehaviorContext) => Promise<Record<string, unknown>>;
+    afterUpdate?: (entity: Record<string, unknown>, ctx?: BehaviorContext) => Promise<void>;
+    beforeDelete?: (id: string, ctx?: BehaviorContext) => Promise<void>;
+    afterDelete?: (id: string, ctx?: BehaviorContext) => Promise<void>;
+  };
+}
+//#endregion
 //#region src/cursor.d.ts
 /** Cursor input for keyset pagination. */
 interface CursorInput {
@@ -194,7 +310,7 @@ interface CursorInput {
   /** Sort direction — must match the ORDER BY direction. */
   direction: 'asc' | 'desc';
   /** Tie-breaker: last seen entity ID. Required for non-unique sort fields. */
-  id?: string;
+  id?: string | undefined;
 }
 //#endregion
 //#region src/admin-config.d.ts
@@ -256,53 +372,6 @@ interface EntityAdminConfig {
   hideFromDashboard?: boolean;
 }
 //#endregion
-//#region src/behaviors/types.d.ts
-/**
- * Context passed to behavior hooks. Resolved once per request by AdminClient
- * from its `contextResolver` and forwarded into every hook so behaviors never
- * have to reach into AsyncLocalStorage themselves — that pattern breaks under
- * bundlers (e.g. Turbopack) that duplicate module instances across boundaries.
- *
- * `loadCurrent` is a lazy, memoized loader for the *current* entity row,
- * provided by AdminClient on update/delete codepaths. Hooks that need to
- * validate against the existing state (e.g. workflowable's transition
- * checker) call it; behaviors that don't, don't pay for the round trip.
- * Returns `null` when no entity matches the id (rare — usually means the
- * row was deleted concurrently). On create, `loadCurrent` is undefined.
- *
- * `viaInternal` is `true` when the hook is running on an `AdminClient.updateInternal`
- * call (the trusted server-side path; public PATCH always sets it false).
- * Hooks SHOULD treat this as informational only — the route layer has
- * authorized the *capability*, but the hook is still responsible for
- * enforcing structural invariants. Workflowable, for example, validates
- * the `_workflowStatus` transition table on every update regardless of
- * `viaInternal` so that even a route-layer bug cannot push the workflow
- * row into an illegal state. Use `viaInternal` when a hook genuinely
- * needs to differentiate (e.g. side effects that should only fire when
- * a real user — not the seed loader — initiates the change).
- */
-interface BehaviorContext {
-  user?: {
-    id: string;
-    name?: string;
-    email?: string;
-  };
-  loadCurrent?: () => Promise<Record<string, unknown> | null>;
-  viaInternal?: boolean;
-}
-interface Behavior<F extends Record<string, FieldConfig> = {}> {
-  name: string;
-  fields?: F;
-  hooks?: {
-    beforeCreate?: (data: Record<string, unknown>, ctx?: BehaviorContext) => Promise<Record<string, unknown>>;
-    afterCreate?: (entity: Record<string, unknown>, ctx?: BehaviorContext) => Promise<void>;
-    beforeUpdate?: (id: string, data: Record<string, unknown>, ctx?: BehaviorContext) => Promise<Record<string, unknown>>;
-    afterUpdate?: (entity: Record<string, unknown>, ctx?: BehaviorContext) => Promise<void>;
-    beforeDelete?: (id: string, ctx?: BehaviorContext) => Promise<void>;
-    afterDelete?: (id: string, ctx?: BehaviorContext) => Promise<void>;
-  };
-}
-//#endregion
 //#region src/define-entity.d.ts
 /**
  * A fully resolved entity with merged behavior fields.
@@ -380,32 +449,64 @@ type EntityResolver = () => Map<string, Entity> | undefined;
 interface AdminClientConfig<AllFields extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
   entity: Entity<AllFields>;
   db: PostgresJsDatabase;
-  logger?: Logger;
+  logger?: Logger | undefined;
   /** Optional count cache for COUNT(*) query optimization. */
-  countCache?: CountCacheLike;
+  countCache?: CountCacheLike | undefined;
   /**
    * Resolves the current request's security context (user, role checker, scope).
    * Provided automatically by `createAdminClient()` from @murumets-ee/core/clients.
    * For direct `new AdminClient()` usage, pass your own resolver or use `runAsCli()`.
    */
-  contextResolver?: ContextResolver;
+  contextResolver?: ContextResolver | undefined;
   /**
    * Resolves the running app's entity registry. Used by cascade delete to
    * read each referencing field's `onDelete` strategy. When omitted, all
    * incoming references are treated as `restrict` — a safe default that
    * blocks deletes rather than guessing.
    */
-  entityResolver?: EntityResolver;
+  entityResolver?: EntityResolver | undefined;
+  /**
+   * Outbox entry point exposed on `BehaviorContext.enqueueOnCommit`
+   * (PR C of PLAN-OUTBOX). When provided, projection-style behaviors can
+   * fire side-effect jobs from their hooks without importing the queue
+   * package — the entity package stays a leaf in the dependency graph.
+   *
+   * Used as a fallback when `enqueueOnCommitFactory` is not supplied:
+   * AdminClient passes this resolver verbatim into hook contexts, and
+   * the row INSERT is NOT bound to the operation's transaction. Tests
+   * that need to capture call-site behavior without wiring queue can
+   * pass this directly.
+   *
+   * In production wiring (`createAdminClient` in
+   * `@murumets-ee/core/clients`), prefer `enqueueOnCommitFactory` —
+   * that's the form that delivers PLAN-OUTBOX §4.2's "rollback removes
+   * the job" guarantee.
+   */
+  enqueueOnCommit?: BehaviorContext['enqueueOnCommit'] | undefined;
+  /**
+   * Outbox factory exposed on `BehaviorContext.enqueueOnCommit` (PR D
+   * of PLAN-OUTBOX). When provided, AdminClient invokes the factory
+   * once per CRUD operation with the active Drizzle transaction so the
+   * resulting fire-and-forget resolver routes its INSERT through that
+   * tx. Hook-fired enqueues commit (or roll back) atomically with the
+   * entity write — the canonical PLAN-OUTBOX §4.2 semantics.
+   *
+   * Wired by `createAdminClient()` in `@murumets-ee/core/clients`
+   * against the running app's queue plugin. Takes precedence over the
+   * older `enqueueOnCommit` field when both are set; CLI scripts that
+   * don't load the queue plugin omit both.
+   */
+  enqueueOnCommitFactory?: EnqueueOnCommitFactory | undefined;
 }
 interface FindManyOptions {
   where?: SQL | undefined;
-  limit?: number;
-  offset?: number;
-  orderBy?: SQL | SQL[];
-  locale?: string;
+  limit?: number | undefined;
+  offset?: number | undefined;
+  orderBy?: SQL | SQL[] | undefined;
+  locale?: string | undefined;
   /** Default content locale. For localized blocks, NULL rows (from initial create)
    *  are only returned as fallback when locale matches defaultLocale. */
-  defaultLocale?: string;
+  defaultLocale?: string | undefined;
   /**
    * Cursor-based (keyset) pagination. When provided, replaces OFFSET with a
    * WHERE condition for O(1) page access at any depth. The `offset` option
@@ -413,13 +514,13 @@ interface FindManyOptions {
    *
    * The cursor `field` must be a real column on the entity table.
    */
-  cursor?: CursorInput;
+  cursor?: CursorInput | undefined;
   /**
    * Include fields marked `internal: true` (and legacy `_`-prefixed
    * infrastructure columns) in the returned DTOs. Use only on trusted
    * server-side reads that need to inspect state-machine fields.
    */
-  includeInternal?: boolean;
+  includeInternal?: boolean | undefined;
 }
 interface CountOptions {
   where?: SQL | undefined;
@@ -461,8 +562,56 @@ declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record
   private countCache?;
   private contextResolver?;
   private entityResolver?;
-  /** Shared context for entity-data-ops functions. */
+  private enqueueOnCommit?;
+  private enqueueOnCommitFactory?;
+  /** Shared context for entity-data-ops functions, bound to the default db. */
   private get ctx();
+  /**
+   * Build an {@link EntityContext} bound to a specific Drizzle executor.
+   *
+   * Used by the public CRUD methods so that when the caller threads in
+   * `{ tx }` (PR D of PLAN-OUTBOX) every block-load / translation
+   * merge / scope-condition lookup hits the SAME tx as the entity write.
+   * Without this, a `loadBlocks(this.ctx, ...)` call inside an active tx
+   * would query `this.db` (the AdminClient's owned connection) and miss
+   * the in-flight INSERT — `entity_refs` / blocks rows wouldn't be
+   * visible until commit.
+   *
+   * For callers that don't pass a tx, `exec === this.db` and the ctx
+   * matches today's behaviour exactly.
+   */
+  private ctxFor;
+  /**
+   * Build the `enqueueOnCommit` slot of a {@link BehaviorContext} for
+   * the active tx, ready to spread into `resolveAuthContext`'s options
+   * (PR D of PLAN-OUTBOX).
+   *
+   * - When the queue plugin's factory is wired, invoke it with `tx` so
+   *   the resulting fire-and-forget resolver routes its INSERT through
+   *   the caller's transaction (atomic with the entity write).
+   * - When only the legacy static `enqueueOnCommit` option is set, pass
+   *   it through verbatim — used by tests and callers that wired their
+   *   own resolver directly.
+   * - When neither is configured (CLI scripts, no queue plugin), return
+   *   `{}` so the BehaviorContext's `enqueueOnCommit` field stays
+   *   undefined and behaviors guard accordingly.
+   */
+  private buildAuthOptions;
+  /**
+   * Re-bind `behaviorCtx.enqueueOnCommit` to the supplied executor.
+   *
+   * Used by `delete` / `deleteMany` when they open an internal tx
+   * because no caller tx was supplied: the auth context was resolved
+   * BEFORE the tx existed, so its `enqueueOnCommit` (if a factory is
+   * wired) was bound to `undefined` and would commit the queue row
+   * outside the internal tx. Rebinding here ensures the queue write
+   * rolls back with the cascade if anything in `runDelete` throws.
+   *
+   * Spreads conditionally to satisfy `exactOptionalPropertyTypes` —
+   * never assigns `enqueueOnCommit: undefined` (which would clear an
+   * existing static resolver if the factory wasn't configured).
+   */
+  private rebindEnqueueOnCommit;
   constructor(config: AdminClientConfig<AllFields>);
   /**
    * Strip caller-provided values for internal fields from the input.
@@ -478,7 +627,7 @@ declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record
    */
   private pickInternalFields;
   /**
-   * Create a new entity
+   * Create a new entity.
    *
    * Flow:
    * 1. Validate input with Zod
@@ -487,8 +636,26 @@ declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record
    * 4. Insert into database
    * 5. Execute afterCreate hooks
    * 6. Shape DTO and return
+   *
+   * **Caller transaction (`options.tx`)** — PR D of PLAN-OUTBOX. When
+   * supplied, the row INSERT, blocks save, refs sync, and any hook-fired
+   * `enqueueOnCommit` participate in the caller's transaction:
+   *
+   * ```ts
+   * await db.transaction(async (tx) => {
+   *   const order = await orders.create({ ... }, { tx })
+   *   // afterCreate hooks fired with this tx — enqueueOnCommit's INSERT
+   *   // routes through it. Outer rollback removes both atomically.
+   * })
+   * ```
+   *
+   * When omitted, behaviour matches pre-PR-D exactly: each statement
+   * auto-commits, hooks run after commit, and the static
+   * `enqueueOnCommit` resolver (if any) writes outside the entity tx.
    */
-  create(data: InferCreateInput<AllFields>): Promise<InferEntityDTO<AllFields>>;
+  create(data: InferCreateInput<AllFields>, options?: {
+    tx?: PostgresJsDatabase;
+  }): Promise<InferEntityDTO<AllFields>>;
   /**
    * Find entity by ID.
    *
@@ -522,6 +689,7 @@ declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record
    */
   update(id: string, data: InferUpdateInput<AllFields>, options?: {
     locale?: string;
+    tx?: PostgresJsDatabase;
   }): Promise<InferEntityDTO<AllFields>>;
   /**
    * Update entity by ID, allowing writes to fields marked `internal: true`.
@@ -542,18 +710,44 @@ declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record
    */
   updateInternal(id: string, data: Record<string, unknown>, options?: {
     locale?: string;
+    tx?: PostgresJsDatabase;
   }): Promise<InferEntityDTO<AllFields>>;
   private updateImpl;
+  /**
+   * Internal `findById` variant that issues its SELECT through the
+   * caller-supplied executor. Used by `updateImpl` so the pre-update
+   * snapshot reflects any earlier writes the caller already made
+   * inside the same transaction.
+   *
+   * **Scope is NOT optional** — it must be the same `scopeId` that
+   * `resolveAuthContext` produced for the surrounding `update` call.
+   * The eventual UPDATE is scope-gated via its WHERE clause; if this
+   * pre-load skipped scope, hooks with side effects (audit logs,
+   * system-message creation, outbox enqueues) would observe and
+   * dispatch on cross-tenant rows even when the gated UPDATE matches
+   * nothing. See HIGH finding in pr-review for #247.
+   *
+   * Permission check is skipped because `resolveAuthContext` ran first
+   * in the surrounding `update` call.
+   */
+  private findByIdInternal;
   /**
    * Delete entity by ID.
    *
    * Wraps cascade + delete in a transaction so cascaded deletes are rolled
-   * back if the final entity delete fails (no partial data loss).
+   * back if the final entity delete fails (no partial data loss). When
+   * the caller threads in `{ tx }` (PR D of PLAN-OUTBOX), the same tx
+   * is reused — the inner `db.transaction(...)` call is replaced with a
+   * direct invocation of the body, and any hook-fired `enqueueOnCommit`
+   * INSERT routes through the caller's tx so an outer rollback removes
+   * everything atomically.
    *
    * Checks entity_refs for incoming references first — throws
    * ReferencedEntityError if this entity is still used somewhere.
    */
-  delete(id: string): Promise<void>;
+  delete(id: string, options?: {
+    tx?: PostgresJsDatabase;
+  }): Promise<void>;
   /**
    * Delete multiple entities matching a WHERE condition.
    *
@@ -569,7 +763,9 @@ declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record
    *
    * @returns Number of rows deleted
    */
-  deleteMany(where: SQL): Promise<number>;
+  deleteMany(where: SQL, options?: {
+    tx?: PostgresJsDatabase;
+  }): Promise<number>;
   /** Maximum cascade depth to prevent infinite recursion from circular references. */
   private static readonly MAX_CASCADE_DEPTH;
   /**
@@ -634,6 +830,7 @@ declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record
   updateMany(where: SQL, data: Partial<InferUpdateInput<AllFields>>, options?: {
     expressions?: Record<string, SQL>;
     allowInternal?: boolean;
+    tx?: PostgresJsDatabase;
   }): Promise<number>;
   /**
    * Run an aggregate query on this entity's table.
@@ -707,30 +904,66 @@ declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record
   /**
    * Save translation for an entity.
    * Each translatable field is a real column on the translation table.
+   *
+   * **Caller transaction (`options.tx`)** — Phase 4b of PLAN-OUTBOX. When
+   * supplied, the upsert participates in the caller's transaction so a
+   * caller wrapping `entity.create + saveTranslation` in a `db.transaction`
+   * gets atomic visibility — outer rollback removes BOTH the entity row
+   * and the translation row, never leaves an orphan translation pointing
+   * at a now-deleted entity. Without it, the translation would auto-commit
+   * regardless of the outer rollback. No hooks fire on this method, so no
+   * factory plumbing is needed — just routing the SQL through `exec`.
    */
-  saveTranslation(entityId: string, locale: string, translations: Record<string, unknown>): Promise<void>;
+  saveTranslation(entityId: string, locale: string, translations: Record<string, unknown>, options?: {
+    tx?: PostgresJsDatabase;
+  }): Promise<void>;
   /**
-   * PHASE 3: Delete translation(s) for an entity
-   * If locale is provided, deletes specific locale; otherwise deletes all translations
+   * Delete translation(s) for an entity. If `locale` is provided, deletes
+   * the specific locale row; otherwise deletes every translation row for
+   * the entity.
+   *
+   * **Caller transaction (`options.tx`)** — Phase 4b of PLAN-OUTBOX. Same
+   * shape as `saveTranslation` — when supplied, the DELETE participates
+   * in the caller's tx.
    */
-  deleteTranslation(entityId: string, locale?: string): Promise<void>;
+  deleteTranslation(entityId: string, locale?: string, options?: {
+    tx?: PostgresJsDatabase;
+  }): Promise<void>;
   /**
    * Save block-level translations for an entity.
    * For each block in each blocks field, extracts translatable field values
    * and upserts them into {entity}_layout_translations.
    *
    * Block _id must match an existing layout row ID.
+   *
+   * **Caller transaction (`options.tx`)** — Phase 4b of PLAN-OUTBOX.
+   * Routes the layout-row lookup AND every layout-translation upsert
+   * through the supplied tx, so a caller doing
+   * `entity.update + saveBlockTranslations` in one tx gets atomic
+   * visibility on rollback.
    */
-  saveBlockTranslations(entityId: string, locale: string, data: Record<string, unknown>): Promise<void>;
+  saveBlockTranslations(entityId: string, locale: string, data: Record<string, unknown>, options?: {
+    tx?: PostgresJsDatabase;
+  }): Promise<void>;
   /**
    * Save per-locale blocks for an entity.
    * Used for entities with `localized: true` on their blocks field — each locale gets
    * its own independent block layout rows in the layout table.
+   *
+   * **Caller transaction (`options.tx`)** — Phase 4b of PLAN-OUTBOX. Threaded
+   * through to `saveBlocks`, which already accepts an executor.
    */
-  saveLocalizedBlocks(entityId: string, locale: string, data: Record<string, unknown>): Promise<void>;
+  saveLocalizedBlocks(entityId: string, locale: string, data: Record<string, unknown>, options?: {
+    tx?: PostgresJsDatabase;
+  }): Promise<void>;
   /**
    * Save blocks for an entity after create/update.
    * For each blocks field, writes rows to {entity}_layout table.
+   *
+   * `exec` is the active Drizzle executor — either a caller-supplied tx
+   * (PR D of PLAN-OUTBOX) or `this.db`. Routing through it keeps the
+   * blocks INSERTs/DELETEs in the same transaction as the parent
+   * entity write.
    */
   private saveBlocks;
   /**
@@ -740,10 +973,24 @@ declare class AdminClient<AllFields extends Record<string, FieldConfig> = Record
    * - 'update': deletes refs for changed ref-bearing fields, then inserts new ones
    *
    * Gracefully skips if entity_refs table is not registered (e.g. before migration).
+   *
+   * `exec` is the active Drizzle executor — caller-supplied tx (PR D of
+   * PLAN-OUTBOX) or `this.db`. Routes the entity_refs UPDATE/INSERT
+   * through the same transaction as the parent entity write.
    */
   private syncRefs;
   /**
    * Invalidate all count cache entries for this entity.
+   *
+   * **Tx-aware** (PR D of PLAN-OUTBOX). When `inCallerTx === true`, we
+   * skip the invalidation: the caller's tx hasn't committed yet, and
+   * eagerly invalidating would have other connections re-compute the
+   * count from the still-pre-tx state and cache that stale value.
+   * The caller is responsible for invalidating after their own commit
+   * (or accepting the cache TTL self-heal). For internally-managed
+   * txs (no-caller-tx path) and no-tx CRUD calls, the invalidation
+   * runs after the inner `db.transaction(...)` resolves — which only
+   * happens post-commit — so the cache reflects the committed state.
    */
   private invalidateCountCache;
 }

package/dist/admin/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/count-cache.ts","../../src/fields/base.ts","../../src/types/infer.ts","../../src/cursor.ts","../../src/admin-config.ts","../../src/behaviors/types.ts","../../src/define-entity.ts","../../src/shared/entity-data-ops.ts","../../src/types/logger.ts","../../src/admin/client.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/count-cache.ts","../../src/fields/base.ts","../../src/types/infer.ts","../../src/behaviors/types.ts","../../src/cursor.ts","../../src/admin-config.ts","../../src/define-entity.ts","../../src/shared/entity-data-ops.ts","../../src/types/logger.ts","../../src/admin/client.ts"],"mappings":"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"}