@prisma-next/adapter-mongo 0.5.0-dev.5 → 0.5.0-dev.51

package/README.md

@@ -4,8 +4,10 @@ MongoDB adapter for Prisma Next. Lowers abstract MongoDB commands into wire-prot
 
 ## Responsibilities
 
-- **Command lowering**: Converts `MongoCommand` instances (find, aggregate) into MongoDB wire-protocol documents
-- **Codec application**: Applies codec transformations to query parameters and result documents
+- **Command lowering**: `MongoAdapter.lower(plan)` converts a `MongoCommand` (find, aggregate, …) into a wire-protocol document. The method is `async` so it can await codec encode work on parameter values; the runtime (`MongoRuntime.execute`) awaits `adapter.lower(plan)` before issuing the command to the driver.
+- **Codec application on encode**: `resolveValue` walks parameter trees and dispatches codec-encoded leaves concurrently via `Promise.all`. The codec's `encode` is awaited (whether the codec body is sync or async), and the resolved wire value is placed into the lowered document.
+
+Mongo does not currently decode rows — documents pass through from the driver directly — so this adapter has no decode-side codec application today. See [ADR 204 — Single-Path Async Codec Runtime](../../../docs/architecture%20docs/adrs/ADR%20204%20-%20Single-Path%20Async%20Codec%20Runtime.md) for the codec runtime's async boundary contract.
 
 ## Dependencies
 

package/dist/control.d.mts

@@ -2,7 +2,7 @@ import { Db, Document, MongoClient } from "mongodb";
 import { CollModCommand, CreateCollectionCommand, CreateIndexCommand, DropCollectionCommand, DropIndexCommand, ListCollectionsCommand, ListIndexesCommand, MongoDdlCommandVisitor, MongoInspectionCommandVisitor } from "@prisma-next/mongo-query-ast/control";
 import { MongoSchemaIR } from "@prisma-next/mongo-schema-ir";
 import { MongoRunnerDependencies } from "@prisma-next/target-mongo/control";
-import { ControlAdapterDescriptor, ControlDriverInstance } from "@prisma-next/framework-components/control";
+import { ControlAdapterDescriptor, ControlDriverInstance, ControlFamilyInstance } from "@prisma-next/framework-components/control";
 import { MongoDriver } from "@prisma-next/mongo-lowering";
 
 //#region src/core/command-executor.d.ts
@@ -33,7 +33,7 @@ declare function createMongoControlDriver(db: Db, client: MongoClient): MongoCon
 //#endregion
 //#region src/core/runner-deps.d.ts
 declare function extractDb(driver: ControlDriverInstance<'mongo', 'mongo'>): Db;
-declare function createMongoRunnerDeps(controlDriver: ControlDriverInstance<'mongo', 'mongo'>, driver: MongoDriver): MongoRunnerDependencies;
+declare function createMongoRunnerDeps(controlDriver: ControlDriverInstance<'mongo', 'mongo'>, driver: MongoDriver, family: ControlFamilyInstance<'mongo', MongoSchemaIR>): MongoRunnerDependencies;
 //#endregion
 //#region src/exports/control.d.ts
 declare const mongoAdapterDescriptor: ControlAdapterDescriptor<'mongo', 'mongo'>;

