@prisma-next/mongo 0.10.0 → 0.11.0

package/README.md

@@ -1,12 +1,19 @@
 # @prisma-next/mongo
 
-One-package MongoDB setup for Prisma Next. Install this single package to get config, runtime, and all transitive type dependencies.
+One-package MongoDB setup for Prisma Next. Install this single package to get config, runtime, contract authoring, control-plane access, and BSON value constructors — no reach-ins to internal packages required.
+
+> **Breaking change:** the top-level `@prisma-next/mongo` barrel (`import { ObjectId } from '@prisma-next/mongo'`) has been removed. Move BSON constructor imports to `@prisma-next/mongo/bson`:
+>
+> ```diff
+> - import { ObjectId } from '@prisma-next/mongo';
+> + import { ObjectId } from '@prisma-next/mongo/bson';
+> ```
 
 ## Package Classification
 
 - **Domain**: extensions
 - **Layer**: adapters
-- **Planes**: shared (config), runtime (runtime)
+- **Planes**: shared (config, contract-builder, bson, family, target), migration (control), runtime (runtime)
 
 ## Quick Start
 
@@ -20,27 +27,83 @@ export default defineConfig({
 });
 ```
 
+```typescript
+// prisma/contract.ts
+import { defineContract, field, model } from '@prisma-next/mongo/contract-builder';
+
+export default defineContract({
+  models: {
+    User: model('User', { fields: { id: field.objectId() } }),
+  },
+});
+```
+
 ## Exports
 
 ### `@prisma-next/mongo/config`
 
-Simplified `defineConfig` that pre-wires all MongoDB internals (family, target, adapter, driver, contract providers). Pass a contract path and optional db config.
+Simplified `defineConfig` that pre-wires all MongoDB internals (family, target, adapter, driver, contract providers). Accepts `contract`, `db`, `extensions`, and `migrations.dir`.
 
-### `@prisma-next/mongo/runtime`
+```typescript
+import { defineConfig } from '@prisma-next/mongo/config';
 
