@prisma-next/postgres 0.5.0-dev.8 → 0.5.0-dev.87

package/README.md

@@ -2,11 +2,18 @@
 
 One-package Postgres setup for Prisma Next. Install this single package to get config, runtime, and all transitive type dependencies.
 
+Two runtime facades ship under different entrypoints:
+
+- `@prisma-next/postgres/runtime` — long-lived Node process facade with closure-cached `runtime()`, `orm`, and `transaction()`.
+- `@prisma-next/postgres/serverless` — per-request facade for serverless / edge runtimes (Cloudflare Workers + Hyperdrive, AWS Lambda, Vercel, Deno Deploy, Bun edge). Each `connect()` returns a fresh `Runtime & AsyncDisposable`.
+
+Pick the facade that matches your deployment lifecycle. The asymmetry is intentional: closure caching is unsafe across `fetch` invocations (stale connections after isolate idle, concurrent-query races, no clean shutdown), so the serverless facade deliberately omits `orm`, `runtime()`, and `transaction()`. See `docs/architecture docs/subsystems/4. Runtime & Middleware Framework.md` and the deployment guide for the rationale.
+
 ## Package Classification
 
 - **Domain**: extensions
 - **Layer**: adapters
-- **Planes**: shared (config), runtime (runtime)
+- **Planes**: shared (config), runtime (runtime, serverless)
 
 ## Quick Start
 
@@ -20,6 +27,8 @@ export default defineConfig({
 });
 ```
 
+### Node (long-lived process)
+
 ```typescript
 // db.ts
 import postgres from '@prisma-next/postgres/runtime';
@@ -29,6 +38,28 @@ import contractJson from './contract.json' with { type: 'json' };
 export const db = postgres<Contract>({ contractJson });
 ```
 
+### Serverless / per-request runtimes
+
+```typescript
+// db.ts — module scope: only the static authoring surface is built here.
+import postgresServerless from '@prisma-next/postgres/serverless';
+import type { Contract } from './contract.d';
+import contractJson from './contract.json' with { type: 'json' };
+
+export const db = postgresServerless<Contract>({ contractJson });
+
+// worker.ts — per-request: acquire a fresh Runtime, dispose with `await using`.
+export default {
+  async fetch(_req: Request, env: Env): Promise<Response> {
+    await using runtime = await db.connect({ url: env.HYPERDRIVE.connectionString });
+    const rows = await runtime.execute(db.sql.from(/* ... */).build());
+    return Response.json(rows);
+  },
+};
+```
+
+The returned client exposes `sql`, `context`, `stack`, `contract`, and `connect()` — and intentionally nothing else. Construct ORM clients (or invoke `withTransaction` from `@prisma-next/sql-runtime`) against the runtime returned by `connect()` instead of caching one on the closure.
+
 ## Exports
 
 ### `@prisma-next/postgres/config`
@@ -40,14 +71,10 @@ Simplified `defineConfig` that pre-wires all Postgres internals (family, target,
 `@prisma-next/postgres/runtime` exposes a single `postgres(...)` helper that composes the Postgres execution stack and returns query/runtime roots:
 
 - `db.sql`
-- `db.kysely` (lane-owned build-only authoring surface: `build(query)` + `whereExpr(query)`)
-- `db.schema`
 - `db.orm`
 - `db.context`
 - `db.stack`
 
-`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(...)`.
 
@@ -56,11 +83,35 @@ When URL binding is used, pool timeouts are configurable via `poolOptions`:
 - `poolOptions.connectionTimeoutMillis` (default `20_000`)
 - `poolOptions.idleTimeoutMillis` (default `30_000`)
 
+### `@prisma-next/postgres/contract-builder`
+
+Re-exports the TypeScript contract authoring DSL (`defineContract`, `field`, `model`, `rel`, ...) so a generated `prisma/contract.ts` can author its contract using only this facade package.
+
+### `@prisma-next/postgres/family`
+
+Re-exports the SQL family pack (the value passed as `family:` to `defineContract`).
+
+### `@prisma-next/postgres/target`
+
+Re-exports the Postgres target pack (the value passed as `target:` to `defineContract`).
+
+### `@prisma-next/postgres/serverless`
+
+`@prisma-next/postgres/serverless` exposes `postgresServerless(...)` for per-request runtimes. The returned client exposes only:
+
+- `db.sql`
+- `db.context`
+- `db.stack`
+- `db.contract`
+- `db.connect({ url })` — returns `Promise<Runtime & AsyncDisposable>`
+
+Each `connect()` call constructs a fresh `pg.Client` and a fresh `Runtime`. No `pg.Pool` is allocated. `[Symbol.asyncDispose]` calls `runtime.close()`, which closes the underlying client. `pg-cursor` is enabled by default; opt out via `cursor: { disabled: true }`.
+
 ## Responsibilities
 
 - Build a static Postgres execution stack from target, adapter, and driver descriptors
-- 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
+- Build a typed SQL authoring surface from the execution context
+- Build a static ORM root from the execution context
 - Normalize runtime binding input (`binding`, `url`, `pg`)
 - 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
@@ -73,19 +124,17 @@ When URL binding is used, pool timeouts are configurable via `poolOptions`:
 - `@prisma-next/target-postgres` for target descriptor
 - `@prisma-next/adapter-postgres` for adapter descriptor
 - `@prisma-next/driver-postgres` for driver descriptor
-- `@prisma-next/sql-lane` for `sql(...)`
-- `@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-builder` for `sql(...)`
 - `@prisma-next/sql-orm-client` for `orm(...)`
 - `@prisma-next/sql-contract` for `validateContract(...)` and contract types
-- `pg` for lazy `Pool` construction when using URL binding
+- `pg` for `Pool` construction (URL / `pgPool` binding on the Node factory) and `Client` construction (`pgClient` binding on the Node factory; per-`connect()` on the serverless facade)
 
 ## Architecture
 
 ```mermaid
 flowchart TD
     App[App Code] --> Client[postgres(...)]
-    Client --> Static[Roots: sql kysely(build-only) schema orm context stack]
+    Client --> Static[Roots: sql orm context stack]
     Client --> Lazy[runtime()]
 
     Lazy --> Instantiate[instantiateExecutionStack]

package/dist/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config/define-config.ts"],"sourcesContent":[],"mappings":";;;;UAYiB,qBAAA;;EAAA,SAAA,EAAA,CAAA,EAAA;IAmBD,SAAA,UAAY,CAAA,EAAU,MAAA;;iCAdL;;;;;iBAcjB,YAAA,UAAsB,wBAAwB"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config/define-config.ts"],"mappings":";;;;UAYiB,qBAAA;EAAA,SACN,QAAA;EAAA,SACA,EAAA;IAAA,SACE,UAAA;EAAA;EAAA,SAEF,UAAA,YAAsB,0BAAA;EAAA,SACtB,UAAA;IAAA,SACE,GAAA;EAAA;AAAA;AAAA,iBAYG,YAAA,CAAa,OAAA,EAAS,qBAAA,GAAwB,gBAAA"}

package/dist/config.mjs

@@ -7,7 +7,6 @@ import { typescriptContractFromPath } from "@prisma-next/sql-contract-ts/config-
 import postgres from "@prisma-next/target-postgres/control";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { extname } from "pathe";
-
 //#region src/config/define-config.ts
 function deriveOutputPath(contractPath) {
 	const ext = extname(contractPath);
@@ -31,7 +30,7 @@ function defineConfig(options) {
 		...ifDefined("migrations", options.migrations)
 	});
 }
-
 //#endregion
 export { defineConfig };
+
 //# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":["coreDefineConfig"],"sources":["../src/config/define-config.ts"],"sourcesContent":["import postgresAdapter from '@prisma-next/adapter-postgres/control';\nimport type { PrismaNextConfig } from '@prisma-next/config/config-types';\nimport { defineConfig as coreDefineConfig } from '@prisma-next/config/config-types';\nimport postgresDriver from '@prisma-next/driver-postgres/control';\nimport sql from '@prisma-next/family-sql/control';\nimport type { ControlExtensionDescriptor } from '@prisma-next/framework-components/control';\nimport { prismaContract } from '@prisma-next/sql-contract-psl/provider';\nimport { typescriptContractFromPath } from '@prisma-next/sql-contract-ts/config-types';\nimport postgres from '@prisma-next/target-postgres/control';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { extname } from 'pathe';\n\nexport interface PostgresConfigOptions {\n  readonly contract: string;\n  readonly db?: {\n    readonly connection?: string;\n  };\n  readonly extensions?: readonly ControlExtensionDescriptor<'sql', 'postgres'>[];\n  readonly migrations?: {\n    readonly dir?: string;\n  };\n}\n\nfunction deriveOutputPath(contractPath: string): string {\n  const ext = extname(contractPath);\n  if (ext.length === 0) {\n    return `${contractPath}.json`;\n  }\n  return `${contractPath.slice(0, -ext.length)}.json`;\n}\n\nexport function defineConfig(options: PostgresConfigOptions): PrismaNextConfig<'sql', 'postgres'> {\n  const extensions = options.extensions ?? [];\n  const output = deriveOutputPath(options.contract);\n  const ext = extname(options.contract);\n\n  const contractConfig =\n    ext === '.ts'\n      ? typescriptContractFromPath(options.contract, output)\n      : prismaContract(options.contract, {\n          output,\n          target: postgres,\n        });\n\n  return coreDefineConfig({\n    family: sql,\n    target: postgres,\n    adapter: postgresAdapter,\n    driver: postgresDriver,\n    extensionPacks: extensions,\n    contract: contractConfig,\n    ...ifDefined('db', options.db),\n    ...ifDefined('migrations', options.migrations),\n  });\n}\n"],"mappings":";;;;;;;;;;;AAuBA,SAAS,iBAAiB,cAA8B;CACtD,MAAM,MAAM,QAAQ,aAAa;AACjC,KAAI,IAAI,WAAW,EACjB,QAAO,GAAG,aAAa;AAEzB,QAAO,GAAG,aAAa,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC;;AAG/C,SAAgB,aAAa,SAAqE;CAChG,MAAM,aAAa,QAAQ,cAAc,EAAE;CAC3C,MAAM,SAAS,iBAAiB,QAAQ,SAAS;AAWjD,QAAOA,eAAiB;EACtB,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,gBAAgB;EAChB,UAhBU,QAAQ,QAAQ,SAAS,KAG3B,QACJ,2BAA2B,QAAQ,UAAU,OAAO,GACpD,eAAe,QAAQ,UAAU;GAC/B;GACA,QAAQ;GACT,CAAC;EASN,GAAG,UAAU,MAAM,QAAQ,GAAG;EAC9B,GAAG,UAAU,cAAc,QAAQ,WAAW;EAC/C,CAAC"}
