@prisma-next/postgres 0.3.0-dev.44 → 0.3.0-dev.52

package/README.md

@@ -13,13 +13,16 @@ Composition-root Postgres helper that builds a Prisma Next runtime client and ex
 `@prisma-next/postgres/runtime` exposes a single `postgres(...)` helper that composes the Postgres execution stack and returns query/runtime roots:
 
 - `db.sql`
-- `db.kysely(runtime)`
+- `db.kysely` (lane-owned build-only authoring surface: `build(query)` + `whereExpr(query)`)
 - `db.schema`
 - `db.orm`
 - `db.context`
 - `db.stack`
 
-Runtime and connection resources are deferred until `db.runtime()` is called.
+`db.kysely` is produced by `@prisma-next/sql-kysely-lane` and intentionally exposes lane behavior, not raw Kysely execution APIs. `build(query)` infers plan row type from `query.compile()`, and `whereExpr(query)` produces `ToWhereExpr` payloads for ORM `.where(...)` interop.
+
+Runtime resources are deferred until `db.runtime()` or `db.connect(...)` is called.
+Connection binding can be provided up front (`url`, `pg`, `binding`) or deferred via `db.connect(...)`.
 
 When URL binding is used, pool timeouts are configurable via `poolOptions`:
 
@@ -29,10 +32,11 @@ When URL binding is used, pool timeouts are configurable via `poolOptions`:
 ## Responsibilities
 
 - Build a static Postgres execution stack from target, adapter, and driver descriptors
-- Build typed SQL and Kysely lane instances from the same execution context
+- Build typed SQL and a build-only Kysely authoring surface from the same execution context
 - Build static schema and ORM roots from the execution context
 - Normalize runtime binding input (`binding`, `url`, `pg`)
-- Lazily instantiate runtime resources on first `db.runtime()` call
+- Lazily instantiate runtime resources on first `db.runtime()` or `db.connect(...)` call
+- Connect the internal Postgres driver through `db.connect(...)` or from initial binding options
 - Memoize runtime so repeated `db.runtime()` calls return one instance
 
 ## Dependencies
@@ -43,11 +47,10 @@ When URL binding is used, pool timeouts are configurable via `poolOptions`:
 - `@prisma-next/adapter-postgres` for adapter descriptor
 - `@prisma-next/driver-postgres` for driver descriptor
 - `@prisma-next/sql-lane` for `sql(...)`
-- `@prisma-next/integration-kysely` for `KyselyPrismaDialect` and contract-to-Kysely typing
+- `@prisma-next/sql-kysely-lane` for contract-to-Kysely typing and build-only Kysely plan assembly
 - `@prisma-next/sql-relational-core` for `schema(...)`
 - `@prisma-next/sql-orm-client` for `orm(...)`
 - `@prisma-next/sql-contract` for `validateContract(...)` and contract types
-- `kysely` for query-builder API surface
 - `pg` for lazy `Pool` construction when using URL binding
 
 ## Architecture
