@opensaas/stack-core 0.41.0 → 0.42.1

package/src/config/types.ts

@@ -1,4 +1,9 @@
-import type { AccessControl, FieldAccess } from '../access/types.js'
+import type {
+  AccessControl,
+  AccessControlledDB,
+  FieldAccess,
+  PrismaClientLike,
+} from '../access/types.js'
 import type { FilterSpec } from '../filter/types.js'
 import type { z } from 'zod'
 
@@ -21,7 +26,7 @@ export type FieldResolveInputHookArgs<
       inputData: TTypeInfo['inputs']['create']
       item: undefined
       resolvedData: TTypeInfo['inputs']['create']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
@@ -30,7 +35,7 @@ export type FieldResolveInputHookArgs<
       inputData: TTypeInfo['inputs']['update']
       item: TTypeInfo['item']
       resolvedData: TTypeInfo['inputs']['update']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
 
 /** Arguments for {@link FieldHooks.validate} (and its deprecated `validateInput` alias). */
@@ -45,7 +50,7 @@ export type FieldValidateHookArgs<
       inputData: TTypeInfo['inputs']['create']
       item: undefined
       resolvedData: TTypeInfo['inputs']['create']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
       addValidationError: (msg: string) => void
     }
   | {
@@ -55,7 +60,7 @@ export type FieldValidateHookArgs<
       inputData: TTypeInfo['inputs']['update']
       item: TTypeInfo['item']
       resolvedData: TTypeInfo['inputs']['update']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
       addValidationError: (msg: string) => void
     }
   | {
@@ -63,7 +68,7 @@ export type FieldValidateHookArgs<
       fieldKey: TFieldKey
       operation: 'delete'
       item: TTypeInfo['item']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
       addValidationError: (msg: string) => void
     }
 
@@ -78,7 +83,7 @@ export type FieldBeforeOperationHookArgs<
       operation: 'create'
       inputData: TTypeInfo['inputs']['create']
       resolvedData: TTypeInfo['inputs']['create']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
@@ -87,14 +92,14 @@ export type FieldBeforeOperationHookArgs<
       inputData: TTypeInfo['inputs']['update']
       item: TTypeInfo['item']
       resolvedData: TTypeInfo['inputs']['update']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
       fieldKey: TFieldKey
       operation: 'delete'
       item: TTypeInfo['item']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
 
 /** Arguments for {@link FieldHooks.afterOperation}. */
@@ -109,7 +114,7 @@ export type FieldAfterOperationHookArgs<
       inputData: TTypeInfo['inputs']['create']
       item: TTypeInfo['item']
       resolvedData: TTypeInfo['inputs']['create']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
@@ -119,14 +124,14 @@ export type FieldAfterOperationHookArgs<
       originalItem: TTypeInfo['item']
       item: TTypeInfo['item']
       resolvedData: TTypeInfo['inputs']['update']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
       fieldKey: TFieldKey
       operation: 'delete'
       originalItem: TTypeInfo['item']
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
 
 /**
@@ -150,7 +155,7 @@ export type FieldBeforeTransactionHookArgs<
       fieldKey: TFieldKey
       operation: 'create'
       inputData: TTypeInfo['inputs']['create']
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
@@ -158,14 +163,14 @@ export type FieldBeforeTransactionHookArgs<
       operation: 'update'
       inputData: TTypeInfo['inputs']['update']
       item: TTypeInfo['item'] | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
       fieldKey: TFieldKey
       operation: 'delete'
       item: TTypeInfo['item'] | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
 
 /**
@@ -196,7 +201,7 @@ export type FieldAfterTransactionHookArgs<
       inputData: TTypeInfo['inputs']['create']
       /** Persisted row — populated for the top-level list only; `undefined` for nested lists. */
       item: TTypeInfo['item'] | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
@@ -205,7 +210,7 @@ export type FieldAfterTransactionHookArgs<
       status: 'rolled-back'
       inputData: TTypeInfo['inputs']['create']
       error: unknown
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
@@ -217,7 +222,7 @@ export type FieldAfterTransactionHookArgs<
       originalItem: TTypeInfo['item'] | undefined
       /** Persisted row — populated for the top-level list only; `undefined` for nested lists. */
       item: TTypeInfo['item'] | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
