@nextlyhq/adapter-postgres 0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 NextlyHQ <info@nextlyhq.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @nextlyhq/adapter-postgres
+
+PostgreSQL database adapter for Nextly. Built on `pg` (node-postgres) with connection pooling, transactions, JSONB, and array support.
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@nextlyhq/adapter-postgres"><img alt="npm" src="https://img.shields.io/npm/v/@nextlyhq/adapter-postgres?style=flat-square&label=npm&color=cb3837" /></a>
+  <a href="https://github.com/nextlyhq/nextly/blob/main/LICENSE.md"><img alt="License" src="https://img.shields.io/github/license/nextlyhq/nextly?style=flat-square&color=blue" /></a>
+  <a href="https://nextlyhq.com/docs"><img alt="Status" src="https://img.shields.io/badge/status-alpha-orange?style=flat-square" /></a>
+</p>
+
+> [!IMPORTANT]
+> Nextly is in alpha. APIs may change before 1.0. Pin exact versions in production.
+
+## What it is
+
+The PostgreSQL adapter for Nextly. Use this if your database is PostgreSQL or any PG-compatible cloud (Neon, Supabase, RDS, Aurora PG, Railway, Cloud SQL).
+
+> [!TIP]
+> **PostgreSQL is the recommended production database for Nextly.** It has the full feature set (JSONB, arrays, native ILIKE, savepoints, `RETURNING`, full-text search via `tsvector`) and the fewest behavioural workarounds. Pick this dialect for any new project unless you have a strong reason to choose MySQL or SQLite.
+
+## Installation
+
+```bash
+pnpm add @nextlyhq/adapter-postgres pg
+pnpm add -D @types/pg
+```
+
+## Quick usage
+
+Nextly selects the adapter from your `.env` file. Install the package and set:
+
+```bash
+DB_DIALECT=postgresql
+DATABASE_URL=postgresql://user:password@localhost:5432/mydb
+```
+
+That is it. Nextly's runtime instantiates the adapter on boot.
+
+## Required environment variables
+
+| Variable       | Required?   | Default                  | Notes                                   |
+| -------------- | ----------- | ------------------------ | --------------------------------------- |
+| `DATABASE_URL` | yes         | (none)                   | Standard `postgresql://...` URL.        |
+| `DB_DIALECT`   | recommended | (auto-detected from URL) | One of `postgresql`, `mysql`, `sqlite`. |
+
+For SSL on managed providers (Neon, Supabase, RDS), append `?sslmode=require` to the URL or set `PGSSLMODE=require`.
+
+## Programmatic usage (advanced)
+
+For custom bootstrap such as test harnesses or scripts, import the factory:
+
+```ts
+import { createPostgresAdapter } from "@nextlyhq/adapter-postgres";
+
+const adapter = createPostgresAdapter({
+  url: process.env.DATABASE_URL!,
+});
+
+await adapter.connect();
+```
+
+Most users do not need this. The framework's runtime does it automatically.
+
+## Supported PostgreSQL versions
+
+- PostgreSQL 15.0 or newer required
+- Tested against PostgreSQL 15, 16, 17
+- Cloud providers: Neon (also reachable via Vercel Marketplace), Supabase, AWS RDS, Aurora PG, Railway, Google Cloud SQL
+
+## Main exports
+
+- `PostgresAdapter`: the adapter class
+- `createPostgresAdapter`: factory for programmatic use
+- `isPostgresAdapter`: type guard
+- Type exports: `PostgresAdapterConfig`
+
+## Compatibility
+
+| Tool     | Version |
+| -------- | ------- |
+| Node.js  | 20+     |
+| `pg`     | 8.10+   |
+| `nextly` | 0.0.x   |
+
+## Documentation
+
+- [**PostgreSQL adapter docs**](https://nextlyhq.com/docs/database/postgres)
+- [**Database support and version policy**](https://nextlyhq.com/docs/database/support)
+
+## Related packages
+
+- [`@nextlyhq/adapter-mysql`](../adapter-mysql)
+- [`@nextlyhq/adapter-sqlite`](../adapter-sqlite)
+
+## License
+
+[MIT](../../LICENSE.md)