@prisma-next/postgres 0.10.0 → 0.11.0

package/README.md

@@ -85,7 +85,35 @@ When URL binding is used, pool timeouts are configurable via `poolOptions`:
 
 ### `@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.
+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. The `defineContract` export is a Postgres-specific wrapper that pre-binds `family` and `target` — callers do not pass those fields:
+
+```typescript
+import { defineContract, field, model } from '@prisma-next/postgres/contract-builder';
+
+export const contract = defineContract(
+  { extensionPacks: {} },
+  ({ field: f, model: m }) => ({
+    models: {
+      User: m('User', { fields: { id: f.id.uuidv4() } }),
+    },
+  }),
+);
+```
+
+### `@prisma-next/postgres/migration`
+
+Re-exports everything from `@prisma-next/target-postgres/migration` so a user-authored `migration.ts` file can import its base class, CLI runner, and operation helpers from the single Postgres facade:
+
+```typescript
+import { Migration, MigrationCLI, addColumn, createTable } from '@prisma-next/postgres/migration';
+
+export default class M extends Migration {
+  up() {
+    return [createTable('users', ...)];
+  }
+}
+MigrationCLI.run(import.meta.url, M);
+```
 
 ### `@prisma-next/postgres/family`
 

package/dist/contract-builder.d.mts

@@ -1,2 +1,29 @@
-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 };
+import { ComposedAuthoringHelpers, ComposedAuthoringHelpers as ComposedAuthoringHelpers$1, ContractDefinition, ContractInput, ContractInput as ContractInput$1, ContractModelBuilder, FieldNode, ForeignKeyNode, IndexNode, ModelLike, ModelNode, PrimaryKeyNode, RelationNode, ScalarFieldBuilder, UniqueConstraintNode, buildSqlContractFromDefinition, defineContract as defineContract$1, field, model, rel } from "@prisma-next/sql-contract-ts/contract-builder";
+import sqlFamilyPack from "@prisma-next/family-sql/pack";
+import postgresPack from "@prisma-next/target-postgres/pack";
+import { ExtensionPackRef } from "@prisma-next/framework-components/components";
+import { PostgresEnumStorageEntry, StorageTypeInstance } from "@prisma-next/sql-contract/types";
+
+//#region src/contract/define-contract.d.ts
+type SqlFamily = typeof sqlFamilyPack;
+type PostgresPack = typeof postgresPack;
+type TypesConstraint = Record<string, StorageTypeInstance | PostgresEnumStorageEntry>;
+type ModelsConstraint = Record<string, ModelLike>;
+type PostgresResult<Types extends TypesConstraint, Models extends ModelsConstraint, ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined> = Omit<ReturnType<typeof defineContract$1<SqlFamily, PostgresPack, Types, Models, ExtensionPacks, Capabilities>>, 'target' | 'targetFamily'> & {
+  readonly target: PostgresPack['targetId'];
+  readonly targetFamily: SqlFamily['familyId'];
+};
+type PostgresBaseScaffold<ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined> = Omit<ContractInput$1<SqlFamily, PostgresPack, Record<never, never>, Record<never, never>, ExtensionPacks, Capabilities>, 'family' | 'target' | 'types' | 'models'>;
+type PostgresDefinition<Types extends TypesConstraint, Models extends ModelsConstraint, ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined> = PostgresBaseScaffold<ExtensionPacks, Capabilities> & {
+  readonly types?: Types;
+  readonly models?: Models;
+};
+type PostgresScaffold<ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined> = PostgresBaseScaffold<ExtensionPacks, Capabilities>;
+declare function defineContract<const Types extends TypesConstraint = Record<never, never>, const Models extends ModelsConstraint = Record<never, never>, const ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined = undefined, const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined>(definition: PostgresDefinition<Types, Models, ExtensionPacks, Capabilities>): PostgresResult<Types, Models, ExtensionPacks, Capabilities>;
+declare function defineContract<const Types extends TypesConstraint = Record<never, never>, const Models extends ModelsConstraint = Record<never, never>, const ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined = undefined, const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined>(scaffold: PostgresScaffold<ExtensionPacks, Capabilities>, factory: (helpers: ComposedAuthoringHelpers$1<SqlFamily, PostgresPack, ExtensionPacks>) => {
+  readonly types?: Types;
+  readonly models?: Models;
+}): PostgresResult<Types, Models, ExtensionPacks, Capabilities>;
+//#endregion
+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 };
+//# sourceMappingURL=contract-builder.d.mts.map