@@ -227,7 +232,7 @@ export type FieldAfterTransactionHookArgs<
       inputData: TTypeInfo['inputs']['update']
       originalItem: TTypeInfo['item'] | undefined
       error: unknown
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
@@ -236,7 +241,7 @@ export type FieldAfterTransactionHookArgs<
       status: 'committed'
       /** Pre-write row — populated for the top-level list only; `undefined` for nested lists. */
       originalItem: TTypeInfo['item'] | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
   | {
       listKey: string
@@ -245,7 +250,7 @@ export type FieldAfterTransactionHookArgs<
       status: 'rolled-back'
       originalItem: TTypeInfo['item'] | undefined
       error: unknown
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
     }
 
 /** Arguments for {@link FieldHooks.resolveOutput}. */
@@ -258,7 +263,7 @@ export type FieldResolveOutputHookArgs<
   item: TTypeInfo['item']
   listKey: string
   fieldName: TFieldKey
-  context: import('../access/types.js').AccessContext
+  context: import('../access/types.js').AccessContext<TTypeInfo['prisma'], TTypeInfo['db']>
 }
 
 /**
@@ -1499,9 +1504,17 @@ export type GetFieldValueType<
  *
  * @template TKey - The list key/name (e.g., 'Post', 'User')
  * @template TFields - The fields configuration for the list
+ * @template TPrisma - The consuming app's own Prisma client type. Defaults to
+ *   {@link PrismaClientLike} so a `TypeInfo` written (or defaulted) without it
+ *   keeps today's behaviour — a hook's `context` resolves to `StackContext`
+ *   over an unnamed client, same as before this member existed.
  * @template TItem - The output type (Prisma model type)
  * @template TCreateInput - The Prisma create input type
  * @template TUpdateInput - The Prisma update input type
+ * @template TDb - The app's own generated `db` surface (the CLI's `CustomDB`),
+ *   with virtual and transformed fields folded into every list's payload.
+ *   Defaults to `AccessControlledDB<TPrisma>` — the plain Prisma-shaped view —
+ *   so a `TypeInfo` written (or defaulted) without it keeps today's behaviour.
  *
  * @example
  * ```typescript
@@ -1513,12 +1526,16 @@ export type GetFieldValueType<
  *     create: Prisma.PostCreateInput
  *     update: Prisma.PostUpdateInput
  *   }
+ *   prisma: PrismaClient
+ *   db: CustomDB
  * }
  * ```
  */
 export interface TypeInfo<
   TKey extends string = string,
   TFields extends Record<string, any> = Record<string, any>, // eslint-disable-line @typescript-eslint/no-explicit-any -- TypeInfo must accept any field record
+  TPrisma extends PrismaClientLike = PrismaClientLike,
+  TDb = AccessControlledDB<TPrisma>,
 > {
   key: TKey
   fields: TFields
@@ -1527,6 +1544,18 @@ export interface TypeInfo<
     create: any // eslint-disable-line @typescript-eslint/no-explicit-any -- Prisma input types are generated and vary per list
     update: any // eslint-disable-line @typescript-eslint/no-explicit-any -- Prisma input types are generated and vary per list
   }
+  /**
+   * The consuming app's own Prisma client type, so a hook's `context` can be
+   * keyed as `StackContext<TPrisma>`/`AccessContext<TPrisma>` instead of
+   * resolving through the unparameterised {@link PrismaClientLike} default.
+   */
+  prisma: TPrisma
+  /**
+   * The app's own generated `db` surface (see {@link TDb}), so a hook's
+   * `context.db` describes the same virtual/transformed-field-augmented rows
+   * the app's own generated `db` surface produces for the same read (#1232).
+   */
+  db: TDb
 }
 
 // Generic `any` default allows OperationAccess to work with any list item type
@@ -1602,6 +1631,8 @@ export type ResolveInputHookArgs<
   TOutput = Record<string, unknown>,
   TCreateInput = Record<string, unknown>,
   TUpdateInput = Record<string, unknown>,
