@prisma-next/mongo 0.5.0-dev.4 → 0.5.0-dev.6

package/dist/runtime.d.mts

@@ -1,24 +1,95 @@
 import { MongoContract, MongoContractWithTypeMaps, MongoTypeMaps } from "@prisma-next/mongo-contract";
-import { mongoOrm } from "@prisma-next/mongo-orm";
+import { MongoOrmClient } from "@prisma-next/mongo-orm";
 import { mongoQuery } from "@prisma-next/mongo-query-builder";
 import { MongoRuntime } from "@prisma-next/mongo-runtime";
+import * as mongodb0 from "mongodb";
+import { MongoClient as MongoClient$1 } from "mongodb";
 
+//#region src/runtime/binding.d.ts
+type MongoBinding = {
+  readonly kind: 'url';
+  readonly url: string;
+  readonly dbName: string;
+} | {
+  readonly kind: 'mongoClient';
+  readonly client: MongoClient$1;
+  readonly dbName: string;
+};
+type MongoBindingInput = {
+  readonly binding: MongoBinding;
+  readonly url?: never;
+  readonly uri?: never;
+  readonly dbName?: never;
+  readonly mongoClient?: never;
+} | {
+  readonly url: string;
+  readonly dbName?: string;
+  readonly binding?: never;
+  readonly uri?: never;
+  readonly mongoClient?: never;
+} | {
+  readonly uri: string;
+  readonly dbName: string;
+  readonly binding?: never;
+  readonly url?: never;
+  readonly mongoClient?: never;
+} | {
+  readonly mongoClient: MongoClient$1;
+  readonly dbName: string;
+  readonly binding?: never;
+  readonly url?: never;
+  readonly uri?: never;
+};
+//#endregion
 //#region src/runtime/mongo.d.ts
-interface MongoOptions {
-  readonly contractJson: unknown;
-}
+type MongoTargetId = 'mongo';
 interface MongoClient<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>> {
-  readonly query: ReturnType<typeof mongoQuery<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 orm: MongoOrmClient<TContract>;
   readonly query: ReturnType<typeof mongoQuery<TContract>>;
   readonly contract: TContract;
+  connect(bindingInput?: MongoBindingInput): Promise<MongoRuntime>;
+  runtime(): Promise<MongoRuntime>;
   close(): Promise<void>;
 }
-declare function mongo<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(options: MongoOptions): MongoClient<TContract>;
+interface MongoOptionsBase {
+  readonly mode?: 'strict' | 'permissive';
+}
+interface MongoBindingOptions {
+  readonly binding?: MongoBinding;
+  readonly url?: string;
+  readonly uri?: string;
+  readonly dbName?: string;
+  readonly mongoClient?: mongodb0.MongoClient;
+}
+type MongoOptionsWithContract<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>> = MongoBindingOptions & MongoOptionsBase & {
+  readonly contract: TContract;
+  readonly contractJson?: never;
+};
+/**
+ * `TContract` is a phantom parameter that drives explicit-type inference at the
+ * call site (e.g. `mongo<Contract>({ contractJson })`). It is not referenced in
+ * the type body — the contract value comes through `contractJson` at runtime.
+ */
+type MongoOptionsWithContractJson<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>> = MongoBindingOptions & MongoOptionsBase & {
+  readonly contractJson: unknown;
+  readonly contract?: never;
+  /**
+   * @internal phantom field; never set at runtime, only references TContract
+   * so that strict tsc/biome don't flag the type parameter as unused.
+   */
+  readonly __contractPhantom?: TContract;
+};
+type MongoOptions<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>> = MongoOptionsWithContract<TContract> | MongoOptionsWithContractJson<TContract>;
+/**
+ * Creates a lazy Mongo client from either `contractJson` or a TypeScript-authored `contract`.
+ * The `orm` and `query` surfaces are available immediately; the underlying driver is connected
+ * on the first query (or the first explicit `connect()` call), mirroring the Postgres facade.
+ *
+ * - No-emit: pass a TypeScript-authored contract. Example: `mongo({ contract, url })`
+ * - Emitted: pass `Contract` type explicitly. Example: `mongo<Contract>({ contractJson, url })`
+ */
+declare function mongo<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(options: MongoOptionsWithContract<TContract>): MongoClient<TContract>;
+declare function mongo<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(options: MongoOptionsWithContractJson<TContract>): MongoClient<TContract>;
 //#endregion
-export { type ConnectedMongoClient, type MongoClient, type MongoOptions, mongo as default };
+export { type MongoBinding, type MongoBindingInput, type MongoClient, type MongoOptions, type MongoOptionsWithContract, type MongoOptionsWithContractJson, type MongoTargetId, mongo as default };
 //# sourceMappingURL=runtime.d.mts.map