package/dist/contract-builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-builder.d.mts","names":[],"sources":["../src/contract/define-contract.ts"],"mappings":";;;;;;;KAcK,SAAA,UAAmB,aAAA;AAAA,KACnB,YAAA,UAAsB,YAAA;AAAA,KAEtB,eAAA,GAAkB,MAAA,SAAe,mBAAA,GAAsB,wBAAA;AAAA,KACvD,gBAAA,GAAmB,MAAA,SAAe,SAAA;AAAA,KAMlC,cAAA,eACW,eAAA,iBACC,gBAAA,yBACQ,MAAA,SAAe,gBAAA,mDACjB,MAAA,SAAe,MAAA,kCAClC,IAAA,CACF,UAAA,QACS,gBAAA,CAAmB,SAAA,EAAW,YAAA,EAAc,KAAA,EAAO,MAAA,EAAQ,cAAA,EAAgB,YAAA;EAAA,SAI3E,MAAA,EAAQ,YAAA;EAAA,SACR,YAAA,EAAc,SAAA;AAAA;AAAA,KAMpB,oBAAA,wBACoB,MAAA,SAAe,gBAAA,mDACjB,MAAA,SAAe,MAAA,kCAClC,IAAA,CACF,eAAA,CACE,SAAA,EACA,YAAA,EACA,MAAA,gBACA,MAAA,gBACA,cAAA,EACA,YAAA;AAAA,KAMC,kBAAA,eACW,eAAA,iBACC,gBAAA,yBACQ,MAAA,SAAe,gBAAA,mDACjB,MAAA,SAAe,MAAA,kCAClC,oBAAA,CAAqB,cAAA,EAAgB,YAAA;EAAA,SAC9B,KAAA,GAAQ,KAAA;EAAA,SACR,MAAA,GAAS,MAAA;AAAA;AAAA,KAIf,gBAAA,wBACoB,MAAA,SAAe,gBAAA,mDACjB,MAAA,SAAe,MAAA,kCAClC,oBAAA,CAAqB,cAAA,EAAgB,YAAA;AAAA,iBAGzB,cAAA,qBACM,eAAA,GAAkB,MAAA,qCACjB,gBAAA,GAAmB,MAAA,6CAEpC,MAAA,SAAe,gBAAA,qEAEQ,MAAA,SAAe,MAAA,2CAAA,CAE1C,UAAA,EAAY,kBAAA,CAAmB,KAAA,EAAO,MAAA,EAAQ,cAAA,EAAgB,YAAA,IAC7D,cAAA,CAAe,KAAA,EAAO,MAAA,EAAQ,cAAA,EAAgB,YAAA;AAAA,iBAGjC,cAAA,qBACM,eAAA,GAAkB,MAAA,qCACjB,gBAAA,GAAmB,MAAA,6CAEpC,MAAA,SAAe,gBAAA,qEAEQ,MAAA,SAAe,MAAA,2CAAA,CAE1C,QAAA,EAAU,gBAAA,CAAiB,cAAA,EAAgB,YAAA,GAC3C,OAAA,GAAU,OAAA,EAAS,0BAAA,CAAyB,SAAA,EAAW,YAAA,EAAc,cAAA;EAAA,SAC1D,KAAA,GAAQ,KAAA;EAAA,SACR,MAAA,GAAS,MAAA;AAAA,IAEnB,cAAA,CAAe,KAAA,EAAO,MAAA,EAAQ,cAAA,EAAgB,YAAA"}

package/dist/contract-builder.mjs

@@ -1,2 +1,17 @@
-import { buildSqlContractFromDefinition, defineContract, field, model, rel } from "@prisma-next/sql-contract-ts/contract-builder";
+import { buildSqlContractFromDefinition, defineContract as defineContract$1, field, model, rel } from "@prisma-next/sql-contract-ts/contract-builder";
+import sqlFamilyPack from "@prisma-next/family-sql/pack";
+import postgresPack from "@prisma-next/target-postgres/pack";
+//#region src/contract/define-contract.ts
+function defineContract(scaffold, factory) {
+	const full = {
+		...scaffold,
+		family: sqlFamilyPack,
+		target: postgresPack
+	};
+	if (factory !== void 0) return defineContract$1(full, factory);
+	return defineContract$1(full);
+}
+//#endregion
 export { buildSqlContractFromDefinition, defineContract, field, model, rel };
+
+//# sourceMappingURL=contract-builder.mjs.map

