@prisma-next/mongo 0.0.1

package/README.md

@@ -0,0 +1,44 @@
+# @prisma-next/mongo
+
+One-package MongoDB setup for Prisma Next. Install this single package to get config, runtime, and all transitive type dependencies.
+
+## Package Classification
+
+- **Domain**: extensions
+- **Layer**: adapters
+- **Planes**: shared (config), runtime (runtime)
+
+## Quick Start
+
+```typescript
+// prisma-next.config.ts
+import { defineConfig } from '@prisma-next/mongo/config';
+
+export default defineConfig({
+  contract: './prisma/contract.prisma',
+  db: { connection: process.env['MONGODB_URL']! },
+});
+```
+
+## 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.
+
+### `@prisma-next/mongo/runtime`
+
+Re-exports `createMongoRuntime` from `@prisma-next/mongo-runtime` for composing the MongoDB execution pipeline.
+
+## Dependencies
+
+This package bundles all the transitive dependencies needed for a MongoDB Prisma Next project, including those referenced in the emitted `contract.d.ts`:
+
+- `@prisma-next/mongo-contract` (contract type definitions)
+- `@prisma-next/adapter-mongo` (adapter + codec types)
+- `@prisma-next/contract` (shared contract types)
+
+## Related Docs
+
+- Architecture: `docs/Architecture Overview.md`
+- Subsystem: `docs/architecture docs/subsystems/5. Adapters & Targets.md`

package/dist/config.d.mts

@@ -0,0 +1,13 @@
+import { PrismaNextConfig } from "@prisma-next/config/config-types";
+
+//#region src/config/define-config.d.ts
+interface MongoConfigOptions {
+  readonly contract: string;
+  readonly db?: {
+    readonly connection?: string;
+  };
+}
+declare function defineConfig(options: MongoConfigOptions): PrismaNextConfig<'mongo', 'mongo'>;
+//#endregion
+export { type MongoConfigOptions, defineConfig };
+//# sourceMappingURL=config.d.mts.map

package/dist/config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config/define-config.ts"],"sourcesContent":[],"mappings":";;;UASiB,kBAAA;;EAAA,SAAA,EAAA,CAAA,EAAA;IAeD,SAAA,UAAY,CAAA,EAAU,MAAA;;;iBAAtB,YAAA,UAAsB,qBAAqB"}

package/dist/config.mjs