package/dist/runtime.d.mts.map

@@ -1 +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,KAAA,EAE5B,UAF4B,CAAA,OAEV,UAFU,CAEC,SAFD,CAAA,CAAA;EAAe,OAAA,CAAA,GAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAGrB,OAHqB,CAGb,oBAHa,CAGQ,SAHR,CAAA,CAAA;;AAEd,UAI9B,oBAJ8B,CAAA,kBAK3B,yBAL2B,CAKD,aALC,EAKc,aALd,CAAA,CAAA,CAAA;EAAX,SAAA,GAAA,EAOpB,UAPoB,CAAA,OAOF,QAPE,CAOO,SAPP,CAAA,CAAA;EAAlB,SAAA,OAAA,EAQE,YARF;EACmD,SAAA,KAAA,EAQnD,UARmD,CAAA,OAQjC,UARiC,CAQtB,SARsB,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"}
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/mongo.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAEY,YAAA;;;;;;mBAIW;EAJX,SAAA,MAAY,EAAA,MAAA;AAQxB,CAAA;KAAY,iBAAA;oBAEY;;ECSZ,SAAA,GAAA,CAAA,EAAA,KAAa;EAER,SAAA,MAAW,CAAA,EAAA,KAAA;EACkB,SAAA,WAAA,CAAA,EAAA,KAAA;CAAe,GAAA;EAAzC,SAAA,GAAA,EAAA,MAAA;EAEW,SAAA,MAAA,CAAA,EAAA,MAAA;EAAf,SAAA,OAAA,CAAA,EAAA,KAAA;EAC+B,SAAA,GAAA,CAAA,EAAA,KAAA;EAAX,SAAA,WAAA,CAAA,EAAA,KAAA;CAAlB,GAAA;EACG,SAAA,GAAA,EAAA,MAAA;EACI,SAAA,MAAA,EAAA,MAAA;EAA4B,SAAA,OAAA,CAAA,EAAA,KAAA;EAAR,SAAA,GAAA,CAAA,EAAA,KAAA;EACxB,SAAA,WAAA,CAAA,EAAA,KAAA;CAAR,GAAA;EACF,SAAA,WAAA,EDEiB,aCFjB;EAAO,SAAA,MAAA,EAAA,MAAA;EAGD,SAAA,OAAA,CAAA,EAAgB,KAAA;EAIhB,SAAA,GAAA,CAAA,EAAA,KAAA;EAQL,SAAA,GAAA,CAAA,EAAA,KAAA;CACkC;;;KA1BlC,aAAA;UAEK,8BACG,0BAA0B,eAAe;gBAE7C,eAAe;EDxBnB,SAAA,KAAA,ECyBM,UDzBM,CAID,OCqBa,UDrBI,CCqBO,SDrBP,CAAA,CAAA;EAI5B,SAAA,QAAA,ECkBS,SDlBQ;yBCmBJ,oBAAoB,QAAQ;aACxC,QAAQ;WACV;AAVX;AAEiB,UAWA,gBAAA,CAXW;EACkB,SAAA,IAAA,CAAA,EAAA,QAAA,GAAA,YAAA;;AAA1B,UAcH,mBAAA,CAdG;EAEW,SAAA,OAAA,CAAA,EAaV,YAbU;EAAf,SAAA,GAAA,CAAA,EAAA,MAAA;EAC+B,SAAA,GAAA,CAAA,EAAA,MAAA;EAAX,SAAA,MAAA,CAAA,EAAA,MAAA;EAAlB,SAAA,WAAA,CAAA,EAYe,QAAA,CAIU,WAhBzB;;AAEO,KAiBb,wBAjBa,CAAA,kBAkBL,yBAlBK,CAkBqB,aAlBrB,EAkBoC,aAlBpC,CAAA,CAAA,GAmBrB,mBAnBqB,GAoBvB,gBApBuB,GAAA;EAA4B,SAAA,QAAA,EAqB9B,SArB8B;EAAR,SAAA,YAAA,CAAA,EAAA,KAAA;CACxB;;;;AAIrB;AAIA;AAQY,KAaA,4BAbwB,CAAA,kBAchB,yBAdgB,CAcU,aAdV,EAcyB,aAdzB,CAAA,CAAA,GAehC,mBAfgC,GAgBlC,gBAhBkC,GAAA;EACU,SAAA,YAAA,EAAA,OAAA;EAAe,SAAA,QAAA,CAAA,EAAA,KAAA;EAAzC;;;;EAGY,SAAA,iBAAA,CAAA,EAmBC,SAnBD;AAShC,CAAA;AAC8C,KAYlC,YAZkC,CAAA,kBAa1B,yBAb0B,CAaA,aAbA,EAae,aAbf,CAAA,CAAA,GAc1C,wBAd0C,CAcjB,SAdiB,CAAA,GAcJ,4BAdI,CAcyB,SAdzB,CAAA;;;;;;;AAY9C;;AAC6D,iBAwBrC,KAxBqC,CAAA,kBAyBzC,yBAzByC,CAyBf,aAzBe,EAyBA,aAzBA,CAAA,CAAA,CAAA,OAAA,EA0BlD,wBA1BkD,CA0BzB,SA1ByB,CAAA,CAAA,EA0BZ,WA1BY,CA0BA,SA1BA,CAAA;AAAzC,iBA2BI,KA3BJ,CAAA,kBA4BA,yBA5BA,CA4B0B,aA5B1B,EA4ByC,aA5BzC,CAAA,CAAA,CAAA,OAAA,EA6BT,4BA7BS,CA6BoB,SA7BpB,CAAA,CAAA,EA6BiC,WA7BjC,CA6B6C,SA7B7C,CAAA"}

