master-zapier-plan-draft/packages/verae-zapier-middleware
George Lambert 9cc0018708
Some checks are pending
offline / test (push) Waiting to run
Add customer names on the ledger, staff session login, and exclusive jobs.events.
Account-balance stores display names and looks up by name. Edge writes
names on customer create/edit; staff UIs join from edge when needed.
New verae-staff-session issues a host cookie; department HTML redirects
when STAFF_AUTH=1. JOBS_EVENTS_EXCLUSIVE lets jobs-events own the durable
consumer. Catalog index is cards; disabled fleet machines are grey.
2026-09-11 18:11:21 -04:00
..
src Add customer names on the ledger, staff session login, and exclusive jobs.events. 2026-09-11 18:11:21 -04:00
test Bind each customer to a Verae userId for hop tracing 2026-09-11 16:18:06 -04:00
.env.example Milestone 3: NATS wait (gate 9), hash lookup, zappier timestamp, NS1 tunnel 2026-09-09 02:54:02 -04:00
Dockerfile Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
NATS.md Split NATS modules: splitter, WORM bloom archive, aggregator, docs-master 2026-09-11 12:33:40 -04:00
package-lock.json Milestone 2: module/model docs (MD, Sphinx RST, PDF) and work log 2026-09-09 02:44:51 -04:00
package.json Milestone 3: NATS wait (gate 9), hash lookup, zappier timestamp, NS1 tunnel 2026-09-09 02:54:02 -04:00
README.md Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00
SUMMARY.md Split NATS modules: splitter, WORM bloom archive, aggregator, docs-master 2026-09-11 12:33:40 -04:00

verae-middleware

Zapier-facing HTTPS adapter (/zapier/v1/*) plus NATS workers. Zapier never speaks NATS or api.veraetime.net; this process does.

Forgejo: https://git.georgelambert.org/marchon/verae-middleware
Clone: ssh://git@git.georgelambert.org:2223/marchon/verae-middleware.git
Catalog README (PDF): https://zapier.georgelambert.org/packages/verae-zapier-middleware/README.pdf
NATS contract: https://zapier.georgelambert.org/docs-master/modules/verae-zapier-middleware/NATS.pdf
Install / Docker / Proxmox: https://zapier.georgelambert.org/packages/verae-ops/README.pdf

Run

cd packages/verae-zapier-middleware
npm install
MOCK_VERAE=true NATS_ENABLED=false npm test
PORT=3100 MOCK_VERAE=true npm start   # /health, /zapier/v1

Docker image: Dockerfile (Node 22, port 3100). Full stack: verae-ops compose.

Environment

Variable Default Purpose
PORT 3100 HTTP bind
VERAE_API_BASE_URL http://localhost:8080 Chain HTTPS
MOCK_VERAE false In-process mock chain
NATS_ENABLED false JetStream vs in-process poller
NATS_URL nats://127.0.0.1:4222 Cluster URL (loopback / docker DNS)
WAIT_TIMEOUT_MS Sync wait on jobs.events

Depends on

  • Upstream HTTPS: zappier-edge (x-api-key already checked) or a lab client
  • Chain: api.veraetime.net or MOCK_VERAE=true
  • NATS: jobs.watch out, jobs.events in; optional archive.put / aggregator wait
  • Optional: request-splitter (in-process), archive-worm, tree-node, webhook-deliver

Does not bind NATS publicly. See verae-ops linking.