@@ -0,0 +1,38 @@
+import { pathToFileURL } from "node:url";
+import mongoAdapter from "@prisma-next/adapter-mongo/control";
+import { defineConfig as defineConfig$1 } from "@prisma-next/config/config-types";
+import mongoDriver from "@prisma-next/driver-mongo/control";
+import { mongoFamilyDescriptor, mongoTargetDescriptor } from "@prisma-next/family-mongo/control";
+import { mongoContract } from "@prisma-next/mongo-contract-psl/provider";
+import { extname, isAbsolute, resolve } from "pathe";
+
+//#region src/config/define-config.ts
+function deriveOutputPath(contractPath) {
+	const ext = extname(contractPath);
+	if (ext.length === 0) return `${contractPath}.json`;
+	return `${contractPath.slice(0, -ext.length)}.json`;
+}
+function defineConfig(options) {
+	const output = deriveOutputPath(options.contract);
+	const ext = extname(options.contract);
+	const absoluteContractPath = isAbsolute(options.contract) ? options.contract : resolve(process.cwd(), options.contract);
+	return defineConfig$1({
+		family: mongoFamilyDescriptor,
+		target: mongoTargetDescriptor,
+		adapter: mongoAdapter,
+		driver: mongoDriver,
+		contract: ext === ".ts" ? {
+			source: async () => {
+				const { typescriptContract } = await import("@prisma-next/mongo-contract-ts/config-types");
+				const mod = await import(pathToFileURL(absoluteContractPath).href);
+				return typescriptContract(mod.default ?? mod.contract, output).source({ composedExtensionPacks: [] });
+			},
+			output
+		} : mongoContract(options.contract, { output }),
+		...options.db !== void 0 ? { db: options.db } : {}
+	});
+}
+
+//#endregion
+export { defineConfig };
+//# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":["coreDefineConfig"],"sources":["../src/config/define-config.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\nimport 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, mongoTargetDescriptor } from '@prisma-next/family-mongo/control';\nimport { mongoContract } from '@prisma-next/mongo-contract-psl/provider';\nimport { extname, isAbsolute, resolve } 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 absoluteContractPath = isAbsolute(options.contract)\n    ? options.contract\n    : resolve(process.cwd(), options.contract);\n\n  const contractConfig =\n    ext === '.ts'\n      ? {\n          source: async () => {\n            const { typescriptContract } = await import(\n              '@prisma-next/mongo-contract-ts/config-types'\n            );\n            const mod = await import(pathToFileURL(absoluteContractPath).href);\n            const contract = mod.default ?? mod.contract;\n            return typescriptContract(contract, output).source({\n              composedExtensionPacks: [],\n            });\n          },\n          output,\n        }\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":";;;;;;;;;AAgBA,SAAS,iBAAiB,cAA8B;CACtD,MAAM,MAAM,QAAQ,aAAa;AACjC,KAAI,IAAI,WAAW,EACjB,QAAO,GAAG,aAAa;AAEzB,QAAO,GAAG,aAAa,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC;;AAG/C,SAAgB,aAAa,SAAiE;CAC5F,MAAM,SAAS,iBAAiB,QAAQ,SAAS;CACjD,MAAM,MAAM,QAAQ,QAAQ,SAAS;CAErC,MAAM,uBAAuB,WAAW,QAAQ,SAAS,GACrD,QAAQ,WACR,QAAQ,QAAQ,KAAK,EAAE,QAAQ,SAAS;AAmB5C,QAAOA,eAAiB;EACtB,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,UArBA,QAAQ,QACJ;GACE,QAAQ,YAAY;IAClB,MAAM,EAAE,uBAAuB,MAAM,OACnC;IAEF,MAAM,MAAM,MAAM,OAAO,cAAc,qBAAqB,CAAC;AAE7D,WAAO,mBADU,IAAI,WAAW,IAAI,UACA,OAAO,CAAC,OAAO,EACjD,wBAAwB,EAAE,EAC3B,CAAC;;GAEJ;GACD,GACD,cAAc,QAAQ,UAAU,EAAE,QAAQ,CAAC;EAQ/C,GAAI,QAAQ,OAAO,SAAY,EAAE,IAAI,QAAQ,IAAI,GAAG,EAAE;EACvD,CAAC"}

package/dist/runtime.d.mts

@@ -0,0 +1,24 @@
+import { MongoContract, MongoContractWithTypeMaps, MongoTypeMaps } from "@prisma-next/mongo-contract";
+import { mongoOrm } from "@prisma-next/mongo-orm";
+import { mongoPipeline } from "@prisma-next/mongo-pipeline-builder";
+import { MongoRuntime } from "@prisma-next/mongo-runtime";
+
+//#region src/runtime/mongo.d.ts
+interface MongoOptions {
+  readonly contractJson: unknown;
+}
+interface MongoClient<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>> {
+  readonly pipeline: ReturnType<typeof mongoPipeline<TContract>>;
+  connect(uri: string, dbName: string): Promise<ConnectedMongoClient<TContract>>;
+}
+interface ConnectedMongoClient<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>> {
+  readonly orm: ReturnType<typeof mongoOrm<TContract>>;
+  readonly runtime: MongoRuntime;
+  readonly pipeline: ReturnType<typeof mongoPipeline<TContract>>;
+  readonly contract: TContract;
+  close(): Promise<void>;
+}
+declare function mongo<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(options: MongoOptions): MongoClient<TContract>;
+//#endregion
+export { type ConnectedMongoClient, type MongoClient, type MongoOptions, mongo as default };
+//# sourceMappingURL=runtime.d.mts.map

