master-zapier-plan-draft/docs/sphinx/repos/verae-zapier-middleware.md
George Lambert e401635fd6
Some checks are pending
offline / test (push) Waiting to run
Document every repo in Sphinx, catalog PDFs, and verae-ops
Add missing package READMEs, expand Sphinx to all runtime modules,
publish a LaTeX/PDF README book, and add verae-ops for Docker,
Proxmox, VMs, dedicated hardware, and service linking. Catalog
defaults to public PDF links for each module README and samples.
2026-09-11 14:36:17 -04:00

1.7 KiB

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.