# dbSDK

> One typed PostgreSQL client for Supabase and Neon. Parameterized SQL, one result shape, explicit transports, and errors that never retry a write on their own.

## Docs

- [Getting started](https://dbsdk.com/docs/getting-started): Build dbSDK from a local clone, pick an adapter, and run your first parameterized query.
- [Capabilities](https://dbsdk.com/docs/capabilities): What each dbSDK adapter and transport supports, with the evidence behind each cell.
- [Queries](https://dbsdk.com/docs/queries): The two query entry points, parameterization rules, reusable statements, and what the type parameter does and does not guarantee.
- [Transactions](https://dbsdk.com/docs/transactions): Interactive transactions, atomic batches, what happens when a connection drops mid-write, and the no-replay rule.
- [Errors](https://dbsdk.com/docs/errors): One normalized DbError with codes, SQLSTATE passthrough, retryable, and the indeterminate flag for writes with unknown outcomes.
- [Testing](https://dbsdk.com/docs/testing): The fixture adapter for tests with zero credentials, and when to test against a real database instead.
- [Frameworks](https://dbsdk.com/docs/frameworks): Patterns for Express, Next.js, and serverless runtimes, where pool lifetimes and disposal decide whether things work.
- [Switching providers](https://dbsdk.com/docs/switching): How to change adapters between Postgres, Supabase, and Neon, what carries over, and what you must move yourself.
- [Installation](https://dbsdk.com/docs/installation): Detailed local-clone build, pack, and consumer setup. npm is not published; this page is the honest way to get the package today.
- [FAQ](https://dbsdk.com/docs/faq): Straight answers about scope, safety, and what dbSDK does not do.

### Adapters

- [Postgres adapter](https://dbsdk.com/docs/adapters/postgres): Any PostgreSQL endpoint over TCP with the official pg driver, for local databases and providers beyond the launch adapters.
- [Supabase adapter](https://dbsdk.com/docs/adapters/supabase): Supabase Postgres over an explicit connection mode, with strict validation, transaction-pooler guards, and the auth and RLS boundary stated plainly.
- [Neon adapter](https://dbsdk.com/docs/adapters/neon): Neon over HTTP, WebSocket, or TCP transaction transports, with capabilities that differ by transport and are always explicit.

## Agent skills

- [dbsdk](https://dbsdk.com/.well-known/agent-skills/dbsdk/SKILL.md): Read the dbSDK docs instead of answering from memory. One typed PostgreSQL client for Supabase and Neon. Parameterized SQL, one result shape, explicit transports, and errors that never retry a write on their own. Use when a task involves dbSDK: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://dbsdk.com/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://dbsdk.com/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://dbsdk.com/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://dbsdk.com/openapi.json.
- [MCP server](https://dbsdk.com/mcp): Streamable HTTP Model Context Protocol server with search_docs, get_page, list_pages, and get_navigation tools, plus every page as a resource. Discovery document: https://dbsdk.com/.well-known/mcp.json
- [Agent skills](https://dbsdk.com/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://dbsdk.com/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://dbsdk.com/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://dbsdk.com/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://dbsdk.com/sitemap.xml): Every indexable page URL with its last-modified date.