package/dist/runtime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime/mongo.ts"],"sourcesContent":[],"mappings":";;;;;;UAaiB,YAAA;;AAAjB;AAIiB,UAAA,WAAW,CAAA,kBACR,yBADQ,CACkB,aADlB,EACiC,aADjC,CAAA,CAAA,CAAA;EACkB,SAAA,QAAA,EAEzB,UAFyB,CAAA,OAEP,aAFO,CAEO,SAFP,CAAA,CAAA;EAAe,OAAA,CAAA,GAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAGrB,OAHqB,CAGb,oBAHa,CAGQ,SAHR,CAAA,CAAA;;AAER,UAIpC,oBAJoC,CAAA,kBAKjC,yBALiC,CAKP,aALO,EAKQ,aALR,CAAA,CAAA,CAAA;EAAd,SAAA,GAAA,EAOvB,UAPuB,CAAA,OAOL,QAPK,CAOI,SAPJ,CAAA,CAAA;EAAlB,SAAA,OAAA,EAQD,YARC;EACgD,SAAA,QAAA,EAQhD,UARgD,CAAA,OAQ9B,aAR8B,CAQhB,SARgB,CAAA,CAAA;EAArB,SAAA,QAAA,EAS3B,SAT2B;EAAR,KAAA,EAAA,EAU7B,OAV6B,CAAA,IAAA,CAAA;;AAGvB,iBAUO,KAVa,CAAA,kBAWjB,yBAXiB,CAWS,aAXT,EAWwB,aAXxB,CAAA,CAAA,CAAA,OAAA,EAY1B,YAZ0B,CAAA,EAYX,WAZW,CAYC,SAZD,CAAA"}

package/dist/runtime.mjs

@@ -0,0 +1,39 @@
+import { createMongoAdapter } from "@prisma-next/adapter-mongo";
+import { createMongoDriver } from "@prisma-next/driver-mongo";
+import { validateMongoContract } from "@prisma-next/mongo-contract";
+import { mongoOrm } from "@prisma-next/mongo-orm";
+import { mongoPipeline } from "@prisma-next/mongo-pipeline-builder";
+import { createMongoRuntime } from "@prisma-next/mongo-runtime";
+
+//#region src/runtime/mongo.ts
+function mongo(options) {
+	const { contract } = validateMongoContract(options.contractJson);
+	const pipeline = mongoPipeline({ contractJson: options.contractJson });
+	return {
+		pipeline,
+		async connect(uri, dbName) {
+			const runtime = createMongoRuntime({
+				adapter: createMongoAdapter(),
+				driver: await createMongoDriver(uri, dbName),
+				contract,
+				targetId: "mongo"
+			});
+			return {
+				orm: mongoOrm({
+					contract,
+					executor: runtime
+				}),
+				runtime,
+				pipeline,
+				contract,
+				async close() {
+					await runtime.close();
+				}
+			};
+		}
+	};
+}
+
+//#endregion
+export { mongo as default };
+//# sourceMappingURL=runtime.mjs.map

