@reventlessdev/reventless-postgres 3.0.0-alpha.9 → 3.0.0-alpha.90

package/CHANGELOG.md

@@ -3,6 +3,656 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 3.0.0-alpha.90 (2026-08-12)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.89 (2026-08-12)
+
+### Features
+
+* **queries:** narrow owner-bearing reads to the caller ([ba9cc3d](https://github.com/ReventlessDev/reventless-core/commit/ba9cc3d58d7914a9e4827bda90a704a74b1b82dd))
+
+
+# 3.0.0-alpha.88 (2026-08-11)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.87 (2026-08-10)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.86 (2026-08-10)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.85 (2026-08-09)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.84 (2026-08-09)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.83 (2026-08-09)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.82 (2026-08-09)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.81 (2026-08-08)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.80 (2026-08-08)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.79 (2026-08-08)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.78 (2026-08-07)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.77 (2026-08-05)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.76 (2026-08-04)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.75 (2026-08-04)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.74 (2026-08-04)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.73 (2026-08-03)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.72 (2026-08-03)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.71 (2026-08-03)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.70 (2026-08-03)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.69 (2026-08-02)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.68 (2026-08-02)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.67 (2026-08-02)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.66 (2026-08-02)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.65 (2026-08-02)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.64 (2026-08-01)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.63 (2026-08-01)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.62 (2026-08-01)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.61 (2026-08-01)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.60 (2026-07-31)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.59 (2026-07-30)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.58 (2026-07-30)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.57 (2026-07-30)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.56 (2026-07-30)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.55 (2026-07-29)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.54 (2026-07-28)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.53 (2026-07-28)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.52 (2026-07-28)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.51 (2026-07-28)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.50 (2026-07-27)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.49 (2026-07-27)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.48 (2026-07-27)
+
+* refactor(aws)!: convert remaining Group-1 entry points to typed-core/thin-shell; fix Counter publish + EP stub wiring ([d7f1aeb](https://github.com/ReventlessDev/reventless-core/commit/d7f1aeb90cfc122106ccc3ffa522911fba5db2de))
+
+### BREAKING CHANGES
+
+* reventless-postgres QueryEnginePostgres.Make no longer
+exposes the dead deploy-time `make` (queryEngineMaker); its Pulumi.Output
+wrap was the last @pulumi/pulumi import in the PgQueryResolver Lambda's
+cold-start graph. Pure helpers now alias QueryDbStorage_Postgres_Ops.
+
+
+
+# 3.0.0-alpha.47 (2026-07-27)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.46 (2026-07-26)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.45 (2026-07-26)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.44 (2026-07-24)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.43 (2026-07-23)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.42 (2026-07-22)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.41 (2026-07-22)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.40 (2026-07-22)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.39 (2026-07-22)
+
+### Features
+
+* **core:** attribute shared substrate to the plugin that owns it ([a440d4f](https://github.com/ReventlessDev/reventless-core/commit/a440d4f827dfab9e2e9a763ffd9fc40240852e09))
+
+
+# 3.0.0-alpha.38 (2026-07-21)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.37 (2026-07-20)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.36 (2026-07-17)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.35 (2026-07-17)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.34 (2026-07-16)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.33 (2026-07-15)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.32 (2026-07-14)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.31 (2026-07-14)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.30 (2026-07-14)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.29 (2026-07-13)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.28 (2026-07-13)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.27 (2026-07-13)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.26 (2026-07-13)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.25 (2026-07-13)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.24 (2026-07-13)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.23 (2026-07-12)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.22 (2026-07-12)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.21 (2026-07-12)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.20 (2026-07-11)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.19 (2026-07-11)
+
+### Bug Fixes
+
+* **build:** mark tests as dev-only sources so dependents don't compile them ([28b3b1c](https://github.com/ReventlessDev/reventless-core/commit/28b3b1ccfeaafc1d7050a86ce2362f32e4299187))
+
+
+# 3.0.0-alpha.18 (2026-07-11)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.17 (2026-07-10)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.16 (2026-07-10)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.15 (2026-07-10)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.14 (2026-07-10)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.13 (2026-07-09)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.12 (2026-07-09)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.11 (2026-07-08)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.10 (2026-07-08)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
 # 3.0.0-alpha.9 (2026-07-08)
 
 **Note:** Version bump only for package @reventlessdev/reventless-postgres

package/README.md

@@ -0,0 +1,83 @@
+[![npm](https://img.shields.io/npm/v/@reventlessdev/reventless-postgres.svg?label=npm)](https://www.npmjs.com/package/@reventlessdev/reventless-postgres)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Docs](https://img.shields.io/badge/docs-reventless.dev-blue)](https://docs.reventless.dev)
+
+# @reventlessdev/reventless-postgres
+
+> ⚠️ **Alpha.** APIs and on-disk formats can change without notice between releases.
+> Pin exact versions and expect breaking changes.
+
+The **Postgres storage backend** for [Reventless](https://docs.reventless.dev) — a
+spec-driven, event-sourced CQRS framework written in [ReScript](https://rescript-lang.org).
+It implements the core storage adapters (classic and DCB event logs, the query
+database, and change feeds) over a plain Postgres connection. It carries **no**
+IaC/provider SDK dependency: it connects by connection string, so it runs against
+RDS/Aurora, any managed provider, or a local container.
+
+## What it provides
+
+ReScript modules, consumed by adding the package to your `rescript.json` `dependencies`:
+
+- **`PgDriver`** — the [`node-postgres`](https://node-postgres.com) (`pg`) binding
+  (pool/client). Accepts a full `connectionString` or discrete fields, with SSL
+  and rotating-secret (password-provider) support.
+- **`PgSchema`** — an idempotent schema + migration runner (`ensureSchema(pool)`),
+  safe to run on every startup and concurrently across processes.
+- **`EventLogStorage_Postgres`** — the classic optimistic-concurrency event log
+  (`event_log` / `snapshot`).
+- **`DcbEventLogStorage_Postgres`** — the DCB (Dynamic Consistency Boundary) event
+  log with a global position sequence and a concurrency-critical `dcb_append`.
+- **`QueryDbStorage_Postgres`** — read-side storage over JSONB `qdb_<name>` tables.
+- **`QueryEnginePostgres`** — compiles the core QueryEngine query/scan AST down to
+  SQL, pushing filters into the database.
+- **`EventLogChangeFeed`** / **`PgChangeFeed`** — checkpointed change feeds for the
+  classic and DCB logs, using an `xmin`-fenced read plus `LISTEN`/`NOTIFY`
+  (`pg_notify`) for near-real-time wakeup. A documented public consumer surface.
+
+The `*_Ops` modules hold the runtime-pure operations (no Pulumi import) so a
+deployed handler's ESM graph stays clean; the wrapper modules add the deploy-time
+adapter shape.
+
+## Where it fits
+
+`reventless-postgres` is a storage **adapter** for the Reventless framework.
+[`reventless-core`](https://www.npmjs.com/package/@reventlessdev/reventless-core)
+is provider-agnostic; this package supplies the Postgres implementation of its
+event-log, query-db, and change-feed interfaces:
+
+- [`@reventlessdev/reventless-aws`](https://www.npmjs.com/package/@reventlessdev/reventless-aws) — AWS (DynamoDB, Lambda, SQS, SNS, S3); can delegate event logs to this package for managed Postgres
+- [`@reventlessdev/reventless-postgres`](https://www.npmjs.com/package/@reventlessdev/reventless-postgres) — **this package**
+- [`@reventlessdev/reventless-local`](https://www.npmjs.com/package/@reventlessdev/reventless-local) — in-memory / SQLite platform that uses this storage against a local Postgres
+
+Because it depends only on `pg` (plus
+[`reventless-core`](https://www.npmjs.com/package/@reventlessdev/reventless-core),
+[`reventless-infra`](https://www.npmjs.com/package/@reventlessdev/reventless-infra),
+and [`reventless-spec`](https://www.npmjs.com/package/@reventlessdev/reventless-spec)),
+the platform package that embeds it owns provisioning; this package only needs a
+reachable Postgres.
+
+## Install
+
+```bash
+pnpm add @reventlessdev/reventless-postgres
+```
+
+Then register it as a ReScript dependency in `rescript.json`:
+
+```json
+{
+  "dependencies": ["@reventlessdev/reventless-postgres"]
+}
+```
+
+Requires ReScript `^12.3.0` (peer dependency).
+
+## Links
+
+- 📚 Documentation — [docs.reventless.dev](https://docs.reventless.dev)
+- 📦 Repository — [ReventlessDev/reventless-core](https://github.com/ReventlessDev/reventless-core)
+- 📋 [Changelog](./CHANGELOG.md)
+
+## License
+
+[Apache-2.0](https://opensource.org/licenses/Apache-2.0)