Skip to content

[feat] @workflow/world-postgres: migrate from postgres.js to pg - #1484

Merged
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main
Mar 23, 2026
Merged

[feat] @workflow/world-postgres: migrate from postgres.js to pg#1484
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main

Conversation

@jlalmes

Copy link
Copy Markdown
Contributor

Summary

Migrates @workflow/world-postgres from postgres.js to node-postgres (pg) and Drizzle’s drizzle-orm/node-postgres driver. Graphile Worker now uses the same pg.Pool via pgPool. Streaming LISTEN/NOTIFY uses a dedicated pg.Client built from new Client(pool.options) so the long-lived listener does not hold a connection checked out from the shared pool.

createWorld accepts an optional pool. When the world creates its own pool from connectionString, world.close() ends that pool; when pool is passed in, world.close() does not end it (caller owns lifecycle).

Motivation

  • Align with Drizzle’s node-postgres path and a single driver stack for Drizzle + Graphile.
  • Allow apps to pass an existing pg.Pool so workflow storage and userland code can share connection configuration and pooling behavior.
  • Avoid using the shared pool for LISTEN (dedicated client for notifications).

Breaking changes

  • BREAKING: Removes the postgres (postgres.js) dependency; consumers that depended on postgres.js-specific behavior or types must switch to pg.

Implementation notes

  • Drizzle:drizzle-orm/postgres-jsdrizzle-orm/node-postgres; createClient(pool) wraps the shared pool.
  • Queue:makeWorkerUtils / run use pgPool: pool; PgBoss migration SQL uses pool.query and result.rows.
  • Streamer:pg_notify via the pool; listenChannel in listen-channel.ts uses a dedicated client from pool.options.
  • CLI: Migrations use drizzle-orm/node-postgres/migrator and a small Pool for setup.
  • Config:PostgresWorldConfig is a discriminated union: either connectionString or pool, plus existing job options.

Docs

  • README and HOW_IT_WORKS updated for pg, optional pool, and dedicated LISTEN client.

Changelog

  • Changeset included for @workflow/world-postgres (patch; breaking called out in body per repo convention).

@jlalmes
jlalmes requested a review from a team as a code ownerMarch 23, 2026 17:50
@changeset-bot

changeset-botBot commented Mar 23, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 30c38c7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
@workflow/world-postgresPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercelBot commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

@jlalmes is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security

socket-securityBot commented Mar 23, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Updatednpm/​@​types/​pg@​8.16.0 ⏵ 8.20.0100+110073+193+2100
Updatednpm/​pg@​8.16.3 ⏵ 8.20.099+110099+192100

View full report

---
DCO Remediation Commit for James Berry <jb@jamesbe.com>
I, James Berry <jb@jamesbe.com>, hereby add my Signed-off-by to this commit: 600d39b
Signed-off-by: James Berry <jb@jamesbe.com>

@VaguelySeriousVaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Could you merge main + fix the doc typecheck on the PR?

@jlalmes

Copy link
Copy Markdown
ContributorAuthor

@VaguelySerious, just merged main. Can't see any doc typecheck failures though.. Thanks!