@@ -55,7 +58,7 @@ When URL binding is used, pool timeouts are configurable via `poolOptions`:
 ```mermaid
 flowchart TD
     App[App Code] --> Client[postgres(...)]
-    Client --> Static[Roots: sql kysely(runtime) schema orm context stack]
+    Client --> Static[Roots: sql kysely(build-only) schema orm context stack]
     Client --> Lazy[runtime()]
 
     Lazy --> Instantiate[instantiateExecutionStack]

package/dist/runtime.d.mts

@@ -1,9 +1,8 @@
-import { KyselifyContract } from "@prisma-next/integration-kysely";
+import { KyselyQueryLane, KyselyQueryLane as KyselyQueryLane$1 } from "@prisma-next/sql-kysely-lane";
 import { SelectBuilder } from "@prisma-next/sql-lane";
 import { orm } from "@prisma-next/sql-orm-client";
 import { SchemaHandle } from "@prisma-next/sql-relational-core/schema";
 import { ExecutionContext, Plugin, Runtime, RuntimeVerifyOptions, SqlExecutionStackWithDriver, SqlRuntimeExtensionDescriptor } from "@prisma-next/sql-runtime";
-import { Kysely } from "kysely";
 import { Client, Pool } from "pg";
 import { ExtractCodecTypes, ExtractOperationTypes, SqlContract, SqlStorage } from "@prisma-next/sql-contract/types";
 import { OperationTypeSignature, OperationTypes } from "@prisma-next/sql-relational-core/types";
@@ -40,11 +39,12 @@ type PostgresTargetId = 'postgres';
 type OrmClient<TContract extends SqlContract<SqlStorage>> = ReturnType<typeof orm<TContract>>;
 interface PostgresClient<TContract extends SqlContract<SqlStorage>> {
   readonly sql: SelectBuilder<TContract, unknown, ExtractCodecTypes<TContract>, ExtractOperationTypes<TContract>>;
-  kysely(runtime: Runtime): Kysely<KyselifyContract<TContract>>;
+  readonly kysely: KyselyQueryLane$1<TContract>;
   readonly schema: SchemaHandle<TContract, ExtractCodecTypes<TContract>, ToSchemaOperationTypes<ExtractOperationTypes<TContract>>>;
   readonly orm: OrmClient<TContract>;
   readonly context: ExecutionContext<TContract>;
   readonly stack: SqlExecutionStackWithDriver<PostgresTargetId>;
+  connect(bindingInput?: PostgresBindingInput): Promise<Runtime>;
   runtime(): Runtime;
 }
 interface PostgresOptionsBase<TContract extends SqlContract<SqlStorage>> {
@@ -56,11 +56,16 @@ interface PostgresOptionsBase<TContract extends SqlContract<SqlStorage>> {
     readonly idleTimeoutMillis?: number;
   };
 }
-type PostgresOptionsWithContract<TContract extends SqlContract<SqlStorage>> = PostgresBindingInput & PostgresOptionsBase<TContract> & {
+interface PostgresBindingOptions {
+  readonly binding?: PostgresBinding;
+  readonly url?: string;
+  readonly pg?: Pool | Client;
+}
+type PostgresOptionsWithContract<TContract extends SqlContract<SqlStorage>> = PostgresBindingOptions & PostgresOptionsBase<TContract> & {
   readonly contract: TContract;
   readonly contractJson?: never;
 };
-type PostgresOptionsWithContractJson<TContract extends SqlContract<SqlStorage>> = PostgresBindingInput & PostgresOptionsBase<TContract> & {
+type PostgresOptionsWithContractJson<TContract extends SqlContract<SqlStorage>> = PostgresBindingOptions & PostgresOptionsBase<TContract> & {
   readonly contractJson: unknown;
   readonly contract?: never;
 };
@@ -72,5 +77,5 @@ type PostgresOptions<TContract extends SqlContract<SqlStorage>> = PostgresOption
 declare function postgres<TContract extends SqlContract<SqlStorage>>(options: PostgresOptionsWithContract<TContract>): PostgresClient<TContract>;
 declare function postgres<TContract extends SqlContract<SqlStorage>>(options: PostgresOptionsWithContractJson<TContract>): PostgresClient<TContract>;
 //#endregion
-export { type PostgresBinding, type PostgresClient, type PostgresOptions, type PostgresOptionsBase, type PostgresOptionsWithContract, type PostgresOptionsWithContractJson, postgres as default };
+export { type KyselyQueryLane, type PostgresBinding, type PostgresClient, type PostgresOptions, type PostgresOptionsBase, type PostgresOptionsWithContract, type PostgresOptionsWithContractJson, postgres 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/binding.ts","../src/runtime/postgres.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/postgres.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/runtime.mjs

@@ -1,14 +1,13 @@
 import postgresAdapter from "@prisma-next/adapter-postgres/runtime";
 import { instantiateExecutionStack } from "@prisma-next/core-execution-plane/stack";
 import postgresDriver from "@prisma-next/driver-postgres/runtime";
-import { KyselyPrismaDialect } from "@prisma-next/integration-kysely";
 import { validateContract } from "@prisma-next/sql-contract/validate";
+import { createKyselyLane } from "@prisma-next/sql-kysely-lane";
 import { sql } from "@prisma-next/sql-lane";
 import { orm } from "@prisma-next/sql-orm-client";
 import { schema } from "@prisma-next/sql-relational-core/schema";
 import { createExecutionContext, createRuntime, createSqlExecutionStack } from "@prisma-next/sql-runtime";
 import postgresTarget from "@prisma-next/target-postgres/runtime";
-import { Kysely } from "kysely";
 import { Client, Pool } from "pg";
 
 //#region src/runtime/binding.ts
@@ -43,6 +42,10 @@ function resolvePostgresBinding(options) {
 	};
 	throw new Error("Unable to determine pg binding type from pg input; use binding with explicit kind");
 }
+function resolveOptionalPostgresBinding(options) {
+	if (Number(options.binding !== void 0) + Number(options.url !== void 0) + Number(options.pg !== void 0) === 0) return;
+	return resolvePostgresBinding(options);
+}
 
 //#endregion
 //#region src/runtime/postgres.ts
@@ -52,9 +55,20 @@ function hasContractJson(options) {
 function resolveContract(options) {
 	return validateContract(hasContractJson(options) ? options.contractJson : options.contract);
 }
+function toRuntimeBinding(binding, options) {
+	if (binding.kind !== "url") return binding;
+	return {
+		kind: "pgPool",
+		pool: new Pool({
+			connectionString: binding.url,
+			connectionTimeoutMillis: options.poolOptions?.connectionTimeoutMillis ?? 2e4,
+			idleTimeoutMillis: options.poolOptions?.idleTimeoutMillis ?? 3e4
+		})
+	};
+}
 function postgres(options) {
 	const contract = resolveContract(options);
-	const binding = resolvePostgresBinding(options);
+	let binding = resolveOptionalPostgresBinding(options);
 	const stack = createSqlExecutionStack({
 		target: postgresTarget,
 		adapter: postgresAdapter,
@@ -68,23 +82,38 @@ function postgres(options) {
 	const schema$1 = schema(context);
 	const sql$1 = sql({ context });
 	let runtimeInstance;
+	let runtimeDriver;
+	let driverConnected = false;
+	let connectPromise;
+	let backgroundConnectError;
+	const connectDriver = async (resolvedBinding) => {
+		if (driverConnected) return;
+		if (!runtimeDriver) throw new Error("Postgres runtime driver missing");
+		if (connectPromise) return connectPromise;
+		const runtimeBinding = toRuntimeBinding(resolvedBinding, options);
+		connectPromise = runtimeDriver.connect(runtimeBinding).then(() => {
+			driverConnected = true;
+		}).catch(async (err) => {
+			backgroundConnectError = err;
+			connectPromise = void 0;
+			if (resolvedBinding.kind === "url" && runtimeBinding.kind === "pgPool") await runtimeBinding.pool.end().catch(() => void 0);
+			throw err;
+		});
+		return connectPromise;
+	};
 	const getRuntime = () => {
+		if (backgroundConnectError !== void 0) throw backgroundConnectError;
 		if (runtimeInstance) return runtimeInstance;
 		const stackInstance = instantiateExecutionStack(stack);
 		const driverDescriptor = stack.driver;
 		if (!driverDescriptor) throw new Error("Driver descriptor missing from execution stack");
-		const connect = binding.kind === "url" ? { pool: new Pool({
-			connectionString: binding.url,
-			connectionTimeoutMillis: options.poolOptions?.connectionTimeoutMillis ?? 2e4,
-			idleTimeoutMillis: options.poolOptions?.idleTimeoutMillis ?? 3e4
-		}) } : binding.kind === "pgPool" ? { pool: binding.pool } : { client: binding.client };
+		const driver = driverDescriptor.create({ cursor: { disabled: true } });
+		runtimeDriver = driver;
+		if (binding !== void 0) connectDriver(binding).catch(() => void 0);
 		runtimeInstance = createRuntime({
 			stackInstance,
 			context,
-			driver: driverDescriptor.create({
-				connect,
-				cursor: { disabled: true }
-			}),
+			driver,
 			verify: options.verify ?? {
 				mode: "onFirstUse",
 				requireMarker: false
@@ -93,28 +122,33 @@ function postgres(options) {
 		});
 		return runtimeInstance;
 	};
+	const orm$1 = orm({
+		contract,
+		runtime: {
+			execute(plan) {
+				return getRuntime().execute(plan);
+			},
+			connection() {
+				return getRuntime().connection();
+			}
+		}
+	});
 	return {
 		sql: sql$1,
-		kysely(runtime) {
-			return new Kysely({ dialect: new KyselyPrismaDialect({
-				runtime,
-				contract
-			}) });
-		},
+		kysely: createKyselyLane(contract),
 		schema: schema$1,
-		orm: orm({
-			contract,
-			runtime: {
-				execute(plan) {
-					return getRuntime().execute(plan);
-				},
-				connection() {
-					return getRuntime().connection();
-				}
-			}
-		}),
+		orm: orm$1,
 		context,
 		stack,
+		async connect(bindingInput) {
+			if (driverConnected || connectPromise) throw new Error("Postgres client already connected");
+			if (bindingInput !== void 0) binding = resolvePostgresBinding(bindingInput);
+			if (binding === void 0) throw new Error("Postgres binding not configured. Pass url/pg/binding to postgres(...) or call db.connect({ ... }).");
+			const runtime = getRuntime();
+			if (driverConnected) return runtime;
+			await connectDriver(binding);
+			return runtime;
+		},
 		runtime() {
 			return getRuntime();
 		}

package/dist/runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.mjs","names":["parsed: URL","PgPool","PgClient","schema: PostgresClient<TContract>['schema']","schemaBuilder","sql","sqlBuilder","runtimeInstance: Runtime | undefined","ormBuilder"],"sources":["../src/runtime/binding.ts","../src/runtime/postgres.ts"],"sourcesContent":["import type { Client, Pool } from 'pg';\nimport { Client as PgClient, Pool as PgPool } from 'pg';\n\nexport type PostgresBinding =\n  | { readonly kind: 'url'; readonly url: string }\n  | { readonly kind: 'pgPool'; readonly pool: Pool }\n  | { readonly kind: 'pgClient'; readonly client: Client };\n\nexport type PostgresBindingInput =\n  | {\n      readonly binding: PostgresBinding;\n      readonly url?: never;\n      readonly pg?: never;\n    }\n  | {\n      readonly url: string;\n      readonly binding?: never;\n      readonly pg?: never;\n    }\n  | {\n      readonly pg: Pool | Client;\n      readonly binding?: never;\n      readonly url?: never;\n    };\n\nfunction validatePostgresUrl(url: string): string {\n  const trimmed = url.trim();\n  if (trimmed.length === 0) {\n    throw new Error('Postgres 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('Postgres URL must be a valid URL');\n  }\n\n  if (parsed.protocol !== 'postgres:' && parsed.protocol !== 'postgresql:') {\n    throw new Error('Postgres URL must use postgres:// or postgresql://');\n  }\n\n  return trimmed;\n}\n\nexport function resolvePostgresBinding(options: PostgresBindingInput): PostgresBinding {\n  const providedCount =\n    Number(options.binding !== undefined) +\n    Number(options.url !== undefined) +\n    Number(options.pg !== undefined);\n\n  if (providedCount !== 1) {\n    throw new Error('Provide one binding input: binding, url, or pg');\n  }\n\n  if (options.binding !== undefined) {\n    return options.binding;\n  }\n\n  if (options.url !== undefined) {\n    return { kind: 'url', url: validatePostgresUrl(options.url) };\n  }\n\n  const pgBinding = options.pg;\n  if (pgBinding === undefined) {\n    throw new Error('Invariant violation: expected pg binding after validation');\n  }\n\n  if (pgBinding instanceof PgPool) {\n    return { kind: 'pgPool', pool: pgBinding };\n  }\n\n  if (pgBinding instanceof PgClient) {\n    return { kind: 'pgClient', client: pgBinding };\n  }\n\n  throw new Error(\n    'Unable to determine pg binding type from pg input; use binding with explicit kind',\n  );\n}\n","import postgresAdapter from '@prisma-next/adapter-postgres/runtime';\nimport { instantiateExecutionStack } from '@prisma-next/core-execution-plane/stack';\nimport postgresDriver from '@prisma-next/driver-postgres/runtime';\nimport { type KyselifyContract, KyselyPrismaDialect } from '@prisma-next/integration-kysely';\nimport type {\n  ExtractCodecTypes,\n  ExtractOperationTypes,\n  SqlContract,\n  SqlStorage,\n} from '@prisma-next/sql-contract/types';\nimport { validateContract } from '@prisma-next/sql-contract/validate';\nimport type { SelectBuilder } from '@prisma-next/sql-lane';\nimport { sql as sqlBuilder } from '@prisma-next/sql-lane';\nimport { orm as ormBuilder } from '@prisma-next/sql-orm-client';\nimport type { SchemaHandle } from '@prisma-next/sql-relational-core/schema';\nimport { schema as schemaBuilder } from '@prisma-next/sql-relational-core/schema';\nimport type {\n  OperationTypeSignature,\n  OperationTypes,\n} from '@prisma-next/sql-relational-core/types';\nimport type {\n  ExecutionContext,\n  Plugin,\n  Runtime,\n  RuntimeVerifyOptions,\n  SqlExecutionStackWithDriver,\n  SqlRuntimeExtensionDescriptor,\n} from '@prisma-next/sql-runtime';\nimport {\n  createExecutionContext,\n  createRuntime,\n  createSqlExecutionStack,\n} from '@prisma-next/sql-runtime';\nimport postgresTarget from '@prisma-next/target-postgres/runtime';\nimport { Kysely } from 'kysely';\nimport { Pool } from 'pg';\nimport { type PostgresBindingInput, resolvePostgresBinding } from './binding';\n\ntype NormalizeOperationTypes<T> = {\n  [TypeId in keyof T]: {\n    [Method in keyof T[TypeId]]: T[TypeId][Method] extends OperationTypeSignature\n      ? T[TypeId][Method]\n      : OperationTypeSignature;\n  };\n};\n\ntype ToSchemaOperationTypes<T> = T extends OperationTypes ? T : NormalizeOperationTypes<T>;\n\nexport type PostgresTargetId = 'postgres';\ntype OrmClient<TContract extends SqlContract<SqlStorage>> = ReturnType<\n  typeof ormBuilder<TContract>\n>;\n\nexport interface PostgresClient<TContract extends SqlContract<SqlStorage>> {\n  readonly sql: SelectBuilder<\n    TContract,\n    unknown,\n    ExtractCodecTypes<TContract>,\n    ExtractOperationTypes<TContract>\n  >;\n  kysely(runtime: Runtime): Kysely<KyselifyContract<TContract>>;\n  readonly schema: SchemaHandle<\n    TContract,\n    ExtractCodecTypes<TContract>,\n    ToSchemaOperationTypes<ExtractOperationTypes<TContract>>\n  >;\n  readonly orm: OrmClient<TContract>;\n  readonly context: ExecutionContext<TContract>;\n  readonly stack: SqlExecutionStackWithDriver<PostgresTargetId>;\n  runtime(): Runtime;\n}\n\nexport interface PostgresOptionsBase<TContract extends SqlContract<SqlStorage>> {\n  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];\n  readonly plugins?: readonly Plugin<TContract>[];\n  readonly verify?: RuntimeVerifyOptions;\n  readonly poolOptions?: {\n    readonly connectionTimeoutMillis?: number;\n    readonly idleTimeoutMillis?: number;\n  };\n}\n\nexport type PostgresOptionsWithContract<TContract extends SqlContract<SqlStorage>> =\n  PostgresBindingInput &\n    PostgresOptionsBase<TContract> & {\n      readonly contract: TContract;\n      readonly contractJson?: never;\n    };\n\nexport type PostgresOptionsWithContractJson<TContract extends SqlContract<SqlStorage>> =\n  PostgresBindingInput &\n    PostgresOptionsBase<TContract> & {\n      readonly contractJson: unknown;\n      readonly contract?: never;\n    };\n\nexport type PostgresOptions<TContract extends SqlContract<SqlStorage>> =\n  | PostgresOptionsWithContract<TContract>\n  | PostgresOptionsWithContractJson<TContract>;\n\nfunction hasContractJson<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): options is PostgresOptionsWithContractJson<TContract> {\n  return 'contractJson' in options;\n}\n\nfunction resolveContract<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): TContract {\n  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;\n  return validateContract<TContract>(contractInput);\n}\n\n/**\n * Creates a lazy Postgres client from either `contractJson` or a TypeScript-authored `contract`.\n * Static query surfaces are available immediately, while `runtime()` instantiates the driver/pool on first call.\n */\nexport default function postgres<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptionsWithContract<TContract>,\n): PostgresClient<TContract>;\nexport default function postgres<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptionsWithContractJson<TContract>,\n): PostgresClient<TContract>;\nexport default function postgres<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): PostgresClient<TContract> {\n  const contract = resolveContract(options);\n  const binding = resolvePostgresBinding(options);\n  const stack = createSqlExecutionStack({\n    target: postgresTarget,\n    adapter: postgresAdapter,\n    driver: postgresDriver,\n    extensionPacks: options.extensions ?? [],\n  });\n\n  const context = createExecutionContext({\n    contract,\n    stack,\n  });\n\n  const schema: PostgresClient<TContract>['schema'] = schemaBuilder(context);\n  const sql = sqlBuilder({ context });\n  let runtimeInstance: Runtime | undefined;\n  const getRuntime = (): Runtime => {\n    if (runtimeInstance) {\n      return runtimeInstance;\n    }\n\n    const stackInstance = instantiateExecutionStack(stack);\n    const driverDescriptor = stack.driver;\n    if (!driverDescriptor) {\n      throw new Error('Driver descriptor missing from execution stack');\n    }\n\n    const connect =\n      binding.kind === 'url'\n        ? {\n            pool: new Pool({\n              connectionString: binding.url,\n              connectionTimeoutMillis: options.poolOptions?.connectionTimeoutMillis ?? 20_000,\n              idleTimeoutMillis: options.poolOptions?.idleTimeoutMillis ?? 30_000,\n            }),\n          }\n        : binding.kind === 'pgPool'\n          ? { pool: binding.pool }\n          : { client: binding.client };\n\n    const driver = driverDescriptor.create({\n      connect,\n      cursor: { disabled: true },\n    });\n\n    runtimeInstance = createRuntime({\n      stackInstance,\n      context,\n      driver,\n      verify: options.verify ?? { mode: 'onFirstUse', requireMarker: false },\n      ...(options.plugins ? { plugins: options.plugins } : {}),\n    });\n\n    return runtimeInstance;\n  };\n  const orm: OrmClient<TContract> = ormBuilder({\n    contract,\n    runtime: {\n      execute(plan) {\n        return getRuntime().execute(plan);\n      },\n      connection() {\n        return getRuntime().connection();\n      },\n    },\n  });\n\n  return {\n    sql,\n    kysely(runtime: Runtime) {\n      return new Kysely<KyselifyContract<TContract>>({\n        dialect: new KyselyPrismaDialect({ runtime, contract }),\n      });\n    },\n    schema,\n    orm,\n    context,\n    stack,\n    runtime() {\n      return getRuntime();\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAyBA,SAAS,oBAAoB,KAAqB;CAChD,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,MAAM,0CAA0C;CAG5D,IAAIA;AACJ,KAAI;AACF,WAAS,IAAI,IAAI,QAAQ;SACnB;AACN,QAAM,IAAI,MAAM,mCAAmC;;AAGrD,KAAI,OAAO,aAAa,eAAe,OAAO,aAAa,cACzD,OAAM,IAAI,MAAM,qDAAqD;AAGvE,QAAO;;AAGT,SAAgB,uBAAuB,SAAgD;AAMrF,KAJE,OAAO,QAAQ,YAAY,OAAU,GACrC,OAAO,QAAQ,QAAQ,OAAU,GACjC,OAAO,QAAQ,OAAO,OAAU,KAEZ,EACpB,OAAM,IAAI,MAAM,iDAAiD;AAGnE,KAAI,QAAQ,YAAY,OACtB,QAAO,QAAQ;AAGjB,KAAI,QAAQ,QAAQ,OAClB,QAAO;EAAE,MAAM;EAAO,KAAK,oBAAoB,QAAQ,IAAI;EAAE;CAG/D,MAAM,YAAY,QAAQ;AAC1B,KAAI,cAAc,OAChB,OAAM,IAAI,MAAM,4DAA4D;AAG9E,KAAI,qBAAqBC,KACvB,QAAO;EAAE,MAAM;EAAU,MAAM;EAAW;AAG5C,KAAI,qBAAqBC,OACvB,QAAO;EAAE,MAAM;EAAY,QAAQ;EAAW;AAGhD,OAAM,IAAI,MACR,oFACD;;;;;ACsBH,SAAS,gBACP,SACuD;AACvD,QAAO,kBAAkB;;AAG3B,SAAS,gBACP,SACW;AAEX,QAAO,iBADe,gBAAgB,QAAQ,GAAG,QAAQ,eAAe,QAAQ,SAC/B;;AAanD,SAAwB,SACtB,SAC2B;CAC3B,MAAM,WAAW,gBAAgB,QAAQ;CACzC,MAAM,UAAU,uBAAuB,QAAQ;CAC/C,MAAM,QAAQ,wBAAwB;EACpC,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,gBAAgB,QAAQ,cAAc,EAAE;EACzC,CAAC;CAEF,MAAM,UAAU,uBAAuB;EACrC;EACA;EACD,CAAC;CAEF,MAAMC,WAA8CC,OAAc,QAAQ;CAC1E,MAAMC,QAAMC,IAAW,EAAE,SAAS,CAAC;CACnC,IAAIC;CACJ,MAAM,mBAA4B;AAChC,MAAI,gBACF,QAAO;EAGT,MAAM,gBAAgB,0BAA0B,MAAM;EACtD,MAAM,mBAAmB,MAAM;AAC/B,MAAI,CAAC,iBACH,OAAM,IAAI,MAAM,iDAAiD;EAGnE,MAAM,UACJ,QAAQ,SAAS,QACb,EACE,MAAM,IAAI,KAAK;GACb,kBAAkB,QAAQ;GAC1B,yBAAyB,QAAQ,aAAa,2BAA2B;GACzE,mBAAmB,QAAQ,aAAa,qBAAqB;GAC9D,CAAC,EACH,GACD,QAAQ,SAAS,WACf,EAAE,MAAM,QAAQ,MAAM,GACtB,EAAE,QAAQ,QAAQ,QAAQ;AAOlC,oBAAkB,cAAc;GAC9B;GACA;GACA,QARa,iBAAiB,OAAO;IACrC;IACA,QAAQ,EAAE,UAAU,MAAM;IAC3B,CAAC;GAMA,QAAQ,QAAQ,UAAU;IAAE,MAAM;IAAc,eAAe;IAAO;GACtE,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,SAAS,GAAG,EAAE;GACxD,CAAC;AAEF,SAAO;;AAcT,QAAO;EACL;EACA,OAAO,SAAkB;AACvB,UAAO,IAAI,OAAoC,EAC7C,SAAS,IAAI,oBAAoB;IAAE;IAAS;IAAU,CAAC,EACxD,CAAC;;EAEJ;EACA,KApBgCC,IAAW;GAC3C;GACA,SAAS;IACP,QAAQ,MAAM;AACZ,YAAO,YAAY,CAAC,QAAQ,KAAK;;IAEnC,aAAa;AACX,YAAO,YAAY,CAAC,YAAY;;IAEnC;GACF,CAAC;EAWA;EACA;EACA,UAAU;AACR,UAAO,YAAY;;EAEtB"}
+{"version":3,"file":"runtime.mjs","names":["parsed: URL","PgPool","PgClient","schema: PostgresClient<TContract>['schema']","schemaBuilder","sql","sqlBuilder","runtimeInstance: Runtime | undefined","runtimeDriver: { connect(binding: unknown): Promise<void> } | undefined","connectPromise: Promise<void> | undefined","backgroundConnectError: unknown","orm: OrmClient<TContract>","ormBuilder"],"sources":["../src/runtime/binding.ts","../src/runtime/postgres.ts"],"sourcesContent":["import type { Client, Pool } from 'pg';\nimport { Client as PgClient, Pool as PgPool } from 'pg';\n\nexport type PostgresBinding =\n  | { readonly kind: 'url'; readonly url: string }\n  | { readonly kind: 'pgPool'; readonly pool: Pool }\n  | { readonly kind: 'pgClient'; readonly client: Client };\n\nexport type PostgresBindingInput =\n  | {\n      readonly binding: PostgresBinding;\n      readonly url?: never;\n      readonly pg?: never;\n    }\n  | {\n      readonly url: string;\n      readonly binding?: never;\n      readonly pg?: never;\n    }\n  | {\n      readonly pg: Pool | Client;\n      readonly binding?: never;\n      readonly url?: never;\n    };\n\ntype PostgresBindingFields = {\n  readonly binding?: PostgresBinding;\n  readonly url?: string;\n  readonly pg?: Pool | Client;\n};\n\nfunction validatePostgresUrl(url: string): string {\n  const trimmed = url.trim();\n  if (trimmed.length === 0) {\n    throw new Error('Postgres 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('Postgres URL must be a valid URL');\n  }\n\n  if (parsed.protocol !== 'postgres:' && parsed.protocol !== 'postgresql:') {\n    throw new Error('Postgres URL must use postgres:// or postgresql://');\n  }\n\n  return trimmed;\n}\n\nexport function resolvePostgresBinding(options: PostgresBindingInput): PostgresBinding {\n  const providedCount =\n    Number(options.binding !== undefined) +\n    Number(options.url !== undefined) +\n    Number(options.pg !== undefined);\n\n  if (providedCount !== 1) {\n    throw new Error('Provide one binding input: binding, url, or pg');\n  }\n\n  if (options.binding !== undefined) {\n    return options.binding;\n  }\n\n  if (options.url !== undefined) {\n    return { kind: 'url', url: validatePostgresUrl(options.url) };\n  }\n\n  const pgBinding = options.pg;\n  if (pgBinding === undefined) {\n    throw new Error('Invariant violation: expected pg binding after validation');\n  }\n\n  if (pgBinding instanceof PgPool) {\n    return { kind: 'pgPool', pool: pgBinding };\n  }\n\n  if (pgBinding instanceof PgClient) {\n    return { kind: 'pgClient', client: pgBinding };\n  }\n\n  throw new Error(\n    'Unable to determine pg binding type from pg input; use binding with explicit kind',\n  );\n}\n\nexport function resolveOptionalPostgresBinding(\n  options: PostgresBindingFields,\n): PostgresBinding | undefined {\n  const providedCount =\n    Number(options.binding !== undefined) +\n    Number(options.url !== undefined) +\n    Number(options.pg !== undefined);\n\n  if (providedCount === 0) {\n    return undefined;\n  }\n\n  return resolvePostgresBinding(options as PostgresBindingInput);\n}\n","import postgresAdapter from '@prisma-next/adapter-postgres/runtime';\nimport { instantiateExecutionStack } from '@prisma-next/core-execution-plane/stack';\nimport postgresDriver from '@prisma-next/driver-postgres/runtime';\nimport type {\n  ExtractCodecTypes,\n  ExtractOperationTypes,\n  SqlContract,\n  SqlStorage,\n} from '@prisma-next/sql-contract/types';\nimport { validateContract } from '@prisma-next/sql-contract/validate';\nimport { createKyselyLane, type KyselyQueryLane } from '@prisma-next/sql-kysely-lane';\nimport type { SelectBuilder } from '@prisma-next/sql-lane';\nimport { sql as sqlBuilder } from '@prisma-next/sql-lane';\nimport { orm as ormBuilder } from '@prisma-next/sql-orm-client';\nimport type { SchemaHandle } from '@prisma-next/sql-relational-core/schema';\nimport { schema as schemaBuilder } from '@prisma-next/sql-relational-core/schema';\nimport type {\n  OperationTypeSignature,\n  OperationTypes,\n} from '@prisma-next/sql-relational-core/types';\nimport type {\n  ExecutionContext,\n  Plugin,\n  Runtime,\n  RuntimeVerifyOptions,\n  SqlExecutionStackWithDriver,\n  SqlRuntimeExtensionDescriptor,\n} from '@prisma-next/sql-runtime';\nimport {\n  createExecutionContext,\n  createRuntime,\n  createSqlExecutionStack,\n} from '@prisma-next/sql-runtime';\nimport postgresTarget from '@prisma-next/target-postgres/runtime';\nimport { type Client, Pool } from 'pg';\nimport {\n  type PostgresBinding,\n  type PostgresBindingInput,\n  resolveOptionalPostgresBinding,\n  resolvePostgresBinding,\n} from './binding';\n\ntype NormalizeOperationTypes<T> = {\n  [TypeId in keyof T]: {\n    [Method in keyof T[TypeId]]: T[TypeId][Method] extends OperationTypeSignature\n      ? T[TypeId][Method]\n      : OperationTypeSignature;\n  };\n};\n\ntype ToSchemaOperationTypes<T> = T extends OperationTypes ? T : NormalizeOperationTypes<T>;\n\nexport type PostgresTargetId = 'postgres';\ntype OrmClient<TContract extends SqlContract<SqlStorage>> = ReturnType<\n  typeof ormBuilder<TContract>\n>;\n\nexport interface PostgresClient<TContract extends SqlContract<SqlStorage>> {\n  readonly sql: SelectBuilder<\n    TContract,\n    unknown,\n    ExtractCodecTypes<TContract>,\n    ExtractOperationTypes<TContract>\n  >;\n  readonly kysely: KyselyQueryLane<TContract>;\n  readonly schema: SchemaHandle<\n    TContract,\n    ExtractCodecTypes<TContract>,\n    ToSchemaOperationTypes<ExtractOperationTypes<TContract>>\n  >;\n  readonly orm: OrmClient<TContract>;\n  readonly context: ExecutionContext<TContract>;\n  readonly stack: SqlExecutionStackWithDriver<PostgresTargetId>;\n  connect(bindingInput?: PostgresBindingInput): Promise<Runtime>;\n  runtime(): Runtime;\n}\n\nexport interface PostgresOptionsBase<TContract extends SqlContract<SqlStorage>> {\n  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];\n  readonly plugins?: readonly Plugin<TContract>[];\n  readonly verify?: RuntimeVerifyOptions;\n  readonly poolOptions?: {\n    readonly connectionTimeoutMillis?: number;\n    readonly idleTimeoutMillis?: number;\n  };\n}\n\nexport interface PostgresBindingOptions {\n  readonly binding?: PostgresBinding;\n  readonly url?: string;\n  readonly pg?: Pool | Client;\n}\n\nexport type PostgresOptionsWithContract<TContract extends SqlContract<SqlStorage>> =\n  PostgresBindingOptions &\n    PostgresOptionsBase<TContract> & {\n      readonly contract: TContract;\n      readonly contractJson?: never;\n    };\n\nexport type PostgresOptionsWithContractJson<TContract extends SqlContract<SqlStorage>> =\n  PostgresBindingOptions &\n    PostgresOptionsBase<TContract> & {\n      readonly contractJson: unknown;\n      readonly contract?: never;\n    };\n\nexport type PostgresOptions<TContract extends SqlContract<SqlStorage>> =\n  | PostgresOptionsWithContract<TContract>\n  | PostgresOptionsWithContractJson<TContract>;\n\nfunction hasContractJson<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): options is PostgresOptionsWithContractJson<TContract> {\n  return 'contractJson' in options;\n}\n\nfunction resolveContract<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): TContract {\n  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;\n  return validateContract<TContract>(contractInput);\n}\n\nfunction toRuntimeBinding<TContract extends SqlContract<SqlStorage>>(\n  binding: PostgresBinding,\n  options: PostgresOptions<TContract>,\n) {\n  if (binding.kind !== 'url') {\n    return binding;\n  }\n\n  return {\n    kind: 'pgPool',\n    pool: new Pool({\n      connectionString: binding.url,\n      connectionTimeoutMillis: options.poolOptions?.connectionTimeoutMillis ?? 20_000,\n      idleTimeoutMillis: options.poolOptions?.idleTimeoutMillis ?? 30_000,\n    }),\n  } as const;\n}\n\n/**\n * Creates a lazy Postgres client from either `contractJson` or a TypeScript-authored `contract`.\n * Static query surfaces are available immediately, while `runtime()` instantiates the driver/pool on first call.\n */\nexport default function postgres<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptionsWithContract<TContract>,\n): PostgresClient<TContract>;\nexport default function postgres<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptionsWithContractJson<TContract>,\n): PostgresClient<TContract>;\nexport default function postgres<TContract extends SqlContract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): PostgresClient<TContract> {\n  const contract = resolveContract(options);\n  let binding = resolveOptionalPostgresBinding(options);\n  const stack = createSqlExecutionStack({\n    target: postgresTarget,\n    adapter: postgresAdapter,\n    driver: postgresDriver,\n    extensionPacks: options.extensions ?? [],\n  });\n\n  const context = createExecutionContext({\n    contract,\n    stack,\n  });\n\n  const schema: PostgresClient<TContract>['schema'] = schemaBuilder(context);\n  const sql = sqlBuilder({ context });\n  let runtimeInstance: Runtime | undefined;\n  let runtimeDriver: { connect(binding: unknown): Promise<void> } | undefined;\n  let driverConnected = false;\n  let connectPromise: Promise<void> | undefined;\n  let backgroundConnectError: unknown;\n  const connectDriver = async (resolvedBinding: PostgresBinding): Promise<void> => {\n    if (driverConnected) return;\n    if (!runtimeDriver) throw new Error('Postgres runtime driver missing');\n    if (connectPromise) return connectPromise;\n    const runtimeBinding = toRuntimeBinding(resolvedBinding, options);\n    connectPromise = runtimeDriver\n      .connect(runtimeBinding)\n      .then(() => {\n        driverConnected = true;\n      })\n      .catch(async (err) => {\n        backgroundConnectError = err;\n        connectPromise = undefined;\n        if (resolvedBinding.kind === 'url' && runtimeBinding.kind === 'pgPool') {\n          await runtimeBinding.pool.end().catch(() => undefined);\n        }\n        throw err;\n      });\n    return connectPromise;\n  };\n  const getRuntime = (): Runtime => {\n    if (backgroundConnectError !== undefined) {\n      throw backgroundConnectError;\n    }\n\n    if (runtimeInstance) {\n      return runtimeInstance;\n    }\n\n    const stackInstance = instantiateExecutionStack(stack);\n    const driverDescriptor = stack.driver;\n    if (!driverDescriptor) {\n      throw new Error('Driver descriptor missing from execution stack');\n    }\n\n    const driver = driverDescriptor.create({\n      cursor: { disabled: true },\n    });\n    runtimeDriver = driver;\n    if (binding !== undefined) {\n      void connectDriver(binding).catch(() => undefined);\n    }\n\n    runtimeInstance = createRuntime({\n      stackInstance,\n      context,\n      driver,\n      verify: options.verify ?? { mode: 'onFirstUse', requireMarker: false },\n      ...(options.plugins ? { plugins: options.plugins } : {}),\n    });\n\n    return runtimeInstance;\n  };\n  const orm: OrmClient<TContract> = ormBuilder({\n    contract,\n    runtime: {\n      execute(plan) {\n        return getRuntime().execute(plan);\n      },\n      connection() {\n        return getRuntime().connection();\n      },\n    },\n  });\n\n  return {\n    sql,\n    kysely: createKyselyLane(contract),\n    schema,\n    orm,\n    context,\n    stack,\n    async connect(bindingInput) {\n      if (driverConnected || connectPromise) {\n        throw new Error('Postgres client already connected');\n      }\n\n      if (bindingInput !== undefined) {\n        binding = resolvePostgresBinding(bindingInput);\n      }\n\n      if (binding === undefined) {\n        throw new Error(\n          'Postgres binding not configured. Pass url/pg/binding to postgres(...) or call db.connect({ ... }).',\n        );\n      }\n\n      const runtime = getRuntime();\n      if (driverConnected) {\n        return runtime;\n      }\n\n      await connectDriver(binding);\n      return runtime;\n    },\n    runtime() {\n      return getRuntime();\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,22 +1,21 @@
 {
   "name": "@prisma-next/postgres",
-  "version": "0.3.0-dev.44",
+  "version": "0.3.0-dev.52",
   "type": "module",
   "sideEffects": false,
   "description": "One-liner lazy Postgres client composition for Prisma Next",
   "dependencies": {
-    "kysely": "0.28.10",
     "pg": "8.16.3",
-    "@prisma-next/core-execution-plane": "0.3.0-dev.44",
-    "@prisma-next/driver-postgres": "0.3.0-dev.44",
-    "@prisma-next/integration-kysely": "0.3.0-dev.44",
-    "@prisma-next/sql-contract": "0.3.0-dev.44",
-    "@prisma-next/sql-lane": "0.3.0-dev.44",
-    "@prisma-next/sql-orm-client": "0.3.0-dev.44",
-    "@prisma-next/sql-relational-core": "0.3.0-dev.44",
-    "@prisma-next/sql-runtime": "0.3.0-dev.44",
-    "@prisma-next/target-postgres": "0.3.0-dev.44",
-    "@prisma-next/adapter-postgres": "0.3.0-dev.44"
+    "@prisma-next/adapter-postgres": "0.3.0-dev.52",
+    "@prisma-next/core-execution-plane": "0.3.0-dev.52",
+    "@prisma-next/driver-postgres": "0.3.0-dev.52",
+    "@prisma-next/sql-contract": "0.3.0-dev.52",
+    "@prisma-next/sql-kysely-lane": "0.3.0-dev.52",
+    "@prisma-next/sql-lane": "0.3.0-dev.52",
+    "@prisma-next/sql-orm-client": "0.3.0-dev.52",
+    "@prisma-next/sql-relational-core": "0.3.0-dev.52",
+    "@prisma-next/sql-runtime": "0.3.0-dev.52",
+    "@prisma-next/target-postgres": "0.3.0-dev.52"
   },
   "devDependencies": {
     "@types/pg": "8.16.0",

package/src/exports/runtime.ts

@@ -1,3 +1,4 @@
+export type { KyselyQueryLane } from '@prisma-next/sql-kysely-lane';
 export type { PostgresBinding } from '../runtime/binding';
 export type {
   PostgresClient,

package/src/runtime/binding.ts

@@ -23,6 +23,12 @@ export type PostgresBindingInput =
       readonly url?: never;
     };
 
+type PostgresBindingFields = {
+  readonly binding?: PostgresBinding;
+  readonly url?: string;
+  readonly pg?: Pool | Client;
+};
+
 function validatePostgresUrl(url: string): string {
   const trimmed = url.trim();
   if (trimmed.length === 0) {
@@ -78,3 +84,18 @@ export function resolvePostgresBinding(options: PostgresBindingInput): PostgresB
     'Unable to determine pg binding type from pg input; use binding with explicit kind',
   );
 }
+
+export function resolveOptionalPostgresBinding(
+  options: PostgresBindingFields,
+): PostgresBinding | undefined {
+  const providedCount =
+    Number(options.binding !== undefined) +
+    Number(options.url !== undefined) +
+    Number(options.pg !== undefined);
+
+  if (providedCount === 0) {
+    return undefined;
+  }
+
+  return resolvePostgresBinding(options as PostgresBindingInput);
+}

package/src/runtime/postgres.ts

@@ -1,7 +1,6 @@
 import postgresAdapter from '@prisma-next/adapter-postgres/runtime';
 import { instantiateExecutionStack } from '@prisma-next/core-execution-plane/stack';
 import postgresDriver from '@prisma-next/driver-postgres/runtime';
-import { type KyselifyContract, KyselyPrismaDialect } from '@prisma-next/integration-kysely';
 import type {
   ExtractCodecTypes,
   ExtractOperationTypes,
@@ -9,6 +8,7 @@ import type {
   SqlStorage,
 } from '@prisma-next/sql-contract/types';
 import { validateContract } from '@prisma-next/sql-contract/validate';
+import { createKyselyLane, type KyselyQueryLane } from '@prisma-next/sql-kysely-lane';
 import type { SelectBuilder } from '@prisma-next/sql-lane';
 import { sql as sqlBuilder } from '@prisma-next/sql-lane';
 import { orm as ormBuilder } from '@prisma-next/sql-orm-client';
@@ -32,9 +32,13 @@ import {
   createSqlExecutionStack,
 } from '@prisma-next/sql-runtime';
 import postgresTarget from '@prisma-next/target-postgres/runtime';
-import { Kysely } from 'kysely';
-import { Pool } from 'pg';
-import { type PostgresBindingInput, resolvePostgresBinding } from './binding';
+import { type Client, Pool } from 'pg';
+import {
+  type PostgresBinding,
+  type PostgresBindingInput,
+  resolveOptionalPostgresBinding,
+  resolvePostgresBinding,
+} from './binding';
 
 type NormalizeOperationTypes<T> = {
   [TypeId in keyof T]: {
@@ -58,7 +62,7 @@ export interface PostgresClient<TContract extends SqlContract<SqlStorage>> {
     ExtractCodecTypes<TContract>,
     ExtractOperationTypes<TContract>
   >;
-  kysely(runtime: Runtime): Kysely<KyselifyContract<TContract>>;
+  readonly kysely: KyselyQueryLane<TContract>;
   readonly schema: SchemaHandle<
     TContract,
     ExtractCodecTypes<TContract>,
@@ -67,6 +71,7 @@ export interface PostgresClient<TContract extends SqlContract<SqlStorage>> {
   readonly orm: OrmClient<TContract>;
   readonly context: ExecutionContext<TContract>;
   readonly stack: SqlExecutionStackWithDriver<PostgresTargetId>;
+  connect(bindingInput?: PostgresBindingInput): Promise<Runtime>;
   runtime(): Runtime;
 }
 
@@ -80,15 +85,21 @@ export interface PostgresOptionsBase<TContract extends SqlContract<SqlStorage>>
   };
 }
 
+export interface PostgresBindingOptions {
+  readonly binding?: PostgresBinding;
+  readonly url?: string;
+  readonly pg?: Pool | Client;
+}
+
 export type PostgresOptionsWithContract<TContract extends SqlContract<SqlStorage>> =
-  PostgresBindingInput &
+  PostgresBindingOptions &
     PostgresOptionsBase<TContract> & {
       readonly contract: TContract;
       readonly contractJson?: never;
     };
 
 export type PostgresOptionsWithContractJson<TContract extends SqlContract<SqlStorage>> =
-  PostgresBindingInput &
+  PostgresBindingOptions &
     PostgresOptionsBase<TContract> & {
       readonly contractJson: unknown;
       readonly contract?: never;
@@ -111,6 +122,24 @@ function resolveContract<TContract extends SqlContract<SqlStorage>>(
   return validateContract<TContract>(contractInput);
 }
 
+function toRuntimeBinding<TContract extends SqlContract<SqlStorage>>(
+  binding: PostgresBinding,
+  options: PostgresOptions<TContract>,
+) {
+  if (binding.kind !== 'url') {
+    return binding;
+  }
+
+  return {
+    kind: 'pgPool',
+    pool: new Pool({
+      connectionString: binding.url,
+      connectionTimeoutMillis: options.poolOptions?.connectionTimeoutMillis ?? 20_000,
+      idleTimeoutMillis: options.poolOptions?.idleTimeoutMillis ?? 30_000,
+    }),
+  } as const;
+}
+
 /**
  * Creates a lazy Postgres client from either `contractJson` or a TypeScript-authored `contract`.
  * Static query surfaces are available immediately, while `runtime()` instantiates the driver/pool on first call.
@@ -125,7 +154,7 @@ export default function postgres<TContract extends SqlContract<SqlStorage>>(
   options: PostgresOptions<TContract>,
 ): PostgresClient<TContract> {
   const contract = resolveContract(options);
-  const binding = resolvePostgresBinding(options);
+  let binding = resolveOptionalPostgresBinding(options);
   const stack = createSqlExecutionStack({
     target: postgresTarget,
     adapter: postgresAdapter,
@@ -141,7 +170,35 @@ export default function postgres<TContract extends SqlContract<SqlStorage>>(
   const schema: PostgresClient<TContract>['schema'] = schemaBuilder(context);
   const sql = sqlBuilder({ context });
   let runtimeInstance: Runtime | undefined;
+  let runtimeDriver: { connect(binding: unknown): Promise<void> } | undefined;
+  let driverConnected = false;
+  let connectPromise: Promise<void> | undefined;
+  let backgroundConnectError: unknown;
+  const connectDriver = async (resolvedBinding: PostgresBinding): Promise<void> => {
+    if (driverConnected) return;
+    if (!runtimeDriver) throw new Error('Postgres runtime driver missing');
+    if (connectPromise) return connectPromise;
+    const runtimeBinding = toRuntimeBinding(resolvedBinding, options);
+    connectPromise = runtimeDriver
+      .connect(runtimeBinding)
+      .then(() => {
+        driverConnected = true;
+      })
+      .catch(async (err) => {
+        backgroundConnectError = err;
+        connectPromise = undefined;
+        if (resolvedBinding.kind === 'url' && runtimeBinding.kind === 'pgPool') {
+          await runtimeBinding.pool.end().catch(() => undefined);
+        }
+        throw err;
+      });
+    return connectPromise;
+  };
   const getRuntime = (): Runtime => {
+    if (backgroundConnectError !== undefined) {
+      throw backgroundConnectError;
+    }
+
     if (runtimeInstance) {
       return runtimeInstance;
     }
@@ -152,23 +209,13 @@ export default function postgres<TContract extends SqlContract<SqlStorage>>(
       throw new Error('Driver descriptor missing from execution stack');
     }
 
-    const connect =
-      binding.kind === 'url'
-        ? {
-            pool: new Pool({
-              connectionString: binding.url,
-              connectionTimeoutMillis: options.poolOptions?.connectionTimeoutMillis ?? 20_000,
-              idleTimeoutMillis: options.poolOptions?.idleTimeoutMillis ?? 30_000,
-            }),
-          }
-        : binding.kind === 'pgPool'
-          ? { pool: binding.pool }
-          : { client: binding.client };
-
     const driver = driverDescriptor.create({
-      connect,
       cursor: { disabled: true },
     });
+    runtimeDriver = driver;
+    if (binding !== undefined) {
+      void connectDriver(binding).catch(() => undefined);
+    }
 
     runtimeInstance = createRuntime({
       stackInstance,
@@ -194,15 +241,34 @@ export default function postgres<TContract extends SqlContract<SqlStorage>>(
 
   return {
     sql,
-    kysely(runtime: Runtime) {
-      return new Kysely<KyselifyContract<TContract>>({
-        dialect: new KyselyPrismaDialect({ runtime, contract }),
-      });
-    },
+    kysely: createKyselyLane(contract),
     schema,
     orm,
     context,
     stack,
+    async connect(bindingInput) {
+      if (driverConnected || connectPromise) {
+        throw new Error('Postgres client already connected');
+      }
+
+      if (bindingInput !== undefined) {
+        binding = resolvePostgresBinding(bindingInput);
+      }
+
+      if (binding === undefined) {
+        throw new Error(
+          'Postgres binding not configured. Pass url/pg/binding to postgres(...) or call db.connect({ ... }).',
+        );
+      }
+
+      const runtime = getRuntime();
+      if (driverConnected) {
+        return runtime;
+      }
+
+      await connectDriver(binding);
+      return runtime;
+    },
     runtime() {
       return getRuntime();
     },