@all2cf/database-connect
v0.2.0-rc.2
Published
PostgreSQL-compatible Service Binding client and loopback connector for All2CF Database
Readme
All2CF Database Connect
Cloudflare Workers import pg through the lightweight Service Binding client:
Run the short command shown by the database page from the Worker project root:
npx @all2cf/[email protected] db_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxThe database identifier is not a credential. The installer uses the customer's existing
Wrangler login to confirm that the Database Worker is visible in the same Cloudflare account,
preserves business source and the original Wrangler file, writes a deployment overlay, and runs
wrangler deploy --dry-run. It never deploys automatically; it prints the exact deploy command.
To remove the generated local overlay and dependency, run:
npx @all2cf/[email protected] rm db_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx{
"alias": { "pg": "@all2cf/database-connect/pg" },
"services": [{
"binding": "ALL2CF_DATABASE",
"service": "edgepg-database-worker",
"entrypoint": "All2CFDatabase",
"remote": true
}]
}Application TypeScript and SQL stay unchanged. A connected client opens one RPC session; a
transaction therefore remains on one EdgePG client. Each session permits 28 query calls so
Cloudflare's 32-invocation request limit is never reached unexpectedly. Use client.batch()
or a database job for larger units of work.
Non-Worker applications and PostgreSQL tools continue to use the loopback connector below.
@all2cf/database-connect exposes an All2CF-managed CF Postgres database
Worker as a loopback-only PostgreSQL endpoint for local or non-Cloudflare
Node.js projects.
npm install --global ./all2cf-database-connect-0.1.0-rc.3.tgz
a2c-db-connect \
--worker-url "$A2C_DATABASE_WORKER_URL" \
--token "$A2C_DATABASE_CONNECT_TOKEN"The command prints a standard DATABASE_URL. Keep the process running while
the application is connected. Stop it and replace DATABASE_URL to switch the
application back to native PostgreSQL.
The connector:
- binds only to
127.0.0.1,localhost, or[::1]; - forwards PostgreSQL bytes directly over an authenticated WebSocket;
- does not parse SQL, store database credentials, or deploy a Worker;
- requires Node.js 24 or newer.