+{"version":3,"file":"config.mjs","names":["coreDefineConfig"],"sources":["../src/config/define-config.ts"],"sourcesContent":["import postgresAdapter from '@prisma-next/adapter-postgres/control';\nimport type { PrismaNextConfig } from '@prisma-next/config/config-types';\nimport { defineConfig as coreDefineConfig } from '@prisma-next/config/config-types';\nimport postgresDriver from '@prisma-next/driver-postgres/control';\nimport sql from '@prisma-next/family-sql/control';\nimport type { ControlExtensionDescriptor } from '@prisma-next/framework-components/control';\nimport { prismaContract } from '@prisma-next/sql-contract-psl/provider';\nimport { typescriptContractFromPath } from '@prisma-next/sql-contract-ts/config-types';\nimport postgres from '@prisma-next/target-postgres/control';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { extname } from 'pathe';\n\nexport interface PostgresConfigOptions {\n  readonly contract: string;\n  readonly db?: {\n    readonly connection?: string;\n  };\n  readonly extensions?: readonly ControlExtensionDescriptor<'sql', 'postgres'>[];\n  readonly migrations?: {\n    readonly dir?: string;\n  };\n}\n\nfunction deriveOutputPath(contractPath: string): string {\n  const ext = extname(contractPath);\n  if (ext.length === 0) {\n    return `${contractPath}.json`;\n  }\n  return `${contractPath.slice(0, -ext.length)}.json`;\n}\n\nexport function defineConfig(options: PostgresConfigOptions): PrismaNextConfig<'sql', 'postgres'> {\n  const extensions = options.extensions ?? [];\n  const output = deriveOutputPath(options.contract);\n  const ext = extname(options.contract);\n\n  const contractConfig =\n    ext === '.ts'\n      ? typescriptContractFromPath(options.contract, output)\n      : prismaContract(options.contract, {\n          output,\n          target: postgres,\n        });\n\n  return coreDefineConfig({\n    family: sql,\n    target: postgres,\n    adapter: postgresAdapter,\n    driver: postgresDriver,\n    extensionPacks: extensions,\n    contract: contractConfig,\n    ...ifDefined('db', options.db),\n    ...ifDefined('migrations', options.migrations),\n  });\n}\n"],"mappings":";;;;;;;;;;AAuBA,SAAS,iBAAiB,cAA8B;CACtD,MAAM,MAAM,QAAQ,aAAa;CACjC,IAAI,IAAI,WAAW,GACjB,OAAO,GAAG,aAAa;CAEzB,OAAO,GAAG,aAAa,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC;;AAG/C,SAAgB,aAAa,SAAqE;CAChG,MAAM,aAAa,QAAQ,cAAc,EAAE;CAC3C,MAAM,SAAS,iBAAiB,QAAQ,SAAS;CAWjD,OAAOA,eAAiB;EACtB,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,gBAAgB;EAChB,UAhBU,QAAQ,QAAQ,SAGvB,KAAK,QACJ,2BAA2B,QAAQ,UAAU,OAAO,GACpD,eAAe,QAAQ,UAAU;GAC/B;GACA,QAAQ;GACT,CAAC;EASN,GAAG,UAAU,MAAM,QAAQ,GAAG;EAC9B,GAAG,UAAU,cAAc,QAAQ,WAAW;EAC/C,CAAC"}

package/dist/contract-builder.d.mts

@@ -0,0 +1,2 @@
+import { ComposedAuthoringHelpers, ContractDefinition, ContractInput, ContractModelBuilder, FieldNode, ForeignKeyNode, IndexNode, ModelNode, PrimaryKeyNode, RelationNode, ScalarFieldBuilder, UniqueConstraintNode, buildSqlContractFromDefinition, defineContract, field, model, rel } from "@prisma-next/sql-contract-ts/contract-builder";
+export { type ComposedAuthoringHelpers, type ContractDefinition, type ContractInput, type ContractModelBuilder, type FieldNode, type ForeignKeyNode, type IndexNode, type ModelNode, type PrimaryKeyNode, type RelationNode, type ScalarFieldBuilder, type UniqueConstraintNode, buildSqlContractFromDefinition, defineContract, field, model, rel };

package/dist/contract-builder.mjs

@@ -0,0 +1,2 @@
+import { buildSqlContractFromDefinition, defineContract, field, model, rel } from "@prisma-next/sql-contract-ts/contract-builder";
+export { buildSqlContractFromDefinition, defineContract, field, model, rel };

package/dist/family.d.mts

@@ -0,0 +1,2 @@
+import pack_default from "@prisma-next/family-sql/pack";
+export { pack_default as default };

package/dist/family.mjs

@@ -0,0 +1,2 @@
+import pack_default from "@prisma-next/family-sql/pack";
+export { pack_default as default };

package/dist/postgres-Bkdcp2EZ.d.mts

@@ -0,0 +1,84 @@
+import { orm } from "@prisma-next/sql-orm-client";
+import { ExecutionContext, Runtime, RuntimeVerifyOptions, SqlExecutionStackWithDriver, SqlMiddleware, SqlRuntimeExtensionDescriptor, TransactionContext } from "@prisma-next/sql-runtime";
+import { Client, Pool } from "pg";
+import { Contract } from "@prisma-next/contract/types";
+import { Db } from "@prisma-next/sql-builder/types";
+import { SqlStorage } from "@prisma-next/sql-contract/types";
+
+//#region src/runtime/binding.d.ts
+type PostgresBinding = {
+  readonly kind: 'url';
+  readonly url: string;
+} | {
+  readonly kind: 'pgPool';
+  readonly pool: Pool;
+} | {
+  readonly kind: 'pgClient';
+  readonly client: Client;
+};
+type PostgresBindingInput = {
+  readonly binding: PostgresBinding;
+  readonly url?: never;
+  readonly pg?: never;
+} | {
+  readonly url: string;
+  readonly binding?: never;
+  readonly pg?: never;
+} | {
+  readonly pg: Pool | Client;
+  readonly binding?: never;
+  readonly url?: never;
+};
+//#endregion
+//#region src/runtime/postgres.d.ts
+type PostgresTargetId = 'postgres';
+type OrmClient<TContract extends Contract<SqlStorage>> = ReturnType<typeof orm<TContract>>;
+interface PostgresTransactionContext<TContract extends Contract<SqlStorage>> extends TransactionContext {
+  readonly sql: Db<TContract>;
+  readonly orm: OrmClient<TContract>;
+}
+interface PostgresClient<TContract extends Contract<SqlStorage>> {
+  readonly sql: Db<TContract>;
+  readonly orm: OrmClient<TContract>;
+  readonly context: ExecutionContext<TContract>;
+  readonly stack: SqlExecutionStackWithDriver<PostgresTargetId>;
+  connect(bindingInput?: PostgresBindingInput): Promise<Runtime>;
+  runtime(): Runtime;
+  transaction<R>(fn: (tx: PostgresTransactionContext<TContract>) => PromiseLike<R>): Promise<R>;
+}
+interface PostgresOptionsBase {
+  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];
+  readonly middleware?: readonly SqlMiddleware[];
+  readonly verify?: RuntimeVerifyOptions;
+  readonly poolOptions?: {
+    readonly connectionTimeoutMillis?: number;
+    readonly idleTimeoutMillis?: number;
+  };
+}
+interface PostgresBindingOptions {
+  readonly binding?: PostgresBinding;
+  readonly url?: string;
+  readonly pg?: Pool | Client;
+}
+type PostgresOptionsWithContract<TContract extends Contract<SqlStorage>> = PostgresBindingOptions & PostgresOptionsBase & {
+  readonly contract: TContract;
+  readonly contractJson?: never;
+};
+type PostgresOptionsWithContractJson<TContract extends Contract<SqlStorage>> = PostgresBindingOptions & PostgresOptionsBase & {
+  readonly contractJson: unknown;
+  readonly contract?: never;
+  readonly _contract?: TContract;
+};
+type PostgresOptions<TContract extends Contract<SqlStorage>> = PostgresOptionsWithContract<TContract> | PostgresOptionsWithContractJson<TContract>;
+/**
+ * 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.
+ *
+ * - No-emit: pass a TypeScript-authored contract. Example: postgres({ contract })
+ * - Emitted: pass Contract type explicitly. Example: postgres<Contract>({ contractJson, url })
+ */
+declare function postgres<TContract extends Contract<SqlStorage>>(options: PostgresOptionsWithContract<TContract>): PostgresClient<TContract>;
+declare function postgres<TContract extends Contract<SqlStorage>>(options: PostgresOptionsWithContractJson<TContract>): PostgresClient<TContract>;
+//#endregion
+export { PostgresOptionsWithContractJson as a, PostgresBinding as c, PostgresOptionsWithContract as i, PostgresOptions as n, PostgresTargetId as o, PostgresOptionsBase as r, postgres as s, PostgresClient as t };
+//# sourceMappingURL=postgres-Bkdcp2EZ.d.mts.map

