npm / @neondatabase/serverless
@neondatabase/serverless
What changed in @neondatabase/serverless 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-12.
4 breaking4 new APIs and options1 behavior and defaults2 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@neondatabase/serverless 111 changes
Breaking changes 4
The package is no longer published to JSR; update jsr references to npm:@neondatabase/serverless.
Declarations are now fully inlined instead of re-exported from @types/pg and @types/node. Code relying on exact type identity, pg module augmentation flowing through these exports, or Buffer-specific types where Uint8Array is now declared may need updated types.
The minimum supported Node version is now v19, avoiding dynamic crypto imports that can cause trouble with bundlers.
The HTTP query template function can only be called as a template function; ordinary function calls are now TypeScript type errors and runtime errors to prevent SQL-injection vulnerabilities.
New APIs and options 4
Options to neon now support individual connection parameters, including values or sync or async functions resolved on every query; they can supplement, override, or replace the connection string.
parseIntoClientConfig from pg-connection-string is exported at top level to simplify using a password function alongside a connection string.
Options to query now support individual connection parameters, including values or sync or async functions resolved on every query; they can supplement, override, or replace the connection string.
Options to transaction now support individual connection parameters, including values or sync or async functions resolved on every query; they can supplement, override, or replace the connection string.
Behavior and default changes 1
HTTP template queries are fully composable, including those with parameters; raw SQL compilation happens lazily at query time so parameter placeholders can be numbered appropriately.
Fixes and other changes 2
Client now supports a sync or async function as the password connection parameter when pipelineConnect is enabled.
Pool now supports a sync or async function as the password connection parameter when pipelineConnect is enabled.