@reventlessdev/reventless-postgres 3.0.0-alpha.7 → 3.0.0-alpha.71

package/CHANGELOG.md

@@ -3,6 +3,521 @@
 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.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
+
+
+
+
+
+# 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

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(1783401131075)
-#Done(1783401133084)
+#Start(1785780305825)
+#Done(1785780311058)

package/lib/bs/ReventlessPostgres.mlmap

@@ -7,8 +7,6 @@ EventLogStorage_Postgres_Ops
 PgChangeFeed
 PgDriver
 PgSchema
-PostgresIntegrationTest
 QueryDbStorage_Postgres
 QueryDbStorage_Postgres_Ops
 QueryEnginePostgres
-QueryEnginePostgresListPageTest

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": "1783401133087"
+  "generated_at": "1785780311065"
 }

package/lib/bs/src/EventLogChangeFeed.res

@@ -15,8 +15,11 @@
 // later commit) is never skipped by a checkpointing reader. `global_seq` alone,
 // being an IDENTITY assigned at INSERT, could NOT provide that guarantee.
 
-// Reuse the shared `<a>:<b>` cursor codec from the DCB storage — identical format.
-module Dcb = DcbEventLogStorage_Postgres
+// Reuse the shared `<a>:<b>` cursor codec from the DCB storage — identical
+// format. Point at the runtime-pure `_Ops` module (no `@pulumi/pulumi`): this
+// feed is drained by the deployed change-feed relay Lambda, whose cold-start
+// graph must stay Pulumi-free.
+module Dcb = DcbEventLogStorage_Postgres_Ops
 
 // One classic event as the feed surfaces it. `payload` is the stored event JSON
 // verbatim; a bus/topic relay transforms it into its target shape (e.g. the AWS

package/lib/bs/src/EventLogChangeFeed.res.mjs

@@ -3,7 +3,7 @@
 import * as Stdlib_Int from "@rescript/runtime/lib/es6/Stdlib_Int.js";
 import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
 import * as PgDriver$ReventlessPostgres from "./PgDriver.res.mjs";
-import * as DcbEventLogStorage_Postgres$ReventlessPostgres from "./DcbEventLogStorage_Postgres.res.mjs";
+import * as DcbEventLogStorage_Postgres_Ops$ReventlessPostgres from "./DcbEventLogStorage_Postgres_Ops.res.mjs";
 
 let selectColumns = "\n  lpad(transaction_id::text, 20, '0') || ':' || lpad(global_seq::text, 20, '0') AS cursor,\n  aggregate_id,\n  seq_nr,\n  payload,\n  msg_id\n";
 
@@ -43,7 +43,7 @@ async function readBatch(pool, logName, after, limitOpt) {
   let limit = limitOpt !== undefined ? limitOpt : 500;
   let params = [logName];
   let where = "log_name = $1 AND transaction_id < pg_snapshot_xmin(pg_current_snapshot())";
-  let match = Stdlib_Option.flatMap(after, DcbEventLogStorage_Postgres$ReventlessPostgres.decodeCursor);
+  let match = Stdlib_Option.flatMap(after, DcbEventLogStorage_Postgres_Ops$ReventlessPostgres.decodeCursor);
   if (match !== undefined) {
     params.push(match[0]);
     params.push(match[1]);
@@ -72,7 +72,7 @@ async function loadCheckpoint(pool, subscriber) {
 }
 
 async function saveCheckpoint(pool, subscriber, cursor) {
-  let match = DcbEventLogStorage_Postgres$ReventlessPostgres.decodeCursor(cursor);
+  let match = DcbEventLogStorage_Postgres_Ops$ReventlessPostgres.decodeCursor(cursor);
   if (match !== undefined) {
     await PgDriver$ReventlessPostgres.query(pool, "INSERT INTO event_log_subscription(subscriber, last_tx, last_global_seq)\n       VALUES ($1, $2::xid8, $3::bigint)\n       ON CONFLICT (subscriber)\n       DO UPDATE SET last_tx = EXCLUDED.last_tx, last_global_seq = EXCLUDED.last_global_seq", [
       subscriber,