chore(pglite): productize adapter + pglite-test for publish

- Make @electric-sql/pglite a peerDependency of @pgpmjs/pglite-adapter and
  pglite-test (kept as a pinned devDependency for the monorepo build/tests),
  so consumers pin the PGlite version and avoid duplicate installs.
- Harden pglite-test getConnections: restore the previous client factory on
  teardown (instead of resetting to default) and unwind seams if setup throws.
- Rename workflow pglite-poc.yaml -> pglite.yaml (job pglite-socket-e2e); it is
  the standalone wire-protocol e2e demo. The in-process path already runs in the
  no-services unit-tests (pglite) job in run-tests.yaml.
- Add CHANGELOG.md stubs for both new packages.

Author: pyramation

.github/workflows/pglite-poc.yaml

@@ -0,0 +1,40 @@
+name: PGlite (socket e2e)
+
+# End-to-end demonstration of the pgpm migrate engine deploying real migrations
+# into PGlite (WASM Postgres) over the pg-gateway wire-protocol shim, using the
+# UNMODIFIED published @pgpmjs/core. Standalone (own lockfile, outside the pnpm
+# workspace). Deliberately has NO `services:` block — PGlite runs in-process, so
+# no Postgres service container is needed.
+#
+# The in-process driver path (@pgpmjs/pglite-adapter + pglite-test) is covered
+# separately by the no-services `unit-tests (pglite ...)` job in run-tests.yaml.
+
+on:
+  push:
+    branches: [main, v1]
+    paths:
+      - 'poc/pglite/**'
+      - '.github/workflows/pglite.yaml'
+  pull_request:
+    branches: [main, v1]
+    paths:
+      - 'poc/pglite/**'
+      - '.github/workflows/pglite.yaml'
+  workflow_dispatch:
+
+jobs:
+  pglite-socket-e2e:
+    if: github.event.pull_request.draft != true
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Install (standalone, not the monorepo)
+        working-directory: poc/pglite
+        run: npm ci
+      - name: Deploy pgpm migrations into PGlite (no Postgres service)
+        working-directory: poc/pglite
+        run: npm start

.github/workflows/pglite.yaml

@@ -177,7 +177,7 @@ single-writer backend, but is not required for this rollout.
 2. **`@pgpmjs/pglite-adapter`** (in-process driver, all pglite deps here). ✅ **DONE** — `registerPglite()` registers a PGlite-backed `QueryablePool`; 6 tests deploy→verify→revert an unmodified pgpm plan into in-process PGlite (no socket), with `useTransaction: true`.
 2b. **`pgsql-client` client-factory seam** (default = `new pg.Client`; zero behavior change). ✅ **DONE** — `registerPgClientFactory` / `defaultPgClientFactory` / `getActivePgClientFactory`, mirroring the `pg-cache` pool seam; `PgClient` routes its underlying client through it; 4 unit tests. Needed because `pgsql-test`/`pgsql-client` build `pg.Client`s directly rather than via `getPgPool`.
 3. **`pglite-test`** drop-in `getConnections` (instance-per-suite). ✅ **DONE** — composes `registerPglite()` (pool seam) + `registerPgClientFactory` (client seam) so `pg`/`db` share one in-process PGlite session; a `SharedTxn` ref-counter keeps the standard two-client `beforeEach`/`afterEach` savepoint harness working over a single session; seeds via `seed.pgpm()`; no `createdb`/`psql`. 5 tests cover deploy, per-test isolation, and RLS role/JWT switching (incl. `WITH CHECK`). No separate PGlite-aware `DbAdmin` subclass was needed — the instance *is* the database and extension/role bootstrap runs via `pglite.extensionSql`.
-4. This PoC's socket-shim CI job (`pglite-poc.yaml`) is **kept as-is** — it's a standalone, out-of-workspace demonstration of the `pg-gateway` wire-protocol path (own lockfile, published `@pgpmjs/core`). The canonical in-process path is now proven by the `@pgpmjs/pglite-adapter` and `pglite-test` jest suites in `run-tests.yaml` (no-services tier).
+4. The socket-shim CI job (`pglite.yaml`, job `pglite-socket-e2e`) is **kept** — a standalone, out-of-workspace demonstration of the `pg-gateway` wire-protocol path (own lockfile, published `@pgpmjs/core`). The canonical in-process path is proven by the `@pgpmjs/pglite-adapter` and `pglite-test` jest suites in the no-services `unit-tests (pglite ...)` job in `run-tests.yaml`.
 5. (Optional) Core transaction-client fix — only if a *multi-connection* single-writer backend is ever targeted; the in-process adapter does not need it.
 6. (Future) `pgpm init --pglite` scaffolder — CLI-layer convenience; no PGlite dep in core.
 

pnpm-lock.yaml