package/dist/contract-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-builder.mjs","names":["baseDefineContract"],"sources":["../src/contract/define-contract.ts"],"sourcesContent":["import sqlFamilyPack from '@prisma-next/family-sql/pack';\nimport type { ExtensionPackRef } from '@prisma-next/framework-components/components';\nimport type {\n  PostgresEnumStorageEntry,\n  StorageTypeInstance,\n} from '@prisma-next/sql-contract/types';\nimport type {\n  ComposedAuthoringHelpers,\n  ContractInput,\n  ModelLike,\n} from '@prisma-next/sql-contract-ts/contract-builder';\nimport { defineContract as baseDefineContract } from '@prisma-next/sql-contract-ts/contract-builder';\nimport postgresPack from '@prisma-next/target-postgres/pack';\n\ntype SqlFamily = typeof sqlFamilyPack;\ntype PostgresPack = typeof postgresPack;\n\ntype TypesConstraint = Record<string, StorageTypeInstance | PostgresEnumStorageEntry>;\ntype ModelsConstraint = Record<string, ModelLike>;\n\n// Return type threaded with all inferred type params.\n// We override target/targetFamily via intersection to preserve the literal values\n// ('postgres', 'sql') even when TypeScript defers conditional-type evaluation on\n// unresolved generic params.\ntype PostgresResult<\n  Types extends TypesConstraint,\n  Models extends ModelsConstraint,\n  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined,\n> = Omit<\n  ReturnType<\n    typeof baseDefineContract<SqlFamily, PostgresPack, Types, Models, ExtensionPacks, Capabilities>\n  >,\n  'target' | 'targetFamily'\n> & {\n  readonly target: PostgresPack['targetId'];\n  readonly targetFamily: SqlFamily['familyId'];\n};\n\n// Scaffold that carries all ContractInput fields EXCEPT family, target, types, models.\n// Built from ContractInput with concrete Record<never, never> defaults to avoid\n// the ContractInput Models constraint (which requires ContractModelBuilder, not ModelLike).\ntype PostgresBaseScaffold<\n  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined,\n> = Omit<\n  ContractInput<\n    SqlFamily,\n    PostgresPack,\n    Record<never, never>,\n    Record<never, never>,\n    ExtensionPacks,\n    Capabilities\n  >,\n  'family' | 'target' | 'types' | 'models'\n>;\n\n// Definition form: inline types + models (uses ModelLike for models, not ContractModelBuilder)\ntype PostgresDefinition<\n  Types extends TypesConstraint,\n  Models extends ModelsConstraint,\n  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined,\n> = PostgresBaseScaffold<ExtensionPacks, Capabilities> & {\n  readonly types?: Types;\n  readonly models?: Models;\n};\n\n// Factory form: scaffold without types/models (factory provides them)\ntype PostgresScaffold<\n  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined,\n> = PostgresBaseScaffold<ExtensionPacks, Capabilities>;\n\n// Overload 1: definition form (models/types inline in scaffold)\nexport function defineContract<\n  const Types extends TypesConstraint = Record<never, never>,\n  const Models extends ModelsConstraint = Record<never, never>,\n  const ExtensionPacks extends\n    | Record<string, ExtensionPackRef<'sql', string>>\n    | undefined = undefined,\n  const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,\n>(\n  definition: PostgresDefinition<Types, Models, ExtensionPacks, Capabilities>,\n): PostgresResult<Types, Models, ExtensionPacks, Capabilities>;\n\n// Overload 2: factory form (scaffold without models/types; factory provides them)\nexport function defineContract<\n  const Types extends TypesConstraint = Record<never, never>,\n  const Models extends ModelsConstraint = Record<never, never>,\n  const ExtensionPacks extends\n    | Record<string, ExtensionPackRef<'sql', string>>\n    | undefined = undefined,\n  const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,\n>(\n  scaffold: PostgresScaffold<ExtensionPacks, Capabilities>,\n  factory: (helpers: ComposedAuthoringHelpers<SqlFamily, PostgresPack, ExtensionPacks>) => {\n    readonly types?: Types;\n    readonly models?: Models;\n  },\n): PostgresResult<Types, Models, ExtensionPacks, Capabilities>;\n\n// Implementation — the runtime type is richer than the wide impl signature;\n// as unknown is safe because every declared overload produces a PostgresResult.\nexport function defineContract(\n  scaffold: Omit<ContractInput, 'family' | 'target'>,\n  factory?: (helpers: ComposedAuthoringHelpers<SqlFamily, PostgresPack, undefined>) => {\n    readonly types?: TypesConstraint;\n    readonly models?: ModelsConstraint;\n  },\n): PostgresResult<TypesConstraint, ModelsConstraint, undefined, undefined> {\n  const full = {\n    ...scaffold,\n    family: sqlFamilyPack,\n    target: postgresPack,\n  } as ContractInput;\n  if (factory !== undefined) {\n    return baseDefineContract(\n      full,\n      factory as Parameters<typeof baseDefineContract>[1],\n    ) as unknown as PostgresResult<TypesConstraint, ModelsConstraint, undefined, undefined>;\n  }\n  return baseDefineContract(full) as unknown as PostgresResult<\n    TypesConstraint,\n    ModelsConstraint,\n    undefined,\n    undefined\n  >;\n}\n"],"mappings":";;;;AAwGA,SAAgB,eACd,UACA,SAIyE;CACzE,MAAM,OAAO;EACX,GAAG;EACH,QAAQ;EACR,QAAQ;EACT;CACD,IAAI,YAAY,KAAA,GACd,OAAOA,iBACL,MACA,QACD;CAEH,OAAOA,iBAAmB,KAAK"}