package/dist/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":[],"sources":["../src/runtime/mongo.ts"],"sourcesContent":["import { createMongoAdapter } from '@prisma-next/adapter-mongo';\nimport { createMongoDriver } from '@prisma-next/driver-mongo';\nimport type {\n  MongoContract,\n  MongoContractWithTypeMaps,\n  MongoTypeMaps,\n} from '@prisma-next/mongo-contract';\nimport { validateMongoContract } from '@prisma-next/mongo-contract';\nimport { mongoOrm } from '@prisma-next/mongo-orm';\nimport { mongoPipeline } from '@prisma-next/mongo-pipeline-builder';\nimport type { MongoRuntime } from '@prisma-next/mongo-runtime';\nimport { createMongoRuntime } from '@prisma-next/mongo-runtime';\n\nexport interface MongoOptions {\n  readonly contractJson: unknown;\n}\n\nexport interface MongoClient<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> {\n  readonly pipeline: ReturnType<typeof mongoPipeline<TContract>>;\n  connect(uri: string, dbName: string): Promise<ConnectedMongoClient<TContract>>;\n}\n\nexport interface ConnectedMongoClient<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n> {\n  readonly orm: ReturnType<typeof mongoOrm<TContract>>;\n  readonly runtime: MongoRuntime;\n  readonly pipeline: ReturnType<typeof mongoPipeline<TContract>>;\n  readonly contract: TContract;\n  close(): Promise<void>;\n}\n\nexport default function mongo<\n  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,\n>(options: MongoOptions): MongoClient<TContract> {\n  const { contract } = validateMongoContract<TContract>(options.contractJson);\n  const pipeline = mongoPipeline<TContract>({ contractJson: options.contractJson });\n\n  return {\n    pipeline,\n    async connect(uri: string, dbName: string): Promise<ConnectedMongoClient<TContract>> {\n      const adapter = createMongoAdapter();\n      const driver = await createMongoDriver(uri, dbName);\n      const runtime = createMongoRuntime({ adapter, driver, contract, targetId: 'mongo' });\n      const orm = mongoOrm<TContract>({ contract, executor: runtime });\n\n      return {\n        orm,\n        runtime,\n        pipeline,\n        contract,\n        async close() {\n          await runtime.close();\n        },\n      };\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAkCA,SAAwB,MAEtB,SAA+C;CAC/C,MAAM,EAAE,aAAa,sBAAiC,QAAQ,aAAa;CAC3E,MAAM,WAAW,cAAyB,EAAE,cAAc,QAAQ,cAAc,CAAC;AAEjF,QAAO;EACL;EACA,MAAM,QAAQ,KAAa,QAA0D;GAGnF,MAAM,UAAU,mBAAmB;IAAE,SAFrB,oBAAoB;IAEU,QAD/B,MAAM,kBAAkB,KAAK,OAAO;IACG;IAAU,UAAU;IAAS,CAAC;AAGpF,UAAO;IACL,KAHU,SAAoB;KAAE;KAAU,UAAU;KAAS,CAAC;IAI9D;IACA;IACA;IACA,MAAM,QAAQ;AACZ,WAAM,QAAQ,OAAO;;IAExB;;EAEJ"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@prisma-next/mongo",
+  "version": "0.0.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "One-package Mongo setup for Prisma Next",
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "lint": "biome check . --error-on-warnings",
+    "lint:fix": "biome check --write .",
+    "lint:fix:unsafe": "biome check --write --unsafe .",
+    "clean": "rm -rf dist dist-tsc dist-tsc-prod coverage .tmp-output"
+  },
+  "dependencies": {
+    "@prisma-next/adapter-mongo": "workspace:*",
+    "@prisma-next/config": "workspace:*",
+    "@prisma-next/contract": "workspace:*",
+    "@prisma-next/driver-mongo": "workspace:*",
+    "@prisma-next/family-mongo": "workspace:*",
+    "@prisma-next/framework-components": "workspace:*",
+    "@prisma-next/mongo-contract": "workspace:*",
+    "@prisma-next/mongo-contract-psl": "workspace:*",
+    "@prisma-next/mongo-contract-ts": "workspace:*",
+    "@prisma-next/mongo-orm": "workspace:*",
+    "@prisma-next/mongo-pipeline-builder": "workspace:*",
+    "@prisma-next/mongo-runtime": "workspace:*",
+    "@prisma-next/target-mongo": "workspace:*",
+    "pathe": "^2.0.3"
+  },
+  "devDependencies": {
+    "@prisma-next/test-utils": "workspace:*",
+    "@prisma-next/tsconfig": "workspace:*",
+    "@prisma-next/tsdown": "workspace:*",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prisma/prisma-next.git",
+    "directory": "packages/3-extensions/mongo"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    "./config": "./dist/config.mjs",
+    "./runtime": "./dist/runtime.mjs",
+    "./package.json": "./package.json"
+  }
+}

package/src/config/define-config.ts

@@ -0,0 +1,58 @@
+import { pathToFileURL } from 'node:url';
+import mongoAdapter from '@prisma-next/adapter-mongo/control';
+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, mongoTargetDescriptor } from '@prisma-next/family-mongo/control';
+import { mongoContract } from '@prisma-next/mongo-contract-psl/provider';
+import { extname, isAbsolute, resolve } from 'pathe';
+
+export interface MongoConfigOptions {
+  readonly contract: string;
+  readonly db?: {
+    readonly connection?: string;
+  };
+}
+
+function deriveOutputPath(contractPath: string): string {
+  const ext = extname(contractPath);
+  if (ext.length === 0) {
+    return `${contractPath}.json`;
+  }
+  return `${contractPath.slice(0, -ext.length)}.json`;
+}
+
+export function defineConfig(options: MongoConfigOptions): PrismaNextConfig<'mongo', 'mongo'> {
+  const output = deriveOutputPath(options.contract);
+  const ext = extname(options.contract);
+
+  const absoluteContractPath = isAbsolute(options.contract)
+    ? options.contract
+    : resolve(process.cwd(), options.contract);
+
+  const contractConfig =
+    ext === '.ts'
+      ? {
+          source: async () => {
+            const { typescriptContract } = await import(
+              '@prisma-next/mongo-contract-ts/config-types'
+            );
+            const mod = await import(pathToFileURL(absoluteContractPath).href);
+            const contract = mod.default ?? mod.contract;
+            return typescriptContract(contract, output).source({
+              composedExtensionPacks: [],
+            });
+          },
+          output,
+        }
+      : mongoContract(options.contract, { output });
+
+  return coreDefineConfig({
+    family: mongoFamilyDescriptor,
+    target: mongoTargetDescriptor,
+    adapter: mongoAdapter,
+    driver: mongoDriver,
+    contract: contractConfig,
+    ...(options.db !== undefined ? { db: options.db } : {}),
+  });
+}