+  TPrisma extends PrismaClientLike = PrismaClientLike,
+  TDb = AccessControlledDB<TPrisma>,
 > =
   | {
       listKey: string
@@ -1609,7 +1640,7 @@ export type ResolveInputHookArgs<
       inputData: TCreateInput
       resolvedData: TCreateInput
       item: undefined
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
     }
   | {
       listKey: string
@@ -1617,7 +1648,7 @@ export type ResolveInputHookArgs<
       inputData: TUpdateInput
       resolvedData: TUpdateInput
       item: TOutput
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
     }
 
 /**
@@ -1630,6 +1661,8 @@ export type ValidateHookArgs<
   TOutput = Record<string, unknown>,
   TCreateInput = Record<string, unknown>,
   TUpdateInput = Record<string, unknown>,
+  TPrisma extends PrismaClientLike = PrismaClientLike,
+  TDb = AccessControlledDB<TPrisma>,
 > =
   | {
       listKey: string
@@ -1637,7 +1670,7 @@ export type ValidateHookArgs<
       inputData: TCreateInput
       resolvedData: TCreateInput
       item: undefined
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
       addValidationError: (msg: string) => void
     }
   | {
@@ -1646,14 +1679,14 @@ export type ValidateHookArgs<
       inputData: TUpdateInput
       resolvedData: TUpdateInput
       item: TOutput
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
       addValidationError: (msg: string) => void
     }
   | {
       listKey: string
       operation: 'delete'
       item: TOutput
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
       addValidationError: (msg: string) => void
     }
 
@@ -1667,13 +1700,15 @@ export type BeforeOperationHookArgs<
   TOutput = Record<string, unknown>,
   TCreateInput = Record<string, unknown>,
   TUpdateInput = Record<string, unknown>,
+  TPrisma extends PrismaClientLike = PrismaClientLike,
+  TDb = AccessControlledDB<TPrisma>,
 > =
   | {
       listKey: string
       operation: 'create'
       inputData: TCreateInput
       resolvedData: TCreateInput
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
     }
   | {
       listKey: string
@@ -1681,13 +1716,13 @@ export type BeforeOperationHookArgs<
       inputData: TUpdateInput
       item: TOutput
       resolvedData: TUpdateInput
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
     }
   | {
       listKey: string
       operation: 'delete'
       item: TOutput
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
     }
 
 /**
@@ -1700,6 +1735,8 @@ export type AfterOperationHookArgs<
   TOutput = Record<string, unknown>,
   TCreateInput = Record<string, unknown>,
   TUpdateInput = Record<string, unknown>,
+  TPrisma extends PrismaClientLike = PrismaClientLike,
+  TDb = AccessControlledDB<TPrisma>,
 > =
   | {
       listKey: string
@@ -1707,7 +1744,7 @@ export type AfterOperationHookArgs<
       inputData: TCreateInput
       item: TOutput
       resolvedData: TCreateInput
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
     }
   | {
       listKey: string
@@ -1716,13 +1753,13 @@ export type AfterOperationHookArgs<
       originalItem: TOutput
       item: TOutput
       resolvedData: TUpdateInput
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
     }
   | {
       listKey: string
       operation: 'delete'
       originalItem: TOutput
-      context: import('../context/index.js').StackContext
+      context: import('../context/index.js').StackContext<TPrisma, TDb>
     }
 
 /**
@@ -1738,25 +1775,27 @@ export type BeforeTransactionHookArgs<
   TOutput = Record<string, unknown>,
   TCreateInput = Record<string, unknown>,
   TUpdateInput = Record<string, unknown>,
+  TPrisma extends PrismaClientLike = PrismaClientLike,
+  TDb = AccessControlledDB<TPrisma>,
 > =
   | {
       listKey: string
       operation: 'create'
       inputData: TCreateInput
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TPrisma, TDb>
     }
   | {
       listKey: string
       operation: 'update'
       inputData: TUpdateInput
       item: TOutput | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TPrisma, TDb>
     }
   | {
       listKey: string
       operation: 'delete'
       item: TOutput | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TPrisma, TDb>
     }
 
 /**
@@ -1781,6 +1820,8 @@ export type AfterTransactionHookArgs<
   TOutput = Record<string, unknown>,
   TCreateInput = Record<string, unknown>,
   TUpdateInput = Record<string, unknown>,
+  TPrisma extends PrismaClientLike = PrismaClientLike,
+  TDb = AccessControlledDB<TPrisma>,
 > =
   | {
       listKey: string
@@ -1789,7 +1830,7 @@ export type AfterTransactionHookArgs<
       inputData: TCreateInput
       /** Persisted row — populated for the top-level list only; `undefined` for nested lists. */
       item: TOutput | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TPrisma, TDb>
     }
   | {
       listKey: string
@@ -1797,7 +1838,7 @@ export type AfterTransactionHookArgs<
       status: 'rolled-back'
       inputData: TCreateInput
       error: unknown
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TPrisma, TDb>
     }
   | {
       listKey: string
@@ -1808,7 +1849,7 @@ export type AfterTransactionHookArgs<
       originalItem: TOutput | undefined
       /** Persisted row — populated for the top-level list only; `undefined` for nested lists. */
       item: TOutput | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TPrisma, TDb>
     }
   | {
       listKey: string
@@ -1817,7 +1858,7 @@ export type AfterTransactionHookArgs<
       inputData: TUpdateInput
       originalItem: TOutput | undefined
       error: unknown
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TPrisma, TDb>
     }
   | {
       listKey: string
@@ -1825,7 +1866,7 @@ export type AfterTransactionHookArgs<
       status: 'committed'
       /** Pre-write row — populated for the top-level list only; `undefined` for nested lists. */
       originalItem: TOutput | undefined
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TPrisma, TDb>
     }
   | {
       listKey: string
@@ -1833,23 +1874,27 @@ export type AfterTransactionHookArgs<
       status: 'rolled-back'
       originalItem: TOutput | undefined
       error: unknown
-      context: import('../access/types.js').AccessContext
+      context: import('../access/types.js').AccessContext<TPrisma, TDb>
     }
 
 export type Hooks<
   TOutput = Record<string, unknown>,
   TCreateInput = Record<string, unknown>,
   TUpdateInput = Record<string, unknown>,
