Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs(ci): list every PostgreSQL spec the job runs

Yudhi Armyndharis1cded6bed437
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 60f3e2087..fbe3dcb90 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -255,15 +255,17 @@ jobs:
# database), that a paged message list has a total order (Postgres sorts a tie group
# differently between two statements, so an unstable order drops rows from a page walk), and
# that the data entities can build their own schema (raw SQL the ORM passes through verbatim,
- # such as a partial index predicate, only case-folds on a real server), and that the UTC pin
- # holds across a backup round trip, a retention window and a local-midnight count. All seven
+ # such as a partial index predicate, only case-folds on a real server), that the UTC pin
+ # holds across a backup round trip, a retention window and a local-midnight count, that webhook
+ # failure recovery and media metadata updates hold on the real server, and that a send
+ # idempotency key is claimed by a unique-violation insert. All seven
# self-skip unless DATABASE_TYPE=postgres, so they are a no-op in the default test job and only
# execute here against the postgres:16 service.
#
# TZ is deliberately NOT UTC: the pin's whole job is to make a `timestamp` column mean the same
# instant on a host that runs in another zone, and on a UTC runner every assertion about it
# would pass for the wrong reason (the UTC-pin spec fails outright rather than pass vacuously).
- - name: Postgres specs (FTS + migrations + ordering + schema + UTC + recovery)
+ - name: Postgres specs (FTS + migrations + ordering + schema + UTC + recovery + idempotency)
# --runInBand: the specs issue DDL against the one shared service database, and jest's
# default file-parallelism races their catalog writes (pg_type duplicate-key). The lock
# spec's own two-migrator race is in-file (Promise.all) and unaffected by runInBand. The
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 92c3141a4..f18d1f11c 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -229,11 +229,13 @@ jobs:
# STORED body_ts tsvector), the boot-migration advisory lock (two concurrent migrators on one
# database), that a paged message list has a total order, that the data entities can build
# their own schema (raw SQL the ORM passes through verbatim, such as a partial index predicate,
- # only case-folds on a real server), and that the UTC pin holds across a backup round trip, a
- # retention window and a local-midnight count. All seven self-skip unless DATABASE_TYPE=postgres,
- # so they are a no-op in the default test job and only execute here against the postgres:16
- # service. TZ is deliberately not UTC, for the reason ci.yml states.
- - name: Postgres specs (FTS + migrations + ordering + schema + UTC + recovery)
+ # only case-folds on a real server), that the UTC pin holds across a backup round trip, a
+ # retention window and a local-midnight count, that webhook failure recovery and media metadata
+ # updates hold on the real server, and that a send idempotency key is claimed by a unique-violation
+ # insert. All seven self-skip unless DATABASE_TYPE=postgres, so they are a no-op in the default test
+ # job and only execute here against the postgres:16 service. TZ is deliberately not UTC, for the
+ # reason ci.yml states.
+ - name: Postgres specs (FTS + migrations + ordering + schema + UTC + recovery + idempotency)
# --runInBand: same reason the CI job passes it — both specs issue DDL against the one
# shared service database, and jest's default file-parallelism races their catalog writes
# (the first v0.19.0 tag failed this step on `relation "messages" already exists` over a
diff --git a/docs/09-testing-strategy.md b/docs/09-testing-strategy.md
index 2f0e9c89c..fbb03f250 100644
--- a/docs/09-testing-strategy.md
+++ b/docs/09-testing-strategy.md
@@ -259,7 +259,7 @@ request's superseded run; push runs on `main` are never cancelled or queued behi
| `lint` | backend ESLint, full-program TypeScript check, formatting, version consistency, .dockerignore context, OpenAPI snapshot, SDK routes and webhook events against the contract, contract coverage per SDK, SDK docs against the shipped client surface, client wire shapes (`check:contract-shapes` — the JavaScript SDK's, dashboard's, Python's, Go's and Java's hand-written types against the OpenAPI schemas; the PHP client returns untyped arrays and has no types layer to gate) |
| `audit` | dependency security audit of all three npm trees (root, `dashboard/` and `sdk/javascript/`); when npm's audit endpoint cannot answer, the root audit skips with a warning annotation here while the dashboard and SDK audits, a plain `npm audit`, fail closed, so the job still goes red until a re-run; the release gate and the weekly scan fail (`CHECK_AUDIT_REQUIRED=1`) |
| `test` | backend coverage run, repo-file drift gates (`test:docs`), script unit tests (node:test), e2e smoke tests |
-| `test-postgres` | real PostgreSQL 16 service, backend build, migration smoke, and the PostgreSQL specs (FTS provider, boot-migration lock, message list ordering, entity synchronize, UTC pin) |
+| `test-postgres` | real PostgreSQL 16 service, backend build, migration smoke, and the PostgreSQL specs (FTS provider, boot-migration lock, message list ordering, entity synchronize, UTC pin, webhook recovery, send idempotency keys) |
| `dashboard` | dashboard install, lint, formatting, type-check, i18n parity, build, unit tests |
| `scripts-smoke` | shellcheck on `docker-entrypoint.sh` and every `scripts/*.sh`, plus the backup/restore smoke test |
| `chart` | helm lint, helm template with default and fully-toggled values, kubeconform on both renders, the rendered-behaviour check, actionlint on the workflows |