package/dist/migration.d.mts

@@ -0,0 +1 @@
+export * from "@prisma-next/target-postgres/migration";

package/dist/migration.mjs

@@ -0,0 +1,2 @@
+export * from "@prisma-next/target-postgres/migration";
+export {};

package/dist/{postgres-V6YAIWZd.d.mts → postgres-DTqYNIbs.d.mts}

@@ -1,9 +1,9 @@
 import { orm } from "@prisma-next/sql-orm-client";
 import { BindSiteParams, Declaration, ExecutionContext, ParamsFromDeclaration, PreparedStatement, Runtime, RuntimeVerifyOptions, SqlExecutionStackWithDriver, SqlMiddleware, SqlRuntimeExtensionDescriptor, TransactionContext } from "@prisma-next/sql-runtime";
 import { Client, Pool } from "pg";
+import { ExtractCodecTypes, SqlStorage } from "@prisma-next/sql-contract/types";
 import { Contract } from "@prisma-next/contract/types";
 import { Db } from "@prisma-next/sql-builder/types";
-import { ExtractCodecTypes, SqlStorage } from "@prisma-next/sql-contract/types";
 import { CodecTypesBase } from "@prisma-next/sql-relational-core/expression";
 import { SqlQueryPlan } from "@prisma-next/sql-relational-core/plan";
 
@@ -48,6 +48,8 @@ interface PostgresClient<TContract extends Contract<SqlStorage>> {
   runtime(): Runtime;
   transaction<R>(fn: (tx: PostgresTransactionContext<TContract>) => PromiseLike<R>): Promise<R>;
   prepare<D extends Declaration<CT>, Row, CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase>(declaration: D, callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>>;
+  close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
 }
 interface PostgresOptionsBase {
   readonly extensions?: readonly SqlRuntimeExtensionDescriptor<PostgresTargetId>[];
@@ -84,4 +86,4 @@ declare function postgres<TContract extends Contract<SqlStorage>>(options: Postg
 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-V6YAIWZd.d.mts.map
+//# sourceMappingURL=postgres-DTqYNIbs.d.mts.map

package/dist/{postgres-V6YAIWZd.d.mts.map → postgres-DTqYNIbs.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"postgres-V6YAIWZd.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;;;KCiBH,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;EAC3F,OAAA,WACY,WAAA,CAAY,EAAA,mBAEX,cAAA,GAAiB,iBAAA,CAAkB,SAAA,IAAa,cAAA,EAE3D,WAAA,EAAa,CAAA,EACb,QAAA,GAAW,GAAA,EAAK,EAAA,CAAG,SAAA,GAAY,MAAA,EAAQ,cAAA,CAAe,CAAA,MAAO,YAAA,CAAa,GAAA,IACzE,OAAA,CAAQ,iBAAA,CAAkB,qBAAA,CAAsB,CAAA,EAAG,EAAA,GAAK,GAAA;AAAA;AAAA,UAG5C,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;AA5DpC;;;;;AAA0C;;AAA1C,iBAsGwB,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"}
+{"version":3,"file":"postgres-DTqYNIbs.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;;;KCiBH,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;EAC3F,OAAA,WACY,WAAA,CAAY,EAAA,mBAEX,cAAA,GAAiB,iBAAA,CAAkB,SAAA,IAAa,cAAA,EAE3D,WAAA,EAAa,CAAA,EACb,QAAA,GAAW,GAAA,EAAK,EAAA,CAAG,SAAA,GAAY,MAAA,EAAQ,cAAA,CAAe,CAAA,MAAO,YAAA,CAAa,GAAA,IACzE,OAAA,CAAQ,iBAAA,CAAkB,qBAAA,CAAsB,CAAA,EAAG,EAAA,GAAK,GAAA;EAC3D,KAAA,IAAS,OAAA;EAAA,CACR,MAAA,CAAO,YAAP,KAAwB,OAAA;AAAA;AAAA,UAGV,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;;;;AA9DM;;;;iBAwGlB,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,2 +1,2 @@
-import { a as PostgresOptionsWithContractJson, c as PostgresBinding, i as PostgresOptionsWithContract, n as PostgresOptions, r as PostgresOptionsBase, s as postgres, t as PostgresClient } from "./postgres-V6YAIWZd.mjs";
+import { a as PostgresOptionsWithContractJson, c as PostgresBinding, i as PostgresOptionsWithContract, n as PostgresOptions, r as PostgresOptionsBase, s as postgres, t as PostgresClient } from "./postgres-DTqYNIbs.mjs";
 export { type PostgresBinding, type PostgresClient, type PostgresOptions, type PostgresOptionsBase, type PostgresOptionsWithContract, type PostgresOptionsWithContractJson, postgres as default };

package/dist/runtime.mjs

@@ -82,22 +82,34 @@ function postgres(options) {
 	let driverConnected = false;
 	let connectPromise;
 	let backgroundConnectError;
+	let closed = false;
+	let ownedDispose;
 	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);
+		if (resolvedBinding.kind === "url" && runtimeBinding.kind === "pgPool") {
+			const pool = runtimeBinding.pool;
+			let disposed = false;
+			ownedDispose = async () => {
+				if (disposed) return;
+				disposed = true;
+				await pool.end().then(() => void 0);
+			};
+		}
 		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);
+			await ownedDispose?.().catch(() => void 0);
 			throw err;
 		});
 		return connectPromise;
 	};
 	const getRuntime = () => {
+		if (closed) throw new Error("Postgres client is closed");
 		if (backgroundConnectError !== void 0) throw backgroundConnectError;
 		if (runtimeInstance) return runtimeInstance;
 		const stackInstance = instantiateExecutionStack(stack);
@@ -136,6 +148,7 @@ function postgres(options) {
 		context,
 		stack,
 		async connect(bindingInput) {
+			if (closed) throw new Error("Postgres client is closed");
 			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({ ... }).");
@@ -164,6 +177,15 @@ function postgres(options) {
 					orm: txOrm
 				}));
 			});