package/dist/runtime.mjs

@@ -1,35 +1,147 @@
 import { createMongoAdapter } from "@prisma-next/adapter-mongo";
-import { createMongoDriver } from "@prisma-next/driver-mongo";
+import { MongoDriverImpl } from "@prisma-next/driver-mongo";
+import { AsyncIterableResult } from "@prisma-next/framework-components/runtime";
 import { validateMongoContract } from "@prisma-next/mongo-contract";
 import { mongoOrm } from "@prisma-next/mongo-orm";
 import { mongoQuery } from "@prisma-next/mongo-query-builder";
 import { createMongoRuntime } from "@prisma-next/mongo-runtime";
 
+//#region src/runtime/binding.ts
+function validateMongoUrl(url) {
+	const trimmed = url.trim();
+	if (trimmed.length === 0) throw new Error("Mongo URL must be a non-empty string");
+	let parsed;
+	try {
+		parsed = new URL(trimmed);
+	} catch {
+		throw new Error("Mongo URL must be a valid URL");
+	}
+	if (parsed.protocol !== "mongodb:" && parsed.protocol !== "mongodb+srv:") throw new Error("Mongo URL must use mongodb:// or mongodb+srv://");
+	return parsed;
+}
+function extractDbNameFromUrl(parsed) {
+	const path = parsed.pathname.startsWith("/") ? parsed.pathname.slice(1) : parsed.pathname;
+	if (path.length === 0) return;
+	const slash = path.indexOf("/");
+	return slash === -1 ? path : path.slice(0, slash);
+}
+function resolveMongoBinding(options) {
+	if (Number(options.binding !== void 0) + Number(options.url !== void 0) + Number(options.uri !== void 0) + Number(options.mongoClient !== void 0) !== 1) throw new Error("Provide one binding input: binding, url, uri+dbName, or mongoClient+dbName");
+	if (options.binding !== void 0) return options.binding;
+	if (options.url !== void 0) {
+		const parsed = validateMongoUrl(options.url);
+		if (options.dbName !== void 0 && options.dbName.trim().length === 0) throw new Error("Mongo binding via { url, dbName } requires a non-empty dbName");
+		const explicitDbName = options.dbName?.trim();
+		const dbName$1 = explicitDbName !== void 0 && explicitDbName.length > 0 ? explicitDbName : extractDbNameFromUrl(parsed);
+		if (dbName$1 === void 0 || dbName$1.length === 0) throw new Error("Mongo URL must include a database name in its path (e.g. mongodb://host:27017/mydb), or pass dbName explicitly");
+		return {
+			kind: "url",
+			url: options.url.trim(),
+			dbName: dbName$1
+		};
+	}
+	if (options.uri !== void 0) {
+		validateMongoUrl(options.uri);
+		const dbName$1 = options.dbName?.trim();
+		if (dbName$1 === void 0 || dbName$1.length === 0) throw new Error("Mongo binding via { uri, dbName } requires a non-empty dbName");
+		return {
+			kind: "url",
+			url: options.uri.trim(),
+			dbName: dbName$1
+		};
+	}
+	const mongoClient = options.mongoClient;
+	if (mongoClient === void 0) throw new Error("Invariant violation: expected mongo binding after validation");
+	const dbName = options.dbName?.trim();
+	if (dbName === void 0 || dbName.length === 0) throw new Error("Mongo binding via { mongoClient, dbName } requires a non-empty dbName");
+	return {
+		kind: "mongoClient",
+		client: mongoClient,
+		dbName
+	};
+}
+function resolveOptionalMongoBinding(options) {
+	const providedCount = Number(options.binding !== void 0) + Number(options.url !== void 0) + Number(options.uri !== void 0) + Number(options.mongoClient !== void 0);
+	if (providedCount === 0) return;
+	if (providedCount !== 1) throw new Error("Provide one binding input: binding, url, uri+dbName, or mongoClient+dbName");
+	if (options.binding !== void 0) return resolveMongoBinding({ binding: options.binding });
+	if (options.url !== void 0) return resolveMongoBinding(options.dbName !== void 0 ? {
+		url: options.url,
+		dbName: options.dbName
+	} : { url: options.url });
+	if (options.uri !== void 0) return resolveMongoBinding({
+		uri: options.uri,
+		dbName: options.dbName ?? ""
+	});
+	if (options.mongoClient !== void 0) return resolveMongoBinding({
+		mongoClient: options.mongoClient,
+		dbName: options.dbName ?? ""
+	});
+	throw new Error("Invariant violation: expected one mongo binding branch");
+}
+
+//#endregion
 //#region src/runtime/mongo.ts