package/dist/control.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"control.d.mts","names":[],"sources":["../src/core/command-executor.ts","../src/core/introspect-schema.ts","../src/core/mongo-control-driver.ts","../src/core/runner-deps.ts","../src/exports/control.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAca,oBAAA,YAAgC,uBAAuB;;kBACjC;mBAEV,qBAAqB;iBAmBvB,mBAAmB;wBAIZ,0BAA0B;EA1B3C,cAAA,CAAA,GAAA,EA0Ce,qBA1CM,CAAA,EA0CkB,OA1ClB,CAAA,IAAA,CAAA;EAAkC,OAAA,CAAA,GAAA,EA8C/C,cA9C+C,CAAA,EA8C9B,OA9C8B,CAAA,IAAA,CAAA;;AAG3C,cAsDZ,uBAAA,YAAmC,6BAtDvB,CAsDqD,OAtDrD,CAsD6D,QAtD7D,EAAA,CAAA,CAAA,CAAA;EAAqB,iBAAA,EAAA;EAmBvB,WAAA,CAAA,EAAA,EAoCY,EApCZ;EAAmB,WAAA,CAAA,GAAA,EAsCjB,kBAtCiB,CAAA,EAsCI,OAtCJ,CAsCY,QAtCZ,EAAA,CAAA;EAIZ,eAAA,CAAA,IAAA,EA6CA,sBA7CA,CAAA,EA6CyB,OA7CzB,CA6CiC,QA7CjC,EAAA,CAAA;;;;iBC8CR,gBAAA,KAAqB,KAAK,QAAQ;;;UCnFvC,0BAAA,SAAmC;eACrC;;iBAuBC,wBAAA,KAA6B,YAAY,cAAc;;;iBCdvD,SAAA,SAAkB,0CAA0C;iBAW5D,qBAAA,gBACC,iDACP,cACP;;;cCPG,wBAAwB"}
+{"version":3,"file":"control.d.mts","names":[],"sources":["../src/core/command-executor.ts","../src/core/introspect-schema.ts","../src/core/mongo-control-driver.ts","../src/core/runner-deps.ts","../src/exports/control.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAca,oBAAA,YAAgC,uBAAuB;;kBACjC;mBAEV,qBAAqB;iBAmBvB,mBAAmB;wBAIZ,0BAA0B;EA1B3C,cAAA,CAAA,GAAA,EA0Ce,qBA1CM,CAAA,EA0CkB,OA1ClB,CAAA,IAAA,CAAA;EAAkC,OAAA,CAAA,GAAA,EA8C/C,cA9C+C,CAAA,EA8C9B,OA9C8B,CAAA,IAAA,CAAA;;AAG3C,cAsDZ,uBAAA,YAAmC,6BAtDvB,CAsDqD,OAtDrD,CAsD6D,QAtD7D,EAAA,CAAA,CAAA,CAAA;EAAqB,iBAAA,EAAA;EAmBvB,WAAA,CAAA,EAAA,EAoCY,EApCZ;EAAmB,WAAA,CAAA,GAAA,EAsCjB,kBAtCiB,CAAA,EAsCI,OAtCJ,CAsCY,QAtCZ,EAAA,CAAA;EAIZ,eAAA,CAAA,IAAA,EA6CA,sBA7CA,CAAA,EA6CyB,OA7CzB,CA6CiC,QA7CjC,EAAA,CAAA;;;;iBC8CR,gBAAA,KAAqB,KAAK,QAAQ;;;UCnFvC,0BAAA,SAAmC;eACrC;;iBAuBC,wBAAA,KAA6B,YAAY,cAAc;;;iBCVvD,SAAA,SAAkB,0CAA0C;iBAW5D,qBAAA,gBACC,iDACP,qBACA,+BAA+B,iBACtC;;;cCpBG,wBAAwB"}

package/dist/control.mjs

@@ -1,4 +1,4 @@
-import { a as mongoInt32Codec, c as mongoVectorCodec, i as mongoDoubleCodec, n as mongoBooleanCodec, o as mongoObjectIdCodec, r as mongoDateCodec, s as mongoStringCodec, t as createMongoAdapter } from "./mongo-adapter-aVo8aZrf.mjs";
+import { r as mongoStandardCodecs, t as createMongoAdapter } from "./mongo-adapter-ByNtvoHK.mjs";
 import { MongoServerError } from "mongodb";
 import { keysToKeySpec } from "@prisma-next/mongo-query-ast/control";
 import { MongoSchemaCollection, MongoSchemaCollectionOptions, MongoSchemaIR, MongoSchemaIndex, MongoSchemaValidator } from "@prisma-next/mongo-schema-ir";
@@ -186,7 +186,7 @@ function extractDb(driver) {
 	if (!mongoDriver.db) throw new Error("Mongo control driver does not expose a db property. Use mongoControlDriver.create() from `@prisma-next/driver-mongo/control`.");
 	return mongoDriver.db;
 }
-function createMongoRunnerDeps(controlDriver, driver) {
+function createMongoRunnerDeps(controlDriver, driver, family) {
 	const db = extractDb(controlDriver);
 	return {
 		commandExecutor: new MongoCommandExecutor(db),
@@ -198,7 +198,8 @@ function createMongoRunnerDeps(controlDriver, driver) {
 			initMarker: (dest) => initMarker(db, dest),
 			updateMarker: (expectedFrom, dest) => updateMarker(db, expectedFrom, dest),
 			writeLedgerEntry: (entry) => writeLedgerEntry(db, entry)
-		}
+		},
+		introspectSchema: () => family.introspect({ driver: controlDriver })
 	};
 }
 
@@ -219,15 +220,7 @@ const mongoAdapterDescriptor = {
 		["Float", "mongo/double@1"]
 	]),
 	types: { codecTypes: {
-		codecInstances: [
-			mongoObjectIdCodec,
-			mongoStringCodec,
-			mongoDoubleCodec,
-			mongoInt32Codec,
-			mongoBooleanCodec,
-			mongoDateCodec,
-			mongoVectorCodec
-		],
+		codecInstances: [...mongoStandardCodecs],
 		import: {
 			package: "@prisma-next/adapter-mongo/codec-types",
 			named: "CodecTypes",

package/dist/control.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"control.mjs","names":["db: Db","keySpec: Document","options: Record<string, unknown>","command: Record<string, unknown>","error: unknown","keys: MongoIndexKey[]","collections: MongoSchemaCollection[]","#client","mongoAdapterDescriptor: ControlAdapterDescriptor<'mongo', 'mongo'>"],"sources":["../src/core/command-executor.ts","../src/core/introspect-schema.ts","../src/core/mongo-control-driver.ts","../src/core/runner-deps.ts","../src/exports/control.ts"],"sourcesContent":["import type {\n  CollModCommand,\n  CreateCollectionCommand,\n  CreateIndexCommand,\n  DropCollectionCommand,\n  DropIndexCommand,\n  ListCollectionsCommand,\n  ListIndexesCommand,\n  MongoDdlCommandVisitor,\n  MongoInspectionCommandVisitor,\n} from '@prisma-next/mongo-query-ast/control';\nimport { keysToKeySpec } from '@prisma-next/mongo-query-ast/control';\nimport { type Db, type Document, MongoServerError } from 'mongodb';\n\nexport class MongoCommandExecutor implements MongoDdlCommandVisitor<Promise<void>> {\n  constructor(private readonly db: Db) {}\n\n  async createIndex(cmd: CreateIndexCommand): Promise<void> {\n    const keySpec: Document = keysToKeySpec(cmd.keys);\n    const options: Record<string, unknown> = {};\n    if (cmd.unique !== undefined) options['unique'] = cmd.unique;\n    if (cmd.sparse !== undefined) options['sparse'] = cmd.sparse;\n    if (cmd.expireAfterSeconds !== undefined)\n      options['expireAfterSeconds'] = cmd.expireAfterSeconds;\n    if (cmd.partialFilterExpression !== undefined)\n      options['partialFilterExpression'] = cmd.partialFilterExpression;\n    if (cmd.name !== undefined) options['name'] = cmd.name;\n    if (cmd.wildcardProjection !== undefined)\n      options['wildcardProjection'] = cmd.wildcardProjection;\n    if (cmd.collation !== undefined) options['collation'] = cmd.collation;\n    if (cmd.weights !== undefined) options['weights'] = cmd.weights;\n    if (cmd.default_language !== undefined) options['default_language'] = cmd.default_language;\n    if (cmd.language_override !== undefined) options['language_override'] = cmd.language_override;\n    await this.db.collection(cmd.collection).createIndex(keySpec, options);\n  }\n\n  async dropIndex(cmd: DropIndexCommand): Promise<void> {\n    await this.db.collection(cmd.collection).dropIndex(cmd.name);\n  }\n\n  async createCollection(cmd: CreateCollectionCommand): Promise<void> {\n    const options: Record<string, unknown> = {};\n    if (cmd.capped !== undefined) options['capped'] = cmd.capped;\n    if (cmd.size !== undefined) options['size'] = cmd.size;\n    if (cmd.max !== undefined) options['max'] = cmd.max;\n    if (cmd.timeseries !== undefined) options['timeseries'] = cmd.timeseries;\n    if (cmd.collation !== undefined) options['collation'] = cmd.collation;\n    if (cmd.clusteredIndex !== undefined) options['clusteredIndex'] = cmd.clusteredIndex;\n    if (cmd.validator !== undefined) options['validator'] = cmd.validator;\n    if (cmd.validationLevel !== undefined) options['validationLevel'] = cmd.validationLevel;\n    if (cmd.validationAction !== undefined) options['validationAction'] = cmd.validationAction;\n    if (cmd.changeStreamPreAndPostImages !== undefined)\n      options['changeStreamPreAndPostImages'] = cmd.changeStreamPreAndPostImages;\n    await this.db.createCollection(cmd.collection, options);\n  }\n\n  async dropCollection(cmd: DropCollectionCommand): Promise<void> {\n    await this.db.collection(cmd.collection).drop();\n  }\n\n  async collMod(cmd: CollModCommand): Promise<void> {\n    const command: Record<string, unknown> = { collMod: cmd.collection };\n    if (cmd.validator !== undefined) command['validator'] = cmd.validator;\n    if (cmd.validationLevel !== undefined) command['validationLevel'] = cmd.validationLevel;\n    if (cmd.validationAction !== undefined) command['validationAction'] = cmd.validationAction;\n    if (cmd.changeStreamPreAndPostImages !== undefined)\n      command['changeStreamPreAndPostImages'] = cmd.changeStreamPreAndPostImages;\n    await this.db.command(command);\n  }\n}\n\nexport class MongoInspectionExecutor implements MongoInspectionCommandVisitor<Promise<Document[]>> {\n  constructor(private readonly db: Db) {}\n\n  async listIndexes(cmd: ListIndexesCommand): Promise<Document[]> {\n    try {\n      return await this.db.collection(cmd.collection).listIndexes().toArray();\n    } catch (error: unknown) {\n      if (error instanceof MongoServerError && error.code === 26) {\n        return [];\n      }\n      throw error;\n    }\n  }\n\n  async listCollections(_cmd: ListCollectionsCommand): Promise<Document[]> {\n    return this.db.listCollections().toArray();\n  }\n}\n","import type { MongoIndexKey, MongoIndexKeyDirection } from '@prisma-next/mongo-contract';\nimport {\n  MongoSchemaCollection,\n  MongoSchemaCollectionOptions,\n  MongoSchemaIndex,\n  MongoSchemaIR,\n  MongoSchemaValidator,\n} from '@prisma-next/mongo-schema-ir';\nimport type { Db, Document } from 'mongodb';\n\nconst PRISMA_MIGRATIONS_COLLECTION = '_prisma_migrations';\n\nfunction parseIndexKeys(keySpec: Record<string, unknown>): MongoIndexKey[] {\n  const keys: MongoIndexKey[] = [];\n  for (const [field, direction] of Object.entries(keySpec)) {\n    keys.push({ field, direction: direction as MongoIndexKeyDirection });\n  }\n  return keys;\n}\n\nfunction isDefaultIdIndex(doc: Document): boolean {\n  const key = doc['key'] as Record<string, unknown> | undefined;\n  if (!key) return false;\n  const entries = Object.entries(key);\n  return entries.length === 1 && entries[0]?.[0] === '_id' && entries[0]?.[1] === 1;\n}\n\nfunction parseIndex(doc: Document): MongoSchemaIndex {\n  const keySpec = doc['key'] as Record<string, unknown>;\n  return new MongoSchemaIndex({\n    keys: parseIndexKeys(keySpec),\n    unique: doc['unique'] as boolean | undefined,\n    sparse: doc['sparse'] as boolean | undefined,\n    expireAfterSeconds: doc['expireAfterSeconds'] as number | undefined,\n    partialFilterExpression: doc['partialFilterExpression'] as Record<string, unknown> | undefined,\n    wildcardProjection: doc['wildcardProjection'] as Record<string, 0 | 1> | undefined,\n    collation: doc['collation'] as Record<string, unknown> | undefined,\n    weights: doc['weights'] as Record<string, number> | undefined,\n    default_language: doc['default_language'] as string | undefined,\n    language_override: doc['language_override'] as string | undefined,\n  });\n}\n\nfunction parseValidator(options: Document): MongoSchemaValidator | undefined {\n  const validator = options['validator'] as Record<string, unknown> | undefined;\n  if (!validator) return undefined;\n\n  const jsonSchema = validator['$jsonSchema'] as Record<string, unknown> | undefined;\n  if (!jsonSchema) return undefined;\n\n  return new MongoSchemaValidator({\n    jsonSchema,\n    validationLevel: (options['validationLevel'] as 'strict' | 'moderate') ?? 'strict',\n    validationAction: (options['validationAction'] as 'error' | 'warn') ?? 'error',\n  });\n}\n\nfunction parseCollectionOptions(info: Document): MongoSchemaCollectionOptions | undefined {\n  const options = info['options'] as Record<string, unknown> | undefined;\n  if (!options) return undefined;\n\n  const capped = options['capped'] as boolean | undefined;\n  const size = options['size'] as number | undefined;\n  const max = options['max'] as number | undefined;\n  const timeseries = options['timeseries'] as\n    | { timeField: string; metaField?: string; granularity?: 'seconds' | 'minutes' | 'hours' }\n    | undefined;\n  const collation = options['collation'] as Record<string, unknown> | undefined;\n  const changeStreamPreAndPostImages = options['changeStreamPreAndPostImages'] as\n    | { enabled: boolean }\n    | undefined;\n  const clusteredIndex = options['clusteredIndex'] as { name?: string } | undefined;\n\n  const hasMeaningfulOptions =\n    capped || timeseries || collation || changeStreamPreAndPostImages || clusteredIndex;\n  if (!hasMeaningfulOptions) return undefined;\n\n  return new MongoSchemaCollectionOptions({\n    ...(capped ? { capped: { size: size ?? 0, ...(max != null ? { max } : {}) } } : {}),\n    ...(timeseries ? { timeseries } : {}),\n    ...(collation ? { collation } : {}),\n    ...(changeStreamPreAndPostImages ? { changeStreamPreAndPostImages } : {}),\n    ...(clusteredIndex ? { clusteredIndex } : {}),\n  });\n}\n\nexport async function introspectSchema(db: Db): Promise<MongoSchemaIR> {\n  const collectionInfos = await db.listCollections().toArray();\n\n  const collections: MongoSchemaCollection[] = [];\n\n  for (const info of collectionInfos) {\n    const name = info['name'] as string;\n    const type = info['type'] as string | undefined;\n\n    if (name === PRISMA_MIGRATIONS_COLLECTION) continue;\n    if (name.startsWith('system.')) continue;\n    if (type === 'view') continue;\n\n    const indexDocs = await db.collection(name).listIndexes().toArray();\n    const indexes = indexDocs.filter((doc) => !isDefaultIdIndex(doc)).map(parseIndex);\n\n    const infoOptions = 'options' in info ? (info['options'] as Record<string, unknown>) : {};\n    const validator = parseValidator(infoOptions);\n    const options = parseCollectionOptions(info);\n\n    collections.push(\n      new MongoSchemaCollection({\n        name,\n        indexes,\n        ...(validator ? { validator } : {}),\n        ...(options ? { options } : {}),\n      }),\n    );\n  }\n\n  return new MongoSchemaIR(collections);\n}\n","import type { ControlDriverInstance } from '@prisma-next/framework-components/control';\nimport type { Db, MongoClient } from 'mongodb';\n\nexport interface MongoControlDriverInstance extends ControlDriverInstance<'mongo', 'mongo'> {\n  readonly db: Db;\n}\n\nclass MongoControlDriverImpl implements MongoControlDriverInstance {\n  readonly familyId = 'mongo' as const;\n  readonly targetId = 'mongo' as const;\n  readonly db: Db;\n  readonly #client: MongoClient;\n\n  constructor(db: Db, client: MongoClient) {\n    this.db = db;\n    this.#client = client;\n  }\n\n  query(): Promise<never> {\n    throw new Error('MongoDB control driver does not support SQL queries');\n  }\n\n  async close(): Promise<void> {\n    await this.#client.close();\n  }\n}\n\nexport function createMongoControlDriver(db: Db, client: MongoClient): MongoControlDriverInstance {\n  return new MongoControlDriverImpl(db, client);\n}\n","import type { ControlDriverInstance } from '@prisma-next/framework-components/control';\nimport type { MongoDriver } from '@prisma-next/mongo-lowering';\nimport {\n  initMarker,\n  type MongoRunnerDependencies,\n  readMarker,\n  updateMarker,\n  writeLedgerEntry,\n} from '@prisma-next/target-mongo/control';\nimport type { Db } from 'mongodb';\nimport { createMongoAdapter } from '../mongo-adapter';\nimport { MongoCommandExecutor, MongoInspectionExecutor } from './command-executor';\n\nexport function extractDb(driver: ControlDriverInstance<'mongo', 'mongo'>): Db {\n  const mongoDriver = driver as ControlDriverInstance<'mongo', 'mongo'> & { db?: Db };\n  if (!mongoDriver.db) {\n    throw new Error(\n      'Mongo control driver does not expose a db property. ' +\n        'Use mongoControlDriver.create() from `@prisma-next/driver-mongo/control`.',\n    );\n  }\n  return mongoDriver.db;\n}\n\nexport function createMongoRunnerDeps(\n  controlDriver: ControlDriverInstance<'mongo', 'mongo'>,\n  driver: MongoDriver,\n): MongoRunnerDependencies {\n  const db = extractDb(controlDriver);\n  return {\n    commandExecutor: new MongoCommandExecutor(db),\n    inspectionExecutor: new MongoInspectionExecutor(db),\n    adapter: createMongoAdapter(),\n    driver,\n    markerOps: {\n      readMarker: () => readMarker(db),\n      initMarker: (dest) => initMarker(db, dest),\n      updateMarker: (expectedFrom, dest) => updateMarker(db, expectedFrom, dest),\n      writeLedgerEntry: (entry) => writeLedgerEntry(db, entry),\n    },\n  };\n}\n","import type { ControlAdapterDescriptor } from '@prisma-next/framework-components/control';\n\nexport { MongoCommandExecutor, MongoInspectionExecutor } from '../core/command-executor';\nexport { introspectSchema } from '../core/introspect-schema';\nexport {\n  createMongoControlDriver,\n  type MongoControlDriverInstance,\n} from '../core/mongo-control-driver';\nexport { createMongoRunnerDeps, extractDb } from '../core/runner-deps';\n\nimport {\n  mongoBooleanCodec,\n  mongoDateCodec,\n  mongoDoubleCodec,\n  mongoInt32Codec,\n  mongoObjectIdCodec,\n  mongoStringCodec,\n  mongoVectorCodec,\n} from '../core/codecs';\n\nconst mongoAdapterDescriptor: ControlAdapterDescriptor<'mongo', 'mongo'> = {\n  kind: 'adapter',\n  id: 'mongo',\n  familyId: 'mongo',\n  targetId: 'mongo',\n  version: '0.0.1',\n  scalarTypeDescriptors: new Map([\n    ['String', 'mongo/string@1'],\n    ['Int', 'mongo/int32@1'],\n    ['Boolean', 'mongo/bool@1'],\n    ['DateTime', 'mongo/date@1'],\n    ['ObjectId', 'mongo/objectId@1'],\n    ['Float', 'mongo/double@1'],\n  ]),\n  types: {\n    codecTypes: {\n      codecInstances: [\n        mongoObjectIdCodec,\n        mongoStringCodec,\n        mongoDoubleCodec,\n        mongoInt32Codec,\n        mongoBooleanCodec,\n        mongoDateCodec,\n        mongoVectorCodec,\n      ],\n      import: {\n        package: '@prisma-next/adapter-mongo/codec-types',\n        named: 'CodecTypes',\n        alias: 'MongoCodecTypes',\n      },\n      typeImports: [\n        {\n          package: '@prisma-next/adapter-mongo/codec-types',\n          named: 'Vector',\n          alias: 'Vector',\n        },\n      ],\n    },\n  },\n  create(_stack) {\n    return { familyId: 'mongo' as const, targetId: 'mongo' as const };\n  },\n};\n\nexport default mongoAdapterDescriptor;\n"],"mappings":"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"}
+{"version":3,"file":"control.mjs","names":["db: Db","keySpec: Document","options: Record<string, unknown>","command: Record<string, unknown>","error: unknown","keys: MongoIndexKey[]","collections: MongoSchemaCollection[]","#client","mongoAdapterDescriptor: ControlAdapterDescriptor<'mongo', 'mongo'>"],"sources":["../src/core/command-executor.ts","../src/core/introspect-schema.ts","../src/core/mongo-control-driver.ts","../src/core/runner-deps.ts","../src/exports/control.ts"],"sourcesContent":["import type {\n  CollModCommand,\n  CreateCollectionCommand,\n  CreateIndexCommand,\n  DropCollectionCommand,\n  DropIndexCommand,\n  ListCollectionsCommand,\n  ListIndexesCommand,\n  MongoDdlCommandVisitor,\n  MongoInspectionCommandVisitor,\n} from '@prisma-next/mongo-query-ast/control';\nimport { keysToKeySpec } from '@prisma-next/mongo-query-ast/control';\nimport { type Db, type Document, MongoServerError } from 'mongodb';\n\nexport class MongoCommandExecutor implements MongoDdlCommandVisitor<Promise<void>> {\n  constructor(private readonly db: Db) {}\n\n  async createIndex(cmd: CreateIndexCommand): Promise<void> {\n    const keySpec: Document = keysToKeySpec(cmd.keys);\n    const options: Record<string, unknown> = {};\n    if (cmd.unique !== undefined) options['unique'] = cmd.unique;\n    if (cmd.sparse !== undefined) options['sparse'] = cmd.sparse;\n    if (cmd.expireAfterSeconds !== undefined)\n      options['expireAfterSeconds'] = cmd.expireAfterSeconds;\n    if (cmd.partialFilterExpression !== undefined)\n      options['partialFilterExpression'] = cmd.partialFilterExpression;\n    if (cmd.name !== undefined) options['name'] = cmd.name;\n    if (cmd.wildcardProjection !== undefined)\n      options['wildcardProjection'] = cmd.wildcardProjection;\n    if (cmd.collation !== undefined) options['collation'] = cmd.collation;\n    if (cmd.weights !== undefined) options['weights'] = cmd.weights;\n    if (cmd.default_language !== undefined) options['default_language'] = cmd.default_language;\n    if (cmd.language_override !== undefined) options['language_override'] = cmd.language_override;\n    await this.db.collection(cmd.collection).createIndex(keySpec, options);\n  }\n\n  async dropIndex(cmd: DropIndexCommand): Promise<void> {\n    await this.db.collection(cmd.collection).dropIndex(cmd.name);\n  }\n\n  async createCollection(cmd: CreateCollectionCommand): Promise<void> {\n    const options: Record<string, unknown> = {};\n    if (cmd.capped !== undefined) options['capped'] = cmd.capped;\n    if (cmd.size !== undefined) options['size'] = cmd.size;\n    if (cmd.max !== undefined) options['max'] = cmd.max;\n    if (cmd.timeseries !== undefined) options['timeseries'] = cmd.timeseries;\n    if (cmd.collation !== undefined) options['collation'] = cmd.collation;\n    if (cmd.clusteredIndex !== undefined) options['clusteredIndex'] = cmd.clusteredIndex;\n    if (cmd.validator !== undefined) options['validator'] = cmd.validator;\n    if (cmd.validationLevel !== undefined) options['validationLevel'] = cmd.validationLevel;\n    if (cmd.validationAction !== undefined) options['validationAction'] = cmd.validationAction;\n    if (cmd.changeStreamPreAndPostImages !== undefined)\n      options['changeStreamPreAndPostImages'] = cmd.changeStreamPreAndPostImages;\n    await this.db.createCollection(cmd.collection, options);\n  }\n\n  async dropCollection(cmd: DropCollectionCommand): Promise<void> {\n    await this.db.collection(cmd.collection).drop();\n  }\n\n  async collMod(cmd: CollModCommand): Promise<void> {\n    const command: Record<string, unknown> = { collMod: cmd.collection };\n    if (cmd.validator !== undefined) command['validator'] = cmd.validator;\n    if (cmd.validationLevel !== undefined) command['validationLevel'] = cmd.validationLevel;\n    if (cmd.validationAction !== undefined) command['validationAction'] = cmd.validationAction;\n    if (cmd.changeStreamPreAndPostImages !== undefined)\n      command['changeStreamPreAndPostImages'] = cmd.changeStreamPreAndPostImages;\n    await this.db.command(command);\n  }\n}\n\nexport class MongoInspectionExecutor implements MongoInspectionCommandVisitor<Promise<Document[]>> {\n  constructor(private readonly db: Db) {}\n\n  async listIndexes(cmd: ListIndexesCommand): Promise<Document[]> {\n    try {\n      return await this.db.collection(cmd.collection).listIndexes().toArray();\n    } catch (error: unknown) {\n      if (error instanceof MongoServerError && error.code === 26) {\n        return [];\n      }\n      throw error;\n    }\n  }\n\n  async listCollections(_cmd: ListCollectionsCommand): Promise<Document[]> {\n    return this.db.listCollections().toArray();\n  }\n}\n","import type { MongoIndexKey, MongoIndexKeyDirection } from '@prisma-next/mongo-contract';\nimport {\n  MongoSchemaCollection,\n  MongoSchemaCollectionOptions,\n  MongoSchemaIndex,\n  MongoSchemaIR,\n  MongoSchemaValidator,\n} from '@prisma-next/mongo-schema-ir';\nimport type { Db, Document } from 'mongodb';\n\nconst PRISMA_MIGRATIONS_COLLECTION = '_prisma_migrations';\n\nfunction parseIndexKeys(keySpec: Record<string, unknown>): MongoIndexKey[] {\n  const keys: MongoIndexKey[] = [];\n  for (const [field, direction] of Object.entries(keySpec)) {\n    keys.push({ field, direction: direction as MongoIndexKeyDirection });\n  }\n  return keys;\n}\n\nfunction isDefaultIdIndex(doc: Document): boolean {\n  const key = doc['key'] as Record<string, unknown> | undefined;\n  if (!key) return false;\n  const entries = Object.entries(key);\n  return entries.length === 1 && entries[0]?.[0] === '_id' && entries[0]?.[1] === 1;\n}\n\nfunction parseIndex(doc: Document): MongoSchemaIndex {\n  const keySpec = doc['key'] as Record<string, unknown>;\n  return new MongoSchemaIndex({\n    keys: parseIndexKeys(keySpec),\n    unique: doc['unique'] as boolean | undefined,\n    sparse: doc['sparse'] as boolean | undefined,\n    expireAfterSeconds: doc['expireAfterSeconds'] as number | undefined,\n    partialFilterExpression: doc['partialFilterExpression'] as Record<string, unknown> | undefined,\n    wildcardProjection: doc['wildcardProjection'] as Record<string, 0 | 1> | undefined,\n    collation: doc['collation'] as Record<string, unknown> | undefined,\n    weights: doc['weights'] as Record<string, number> | undefined,\n    default_language: doc['default_language'] as string | undefined,\n    language_override: doc['language_override'] as string | undefined,\n  });\n}\n\nfunction parseValidator(options: Document): MongoSchemaValidator | undefined {\n  const validator = options['validator'] as Record<string, unknown> | undefined;\n  if (!validator) return undefined;\n\n  const jsonSchema = validator['$jsonSchema'] as Record<string, unknown> | undefined;\n  if (!jsonSchema) return undefined;\n\n  return new MongoSchemaValidator({\n    jsonSchema,\n    validationLevel: (options['validationLevel'] as 'strict' | 'moderate') ?? 'strict',\n    validationAction: (options['validationAction'] as 'error' | 'warn') ?? 'error',\n  });\n}\n\nfunction parseCollectionOptions(info: Document): MongoSchemaCollectionOptions | undefined {\n  const options = info['options'] as Record<string, unknown> | undefined;\n  if (!options) return undefined;\n\n  const capped = options['capped'] as boolean | undefined;\n  const size = options['size'] as number | undefined;\n  const max = options['max'] as number | undefined;\n  const timeseries = options['timeseries'] as\n    | { timeField: string; metaField?: string; granularity?: 'seconds' | 'minutes' | 'hours' }\n    | undefined;\n  const collation = options['collation'] as Record<string, unknown> | undefined;\n  const changeStreamPreAndPostImages = options['changeStreamPreAndPostImages'] as\n    | { enabled: boolean }\n    | undefined;\n  const clusteredIndex = options['clusteredIndex'] as { name?: string } | undefined;\n\n  const hasMeaningfulOptions =\n    capped || timeseries || collation || changeStreamPreAndPostImages || clusteredIndex;\n  if (!hasMeaningfulOptions) return undefined;\n\n  return new MongoSchemaCollectionOptions({\n    ...(capped ? { capped: { size: size ?? 0, ...(max != null ? { max } : {}) } } : {}),\n    ...(timeseries ? { timeseries } : {}),\n    ...(collation ? { collation } : {}),\n    ...(changeStreamPreAndPostImages ? { changeStreamPreAndPostImages } : {}),\n    ...(clusteredIndex ? { clusteredIndex } : {}),\n  });\n}\n\nexport async function introspectSchema(db: Db): Promise<MongoSchemaIR> {\n  const collectionInfos = await db.listCollections().toArray();\n\n  const collections: MongoSchemaCollection[] = [];\n\n  for (const info of collectionInfos) {\n    const name = info['name'] as string;\n    const type = info['type'] as string | undefined;\n\n    if (name === PRISMA_MIGRATIONS_COLLECTION) continue;\n    if (name.startsWith('system.')) continue;\n    if (type === 'view') continue;\n\n    const indexDocs = await db.collection(name).listIndexes().toArray();\n    const indexes = indexDocs.filter((doc) => !isDefaultIdIndex(doc)).map(parseIndex);\n\n    const infoOptions = 'options' in info ? (info['options'] as Record<string, unknown>) : {};\n    const validator = parseValidator(infoOptions);\n    const options = parseCollectionOptions(info);\n\n    collections.push(\n      new MongoSchemaCollection({\n        name,\n        indexes,\n        ...(validator ? { validator } : {}),\n        ...(options ? { options } : {}),\n      }),\n    );\n  }\n\n  return new MongoSchemaIR(collections);\n}\n","import type { ControlDriverInstance } from '@prisma-next/framework-components/control';\nimport type { Db, MongoClient } from 'mongodb';\n\nexport interface MongoControlDriverInstance extends ControlDriverInstance<'mongo', 'mongo'> {\n  readonly db: Db;\n}\n\nclass MongoControlDriverImpl implements MongoControlDriverInstance {\n  readonly familyId = 'mongo' as const;\n  readonly targetId = 'mongo' as const;\n  readonly db: Db;\n  readonly #client: MongoClient;\n\n  constructor(db: Db, client: MongoClient) {\n    this.db = db;\n    this.#client = client;\n  }\n\n  query(): Promise<never> {\n    throw new Error('MongoDB control driver does not support SQL queries');\n  }\n\n  async close(): Promise<void> {\n    await this.#client.close();\n  }\n}\n\nexport function createMongoControlDriver(db: Db, client: MongoClient): MongoControlDriverInstance {\n  return new MongoControlDriverImpl(db, client);\n}\n","import type {\n  ControlDriverInstance,\n  ControlFamilyInstance,\n} from '@prisma-next/framework-components/control';\nimport type { MongoDriver } from '@prisma-next/mongo-lowering';\nimport type { MongoSchemaIR } from '@prisma-next/mongo-schema-ir';\nimport {\n  initMarker,\n  type MongoRunnerDependencies,\n  readMarker,\n  updateMarker,\n  writeLedgerEntry,\n} from '@prisma-next/target-mongo/control';\nimport type { Db } from 'mongodb';\nimport { createMongoAdapter } from '../mongo-adapter';\nimport { MongoCommandExecutor, MongoInspectionExecutor } from './command-executor';\n\nexport function extractDb(driver: ControlDriverInstance<'mongo', 'mongo'>): Db {\n  const mongoDriver = driver as ControlDriverInstance<'mongo', 'mongo'> & { db?: Db };\n  if (!mongoDriver.db) {\n    throw new Error(\n      'Mongo control driver does not expose a db property. ' +\n        'Use mongoControlDriver.create() from `@prisma-next/driver-mongo/control`.',\n    );\n  }\n  return mongoDriver.db;\n}\n\nexport function createMongoRunnerDeps(\n  controlDriver: ControlDriverInstance<'mongo', 'mongo'>,\n  driver: MongoDriver,\n  family: ControlFamilyInstance<'mongo', MongoSchemaIR>,\n): MongoRunnerDependencies {\n  const db = extractDb(controlDriver);\n  return {\n    commandExecutor: new MongoCommandExecutor(db),\n    inspectionExecutor: new MongoInspectionExecutor(db),\n    adapter: createMongoAdapter(),\n    driver,\n    markerOps: {\n      readMarker: () => readMarker(db),\n      initMarker: (dest) => initMarker(db, dest),\n      updateMarker: (expectedFrom, dest) => updateMarker(db, expectedFrom, dest),\n      writeLedgerEntry: (entry) => writeLedgerEntry(db, entry),\n    },\n    introspectSchema: () => family.introspect({ driver: controlDriver }),\n  };\n}\n","import type { ControlAdapterDescriptor } from '@prisma-next/framework-components/control';\n\nexport { MongoCommandExecutor, MongoInspectionExecutor } from '../core/command-executor';\nexport { introspectSchema } from '../core/introspect-schema';\nexport {\n  createMongoControlDriver,\n  type MongoControlDriverInstance,\n} from '../core/mongo-control-driver';\nexport { createMongoRunnerDeps, extractDb } from '../core/runner-deps';\n\nimport { mongoStandardCodecs } from '../core/codecs';\n\nconst mongoAdapterDescriptor: ControlAdapterDescriptor<'mongo', 'mongo'> = {\n  kind: 'adapter',\n  id: 'mongo',\n  familyId: 'mongo',\n  targetId: 'mongo',\n  version: '0.0.1',\n  scalarTypeDescriptors: new Map([\n    ['String', 'mongo/string@1'],\n    ['Int', 'mongo/int32@1'],\n    ['Boolean', 'mongo/bool@1'],\n    ['DateTime', 'mongo/date@1'],\n    ['ObjectId', 'mongo/objectId@1'],\n    ['Float', 'mongo/double@1'],\n  ]),\n  types: {\n    codecTypes: {\n      codecInstances: [...mongoStandardCodecs],\n      import: {\n        package: '@prisma-next/adapter-mongo/codec-types',\n        named: 'CodecTypes',\n        alias: 'MongoCodecTypes',\n      },\n      typeImports: [\n        {\n          package: '@prisma-next/adapter-mongo/codec-types',\n          named: 'Vector',\n          alias: 'Vector',\n        },\n      ],\n    },\n  },\n  create(_stack) {\n    return { familyId: 'mongo' as const, targetId: 'mongo' as const };\n  },\n};\n\nexport default mongoAdapterDescriptor;\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -3,29 +3,35 @@ import { Document } from "@prisma-next/mongo-value";
 import { MongoCodecRegistry } from "@prisma-next/mongo-codec";
 import { MongoAdapter } from "@prisma-next/mongo-lowering";
 import { OperationDescriptor } from "@prisma-next/operations";
+import { CodecCallContext } from "@prisma-next/framework-components/codec";
 
 //#region src/core/operations.d.ts
 declare const mongoVectorNearOperation: Readonly<{
   method: "near";
-  args: {
+  self: {
     codecId: "mongo/vector@1";
-    nullable: boolean;
-  }[];
-  returns: {
-    codecId: "mongo/int32@1";
-    nullable: boolean;
   };
+  impl: () => never;
 }>;
 declare const mongoVectorOperationDescriptors: readonly OperationDescriptor[];
 //#endregion
 //#region src/lowering.d.ts
 declare function lowerAggExpr(expr: MongoAggExpr): unknown;
-declare function lowerFilter(filter: MongoFilterExpr): Document;
-declare function lowerStage(stage: MongoPipelineStage): Record<string, unknown>;
-declare function lowerPipeline(stages: ReadonlyArray<MongoPipelineStage>): Array<Record<string, unknown>>;
+declare function lowerFilter(filter: MongoFilterExpr, codecs: MongoCodecRegistry, ctx: CodecCallContext): Promise<Document>;
+declare function lowerStage(stage: MongoPipelineStage, codecs: MongoCodecRegistry, ctx: CodecCallContext): Promise<Record<string, unknown>>;
+declare function lowerPipeline(stages: ReadonlyArray<MongoPipelineStage>, codecs: MongoCodecRegistry, ctx: CodecCallContext): Promise<Array<Record<string, unknown>>>;
 //#endregion
 //#region src/mongo-adapter.d.ts
-declare function createMongoAdapter(codecs?: MongoCodecRegistry): MongoAdapter;
+/**
+ * Construct a Mongo adapter with the standard wire-type codecs registered
+ * for encode-side dispatch (`MongoParamRef.codecId` lookups).
+ *
+ * The runtime-side codec registry the runtime decodes against is composed
+ * separately by `createMongoExecutionContext`. This factory exists for
+ * direct adapter use (the runtime descriptor's `create(stack)` calls
+ * through it). User code should compose a stack/context instead.
+ */
+declare function createMongoAdapter(): MongoAdapter;
 //#endregion
 export { createMongoAdapter, lowerAggExpr, lowerFilter, lowerPipeline, lowerStage, mongoVectorNearOperation, mongoVectorOperationDescriptors };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/core/operations.ts","../src/lowering.ts","../src/mongo-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;cAGa,0BAAwB;;;;;;EAAxB,OAAA,EAAA;IAMA,OAAA,EAAA,eAAA;;;;AC6HG,cD7HH,+BC6HkC,EAAA,SD7HQ,mBC6HR,EAAA;;;iBAA/B,YAAA,OAAmB;iBAInB,WAAA,SAAoB,kBAAkB;iBA8DtC,UAAA,QAAkB,qBAAqB;iBAqMvC,aAAA,SACN,cAAc,sBACrB,MAAM;;;iBChPO,kBAAA,UAA4B,qBAAqB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/core/operations.ts","../src/lowering.ts","../src/mongo-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAGa,0BAAwB;;;;;;;AAAxB,cAMA,+BANwB,EAAA,SAMkB,mBANlB,EAAA;;;iBCqIrB,YAAA,OAAmB;iBAIb,WAAA,SACZ,yBACA,yBACH,mBACJ,QAAQ;iBA8DW,UAAA,QACb,4BACC,yBACH,mBACJ,QAAQ;iBAsNW,aAAA,SACZ,cAAc,6BACd,yBACH,mBACJ,QAAQ,MAAM;;;;;;;;;ADzajB;AAMA;;iBE+JgB,kBAAA,CAAA,GAAsB"}

package/dist/index.mjs

@@ -1,16 +1,10 @@
-import { d as lowerPipeline, f as lowerStage, l as lowerAggExpr, m as MONGO_VECTOR_CODEC_ID, p as MONGO_INT32_CODEC_ID, t as createMongoAdapter, u as lowerFilter } from "./mongo-adapter-aVo8aZrf.mjs";
+import { a as lowerFilter, c as MONGO_VECTOR_CODEC_ID, i as lowerAggExpr, o as lowerPipeline, s as lowerStage, t as createMongoAdapter } from "./mongo-adapter-ByNtvoHK.mjs";
 
 //#region src/core/operations.ts
 const mongoVectorNearOperation = Object.freeze({
 	method: "near",
-	args: [{
-		codecId: MONGO_VECTOR_CODEC_ID,
-		nullable: false
-	}],
-	returns: {
-		codecId: MONGO_INT32_CODEC_ID,
-		nullable: false
-	}
+	self: { codecId: MONGO_VECTOR_CODEC_ID },
+	impl: () => void 0
 });
 const mongoVectorOperationDescriptors = [mongoVectorNearOperation];
 

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["mongoVectorOperationDescriptors: readonly OperationDescriptor[]"],"sources":["../src/core/operations.ts"],"sourcesContent":["import type { OperationDescriptor } from '@prisma-next/operations';\nimport { MONGO_INT32_CODEC_ID, MONGO_VECTOR_CODEC_ID } from './codec-ids';\n\nexport const mongoVectorNearOperation = Object.freeze({\n  method: 'near',\n  args: [{ codecId: MONGO_VECTOR_CODEC_ID, nullable: false }],\n  returns: { codecId: MONGO_INT32_CODEC_ID, nullable: false },\n}) satisfies OperationDescriptor;\n\nexport const mongoVectorOperationDescriptors: readonly OperationDescriptor[] = [\n  mongoVectorNearOperation,\n];\n"],"mappings":";;;AAGA,MAAa,2BAA2B,OAAO,OAAO;CACpD,QAAQ;CACR,MAAM,CAAC;EAAE,SAAS;EAAuB,UAAU;EAAO,CAAC;CAC3D,SAAS;EAAE,SAAS;EAAsB,UAAU;EAAO;CAC5D,CAAC;AAEF,MAAaA,kCAAkE,CAC7E,yBACD"}
+{"version":3,"file":"index.mjs","names":["mongoVectorOperationDescriptors: readonly OperationDescriptor[]"],"sources":["../src/core/operations.ts"],"sourcesContent":["import type { OperationDescriptor } from '@prisma-next/operations';\nimport { MONGO_VECTOR_CODEC_ID } from './codec-ids';\n\nexport const mongoVectorNearOperation = Object.freeze({\n  method: 'near',\n  self: { codecId: MONGO_VECTOR_CODEC_ID },\n  impl: () => undefined as never,\n}) satisfies OperationDescriptor;\n\nexport const mongoVectorOperationDescriptors: readonly OperationDescriptor[] = [\n  mongoVectorNearOperation,\n];\n"],"mappings":";;;AAGA,MAAa,2BAA2B,OAAO,OAAO;CACpD,QAAQ;CACR,MAAM,EAAE,SAAS,uBAAuB;CACxC,YAAY;CACb,CAAC;AAEF,MAAaA,kCAAkE,CAC7E,yBACD"}

package/dist/{mongo-adapter-aVo8aZrf.mjs → mongo-adapter-ByNtvoHK.mjs}

@@ -1,7 +1,8 @@
 import { isExprArray, isRecordArgs } from "@prisma-next/mongo-query-ast/execution";
+import { checkAborted, raceAgainstAbort, runtimeError } from "@prisma-next/framework-components/runtime";
 import { MongoParamRef } from "@prisma-next/mongo-value";
-import { createMongoCodecRegistry, mongoCodec } from "@prisma-next/mongo-codec";
 import { AggregateWireCommand, DeleteManyWireCommand, DeleteOneWireCommand, FindOneAndDeleteWireCommand, FindOneAndUpdateWireCommand, InsertManyWireCommand, InsertOneWireCommand, UpdateManyWireCommand, UpdateOneWireCommand } from "@prisma-next/mongo-wire";
+import { createMongoCodecRegistry, mongoCodec } from "@prisma-next/mongo-codec";
 import { ObjectId } from "mongodb";
 
 //#region src/core/codec-ids.ts
@@ -15,21 +16,80 @@ const MONGO_VECTOR_CODEC_ID = "mongo/vector@1";
 
 //#endregion
 //#region src/resolve-value.ts
-function resolveValue(value, codecs) {
+/**
+* Resolves a `MongoValue` (which may contain `MongoParamRef` leaves) into the
+* driver-ready wire shape. When a leaf has a `codecId` and the registry has a
+* codec for it, the codec's async `encode` is awaited so codecs may perform
+* asynchronous work (e.g. lookups, key derivations).
+*
+* Object/array nodes dispatch their child resolutions concurrently via
+* `Promise.all` so independent leaves encode in parallel.
+*
+* Codec encode failures are wrapped in a `RUNTIME.ENCODE_FAILED` envelope
+* (mirroring SQL's `wrapEncodeFailure` shape) with `{ label, codec }` details
+* and the original error attached on `cause`. An already-wrapped envelope is
+* re-thrown verbatim so nested resolvers don't double-wrap.
+*
+* `ctx: CodecCallContext` is forwarded verbatim to every
+* `codec.encode(value, ctx)` call. The same `ctx` reference is also passed
+* to nested `resolveValue` invocations so codec authors observe **signal
+* identity** across the entire recursive walk for one `runtime.execute()`.
+*
+* Abort observation (only when `ctx.signal` is provided):
+*
+* - **Already-aborted at entry** — every recursive call pre-checks
+*   `ctx.signal.aborted` and short-circuits with
+*   `RUNTIME.ABORTED { phase: 'encode' }` before any codec is invoked.
+* - **Mid-flight abort** — each per-level `Promise.all` races against the
+*   signal via `raceAgainstAbort`. The runtime returns
+*   `RUNTIME.ABORTED { phase: 'encode' }` promptly even if codec bodies
+*   ignore the signal; in-flight bodies run to completion in the background
+*   (cooperative cancellation, see ADR 204).
+* - `RUNTIME.ENCODE_FAILED` envelopes thrown by a codec body before the
+*   runtime sees the abort pass through unchanged (AC-ERR4).
+*/
+async function resolveValue(value, codecs, ctx) {
+	checkAborted(ctx, "encode");
+	const signal = ctx.signal;
 	if (value instanceof MongoParamRef) {
-		if (value.codecId && codecs) {
+		if (value.codecId) {
 			const codec = codecs.get(value.codecId);
-			if (codec?.encode) return codec.encode(value.value);
+			if (codec?.encode) try {
+				return await raceAgainstAbort(codec.encode(value.value, ctx), signal, "encode");
+			} catch (error) {
+				wrapEncodeFailure(error, value, codec.id);
+			}
 		}
 		return value.value;
 	}
 	if (value === null || typeof value !== "object") return value;
 	if (value instanceof Date) return value;
-	if (Array.isArray(value)) return value.map((v) => resolveValue(v, codecs));
+	if (Array.isArray(value)) return raceAgainstAbort(Promise.all(value.map((v) => resolveValue(v, codecs, ctx))), signal, "encode");
+	const entries = Object.entries(value);
+	const resolved = await raceAgainstAbort(Promise.all(entries.map(([, val]) => resolveValue(val, codecs, ctx))), signal, "encode");
 	const result = {};
-	for (const [key, val] of Object.entries(value)) result[key] = resolveValue(val, codecs);
+	for (let i = 0; i < entries.length; i++) {
+		const entry = entries[i];
+		if (entry) result[entry[0]] = resolved[i];
+	}
 	return result;
 }
+function paramRefLabel(ref, codecId) {
+	return ref.name ?? codecId;
+}
+function isAlreadyEncodeFailure(error) {
+	return error instanceof Error && "code" in error && error.code === "RUNTIME.ENCODE_FAILED";
+}
+function wrapEncodeFailure(error, ref, codecId) {
+	if (isAlreadyEncodeFailure(error)) throw error;
+	const label = paramRefLabel(ref, codecId);
+	const wrapped = runtimeError("RUNTIME.ENCODE_FAILED", `Failed to encode parameter ${label} with codec '${codecId}': ${error instanceof Error ? error.message : String(error)}`, {
+		label,
+		codec: codecId
+	});
+	wrapped.cause = error;
+	throw wrapped;
+}
 
 //#endregion
 //#region src/lowering.ts
@@ -110,12 +170,12 @@ function needsLiteralWrap(value) {
 function lowerAggExpr(expr) {
 	return expr.accept(aggExprLoweringVisitor);
 }
-function lowerFilter(filter) {
+async function lowerFilter(filter, codecs, ctx) {
 	switch (filter.kind) {
-		case "field": return { [filter.field]: { [filter.op]: resolveValue(filter.value) } };
-		case "and": return { $and: filter.exprs.map((e) => lowerFilter(e)) };
-		case "or": return { $or: filter.exprs.map((e) => lowerFilter(e)) };
-		case "not": return { $nor: [lowerFilter(filter.expr)] };
+		case "field": return { [filter.field]: { [filter.op]: await resolveValue(filter.value, codecs, ctx) } };
+		case "and": return { $and: await Promise.all(filter.exprs.map((e) => lowerFilter(e, codecs, ctx))) };
+		case "or": return { $or: await Promise.all(filter.exprs.map((e) => lowerFilter(e, codecs, ctx))) };
+		case "not": return { $nor: [await lowerFilter(filter.expr, codecs, ctx)] };
 		case "exists": return { [filter.field]: { $exists: filter.exists } };
 		case "expr": return { $expr: lowerAggExpr(filter.aggExpr) };
 		default: {
@@ -149,9 +209,9 @@ function lowerWindowField(wf) {
 	if (wf.window) result["window"] = { ...wf.window };
 	return result;
 }
-function lowerStage(stage) {
+async function lowerStage(stage, codecs, ctx) {
 	switch (stage.kind) {
-		case "match": return { $match: lowerFilter(stage.filter) };
+		case "match": return { $match: await lowerFilter(stage.filter, codecs, ctx) };
 		case "project": {
 			const projection = {};
 			for (const [key, val] of Object.entries(stage.projection)) projection[key] = lowerProjectionValue(val);
@@ -167,7 +227,7 @@ function lowerStage(stage) {
 			};
 			if (stage.localField !== void 0) lookup["localField"] = stage.localField;
 			if (stage.foreignField !== void 0) lookup["foreignField"] = stage.foreignField;
-			if (stage.pipeline) lookup["pipeline"] = stage.pipeline.map((s) => lowerStage(s));
+			if (stage.pipeline) lookup["pipeline"] = await Promise.all(stage.pipeline.map((s) => lowerStage(s, codecs, ctx)));
 			if (stage.let_) lookup["let"] = lowerExprRecord(stage.let_);
 			return { $lookup: lookup };
 		}
@@ -196,7 +256,7 @@ function lowerStage(stage) {
 		} : stage.collection };
 		case "unionWith": {
 			const unionWith = { coll: stage.collection };
-			if (stage.pipeline) unionWith["pipeline"] = stage.pipeline.map((s) => lowerStage(s));
+			if (stage.pipeline) unionWith["pipeline"] = await Promise.all(stage.pipeline.map((s) => lowerStage(s, codecs, ctx)));
 			return { $unionWith: unionWith };
 		}
 		case "bucket": {
@@ -225,15 +285,20 @@ function lowerStage(stage) {
 			if (stage.spherical !== void 0) geoNear["spherical"] = stage.spherical;
 			if (stage.maxDistance !== void 0) geoNear["maxDistance"] = stage.maxDistance;
 			if (stage.minDistance !== void 0) geoNear["minDistance"] = stage.minDistance;
-			if (stage.query) geoNear["query"] = lowerFilter(stage.query);
+			if (stage.query) geoNear["query"] = await lowerFilter(stage.query, codecs, ctx);
 			if (stage.key !== void 0) geoNear["key"] = stage.key;
 			if (stage.distanceMultiplier !== void 0) geoNear["distanceMultiplier"] = stage.distanceMultiplier;
 			if (stage.includeLocs !== void 0) geoNear["includeLocs"] = stage.includeLocs;
 			return { $geoNear: geoNear };
 		}
 		case "facet": {
+			const facetEntries = Object.entries(stage.facets);
+			const facetPipelines = await Promise.all(facetEntries.map(([, pipeline]) => Promise.all(pipeline.map((s) => lowerStage(s, codecs, ctx)))));
 			const facet = {};
-			for (const [key, pipeline] of Object.entries(stage.facets)) facet[key] = pipeline.map((s) => lowerStage(s));
+			for (let i = 0; i < facetEntries.length; i++) {
+				const entry = facetEntries[i];
+				if (entry) facet[entry[0]] = facetPipelines[i];
+			}
 			return { $facet: facet };
 		}
 		case "graphLookup": {
@@ -246,13 +311,13 @@ function lowerStage(stage) {
 			};
 			if (stage.maxDepth !== void 0) graphLookup["maxDepth"] = stage.maxDepth;
 			if (stage.depthField !== void 0) graphLookup["depthField"] = stage.depthField;
-			if (stage.restrictSearchWithMatch) graphLookup["restrictSearchWithMatch"] = lowerFilter(stage.restrictSearchWithMatch);
+			if (stage.restrictSearchWithMatch) graphLookup["restrictSearchWithMatch"] = await lowerFilter(stage.restrictSearchWithMatch, codecs, ctx);
 			return { $graphLookup: graphLookup };
 		}
 		case "merge": {
 			const merge = { into: stage.into };
 			if (stage.on !== void 0) merge["on"] = stage.on;
-			if (stage.whenMatched !== void 0) merge["whenMatched"] = Array.isArray(stage.whenMatched) ? stage.whenMatched.map((s) => lowerStage(s)) : stage.whenMatched;
+			if (stage.whenMatched !== void 0) merge["whenMatched"] = Array.isArray(stage.whenMatched) ? await Promise.all(stage.whenMatched.map((s) => lowerStage(s, codecs, ctx))) : stage.whenMatched;
 			if (stage.whenNotMatched !== void 0) merge["whenNotMatched"] = stage.whenNotMatched;
 			return { $merge: merge };
 		}
@@ -315,8 +380,8 @@ function lowerStage(stage) {
 		}
 	}
 }
-function lowerPipeline(stages) {
-	return stages.map(lowerStage);
+async function lowerPipeline(stages, codecs, ctx) {
+	return Promise.all(stages.map((s) => lowerStage(s, codecs, ctx)));
 }
 
 //#endregion
@@ -373,7 +438,12 @@ const mongoDateCodec = mongoCodec({
 	targetTypes: ["date"],
 	traits: ["equality", "order"],
 	decode: (wire) => wire,
-	encode: (value) => value
+	encode: (value) => value,
+	encodeJson: (value) => value.toISOString(),
+	decodeJson: (json) => {
+		if (typeof json !== "string") throw new Error("expected ISO date string");
+		return new Date(json);
+	}
 });
 const mongoVectorCodec = mongoCodec({
 	typeId: MONGO_VECTOR_CODEC_ID,
@@ -388,6 +458,36 @@ const mongoVectorCodec = mongoCodec({
 		return `Vector<${length}>`;
 	}
 });
+/**
+* The canonical set of Mongo wire-type codecs.
+*
+* Single source of truth for both control- and runtime-plane adapter
+* descriptors. Don't duplicate this list — import it.
+*/
+const mongoStandardCodecs = [
+	mongoObjectIdCodec,
+	mongoStringCodec,
+	mongoDoubleCodec,
+	mongoInt32Codec,
+	mongoBooleanCodec,
+	mongoDateCodec,
+	mongoVectorCodec
+];
+/**
+* Build a {@link MongoCodecRegistry} preloaded with the standard Mongo
+* wire-type codecs.
+*
+* Single point of truth for adapter-side codec construction: used by the
+* legacy synchronous `createMongoAdapter()` factory and by the runtime
+* adapter descriptor's `codecs()` getter. Userland code obtains a registry
+* via the framework's execution-stack composition (see
+* `createMongoExecutionContext`) instead of calling this directly.
+*/
+function buildStandardCodecRegistry() {
+	const registry = createMongoCodecRegistry();
+	for (const codec of mongoStandardCodecs) registry.register(codec);
+	return registry;
+}
 
 //#endregion
 //#region src/mongo-adapter.ts
@@ -399,27 +499,41 @@ var MongoAdapterImpl = class {
 	constructor(codecs) {
 		this.#codecs = codecs;
 	}
-	#resolveDocument(expr) {
+	async #resolveDocument(expr, ctx) {
+		const entries = Object.entries(expr);
+		const resolved = await Promise.all(entries.map(([, val]) => resolveValue(val, this.#codecs, ctx)));
 		const result = {};
-		for (const [key, val] of Object.entries(expr)) result[key] = resolveValue(val, this.#codecs);
+		for (let i = 0; i < entries.length; i++) {
+			const entry = entries[i];
+			if (entry) result[entry[0]] = resolved[i];
+		}
 		return result;
 	}
-	#lowerUpdate(update) {
-		if (isUpdatePipeline(update)) return update.map((stage) => lowerStage(stage));
-		return this.#resolveDocument(update);
+	async #lowerUpdate(update, ctx) {
+		if (isUpdatePipeline(update)) return Promise.all(update.map((stage) => lowerStage(stage, this.#codecs, ctx)));
+		return this.#resolveDocument(update, ctx);
 	}
-	lower(plan) {
+	async lower(plan, ctx) {
 		const { command } = plan;
 		switch (command.kind) {
-			case "insertOne": return new InsertOneWireCommand(command.collection, this.#resolveDocument(command.document));
-			case "updateOne": return new UpdateOneWireCommand(command.collection, lowerFilter(command.filter), this.#lowerUpdate(command.update), command.upsert);
-			case "insertMany": return new InsertManyWireCommand(command.collection, command.documents.map((doc) => this.#resolveDocument(doc)));
-			case "updateMany": return new UpdateManyWireCommand(command.collection, lowerFilter(command.filter), this.#lowerUpdate(command.update), command.upsert);
-			case "deleteOne": return new DeleteOneWireCommand(command.collection, lowerFilter(command.filter));
-			case "deleteMany": return new DeleteManyWireCommand(command.collection, lowerFilter(command.filter));
-			case "findOneAndUpdate": return new FindOneAndUpdateWireCommand(command.collection, lowerFilter(command.filter), this.#lowerUpdate(command.update), command.upsert, command.sort, command.returnDocument);
-			case "findOneAndDelete": return new FindOneAndDeleteWireCommand(command.collection, lowerFilter(command.filter), command.sort);
-			case "aggregate": return new AggregateWireCommand(command.collection, lowerPipeline(command.pipeline));
+			case "insertOne": return new InsertOneWireCommand(command.collection, await this.#resolveDocument(command.document, ctx));
+			case "updateOne": {
+				const [filter, update] = await Promise.all([lowerFilter(command.filter, this.#codecs, ctx), this.#lowerUpdate(command.update, ctx)]);
+				return new UpdateOneWireCommand(command.collection, filter, update, command.upsert);
+			}
+			case "insertMany": return new InsertManyWireCommand(command.collection, await Promise.all(command.documents.map((doc) => this.#resolveDocument(doc, ctx))));
+			case "updateMany": {
+				const [filter, update] = await Promise.all([lowerFilter(command.filter, this.#codecs, ctx), this.#lowerUpdate(command.update, ctx)]);
+				return new UpdateManyWireCommand(command.collection, filter, update, command.upsert);
+			}
+			case "deleteOne": return new DeleteOneWireCommand(command.collection, await lowerFilter(command.filter, this.#codecs, ctx));
+			case "deleteMany": return new DeleteManyWireCommand(command.collection, await lowerFilter(command.filter, this.#codecs, ctx));
+			case "findOneAndUpdate": {
+				const [filter, update] = await Promise.all([lowerFilter(command.filter, this.#codecs, ctx), this.#lowerUpdate(command.update, ctx)]);
+				return new FindOneAndUpdateWireCommand(command.collection, filter, update, command.upsert, command.sort, command.returnDocument);
+			}
+			case "findOneAndDelete": return new FindOneAndDeleteWireCommand(command.collection, await lowerFilter(command.filter, this.#codecs, ctx), command.sort);
+			case "aggregate": return new AggregateWireCommand(command.collection, await lowerPipeline(command.pipeline, this.#codecs, ctx));
 			case "rawAggregate": return new AggregateWireCommand(command.collection, command.pipeline);
 			case "rawInsertOne": return new InsertOneWireCommand(command.collection, command.document);
 			case "rawInsertMany": return new InsertManyWireCommand(command.collection, command.documents);
@@ -436,23 +550,19 @@ var MongoAdapterImpl = class {
 		}
 	}
 };
-function defaultCodecRegistry() {
-	const registry = createMongoCodecRegistry();
-	for (const codec of [
-		mongoObjectIdCodec,
-		mongoStringCodec,
-		mongoDoubleCodec,
-		mongoInt32Codec,
-		mongoBooleanCodec,
-		mongoDateCodec,
-		mongoVectorCodec
-	]) registry.register(codec);
-	return registry;
-}
-function createMongoAdapter(codecs) {
-	return new MongoAdapterImpl(codecs ?? defaultCodecRegistry());
+/**
+* Construct a Mongo adapter with the standard wire-type codecs registered
+* for encode-side dispatch (`MongoParamRef.codecId` lookups).
+*
+* The runtime-side codec registry the runtime decodes against is composed
+* separately by `createMongoExecutionContext`. This factory exists for
+* direct adapter use (the runtime descriptor's `create(stack)` calls
+* through it). User code should compose a stack/context instead.
+*/
+function createMongoAdapter() {
+	return new MongoAdapterImpl(buildStandardCodecRegistry());
 }
 
 //#endregion
-export { mongoInt32Codec as a, mongoVectorCodec as c, lowerPipeline as d, lowerStage as f, mongoDoubleCodec as i, lowerAggExpr as l, MONGO_VECTOR_CODEC_ID as m, mongoBooleanCodec as n, mongoObjectIdCodec as o, MONGO_INT32_CODEC_ID as p, mongoDateCodec as r, mongoStringCodec as s, createMongoAdapter as t, lowerFilter as u };
-//# sourceMappingURL=mongo-adapter-aVo8aZrf.mjs.map
+export { lowerFilter as a, MONGO_VECTOR_CODEC_ID as c, lowerAggExpr as i, buildStandardCodecRegistry as n, lowerPipeline as o, mongoStandardCodecs as r, lowerStage as s, createMongoAdapter as t };
+//# sourceMappingURL=mongo-adapter-ByNtvoHK.mjs.map