package/dist/postgres-Bkdcp2EZ.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-Bkdcp2EZ.d.mts","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/postgres.ts"],"mappings":";;;;;;;;KAGY,eAAA;EAAA,SACG,IAAA;EAAA,SAAsB,GAAA;AAAA;EAAA,SACtB,IAAA;EAAA,SAAyB,IAAA,EAAM,IAAA;AAAA;EAAA,SAC/B,IAAA;EAAA,SAA2B,MAAA,EAAQ,MAAA;AAAA;AAAA,KAEtC,oBAAA;EAAA,SAEG,OAAA,EAAS,eAAA;EAAA,SACT,GAAA;EAAA,SACA,EAAA;AAAA;EAAA,SAGA,GAAA;EAAA,SACA,OAAA;EAAA,SACA,EAAA;AAAA;EAAA,SAGA,EAAA,EAAI,IAAA,GAAO,MAAA;EAAA,SACX,OAAA;EAAA,SACA,GAAA;AAAA;;;KCaH,gBAAA;AAAA,KACP,SAAA,mBAA4B,QAAA,CAAS,UAAA,KAAe,UAAA,QAAkB,GAAA,CAAW,SAAA;AAAA,UAErE,0BAAA,mBAA6C,QAAA,CAAS,UAAA,WAC7D,kBAAA;EAAA,SACC,GAAA,EAAK,EAAA,CAAG,SAAA;EAAA,SACR,GAAA,EAAK,SAAA,CAAU,SAAA;AAAA;AAAA,UAGT,cAAA,mBAAiC,QAAA,CAAS,UAAA;EAAA,SAChD,GAAA,EAAK,EAAA,CAAG,SAAA;EAAA,SACR,GAAA,EAAK,SAAA,CAAU,SAAA;EAAA,SACf,OAAA,EAAS,gBAAA,CAAiB,SAAA;EAAA,SAC1B,KAAA,EAAO,2BAAA,CAA4B,gBAAA;EAC5C,OAAA,CAAQ,YAAA,GAAe,oBAAA,GAAuB,OAAA,CAAQ,OAAA;EACtD,OAAA,IAAW,OAAA;EACX,WAAA,IAAe,EAAA,GAAK,EAAA,EAAI,0BAAA,CAA2B,SAAA,MAAe,WAAA,CAAY,CAAA,IAAK,OAAA,CAAQ,CAAA;AAAA;AAAA,UAG5E,mBAAA;EAAA,SACN,UAAA,YAAsB,6BAAA,CAA8B,gBAAA;EAAA,SACpD,UAAA,YAAsB,aAAA;EAAA,SACtB,MAAA,GAAS,oBAAA;EAAA,SACT,WAAA;IAAA,SACE,uBAAA;IAAA,SACA,iBAAA;EAAA;AAAA;AAAA,UAII,sBAAA;EAAA,SACN,OAAA,GAAU,eAAA;EAAA,SACV,GAAA;EAAA,SACA,EAAA,GAAK,IAAA,GAAO,MAAA;AAAA;AAAA,KAGX,2BAAA,mBAA8C,QAAA,CAAS,UAAA,KACjE,sBAAA,GACE,mBAAA;EAAA,SACW,QAAA,EAAU,SAAA;EAAA,SACV,YAAA;AAAA;AAAA,KAGH,+BAAA,mBAAkD,QAAA,CAAS,UAAA,KACrE,sBAAA,GACE,mBAAA;EAAA,SACW,YAAA;EAAA,SACA,QAAA;EAAA,SACA,SAAA,GAAY,SAAA;AAAA;AAAA,KAGf,eAAA,mBAAkC,QAAA,CAAS,UAAA,KACnD,2BAAA,CAA4B,SAAA,IAC5B,+BAAA,CAAgC,SAAA;;AApDpC;;;;;AAA0C;iBA4FlB,QAAA,mBAA2B,QAAA,CAAS,UAAA,EAAA,CAC1D,OAAA,EAAS,2BAAA,CAA4B,SAAA,IACpC,cAAA,CAAe,SAAA;AAAA,iBACM,QAAA,mBAA2B,QAAA,CAAS,UAAA,EAAA,CAC1D,OAAA,EAAS,+BAAA,CAAgC,SAAA,IACxC,cAAA,CAAe,SAAA"}

package/dist/runtime.d.mts

@@ -1,84 +1,2 @@
-import { orm } from "@prisma-next/sql-orm-client";
-import { ExecutionContext, Runtime, RuntimeVerifyOptions, SqlExecutionStackWithDriver, SqlMiddleware, SqlRuntimeExtensionDescriptor, TransactionContext } from "@prisma-next/sql-runtime";
-import { Client, Pool } from "pg";
-import { Contract } from "@prisma-next/contract/types";
-import { Db } from "@prisma-next/sql-builder/types";
-import { SqlStorage } from "@prisma-next/sql-contract/types";
-
-//#region src/runtime/binding.d.ts
-type PostgresBinding = {
-  readonly kind: 'url';
-  readonly url: string;
-} | {
-  readonly kind: 'pgPool';
-  readonly pool: Pool;
-} | {
-  readonly kind: 'pgClient';
-  readonly client: Client;
-};
-type PostgresBindingInput = {
-  readonly binding: PostgresBinding;
-  readonly url?: never;
-  readonly pg?: never;
-} | {
-  readonly url: string;
-  readonly binding?: never;
-  readonly pg?: never;
-} | {
-  readonly pg: Pool | Client;
-  readonly binding?: never;
-  readonly url?: never;
-};
-//#endregion
-//#region src/runtime/postgres.d.ts
-type PostgresTargetId = 'postgres';
-type OrmClient<TContract extends Contract<SqlStorage>> = ReturnType<typeof orm<TContract>>;
-interface PostgresTransactionContext<TContract extends Contract<SqlStorage>> extends TransactionContext {
-  readonly sql: Db<TContract>;
-  readonly orm: OrmClient<TContract>;
-}
-interface PostgresClient<TContract extends Contract<SqlStorage>> {
-  readonly sql: Db<TContract>;
-  readonly orm: OrmClient<TContract>;
-  readonly context: ExecutionContext<TContract>;
-  readonly stack: SqlExecutionStackWithDriver<PostgresTargetId>;
-  connect(bindingInput?: PostgresBindingInput): Promise<Runtime>;
-  runtime(): Runtime;
-  transaction<R>(fn: (tx: PostgresTransactionContext<TContract>) => PromiseLike<R>): Promise<R>;
-}
-interface PostgresOptionsBase {
-  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];
-  readonly middleware?: readonly SqlMiddleware[];
-  readonly verify?: RuntimeVerifyOptions;
-  readonly poolOptions?: {
-    readonly connectionTimeoutMillis?: number;
-    readonly idleTimeoutMillis?: number;
-  };
-}
-interface PostgresBindingOptions {
-  readonly binding?: PostgresBinding;
-  readonly url?: string;
-  readonly pg?: Pool | Client;
-}
-type PostgresOptionsWithContract<TContract extends Contract<SqlStorage>> = PostgresBindingOptions & PostgresOptionsBase & {
-  readonly contract: TContract;
-  readonly contractJson?: never;
-};
-type PostgresOptionsWithContractJson<TContract extends Contract<SqlStorage>> = PostgresBindingOptions & PostgresOptionsBase & {
-  readonly contractJson: unknown;
-  readonly contract?: never;
-  readonly _contract?: TContract;
-};
-type PostgresOptions<TContract extends Contract<SqlStorage>> = PostgresOptionsWithContract<TContract> | PostgresOptionsWithContractJson<TContract>;
-/**
- * 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.
- *
- * - No-emit: pass a TypeScript-authored contract. Example: postgres({ contract })
- * - Emitted: pass Contract type explicitly. Example: postgres<Contract>({ contractJson, url })
- */
-declare function postgres<TContract extends Contract<SqlStorage>>(options: PostgresOptionsWithContract<TContract>): PostgresClient<TContract>;
-declare function postgres<TContract extends Contract<SqlStorage>>(options: PostgresOptionsWithContractJson<TContract>): PostgresClient<TContract>;
-//#endregion
-export { type PostgresBinding, type PostgresClient, type PostgresOptions, type PostgresOptionsBase, type PostgresOptionsWithContract, type PostgresOptionsWithContractJson, postgres as default };
-//# sourceMappingURL=runtime.d.mts.map
+import { a as PostgresOptionsWithContractJson, c as PostgresBinding, i as PostgresOptionsWithContract, n as PostgresOptions, r as PostgresOptionsBase, s as postgres, t as PostgresClient } from "./postgres-Bkdcp2EZ.mjs";
+export { type PostgresBinding, type PostgresClient, type PostgresOptions, type PostgresOptionsBase, type PostgresOptionsWithContract, type PostgresOptionsWithContractJson, postgres as default };

package/dist/runtime.mjs

@@ -1,3 +1,4 @@
+import { ifDefined } from "@prisma-next/utils/defined";
 import postgresAdapter from "@prisma-next/adapter-postgres/runtime";
 import postgresDriver from "@prisma-next/driver-postgres/runtime";
 import { emptyCodecLookup } from "@prisma-next/framework-components/codec";
@@ -8,7 +9,6 @@ import { orm } from "@prisma-next/sql-orm-client";
 import { createExecutionContext, createRuntime, createSqlExecutionStack, withTransaction } from "@prisma-next/sql-runtime";
 import postgresTarget from "@prisma-next/target-postgres/runtime";
 import { Client, Pool } from "pg";