+  TPrisma extends PrismaClientLike = PrismaClientLike,
+  TDb = AccessControlledDB<TPrisma>,
 > = {
   resolveInput?: (
-    args: ResolveInputHookArgs<TOutput, TCreateInput, TUpdateInput>,
+    args: ResolveInputHookArgs<TOutput, TCreateInput, TUpdateInput, TPrisma, TDb>,
   ) => Promise<TCreateInput | TUpdateInput>
-  validate?: (args: ValidateHookArgs<TOutput, TCreateInput, TUpdateInput>) => Promise<void>
+  validate?: (
+    args: ValidateHookArgs<TOutput, TCreateInput, TUpdateInput, TPrisma, TDb>,
+  ) => Promise<void>
   beforeOperation?: (
-    args: BeforeOperationHookArgs<TOutput, TCreateInput, TUpdateInput>,
+    args: BeforeOperationHookArgs<TOutput, TCreateInput, TUpdateInput, TPrisma, TDb>,
   ) => Promise<void>
   afterOperation?: (
-    args: AfterOperationHookArgs<TOutput, TCreateInput, TUpdateInput>,
+    args: AfterOperationHookArgs<TOutput, TCreateInput, TUpdateInput, TPrisma, TDb>,
   ) => Promise<void>
   /**
    * Side effect BEFORE the write's transaction opens (#590 / ADR-0010).
@@ -1858,7 +1903,7 @@ export type Hooks<
    * with `status: 'rolled-back'`. See {@link BeforeTransactionHookArgs}.
    */
   beforeTransaction?: (
-    args: BeforeTransactionHookArgs<TOutput, TCreateInput, TUpdateInput>,
+    args: BeforeTransactionHookArgs<TOutput, TCreateInput, TUpdateInput, TPrisma, TDb>,
   ) => Promise<void> | void
   /**
    * Side effect AFTER the write's transaction settles (#590 / ADR-0010).
@@ -1869,12 +1914,14 @@ export type Hooks<
    * {@link AfterTransactionHookArgs}.
    */
   afterTransaction?: (
-    args: AfterTransactionHookArgs<TOutput, TCreateInput, TUpdateInput>,
+    args: AfterTransactionHookArgs<TOutput, TCreateInput, TUpdateInput, TPrisma, TDb>,
   ) => Promise<void> | void
   /**
    * @deprecated Use 'validate' instead. This alias is provided for backwards compatibility.
    */
-  validateInput?: (args: ValidateHookArgs<TOutput, TCreateInput, TUpdateInput>) => Promise<void>
+  validateInput?: (
+    args: ValidateHookArgs<TOutput, TCreateInput, TUpdateInput, TPrisma, TDb>,
+  ) => Promise<void>
 }
 
 /**
@@ -1938,7 +1985,13 @@ export type ListConfig<TTypeInfo extends TypeInfo> = {
   access?: {
     operation?: OperationAccess<TTypeInfo['item']>
   }
-  hooks?: Hooks<TTypeInfo['item'], TTypeInfo['inputs']['create'], TTypeInfo['inputs']['update']>
+  hooks?: Hooks<
+    TTypeInfo['item'],
+    TTypeInfo['inputs']['create'],
+    TTypeInfo['inputs']['update'],
+    TTypeInfo['prisma'],
+    TTypeInfo['db']
+  >
   /**
    * Database configuration for this list (model level)
    */