+function hasContractJson(options) {
+	return "contractJson" in options;
+}
+function resolveContract(options) {
+	return validateMongoContract(hasContractJson(options) ? options.contractJson : options.contract).contract;
+}
 function mongo(options) {
-	const { contract } = validateMongoContract(options.contractJson);
+	const contract = resolveContract(options);
+	let binding = resolveOptionalMongoBinding(options);
 	const query = mongoQuery({ contractJson: contract });
+	let runtimePromise;
+	let closed = false;
+	const buildRuntime = async (resolvedBinding) => {
+		return createMongoRuntime({
+			adapter: createMongoAdapter(),
+			driver: resolvedBinding.kind === "url" ? await MongoDriverImpl.fromConnection(resolvedBinding.url, resolvedBinding.dbName) : MongoDriverImpl.fromDb(resolvedBinding.client.db(resolvedBinding.dbName)),
+			contract,
+			targetId: "mongo",
+			...options.mode !== void 0 ? { mode: options.mode } : {}
+		});
+	};
+	const getRuntime = () => {
+		if (closed) return Promise.reject(/* @__PURE__ */ new Error("Mongo client is closed"));
+		if (runtimePromise !== void 0) return runtimePromise;
+		if (binding === void 0) return Promise.reject(/* @__PURE__ */ new Error("Mongo binding not configured. Pass url/uri+dbName/mongoClient+dbName/binding to mongo(...) or call db.connect({ ... })."));
+		runtimePromise = buildRuntime(binding).catch((err) => {
+			runtimePromise = void 0;
+			throw err;
+		});
+		return runtimePromise;
+	};
 	return {
-		query,
-		async connect(uri, dbName) {
-			const runtime = createMongoRuntime({
-				adapter: createMongoAdapter(),
-				driver: await createMongoDriver(uri, dbName),
-				contract,
-				targetId: "mongo"
-			});
-			return {
-				orm: mongoOrm({
-					contract,
-					executor: runtime
-				}),
-				runtime,
-				query,
-				contract,
-				async close() {
-					await runtime.close();
+		orm: mongoOrm({
+			contract,
+			executor: { execute(plan) {
+				async function* iterate() {
+					yield* (await getRuntime()).execute(plan);
 				}
-			};
+				return new AsyncIterableResult(iterate());
+			} }
+		}),
+		query,
+		contract,
+		async connect(bindingInput) {
+			if (closed) throw new Error("Mongo client is closed");
+			if (runtimePromise !== void 0) throw new Error("Mongo client already connected");
+			if (bindingInput !== void 0) binding = resolveMongoBinding(bindingInput);
+			if (binding === void 0) throw new Error("Mongo binding not configured. Pass url/uri+dbName/mongoClient+dbName/binding to mongo(...) or call db.connect({ ... }).");
+			return getRuntime();
+		},
+		runtime() {
+			return getRuntime();
+		},
+		async close() {
+			if (closed) return;
+			closed = true;
+			if (runtimePromise === void 0) return;
+			try {
+				await (await runtimePromise).close();
+			} catch {}
 		}
 	};
 }

package/dist/runtime.mjs.map

@@ -1 +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 { mongoQuery } from '@prisma-next/mongo-query-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 query: ReturnType<typeof mongoQuery<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 query: ReturnType<typeof mongoQuery<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 query = mongoQuery<TContract>({ contractJson: contract });\n\n  return {\n    query,\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        query,\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,QAAQ,WAAsB,EAAE,cAAc,UAAU,CAAC;AAE/D,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"}
+{"version":3,"file":"runtime.mjs","names":["parsed: URL","dbName","runtimePromise: Promise<MongoRuntime> | undefined"],"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 { createMongoAdapter } from '@prisma-next/adapter-mongo';\nimport { MongoDriverImpl } from '@prisma-next/driver-mongo';\nimport { AsyncIterableResult } from '@prisma-next/framework-components/runtime';\nimport type {\n  MongoContract,\n  MongoContractWithTypeMaps,\n  MongoTypeMaps,\n} from '@prisma-next/mongo-contract';\nimport { validateMongoContract } 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 { MongoRuntime } from '@prisma-next/mongo-runtime';\nimport { createMongoRuntime } from '@prisma-next/mongo-runtime';\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\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 validateMongoContract<TContract>(contractInput).contract;\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 adapter = createMongoAdapter();\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      adapter,\n      driver,\n      contract,\n      targetId: 'mongo',\n      ...(options.mode !== undefined ? { mode: options.mode } : {}),\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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"}

package/package.json

@@ -1,26 +1,28 @@
 {
   "name": "@prisma-next/mongo",
-  "version": "0.5.0-dev.4",
+  "version": "0.5.0-dev.6",
   "type": "module",
   "sideEffects": false,
   "description": "One-package Mongo setup for Prisma Next",
   "dependencies": {
+    "mongodb": "^6.16.0",
     "pathe": "^2.0.3",
-    "@prisma-next/adapter-mongo": "0.5.0-dev.4",
-    "@prisma-next/contract": "0.5.0-dev.4",
-    "@prisma-next/family-mongo": "0.5.0-dev.4",
-    "@prisma-next/framework-components": "0.5.0-dev.4",
-    "@prisma-next/driver-mongo": "0.5.0-dev.4",
-    "@prisma-next/mongo-contract-psl": "0.5.0-dev.4",
-    "@prisma-next/mongo-contract": "0.5.0-dev.4",
-    "@prisma-next/config": "0.5.0-dev.4",
-    "@prisma-next/mongo-contract-ts": "0.5.0-dev.4",
-    "@prisma-next/mongo-query-builder": "0.5.0-dev.4",
-    "@prisma-next/mongo-orm": "0.5.0-dev.4",
-    "@prisma-next/mongo-runtime": "0.5.0-dev.4",
-    "@prisma-next/target-mongo": "0.5.0-dev.4"
+    "@prisma-next/adapter-mongo": "0.5.0-dev.6",
+    "@prisma-next/family-mongo": "0.5.0-dev.6",
+    "@prisma-next/config": "0.5.0-dev.6",
+    "@prisma-next/contract": "0.5.0-dev.6",
+    "@prisma-next/driver-mongo": "0.5.0-dev.6",
+    "@prisma-next/mongo-contract": "0.5.0-dev.6",
+    "@prisma-next/framework-components": "0.5.0-dev.6",
+    "@prisma-next/mongo-query-builder": "0.5.0-dev.6",
+    "@prisma-next/mongo-orm": "0.5.0-dev.6",
+    "@prisma-next/mongo-runtime": "0.5.0-dev.6",
+    "@prisma-next/target-mongo": "0.5.0-dev.6",
+    "@prisma-next/mongo-contract-psl": "0.5.0-dev.6",
+    "@prisma-next/mongo-contract-ts": "0.5.0-dev.6"
   },
   "devDependencies": {
+    "mongodb-memory-server": "10.4.3",
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.17",

package/src/exports/runtime.ts

@@ -1,2 +1,9 @@
-export type { ConnectedMongoClient, MongoClient, MongoOptions } from '../runtime/mongo';
+export type { MongoBinding, MongoBindingInput } from '../runtime/binding';
+export type {
+  MongoClient,
+  MongoOptions,
+  MongoOptionsWithContract,
+  MongoOptionsWithContractJson,
+  MongoTargetId,
+} from '../runtime/mongo';
 export { default } from '../runtime/mongo';

package/src/runtime/binding.ts

@@ -0,0 +1,181 @@
+import type { MongoClient as MongoDriverClient } from 'mongodb';
+
+export type MongoBinding =
+  | { readonly kind: 'url'; readonly url: string; readonly dbName: string }
+  | {
+      readonly kind: 'mongoClient';
+      readonly client: MongoDriverClient;
+      readonly dbName: string;
+    };
+
+export type MongoBindingInput =
+  | {
+      readonly binding: MongoBinding;
+      readonly url?: never;
+      readonly uri?: never;
+      readonly dbName?: never;
+      readonly mongoClient?: never;
+    }
+  | {
+      readonly url: string;
+      readonly dbName?: string;
+      readonly binding?: never;
+      readonly uri?: never;
+      readonly mongoClient?: never;
+    }
+  | {
+      readonly uri: string;
+      readonly dbName: string;
+      readonly binding?: never;
+      readonly url?: never;
+      readonly mongoClient?: never;
+    }
+  | {
+      readonly mongoClient: MongoDriverClient;
+      readonly dbName: string;
+      readonly binding?: never;
+      readonly url?: never;
+      readonly uri?: never;
+    };
+
+type MongoBindingFields = {
+  readonly binding?: MongoBinding;
+  readonly url?: string;
+  readonly uri?: string;
+  readonly dbName?: string;
+  readonly mongoClient?: MongoDriverClient;
+};
+
+function validateMongoUrl(url: string): URL {
+  const trimmed = url.trim();
+  if (trimmed.length === 0) {
+    throw new Error('Mongo URL must be a non-empty string');
+  }
+
+  let parsed: URL;
+  try {
+    parsed = new URL(trimmed);
+  } catch {
+    throw new Error('Mongo URL must be a valid URL');
+  }
+
+  if (parsed.protocol !== 'mongodb:' && parsed.protocol !== 'mongodb+srv:') {
+    throw new Error('Mongo URL must use mongodb:// or mongodb+srv://');
+  }
+
+  return parsed;
+}
+
+function extractDbNameFromUrl(parsed: URL): string | undefined {
+  // pathname is "/dbname" or "" — strip the leading slash. Anything past
+  // a second slash is invalid for our purposes (auth-source style paths).
+  const path = parsed.pathname.startsWith('/') ? parsed.pathname.slice(1) : parsed.pathname;
+  if (path.length === 0) {
+    return undefined;
+  }
+  const slash = path.indexOf('/');
+  return slash === -1 ? path : path.slice(0, slash);
+}
+
+export function resolveMongoBinding(options: MongoBindingInput): MongoBinding {
+  const providedCount =
+    Number(options.binding !== undefined) +
+    Number(options.url !== undefined) +
+    Number(options.uri !== undefined) +
+    Number(options.mongoClient !== undefined);
+
+  if (providedCount !== 1) {
+    throw new Error('Provide one binding input: binding, url, uri+dbName, or mongoClient+dbName');
+  }
+
+  if (options.binding !== undefined) {
+    return options.binding;
+  }
+
+  if (options.url !== undefined) {
+    const parsed = validateMongoUrl(options.url);
+    // An explicit, whitespace-only `dbName` is a user-error we'd rather
+    // surface loudly: silently falling back to the URL path would mask
+    // a typo or empty-template-string bug. Treat it the same as the
+    // `{ uri, dbName }` and `{ mongoClient, dbName }` paths, where an
+    // empty trimmed dbName is already a fast failure.
+    if (options.dbName !== undefined && options.dbName.trim().length === 0) {
+      throw new Error('Mongo binding via { url, dbName } requires a non-empty dbName');
+    }
+    const explicitDbName = options.dbName?.trim();
+    const dbName =
+      explicitDbName !== undefined && explicitDbName.length > 0
+        ? explicitDbName
+        : extractDbNameFromUrl(parsed);
+    if (dbName === undefined || dbName.length === 0) {
+      throw new Error(
+        'Mongo URL must include a database name in its path (e.g. mongodb://host:27017/mydb), or pass dbName explicitly',
+      );
+    }
+    return { kind: 'url', url: options.url.trim(), dbName };
+  }
+
+  if (options.uri !== undefined) {
+    validateMongoUrl(options.uri);
+    const dbName = options.dbName?.trim();
+    if (dbName === undefined || dbName.length === 0) {
+      throw new Error('Mongo binding via { uri, dbName } requires a non-empty dbName');
+    }
+    return { kind: 'url', url: options.uri.trim(), dbName };
+  }
+
+  const mongoClient = options.mongoClient;
+  if (mongoClient === undefined) {
+    throw new Error('Invariant violation: expected mongo binding after validation');
+  }
+  const dbName = options.dbName?.trim();
+  if (dbName === undefined || dbName.length === 0) {
+    throw new Error('Mongo binding via { mongoClient, dbName } requires a non-empty dbName');
+  }
+  return { kind: 'mongoClient', client: mongoClient, dbName };
+}
+
+export function resolveOptionalMongoBinding(options: MongoBindingFields): MongoBinding | undefined {
+  const providedCount =
+    Number(options.binding !== undefined) +
+    Number(options.url !== undefined) +
+    Number(options.uri !== undefined) +
+    Number(options.mongoClient !== undefined);
+
+  if (providedCount === 0) {
+    return undefined;
+  }
+  // Defer the "exactly one" enforcement to `resolveMongoBinding`. We call it
+  // through a single branch per input field so the matching union member of
+  // `MongoBindingInput` is constructed explicitly — the previous
+  // `options as MongoBindingInput` cast hid drift between `MongoBindingFields`
+  // (any combination of optional inputs) and `MongoBindingInput` (exactly one).
+  if (providedCount !== 1) {
+    throw new Error('Provide one binding input: binding, url, uri+dbName, or mongoClient+dbName');
+  }
+  if (options.binding !== undefined) {
+    return resolveMongoBinding({ binding: options.binding });
+  }
+  if (options.url !== undefined) {
+    return resolveMongoBinding(
+      options.dbName !== undefined
+        ? { url: options.url, dbName: options.dbName }
+        : { url: options.url },
+    );
+  }
+  if (options.uri !== undefined) {
+    return resolveMongoBinding({ uri: options.uri, dbName: options.dbName ?? '' });
+  }
+  if (options.mongoClient !== undefined) {
+    return resolveMongoBinding({
+      mongoClient: options.mongoClient,
+      dbName: options.dbName ?? '',
+    });
+  }
+  // Unreachable: the `providedCount === 1` guard above plus the four
+  // branch checks cover every shape of `MongoBindingFields`. A bare
+  // `return undefined` here would silently mask a future
+  // `MongoBindingFields` extension that adds a fifth input, so we
+  // surface it as an invariant rather than a missing binding.
+  throw new Error('Invariant violation: expected one mongo binding branch');
+}

package/src/runtime/mongo.ts

@@ -1,60 +1,213 @@
 import { createMongoAdapter } from '@prisma-next/adapter-mongo';
-import { createMongoDriver } from '@prisma-next/driver-mongo';
+import { MongoDriverImpl } from '@prisma-next/driver-mongo';
+import { AsyncIterableResult } from '@prisma-next/framework-components/runtime';
 import type {
   MongoContract,
   MongoContractWithTypeMaps,
   MongoTypeMaps,
 } from '@prisma-next/mongo-contract';
 import { validateMongoContract } from '@prisma-next/mongo-contract';
+import type { MongoOrmClient, MongoQueryPlan } from '@prisma-next/mongo-orm';
 import { mongoOrm } from '@prisma-next/mongo-orm';
 import { mongoQuery } from '@prisma-next/mongo-query-builder';
 import type { MongoRuntime } from '@prisma-next/mongo-runtime';
 import { createMongoRuntime } from '@prisma-next/mongo-runtime';
+import {
+  type MongoBinding,
+  type MongoBindingInput,
+  resolveMongoBinding,
+  resolveOptionalMongoBinding,
+} from './binding';
 
-export interface MongoOptions {
-  readonly contractJson: unknown;
-}
+export type MongoTargetId = 'mongo';
 
 export interface MongoClient<
   TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
 > {
+  readonly orm: MongoOrmClient<TContract>;
   readonly query: ReturnType<typeof mongoQuery<TContract>>;
-  connect(uri: string, dbName: string): Promise<ConnectedMongoClient<TContract>>;
+  readonly contract: TContract;
+  connect(bindingInput?: MongoBindingInput): Promise<MongoRuntime>;
+  runtime(): Promise<MongoRuntime>;
+  close(): Promise<void>;
+}
+
+export interface MongoOptionsBase {
+  readonly mode?: 'strict' | 'permissive';
 }
 
-export interface ConnectedMongoClient<
+export interface MongoBindingOptions {
+  readonly binding?: MongoBinding;
+  readonly url?: string;
+  readonly uri?: string;
+  readonly dbName?: string;
+  readonly mongoClient?: import('mongodb').MongoClient;
+}
+
+export type MongoOptionsWithContract<
   TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
-> {
-  readonly orm: ReturnType<typeof mongoOrm<TContract>>;
-  readonly runtime: MongoRuntime;
-  readonly query: ReturnType<typeof mongoQuery<TContract>>;
-  readonly contract: TContract;
-  close(): Promise<void>;
+> = MongoBindingOptions &
+  MongoOptionsBase & {
+    readonly contract: TContract;
+    readonly contractJson?: never;
+  };
+
+/**
+ * `TContract` is a phantom parameter that drives explicit-type inference at the
+ * call site (e.g. `mongo<Contract>({ contractJson })`). It is not referenced in
+ * the type body — the contract value comes through `contractJson` at runtime.
+ */
+export type MongoOptionsWithContractJson<
+  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
+> = MongoBindingOptions &
+  MongoOptionsBase & {
+    readonly contractJson: unknown;
+    readonly contract?: never;
+    /**
+     * @internal phantom field; never set at runtime, only references TContract
+     * so that strict tsc/biome don't flag the type parameter as unused.
+     */
+    readonly __contractPhantom?: TContract;
+  };
+
+export type MongoOptions<
+  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
+> = MongoOptionsWithContract<TContract> | MongoOptionsWithContractJson<TContract>;
+
+function hasContractJson<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(
+  options: MongoOptions<TContract>,
+): options is MongoOptionsWithContractJson<TContract> {
+  return 'contractJson' in options;
 }
 
+function resolveContract<TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>>(
+  options: MongoOptions<TContract>,
+): TContract {
+  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;
+  return validateMongoContract<TContract>(contractInput).contract;
+}
+
+/**
+ * Creates a lazy Mongo client from either `contractJson` or a TypeScript-authored `contract`.
+ * The `orm` and `query` surfaces are available immediately; the underlying driver is connected
+ * on the first query (or the first explicit `connect()` call), mirroring the Postgres facade.
+ *
+ * - No-emit: pass a TypeScript-authored contract. Example: `mongo({ contract, url })`
+ * - Emitted: pass `Contract` type explicitly. Example: `mongo<Contract>({ contractJson, url })`
+ */
+export default function mongo<
+  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
+>(options: MongoOptionsWithContract<TContract>): MongoClient<TContract>;
+export default function mongo<
+  TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
+>(options: MongoOptionsWithContractJson<TContract>): MongoClient<TContract>;
 export default function mongo<
   TContract extends MongoContractWithTypeMaps<MongoContract, MongoTypeMaps>,
->(options: MongoOptions): MongoClient<TContract> {
-  const { contract } = validateMongoContract<TContract>(options.contractJson);
+>(options: MongoOptions<TContract>): MongoClient<TContract> {
+  const contract = resolveContract(options);
+  let binding = resolveOptionalMongoBinding(options);
+
+  // `mongoQuery` calls its parameter `contractJson`, but accepts the validated
+  // contract value here (it normalises both internally).
   const query = mongoQuery<TContract>({ contractJson: contract });
 
+  // Single source of truth for the lifecycle. `runtimePromise` is the in-flight
+  // or settled build; `closed` is the terminal state set by `close()`. A failed
+  // build resets `runtimePromise` so a retry is possible (see test).
+  let runtimePromise: Promise<MongoRuntime> | undefined;
+  let closed = false;
+
+  const buildRuntime = async (resolvedBinding: MongoBinding): Promise<MongoRuntime> => {
+    const adapter = createMongoAdapter();
+    const driver =
+      resolvedBinding.kind === 'url'
+        ? await MongoDriverImpl.fromConnection(resolvedBinding.url, resolvedBinding.dbName)
+        : MongoDriverImpl.fromDb(resolvedBinding.client.db(resolvedBinding.dbName));
+    return createMongoRuntime({
+      adapter,
+      driver,
+      contract,
+      targetId: 'mongo',
+      ...(options.mode !== undefined ? { mode: options.mode } : {}),
+    });
+  };
+
+  const getRuntime = (): Promise<MongoRuntime> => {
+    if (closed) {
+      return Promise.reject(new Error('Mongo client is closed'));
+    }
+    if (runtimePromise !== undefined) {
+      return runtimePromise;
+    }
+    if (binding === undefined) {
+      return Promise.reject(
+        new Error(
+          'Mongo binding not configured. Pass url/uri+dbName/mongoClient+dbName/binding to mongo(...) or call db.connect({ ... }).',
+        ),
+      );
+    }
+    runtimePromise = buildRuntime(binding).catch((err) => {
+      // Reset so a later connect()/runtime() can retry rather than always
+      // re-throwing the cached failure.
+      runtimePromise = undefined;
+      throw err;
+    });
+    return runtimePromise;
+  };
+
+  const orm = mongoOrm<TContract>({
+    contract,
+    executor: {
+      execute<Row>(plan: MongoQueryPlan<Row>) {
+        async function* iterate(): AsyncGenerator<Row, void, unknown> {
+          const runtime = await getRuntime();
+          yield* runtime.execute(plan);
+        }
+        return new AsyncIterableResult(iterate());
+      },
+    },
+  });
+
   return {
+    orm,
     query,
-    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,
-        query,
-        contract,
-        async close() {
-          await runtime.close();
-        },
-      };
+    contract,
+
+    async connect(bindingInput?: MongoBindingInput): Promise<MongoRuntime> {
+      if (closed) {
+        throw new Error('Mongo client is closed');
+      }
+      if (runtimePromise !== undefined) {
+        throw new Error('Mongo client already connected');
+      }
+      if (bindingInput !== undefined) {
+        binding = resolveMongoBinding(bindingInput);
+      }
+      if (binding === undefined) {
+        throw new Error(
+          'Mongo binding not configured. Pass url/uri+dbName/mongoClient+dbName/binding to mongo(...) or call db.connect({ ... }).',
+        );
+      }
+      return getRuntime();
+    },
+
+    runtime(): Promise<MongoRuntime> {
+      return getRuntime();
+    },
+
+    async close(): Promise<void> {
+      if (closed) return;
+      closed = true;
+      if (runtimePromise === undefined) return;
+      // Await whatever the build resolved to. Swallow build failures because
+      // 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();
+      } catch {
+        // build failed; nothing to close.
+      }
     },
   };
 }