@VaguelySerious
VaguelySerious enabled auto-merge (squash) March 23, 2026 23:29
@VaguelySerious
VaguelySerious merged commit 5502438 into vercel:mainMar 23, 2026
69 of 103 checks passed
pranaygp added a commit that referenced this pull request Mar 23, 2026
…rovements
* origin/main:
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
# Conflicts:
#	pnpm-lock.yaml
@ghostghost mentioned this pull request Mar 23, 2026
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-db9e68c1
* 'main' of https://github.com/vercel/workflow: (32 commits)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
[utils] Re-export parseName utilities and add workflow/observability module (#1453)
[o11y] Polish display when run data has expired (#1438)
Add CommonJS `require()` support for class serialization detection in SWC plugin (#1144)
fix(next): stabilize deferred canary e2e in nextjs workbenches (#1468)
[web] Support legacy newline-delimited stream format in `useStreamReader` (#1473)
...
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-6fadd605
* 'main' of https://github.com/vercel/workflow: (73 commits)
chore: bump next to 16.2.1 and fix deferred build (#1496)
chore: bump nitropack to ^2.13.1 (#1501)
chore: bump nuxt ecosystem dependencies (#1500)
chore: bump sveltekit ecosystem (#1498)
chore: bump express and fastify in workbenches (#1499)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
...
# Conflicts:
#	packages/core/src/runtime/start.ts
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@jlalmes@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
[feat] @workflow/world-postgres: migrate from postgres.js to pg by jlalmes · Pull Request #1484 · vercel/workflow · GitHub
Skip to content

[feat] @workflow/world-postgres: migrate from postgres.js to pg - #1484

Merged
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main
Mar 23, 2026
Merged

[feat] @workflow/world-postgres: migrate from postgres.js to pg#1484
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main

Conversation

@jlalmes

Copy link
Copy Markdown
Contributor

Summary

Migrates @workflow/world-postgres from postgres.js to node-postgres (pg) and Drizzle’s drizzle-orm/node-postgres driver. Graphile Worker now uses the same pg.Pool via pgPool. Streaming LISTEN/NOTIFY uses a dedicated pg.Client built from new Client(pool.options) so the long-lived listener does not hold a connection checked out from the shared pool.

createWorld accepts an optional pool. When the world creates its own pool from connectionString, world.close() ends that pool; when pool is passed in, world.close() does not end it (caller owns lifecycle).

Motivation

  • Align with Drizzle’s node-postgres path and a single driver stack for Drizzle + Graphile.
  • Allow apps to pass an existing pg.Pool so workflow storage and userland code can share connection configuration and pooling behavior.
  • Avoid using the shared pool for LISTEN (dedicated client for notifications).

Breaking changes

  • BREAKING: Removes the postgres (postgres.js) dependency; consumers that depended on postgres.js-specific behavior or types must switch to pg.

Implementation notes

  • Drizzle:drizzle-orm/postgres-jsdrizzle-orm/node-postgres; createClient(pool) wraps the shared pool.
  • Queue:makeWorkerUtils / run use pgPool: pool; PgBoss migration SQL uses pool.query and result.rows.
  • Streamer:pg_notify via the pool; listenChannel in listen-channel.ts uses a dedicated client from pool.options.
  • CLI: Migrations use drizzle-orm/node-postgres/migrator and a small Pool for setup.
  • Config:PostgresWorldConfig is a discriminated union: either connectionString or pool, plus existing job options.

Docs

  • README and HOW_IT_WORKS updated for pg, optional pool, and dedicated LISTEN client.

Changelog

  • Changeset included for @workflow/world-postgres (patch; breaking called out in body per repo convention).

@jlalmes
jlalmes requested a review from a team as a code ownerMarch 23, 2026 17:50
@changeset-bot

changeset-botBot commented Mar 23, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 30c38c7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
@workflow/world-postgresPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercelBot commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

@jlalmes is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security

socket-securityBot commented Mar 23, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Updatednpm/​@​types/​pg@​8.16.0 ⏵ 8.20.0100+110073+193+2100
Updatednpm/​pg@​8.16.3 ⏵ 8.20.099+110099+192100

View full report

---
DCO Remediation Commit for James Berry <jb@jamesbe.com>
I, James Berry <jb@jamesbe.com>, hereby add my Signed-off-by to this commit: 600d39b
Signed-off-by: James Berry <jb@jamesbe.com>

@VaguelySeriousVaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Could you merge main + fix the doc typecheck on the PR?

@jlalmes

Copy link
Copy Markdown
ContributorAuthor

@VaguelySerious, just merged main. Can't see any doc typecheck failures though.. Thanks!

@VaguelySerious
VaguelySerious enabled auto-merge (squash) March 23, 2026 23:29
@VaguelySerious
VaguelySerious merged commit 5502438 into vercel:mainMar 23, 2026
69 of 103 checks passed
pranaygp added a commit that referenced this pull request Mar 23, 2026
…rovements
* origin/main:
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
# Conflicts:
#	pnpm-lock.yaml
@ghostghost mentioned this pull request Mar 23, 2026
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-db9e68c1
* 'main' of https://github.com/vercel/workflow: (32 commits)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
[utils] Re-export parseName utilities and add workflow/observability module (#1453)
[o11y] Polish display when run data has expired (#1438)
Add CommonJS `require()` support for class serialization detection in SWC plugin (#1144)
fix(next): stabilize deferred canary e2e in nextjs workbenches (#1468)
[web] Support legacy newline-delimited stream format in `useStreamReader` (#1473)
...
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-6fadd605
* 'main' of https://github.com/vercel/workflow: (73 commits)
chore: bump next to 16.2.1 and fix deferred build (#1496)
chore: bump nitropack to ^2.13.1 (#1501)
chore: bump nuxt ecosystem dependencies (#1500)
chore: bump sveltekit ecosystem (#1498)
chore: bump express and fastify in workbenches (#1499)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
...
# Conflicts:
#	packages/core/src/runtime/start.ts
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@jlalmes@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [feat] @workflow/world-postgres: migrate from postgres.js to pg by jlalmes · Pull Request #1484 · vercel/workflow · GitHub
Skip to content

[feat] @workflow/world-postgres: migrate from postgres.js to pg - #1484

Merged
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main
Mar 23, 2026
Merged

[feat] @workflow/world-postgres: migrate from postgres.js to pg#1484
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main

Conversation

@jlalmes

Copy link
Copy Markdown
Contributor

Summary

Migrates @workflow/world-postgres from postgres.js to node-postgres (pg) and Drizzle’s drizzle-orm/node-postgres driver. Graphile Worker now uses the same pg.Pool via pgPool. Streaming LISTEN/NOTIFY uses a dedicated pg.Client built from new Client(pool.options) so the long-lived listener does not hold a connection checked out from the shared pool.

createWorld accepts an optional pool. When the world creates its own pool from connectionString, world.close() ends that pool; when pool is passed in, world.close() does not end it (caller owns lifecycle).

Motivation

  • Align with Drizzle’s node-postgres path and a single driver stack for Drizzle + Graphile.
  • Allow apps to pass an existing pg.Pool so workflow storage and userland code can share connection configuration and pooling behavior.
  • Avoid using the shared pool for LISTEN (dedicated client for notifications).

Breaking changes

  • BREAKING: Removes the postgres (postgres.js) dependency; consumers that depended on postgres.js-specific behavior or types must switch to pg.

Implementation notes

  • Drizzle:drizzle-orm/postgres-jsdrizzle-orm/node-postgres; createClient(pool) wraps the shared pool.
  • Queue:makeWorkerUtils / run use pgPool: pool; PgBoss migration SQL uses pool.query and result.rows.
  • Streamer:pg_notify via the pool; listenChannel in listen-channel.ts uses a dedicated client from pool.options.
  • CLI: Migrations use drizzle-orm/node-postgres/migrator and a small Pool for setup.
  • Config:PostgresWorldConfig is a discriminated union: either connectionString or pool, plus existing job options.

Docs

  • README and HOW_IT_WORKS updated for pg, optional pool, and dedicated LISTEN client.

Changelog

  • Changeset included for @workflow/world-postgres (patch; breaking called out in body per repo convention).

@jlalmes
jlalmes requested a review from a team as a code ownerMarch 23, 2026 17:50
@changeset-bot

changeset-botBot commented Mar 23, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 30c38c7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
@workflow/world-postgresPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercelBot commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

@jlalmes is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security

socket-securityBot commented Mar 23, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Updatednpm/​@​types/​pg@​8.16.0 ⏵ 8.20.0100+110073+193+2100
Updatednpm/​pg@​8.16.3 ⏵ 8.20.099+110099+192100

View full report

---
DCO Remediation Commit for James Berry <jb@jamesbe.com>
I, James Berry <jb@jamesbe.com>, hereby add my Signed-off-by to this commit: 600d39b
Signed-off-by: James Berry <jb@jamesbe.com>

@VaguelySeriousVaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Could you merge main + fix the doc typecheck on the PR?

@jlalmes

Copy link
Copy Markdown
ContributorAuthor

@VaguelySerious, just merged main. Can't see any doc typecheck failures though.. Thanks!

@VaguelySerious
VaguelySerious enabled auto-merge (squash) March 23, 2026 23:29
@VaguelySerious
VaguelySerious merged commit 5502438 into vercel:mainMar 23, 2026
69 of 103 checks passed
pranaygp added a commit that referenced this pull request Mar 23, 2026
…rovements
* origin/main:
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
# Conflicts:
#	pnpm-lock.yaml
@ghostghost mentioned this pull request Mar 23, 2026
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-db9e68c1
* 'main' of https://github.com/vercel/workflow: (32 commits)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
[utils] Re-export parseName utilities and add workflow/observability module (#1453)
[o11y] Polish display when run data has expired (#1438)
Add CommonJS `require()` support for class serialization detection in SWC plugin (#1144)
fix(next): stabilize deferred canary e2e in nextjs workbenches (#1468)
[web] Support legacy newline-delimited stream format in `useStreamReader` (#1473)
...
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-6fadd605
* 'main' of https://github.com/vercel/workflow: (73 commits)
chore: bump next to 16.2.1 and fix deferred build (#1496)
chore: bump nitropack to ^2.13.1 (#1501)
chore: bump nuxt ecosystem dependencies (#1500)
chore: bump sveltekit ecosystem (#1498)
chore: bump express and fastify in workbenches (#1499)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
...
# Conflicts:
#	packages/core/src/runtime/start.ts
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@jlalmes@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [feat] @workflow/world-postgres: migrate from postgres.js to pg by jlalmes · Pull Request #1484 · vercel/workflow · GitHub
Skip to content

[feat] @workflow/world-postgres: migrate from postgres.js to pg - #1484

Merged
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main
Mar 23, 2026
Merged

[feat] @workflow/world-postgres: migrate from postgres.js to pg#1484
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main

Conversation

@jlalmes

Copy link
Copy Markdown
Contributor

Summary

Migrates @workflow/world-postgres from postgres.js to node-postgres (pg) and Drizzle’s drizzle-orm/node-postgres driver. Graphile Worker now uses the same pg.Pool via pgPool. Streaming LISTEN/NOTIFY uses a dedicated pg.Client built from new Client(pool.options) so the long-lived listener does not hold a connection checked out from the shared pool.

createWorld accepts an optional pool. When the world creates its own pool from connectionString, world.close() ends that pool; when pool is passed in, world.close() does not end it (caller owns lifecycle).

Motivation

  • Align with Drizzle’s node-postgres path and a single driver stack for Drizzle + Graphile.
  • Allow apps to pass an existing pg.Pool so workflow storage and userland code can share connection configuration and pooling behavior.
  • Avoid using the shared pool for LISTEN (dedicated client for notifications).

Breaking changes

  • BREAKING: Removes the postgres (postgres.js) dependency; consumers that depended on postgres.js-specific behavior or types must switch to pg.

Implementation notes

  • Drizzle:drizzle-orm/postgres-jsdrizzle-orm/node-postgres; createClient(pool) wraps the shared pool.
  • Queue:makeWorkerUtils / run use pgPool: pool; PgBoss migration SQL uses pool.query and result.rows.
  • Streamer:pg_notify via the pool; listenChannel in listen-channel.ts uses a dedicated client from pool.options.
  • CLI: Migrations use drizzle-orm/node-postgres/migrator and a small Pool for setup.
  • Config:PostgresWorldConfig is a discriminated union: either connectionString or pool, plus existing job options.

Docs

  • README and HOW_IT_WORKS updated for pg, optional pool, and dedicated LISTEN client.

Changelog

  • Changeset included for @workflow/world-postgres (patch; breaking called out in body per repo convention).

@jlalmes
jlalmes requested a review from a team as a code ownerMarch 23, 2026 17:50
@changeset-bot

changeset-botBot commented Mar 23, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 30c38c7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
@workflow/world-postgresPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercelBot commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

@jlalmes is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security

socket-securityBot commented Mar 23, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Updatednpm/​@​types/​pg@​8.16.0 ⏵ 8.20.0100+110073+193+2100
Updatednpm/​pg@​8.16.3 ⏵ 8.20.099+110099+192100

View full report

---
DCO Remediation Commit for James Berry <jb@jamesbe.com>
I, James Berry <jb@jamesbe.com>, hereby add my Signed-off-by to this commit: 600d39b
Signed-off-by: James Berry <jb@jamesbe.com>

@VaguelySeriousVaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Could you merge main + fix the doc typecheck on the PR?

@jlalmes

Copy link
Copy Markdown
ContributorAuthor

@VaguelySerious, just merged main. Can't see any doc typecheck failures though.. Thanks!

@VaguelySerious
VaguelySerious enabled auto-merge (squash) March 23, 2026 23:29
@VaguelySerious
VaguelySerious merged commit 5502438 into vercel:mainMar 23, 2026
69 of 103 checks passed
pranaygp added a commit that referenced this pull request Mar 23, 2026
…rovements
* origin/main:
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
# Conflicts:
#	pnpm-lock.yaml
@ghostghost mentioned this pull request Mar 23, 2026
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-db9e68c1
* 'main' of https://github.com/vercel/workflow: (32 commits)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
[utils] Re-export parseName utilities and add workflow/observability module (#1453)
[o11y] Polish display when run data has expired (#1438)
Add CommonJS `require()` support for class serialization detection in SWC plugin (#1144)
fix(next): stabilize deferred canary e2e in nextjs workbenches (#1468)
[web] Support legacy newline-delimited stream format in `useStreamReader` (#1473)
...
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-6fadd605
* 'main' of https://github.com/vercel/workflow: (73 commits)
chore: bump next to 16.2.1 and fix deferred build (#1496)
chore: bump nitropack to ^2.13.1 (#1501)
chore: bump nuxt ecosystem dependencies (#1500)
chore: bump sveltekit ecosystem (#1498)
chore: bump express and fastify in workbenches (#1499)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
...
# Conflicts:
#	packages/core/src/runtime/start.ts
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@jlalmes@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' [feat] @workflow/world-postgres: migrate from postgres.js to pg by jlalmes · Pull Request #1484 · vercel/workflow · GitHub
Skip to content

[feat] @workflow/world-postgres: migrate from postgres.js to pg - #1484

Merged
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main
Mar 23, 2026
Merged

[feat] @workflow/world-postgres: migrate from postgres.js to pg#1484
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main

Conversation

@jlalmes

Copy link
Copy Markdown
Contributor

Summary

Migrates @workflow/world-postgres from postgres.js to node-postgres (pg) and Drizzle’s drizzle-orm/node-postgres driver. Graphile Worker now uses the same pg.Pool via pgPool. Streaming LISTEN/NOTIFY uses a dedicated pg.Client built from new Client(pool.options) so the long-lived listener does not hold a connection checked out from the shared pool.

createWorld accepts an optional pool. When the world creates its own pool from connectionString, world.close() ends that pool; when pool is passed in, world.close() does not end it (caller owns lifecycle).

Motivation

  • Align with Drizzle’s node-postgres path and a single driver stack for Drizzle + Graphile.
  • Allow apps to pass an existing pg.Pool so workflow storage and userland code can share connection configuration and pooling behavior.
  • Avoid using the shared pool for LISTEN (dedicated client for notifications).

Breaking changes

  • BREAKING: Removes the postgres (postgres.js) dependency; consumers that depended on postgres.js-specific behavior or types must switch to pg.

Implementation notes

  • Drizzle:drizzle-orm/postgres-jsdrizzle-orm/node-postgres; createClient(pool) wraps the shared pool.
  • Queue:makeWorkerUtils / run use pgPool: pool; PgBoss migration SQL uses pool.query and result.rows.
  • Streamer:pg_notify via the pool; listenChannel in listen-channel.ts uses a dedicated client from pool.options.
  • CLI: Migrations use drizzle-orm/node-postgres/migrator and a small Pool for setup.
  • Config:PostgresWorldConfig is a discriminated union: either connectionString or pool, plus existing job options.

Docs

  • README and HOW_IT_WORKS updated for pg, optional pool, and dedicated LISTEN client.

Changelog

  • Changeset included for @workflow/world-postgres (patch; breaking called out in body per repo convention).

@jlalmes
jlalmes requested a review from a team as a code ownerMarch 23, 2026 17:50
@changeset-bot

changeset-botBot commented Mar 23, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 30c38c7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
@workflow/world-postgresPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercelBot commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

@jlalmes is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security

socket-securityBot commented Mar 23, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Updatednpm/​@​types/​pg@​8.16.0 ⏵ 8.20.0100+110073+193+2100
Updatednpm/​pg@​8.16.3 ⏵ 8.20.099+110099+192100

View full report

---
DCO Remediation Commit for James Berry <jb@jamesbe.com>
I, James Berry <jb@jamesbe.com>, hereby add my Signed-off-by to this commit: 600d39b
Signed-off-by: James Berry <jb@jamesbe.com>

@VaguelySeriousVaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Could you merge main + fix the doc typecheck on the PR?

@jlalmes

Copy link
Copy Markdown
ContributorAuthor

@VaguelySerious, just merged main. Can't see any doc typecheck failures though.. Thanks!

@VaguelySerious
VaguelySerious enabled auto-merge (squash) March 23, 2026 23:29
@VaguelySerious
VaguelySerious merged commit 5502438 into vercel:mainMar 23, 2026
69 of 103 checks passed
pranaygp added a commit that referenced this pull request Mar 23, 2026
…rovements
* origin/main:
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
# Conflicts:
#	pnpm-lock.yaml
@ghostghost mentioned this pull request Mar 23, 2026
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-db9e68c1
* 'main' of https://github.com/vercel/workflow: (32 commits)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
[utils] Re-export parseName utilities and add workflow/observability module (#1453)
[o11y] Polish display when run data has expired (#1438)
Add CommonJS `require()` support for class serialization detection in SWC plugin (#1144)
fix(next): stabilize deferred canary e2e in nextjs workbenches (#1468)
[web] Support legacy newline-delimited stream format in `useStreamReader` (#1473)
...
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-6fadd605
* 'main' of https://github.com/vercel/workflow: (73 commits)
chore: bump next to 16.2.1 and fix deferred build (#1496)
chore: bump nitropack to ^2.13.1 (#1501)
chore: bump nuxt ecosystem dependencies (#1500)
chore: bump sveltekit ecosystem (#1498)
chore: bump express and fastify in workbenches (#1499)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
...
# Conflicts:
#	packages/core/src/runtime/start.ts
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@jlalmes@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [feat] @workflow/world-postgres: migrate from postgres.js to pg by jlalmes · Pull Request #1484 · vercel/workflow · GitHub
Skip to content

[feat] @workflow/world-postgres: migrate from postgres.js to pg - #1484

Merged
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main
Mar 23, 2026
Merged

[feat] @workflow/world-postgres: migrate from postgres.js to pg#1484
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main

Conversation

@jlalmes

Copy link
Copy Markdown
Contributor

Summary

Migrates @workflow/world-postgres from postgres.js to node-postgres (pg) and Drizzle’s drizzle-orm/node-postgres driver. Graphile Worker now uses the same pg.Pool via pgPool. Streaming LISTEN/NOTIFY uses a dedicated pg.Client built from new Client(pool.options) so the long-lived listener does not hold a connection checked out from the shared pool.

createWorld accepts an optional pool. When the world creates its own pool from connectionString, world.close() ends that pool; when pool is passed in, world.close() does not end it (caller owns lifecycle).

Motivation

  • Align with Drizzle’s node-postgres path and a single driver stack for Drizzle + Graphile.
  • Allow apps to pass an existing pg.Pool so workflow storage and userland code can share connection configuration and pooling behavior.
  • Avoid using the shared pool for LISTEN (dedicated client for notifications).

Breaking changes

  • BREAKING: Removes the postgres (postgres.js) dependency; consumers that depended on postgres.js-specific behavior or types must switch to pg.

Implementation notes

  • Drizzle:drizzle-orm/postgres-jsdrizzle-orm/node-postgres; createClient(pool) wraps the shared pool.
  • Queue:makeWorkerUtils / run use pgPool: pool; PgBoss migration SQL uses pool.query and result.rows.
  • Streamer:pg_notify via the pool; listenChannel in listen-channel.ts uses a dedicated client from pool.options.
  • CLI: Migrations use drizzle-orm/node-postgres/migrator and a small Pool for setup.
  • Config:PostgresWorldConfig is a discriminated union: either connectionString or pool, plus existing job options.

Docs

  • README and HOW_IT_WORKS updated for pg, optional pool, and dedicated LISTEN client.

Changelog

  • Changeset included for @workflow/world-postgres (patch; breaking called out in body per repo convention).

@jlalmes
jlalmes requested a review from a team as a code ownerMarch 23, 2026 17:50
@changeset-bot

changeset-botBot commented Mar 23, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 30c38c7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
@workflow/world-postgresPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercelBot commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

@jlalmes is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security

socket-securityBot commented Mar 23, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Updatednpm/​@​types/​pg@​8.16.0 ⏵ 8.20.0100+110073+193+2100
Updatednpm/​pg@​8.16.3 ⏵ 8.20.099+110099+192100

View full report

---
DCO Remediation Commit for James Berry <jb@jamesbe.com>
I, James Berry <jb@jamesbe.com>, hereby add my Signed-off-by to this commit: 600d39b
Signed-off-by: James Berry <jb@jamesbe.com>

@VaguelySeriousVaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Could you merge main + fix the doc typecheck on the PR?

@jlalmes

Copy link
Copy Markdown
ContributorAuthor

@VaguelySerious, just merged main. Can't see any doc typecheck failures though.. Thanks!

@VaguelySerious
VaguelySerious enabled auto-merge (squash) March 23, 2026 23:29
@VaguelySerious
VaguelySerious merged commit 5502438 into vercel:mainMar 23, 2026
69 of 103 checks passed
pranaygp added a commit that referenced this pull request Mar 23, 2026
…rovements
* origin/main:
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
# Conflicts:
#	pnpm-lock.yaml
@ghostghost mentioned this pull request Mar 23, 2026
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-db9e68c1
* 'main' of https://github.com/vercel/workflow: (32 commits)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
[utils] Re-export parseName utilities and add workflow/observability module (#1453)
[o11y] Polish display when run data has expired (#1438)
Add CommonJS `require()` support for class serialization detection in SWC plugin (#1144)
fix(next): stabilize deferred canary e2e in nextjs workbenches (#1468)
[web] Support legacy newline-delimited stream format in `useStreamReader` (#1473)
...
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-6fadd605
* 'main' of https://github.com/vercel/workflow: (73 commits)
chore: bump next to 16.2.1 and fix deferred build (#1496)
chore: bump nitropack to ^2.13.1 (#1501)
chore: bump nuxt ecosystem dependencies (#1500)
chore: bump sveltekit ecosystem (#1498)
chore: bump express and fastify in workbenches (#1499)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
...
# Conflicts:
#	packages/core/src/runtime/start.ts
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@jlalmes@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [feat] @workflow/world-postgres: migrate from postgres.js to pg by jlalmes · Pull Request #1484 · vercel/workflow · GitHub
Skip to content

[feat] @workflow/world-postgres: migrate from postgres.js to pg - #1484

Merged
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main
Mar 23, 2026
Merged

[feat] @workflow/world-postgres: migrate from postgres.js to pg#1484
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main

Conversation

@jlalmes

Copy link
Copy Markdown
Contributor

Summary

Migrates @workflow/world-postgres from postgres.js to node-postgres (pg) and Drizzle’s drizzle-orm/node-postgres driver. Graphile Worker now uses the same pg.Pool via pgPool. Streaming LISTEN/NOTIFY uses a dedicated pg.Client built from new Client(pool.options) so the long-lived listener does not hold a connection checked out from the shared pool.

createWorld accepts an optional pool. When the world creates its own pool from connectionString, world.close() ends that pool; when pool is passed in, world.close() does not end it (caller owns lifecycle).

Motivation

  • Align with Drizzle’s node-postgres path and a single driver stack for Drizzle + Graphile.
  • Allow apps to pass an existing pg.Pool so workflow storage and userland code can share connection configuration and pooling behavior.
  • Avoid using the shared pool for LISTEN (dedicated client for notifications).

Breaking changes

  • BREAKING: Removes the postgres (postgres.js) dependency; consumers that depended on postgres.js-specific behavior or types must switch to pg.

Implementation notes

  • Drizzle:drizzle-orm/postgres-jsdrizzle-orm/node-postgres; createClient(pool) wraps the shared pool.
  • Queue:makeWorkerUtils / run use pgPool: pool; PgBoss migration SQL uses pool.query and result.rows.
  • Streamer:pg_notify via the pool; listenChannel in listen-channel.ts uses a dedicated client from pool.options.
  • CLI: Migrations use drizzle-orm/node-postgres/migrator and a small Pool for setup.
  • Config:PostgresWorldConfig is a discriminated union: either connectionString or pool, plus existing job options.

Docs

  • README and HOW_IT_WORKS updated for pg, optional pool, and dedicated LISTEN client.

Changelog

  • Changeset included for @workflow/world-postgres (patch; breaking called out in body per repo convention).

@jlalmes
jlalmes requested a review from a team as a code ownerMarch 23, 2026 17:50
@changeset-bot

changeset-botBot commented Mar 23, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 30c38c7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
@workflow/world-postgresPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercelBot commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

@jlalmes is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security

socket-securityBot commented Mar 23, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Updatednpm/​@​types/​pg@​8.16.0 ⏵ 8.20.0100+110073+193+2100
Updatednpm/​pg@​8.16.3 ⏵ 8.20.099+110099+192100

View full report

---
DCO Remediation Commit for James Berry <jb@jamesbe.com>
I, James Berry <jb@jamesbe.com>, hereby add my Signed-off-by to this commit: 600d39b
Signed-off-by: James Berry <jb@jamesbe.com>

@VaguelySeriousVaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Could you merge main + fix the doc typecheck on the PR?

@jlalmes

Copy link
Copy Markdown
ContributorAuthor

@VaguelySerious, just merged main. Can't see any doc typecheck failures though.. Thanks!

@VaguelySerious
VaguelySerious enabled auto-merge (squash) March 23, 2026 23:29
@VaguelySerious
VaguelySerious merged commit 5502438 into vercel:mainMar 23, 2026
69 of 103 checks passed
pranaygp added a commit that referenced this pull request Mar 23, 2026
…rovements
* origin/main:
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
# Conflicts:
#	pnpm-lock.yaml
@ghostghost mentioned this pull request Mar 23, 2026
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-db9e68c1
* 'main' of https://github.com/vercel/workflow: (32 commits)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
[utils] Re-export parseName utilities and add workflow/observability module (#1453)
[o11y] Polish display when run data has expired (#1438)
Add CommonJS `require()` support for class serialization detection in SWC plugin (#1144)
fix(next): stabilize deferred canary e2e in nextjs workbenches (#1468)
[web] Support legacy newline-delimited stream format in `useStreamReader` (#1473)
...
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-6fadd605
* 'main' of https://github.com/vercel/workflow: (73 commits)
chore: bump next to 16.2.1 and fix deferred build (#1496)
chore: bump nitropack to ^2.13.1 (#1501)
chore: bump nuxt ecosystem dependencies (#1500)
chore: bump sveltekit ecosystem (#1498)
chore: bump express and fastify in workbenches (#1499)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
...
# Conflicts:
#	packages/core/src/runtime/start.ts
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@jlalmes@VaguelySerious
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); [feat] @workflow/world-postgres: migrate from postgres.js to pg by jlalmes · Pull Request #1484 · vercel/workflow · GitHub
Skip to content

[feat] @workflow/world-postgres: migrate from postgres.js to pg - #1484

Merged
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main
Mar 23, 2026
Merged

[feat] @workflow/world-postgres: migrate from postgres.js to pg#1484
VaguelySerious merged 2 commits into
vercel:mainfrom
jlalmes:main

Conversation

@jlalmes

Copy link
Copy Markdown
Contributor

Summary

Migrates @workflow/world-postgres from postgres.js to node-postgres (pg) and Drizzle’s drizzle-orm/node-postgres driver. Graphile Worker now uses the same pg.Pool via pgPool. Streaming LISTEN/NOTIFY uses a dedicated pg.Client built from new Client(pool.options) so the long-lived listener does not hold a connection checked out from the shared pool.

createWorld accepts an optional pool. When the world creates its own pool from connectionString, world.close() ends that pool; when pool is passed in, world.close() does not end it (caller owns lifecycle).

Motivation

  • Align with Drizzle’s node-postgres path and a single driver stack for Drizzle + Graphile.
  • Allow apps to pass an existing pg.Pool so workflow storage and userland code can share connection configuration and pooling behavior.
  • Avoid using the shared pool for LISTEN (dedicated client for notifications).

Breaking changes

  • BREAKING: Removes the postgres (postgres.js) dependency; consumers that depended on postgres.js-specific behavior or types must switch to pg.

Implementation notes

  • Drizzle:drizzle-orm/postgres-jsdrizzle-orm/node-postgres; createClient(pool) wraps the shared pool.
  • Queue:makeWorkerUtils / run use pgPool: pool; PgBoss migration SQL uses pool.query and result.rows.
  • Streamer:pg_notify via the pool; listenChannel in listen-channel.ts uses a dedicated client from pool.options.
  • CLI: Migrations use drizzle-orm/node-postgres/migrator and a small Pool for setup.
  • Config:PostgresWorldConfig is a discriminated union: either connectionString or pool, plus existing job options.

Docs

  • README and HOW_IT_WORKS updated for pg, optional pool, and dedicated LISTEN client.

Changelog

  • Changeset included for @workflow/world-postgres (patch; breaking called out in body per repo convention).

@jlalmes
jlalmes requested a review from a team as a code ownerMarch 23, 2026 17:50
@changeset-bot

changeset-botBot commented Mar 23, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 30c38c7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
NameType
@workflow/world-postgresPatch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercelBot commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

@jlalmes is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security

socket-securityBot commented Mar 23, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Updatednpm/​@​types/​pg@​8.16.0 ⏵ 8.20.0100+110073+193+2100
Updatednpm/​pg@​8.16.3 ⏵ 8.20.099+110099+192100

View full report

---
DCO Remediation Commit for James Berry <jb@jamesbe.com>
I, James Berry <jb@jamesbe.com>, hereby add my Signed-off-by to this commit: 600d39b
Signed-off-by: James Berry <jb@jamesbe.com>

@VaguelySeriousVaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Could you merge main + fix the doc typecheck on the PR?

@jlalmes

Copy link
Copy Markdown
ContributorAuthor

@VaguelySerious, just merged main. Can't see any doc typecheck failures though.. Thanks!

@VaguelySerious
VaguelySerious enabled auto-merge (squash) March 23, 2026 23:29
@VaguelySerious
VaguelySerious merged commit 5502438 into vercel:mainMar 23, 2026
69 of 103 checks passed
pranaygp added a commit that referenced this pull request Mar 23, 2026
…rovements
* origin/main:
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
# Conflicts:
#	pnpm-lock.yaml
@ghostghost mentioned this pull request Mar 23, 2026
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-db9e68c1
* 'main' of https://github.com/vercel/workflow: (32 commits)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
[utils] Re-export parseName utilities and add workflow/observability module (#1453)
[o11y] Polish display when run data has expired (#1438)
Add CommonJS `require()` support for class serialization detection in SWC plugin (#1144)
fix(next): stabilize deferred canary e2e in nextjs workbenches (#1468)
[web] Support legacy newline-delimited stream format in `useStreamReader` (#1473)
...
pranaygp added a commit that referenced this pull request Mar 24, 2026
…naygp-6fadd605
* 'main' of https://github.com/vercel/workflow: (73 commits)
chore: bump next to 16.2.1 and fix deferred build (#1496)
chore: bump nitropack to ^2.13.1 (#1501)
chore: bump nuxt ecosystem dependencies (#1500)
chore: bump sveltekit ecosystem (#1498)
chore: bump express and fastify in workbenches (#1499)
chore: bump @nestjs/* to ^11.1.17 (#1497)
chore: bump hono to ^4.12.8 (#1495)
Revert "Inline class serialization registration to fix 3rd-party package supp…" (#1493)
[world] Add stream pagination and metadata endpoints (#1470)
[cli] [world-local] Ensure update checks don't suggest upgrading from stable release to pre-releases (#1490)
Remove NestJS Vercel integration while in experimental phase (#1485)
feat: export semantic error types and add API reference docs (#1447)
feat: enforce max queue deliveries in handlers with graceful failure (#1344)
[world-postgres] Migrate client from `postgres.js` to `pg` (#1484)
Inline class serialization registration to fix 3rd-party package support (#1480)
[ai] Add experimental_context to DurableAgentOptions (#1489)
[ai] Expose configured tools on DurableAgent instances (#1488)
fix(builders): catch node builtin usage when entry fields diverge (#1455)
[web-shared] Fix timeline duration format and precision (#1482)
[cli] Add bulk cancel, --status filter, fix step JSON hydration (#1467)
...
# Conflicts:
#	packages/core/src/runtime/start.ts
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@jlalmes@VaguelySerious