package/src/exports/config.ts

@@ -0,0 +1,2 @@
+export type { MongoConfigOptions } from '../config/define-config';
+export { defineConfig } from '../config/define-config';

package/src/exports/runtime.ts

@@ -0,0 +1,2 @@
+export type { ConnectedMongoClient, MongoClient, MongoOptions } from '../runtime/mongo';
+export { default } from '../runtime/mongo';

package/src/runtime/mongo.ts

@@ -0,0 +1,60 @@
+import { createMongoAdapter } from '@prisma-next/adapter-mongo';
+import { createMongoDriver } from '@prisma-next/driver-mongo';
+import type {
+  MongoContract,
+  MongoContractWithTypeMaps,
+  MongoTypeMaps,
+} from '@prisma-next/mongo-contract';
+import { validateMongoContract } from '@prisma-next/mongo-contract';
+import { mongoOrm } from '@prisma-next/mongo-orm';
+import { mongoPipeline } from '@prisma-next/mongo-pipeline-builder';
+import type { MongoRuntime } from '@prisma-next/mongo-runtime';
+import { createMongoRuntime } from '@prisma-next/mongo-runtime';
+
+export interface MongoOptions {
+  readonly contractJson: unknown;
+}
+
+export interface MongoClient<
+  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
+> {
+  readonly pipeline: ReturnType<typeof mongoPipeline<TContract>>;
+  connect(uri: string, dbName: string): Promise<ConnectedMongoClient<TContract>>;
+}
+
+export interface ConnectedMongoClient<
+  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
+> {
+  readonly orm: ReturnType<typeof mongoOrm<TContract>>;
+  readonly runtime: MongoRuntime;
+  readonly pipeline: ReturnType<typeof mongoPipeline<TContract>>;
+  readonly contract: TContract;
+  close(): Promise<void>;
+}
+
+export default function mongo<
+  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
+>(options: MongoOptions): MongoClient<TContract> {
+  const { contract } = validateMongoContract<TContract>(options.contractJson);
+  const pipeline = mongoPipeline<TContract>({ contractJson: options.contractJson });
+
+  return {
+    pipeline,
+    async connect(uri: string, dbName: string): Promise<ConnectedMongoClient<TContract>> {
+      const adapter = createMongoAdapter();
+      const driver = await createMongoDriver(uri, dbName);
+      const runtime = createMongoRuntime({ adapter, driver, contract, targetId: 'mongo' });
+      const orm = mongoOrm<TContract>({ contract, executor: runtime });
+
+      return {
+        orm,
+        runtime,
+        pipeline,
+        contract,
+        async close() {
+          await runtime.close();
+        },
+      };
+    },
+  };
+}