@prisma-next/mongo 0.10.0-dev.25 → 0.10.0-dev.27

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.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();

package/package.json

@@ -1,32 +1,33 @@
 {
   "name": "@prisma-next/mongo",
-  "version": "0.10.0-dev.25",
+  "version": "0.10.0-dev.27",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "One-package Mongo setup for Prisma Next",
   "dependencies": {
-    "@prisma-next/adapter-mongo": "0.10.0-dev.25",
-    "@prisma-next/config": "0.10.0-dev.25",
-    "@prisma-next/contract": "0.10.0-dev.25",
-    "@prisma-next/driver-mongo": "0.10.0-dev.25",
-    "@prisma-next/family-mongo": "0.10.0-dev.25",
-    "@prisma-next/framework-components": "0.10.0-dev.25",
-    "@prisma-next/mongo-contract": "0.10.0-dev.25",
-    "@prisma-next/mongo-contract-psl": "0.10.0-dev.25",
-    "@prisma-next/mongo-contract-ts": "0.10.0-dev.25",
-    "@prisma-next/mongo-orm": "0.10.0-dev.25",
-    "@prisma-next/mongo-query-builder": "0.10.0-dev.25",
-    "@prisma-next/mongo-runtime": "0.10.0-dev.25",
-    "@prisma-next/target-mongo": "0.10.0-dev.25",
-    "@prisma-next/utils": "0.10.0-dev.25",
+    "@prisma-next/adapter-mongo": "0.10.0-dev.27",
+    "@prisma-next/cli": "0.10.0-dev.27",
+    "@prisma-next/config": "0.10.0-dev.27",
+    "@prisma-next/contract": "0.10.0-dev.27",
+    "@prisma-next/driver-mongo": "0.10.0-dev.27",
+    "@prisma-next/family-mongo": "0.10.0-dev.27",
+    "@prisma-next/framework-components": "0.10.0-dev.27",
+    "@prisma-next/mongo-contract": "0.10.0-dev.27",
+    "@prisma-next/mongo-contract-psl": "0.10.0-dev.27",
+    "@prisma-next/mongo-contract-ts": "0.10.0-dev.27",
+    "@prisma-next/mongo-orm": "0.10.0-dev.27",
+    "@prisma-next/mongo-query-builder": "0.10.0-dev.27",
+    "@prisma-next/mongo-runtime": "0.10.0-dev.27",
+    "@prisma-next/target-mongo": "0.10.0-dev.27",
+    "@prisma-next/utils": "0.10.0-dev.27",
     "mongodb": "^6.16.0",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@prisma-next/test-utils": "0.10.0-dev.25",
-    "@prisma-next/tsconfig": "0.10.0-dev.25",
-    "@prisma-next/tsdown": "0.10.0-dev.25",
+    "@prisma-next/test-utils": "0.10.0-dev.27",
+    "@prisma-next/tsconfig": "0.10.0-dev.27",
+    "@prisma-next/tsdown": "0.10.0-dev.27",
     "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/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';