Upgrading postgres from 3.x to 4.x

Comparison of the public API of postgres 3.4.9 and 4.0.0, computed automatically from their TypeScript types. A changed signature is a candidate for a breaking change, not a certainty.

Summary

Removed import paths	0
Removed exports	45
Changed signatures	14
Removed class or interface members	0
Changed class or interface members	0
Newly deprecated	0
Requirement changes (engines, peer dependencies)	1
New exports	6

Removed exports

import	export	kind	Before
`postgres`	`State`	interface	`interface`
`postgres`	`camel`	namespace	`namespace`
`postgres`	`kebab`	namespace	`namespace`
`postgres`	`BigInt`	variable	`PostgresType<bigint>`
`postgres`	`Column`	interface	`interface`
`postgres`	`pascal`	namespace	`namespace`
`postgres`	`toCamel`	function	`(str: string): string`
`postgres`	`toKebab`	function	`(str: string): string`
`postgres`	`MaybeRow`	type	`Row \| undefined`
`postgres`	`toPascal`	function	`(str: string): string`
`postgres`	`JSONValue`	type	`string \| number \| boolean \| Date \| readonly JSONValue[] \| { toJSON(): any; } \| { readonly [prop: string]: JSONValue \| ((...args: any) => any) \| undefined; readonly [prop: number]: JSONValue \| ((...args: any) => any) \| undefined; } \| null`
`postgres`	`Statement`	interface	`interface`
`postgres`	`Transform`	interface	`interface`
`postgres`	`fromCamel`	function	`(str: string): string`
`postgres`	`fromKebab`	function	`(str: string): string`
`postgres`	`ColumnInfo`	interface	`interface`
`postgres`	`ColumnList`	type	`(T extends string ? Column<T> : never)[]`
`postgres`	`ListenMeta`	interface	`interface`
`postgres`	`RawRowList`	type	`Buffer[][] & Iterable<Buffer[][]> & ResultQueryMeta<T["length"], keyof T[number]>`
`postgres`	`ResultMeta`	interface	`interface`
`postgres`	`fromPascal`	function	`(str: string): string`
`postgres`	`LargeObject`	interface	`interface`
`postgres`	`GenericError`	interface	`interface`
`postgres`	`RelationInfo`	interface	`interface`
`postgres`	`Serializable`	type	`string \| number \| boolean \| Date \| Uint8Array<ArrayBufferLike> \| null`
`postgres`	`ListenRequest`	interface	`interface`
`postgres`	`ValuesRowList`	type	`T[number][keyof T[number]][][] & ResultQueryMeta<T["length"], keyof T[number]>`
`postgres`	`ArrayParameter`	interface	`interface`
`postgres`	`EscapableArray`	type	`(string \| number)[]`
`postgres`	`PendingRequest`	interface	`interface`
`postgres`	`ConnectionError`	interface	`interface`
`postgres`	`ExecutionResult`	type	`[] & ResultQueryMeta<number, keyof NonNullable<T>>`
`postgres`	`ParameterOrJSON`	type	`string \| number \| boolean \| Date \| Uint8Array<ArrayBufferLike> \| Helper<any, any[]> \| Parameter<any> \| ArrayParameter<readonly any[]> \| readonly JSONValue[] \| { toJSON(): any; } \| { readonly [prop: string]: JSONValue \| ((...args: any) => any) \| undefined; readonly [prop: number]: JSONValue \| ((...args: any) => any) \| undefined; } \| T \| readonly SerializableParameter<T>[] \| null`
`postgres`	`PendingRawQuery`	interface	`interface`
`postgres`	`ResultQueryMeta`	interface	`interface`
`postgres`	`NotSupportedError`	interface	`interface`
`postgres`	`PendingValuesQuery`	interface	`interface`
`postgres`	`SubscriptionHandle`	interface	`interface`
`postgres`	`UnsafeQueryOptions`	interface	`interface`
`postgres`	`ParameterOrFragment`	type	`Fragment \| SerializableParameter<T> \| Fragment[]`
`postgres`	`ConnectionParameters`	interface	`interface`
`postgres`	`PendingDescribeQuery`	interface	`interface`
`postgres`	`PendingQueryModifiers`	interface	`interface`
`postgres`	`SerializableParameter`	type	`Serializable \| T \| Helper<any, any[]> \| Parameter<any> \| ArrayParameter<readonly any[]> \| readonly SerializableParameter<T>[]`
`postgres`	`AuthNotImplementedError`	interface	`interface`

Changed signatures

export	Before	After
`postgres · Row`	`interface`	`Row`
`postgres · Sql`	`interface`	`Sql<TTypes>`
`postgres · ISql`	`interface`	`ISql<TTypes>`
`postgres · Helper`	`interface`	`Helper<T, U>`
`postgres · Notice`	`interface`	`Notice`
`postgres · Options`	`interface`	`Options<T>`
`postgres · Parameter`	`interface`	`Parameter<T>`
`postgres · ReservedSql`	`interface`	`ReservedSql<TTypes>`
`postgres · PendingQuery`	`interface`	`PendingQuery<T>`
`postgres · PostgresType`	`interface`	`PostgresType<T>`
`postgres · ParsedOptions`	`interface`	`ParsedOptions<T>`
`postgres · PostgresError`	`class`	`PostgresError`
`postgres · TransactionSql`	`interface`	`TransactionSql<TTypes>`
`postgres · ReplicationEvent`	`{ command: "insert"; relation: RelationInfo; } \| { command: "delete"; relation: RelationInfo; key: boolean; } \| { command: "update"; relation: RelationInfo; key: boolean; old: Row \| null; }`	`TransactionInfo & ({ command: "insert"; relation: RelationInfo; } \| { command: "update"; relation: RelationInfo; key: boolean; old: Row \| null; } \| { command: "delete"; relation: RelationInfo; key: boolean; } \| { command: "truncate"; relation: RelationInfo; cascade: boolean; restartIdentity: boolean; })`

Removed class or interface members

None detected.

Changed class or interface members

None detected.

Newly deprecated

None detected.

Requirement changes (engines, peer dependencies)

	Before	After
`engines.node`	`>=12`	`>=20`

New exports (6)

import	export	kind
`postgres`	`default`	function
`postgres`	`PoolEvent`	type
`postgres`	`QueryTrace`	type
`postgres`	`NoticeEvent`	type
`postgres`	`ConnectTrace`	type
`postgres`	`TransactionTrace`	type

Give your AI agent these facts

Vigia is a free MCP server: your coding agent checks versions, breaking changes and vulnerabilities before it writes code. No signup, no API key.

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

Add to Cursor Add to VS Code ★ Star on GitHub

Any other MCP client

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

Agent skill (SKILL.md): tells the agent when to use Vigia · GitHub Action for pull requests

Frequently asked questions

What are the breaking changes when upgrading postgres from 3 to 4?

Between postgres 3.4.9 and 4.0.0, Vigia found 45 removed exports, 14 changed signatures and 0 removed or changed class or interface members.

What became deprecated in postgres 4?

0 exports or members are newly marked as deprecated in postgres 4.0.0.

For agents

GET https://vigia.coredls.cloud/v1/packages/npm/postgres/upgrade?from=3.4.9&to=4.0.0