package/src/context/index.ts

@@ -313,8 +313,20 @@ interface TransactionCapable<TPrisma> {
  * still runs access control), and `transaction()` (interactive, hook-firing
  * transaction). All access-checked operations run their list/field hooks.
  */
-export interface StackContext<TPrisma extends PrismaClientLike = PrismaClientLike> {
-  db: AccessControlledDB<TPrisma>
+export interface StackContext<
+  TPrisma extends PrismaClientLike = PrismaClientLike,
+  // Defaults to the plain Prisma-shaped view (#1232). The generator points a
+  // list's `TypeInfo['db']` at its own generated `CustomDB` — the same
+  // virtual/transformed-field-augmented description `context.db` already
+  // resolves to outside a hook — so a hook's `context: StackContext<TPrisma,
+  // TDb>` (keyed via `TTypeInfo['db']`) describes the same rows. Left
+  // unconstrained (no `extends AccessControlledDB<TPrisma>`) — `CustomDB`'s
+  // per-list payload requires strictly more keys than the raw Prisma payload,
+  // so constraining this parameter would reintroduce the assignability gap
+  // #1233 already worked around for the fragment overload, one level higher.
+  TDb = AccessControlledDB<TPrisma>,
+> {
+  db: TDb
   session: Session | null
   prisma: TPrisma
   storage: StorageUtils
@@ -342,10 +354,10 @@ export interface StackContext<TPrisma extends PrismaClientLike = PrismaClientLik
    * plugin service) for writes that must be atomic with the transaction.
    */
   transaction: <T>(
-    fn: (txContext: StackContext<TPrisma>) => Promise<T>,
+    fn: (txContext: StackContext<TPrisma, TDb>) => Promise<T>,
     options?: TransactionOptions,
   ) => Promise<T>
-  sudo: () => StackContext<TPrisma>
+  sudo: () => StackContext<TPrisma, TDb>
   /**
    * Derive a context identical to this one except for its session, reusing
    * the already-resolved config and this context's own client (including a
@@ -362,7 +374,7 @@ export interface StackContext<TPrisma extends PrismaClientLike = PrismaClientLik
    * state (elevated stays elevated), so `context.withSession(s).sudo()` and
    * `context.sudo().withSession(s)` are equivalent.
    */
-  withSession: (session: Session | null) => StackContext<TPrisma>
+  withSession: (session: Session | null) => StackContext<TPrisma, TDb>
   _isSudo: boolean
   /**
    * @internal Present so a hook-bound `StackContext` (issue #1176) satisfies

package/src/internal.ts

@@ -19,8 +19,8 @@ export type {
   FindManyQueryArgs,
 } from './access/types.js'
 
-// Typed-query internals (Fragment/FieldSelection appear in generated types)
-export type { Fragment, FieldSelection } from './query/index.js'
+// Typed-query internals (Fragment/FieldSelection/ResultOf appear in generated types)
+export type { Fragment, FieldSelection, ResultOf } from './query/index.js'
 
 // Password hashing internals (the password field emits HashedPassword into generated types)
 export {