@reventlessdev/reventless-postgres 3.0.0-alpha.3 → 3.0.0-alpha.30

package/CHANGELOG.md

@@ -3,6 +3,219 @@
 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.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
+
+
+
+
+
+# 3.0.0-alpha.8 (2026-07-07)
+
+**Note:** Version bump only for package @reventlessdev/reventless-postgres
+
+
+
+
+
+# 3.0.0-alpha.7 (2026-07-07)
+
+### Bug Fixes
+
+* **reventless-postgres:** keep [@pulumi](https://github.com/pulumi) out of the deployed Lambda runtime graph ([0f363cd](https://github.com/ReventlessDev/reventless-core/commit/0f363cd273590591c8f9353fa38ac8b6072e6c49))
+
+
+# 3.0.0-alpha.6 (2026-07-06)
+
+### Features
+
+* **reventless-postgres,reventless-aws:** items (sub-id connection) resolver for Postgres reads (B3.2c) ([2477220](https://github.com/ReventlessDev/reventless-core/commit/247722062913f5d0bcb5895b152f05033d8297d8))
+
+
+# 3.0.0-alpha.5 (2026-07-06)
+
+### Features
+
+* **reventless-aws:** classic EventLog Postgres deploy-time wiring + relay (B1 vertical) ([8235ba4](https://github.com/ReventlessDev/reventless-core/commit/8235ba44e506f7094d17251405c6a05c39789805))
+* **reventless-aws:** Postgres QueryDb storage vertical (B3.1) ([51a7993](https://github.com/ReventlessDev/reventless-core/commit/51a79934c1d9f59bb6f61233a90651d5eadf9f4e))
+* **reventless-postgres:** QueryEnginePostgres list/index/byIds resolver push-downs (B3.2a-1) ([8cb09e4](https://github.com/ReventlessDev/reventless-core/commit/8cb09e40cffa9698a251f1ee3fb17b016c4f8b07))
+
+
+# 3.0.0-alpha.4 (2026-07-05)
+
+### Features
+
+* **reventless-postgres:** classic event_log change feed (B2.5) ([59529c7](https://github.com/ReventlessDev/reventless-core/commit/59529c795395f37d29e935ba2d6bd5a3e7e8b5c0))
+
+
 # 3.0.0-alpha.3 (2026-07-05)
 
 **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)

package/lib/bs/.compiler.log

@@ -1,2 +1,2 @@
-#Start(1783258950748)
-#Done(1783258952632)
+#Start(1784020571292)
+#Done(1784020574837)

package/lib/bs/ReventlessPostgres.mlmap

@@ -1,9 +1,12 @@
 randjbuildsystem
 DcbEventLogStorage_Postgres
+DcbEventLogStorage_Postgres_Ops
+EventLogChangeFeed
 EventLogStorage_Postgres
+EventLogStorage_Postgres_Ops
 PgChangeFeed
 PgDriver
 PgSchema
-PostgresIntegrationTest
 QueryDbStorage_Postgres
+QueryDbStorage_Postgres_Ops
 QueryEnginePostgres

package/lib/bs/compiler-info.json

@@ -2,7 +2,7 @@
   "version": "12.3.0",
   "bsc_path": "/home/runner/work/reventless-core/reventless-core/node_modules/@rescript/linux-x64/bin/bsc.exe",
   "bsc_hash": "75e3a59c95cc953608fd3dd6ea6ed68141bba4414a20a52f114261b8a48385fa",
-  "rescript_config_hash": "48ea15db3d741cf15a2ff49dd0b47d86badf2b548ecb3859a896faf1e3a82a15",
+  "rescript_config_hash": "af2af60a0fa33b8249a96ff2758f36482843126dc4e07b9302842d011e0ad8c6",
   "runtime_path": "/home/runner/work/reventless-core/reventless-core/node_modules/@rescript/runtime",
-  "generated_at": "1783258952640"
+  "generated_at": "1784020574843"
 }