+		},
+		async close() {
+			if (closed) return;
+			closed = true;
+			await connectPromise?.catch(() => void 0);
+			await ownedDispose?.();
+		},
+		[Symbol.asyncDispose]() {
+			return this.close();
 		}
 	};
 }

package/dist/runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.mjs","names":["PgPool","PgClient","orm","ormBuilder","sql","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 { 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 { ExtractCodecTypes, SqlStorage } from '@prisma-next/sql-contract/types';\nimport { orm as ormBuilder } from '@prisma-next/sql-orm-client';\nimport type { CodecTypesBase } from '@prisma-next/sql-relational-core/expression';\nimport type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';\nimport type {\n  BindSiteParams,\n  Declaration,\n  ExecutionContext,\n  ParamsFromDeclaration,\n  PreparedStatement,\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, { PostgresContractSerializer } 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  prepare<\n    D extends Declaration<CT>,\n    Row,\n    CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase,\n  >(\n    declaration: D,\n    callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,\n  ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>>;\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\nconst contractSerializer = new PostgresContractSerializer();\n\nfunction resolveContract<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): TContract {\n  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;\n  return contractSerializer.deserializeContract(contractInput) as TContract;\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    prepare<\n      D extends Declaration<CT>,\n      Row,\n      CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase,\n    >(\n      declaration: D,\n      callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,\n    ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>> {\n      return getRuntime().prepare<D, Row, CT>(declaration, (params) => callback(sql, params));\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","sql","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 { 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 { ExtractCodecTypes, SqlStorage } from '@prisma-next/sql-contract/types';\nimport { orm as ormBuilder } from '@prisma-next/sql-orm-client';\nimport type { CodecTypesBase } from '@prisma-next/sql-relational-core/expression';\nimport type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';\nimport type {\n  BindSiteParams,\n  Declaration,\n  ExecutionContext,\n  ParamsFromDeclaration,\n  PreparedStatement,\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, { PostgresContractSerializer } 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  prepare<\n    D extends Declaration<CT>,\n    Row,\n    CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase,\n  >(\n    declaration: D,\n    callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,\n  ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>>;\n  close(): Promise<void>;\n  [Symbol.asyncDispose](): Promise<void>;\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\nconst contractSerializer = new PostgresContractSerializer();\n\nfunction resolveContract<TContract extends Contract<SqlStorage>>(\n  options: PostgresOptions<TContract>,\n): TContract {\n  const contractInput = hasContractJson(options) ? options.contractJson : options.contract;\n  return contractSerializer.deserializeContract(contractInput) as TContract;\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  let closed = false;\n  let ownedDispose: (() => Promise<void>) | undefined;\n\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    if (resolvedBinding.kind === 'url' && runtimeBinding.kind === 'pgPool') {\n      const pool = runtimeBinding.pool;\n      let disposed = false;\n      ownedDispose = async () => {\n        if (disposed) return;\n        disposed = true;\n        await pool.end().then(() => undefined);\n      };\n    }\n    connectPromise = runtimeDriver\n      .connect(runtimeBinding)\n      .then(() => {\n        driverConnected = true;\n      })\n      .catch(async (err) => {\n        backgroundConnectError = err;\n        connectPromise = undefined;\n        await ownedDispose?.().catch(() => undefined);\n        throw err;\n      });\n    return connectPromise;\n  };\n  const getRuntime = (): Runtime => {\n    if (closed) {\n      throw new Error('Postgres client is closed');\n    }\n\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 (closed) {\n        throw new Error('Postgres client is closed');\n      }\n\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    prepare<\n      D extends Declaration<CT>,\n      Row,\n      CT extends CodecTypesBase = ExtractCodecTypes<TContract> & CodecTypesBase,\n    >(\n      declaration: D,\n      callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,\n    ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>> {\n      return getRuntime().prepare<D, Row, CT>(declaration, (params) => callback(sql, params));\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    async close(): Promise<void> {\n      if (closed) return;\n      closed = true;\n      await connectPromise?.catch(() => undefined);\n      await ownedDispose?.();\n    },\n\n    [Symbol.asyncDispose](): Promise<void> {\n      return this.close();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/serverless.d.mts

@@ -1,9 +1,9 @@
-import { o as PostgresTargetId } from "./postgres-V6YAIWZd.mjs";
+import { o as PostgresTargetId } from "./postgres-DTqYNIbs.mjs";
 import { PostgresDriverCreateOptions } from "@prisma-next/driver-postgres/runtime";
 import { ExecutionContext, Runtime, RuntimeVerifyOptions, SqlExecutionStackWithDriver, SqlMiddleware, SqlRuntimeExtensionDescriptor } from "@prisma-next/sql-runtime";
+import { SqlStorage } from "@prisma-next/sql-contract/types";
 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']>;

package/package.json

@@ -1,35 +1,35 @@
 {
   "name": "@prisma-next/postgres",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "One-liner lazy Postgres client composition for Prisma Next",
   "dependencies": {
-    "@prisma-next/adapter-postgres": "0.10.0",
-    "@prisma-next/cli": "0.10.0",
-    "@prisma-next/config": "0.10.0",
-    "@prisma-next/contract": "0.10.0",
-    "@prisma-next/driver-postgres": "0.10.0",
-    "@prisma-next/family-sql": "0.10.0",
-    "@prisma-next/framework-components": "0.10.0",
-    "@prisma-next/sql-contract": "0.10.0",
-    "@prisma-next/sql-contract-psl": "0.10.0",
-    "@prisma-next/sql-contract-ts": "0.10.0",
-    "@prisma-next/sql-builder": "0.10.0",
-    "@prisma-next/sql-orm-client": "0.10.0",
-    "@prisma-next/sql-relational-core": "0.10.0",
-    "@prisma-next/sql-runtime": "0.10.0",
-    "@prisma-next/target-postgres": "0.10.0",
-    "@prisma-next/utils": "0.10.0",
+    "@prisma-next/adapter-postgres": "0.11.0",
+    "@prisma-next/cli": "0.11.0",
+    "@prisma-next/config": "0.11.0",
+    "@prisma-next/contract": "0.11.0",
+    "@prisma-next/driver-postgres": "0.11.0",
+    "@prisma-next/family-sql": "0.11.0",
+    "@prisma-next/framework-components": "0.11.0",
+    "@prisma-next/sql-contract": "0.11.0",
+    "@prisma-next/sql-contract-psl": "0.11.0",
+    "@prisma-next/sql-contract-ts": "0.11.0",
+    "@prisma-next/sql-builder": "0.11.0",
+    "@prisma-next/sql-orm-client": "0.11.0",
+    "@prisma-next/sql-relational-core": "0.11.0",
+    "@prisma-next/sql-runtime": "0.11.0",
+    "@prisma-next/target-postgres": "0.11.0",
+    "@prisma-next/utils": "0.11.0",
     "pathe": "^2.0.3",
     "pg": "8.20.0"
   },
   "devDependencies": {
-    "@prisma-next/psl-parser": "0.10.0",
-    "@prisma-next/test-utils": "0.10.0",
-    "@prisma-next/tsconfig": "0.10.0",
-    "@prisma-next/tsdown": "0.10.0",
+    "@prisma-next/psl-parser": "0.11.0",
+    "@prisma-next/test-utils": "0.11.0",
+    "@prisma-next/tsconfig": "0.11.0",
+    "@prisma-next/tsdown": "0.11.0",
     "@types/pg": "8.20.0",
     "tsdown": "0.22.0",
     "typescript": "5.9.3",
@@ -52,6 +52,7 @@
     "./contract-builder": "./dist/contract-builder.mjs",
     "./control": "./dist/control.mjs",
     "./family": "./dist/family.mjs",
+    "./migration": "./dist/migration.mjs",
     "./runtime": "./dist/runtime.mjs",
     "./serverless": "./dist/serverless.mjs",
     "./target": "./dist/target.mjs",

package/src/contract/define-contract.ts

@@ -0,0 +1,129 @@
+import sqlFamilyPack from '@prisma-next/family-sql/pack';
+import type { ExtensionPackRef } from '@prisma-next/framework-components/components';
+import type {
+  PostgresEnumStorageEntry,
+  StorageTypeInstance,
+} from '@prisma-next/sql-contract/types';
+import type {
+  ComposedAuthoringHelpers,
+  ContractInput,
+  ModelLike,
+} from '@prisma-next/sql-contract-ts/contract-builder';
+import { defineContract as baseDefineContract } from '@prisma-next/sql-contract-ts/contract-builder';
+import postgresPack from '@prisma-next/target-postgres/pack';
+
+type SqlFamily = typeof sqlFamilyPack;
+type PostgresPack = typeof postgresPack;
+
+type TypesConstraint = Record<string, StorageTypeInstance | PostgresEnumStorageEntry>;
+type ModelsConstraint = Record<string, ModelLike>;
+
+// Return type threaded with all inferred type params.
+// We override target/targetFamily via intersection to preserve the literal values
+// ('postgres', 'sql') even when TypeScript defers conditional-type evaluation on
+// unresolved generic params.
+type PostgresResult<
+  Types extends TypesConstraint,
+  Models extends ModelsConstraint,
+  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,
+  Capabilities extends Record<string, Record<string, boolean>> | undefined,
+> = Omit<
+  ReturnType<
+    typeof baseDefineContract<SqlFamily, PostgresPack, Types, Models, ExtensionPacks, Capabilities>
+  >,
+  'target' | 'targetFamily'
+> & {
+  readonly target: PostgresPack['targetId'];
+  readonly targetFamily: SqlFamily['familyId'];
+};
+
+// Scaffold that carries all ContractInput fields EXCEPT family, target, types, models.
+// Built from ContractInput with concrete Record<never, never> defaults to avoid
+// the ContractInput Models constraint (which requires ContractModelBuilder, not ModelLike).
+type PostgresBaseScaffold<
+  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,
+  Capabilities extends Record<string, Record<string, boolean>> | undefined,
+> = Omit<
+  ContractInput<
+    SqlFamily,
+    PostgresPack,
+    Record<never, never>,
+    Record<never, never>,
+    ExtensionPacks,
+    Capabilities
+  >,
+  'family' | 'target' | 'types' | 'models'
+>;
+
+// Definition form: inline types + models (uses ModelLike for models, not ContractModelBuilder)
+type PostgresDefinition<
+  Types extends TypesConstraint,
+  Models extends ModelsConstraint,
+  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,
+  Capabilities extends Record<string, Record<string, boolean>> | undefined,
+> = PostgresBaseScaffold<ExtensionPacks, Capabilities> & {
+  readonly types?: Types;
+  readonly models?: Models;
+};
+
+// Factory form: scaffold without types/models (factory provides them)
+type PostgresScaffold<
+  ExtensionPacks extends Record<string, ExtensionPackRef<'sql', string>> | undefined,
+  Capabilities extends Record<string, Record<string, boolean>> | undefined,
+> = PostgresBaseScaffold<ExtensionPacks, Capabilities>;
+
+// Overload 1: definition form (models/types inline in scaffold)
+export function defineContract<
+  const Types extends TypesConstraint = Record<never, never>,
+  const Models extends ModelsConstraint = Record<never, never>,
+  const ExtensionPacks extends
+    | Record<string, ExtensionPackRef<'sql', string>>
+    | undefined = undefined,
+  const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,
+>(
+  definition: PostgresDefinition<Types, Models, ExtensionPacks, Capabilities>,
+): PostgresResult<Types, Models, ExtensionPacks, Capabilities>;
+
+// Overload 2: factory form (scaffold without models/types; factory provides them)
+export function defineContract<
+  const Types extends TypesConstraint = Record<never, never>,
+  const Models extends ModelsConstraint = Record<never, never>,
+  const ExtensionPacks extends
+    | Record<string, ExtensionPackRef<'sql', string>>
+    | undefined = undefined,
+  const Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,
+>(
+  scaffold: PostgresScaffold<ExtensionPacks, Capabilities>,
+  factory: (helpers: ComposedAuthoringHelpers<SqlFamily, PostgresPack, ExtensionPacks>) => {
+    readonly types?: Types;
+    readonly models?: Models;
+  },
+): PostgresResult<Types, Models, ExtensionPacks, Capabilities>;
+
+// Implementation — the runtime type is richer than the wide impl signature;
+// as unknown is safe because every declared overload produces a PostgresResult.
+export function defineContract(
+  scaffold: Omit<ContractInput, 'family' | 'target'>,
+  factory?: (helpers: ComposedAuthoringHelpers<SqlFamily, PostgresPack, undefined>) => {
+    readonly types?: TypesConstraint;
+    readonly models?: ModelsConstraint;
+  },
+): PostgresResult<TypesConstraint, ModelsConstraint, undefined, undefined> {
+  const full = {
+    ...scaffold,
+    family: sqlFamilyPack,
+    target: postgresPack,
+  } as ContractInput;
+  if (factory !== undefined) {
+    return baseDefineContract(
+      full,
+      factory as Parameters<typeof baseDefineContract>[1],
+    ) as unknown as PostgresResult<TypesConstraint, ModelsConstraint, undefined, undefined>;
+  }
+  return baseDefineContract(full) as unknown as PostgresResult<
+    TypesConstraint,
+    ModelsConstraint,
+    undefined,
+    undefined
+  >;
+}

package/src/exports/contract-builder.ts

@@ -14,8 +14,8 @@ export type {
 } from '@prisma-next/sql-contract-ts/contract-builder';
 export {
   buildSqlContractFromDefinition,
-  defineContract,
   field,
   model,
   rel,
 } from '@prisma-next/sql-contract-ts/contract-builder';
+export { defineContract } from '../contract/define-contract';

package/src/exports/migration.ts

@@ -0,0 +1 @@
+export * from '@prisma-next/target-postgres/migration';

package/src/runtime/postgres.ts

@@ -62,6 +62,8 @@ export interface PostgresClient<TContract extends Contract<SqlStorage>> {
     declaration: D,
     callback: (sql: Db<TContract>, params: BindSiteParams<D>) => SqlQueryPlan<Row>,
   ): Promise<PreparedStatement<ParamsFromDeclaration<D, CT>, Row>>;
+  close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
 }
 
 export interface PostgresOptionsBase {
@@ -167,11 +169,23 @@ export default function postgres<TContract extends Contract<SqlStorage>>(
   let driverConnected = false;
   let connectPromise: Promise<void> | undefined;
   let backgroundConnectError: unknown;
+  let closed = false;
+  let ownedDispose: (() => Promise<void>) | undefined;
+
   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);
+    if (resolvedBinding.kind === 'url' && runtimeBinding.kind === 'pgPool') {
+      const pool = runtimeBinding.pool;
+      let disposed = false;
+      ownedDispose = async () => {
+        if (disposed) return;
+        disposed = true;
+        await pool.end().then(() => undefined);
+      };
+    }
     connectPromise = runtimeDriver
       .connect(runtimeBinding)
       .then(() => {
@@ -180,14 +194,16 @@ export default function postgres<TContract extends Contract<SqlStorage>>(
       .catch(async (err) => {
         backgroundConnectError = err;
         connectPromise = undefined;
-        if (resolvedBinding.kind === 'url' && runtimeBinding.kind === 'pgPool') {
-          await runtimeBinding.pool.end().catch(() => undefined);
-        }
+        await ownedDispose?.().catch(() => undefined);
         throw err;
       });
     return connectPromise;
   };
   const getRuntime = (): Runtime => {
+    if (closed) {
+      throw new Error('Postgres client is closed');
+    }
+
     if (backgroundConnectError !== undefined) {
       throw backgroundConnectError;
     }
@@ -241,6 +257,10 @@ export default function postgres<TContract extends Contract<SqlStorage>>(
     stack,
 
     async connect(bindingInput) {
+      if (closed) {
+        throw new Error('Postgres client is closed');
+      }
+
       if (driverConnected || connectPromise) {
         throw new Error('Postgres client already connected');
       }
@@ -304,5 +324,16 @@ export default function postgres<TContract extends Contract<SqlStorage>>(
         return fn(tx);
       });
     },
+
+    async close(): Promise<void> {
+      if (closed) return;
+      closed = true;
+      await connectPromise?.catch(() => undefined);
+      await ownedDispose?.();
+    },
+
+    [Symbol.asyncDispose](): Promise<void> {
+      return this.close();
+    },
   };
 }