refactor(prisma-next): address CodeRabbit review (centralize v3 index guard, fix docs/test labels)

- Move V3_INDEX_VALUES + isV3Index to v3/domain-map.ts (single source of truth;
  was duplicated in derive-schemas.ts and codec-hooks-v3.ts).
- Align vendor-script run comment with REFRESH_EQL_V3.md (node --experimental-strip-types).
- Rename the mislabeled e2e 'NULL round-trips' test (UserV3 columns are NOT NULL).

Author: tobyhede

examples/prisma/test/e2e/str-v3.e2e.test.ts

@@ -88,9 +88,9 @@ describe.skipIf(!dbUrl)('EQL v3 String e2e (live PG + eql_v3 + ZeroKMS)', () =>
     expect(rows.map((r) => r.id).sort()).toEqual(expected)
   })
 
-  it('NULL round-trips: a null v3 column decrypts back to null', async () => {
+  it('insert + decrypt round-trips a freshly-created v3 row (UserV3 columns are NOT NULL)', async () => {
     await db.orm.UserV3.create({
-      id: 'e2e-strv3-null',
+      id: 'e2e-strv3-extra',
       email: EncryptedString.from('present'),
       bio: EncryptedString.from('present'),
       name: EncryptedString.from('present'),

packages/prisma-next/scripts/vendor-eql-v3-install.ts

@@ -1,7 +1,8 @@
 // Regenerates src/migration/eql-v3-install.generated.ts from the vendored
 // __tests__/fixtures/cipherstash-encrypt-v3.sql installer.
 //
-// Run: pnpm tsx scripts/vendor-eql-v3-install.ts
+// Run (tsx is not installed in this workspace; Node 22+ runs the TS directly):
+//   node --experimental-strip-types scripts/vendor-eql-v3-install.ts
 //
 // See scripts/REFRESH_EQL_V3.md for the full refresh procedure (which EQL commit
 // the fixture is built from, the cross-package duplication hazard, etc.).

packages/prisma-next/src/migration/codec-hooks-v3.ts

@@ -15,13 +15,7 @@
  */
 
 import type { CodecControlHooks } from '@prisma-next/family-sql/control'
-import { type V3Index, eqlV3Domain } from '../v3/domain-map'
-
-const V3_INDEX_VALUES = ['equality', 'freeTextSearch', 'orderAndRange'] as const
-
-function isV3Index(value: unknown): value is V3Index {
-  return typeof value === 'string' && (V3_INDEX_VALUES as readonly string[]).includes(value)
-}
+import { eqlV3Domain, isV3Index } from '../v3/domain-map'
 
 const expandNativeType: NonNullable<CodecControlHooks['expandNativeType']> = ({ typeParams }) => {
   const index = typeParams?.['index']

packages/prisma-next/src/stack/derive-schemas.ts

@@ -33,7 +33,7 @@ import {
   isCipherstashCodecId,
   isCipherstashV3CodecId,
 } from '../extension-metadata/constants'
-import { type V3Index, v3CastAs } from '../v3/domain-map'
+import { V3_INDEX_VALUES, isV3Index, v3CastAs } from '../v3/domain-map'
 
 /**
  * Structural shape of the subset of `contract.json` this derivation
@@ -155,12 +155,6 @@ function isCipherstashFlag(value: string): value is CipherstashFlag {
   return value in FLAG_DISPATCH
 }
 
-const V3_INDEX_VALUES = ['equality', 'freeTextSearch', 'orderAndRange'] as const
-
-function isV3Index(value: unknown): value is V3Index {
-  return typeof value === 'string' && (V3_INDEX_VALUES as readonly string[]).includes(value)
-}
-
 /**
  * Apply a v3 column's single index. `typeParams.index` is `unknown` (the contract
  * view types typeParams as `Record<string, unknown> | null`), so narrow with

packages/prisma-next/src/v3/domain-map.ts

@@ -18,6 +18,14 @@ export type V3DataType = 'text'
 /** v3 single-capability index choices for the text scalar. */
 export type V3Index = 'equality' | 'freeTextSearch' | 'orderAndRange'
 
+/** The closed set of v3 index values, as a runtime array (SSOT for {@link isV3Index}). */
+export const V3_INDEX_VALUES = ['equality', 'freeTextSearch', 'orderAndRange'] as const
+
+/** Narrow an `unknown` (e.g. a `typeParams.index` read from a contract) to {@link V3Index}. */
+export function isV3Index(value: unknown): value is V3Index {
+  return typeof value === 'string' && (V3_INDEX_VALUES as readonly string[]).includes(value)
+}
+
 /**
  * Per-scalar capability table. Keyed by scalar so adding int/date/timestamptz is
  * a type-shape extension (new key + its valid index subset), not a row append