@@ -11,7 +11,7 @@ npm ci
 npm start   # boots PGlite in-process, runs pgpm deploy -> verify -> revert, asserts
 ```
 
-This runs in CI via `.github/workflows/pglite-poc.yaml` with no `services:` block —
+This runs in CI via `.github/workflows/pglite.yaml` with no `services:` block —
 the whole point: PGlite needs no external database.
 
 ## What it does

poc/pglite/DESIGN.md

@@ -0,0 +1,4 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

poc/pglite/README.md

@@ -40,12 +40,15 @@
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch"
   },
   "devDependencies": {
+    "@electric-sql/pglite": "0.5.4",
     "@pgpmjs/core": "workspace:^",
     "@types/pg": "^8.20.0",
     "makage": "^0.3.0"
   },
   "dependencies": {
-    "@electric-sql/pglite": "0.5.4",
     "pg-cache": "workspace:^"
+  },
+  "peerDependencies": {
+    "@electric-sql/pglite": ">=0.5.0"
   }
 }

postgres/pglite-adapter/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

postgres/pglite-adapter/package.json

@@ -41,16 +41,19 @@
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch"
   },
   "devDependencies": {
+    "@electric-sql/pglite": "0.5.4",
     "@types/pg": "^8.20.0",
     "makage": "^0.3.0"
   },
   "dependencies": {
-    "@electric-sql/pglite": "0.5.4",
     "@pgpmjs/env": "workspace:^",
     "@pgpmjs/pglite-adapter": "workspace:^",
     "pg-cache": "workspace:^",
     "pg-env": "workspace:^",
     "pgsql-client": "workspace:^",
     "pgsql-test": "workspace:^"
+  },
+  "peerDependencies": {
+    "@electric-sql/pglite": ">=0.5.0"
   }
 }

postgres/pglite-test/CHANGELOG.md

@@ -32,7 +32,7 @@
 import type { PGlite } from '@electric-sql/pglite';
 import { createPgliteClient,registerPglite } from '@pgpmjs/pglite-adapter';
 import { getPgEnvOptions, PgConfig } from 'pg-env';
-import { registerPgClientFactory } from 'pgsql-client';
+import { getActivePgClientFactory, registerPgClientFactory } from 'pgsql-client';
 import { DbAdmin, GetConnectionOpts, PgTestClient, seed, SeedAdapter } from 'pgsql-test';
 
 import { PgliteTestClient, SharedTxn } from './txn';
@@ -75,6 +75,11 @@ export const getConnections = async (
   cn: PgliteConnectionOpts = {},
   seedAdapters: SeedAdapter[] = [seed.pgpm()]
 ): Promise<PgliteConnectionResult> => {
+  // Capture the previously-active client factory so teardown restores it
+  // (rather than clobbering to the default), mirroring how registerPglite
+  // restores the previous pool factory. Keeps nested/sequential suites clean.
+  const previousClientFactory = getActivePgClientFactory();
+
   const handle = await registerPglite({
     dataDir: cn.pglite?.dataDir,
     extensions: cn.pglite?.extensions,
@@ -85,30 +90,38 @@ export const getConnections = async (
   // Route pgsql-client's PgClient at the same in-process PGlite session.
   registerPgClientFactory(() => createPgliteClient(handle.db));
 
-  const config: PgConfig = getPgEnvOptions({ database: 'postgres', ...cn.pg });
+  try {
+    const config: PgConfig = getPgEnvOptions({ database: 'postgres', ...cn.pg });
 
-  const txn = new SharedTxn();
-  const pg = new PgliteTestClient(config, {}, txn);
-  const db = new PgliteTestClient(config, { auth: cn.db?.auth, roles: cn.db?.roles }, txn);
+    const txn = new SharedTxn();
+    const pg = new PgliteTestClient(config, {}, txn);
+    const db = new PgliteTestClient(config, { auth: cn.db?.auth, roles: cn.db?.roles }, txn);
 
-  // seed.pgpm deploys via getPgPool -> PGlite; sqlfile/json/csv/fn use ctx.pg.
-  if (seedAdapters.length) {
-    await seed.compose(seedAdapters).seed({
-      connect: cn.db ?? {},
-      admin: undefined as unknown as DbAdmin, // unused by the PGlite-safe adapters
-      config,
-      pg
-    });
-  }
+    // seed.pgpm deploys via getPgPool -> PGlite; sqlfile/json/csv/fn use ctx.pg.
+    if (seedAdapters.length) {
+      await seed.compose(seedAdapters).seed({
+        connect: cn.db ?? {},
+        admin: undefined as unknown as DbAdmin, // unused by the PGlite-safe adapters
+        config,
+        pg
+      });
+    }
 
-  const teardown = async (): Promise<void> => {
-    registerPgClientFactory(undefined);
-    await pg.close();
-    await db.close();
-    await handle.close();
-  };
+    const teardown = async (): Promise<void> => {
+      registerPgClientFactory(previousClientFactory);
+      await pg.close();
+      await db.close();
+      await handle.close();
+    };
 
-  return { pg, db, instance: handle.db, teardown };
+    return { pg, db, instance: handle.db, teardown };
+  } catch (err) {
+    // Setup failed after registering the seams — unwind so a broken suite
+    // doesn't leak factories/instance into the next one.
+    registerPgClientFactory(previousClientFactory);
+    await handle.close();
+    throw err;
+  }
 };
 
 export { PgliteTestClient, SharedTxn } from './txn';