-Re-exports `createMongoRuntime` from `@prisma-next/mongo-runtime` for composing the MongoDB execution pipeline.
+export default defineConfig({
+  contract: './prisma/contract.prisma',
+  db: { connection: process.env['MONGODB_URL']! },
+  migrations: { dir: 'migrations/app' },
+});
+```
 
 ### `@prisma-next/mongo/contract-builder`
 
-Re-exports the TypeScript contract authoring DSL (`defineContract`, `field`, `model`, `rel`, ...) so a generated `prisma/contract.ts` can author its contract using only this facade package.
+TypeScript contract authoring DSL (`defineContract`, `field`, `model`, `rel`, `index`, `valueObject`, …). The `defineContract` facade pre-binds `family` and `target` — callers do not pass those fields.
+
+```typescript
+import { defineContract, field, model } from '@prisma-next/mongo/contract-builder';
+
+export default defineContract({
+  models: {
+    User: model('User', { fields: { id: field.objectId() } }),
+  },
+});
+```
+
+### `@prisma-next/mongo/control`
+
+Control-plane client factory. Collapses the family + target + adapter + driver wiring into a single call.
+
+```typescript
+import { createMongoControlClient } from '@prisma-next/mongo/control';
+
+const control = createMongoControlClient({
+  connection: process.env['MONGODB_URL']!,
+});
+await control.dbUpdate({ migrations: { dir: 'migrations/app' } });
+```
+
+### `@prisma-next/mongo/bson`
+
+BSON value constructors for use in seed scripts, fixtures, and tests.
+
+```typescript
+import { ObjectId } from '@prisma-next/mongo/bson';
+
+const id = new ObjectId();
+```
+
+Exports: `Binary`, `Decimal128`, `Long`, `MongoClient`, `ObjectId`, `Timestamp`.
+
+### `@prisma-next/mongo/runtime`
+
+Re-exports `createMongoRuntime` from `@prisma-next/mongo-runtime` for composing the MongoDB execution pipeline.
 
 ### `@prisma-next/mongo/family`
 
-Re-exports the MongoDB family pack (the value passed as `family:` to `defineContract`).
+Re-exports the MongoDB family pack (only needed when using the low-level API; `defineContract` pre-binds this for you).
 
 ### `@prisma-next/mongo/target`
 
-Re-exports the MongoDB target pack (the value passed as `target:` to `defineContract`).
+Re-exports the MongoDB target pack (only needed when using the low-level API; `defineContract` pre-binds this for you).
 
 ## Dependencies
 

package/dist/config.d.mts

@@ -1,4 +1,5 @@
 import { PrismaNextConfig } from "@prisma-next/config/config-types";
+import { ControlExtensionDescriptor } from "@prisma-next/framework-components/control";
 
 //#region src/config/define-config.d.ts
 interface MongoConfigOptions {
@@ -6,6 +7,10 @@ interface MongoConfigOptions {
   readonly db?: {
     readonly connection?: string;
   };
+  readonly extensions?: readonly ControlExtensionDescriptor<'mongo', 'mongo'>[];
+  readonly migrations?: {
+    readonly dir?: string;
+  };
 }
 declare function defineConfig(options: MongoConfigOptions): PrismaNextConfig<'mongo', 'mongo'>;
 //#endregion

package/dist/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config/define-config.ts"],"mappings":";;;UAUiB,kBAAA;EAAA,SACN,QAAA;EAAA,SACA,EAAA;IAAA,SACE,UAAA;EAAA;AAAA;AAAA,iBAYG,YAAA,CAAa,OAAA,EAAS,kBAAA,GAAqB,gBAAA"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config/define-config.ts"],"mappings":";;;;UAYiB,kBAAA;EAAA,SACN,QAAA;EAAA,SACA,EAAA;IAAA,SACE,UAAA;EAAA;EAAA,SAEF,UAAA,YAAsB,0BAAA;EAAA,SACtB,UAAA;IAAA,SACE,GAAA;EAAA;AAAA;AAAA,iBAYG,YAAA,CAAa,OAAA,EAAS,kBAAA,GAAqB,gBAAA"}

package/dist/config.mjs

@@ -5,6 +5,7 @@ import { mongoFamilyDescriptor } from "@prisma-next/family-mongo/control";
 import { mongoContract } from "@prisma-next/mongo-contract-psl/provider";
 import { typescriptContractFromPath } from "@prisma-next/mongo-contract-ts/config-types";
 import { mongoTargetDescriptor } from "@prisma-next/target-mongo/control";
+import { ifDefined } from "@prisma-next/utils/defined";
 import { extname } from "pathe";
 //#region src/config/define-config.ts
 function deriveOutputPath(contractPath) {
@@ -13,14 +14,17 @@ function deriveOutputPath(contractPath) {
 	return `${contractPath.slice(0, -ext.length)}.json`;
 }
 function defineConfig(options) {
+	const extensions = options.extensions ?? [];
 	const output = deriveOutputPath(options.contract);
 	return defineConfig$1({
 		family: mongoFamilyDescriptor,
 		target: mongoTargetDescriptor,
 		adapter: mongoAdapter,
 		driver: mongoDriver,
+		extensionPacks: extensions,
 		contract: extname(options.contract) === ".ts" ? typescriptContractFromPath(options.contract, output) : mongoContract(options.contract, { output }),
-		...options.db !== void 0 ? { db: options.db } : {}
+		...ifDefined("db", options.db),
+		...ifDefined("migrations", options.migrations)
 	});
 }
 //#endregion

package/dist/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":["coreDefineConfig"],"sources":["../src/config/define-config.ts"],"sourcesContent":["import mongoAdapter from '@prisma-next/adapter-mongo/control';\nimport type { PrismaNextConfig } from '@prisma-next/config/config-types';\nimport { defineConfig as coreDefineConfig } from '@prisma-next/config/config-types';\nimport mongoDriver from '@prisma-next/driver-mongo/control';\nimport { mongoFamilyDescriptor } from '@prisma-next/family-mongo/control';\nimport { mongoContract } from '@prisma-next/mongo-contract-psl/provider';\nimport { typescriptContractFromPath } from '@prisma-next/mongo-contract-ts/config-types';\nimport { mongoTargetDescriptor } from '@prisma-next/target-mongo/control';\nimport { extname } from 'pathe';\n\nexport interface MongoConfigOptions {\n  readonly contract: string;\n  readonly db?: {\n    readonly connection?: string;\n  };\n}\n\nfunction deriveOutputPath(contractPath: string): string {\n  const ext = extname(contractPath);\n  if (ext.length === 0) {\n    return `${contractPath}.json`;\n  }\n  return `${contractPath.slice(0, -ext.length)}.json`;\n}\n\nexport function defineConfig(options: MongoConfigOptions): PrismaNextConfig<'mongo', 'mongo'> {\n  const output = deriveOutputPath(options.contract);\n  const ext = extname(options.contract);\n\n  const contractConfig =\n    ext === '.ts'\n      ? typescriptContractFromPath(options.contract, output)\n      : mongoContract(options.contract, { output });\n\n  return coreDefineConfig({\n    family: mongoFamilyDescriptor,\n    target: mongoTargetDescriptor,\n    adapter: mongoAdapter,\n    driver: mongoDriver,\n    contract: contractConfig,\n    ...(options.db !== undefined ? { db: options.db } : {}),\n  });\n}\n"],"mappings":";;;;;;;;;AAiBA,SAAS,iBAAiB,cAA8B;CACtD,MAAM,MAAM,QAAQ,aAAa;CACjC,IAAI,IAAI,WAAW,GACjB,OAAO,GAAG,aAAa;CAEzB,OAAO,GAAG,aAAa,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC;;AAG/C,SAAgB,aAAa,SAAiE;CAC5F,MAAM,SAAS,iBAAiB,QAAQ,SAAS;CAQjD,OAAOA,eAAiB;EACtB,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,UAZU,QAAQ,QAAQ,SAGvB,KAAK,QACJ,2BAA2B,QAAQ,UAAU,OAAO,GACpD,cAAc,QAAQ,UAAU,EAAE,QAAQ,CAAC;EAQ/C,GAAI,QAAQ,OAAO,KAAA,IAAY,EAAE,IAAI,QAAQ,IAAI,GAAG,EAAE;EACvD,CAAC"}
+{"version":3,"file":"config.mjs","names":["coreDefineConfig"],"sources":["../src/config/define-config.ts"],"sourcesContent":["import mongoAdapter from '@prisma-next/adapter-mongo/control';\nimport type { PrismaNextConfig } from '@prisma-next/config/config-types';\nimport { defineConfig as coreDefineConfig } from '@prisma-next/config/config-types';\nimport mongoDriver from '@prisma-next/driver-mongo/control';\nimport { mongoFamilyDescriptor } from '@prisma-next/family-mongo/control';\nimport type { ControlExtensionDescriptor } from '@prisma-next/framework-components/control';\nimport { mongoContract } from '@prisma-next/mongo-contract-psl/provider';\nimport { typescriptContractFromPath } from '@prisma-next/mongo-contract-ts/config-types';\nimport { mongoTargetDescriptor } from '@prisma-next/target-mongo/control';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { extname } from 'pathe';\n\nexport interface MongoConfigOptions {\n  readonly contract: string;\n  readonly db?: {\n    readonly connection?: string;\n  };\n  readonly extensions?: readonly ControlExtensionDescriptor<'mongo', 'mongo'>[];\n  readonly migrations?: {\n    readonly dir?: string;\n  };\n}\n\nfunction deriveOutputPath(contractPath: string): string {\n  const ext = extname(contractPath);\n  if (ext.length === 0) {\n    return `${contractPath}.json`;\n  }\n  return `${contractPath.slice(0, -ext.length)}.json`;\n}\n\nexport function defineConfig(options: MongoConfigOptions): PrismaNextConfig<'mongo', 'mongo'> {\n  const extensions = options.extensions ?? [];\n  const output = deriveOutputPath(options.contract);\n  const ext = extname(options.contract);\n\n  const contractConfig =\n    ext === '.ts'\n      ? typescriptContractFromPath(options.contract, output)\n      : mongoContract(options.contract, { output });\n\n  return coreDefineConfig({\n    family: mongoFamilyDescriptor,\n    target: mongoTargetDescriptor,\n    adapter: mongoAdapter,\n    driver: mongoDriver,\n    extensionPacks: extensions,\n    contract: contractConfig,\n    ...ifDefined('db', options.db),\n    ...ifDefined('migrations', options.migrations),\n  });\n}\n"],"mappings":";;;;;;;;;;AAuBA,SAAS,iBAAiB,cAA8B;CACtD,MAAM,MAAM,QAAQ,aAAa;CACjC,IAAI,IAAI,WAAW,GACjB,OAAO,GAAG,aAAa;CAEzB,OAAO,GAAG,aAAa,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC;;AAG/C,SAAgB,aAAa,SAAiE;CAC5F,MAAM,aAAa,QAAQ,cAAc,EAAE;CAC3C,MAAM,SAAS,iBAAiB,QAAQ,SAAS;CAQjD,OAAOA,eAAiB;EACtB,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,gBAAgB;EAChB,UAbU,QAAQ,QAAQ,SAGvB,KAAK,QACJ,2BAA2B,QAAQ,UAAU,OAAO,GACpD,cAAc,QAAQ,UAAU,EAAE,QAAQ,CAAC;EAS/C,GAAG,UAAU,MAAM,QAAQ,GAAG;EAC9B,GAAG,UAAU,cAAc,QAAQ,WAAW;EAC/C,CAAC"}

package/dist/contract-builder.d.mts

@@ -1,2 +1,31 @@
-import { ContractDefinition, ContractFactory, ContractScaffold, FieldBuilder, FieldReference, ModelBuilder, MongoContractResult, RelationBuilder, ValueObjectBuilder, defineContract, field, index, model, rel, valueObject } from "@prisma-next/mongo-contract-ts/contract-builder";
-export { type ContractDefinition, type ContractFactory, type ContractScaffold, type FieldBuilder, type FieldReference, type ModelBuilder, type MongoContractResult, type RelationBuilder, type ValueObjectBuilder, defineContract, field, index, model, rel, valueObject };
+import { ContractDefinition, ContractDefinition as ContractDefinition$1, ContractFactory, ContractFactory as ContractFactory$1, ContractScaffold, ContractScaffold as ContractScaffold$1, FieldBuilder, FieldReference, ModelBuilder, MongoContractResult, MongoContractResult as MongoContractResult$1, RelationBuilder, ValueObjectBuilder, field, index, model, rel, valueObject } from "@prisma-next/mongo-contract-ts/contract-builder";
+import mongoFamilyPack from "@prisma-next/family-mongo/pack";
+import mongoTargetPack from "@prisma-next/target-mongo/pack";
+
+//#region src/contract/define-contract.d.ts
+type MongoFamilyPack = typeof mongoFamilyPack;
+type MongoTargetPack = typeof mongoTargetPack;
+type MongoHelpers = Parameters<ContractFactory$1<Record<never, never>, Record<never, never>, undefined, MongoFamilyPack, MongoTargetPack, undefined>>[0];
+type MongoDefinitionInput = Omit<ContractDefinition$1<MongoFamilyPack, MongoTargetPack>, 'family' | 'target'> & {
+  readonly family?: never;
+  readonly target?: never;
+};
+type MongoScaffoldInput = Omit<ContractScaffold$1<MongoFamilyPack, MongoTargetPack>, 'family' | 'target'> & {
+  readonly family?: never;
+  readonly target?: never;
+};
+declare function defineContract<const Definition extends MongoDefinitionInput>(definition: Definition): MongoContractResult$1<Definition & {
+  readonly family: MongoFamilyPack;
+  readonly target: MongoTargetPack;
+}>;
+declare function defineContract<const Definition extends MongoScaffoldInput, const Built extends {
+  readonly models?: Record<string, unknown>;
+  readonly valueObjects?: Record<string, unknown>;
+  readonly roots?: Record<string, string>;
+}>(scaffold: Definition, factory: (helpers: MongoHelpers) => Built): MongoContractResult$1<Definition & Built & {
+  readonly family: MongoFamilyPack;
+  readonly target: MongoTargetPack;
+}>;
+//#endregion
+export { type ContractDefinition, type ContractFactory, type ContractScaffold, type FieldBuilder, type FieldReference, type ModelBuilder, type MongoContractResult, type RelationBuilder, type ValueObjectBuilder, defineContract, field, index, model, rel, valueObject };
+//# sourceMappingURL=contract-builder.d.mts.map

package/dist/contract-builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-builder.d.mts","names":[],"sources":["../src/contract/define-contract.ts"],"mappings":";;;;;KAUK,eAAA,UAAyB,eAAA;AAAA,KACzB,eAAA,UAAyB,eAAA;AAAA,KAIzB,YAAA,GAAe,UAAA,CAClB,iBAAA,CACE,MAAA,gBACA,MAAA,2BAEA,eAAA,EACA,eAAA;AAAA,KAOC,oBAAA,GAAuB,IAAA,CAC1B,oBAAA,CAAmB,eAAA,EAAiB,eAAA;EAAA,SAG3B,MAAA;EAAA,SACA,MAAA;AAAA;AAAA,KAGN,kBAAA,GAAqB,IAAA,CACxB,kBAAA,CAAiB,eAAA,EAAiB,eAAA;EAAA,SAGzB,MAAA;EAAA,SACA,MAAA;AAAA;AAAA,iBAIK,cAAA,0BAAwC,oBAAA,CAAA,CACtD,UAAA,EAAY,UAAA,GACX,qBAAA,CACD,UAAA;EAAA,SAAwB,MAAA,EAAQ,eAAA;EAAA,SAA0B,MAAA,EAAQ,eAAA;AAAA;AAAA,iBAIpD,cAAA,0BACW,kBAAA;EAAA,SAEd,MAAA,GAAS,MAAA;EAAA,SACT,YAAA,GAAe,MAAA;EAAA,SACf,KAAA,GAAQ,MAAA;AAAA,EAAA,CAGnB,QAAA,EAAU,UAAA,EACV,OAAA,GAAU,OAAA,EAAS,YAAA,KAAiB,KAAA,GACnC,qBAAA,CACD,UAAA,GAAa,KAAA;EAAA,SAAmB,MAAA,EAAQ,eAAA;EAAA,SAA0B,MAAA,EAAQ,eAAA;AAAA"}

package/dist/contract-builder.mjs

@@ -1,2 +1,17 @@
-import { defineContract, field, index, model, rel, valueObject } from "@prisma-next/mongo-contract-ts/contract-builder";
+import { defineContract as defineContract$1, field, index, model, rel, valueObject } from "@prisma-next/mongo-contract-ts/contract-builder";
+import mongoFamilyPack from "@prisma-next/family-mongo/pack";
+import mongoTargetPack from "@prisma-next/target-mongo/pack";
+//#region src/contract/define-contract.ts
+function defineContract(definition, factory) {
+	const full = {
+		...definition,
+		family: mongoFamilyPack,
+		target: mongoTargetPack
+	};
+	if (factory !== void 0) return defineContract$1(full, factory);
+	return defineContract$1(full);
+}
+//#endregion
 export { defineContract, field, index, model, rel, valueObject };
+
+//# sourceMappingURL=contract-builder.mjs.map

package/dist/contract-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-builder.mjs","names":["baseDefineContract"],"sources":["../src/contract/define-contract.ts"],"sourcesContent":["import mongoFamilyPack from '@prisma-next/family-mongo/pack';\nimport type {\n  ContractDefinition,\n  ContractFactory,\n  ContractScaffold,\n  MongoContractResult,\n} from '@prisma-next/mongo-contract-ts/contract-builder';\nimport { defineContract as baseDefineContract } from '@prisma-next/mongo-contract-ts/contract-builder';\nimport mongoTargetPack from '@prisma-next/target-mongo/pack';\n\ntype MongoFamilyPack = typeof mongoFamilyPack;\ntype MongoTargetPack = typeof mongoTargetPack;\n\n// Helpers type derived from the exported ContractFactory rather than the\n// un-exported ContractAuthoringHelpers, so we stay inside the public surface.\ntype MongoHelpers = Parameters<\n  ContractFactory<\n    Record<never, never>,\n    Record<never, never>,\n    undefined,\n    MongoFamilyPack,\n    MongoTargetPack,\n    undefined\n  >\n>[0];\n\n// Input types omit family + target AND explicitly forbid them so that\n// `@ts-expect-error` tests can verify the fields are rejected.\ntype MongoDefinitionInput = Omit<\n  ContractDefinition<MongoFamilyPack, MongoTargetPack>,\n  'family' | 'target'\n> & {\n  readonly family?: never;\n  readonly target?: never;\n};\n\ntype MongoScaffoldInput = Omit<\n  ContractScaffold<MongoFamilyPack, MongoTargetPack>,\n  'family' | 'target'\n> & {\n  readonly family?: never;\n  readonly target?: never;\n};\n\n// Overload 1: definition form — models / valueObjects inline in the definition object.\nexport function defineContract<const Definition extends MongoDefinitionInput>(\n  definition: Definition,\n): MongoContractResult<\n  Definition & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }\n>;\n\n// Overload 2: factory form — models / valueObjects provided by a factory function.\nexport function defineContract<\n  const Definition extends MongoScaffoldInput,\n  const Built extends {\n    readonly models?: Record<string, unknown>;\n    readonly valueObjects?: Record<string, unknown>;\n    readonly roots?: Record<string, string>;\n  },\n>(\n  scaffold: Definition,\n  factory: (helpers: MongoHelpers) => Built,\n): MongoContractResult<\n  Definition & Built & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }\n>;\n\n// Implementation — pre-binds family and target before delegating to the base.\n// The `as unknown` cast is safe: every declared overload produces a MongoContractResult\n// and the only difference between the public overload signatures and the impl is\n// that we union both call forms here.\nexport function defineContract(\n  definition: MongoDefinitionInput,\n  factory?: (helpers: MongoHelpers) => {\n    readonly models?: Record<string, unknown>;\n    readonly valueObjects?: Record<string, unknown>;\n    readonly roots?: Record<string, string>;\n  },\n): MongoContractResult<\n  MongoDefinitionInput & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }\n> {\n  const full = {\n    ...definition,\n    family: mongoFamilyPack,\n    target: mongoTargetPack,\n  } as ContractDefinition<MongoFamilyPack, MongoTargetPack>;\n\n  if (factory !== undefined) {\n    return baseDefineContract(\n      full as ContractScaffold<MongoFamilyPack, MongoTargetPack>,\n      factory as unknown as Parameters<typeof baseDefineContract>[1],\n    ) as unknown as MongoContractResult<\n      MongoDefinitionInput & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }\n    >;\n  }\n\n  return baseDefineContract(full) as unknown as MongoContractResult<\n    MongoDefinitionInput & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }\n  >;\n}\n"],"mappings":";;;;AAsEA,SAAgB,eACd,YACA,SAOA;CACA,MAAM,OAAO;EACX,GAAG;EACH,QAAQ;EACR,QAAQ;EACT;CAED,IAAI,YAAY,KAAA,GACd,OAAOA,iBACL,MACA,QACD;CAKH,OAAOA,iBAAmB,KAAK"}

package/dist/control.d.mts

@@ -0,0 +1,11 @@
+import { ControlClient, ControlClientOptions } from "@prisma-next/cli/control-api";
+
+//#region src/exports/control.d.ts
+interface MongoControlClientOptions {
+  readonly connection?: string;
+  readonly extensionPacks?: ControlClientOptions['extensionPacks'];
+}
+declare function createMongoControlClient(options?: MongoControlClientOptions): ControlClient;
+//#endregion
+export { type ControlClient, MongoControlClientOptions, createMongoControlClient };
+//# sourceMappingURL=control.d.mts.map

package/dist/control.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.mts","names":[],"sources":["../src/exports/control.ts"],"mappings":";;;UAWiB,yBAAA;EAAA,SACN,UAAA;EAAA,SACA,cAAA,GAAiB,oBAAA;AAAA;AAAA,iBAGZ,wBAAA,CAAyB,OAAA,GAAS,yBAAA,GAAiC,aAAA"}

package/dist/control.mjs

@@ -0,0 +1,21 @@
+import mongoAdapter from "@prisma-next/adapter-mongo/control";
+import mongoDriver from "@prisma-next/driver-mongo/control";
+import { mongoFamilyDescriptor } from "@prisma-next/family-mongo/control";
+import { mongoTargetDescriptor } from "@prisma-next/target-mongo/control";
+import { ifDefined } from "@prisma-next/utils/defined";
+import { createControlClient } from "@prisma-next/cli/control-api";
+//#region src/exports/control.ts
+function createMongoControlClient(options = {}) {
+	return createControlClient({
+		family: mongoFamilyDescriptor,
+		target: mongoTargetDescriptor,
+		adapter: mongoAdapter,
+		driver: mongoDriver,
+		...ifDefined("connection", options.connection),
+		...ifDefined("extensionPacks", options.extensionPacks)
+	});
+}
+//#endregion
+export { createMongoControlClient };
+
+//# sourceMappingURL=control.mjs.map

package/dist/control.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.mjs","names":[],"sources":["../src/exports/control.ts"],"sourcesContent":["import mongoAdapter from '@prisma-next/adapter-mongo/control';\nimport {\n  type ControlClient,\n  type ControlClientOptions,\n  createControlClient,\n} from '@prisma-next/cli/control-api';\nimport mongoDriver from '@prisma-next/driver-mongo/control';\nimport { mongoFamilyDescriptor } from '@prisma-next/family-mongo/control';\nimport { mongoTargetDescriptor } from '@prisma-next/target-mongo/control';\nimport { ifDefined } from '@prisma-next/utils/defined';\n\nexport interface MongoControlClientOptions {\n  readonly connection?: string;\n  readonly extensionPacks?: ControlClientOptions['extensionPacks'];\n}\n\nexport function createMongoControlClient(options: MongoControlClientOptions = {}): ControlClient {\n  const clientOptions: ControlClientOptions = {\n    family: mongoFamilyDescriptor,\n    target: mongoTargetDescriptor,\n    adapter: mongoAdapter,\n    driver: mongoDriver,\n    ...ifDefined('connection', options.connection),\n    ...ifDefined('extensionPacks', options.extensionPacks),\n  };\n  return createControlClient(clientOptions);\n}\n\nexport type { ControlClient };\n"],"mappings":";;;;;;;AAgBA,SAAgB,yBAAyB,UAAqC,EAAE,EAAiB;CAS/F,OAAO,oBAAoB;EAPzB,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,GAAG,UAAU,cAAc,QAAQ,WAAW;EAC9C,GAAG,UAAU,kBAAkB,QAAQ,eAAe;EAEhB,CAAC"}

package/dist/runtime.d.mts

@@ -50,6 +50,7 @@ interface MongoClient<TContract extends MongoContractWithTypeMaps<MongoContract,
   connect(bindingInput?: MongoBindingInput): Promise<MongoRuntime>;
   runtime(): Promise<MongoRuntime>;
   close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
 }
 interface MongoOptionsBase {
   readonly mode?: 'strict' | 'permissive';

package/dist/runtime.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/mongo.ts"],"mappings":";;;;;;;;KAEY,YAAA;EAAA,SACG,IAAA;EAAA,SAAsB,GAAA;EAAA,SAAsB,MAAA;AAAA;EAAA,SAE5C,IAAA;EAAA,SACA,MAAA,EAAQ,aAAA;EAAA,SACR,MAAA;AAAA;AAAA,KAGH,iBAAA;EAAA,SAEG,OAAA,EAAS,YAAA;EAAA,SACT,GAAA;EAAA,SACA,GAAA;EAAA,SACA,MAAA;EAAA,SACA,WAAA;AAAA;EAAA,SAGA,GAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAAA,SACA,GAAA;EAAA,SACA,WAAA;AAAA;EAAA,SAGA,GAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAAA,SACA,GAAA;EAAA,SACA,WAAA;AAAA;EAAA,SAGA,WAAA,EAAa,aAAA;EAAA,SACb,MAAA;EAAA,SACA,OAAA;EAAA,SACA,GAAA;EAAA,SACA,GAAA;AAAA;;;KCVH,aAAA;AAAA,UAEK,WAAA,mBACG,yBAAA,CAA0B,aAAA,EAAe,aAAA;EAAA,SAElD,GAAA,EAAK,cAAA,CAAe,SAAA;EAAA,SACpB,KAAA,EAAO,UAAA,QAAkB,UAAA,CAAW,SAAA;EAAA,SACpC,QAAA,EAAU,SAAA;EACnB,OAAA,CAAQ,YAAA,GAAe,iBAAA,GAAoB,OAAA,CAAQ,YAAA;EACnD,OAAA,IAAW,OAAA,CAAQ,YAAA;EACnB,KAAA,IAAS,OAAA;AAAA;AAAA,UAGM,gBAAA;EAAA,SACN,IAAA;EDnCI;;;EAAA,SCuCJ,UAAA,YAAsB,eAAA;AAAA;AAAA,UAGhB,mBAAA;EAAA,SACN,OAAA,GAAU,YAAA;EAAA,SACV,GAAA;EAAA,SACA,GAAA;EAAA,SACA,MAAA;EAAA,SACA,WAAA,GAJsB,SAAA,CAIU,WAAA;AAAA;AAAA,KAG/B,wBAAA,mBACQ,yBAAA,CAA0B,aAAA,EAAe,aAAA,KACzD,mBAAA,GACF,gBAAA;EAAA,SACW,QAAA,EAAU,SAAA;EAAA,SACV,YAAA;AAAA;;;;;;KAQD,4BAAA,mBACQ,yBAAA,CAA0B,aAAA,EAAe,aAAA,KACzD,mBAAA,GACF,gBAAA;EAAA,SACW,YAAA;EAAA,SACA,QAAA;ED5CE;;;;EAAA,SCiDF,iBAAA,GAAoB,SAAA;AAAA;AAAA,KAGrB,YAAA,mBACQ,yBAAA,CAA0B,aAAA,EAAe,aAAA,KACzD,wBAAA,CAAyB,SAAA,IAAa,4BAAA,CAA6B,SAAA;;;;;;AAzDvE;;;iBAgFwB,KAAA,mBACJ,yBAAA,CAA0B,aAAA,EAAe,aAAA,EAAA,CAC3D,OAAA,EAAS,wBAAA,CAAyB,SAAA,IAAa,WAAA,CAAY,SAAA;AAAA,iBACrC,KAAA,mBACJ,yBAAA,CAA0B,aAAA,EAAe,aAAA,EAAA,CAC3D,OAAA,EAAS,4BAAA,CAA6B,SAAA,IAAa,WAAA,CAAY,SAAA"}
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/mongo.ts"],"mappings":";;;;;;;;KAEY,YAAA;EAAA,SACG,IAAA;EAAA,SAAsB,GAAA;EAAA,SAAsB,MAAA;AAAA;EAAA,SAE5C,IAAA;EAAA,SACA,MAAA,EAAQ,aAAA;EAAA,SACR,MAAA;AAAA;AAAA,KAGH,iBAAA;EAAA,SAEG,OAAA,EAAS,YAAA;EAAA,SACT,GAAA;EAAA,SACA,GAAA;EAAA,SACA,MAAA;EAAA,SACA,WAAA;AAAA;EAAA,SAGA,GAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAAA,SACA,GAAA;EAAA,SACA,WAAA;AAAA;EAAA,SAGA,GAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAAA,SACA,GAAA;EAAA,SACA,WAAA;AAAA;EAAA,SAGA,WAAA,EAAa,aAAA;EAAA,SACb,MAAA;EAAA,SACA,OAAA;EAAA,SACA,GAAA;EAAA,SACA,GAAA;AAAA;;;KCVH,aAAA;AAAA,UAEK,WAAA,mBACG,yBAAA,CAA0B,aAAA,EAAe,aAAA;EAAA,SAElD,GAAA,EAAK,cAAA,CAAe,SAAA;EAAA,SACpB,KAAA,EAAO,UAAA,QAAkB,UAAA,CAAW,SAAA;EAAA,SACpC,QAAA,EAAU,SAAA;EACnB,OAAA,CAAQ,YAAA,GAAe,iBAAA,GAAoB,OAAA,CAAQ,YAAA;EACnD,OAAA,IAAW,OAAA,CAAQ,YAAA;EACnB,KAAA,IAAS,OAAA;EAAA,CACR,MAAA,CAAO,YAAP,KAAwB,OAAA;AAAA;AAAA,UAGV,gBAAA;EAAA,SACN,IAAA;EDpCY;;;EAAA,SCwCZ,UAAA,YAAsB,eAAA;AAAA;AAAA,UAGhB,mBAAA;EAAA,SACN,OAAA,GAAU,YAAA;EAAA,SACV,GAAA;EAAA,SACA,GAAA;EAAA,SACA,MAAA;EAAA,SACA,WAAA,GAJsB,SAAA,CAIU,WAAA;AAAA;AAAA,KAG/B,wBAAA,mBACQ,yBAAA,CAA0B,aAAA,EAAe,aAAA,KACzD,mBAAA,GACF,gBAAA;EAAA,SACW,QAAA,EAAU,SAAA;EAAA,SACV,YAAA;AAAA;;;;;;KAQD,4BAAA,mBACQ,yBAAA,CAA0B,aAAA,EAAe,aAAA,KACzD,mBAAA,GACF,gBAAA;EAAA,SACW,YAAA;EAAA,SACA,QAAA;ED1CE;;;;EAAA,SC+CF,iBAAA,GAAoB,SAAA;AAAA;AAAA,KAGrB,YAAA,mBACQ,yBAAA,CAA0B,aAAA,EAAe,aAAA,KACzD,wBAAA,CAAyB,SAAA,IAAa,4BAAA,CAA6B,SAAA;;;;;AA1DvE;;;;iBAiFwB,KAAA,mBACJ,yBAAA,CAA0B,aAAA,EAAe,aAAA,EAAA,CAC3D,OAAA,EAAS,wBAAA,CAAyB,SAAA,IAAa,WAAA,CAAY,SAAA;AAAA,iBACrC,KAAA,mBACJ,yBAAA,CAA0B,aAAA,EAAe,aAAA,EAAA,CAC3D,OAAA,EAAS,4BAAA,CAA6B,SAAA,IAAa,WAAA,CAAY,SAAA"}

package/dist/runtime.mjs

@@ -1,3 +1,4 @@
+import { ifDefined } from "@prisma-next/utils/defined";
 import mongoRuntimeAdapter from "@prisma-next/adapter-mongo/runtime";
 import { MongoDriverImpl } from "@prisma-next/driver-mongo";
 import { MongoContractSerializer } from "@prisma-next/family-mongo/ir";
@@ -6,7 +7,6 @@ import { mongoOrm } from "@prisma-next/mongo-orm";
 import { mongoQuery } from "@prisma-next/mongo-query-builder";
 import { createMongoExecutionContext, createMongoExecutionStack, createMongoRuntime } from "@prisma-next/mongo-runtime";
 import mongoRuntimeTarget from "@prisma-next/target-mongo/runtime";
-import { ifDefined } from "@prisma-next/utils/defined";
 //#region src/runtime/binding.ts
 function validateMongoUrl(url) {
 	const trimmed = url.trim();
@@ -95,16 +95,20 @@ function mongo(options) {
 	const query = mongoQuery({ contractJson: contract });
 	let runtimePromise;
 	let closed = false;
+	let ownedDispose;
 	const buildRuntime = async (resolvedBinding) => {
+		const context = createMongoExecutionContext({
+			contract,
+			stack: createMongoExecutionStack({
+				target: mongoRuntimeTarget,
+				adapter: mongoRuntimeAdapter
+			})
+		});
+		const driver = resolvedBinding.kind === "url" ? await MongoDriverImpl.fromConnection(resolvedBinding.url, resolvedBinding.dbName) : MongoDriverImpl.fromDb(resolvedBinding.client.db(resolvedBinding.dbName));
+		if (resolvedBinding.kind === "url") ownedDispose = () => driver.close();
 		return createMongoRuntime({
-			context: createMongoExecutionContext({
-				contract,
-				stack: createMongoExecutionStack({
-					target: mongoRuntimeTarget,
-					adapter: mongoRuntimeAdapter
-				})
-			}),
-			driver: resolvedBinding.kind === "url" ? await MongoDriverImpl.fromConnection(resolvedBinding.url, resolvedBinding.dbName) : MongoDriverImpl.fromDb(resolvedBinding.client.db(resolvedBinding.dbName)),
+			context,
+			driver,
 			...options.mode !== void 0 ? { mode: options.mode } : {},
 			...ifDefined("middleware", options.middleware)
 		});
@@ -146,8 +150,14 @@ function mongo(options) {
 			closed = true;
 			if (runtimePromise === void 0) return;
 			try {
-				await (await runtimePromise).close();
+				await runtimePromise;
 			} catch {}
+			const dispose = ownedDispose;
+			ownedDispose = void 0;
+			await dispose?.();
+		},
+		[Symbol.asyncDispose]() {
+			return this.close();
 		}
 	};
 }

package/dist/runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.mjs","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/mongo.ts"],"sourcesContent":["import type { MongoClient as MongoDriverClient } from 'mongodb';\n\nexport type MongoBinding =\n  | { readonly kind: 'url'; readonly url: string; readonly dbName: string }\n  | {\n      readonly kind: 'mongoClient';\n      readonly client: MongoDriverClient;\n      readonly dbName: string;\n    };\n\nexport type MongoBindingInput =\n  | {\n      readonly binding: MongoBinding;\n      readonly url?: never;\n      readonly uri?: never;\n      readonly dbName?: never;\n      readonly mongoClient?: never;\n    }\n  | {\n      readonly url: string;\n      readonly dbName?: string;\n      readonly binding?: never;\n      readonly uri?: never;\n      readonly mongoClient?: never;\n    }\n  | {\n      readonly uri: string;\n      readonly dbName: string;\n      readonly binding?: never;\n      readonly url?: never;\n      readonly mongoClient?: never;\n    }\n  | {\n      readonly mongoClient: MongoDriverClient;\n      readonly dbName: string;\n      readonly binding?: never;\n      readonly url?: never;\n      readonly uri?: never;\n    };\n\ntype MongoBindingFields = {\n  readonly binding?: MongoBinding;\n  readonly url?: string;\n  readonly uri?: string;\n  readonly dbName?: string;\n  readonly mongoClient?: MongoDriverClient;\n};\n\nfunction validateMongoUrl(url: string): URL {\n  const trimmed = url.trim();\n  if (trimmed.length === 0) {\n    throw new Error('Mongo URL must be a non-empty string');\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(trimmed);\n  } catch {\n    throw new Error('Mongo URL must be a valid URL');\n  }\n\n  if (parsed.protocol !== 'mongodb:' && parsed.protocol !== 'mongodb+srv:') {\n    throw new Error('Mongo URL must use mongodb:// or mongodb+srv://');\n  }\n\n  return parsed;\n}\n\nfunction extractDbNameFromUrl(parsed: URL): string | undefined {\n  // pathname is \"/dbname\" or \"\" — strip the leading slash. Anything past\n  // a second slash is invalid for our purposes (auth-source style paths).\n  const path = parsed.pathname.startsWith('/') ? parsed.pathname.slice(1) : parsed.pathname;\n  if (path.length === 0) {\n    return undefined;\n  }\n  const slash = path.indexOf('/');\n  return slash === -1 ? path : path.slice(0, slash);\n}\n\nexport function resolveMongoBinding(options: MongoBindingInput): MongoBinding {\n  const providedCount =\n    Number(options.binding !== undefined) +\n    Number(options.url !== undefined) +\n    Number(options.uri !== undefined) +\n    Number(options.mongoClient !== undefined);\n\n  if (providedCount !== 1) {\n    throw new Error('Provide one binding input: binding, url, uri+dbName, or mongoClient+dbName');\n  }\n\n  if (options.binding !== undefined) {\n    return options.binding;\n  }\n\n  if (options.url !== undefined) {\n    const parsed = validateMongoUrl(options.url);\n    // An explicit, whitespace-only `dbName` is a user-error we'd rather\n    // surface loudly: silently falling back to the URL path would mask\n    // a typo or empty-template-string bug. Treat it the same as the\n    // `{ uri, dbName }` and `{ mongoClient, dbName }` paths, where an\n    // empty trimmed dbName is already a fast failure.\n    if (options.dbName !== undefined && options.dbName.trim().length === 0) {\n      throw new Error('Mongo binding via { url, dbName } requires a non-empty dbName');\n    }\n    const explicitDbName = options.dbName?.trim();\n    const dbName =\n      explicitDbName !== undefined && explicitDbName.length > 0\n        ? explicitDbName\n        : extractDbNameFromUrl(parsed);\n    if (dbName === undefined || dbName.length === 0) {\n      throw new Error(\n        'Mongo URL must include a database name in its path (e.g. mongodb://host:27017/mydb), or pass dbName explicitly',\n      );\n    }\n    return { kind: 'url', url: options.url.trim(), dbName };\n  }\n\n  if (options.uri !== undefined) {\n    validateMongoUrl(options.uri);\n    const dbName = options.dbName?.trim();\n    if (dbName === undefined || dbName.length === 0) {\n      throw new Error('Mongo binding via { uri, dbName } requires a non-empty dbName');\n    }\n    return { kind: 'url', url: options.uri.trim(), dbName };\n  }\n\n  const mongoClient = options.mongoClient;\n  if (mongoClient === undefined) {\n    throw new Error('Invariant violation: expected mongo binding after validation');\n  }\n  const dbName = options.dbName?.trim();\n  if (dbName === undefined || dbName.length === 0) {\n    throw new Error('Mongo binding via { mongoClient, dbName } requires a non-empty dbName');\n  }\n  return { kind: 'mongoClient', client: mongoClient, dbName };\n}\n\nexport function resolveOptionalMongoBinding(options: MongoBindingFields): MongoBinding | undefined {\n  const providedCount =\n    Number(options.binding !== undefined) +\n    Number(options.url !== undefined) +\n    Number(options.uri !== undefined) +\n    Number(options.mongoClient !== undefined);\n\n  if (providedCount === 0) {\n    return undefined;\n  }\n  // Defer the \"exactly one\" enforcement to `resolveMongoBinding`. We call it\n  // through a single branch per input field so the matching union member of\n  // `MongoBindingInput` is constructed explicitly — the previous\n  // `options as MongoBindingInput` cast hid drift between `MongoBindingFields`\n  // (any combination of optional inputs) and `MongoBindingInput` (exactly one).\n  if (providedCount !== 1) {\n    throw new Error('Provide one binding input: binding, url, uri+dbName, or mongoClient+dbName');\n  }\n  if (options.binding !== undefined) {\n    return resolveMongoBinding({ binding: options.binding });\n  }\n  if (options.url !== undefined) {\n    return resolveMongoBinding(\n      options.dbName !== undefined\n        ? { url: options.url, dbName: options.dbName }\n        : { url: options.url },\n    );\n  }\n  if (options.uri !== undefined) {\n    return resolveMongoBinding({ uri: options.uri, dbName: options.dbName ?? '' });\n  }\n  if (options.mongoClient !== undefined) {\n    return resolveMongoBinding({\n      mongoClient: options.mongoClient,\n      dbName: options.dbName ?? '',\n    });\n  }\n  // Unreachable: the `providedCount === 1` guard above plus the four\n  // branch checks cover every shape of `MongoBindingFields`. A bare\n  // `return undefined` here would silently mask a future\n  // `MongoBindingFields` extension that adds a fifth input, so we\n  // surface it as an invariant rather than a missing binding.\n  throw new Error('Invariant violation: expected one mongo binding branch');\n}\n","import mongoRuntimeAdapter from '@prisma-next/adapter-mongo/runtime';\nimport { MongoDriverImpl } from '@prisma-next/driver-mongo';\nimport { MongoContractSerializer } from '@prisma-next/family-mongo/ir';\nimport { AsyncIterableResult } from '@prisma-next/framework-components/runtime';\nimport type {\n  MongoContract,\n  MongoContractWithTypeMaps,\n  MongoTypeMaps,\n} from '@prisma-next/mongo-contract';\nimport type { MongoOrmClient, MongoQueryPlan } from '@prisma-next/mongo-orm';\nimport { mongoOrm } from '@prisma-next/mongo-orm';\nimport { mongoQuery } from '@prisma-next/mongo-query-builder';\nimport type { MongoMiddleware, MongoRuntime } from '@prisma-next/mongo-runtime';\nimport {\n  createMongoExecutionContext,\n  createMongoExecutionStack,\n  createMongoRuntime,\n} from '@prisma-next/mongo-runtime';\nimport mongoRuntimeTarget from '@prisma-next/target-mongo/runtime';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport {\n  type MongoBinding,\n  type MongoBindingInput,\n  resolveMongoBinding,\n  resolveOptionalMongoBinding,\n} from './binding';\n\nexport type MongoTargetId = 'mongo';\n\nexport interface MongoClient<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> {\n  readonly orm: MongoOrmClient<TContract>;\n  readonly query: ReturnType<typeof mongoQuery<TContract>>;\n  readonly contract: TContract;\n  connect(bindingInput?: MongoBindingInput): Promise<MongoRuntime>;\n  runtime(): Promise<MongoRuntime>;\n  close(): Promise<void>;\n}\n\nexport interface MongoOptionsBase {\n  readonly mode?: 'strict' | 'permissive';\n  /**\n   * Optional middleware chain applied to every Mongo execution.\n   */\n  readonly middleware?: readonly MongoMiddleware[];\n}\n\nexport interface MongoBindingOptions {\n  readonly binding?: MongoBinding;\n  readonly url?: string;\n  readonly uri?: string;\n  readonly dbName?: string;\n  readonly mongoClient?: import('mongodb').MongoClient;\n}\n\nexport type MongoOptionsWithContract<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> = MongoBindingOptions &\n  MongoOptionsBase & {\n    readonly contract: TContract;\n    readonly contractJson?: never;\n  };\n\n/**\n * `TContract` is a phantom parameter that drives explicit-type inference at the\n * call site (e.g. `mongo<Contract>({ contractJson })`). It is not referenced in\n * the type body — the contract value comes through `contractJson` at runtime.\n */\nexport type MongoOptionsWithContractJson<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> = MongoBindingOptions &\n  MongoOptionsBase & {\n    readonly contractJson: unknown;\n    readonly contract?: never;\n    /**\n     * @internal phantom field; never set at runtime, only references TContract\n     * so that strict tsc/biome don't flag the type parameter as unused.\n     */\n    readonly __contractPhantom?: TContract;\n  };\n\nexport type MongoOptions<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> = MongoOptionsWithContract<TContract> | MongoOptionsWithContractJson<TContract>;\n\nfunction hasContractJson<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(\n  options: MongoOptions<TContract>,\n): options is MongoOptionsWithContractJson<TContract> {\n  return 'contractJson' in options;\n}\n\nfunction resolveContract<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(\n  options: MongoOptions<TContract>,\n): TContract {\n  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;\n  return new MongoContractSerializer().deserializeContract(contractInput) as TContract;\n}\n\n/**\n * Creates a lazy Mongo client from either `contractJson` or a TypeScript-authored `contract`.\n * The `orm` and `query` surfaces are available immediately; the underlying driver is connected\n * on the first query (or the first explicit `connect()` call), mirroring the Postgres facade.\n *\n * - No-emit: pass a TypeScript-authored contract. Example: `mongo({ contract, url })`\n * - Emitted: pass `Contract` type explicitly. Example: `mongo<Contract>({ contractJson, url })`\n */\nexport default function mongo<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n>(options: MongoOptionsWithContract<TContract>): MongoClient<TContract>;\nexport default function mongo<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n>(options: MongoOptionsWithContractJson<TContract>): MongoClient<TContract>;\nexport default function mongo<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n>(options: MongoOptions<TContract>): MongoClient<TContract> {\n  const contract = resolveContract(options);\n  let binding = resolveOptionalMongoBinding(options);\n\n  // `mongoQuery` calls its parameter `contractJson`, but accepts the validated\n  // contract value here (it normalises both internally).\n  const query = mongoQuery<TContract>({ contractJson: contract });\n\n  // Single source of truth for the lifecycle. `runtimePromise` is the in-flight\n  // or settled build; `closed` is the terminal state set by `close()`. A failed\n  // build resets `runtimePromise` so a retry is possible (see test).\n  let runtimePromise: Promise<MongoRuntime> | undefined;\n  let closed = false;\n\n  const buildRuntime = async (resolvedBinding: MongoBinding): Promise<MongoRuntime> => {\n    const stack = createMongoExecutionStack({\n      target: mongoRuntimeTarget,\n      adapter: mongoRuntimeAdapter,\n    });\n    const context = createMongoExecutionContext({ contract, stack });\n    const driver =\n      resolvedBinding.kind === 'url'\n        ? await MongoDriverImpl.fromConnection(resolvedBinding.url, resolvedBinding.dbName)\n        : MongoDriverImpl.fromDb(resolvedBinding.client.db(resolvedBinding.dbName));\n    return createMongoRuntime({\n      context,\n      driver,\n      ...(options.mode !== undefined ? { mode: options.mode } : {}),\n      ...ifDefined('middleware', options.middleware),\n    });\n  };\n\n  const getRuntime = (): Promise<MongoRuntime> => {\n    if (closed) {\n      return Promise.reject(new Error('Mongo client is closed'));\n    }\n    if (runtimePromise !== undefined) {\n      return runtimePromise;\n    }\n    if (binding === undefined) {\n      return Promise.reject(\n        new Error(\n          'Mongo binding not configured. Pass url/uri+dbName/mongoClient+dbName/binding to mongo(...) or call db.connect({ ... }).',\n        ),\n      );\n    }\n    runtimePromise = buildRuntime(binding).catch((err) => {\n      // Reset so a later connect()/runtime() can retry rather than always\n      // re-throwing the cached failure.\n      runtimePromise = undefined;\n      throw err;\n    });\n    return runtimePromise;\n  };\n\n  const orm = mongoOrm<TContract>({\n    contract,\n    executor: {\n      execute<Row>(plan: MongoQueryPlan<Row>) {\n        async function* iterate(): AsyncGenerator<Row, void, unknown> {\n          const runtime = await getRuntime();\n          yield* runtime.execute(plan);\n        }\n        return new AsyncIterableResult(iterate());\n      },\n    },\n  });\n\n  return {\n    orm,\n    query,\n    contract,\n\n    async connect(bindingInput?: MongoBindingInput): Promise<MongoRuntime> {\n      if (closed) {\n        throw new Error('Mongo client is closed');\n      }\n      if (runtimePromise !== undefined) {\n        throw new Error('Mongo client already connected');\n      }\n      if (bindingInput !== undefined) {\n        binding = resolveMongoBinding(bindingInput);\n      }\n      if (binding === undefined) {\n        throw new Error(\n          'Mongo binding not configured. Pass url/uri+dbName/mongoClient+dbName/binding to mongo(...) or call db.connect({ ... }).',\n        );\n      }\n      return getRuntime();\n    },\n\n    runtime(): Promise<MongoRuntime> {\n      return getRuntime();\n    },\n\n    async close(): Promise<void> {\n      if (closed) return;\n      closed = true;\n      if (runtimePromise === undefined) return;\n      // Await whatever the build resolved to. Swallow build failures because\n      // the user's intent is \"release any resources we acquired\" — there is\n      // nothing to close if the build never produced a runtime.\n      try {\n        const runtime = await runtimePromise;\n        await runtime.close();\n      } catch {\n        // build failed; nothing to close.\n      }\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"runtime.mjs","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/mongo.ts"],"sourcesContent":["import type { MongoClient as MongoDriverClient } from 'mongodb';\n\nexport type MongoBinding =\n  | { readonly kind: 'url'; readonly url: string; readonly dbName: string }\n  | {\n      readonly kind: 'mongoClient';\n      readonly client: MongoDriverClient;\n      readonly dbName: string;\n    };\n\nexport type MongoBindingInput =\n  | {\n      readonly binding: MongoBinding;\n      readonly url?: never;\n      readonly uri?: never;\n      readonly dbName?: never;\n      readonly mongoClient?: never;\n    }\n  | {\n      readonly url: string;\n      readonly dbName?: string;\n      readonly binding?: never;\n      readonly uri?: never;\n      readonly mongoClient?: never;\n    }\n  | {\n      readonly uri: string;\n      readonly dbName: string;\n      readonly binding?: never;\n      readonly url?: never;\n      readonly mongoClient?: never;\n    }\n  | {\n      readonly mongoClient: MongoDriverClient;\n      readonly dbName: string;\n      readonly binding?: never;\n      readonly url?: never;\n      readonly uri?: never;\n    };\n\ntype MongoBindingFields = {\n  readonly binding?: MongoBinding;\n  readonly url?: string;\n  readonly uri?: string;\n  readonly dbName?: string;\n  readonly mongoClient?: MongoDriverClient;\n};\n\nfunction validateMongoUrl(url: string): URL {\n  const trimmed = url.trim();\n  if (trimmed.length === 0) {\n    throw new Error('Mongo URL must be a non-empty string');\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(trimmed);\n  } catch {\n    throw new Error('Mongo URL must be a valid URL');\n  }\n\n  if (parsed.protocol !== 'mongodb:' && parsed.protocol !== 'mongodb+srv:') {\n    throw new Error('Mongo URL must use mongodb:// or mongodb+srv://');\n  }\n\n  return parsed;\n}\n\nfunction extractDbNameFromUrl(parsed: URL): string | undefined {\n  // pathname is \"/dbname\" or \"\" — strip the leading slash. Anything past\n  // a second slash is invalid for our purposes (auth-source style paths).\n  const path = parsed.pathname.startsWith('/') ? parsed.pathname.slice(1) : parsed.pathname;\n  if (path.length === 0) {\n    return undefined;\n  }\n  const slash = path.indexOf('/');\n  return slash === -1 ? path : path.slice(0, slash);\n}\n\nexport function resolveMongoBinding(options: MongoBindingInput): MongoBinding {\n  const providedCount =\n    Number(options.binding !== undefined) +\n    Number(options.url !== undefined) +\n    Number(options.uri !== undefined) +\n    Number(options.mongoClient !== undefined);\n\n  if (providedCount !== 1) {\n    throw new Error('Provide one binding input: binding, url, uri+dbName, or mongoClient+dbName');\n  }\n\n  if (options.binding !== undefined) {\n    return options.binding;\n  }\n\n  if (options.url !== undefined) {\n    const parsed = validateMongoUrl(options.url);\n    // An explicit, whitespace-only `dbName` is a user-error we'd rather\n    // surface loudly: silently falling back to the URL path would mask\n    // a typo or empty-template-string bug. Treat it the same as the\n    // `{ uri, dbName }` and `{ mongoClient, dbName }` paths, where an\n    // empty trimmed dbName is already a fast failure.\n    if (options.dbName !== undefined && options.dbName.trim().length === 0) {\n      throw new Error('Mongo binding via { url, dbName } requires a non-empty dbName');\n    }\n    const explicitDbName = options.dbName?.trim();\n    const dbName =\n      explicitDbName !== undefined && explicitDbName.length > 0\n        ? explicitDbName\n        : extractDbNameFromUrl(parsed);\n    if (dbName === undefined || dbName.length === 0) {\n      throw new Error(\n        'Mongo URL must include a database name in its path (e.g. mongodb://host:27017/mydb), or pass dbName explicitly',\n      );\n    }\n    return { kind: 'url', url: options.url.trim(), dbName };\n  }\n\n  if (options.uri !== undefined) {\n    validateMongoUrl(options.uri);\n    const dbName = options.dbName?.trim();\n    if (dbName === undefined || dbName.length === 0) {\n      throw new Error('Mongo binding via { uri, dbName } requires a non-empty dbName');\n    }\n    return { kind: 'url', url: options.uri.trim(), dbName };\n  }\n\n  const mongoClient = options.mongoClient;\n  if (mongoClient === undefined) {\n    throw new Error('Invariant violation: expected mongo binding after validation');\n  }\n  const dbName = options.dbName?.trim();\n  if (dbName === undefined || dbName.length === 0) {\n    throw new Error('Mongo binding via { mongoClient, dbName } requires a non-empty dbName');\n  }\n  return { kind: 'mongoClient', client: mongoClient, dbName };\n}\n\nexport function resolveOptionalMongoBinding(options: MongoBindingFields): MongoBinding | undefined {\n  const providedCount =\n    Number(options.binding !== undefined) +\n    Number(options.url !== undefined) +\n    Number(options.uri !== undefined) +\n    Number(options.mongoClient !== undefined);\n\n  if (providedCount === 0) {\n    return undefined;\n  }\n  // Defer the \"exactly one\" enforcement to `resolveMongoBinding`. We call it\n  // through a single branch per input field so the matching union member of\n  // `MongoBindingInput` is constructed explicitly — the previous\n  // `options as MongoBindingInput` cast hid drift between `MongoBindingFields`\n  // (any combination of optional inputs) and `MongoBindingInput` (exactly one).\n  if (providedCount !== 1) {\n    throw new Error('Provide one binding input: binding, url, uri+dbName, or mongoClient+dbName');\n  }\n  if (options.binding !== undefined) {\n    return resolveMongoBinding({ binding: options.binding });\n  }\n  if (options.url !== undefined) {\n    return resolveMongoBinding(\n      options.dbName !== undefined\n        ? { url: options.url, dbName: options.dbName }\n        : { url: options.url },\n    );\n  }\n  if (options.uri !== undefined) {\n    return resolveMongoBinding({ uri: options.uri, dbName: options.dbName ?? '' });\n  }\n  if (options.mongoClient !== undefined) {\n    return resolveMongoBinding({\n      mongoClient: options.mongoClient,\n      dbName: options.dbName ?? '',\n    });\n  }\n  // Unreachable: the `providedCount === 1` guard above plus the four\n  // branch checks cover every shape of `MongoBindingFields`. A bare\n  // `return undefined` here would silently mask a future\n  // `MongoBindingFields` extension that adds a fifth input, so we\n  // surface it as an invariant rather than a missing binding.\n  throw new Error('Invariant violation: expected one mongo binding branch');\n}\n","import mongoRuntimeAdapter from '@prisma-next/adapter-mongo/runtime';\nimport { MongoDriverImpl } from '@prisma-next/driver-mongo';\nimport { MongoContractSerializer } from '@prisma-next/family-mongo/ir';\nimport { AsyncIterableResult } from '@prisma-next/framework-components/runtime';\nimport type {\n  MongoContract,\n  MongoContractWithTypeMaps,\n  MongoTypeMaps,\n} from '@prisma-next/mongo-contract';\nimport type { MongoOrmClient, MongoQueryPlan } from '@prisma-next/mongo-orm';\nimport { mongoOrm } from '@prisma-next/mongo-orm';\nimport { mongoQuery } from '@prisma-next/mongo-query-builder';\nimport type { MongoMiddleware, MongoRuntime } from '@prisma-next/mongo-runtime';\nimport {\n  createMongoExecutionContext,\n  createMongoExecutionStack,\n  createMongoRuntime,\n} from '@prisma-next/mongo-runtime';\nimport mongoRuntimeTarget from '@prisma-next/target-mongo/runtime';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport {\n  type MongoBinding,\n  type MongoBindingInput,\n  resolveMongoBinding,\n  resolveOptionalMongoBinding,\n} from './binding';\n\nexport type MongoTargetId = 'mongo';\n\nexport interface MongoClient<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> {\n  readonly orm: MongoOrmClient<TContract>;\n  readonly query: ReturnType<typeof mongoQuery<TContract>>;\n  readonly contract: TContract;\n  connect(bindingInput?: MongoBindingInput): Promise<MongoRuntime>;\n  runtime(): Promise<MongoRuntime>;\n  close(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nexport interface MongoOptionsBase {\n  readonly mode?: 'strict' | 'permissive';\n  /**\n   * Optional middleware chain applied to every Mongo execution.\n   */\n  readonly middleware?: readonly MongoMiddleware[];\n}\n\nexport interface MongoBindingOptions {\n  readonly binding?: MongoBinding;\n  readonly url?: string;\n  readonly uri?: string;\n  readonly dbName?: string;\n  readonly mongoClient?: import('mongodb').MongoClient;\n}\n\nexport type MongoOptionsWithContract<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> = MongoBindingOptions &\n  MongoOptionsBase & {\n    readonly contract: TContract;\n    readonly contractJson?: never;\n  };\n\n/**\n * `TContract` is a phantom parameter that drives explicit-type inference at the\n * call site (e.g. `mongo<Contract>({ contractJson })`). It is not referenced in\n * the type body — the contract value comes through `contractJson` at runtime.\n */\nexport type MongoOptionsWithContractJson<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> = MongoBindingOptions &\n  MongoOptionsBase & {\n    readonly contractJson: unknown;\n    readonly contract?: never;\n    /**\n     * @internal phantom field; never set at runtime, only references TContract\n     * so that strict tsc/biome don't flag the type parameter as unused.\n     */\n    readonly __contractPhantom?: TContract;\n  };\n\nexport type MongoOptions<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> = MongoOptionsWithContract<TContract> | MongoOptionsWithContractJson<TContract>;\n\nfunction hasContractJson<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(\n  options: MongoOptions<TContract>,\n): options is MongoOptionsWithContractJson<TContract> {\n  return 'contractJson' in options;\n}\n\nfunction resolveContract<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(\n  options: MongoOptions<TContract>,\n): TContract {\n  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;\n  return new MongoContractSerializer().deserializeContract(contractInput) as TContract;\n}\n\n/**\n * Creates a lazy Mongo client from either `contractJson` or a TypeScript-authored `contract`.\n * The `orm` and `query` surfaces are available immediately; the underlying driver is connected\n * on the first query (or the first explicit `connect()` call), mirroring the Postgres facade.\n *\n * - No-emit: pass a TypeScript-authored contract. Example: `mongo({ contract, url })`\n * - Emitted: pass `Contract` type explicitly. Example: `mongo<Contract>({ contractJson, url })`\n */\nexport default function mongo<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n>(options: MongoOptionsWithContract<TContract>): MongoClient<TContract>;\nexport default function mongo<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n>(options: MongoOptionsWithContractJson<TContract>): MongoClient<TContract>;\nexport default function mongo<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n>(options: MongoOptions<TContract>): MongoClient<TContract> {\n  const contract = resolveContract(options);\n  let binding = resolveOptionalMongoBinding(options);\n\n  // `mongoQuery` calls its parameter `contractJson`, but accepts the validated\n  // contract value here (it normalises both internally).\n  const query = mongoQuery<TContract>({ contractJson: contract });\n\n  // Single source of truth for the lifecycle. `runtimePromise` is the in-flight\n  // or settled build; `closed` is the terminal state set by `close()`. A failed\n  // build resets `runtimePromise` so a retry is possible (see test).\n  let runtimePromise: Promise<MongoRuntime> | undefined;\n  let closed = false;\n  let ownedDispose: (() => Promise<void>) | undefined;\n\n  const buildRuntime = async (resolvedBinding: MongoBinding): Promise<MongoRuntime> => {\n    const stack = createMongoExecutionStack({\n      target: mongoRuntimeTarget,\n      adapter: mongoRuntimeAdapter,\n    });\n    const context = createMongoExecutionContext({ contract, stack });\n    const driver =\n      resolvedBinding.kind === 'url'\n        ? await MongoDriverImpl.fromConnection(resolvedBinding.url, resolvedBinding.dbName)\n        : MongoDriverImpl.fromDb(resolvedBinding.client.db(resolvedBinding.dbName));\n    if (resolvedBinding.kind === 'url') {\n      ownedDispose = () => driver.close();\n    }\n    return createMongoRuntime({\n      context,\n      driver,\n      ...(options.mode !== undefined ? { mode: options.mode } : {}),\n      ...ifDefined('middleware', options.middleware),\n    });\n  };\n\n  const getRuntime = (): Promise<MongoRuntime> => {\n    if (closed) {\n      return Promise.reject(new Error('Mongo client is closed'));\n    }\n    if (runtimePromise !== undefined) {\n      return runtimePromise;\n    }\n    if (binding === undefined) {\n      return Promise.reject(\n        new Error(\n          'Mongo binding not configured. Pass url/uri+dbName/mongoClient+dbName/binding to mongo(...) or call db.connect({ ... }).',\n        ),\n      );\n    }\n    runtimePromise = buildRuntime(binding).catch((err) => {\n      // Reset so a later connect()/runtime() can retry rather than always\n      // re-throwing the cached failure.\n      runtimePromise = undefined;\n      throw err;\n    });\n    return runtimePromise;\n  };\n\n  const orm = mongoOrm<TContract>({\n    contract,\n    executor: {\n      execute<Row>(plan: MongoQueryPlan<Row>) {\n        async function* iterate(): AsyncGenerator<Row, void, unknown> {\n          const runtime = await getRuntime();\n          yield* runtime.execute(plan);\n        }\n        return new AsyncIterableResult(iterate());\n      },\n    },\n  });\n\n  return {\n    orm,\n    query,\n    contract,\n\n    async connect(bindingInput?: MongoBindingInput): Promise<MongoRuntime> {\n      if (closed) {\n        throw new Error('Mongo client is closed');\n      }\n      if (runtimePromise !== undefined) {\n        throw new Error('Mongo client already connected');\n      }\n      if (bindingInput !== undefined) {\n        binding = resolveMongoBinding(bindingInput);\n      }\n      if (binding === undefined) {\n        throw new Error(\n          'Mongo binding not configured. Pass url/uri+dbName/mongoClient+dbName/binding to mongo(...) or call db.connect({ ... }).',\n        );\n      }\n      return getRuntime();\n    },\n\n    runtime(): Promise<MongoRuntime> {\n      return getRuntime();\n    },\n\n    async close(): Promise<void> {\n      if (closed) return;\n      closed = true;\n      if (runtimePromise === undefined) return;\n      // Await whatever the build resolved to. Swallow build failures because\n      // the user's intent is \"release any resources we acquired\" — there is\n      // nothing to close if the build never produced a runtime.\n      try {\n        await runtimePromise;\n      } catch {\n        // build failed; still attempt disposing any already-acquired owned driver.\n      }\n      const dispose = ownedDispose;\n      ownedDispose = undefined;\n      await dispose?.();\n    },\n\n    [Symbol.asyncDispose](): Promise<void> {\n      return this.close();\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,32 +1,33 @@
 {
   "name": "@prisma-next/mongo",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "One-package Mongo setup for Prisma Next",
   "dependencies": {
-    "@prisma-next/adapter-mongo": "0.10.0",
-    "@prisma-next/config": "0.10.0",
-    "@prisma-next/contract": "0.10.0",
-    "@prisma-next/driver-mongo": "0.10.0",
-    "@prisma-next/family-mongo": "0.10.0",
-    "@prisma-next/framework-components": "0.10.0",
-    "@prisma-next/mongo-contract": "0.10.0",
-    "@prisma-next/mongo-contract-psl": "0.10.0",
-    "@prisma-next/mongo-contract-ts": "0.10.0",
-    "@prisma-next/mongo-orm": "0.10.0",
-    "@prisma-next/mongo-query-builder": "0.10.0",
-    "@prisma-next/mongo-runtime": "0.10.0",
-    "@prisma-next/target-mongo": "0.10.0",
-    "@prisma-next/utils": "0.10.0",
+    "@prisma-next/adapter-mongo": "0.11.0",
+    "@prisma-next/cli": "0.11.0",
+    "@prisma-next/config": "0.11.0",
+    "@prisma-next/contract": "0.11.0",
+    "@prisma-next/driver-mongo": "0.11.0",
+    "@prisma-next/family-mongo": "0.11.0",
+    "@prisma-next/framework-components": "0.11.0",
+    "@prisma-next/mongo-contract": "0.11.0",
+    "@prisma-next/mongo-contract-psl": "0.11.0",
+    "@prisma-next/mongo-contract-ts": "0.11.0",
+    "@prisma-next/mongo-orm": "0.11.0",
+    "@prisma-next/mongo-query-builder": "0.11.0",
+    "@prisma-next/mongo-runtime": "0.11.0",
+    "@prisma-next/target-mongo": "0.11.0",
+    "@prisma-next/utils": "0.11.0",
     "mongodb": "^6.16.0",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@prisma-next/test-utils": "0.10.0",
-    "@prisma-next/tsconfig": "0.10.0",
-    "@prisma-next/tsdown": "0.10.0",
+    "@prisma-next/test-utils": "0.11.0",
+    "@prisma-next/tsconfig": "0.11.0",
+    "@prisma-next/tsdown": "0.11.0",
     "mongodb-memory-server": "11.1.0",
     "tsdown": "0.22.0",
     "typescript": "5.9.3",
@@ -45,9 +46,10 @@
     "node": ">=20"
   },
   "exports": {
-    ".": "./dist/index.mjs",
+    "./bson": "./dist/bson.mjs",
     "./config": "./dist/config.mjs",
     "./contract-builder": "./dist/contract-builder.mjs",
+    "./control": "./dist/control.mjs",
     "./family": "./dist/family.mjs",
     "./runtime": "./dist/runtime.mjs",
     "./target": "./dist/target.mjs",

package/src/config/define-config.ts

@@ -3,9 +3,11 @@ import type { PrismaNextConfig } from '@prisma-next/config/config-types';
 import { defineConfig as coreDefineConfig } from '@prisma-next/config/config-types';
 import mongoDriver from '@prisma-next/driver-mongo/control';
 import { mongoFamilyDescriptor } from '@prisma-next/family-mongo/control';
+import type { ControlExtensionDescriptor } from '@prisma-next/framework-components/control';
 import { mongoContract } from '@prisma-next/mongo-contract-psl/provider';
 import { typescriptContractFromPath } from '@prisma-next/mongo-contract-ts/config-types';
 import { mongoTargetDescriptor } from '@prisma-next/target-mongo/control';
+import { ifDefined } from '@prisma-next/utils/defined';
 import { extname } from 'pathe';
 
 export interface MongoConfigOptions {
@@ -13,6 +15,10 @@ export interface MongoConfigOptions {
   readonly db?: {
     readonly connection?: string;
   };
+  readonly extensions?: readonly ControlExtensionDescriptor<'mongo', 'mongo'>[];
+  readonly migrations?: {
+    readonly dir?: string;
+  };
 }
 
 function deriveOutputPath(contractPath: string): string {
@@ -24,6 +30,7 @@ function deriveOutputPath(contractPath: string): string {
 }
 
 export function defineConfig(options: MongoConfigOptions): PrismaNextConfig<'mongo', 'mongo'> {
+  const extensions = options.extensions ?? [];
   const output = deriveOutputPath(options.contract);
   const ext = extname(options.contract);
 
@@ -37,7 +44,9 @@ export function defineConfig(options: MongoConfigOptions): PrismaNextConfig<'mon
     target: mongoTargetDescriptor,
     adapter: mongoAdapter,
     driver: mongoDriver,
+    extensionPacks: extensions,
     contract: contractConfig,
-    ...(options.db !== undefined ? { db: options.db } : {}),
+    ...ifDefined('db', options.db),
+    ...ifDefined('migrations', options.migrations),
   });
 }

package/src/contract/define-contract.ts

@@ -0,0 +1,99 @@
+import mongoFamilyPack from '@prisma-next/family-mongo/pack';
+import type {
+  ContractDefinition,
+  ContractFactory,
+  ContractScaffold,
+  MongoContractResult,
+} from '@prisma-next/mongo-contract-ts/contract-builder';
+import { defineContract as baseDefineContract } from '@prisma-next/mongo-contract-ts/contract-builder';
+import mongoTargetPack from '@prisma-next/target-mongo/pack';
+
+type MongoFamilyPack = typeof mongoFamilyPack;
+type MongoTargetPack = typeof mongoTargetPack;
+
+// Helpers type derived from the exported ContractFactory rather than the
+// un-exported ContractAuthoringHelpers, so we stay inside the public surface.
+type MongoHelpers = Parameters<
+  ContractFactory<
+    Record<never, never>,
+    Record<never, never>,
+    undefined,
+    MongoFamilyPack,
+    MongoTargetPack,
+    undefined
+  >
+>[0];
+
+// Input types omit family + target AND explicitly forbid them so that
+// `@ts-expect-error` tests can verify the fields are rejected.
+type MongoDefinitionInput = Omit<
+  ContractDefinition<MongoFamilyPack, MongoTargetPack>,
+  'family' | 'target'
+> & {
+  readonly family?: never;
+  readonly target?: never;
+};
+
+type MongoScaffoldInput = Omit<
+  ContractScaffold<MongoFamilyPack, MongoTargetPack>,
+  'family' | 'target'
+> & {
+  readonly family?: never;
+  readonly target?: never;
+};
+
+// Overload 1: definition form — models / valueObjects inline in the definition object.
+export function defineContract<const Definition extends MongoDefinitionInput>(
+  definition: Definition,
+): MongoContractResult<
+  Definition & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }
+>;
+
+// Overload 2: factory form — models / valueObjects provided by a factory function.
+export function defineContract<
+  const Definition extends MongoScaffoldInput,
+  const Built extends {
+    readonly models?: Record<string, unknown>;
+    readonly valueObjects?: Record<string, unknown>;
+    readonly roots?: Record<string, string>;
+  },
+>(
+  scaffold: Definition,
+  factory: (helpers: MongoHelpers) => Built,
+): MongoContractResult<
+  Definition & Built & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }
+>;
+
+// Implementation — pre-binds family and target before delegating to the base.
+// The `as unknown` cast is safe: every declared overload produces a MongoContractResult
+// and the only difference between the public overload signatures and the impl is
+// that we union both call forms here.
+export function defineContract(
+  definition: MongoDefinitionInput,
+  factory?: (helpers: MongoHelpers) => {
+    readonly models?: Record<string, unknown>;
+    readonly valueObjects?: Record<string, unknown>;
+    readonly roots?: Record<string, string>;
+  },
+): MongoContractResult<
+  MongoDefinitionInput & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }
+> {
+  const full = {
+    ...definition,
+    family: mongoFamilyPack,
+    target: mongoTargetPack,
+  } as ContractDefinition<MongoFamilyPack, MongoTargetPack>;
+
+  if (factory !== undefined) {
+    return baseDefineContract(
+      full as ContractScaffold<MongoFamilyPack, MongoTargetPack>,
+      factory as unknown as Parameters<typeof baseDefineContract>[1],
+    ) as unknown as MongoContractResult<
+      MongoDefinitionInput & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }
+    >;
+  }
+
+  return baseDefineContract(full) as unknown as MongoContractResult<
+    MongoDefinitionInput & { readonly family: MongoFamilyPack; readonly target: MongoTargetPack }
+  >;
+}

package/src/exports/bson.ts

@@ -0,0 +1 @@
+export { Binary, Decimal128, Long, MongoClient, ObjectId, Timestamp } from 'mongodb';

package/src/exports/contract-builder.ts

@@ -10,10 +10,10 @@ export type {
   ValueObjectBuilder,
 } from '@prisma-next/mongo-contract-ts/contract-builder';
 export {
-  defineContract,
   field,
   index,
   model,
   rel,
   valueObject,
 } from '@prisma-next/mongo-contract-ts/contract-builder';
+export { defineContract } from '../contract/define-contract';

package/src/exports/control.ts

@@ -0,0 +1,29 @@
+import mongoAdapter from '@prisma-next/adapter-mongo/control';
+import {
+  type ControlClient,
+  type ControlClientOptions,
+  createControlClient,
+} from '@prisma-next/cli/control-api';
+import mongoDriver from '@prisma-next/driver-mongo/control';
+import { mongoFamilyDescriptor } from '@prisma-next/family-mongo/control';
+import { mongoTargetDescriptor } from '@prisma-next/target-mongo/control';
+import { ifDefined } from '@prisma-next/utils/defined';
+
+export interface MongoControlClientOptions {
+  readonly connection?: string;
+  readonly extensionPacks?: ControlClientOptions['extensionPacks'];
+}
+
+export function createMongoControlClient(options: MongoControlClientOptions = {}): ControlClient {
+  const clientOptions: ControlClientOptions = {
+    family: mongoFamilyDescriptor,
+    target: mongoTargetDescriptor,
+    adapter: mongoAdapter,
+    driver: mongoDriver,
+    ...ifDefined('connection', options.connection),
+    ...ifDefined('extensionPacks', options.extensionPacks),
+  };
+  return createControlClient(clientOptions);
+}
+
+export type { ControlClient };

package/src/runtime/mongo.ts

@@ -36,6 +36,7 @@ export interface MongoClient<
   connect(bindingInput?: MongoBindingInput): Promise<MongoRuntime>;
   runtime(): Promise<MongoRuntime>;
   close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
 }
 
 export interface MongoOptionsBase {
@@ -126,6 +127,7 @@ export default function mongo<
   // build resets `runtimePromise` so a retry is possible (see test).
   let runtimePromise: Promise<MongoRuntime> | undefined;
   let closed = false;
+  let ownedDispose: (() => Promise<void>) | undefined;
 
   const buildRuntime = async (resolvedBinding: MongoBinding): Promise<MongoRuntime> => {
     const stack = createMongoExecutionStack({
@@ -137,6 +139,9 @@ export default function mongo<
       resolvedBinding.kind === 'url'
         ? await MongoDriverImpl.fromConnection(resolvedBinding.url, resolvedBinding.dbName)
         : MongoDriverImpl.fromDb(resolvedBinding.client.db(resolvedBinding.dbName));
+    if (resolvedBinding.kind === 'url') {
+      ownedDispose = () => driver.close();
+    }
     return createMongoRuntime({
       context,
       driver,
@@ -216,11 +221,17 @@ export default function mongo<
       // the user's intent is "release any resources we acquired" — there is
       // nothing to close if the build never produced a runtime.
       try {
-        const runtime = await runtimePromise;
-        await runtime.close();
+        await runtimePromise;
       } catch {
-        // build failed; nothing to close.
+        // build failed; still attempt disposing any already-acquired owned driver.
       }
+      const dispose = ownedDispose;
+      ownedDispose = undefined;
+      await dispose?.();
+    },
+
+    [Symbol.asyncDispose](): Promise<void> {
+      return this.close();
     },
   };
 }

package/src/exports/index.ts

@@ -1,11 +0,0 @@
-/**
- * Top-level entry for `@prisma-next/mongo`.
- *
- * Re-exports the BSON value constructors users reach for when authoring
- * seed scripts, fixtures, or relational graphs that need to pre-allocate
- * `_id`s before insert (e.g. wiring related rows in a single `createAll`
- * call). Routing these through the facade keeps the user's `package.json`
- * to a single `@prisma-next/mongo` pin and removes the version-drift risk
- * of also declaring `mongodb` directly when the facade already bundles it.
- */
-export { Binary, Decimal128, Long, MongoClient, ObjectId, Timestamp } from 'mongodb';