-
 //#region src/runtime/binding.ts
 function validatePostgresUrl(url) {
 	const trimmed = url.trim();
@@ -45,7 +45,6 @@ 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
 function hasContractJson(options) {
@@ -115,7 +114,7 @@ function postgres(options) {
 				mode: "onFirstUse",
 				requireMarker: false
 			},
-			...options.middleware ? { middleware: options.middleware } : {}
+			...ifDefined("middleware", options.middleware)
 		});
 		return runtimeInstance;
 	};
@@ -164,7 +163,7 @@ function postgres(options) {
 		}
 	};
 }
-
 //#endregion
 export { postgres as default };
+
 //# sourceMappingURL=runtime.mjs.map

package/dist/runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.mjs","names":["parsed: URL","PgPool","PgClient","runtimeInstance: Runtime | undefined","runtimeDriver: { connect(binding: unknown): Promise<void> } | undefined","connectPromise: Promise<void> | undefined","backgroundConnectError: unknown","orm: OrmClient<TContract>","ormBuilder","sqlBuilder","txSql: Db<TContract>","txOrm: OrmClient<TContract>"],"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 type { Contract } from '@prisma-next/contract/types';\nimport postgresDriver from '@prisma-next/driver-postgres/runtime';\nimport { emptyCodecLookup } from '@prisma-next/framework-components/codec';\nimport { instantiateExecutionStack } from '@prisma-next/framework-components/execution';\nimport { sql as sqlBuilder } from '@prisma-next/sql-builder/runtime';\nimport type { Db } from '@prisma-next/sql-builder/types';\nimport type { SqlStorage } from '@prisma-next/sql-contract/types';\nimport { validateContract } from '@prisma-next/sql-contract/validate';\nimport { orm as ormBuilder } from '@prisma-next/sql-orm-client';\nimport type {\n  ExecutionContext,\n  Runtime,\n  RuntimeVerifyOptions,\n  SqlExecutionStackWithDriver,\n  SqlMiddleware,\n  SqlRuntimeExtensionDescriptor,\n  TransactionContext,\n} from '@prisma-next/sql-runtime';\nimport {\n  createExecutionContext,\n  createRuntime,\n  createSqlExecutionStack,\n  withTransaction,\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\nexport type PostgresTargetId = 'postgres';\ntype OrmClient<TContract extends Contract<SqlStorage>> = ReturnType<typeof ormBuilder<TContract>>;\n\nexport interface PostgresTransactionContext<TContract extends Contract<SqlStorage>>\n  extends TransactionContext {\n  readonly sql: Db<TContract>;\n  readonly orm: OrmClient<TContract>;\n}\n\nexport interface PostgresClient<TContract extends Contract<SqlStorage>> {\n  readonly sql: Db<TContract>;\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  transaction<R>(fn: (tx: PostgresTransactionContext<TContract>) => PromiseLike<R>): Promise<R>;\n}\n\nexport interface PostgresOptionsBase {\n  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];\n  readonly middleware?: readonly SqlMiddleware[];\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 Contract<SqlStorage>> =\n  PostgresBindingOptions &\n    PostgresOptionsBase & {\n      readonly contract: TContract;\n      readonly contractJson?: never;\n    };\n\nexport type PostgresOptionsWithContractJson<TContract extends Contract<SqlStorage>> =\n  PostgresBindingOptions &\n    PostgresOptionsBase & {\n      readonly contractJson: unknown;\n      readonly contract?: never;\n      readonly _contract?: TContract;\n    };\n\nexport type PostgresOptions<TContract extends Contract<SqlStorage>> =\n  | PostgresOptionsWithContract<TContract>\n  | PostgresOptionsWithContractJson<TContract>;\n\nfunction hasContractJson<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): options is PostgresOptionsWithContractJson<TContract> {\n  return 'contractJson' in options;\n}\n\nfunction resolveContract<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): TContract {\n  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;\n  return validateContract<TContract>(contractInput, emptyCodecLookup);\n}\n\nfunction toRuntimeBinding<TContract extends Contract<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 *\n * - No-emit: pass a TypeScript-authored contract. Example: postgres({ contract })\n * - Emitted: pass Contract type explicitly. Example: postgres<Contract>({ contractJson, url })\n */\nexport default function postgres<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptionsWithContract<TContract>,\n): PostgresClient<TContract>;\nexport default function postgres<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptionsWithContractJson<TContract>,\n): PostgresClient<TContract>;\nexport default function postgres<TContract extends Contract<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  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.middleware ? { middleware: options.middleware } : {}),\n    });\n\n    return runtimeInstance;\n  };\n  const orm: OrmClient<TContract> = ormBuilder({\n    runtime: {\n      execute(plan) {\n        return getRuntime().execute(plan);\n      },\n      connection() {\n        return getRuntime().connection();\n      },\n    },\n    context,\n  });\n\n  const sql: Db<TContract> = sqlBuilder<TContract>({ context });\n\n  return {\n    sql,\n    orm,\n    context,\n    stack,\n\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\n    runtime() {\n      return getRuntime();\n    },\n\n    transaction<R>(fn: (tx: PostgresTransactionContext<TContract>) => PromiseLike<R>): Promise<R> {\n      return withTransaction(getRuntime(), (txCtx) => {\n        const txSql: Db<TContract> = sqlBuilder<TContract>({ context });\n\n        const txOrm: OrmClient<TContract> = ormBuilder({\n          runtime: {\n            execute(plan) {\n              return txCtx.execute(plan);\n            },\n          },\n          context,\n        });\n\n        // Use `txCtx` as the prototype instead of spreading it so that live\n        // accessors (notably the `invalidated` getter, which reads a closure\n        // variable in `withTransaction`) remain wired to the original object.\n        // Spreading would evaluate the getter once and freeze its value.\n        const tx: PostgresTransactionContext<TContract> = Object.assign(\n          Object.create(txCtx) as TransactionContext,\n          { sql: txSql, orm: txOrm },\n        );\n\n        return fn(tx);\n      });\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"runtime.mjs","names":["PgPool","PgClient","orm","ormBuilder","sqlBuilder"],"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 type { Contract } from '@prisma-next/contract/types';\nimport postgresDriver from '@prisma-next/driver-postgres/runtime';\nimport { emptyCodecLookup } from '@prisma-next/framework-components/codec';\nimport { instantiateExecutionStack } from '@prisma-next/framework-components/execution';\nimport { sql as sqlBuilder } from '@prisma-next/sql-builder/runtime';\nimport type { Db } from '@prisma-next/sql-builder/types';\nimport type { SqlStorage } from '@prisma-next/sql-contract/types';\nimport { validateContract } from '@prisma-next/sql-contract/validate';\nimport { orm as ormBuilder } from '@prisma-next/sql-orm-client';\nimport type {\n  ExecutionContext,\n  Runtime,\n  RuntimeVerifyOptions,\n  SqlExecutionStackWithDriver,\n  SqlMiddleware,\n  SqlRuntimeExtensionDescriptor,\n  TransactionContext,\n} from '@prisma-next/sql-runtime';\nimport {\n  createExecutionContext,\n  createRuntime,\n  createSqlExecutionStack,\n  withTransaction,\n} from '@prisma-next/sql-runtime';\nimport postgresTarget from '@prisma-next/target-postgres/runtime';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { type Client, Pool } from 'pg';\nimport {\n  type PostgresBinding,\n  type PostgresBindingInput,\n  resolveOptionalPostgresBinding,\n  resolvePostgresBinding,\n} from './binding';\n\nexport type PostgresTargetId = 'postgres';\ntype OrmClient<TContract extends Contract<SqlStorage>> = ReturnType<typeof ormBuilder<TContract>>;\n\nexport interface PostgresTransactionContext<TContract extends Contract<SqlStorage>>\n  extends TransactionContext {\n  readonly sql: Db<TContract>;\n  readonly orm: OrmClient<TContract>;\n}\n\nexport interface PostgresClient<TContract extends Contract<SqlStorage>> {\n  readonly sql: Db<TContract>;\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  transaction<R>(fn: (tx: PostgresTransactionContext<TContract>) => PromiseLike<R>): Promise<R>;\n}\n\nexport interface PostgresOptionsBase {\n  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];\n  readonly middleware?: readonly SqlMiddleware[];\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 Contract<SqlStorage>> =\n  PostgresBindingOptions &\n    PostgresOptionsBase & {\n      readonly contract: TContract;\n      readonly contractJson?: never;\n    };\n\nexport type PostgresOptionsWithContractJson<TContract extends Contract<SqlStorage>> =\n  PostgresBindingOptions &\n    PostgresOptionsBase & {\n      readonly contractJson: unknown;\n      readonly contract?: never;\n      readonly _contract?: TContract;\n    };\n\nexport type PostgresOptions<TContract extends Contract<SqlStorage>> =\n  | PostgresOptionsWithContract<TContract>\n  | PostgresOptionsWithContractJson<TContract>;\n\nfunction hasContractJson<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): options is PostgresOptionsWithContractJson<TContract> {\n  return 'contractJson' in options;\n}\n\nfunction resolveContract<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): TContract {\n  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;\n  return validateContract<TContract>(contractInput, emptyCodecLookup);\n}\n\nfunction toRuntimeBinding<TContract extends Contract<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 *\n * - No-emit: pass a TypeScript-authored contract. Example: postgres({ contract })\n * - Emitted: pass Contract type explicitly. Example: postgres<Contract>({ contractJson, url })\n */\nexport default function postgres<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptionsWithContract<TContract>,\n): PostgresClient<TContract>;\nexport default function postgres<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptionsWithContractJson<TContract>,\n): PostgresClient<TContract>;\nexport default function postgres<TContract extends Contract<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  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      ...ifDefined('middleware', options.middleware),\n    });\n\n    return runtimeInstance;\n  };\n  const orm: OrmClient<TContract> = ormBuilder({\n    runtime: {\n      execute(plan) {\n        return getRuntime().execute(plan);\n      },\n      connection() {\n        return getRuntime().connection();\n      },\n    },\n    context,\n  });\n\n  const sql: Db<TContract> = sqlBuilder<TContract>({ context });\n\n  return {\n    sql,\n    orm,\n    context,\n    stack,\n\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\n    runtime() {\n      return getRuntime();\n    },\n\n    transaction<R>(fn: (tx: PostgresTransactionContext<TContract>) => PromiseLike<R>): Promise<R> {\n      return withTransaction(getRuntime(), (txCtx) => {\n        const txSql: Db<TContract> = sqlBuilder<TContract>({ context });\n\n        const txOrm: OrmClient<TContract> = ormBuilder({\n          runtime: {\n            execute(plan) {\n              return txCtx.execute(plan);\n            },\n          },\n          context,\n        });\n\n        // Use `txCtx` as the prototype instead of spreading it so that live\n        // accessors (notably the `invalidated` getter, which reads a closure\n        // variable in `withTransaction`) remain wired to the original object.\n        // Spreading would evaluate the getter once and freeze its value.\n        const tx: PostgresTransactionContext<TContract> = Object.assign(\n          Object.create(txCtx) as TransactionContext,\n          { sql: txSql, orm: txOrm },\n        );\n\n        return fn(tx);\n      });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/serverless.d.mts

@@ -0,0 +1,62 @@
+import { o as PostgresTargetId } from "./postgres-Bkdcp2EZ.mjs";
+import { PostgresDriverCreateOptions } from "@prisma-next/driver-postgres/runtime";
+import { ExecutionContext, Runtime, RuntimeVerifyOptions, SqlExecutionStackWithDriver, SqlMiddleware, SqlRuntimeExtensionDescriptor } from "@prisma-next/sql-runtime";
+import { Contract } from "@prisma-next/contract/types";
+import { Db } from "@prisma-next/sql-builder/types";
+import { SqlStorage } from "@prisma-next/sql-contract/types";
+
+//#region src/runtime/postgres-serverless.d.ts
+type PostgresServerlessCursorOptions = NonNullable<PostgresDriverCreateOptions['cursor']>;
+interface PostgresServerlessClient<TContract extends Contract<SqlStorage>> {
+  readonly sql: Db<TContract>;
+  readonly context: ExecutionContext<TContract>;
+  readonly stack: SqlExecutionStackWithDriver<PostgresTargetId>;
+  readonly contract: TContract;
+  connect(binding: {
+    readonly url: string;
+  }): Promise<Runtime & AsyncDisposable>;
+}
+interface PostgresServerlessOptionsBase {
+  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];
+  readonly middleware?: readonly SqlMiddleware[];
+  readonly verify?: RuntimeVerifyOptions;
+  readonly cursor?: PostgresServerlessCursorOptions;
+}
+type PostgresServerlessOptionsWithContract<TContract extends Contract<SqlStorage>> = PostgresServerlessOptionsBase & {
+  readonly contract: TContract;
+  readonly contractJson?: never;
+};
+type PostgresServerlessOptionsWithContractJson<TContract extends Contract<SqlStorage>> = PostgresServerlessOptionsBase & {
+  readonly contractJson: unknown;
+  readonly contract?: never;
+  readonly _contract?: TContract;
+};
+type PostgresServerlessOptions<TContract extends Contract<SqlStorage>> = PostgresServerlessOptionsWithContract<TContract> | PostgresServerlessOptionsWithContractJson<TContract>;
+/**
+ * Per-request Postgres facade for serverless / edge runtimes (Cloudflare Workers + Hyperdrive,
+ * AWS Lambda, Vercel, Deno Deploy, Bun edge, etc.).
+ *
+ * Construction shape mirrors the Node `postgres()` factory but the returned client deliberately
+ * omits `orm`, `runtime()`, and `transaction()`. Closure-cached convenience surfaces are unsafe
+ * across `fetch` invocations: stale connections after isolate idle, concurrent-query races on a
+ * shared `pg.Client`, no clean shutdown. Per-request callers acquire a fresh `Runtime` via
+ * `db.connect({ url })` and dispose it via `await using` on scope exit.
+ *
+ * @example
+ * ```ts
+ * const db = postgresServerless<Contract>({ contractJson });
+ *
+ * export default {
+ *   async fetch(_req: Request, env: Env): Promise<Response> {
+ *     await using runtime = await db.connect({ url: env.HYPERDRIVE.connectionString });
+ *     const rows = await runtime.execute(db.sql.from(t).select(...).build());
+ *     return Response.json(rows);
+ *   },
+ * };
+ * ```
+ */
+declare function postgresServerless<TContract extends Contract<SqlStorage>>(options: PostgresServerlessOptionsWithContract<TContract>): PostgresServerlessClient<TContract>;
+declare function postgresServerless<TContract extends Contract<SqlStorage>>(options: PostgresServerlessOptionsWithContractJson<TContract>): PostgresServerlessClient<TContract>;
+//#endregion
+export { type PostgresServerlessClient, type PostgresServerlessCursorOptions, type PostgresServerlessOptions, type PostgresServerlessOptionsBase, type PostgresServerlessOptionsWithContract, type PostgresServerlessOptionsWithContractJson, postgresServerless as default };
+//# sourceMappingURL=serverless.d.mts.map

package/dist/serverless.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverless.d.mts","names":[],"sources":["../src/runtime/postgres-serverless.ts"],"mappings":";;;;;;;;KA8BY,+BAAA,GAAkC,WAAA,CAAY,2BAAA;AAAA,UAEzC,wBAAA,mBAA2C,QAAA,CAAS,UAAA;EAAA,SAC1D,GAAA,EAAK,EAAA,CAAG,SAAA;EAAA,SACR,OAAA,EAAS,gBAAA,CAAiB,SAAA;EAAA,SAC1B,KAAA,EAAO,2BAAA,CAA4B,gBAAA;EAAA,SACnC,QAAA,EAAU,SAAA;EACnB,OAAA,CAAQ,OAAA;IAAA,SAAoB,GAAA;EAAA,IAAgB,OAAA,CAAQ,OAAA,GAAU,eAAA;AAAA;AAAA,UAG/C,6BAAA;EAAA,SACN,UAAA,YAAsB,6BAAA,CAA8B,gBAAA;EAAA,SACpD,UAAA,YAAsB,aAAA;EAAA,SACtB,MAAA,GAAS,oBAAA;EAAA,SACT,MAAA,GAAS,+BAAA;AAAA;AAAA,KAGR,qCAAA,mBAAwD,QAAA,CAAS,UAAA,KAC3E,6BAAA;EAAA,SACW,QAAA,EAAU,SAAA;EAAA,SACV,YAAA;AAAA;AAAA,KAGD,yCAAA,mBAA4D,QAAA,CAAS,UAAA,KAC/E,6BAAA;EAAA,SACW,YAAA;EAAA,SACA,QAAA;EAAA,SACA,SAAA,GAAY,SAAA;AAAA;AAAA,KAGb,yBAAA,mBAA4C,QAAA,CAAS,UAAA,KAC7D,qCAAA,CAAsC,SAAA,IACtC,yCAAA,CAA0C,SAAA;;;;;;;;;;;;;;;;;;;;;AAtB9C;;;iBAoEwB,kBAAA,mBAAqC,QAAA,CAAS,UAAA,EAAA,CACpE,OAAA,EAAS,qCAAA,CAAsC,SAAA,IAC9C,wBAAA,CAAyB,SAAA;AAAA,iBACJ,kBAAA,mBAAqC,QAAA,CAAS,UAAA,EAAA,CACpE,OAAA,EAAS,yCAAA,CAA0C,SAAA,IAClD,wBAAA,CAAyB,SAAA"}

package/dist/serverless.mjs

@@ -0,0 +1,80 @@
+import { ifDefined } from "@prisma-next/utils/defined";
+import postgresAdapter from "@prisma-next/adapter-postgres/runtime";
+import postgresDriver from "@prisma-next/driver-postgres/runtime";
+import { emptyCodecLookup } from "@prisma-next/framework-components/codec";
+import { instantiateExecutionStack } from "@prisma-next/framework-components/execution";
+import { sql } from "@prisma-next/sql-builder/runtime";
+import { validateContract } from "@prisma-next/sql-contract/validate";
+import { createExecutionContext, createRuntime, createSqlExecutionStack } from "@prisma-next/sql-runtime";
+import postgresTarget from "@prisma-next/target-postgres/runtime";
+import { Client } from "pg";
+//#region src/runtime/postgres-serverless.ts
+function hasContractJson(options) {
+	return "contractJson" in options;
+}
+function resolveContract(options) {
+	return validateContract(hasContractJson(options) ? options.contractJson : options.contract, emptyCodecLookup);
+}
+function validateConnectionString(url) {
+	const trimmed = url.trim();
+	if (trimmed.length === 0) throw new Error("Postgres URL must be a non-empty string");
+	return trimmed;
+}
+function postgresServerless(options) {
+	const contract = resolveContract(options);
+	const stack = createSqlExecutionStack({
+		target: postgresTarget,
+		adapter: postgresAdapter,
+		driver: postgresDriver,
+		extensionPacks: options.extensions ?? []
+	});
+	const context = createExecutionContext({
+		contract,
+		stack
+	});
+	return {
+		sql: sql({ context }),
+		context,
+		stack,
+		contract,
+		async connect(binding) {
+			const url = validateConnectionString(binding.url);
+			const driverDescriptor = stack.driver;
+			if (!driverDescriptor) throw new Error("Driver descriptor missing from execution stack");
+			const stackInstance = instantiateExecutionStack(stack);
+			const driver = driverDescriptor.create({ ...ifDefined("cursor", options.cursor) });
+			const client = new Client({ connectionString: url });
+			await driver.connect({
+				kind: "pgClient",
+				client
+			});
+			let runtime;
+			try {
+				runtime = createRuntime({
+					stackInstance,
+					context,
+					driver,
+					verify: options.verify ?? {
+						mode: "onFirstUse",
+						requireMarker: false
+					},
+					...ifDefined("middleware", options.middleware)
+				});
+			} catch (err) {
+				await driver.close().catch(() => void 0);
+				throw err;
+			}
+			Object.defineProperty(runtime, Symbol.asyncDispose, {
+				value: () => runtime.close(),
+				configurable: true,
+				writable: false,
+				enumerable: false
+			});
+			return runtime;
+		}
+	};
+}
+//#endregion
+export { postgresServerless as default };
+
+//# sourceMappingURL=serverless.mjs.map

package/dist/serverless.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverless.mjs","names":["sqlBuilder"],"sources":["../src/runtime/postgres-serverless.ts"],"sourcesContent":["import postgresAdapter from '@prisma-next/adapter-postgres/runtime';\nimport type { Contract } from '@prisma-next/contract/types';\nimport postgresDriver, {\n  type PostgresDriverCreateOptions,\n} from '@prisma-next/driver-postgres/runtime';\nimport { emptyCodecLookup } from '@prisma-next/framework-components/codec';\nimport { instantiateExecutionStack } from '@prisma-next/framework-components/execution';\nimport { sql as sqlBuilder } from '@prisma-next/sql-builder/runtime';\nimport type { Db } from '@prisma-next/sql-builder/types';\nimport type { SqlStorage } from '@prisma-next/sql-contract/types';\nimport { validateContract } from '@prisma-next/sql-contract/validate';\nimport type {\n  ExecutionContext,\n  Runtime,\n  RuntimeVerifyOptions,\n  SqlExecutionStackWithDriver,\n  SqlMiddleware,\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 { ifDefined } from '@prisma-next/utils/defined';\nimport { Client } from 'pg';\n\nimport type { PostgresTargetId } from './postgres';\n\nexport type PostgresServerlessCursorOptions = NonNullable<PostgresDriverCreateOptions['cursor']>;\n\nexport interface PostgresServerlessClient<TContract extends Contract<SqlStorage>> {\n  readonly sql: Db<TContract>;\n  readonly context: ExecutionContext<TContract>;\n  readonly stack: SqlExecutionStackWithDriver<PostgresTargetId>;\n  readonly contract: TContract;\n  connect(binding: { readonly url: string }): Promise<Runtime & AsyncDisposable>;\n}\n\nexport interface PostgresServerlessOptionsBase {\n  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];\n  readonly middleware?: readonly SqlMiddleware[];\n  readonly verify?: RuntimeVerifyOptions;\n  readonly cursor?: PostgresServerlessCursorOptions;\n}\n\nexport type PostgresServerlessOptionsWithContract<TContract extends Contract<SqlStorage>> =\n  PostgresServerlessOptionsBase & {\n    readonly contract: TContract;\n    readonly contractJson?: never;\n  };\n\nexport type PostgresServerlessOptionsWithContractJson<TContract extends Contract<SqlStorage>> =\n  PostgresServerlessOptionsBase & {\n    readonly contractJson: unknown;\n    readonly contract?: never;\n    readonly _contract?: TContract;\n  };\n\nexport type PostgresServerlessOptions<TContract extends Contract<SqlStorage>> =\n  | PostgresServerlessOptionsWithContract<TContract>\n  | PostgresServerlessOptionsWithContractJson<TContract>;\n\nfunction hasContractJson<TContract extends Contract<SqlStorage>>(\n  options: PostgresServerlessOptions<TContract>,\n): options is PostgresServerlessOptionsWithContractJson<TContract> {\n  return 'contractJson' in options;\n}\n\nfunction resolveContract<TContract extends Contract<SqlStorage>>(\n  options: PostgresServerlessOptions<TContract>,\n): TContract {\n  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;\n  return validateContract<TContract>(contractInput, emptyCodecLookup);\n}\n\nfunction validateConnectionString(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  return trimmed;\n}\n\n/**\n * Per-request Postgres facade for serverless / edge runtimes (Cloudflare Workers + Hyperdrive,\n * AWS Lambda, Vercel, Deno Deploy, Bun edge, etc.).\n *\n * Construction shape mirrors the Node `postgres()` factory but the returned client deliberately\n * omits `orm`, `runtime()`, and `transaction()`. Closure-cached convenience surfaces are unsafe\n * across `fetch` invocations: stale connections after isolate idle, concurrent-query races on a\n * shared `pg.Client`, no clean shutdown. Per-request callers acquire a fresh `Runtime` via\n * `db.connect({ url })` and dispose it via `await using` on scope exit.\n *\n * @example\n * ```ts\n * const db = postgresServerless<Contract>({ contractJson });\n *\n * export default {\n *   async fetch(_req: Request, env: Env): Promise<Response> {\n *     await using runtime = await db.connect({ url: env.HYPERDRIVE.connectionString });\n *     const rows = await runtime.execute(db.sql.from(t).select(...).build());\n *     return Response.json(rows);\n *   },\n * };\n * ```\n */\nexport default function postgresServerless<TContract extends Contract<SqlStorage>>(\n  options: PostgresServerlessOptionsWithContract<TContract>,\n): PostgresServerlessClient<TContract>;\nexport default function postgresServerless<TContract extends Contract<SqlStorage>>(\n  options: PostgresServerlessOptionsWithContractJson<TContract>,\n): PostgresServerlessClient<TContract>;\nexport default function postgresServerless<TContract extends Contract<SqlStorage>>(\n  options: PostgresServerlessOptions<TContract>,\n): PostgresServerlessClient<TContract> {\n  const contract = resolveContract(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 sql: Db<TContract> = sqlBuilder<TContract>({ context });\n\n  return {\n    sql,\n    context,\n    stack,\n    contract,\n\n    async connect(binding) {\n      const url = validateConnectionString(binding.url);\n\n      const driverDescriptor = stack.driver;\n      if (!driverDescriptor) {\n        throw new Error('Driver descriptor missing from execution stack');\n      }\n\n      const stackInstance = instantiateExecutionStack(stack);\n      const driver = driverDescriptor.create({\n        ...ifDefined('cursor', options.cursor),\n      });\n\n      const client = new Client({ connectionString: url });\n      await driver.connect({ kind: 'pgClient', client });\n\n      let runtime: Runtime;\n      try {\n        runtime = createRuntime({\n          stackInstance,\n          context,\n          driver,\n          verify: options.verify ?? { mode: 'onFirstUse', requireMarker: false },\n          ...ifDefined('middleware', options.middleware),\n        });\n      } catch (err) {\n        // The driver is bound to the pg.Client at this point; without a runtime\n        // to wrap it, the caller has no handle to dispose. Close the driver so\n        // the underlying pg.Client is released even if its TCP socket has not\n        // yet opened (lazy connect): keeps cleanup symmetric with successful\n        // construction and prevents real socket leaks if pg ever changes its\n        // connect semantics.\n        await driver.close().catch(() => undefined);\n        throw err;\n      }\n\n      Object.defineProperty(runtime, Symbol.asyncDispose, {\n        value: () => runtime.close(),\n        configurable: true,\n        writable: false,\n        enumerable: false,\n      });\n\n      return runtime as Runtime & AsyncDisposable;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;AAgEA,SAAS,gBACP,SACiE;CACjE,OAAO,kBAAkB;;AAG3B,SAAS,gBACP,SACW;CAEX,OAAO,iBADe,gBAAgB,QAAQ,GAAG,QAAQ,eAAe,QAAQ,UAC9B,iBAAiB;;AAGrE,SAAS,yBAAyB,KAAqB;CACrD,MAAM,UAAU,IAAI,MAAM;CAC1B,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,MAAM,0CAA0C;CAE5D,OAAO;;AAgCT,SAAwB,mBACtB,SACqC;CACrC,MAAM,WAAW,gBAAgB,QAAQ;CACzC,MAAM,QAAQ,wBAAwB;EACpC,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,gBAAgB,QAAQ,cAAc,EAAE;EACzC,CAAC;CAEF,MAAM,UAAU,uBAAuB;EACrC;EACA;EACD,CAAC;CAIF,OAAO;EACL,KAHyBA,IAAsB,EAAE,SAAS,CAGvD;EACH;EACA;EACA;EAEA,MAAM,QAAQ,SAAS;GACrB,MAAM,MAAM,yBAAyB,QAAQ,IAAI;GAEjD,MAAM,mBAAmB,MAAM;GAC/B,IAAI,CAAC,kBACH,MAAM,IAAI,MAAM,iDAAiD;GAGnE,MAAM,gBAAgB,0BAA0B,MAAM;GACtD,MAAM,SAAS,iBAAiB,OAAO,EACrC,GAAG,UAAU,UAAU,QAAQ,OAAO,EACvC,CAAC;GAEF,MAAM,SAAS,IAAI,OAAO,EAAE,kBAAkB,KAAK,CAAC;GACpD,MAAM,OAAO,QAAQ;IAAE,MAAM;IAAY;IAAQ,CAAC;GAElD,IAAI;GACJ,IAAI;IACF,UAAU,cAAc;KACtB;KACA;KACA;KACA,QAAQ,QAAQ,UAAU;MAAE,MAAM;MAAc,eAAe;MAAO;KACtE,GAAG,UAAU,cAAc,QAAQ,WAAW;KAC/C,CAAC;YACK,KAAK;IAOZ,MAAM,OAAO,OAAO,CAAC,YAAY,KAAA,EAAU;IAC3C,MAAM;;GAGR,OAAO,eAAe,SAAS,OAAO,cAAc;IAClD,aAAa,QAAQ,OAAO;IAC5B,cAAc;IACd,UAAU;IACV,YAAY;IACb,CAAC;GAEF,OAAO;;EAEV"}

package/dist/target.d.mts

@@ -0,0 +1,2 @@
+import pack_default from "@prisma-next/target-postgres/pack";
+export { pack_default as default };

package/dist/target.mjs

@@ -0,0 +1,2 @@
+import pack_default from "@prisma-next/target-postgres/pack";
+export { pack_default as default };

package/package.json

@@ -1,36 +1,37 @@
 {
   "name": "@prisma-next/postgres",
-  "version": "0.5.0-dev.8",
+  "version": "0.5.0-dev.87",
+  "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "One-liner lazy Postgres client composition for Prisma Next",
   "dependencies": {
     "pathe": "^2.0.3",
-    "pg": "8.16.3",
-    "@prisma-next/config": "0.5.0-dev.8",
-    "@prisma-next/adapter-postgres": "0.5.0-dev.8",
-    "@prisma-next/contract": "0.5.0-dev.8",
-    "@prisma-next/family-sql": "0.5.0-dev.8",
-    "@prisma-next/driver-postgres": "0.5.0-dev.8",
-    "@prisma-next/framework-components": "0.5.0-dev.8",
-    "@prisma-next/sql-contract": "0.5.0-dev.8",
-    "@prisma-next/sql-contract-psl": "0.5.0-dev.8",
-    "@prisma-next/sql-contract-ts": "0.5.0-dev.8",
-    "@prisma-next/sql-orm-client": "0.5.0-dev.8",
-    "@prisma-next/sql-relational-core": "0.5.0-dev.8",
-    "@prisma-next/sql-builder": "0.5.0-dev.8",
-    "@prisma-next/target-postgres": "0.5.0-dev.8",
-    "@prisma-next/sql-runtime": "0.5.0-dev.8",
-    "@prisma-next/utils": "0.5.0-dev.8"
+    "pg": "8.20.0",
+    "@prisma-next/config": "0.5.0-dev.87",
+    "@prisma-next/driver-postgres": "0.5.0-dev.87",
+    "@prisma-next/family-sql": "0.5.0-dev.87",
+    "@prisma-next/framework-components": "0.5.0-dev.87",
+    "@prisma-next/sql-contract": "0.5.0-dev.87",
+    "@prisma-next/contract": "0.5.0-dev.87",
+    "@prisma-next/sql-contract-psl": "0.5.0-dev.87",
+    "@prisma-next/adapter-postgres": "0.5.0-dev.87",
+    "@prisma-next/sql-orm-client": "0.5.0-dev.87",
+    "@prisma-next/sql-contract-ts": "0.5.0-dev.87",
+    "@prisma-next/sql-relational-core": "0.5.0-dev.87",
+    "@prisma-next/sql-builder": "0.5.0-dev.87",
+    "@prisma-next/sql-runtime": "0.5.0-dev.87",
+    "@prisma-next/target-postgres": "0.5.0-dev.87",
+    "@prisma-next/utils": "0.5.0-dev.87"
   },
   "devDependencies": {
-    "@types/pg": "8.16.0",
-    "tsdown": "0.18.4",
+    "@types/pg": "8.20.0",
+    "tsdown": "0.22.0",
     "typescript": "5.9.3",
-    "vitest": "4.0.17",
+    "vitest": "4.1.5",
     "@prisma-next/test-utils": "0.0.1",
-    "@prisma-next/tsdown": "0.0.0",
-    "@prisma-next/tsconfig": "0.0.0"
+    "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/tsdown": "0.0.0"
   },
   "files": [
     "dist",
@@ -46,11 +47,13 @@
   },
   "exports": {
     "./config": "./dist/config.mjs",
+    "./contract-builder": "./dist/contract-builder.mjs",
+    "./family": "./dist/family.mjs",
     "./runtime": "./dist/runtime.mjs",
+    "./serverless": "./dist/serverless.mjs",
+    "./target": "./dist/target.mjs",
     "./package.json": "./package.json"
   },
-  "main": "./dist/runtime.mjs",
-  "module": "./dist/runtime.mjs",
   "types": "./dist/runtime.d.mts",
   "scripts": {
     "build": "tsdown",

package/src/exports/contract-builder.ts

@@ -0,0 +1,21 @@
+export type {
+  ComposedAuthoringHelpers,
+  ContractDefinition,
+  ContractInput,
+  ContractModelBuilder,
+  FieldNode,
+  ForeignKeyNode,
+  IndexNode,
+  ModelNode,
+  PrimaryKeyNode,
+  RelationNode,
+  ScalarFieldBuilder,
+  UniqueConstraintNode,
+} from '@prisma-next/sql-contract-ts/contract-builder';
+export {
+  buildSqlContractFromDefinition,
+  defineContract,
+  field,
+  model,
+  rel,
+} from '@prisma-next/sql-contract-ts/contract-builder';

package/src/exports/family.ts

@@ -0,0 +1 @@
+export { default } from '@prisma-next/family-sql/pack';

package/src/exports/serverless.ts

@@ -0,0 +1,9 @@
+export type {
+  PostgresServerlessClient,
+  PostgresServerlessCursorOptions,
+  PostgresServerlessOptions,
+  PostgresServerlessOptionsBase,
+  PostgresServerlessOptionsWithContract,
+  PostgresServerlessOptionsWithContractJson,
+} from '../runtime/postgres-serverless';
+export { default } from '../runtime/postgres-serverless';

package/src/exports/target.ts

@@ -0,0 +1 @@
+export { default } from '@prisma-next/target-postgres/pack';

package/src/runtime/postgres-serverless.ts

@@ -0,0 +1,185 @@
+import postgresAdapter from '@prisma-next/adapter-postgres/runtime';
+import type { Contract } from '@prisma-next/contract/types';
+import postgresDriver, {
+  type PostgresDriverCreateOptions,
+} from '@prisma-next/driver-postgres/runtime';
+import { emptyCodecLookup } from '@prisma-next/framework-components/codec';
+import { instantiateExecutionStack } from '@prisma-next/framework-components/execution';
+import { sql as sqlBuilder } from '@prisma-next/sql-builder/runtime';
+import type { Db } from '@prisma-next/sql-builder/types';
+import type { SqlStorage } from '@prisma-next/sql-contract/types';
+import { validateContract } from '@prisma-next/sql-contract/validate';
+import type {
+  ExecutionContext,
+  Runtime,
+  RuntimeVerifyOptions,
+  SqlExecutionStackWithDriver,
+  SqlMiddleware,
+  SqlRuntimeExtensionDescriptor,
+} from '@prisma-next/sql-runtime';
+import {
+  createExecutionContext,
+  createRuntime,
+  createSqlExecutionStack,
+} from '@prisma-next/sql-runtime';
+import postgresTarget from '@prisma-next/target-postgres/runtime';
+import { ifDefined } from '@prisma-next/utils/defined';
+import { Client } from 'pg';
+
+import type { PostgresTargetId } from './postgres';
+
+export type PostgresServerlessCursorOptions = NonNullable<PostgresDriverCreateOptions['cursor']>;
+
+export interface PostgresServerlessClient<TContract extends Contract<SqlStorage>> {
+  readonly sql: Db<TContract>;
+  readonly context: ExecutionContext<TContract>;
+  readonly stack: SqlExecutionStackWithDriver<PostgresTargetId>;
+  readonly contract: TContract;
+  connect(binding: { readonly url: string }): Promise<Runtime & AsyncDisposable>;
+}
+
+export interface PostgresServerlessOptionsBase {
+  readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];
+  readonly middleware?: readonly SqlMiddleware[];
+  readonly verify?: RuntimeVerifyOptions;
+  readonly cursor?: PostgresServerlessCursorOptions;
+}
+
+export type PostgresServerlessOptionsWithContract<TContract extends Contract<SqlStorage>> =
+  PostgresServerlessOptionsBase & {
+    readonly contract: TContract;
+    readonly contractJson?: never;
+  };
+
+export type PostgresServerlessOptionsWithContractJson<TContract extends Contract<SqlStorage>> =
+  PostgresServerlessOptionsBase & {
+    readonly contractJson: unknown;
+    readonly contract?: never;
+    readonly _contract?: TContract;
+  };
+
+export type PostgresServerlessOptions<TContract extends Contract<SqlStorage>> =
+  | PostgresServerlessOptionsWithContract<TContract>
+  | PostgresServerlessOptionsWithContractJson<TContract>;
+
+function hasContractJson<TContract extends Contract<SqlStorage>>(
+  options: PostgresServerlessOptions<TContract>,
+): options is PostgresServerlessOptionsWithContractJson<TContract> {
+  return 'contractJson' in options;
+}
+
+function resolveContract<TContract extends Contract<SqlStorage>>(
+  options: PostgresServerlessOptions<TContract>,
+): TContract {
+  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;
+  return validateContract<TContract>(contractInput, emptyCodecLookup);
+}
+
+function validateConnectionString(url: string): string {
+  const trimmed = url.trim();
+  if (trimmed.length === 0) {
+    throw new Error('Postgres URL must be a non-empty string');
+  }
+  return trimmed;
+}
+
+/**
+ * Per-request Postgres facade for serverless / edge runtimes (Cloudflare Workers + Hyperdrive,
+ * AWS Lambda, Vercel, Deno Deploy, Bun edge, etc.).
+ *
+ * Construction shape mirrors the Node `postgres()` factory but the returned client deliberately
+ * omits `orm`, `runtime()`, and `transaction()`. Closure-cached convenience surfaces are unsafe
+ * across `fetch` invocations: stale connections after isolate idle, concurrent-query races on a
+ * shared `pg.Client`, no clean shutdown. Per-request callers acquire a fresh `Runtime` via
+ * `db.connect({ url })` and dispose it via `await using` on scope exit.
+ *
+ * @example
+ * ```ts
+ * const db = postgresServerless<Contract>({ contractJson });
+ *
+ * export default {
+ *   async fetch(_req: Request, env: Env): Promise<Response> {
+ *     await using runtime = await db.connect({ url: env.HYPERDRIVE.connectionString });
+ *     const rows = await runtime.execute(db.sql.from(t).select(...).build());
+ *     return Response.json(rows);
+ *   },
+ * };
+ * ```
+ */
+export default function postgresServerless<TContract extends Contract<SqlStorage>>(
+  options: PostgresServerlessOptionsWithContract<TContract>,
+): PostgresServerlessClient<TContract>;
+export default function postgresServerless<TContract extends Contract<SqlStorage>>(
+  options: PostgresServerlessOptionsWithContractJson<TContract>,
+): PostgresServerlessClient<TContract>;
+export default function postgresServerless<TContract extends Contract<SqlStorage>>(
+  options: PostgresServerlessOptions<TContract>,
+): PostgresServerlessClient<TContract> {
+  const contract = resolveContract(options);
+  const stack = createSqlExecutionStack({
+    target: postgresTarget,
+    adapter: postgresAdapter,
+    driver: postgresDriver,
+    extensionPacks: options.extensions ?? [],
+  });
+
+  const context = createExecutionContext({
+    contract,
+    stack,
+  });
+
+  const sql: Db<TContract> = sqlBuilder<TContract>({ context });
+
+  return {
+    sql,
+    context,
+    stack,
+    contract,
+
+    async connect(binding) {
+      const url = validateConnectionString(binding.url);
+
+      const driverDescriptor = stack.driver;
+      if (!driverDescriptor) {
+        throw new Error('Driver descriptor missing from execution stack');
+      }
+
+      const stackInstance = instantiateExecutionStack(stack);
+      const driver = driverDescriptor.create({
+        ...ifDefined('cursor', options.cursor),
+      });
+
+      const client = new Client({ connectionString: url });
+      await driver.connect({ kind: 'pgClient', client });
+
+      let runtime: Runtime;
+      try {
+        runtime = createRuntime({
+          stackInstance,
+          context,
+          driver,
+          verify: options.verify ?? { mode: 'onFirstUse', requireMarker: false },
+          ...ifDefined('middleware', options.middleware),
+        });
+      } catch (err) {
+        // The driver is bound to the pg.Client at this point; without a runtime
+        // to wrap it, the caller has no handle to dispose. Close the driver so
+        // the underlying pg.Client is released even if its TCP socket has not
+        // yet opened (lazy connect): keeps cleanup symmetric with successful
+        // construction and prevents real socket leaks if pg ever changes its
+        // connect semantics.
+        await driver.close().catch(() => undefined);
+        throw err;
+      }
+
+      Object.defineProperty(runtime, Symbol.asyncDispose, {
+        value: () => runtime.close(),
+        configurable: true,
+        writable: false,
+        enumerable: false,
+      });
+
+      return runtime as Runtime & AsyncDisposable;
+    },
+  };
+}

package/src/runtime/postgres.ts

@@ -24,6 +24,7 @@ import {
   withTransaction,
 } from '@prisma-next/sql-runtime';
 import postgresTarget from '@prisma-next/target-postgres/runtime';
+import { ifDefined } from '@prisma-next/utils/defined';
 import { type Client, Pool } from 'pg';
 import {
   type PostgresBinding,
@@ -200,7 +201,7 @@ export default function postgres<TContract extends Contract<SqlStorage>>(
       context,
       driver,
       verify: options.verify ?? { mode: 'onFirstUse', requireMarker: false },
-      ...(options.middleware ? { middleware: options.middleware } : {}),
+      ...ifDefined('middleware', options.middleware),
     });
 
     return runtimeInstance;

package/dist/runtime.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime/binding.ts","../src/runtime/postgres.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAGY,eAAA;;;;;iBAEkC;;EAFlC,SAAA,IAAA,EAAA,UAAe;EAKf,SAAA,MAAA,EAFsC,MAElB;CAER;AAUL,KAZP,oBAAA,GAYO;EAAO,SAAA,OAAA,EAVF,eAUE;EAAM,SAAA,GAAA,CAAA,EAAA,KAAA;;;;ECcpB,SAAA,OAAA,CAAA,EAAgB,KAAA;EACvB,SAAA,EAAA,CAAS,EAAA,KAAA;CAA4B,GAAA;EAAT,SAAA,EAAA,EDfd,ICec,GDfP,MCeO;EAAqD,SAAA,OAAA,CAAA,EAAA,KAAA;EAAX,SAAA,GAAA,CAAA,EAAA,KAAA;CAAlB;;;KAD7C,gBAAA;AD/BZ,KCgCK,SDhCO,CAAA,kBCgCqB,QD7BiB,CC6BR,UD7Bc,CAAA,CAAA,GC6BC,UD7BD,CAAA,OC6BmB,GD7BnB,CC6B8B,SD7B9B,CAAA,CAAA;AAE5C,UC6BK,0BD7Be,CAAA,kBC6B8B,QD7B9B,CC6BuC,UD7BvC,CAAA,CAAA,SC8BtB,kBD9BsB,CAAA;EAER,SAAA,GAAA,EC6BR,ED7BQ,CC6BL,SD7BK,CAAA;EAUL,SAAA,GAAA,ECoBH,SDpBG,CCoBO,SDpBP,CAAA;;AAAa,UCuBf,cDvBe,CAAA,kBCuBkB,QDvBlB,CCuB2B,UDvB3B,CAAA,CAAA,CAAA;gBCwBhB,GAAG;gBACH,UAAU;oBACN,iBAAiB;EAZzB,SAAA,KAAA,EAaM,2BAbU,CAakB,gBAblB,CAAA;EACvB,OAAA,CAAA,YAAS,CAAA,EAaW,oBAbX,CAAA,EAakC,OAblC,CAa0C,OAb1C,CAAA;EAA4B,OAAA,EAAA,EAc7B,OAd6B;EAAT,WAAA,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,EAAA,EAeP,0BAfO,CAeoB,SAfpB,CAAA,EAAA,GAemC,WAfnC,CAe+C,CAf/C,CAAA,CAAA,EAeoD,OAfpD,CAe4D,CAf5D,CAAA;;AAA0C,UAkB1D,mBAAA,CAlB0D;EAAlB,SAAA,UAAA,CAAA,EAAA,SAmBxB,6BAnBwB,CAmBM,gBAnBN,CAAA,EAAA;EAAU,SAAA,UAAA,CAAA,EAAA,SAoBlC,aApBkC,EAAA;EAElD,SAAA,MAAA,CAAA,EAmBG,oBAnBuB;EAA4B,SAAA,WAAA,CAAA,EAAA;IAAT,SAAA,uBAAA,CAAA,EAAA,MAAA;IAE3C,SAAA,iBAAA,CAAA,EAAA,MAAA;EAAH,CAAA;;AACA,UAuBC,sBAAA,CAvBD;EAFN,SAAA,OAAA,CAAA,EA0BW,eA1BX;EAAkB,SAAA,GAAA,CAAA,EAAA,MAAA;EAKX,SAAA,EAAA,CAAA,EAuBD,IAvBe,GAuBR,MAvBQ;;AAAmB,KA0BtC,2BA1BsC,CAAA,kBA0BQ,QA1BR,CA0BiB,UA1BjB,CAAA,CAAA,GA2BhD,sBA3BgD,GA4B9C,mBA5B8C,GAAA;EAC/B,SAAA,QAAA,EA4BM,SA5BN;EAAH,SAAA,YAAA,CAAA,EAAA,KAAA;CACU;AAAV,KA+BJ,+BA/BI,CAAA,kBA+B8C,QA/B9C,CA+BuD,UA/BvD,CAAA,CAAA,GAgCd,sBAhCc,GAiCZ,mBAjCY,GAAA;EACqB,SAAA,YAAA,EAAA,OAAA;EAAjB,SAAA,QAAA,CAAA,EAAA,KAAA;EAC0B,SAAA,SAAA,CAAA,EAkCnB,SAlCmB;CAA5B;AACO,KAoCb,eApCa,CAAA,kBAoCqB,QApCrB,CAoC8B,UApC9B,CAAA,CAAA,GAqCrB,2BArCqB,CAqCO,SArCP,CAAA,GAsCrB,+BAtCqB,CAsCW,SAtCX,CAAA;;;;;;;;AAEoE,iBA4ErE,QA5EqE,CAAA,kBA4E1C,QA5E0C,CA4EjC,UA5EiC,CAAA,CAAA,CAAA,OAAA,EA6ElF,2BA7EkF,CA6EtD,SA7EsD,CAAA,CAAA,EA8E1F,cA9E0F,CA8E3E,SA9E2E,CAAA;AAAR,iBA+E7D,QA/E6D,CAAA,kBA+ElC,QA/EkC,CA+EzB,UA/EyB,CAAA,CAAA,CAAA,OAAA,EAgF1E,+BAhF0E,CAgF1C,SAhF0C,CAAA,CAAA,EAiFlF,cAjFkF,CAiFnE,SAjFmE,CAAA"}