refactor(prisma-next): consume @cipherstash/stack/adapter-kit, drop the eql/v3 graduation

The branch had graduated DOMAIN_REGISTRY / factoryForDomain /
stripDomainSchema onto the public eql/v3 barrel while adapter-kit still
exported the same symbols — two doors to one registry. Revert the
graduation and import through adapter-kit, the seam the Drizzle and
Supabase adapters already consume (PR #655 review, item 3). Also make
v3Authored return a fresh descriptor per invocation so a caller
mutation cannot alter later contracts (review).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: calvinbrewer

.changeset/eql-v3-stack-domain-registry-exports.md

@@ -25,11 +25,12 @@
  * `AuthoringArgRef.default`.
  */
 
-import {
-  type AnyEncryptedV3Column,
-  stripDomainSchema,
-  types,
-} from '@cipherstash/stack/eql/v3'
+// `stripDomainSchema` is adapter-seam surface (`adapter-kit`), same import
+// route as the Drizzle and Supabase adapters; `types` and the column union
+// stay on the public authoring entry.
+import { stripDomainSchema } from '@cipherstash/stack/adapter-kit'
+import type { AnyEncryptedV3Column } from '@cipherstash/stack/eql/v3'
+import { types } from '@cipherstash/stack/eql/v3'
 import {
   CIPHERSTASH_BIGINT_CODEC_ID,
   CIPHERSTASH_BOOLEAN_CODEC_ID,
@@ -97,19 +98,25 @@ function v3Authored<C extends AnyEncryptedV3Column>(
 ): () => V3ColumnDescriptor<C> {
   const probe = make('__probe__')
   const nativeType = probe.getEqlType()
-  const descriptor = {
-    codecId: toV3CodecId(stripDomainSchema(nativeType)),
-    nativeType,
-    typeParams: {
-      // Narrowing assertion, mirrors ../v3/catalog.ts: `build()` widens
-      // `cast_as` in the bundled d.ts; the value is the domain's literal.
-      castAs: probe.build().cast_as as V3CastAs,
-      capabilities: probe.getQueryCapabilities(),
-    },
-    // Narrowing assertion: runtime strings are the literals the getters
-    // declare; `toV3CodecId` returns `string` by signature.
-  } as V3ColumnDescriptor<C>
-  return () => descriptor
+  const codecId = toV3CodecId(stripDomainSchema(nativeType))
+  // Narrowing assertion, mirrors ../v3/catalog.ts: `build()` widens
+  // `cast_as` in the bundled d.ts; the value is the domain's literal.
+  const castAs = probe.build().cast_as as V3CastAs
+  const capabilities = probe.getQueryCapabilities()
+  // A FRESH descriptor per invocation: descriptors flow into caller-owned
+  // contract structures, so a shared instance would let one caller's
+  // mutation alter every later contract (call-order-dependent output).
+  return () =>
+    ({
+      codecId,
+      nativeType,
+      typeParams: {
+        castAs,
+        capabilities: { ...capabilities },
+      },
+      // Narrowing assertion: runtime strings are the literals the getters
+      // declare; `toV3CodecId` returns `string` by signature.
+    }) as V3ColumnDescriptor<C>
 }
 
 // Each factory has a DISTINCT return type (V3ColumnDescriptor<EncryptedXColumn>);

packages/prisma-next/src/exports/column-types.ts

@@ -10,12 +10,16 @@
  * prettified transform decode would have to invert. The `eql-v3` token is a
  * logical version tag, NOT the operator schema.
  */
+// The registry is adapter-seam surface (`adapter-kit`), consumed here the same
+// way the Drizzle and Supabase adapters consume it; the public `eql/v3` entry
+// stays end-user authoring API only (see stack's `adapter-kit.ts` header).
 import {
   type AnyEncryptedV3Column,
   DOMAIN_REGISTRY,
-  type QueryCapabilities,
-  type V3ColumnFactory,
-} from '@cipherstash/stack/eql/v3'
+} from '@cipherstash/stack/adapter-kit'
+import type { QueryCapabilities } from '@cipherstash/stack/eql/v3'
+
+type V3ColumnFactory = (name: string) => AnyEncryptedV3Column
 
 export type V3CastAs =
   | 'string'

packages/prisma-next/src/v3/catalog.ts

@@ -1,4 +1,7 @@
-import { DOMAIN_REGISTRY } from '@cipherstash/stack/eql/v3'
+// The domain registry is adapter-seam surface: the eql/v3 barrel no
+// longer exports it, so it ships from adapter-kit (the same import
+// route `src/v3/catalog.ts` uses).
+import { DOMAIN_REGISTRY } from '@cipherstash/stack/adapter-kit'
 import { describe, expect, it } from 'vitest'
 import {
   EXPOSED_DOMAIN_ENTRIES,

packages/prisma-next/test/v3/catalog-invariants.test.ts

@@ -62,12 +62,6 @@ export {
   EncryptedTimestampOrdOreColumn,
   TEXT_SEARCH_EQL_TYPE,
 } from './columns'
-export {
-  DOMAIN_REGISTRY,
-  factoryForDomain,
-  stripDomainSchema,
-  type V3ColumnFactory,
-} from './domain-registry'
 export type {
   AnyV3Table,
   ColumnsOf,