Refresh docs-master with Forgejo URLs and NATS.md for every module
Some checks are pending
offline / test (push) Waiting to run
Some checks are pending
offline / test (push) Waiting to run
HTTPS-only packages (zappier, activate, zapier-app) now state they do not subscribe to NATS. Catalog build copies docs-master onto the site.
This commit is contained in:
parent
8f9707a3b7
commit
392fe7bb15
8 changed files with 90 additions and 5 deletions
|
|
@ -1,21 +1,44 @@
|
|||
# zapier-docs-master
|
||||
|
||||
Summaries and NATS interaction map for every Verae Time × Zapier module.
|
||||
Summaries, NATS contracts, and message flows for every Verae Time × Zapier module.
|
||||
|
||||
**Live HTML:** https://zapier.georgelambert.org/
|
||||
**Live catalog:** https://zapier.georgelambert.org/
|
||||
**Monorepo:** https://git.georgelambert.org/marchon/master-zapier-plan-draft (`main` and `master`)
|
||||
|
||||
**Monorepo:** https://git.georgelambert.org/marchon/master-zapier-plan-draft
|
||||
## Git repos (Forgejo on NS1)
|
||||
|
||||
| Repo | URL |
|
||||
|------|-----|
|
||||
| master-zapier-plan-draft | https://git.georgelambert.org/marchon/master-zapier-plan-draft |
|
||||
| zappier-edge | https://git.georgelambert.org/marchon/zappier-edge |
|
||||
| verae-middleware | https://git.georgelambert.org/marchon/verae-middleware |
|
||||
| verae-zapier-app | https://git.georgelambert.org/marchon/verae-zapier-app |
|
||||
| verae-activate | https://git.georgelambert.org/marchon/verae-activate |
|
||||
| verae-request-splitter | https://git.georgelambert.org/marchon/verae-request-splitter |
|
||||
| verae-archive-worm | https://git.georgelambert.org/marchon/verae-archive-worm |
|
||||
| verae-archive-aggregator | https://git.georgelambert.org/marchon/verae-archive-aggregator |
|
||||
| **zapier-docs-master** (this repo) | https://git.georgelambert.org/marchon/zapier-docs-master |
|
||||
|
||||
Clone (SSH port 2223):
|
||||
|
||||
`git clone ssh://git@git.georgelambert.org:2223/marchon/<name>.git`
|
||||
|
||||
## Modules
|
||||
|
||||
| Module | Summary | NATS in | NATS out |
|
||||
|--------|---------|---------|----------|
|
||||
| zappier-edge | Metered HTTPS for Zapier | — | — (HTTPS to middleware) |
|
||||
| verae-middleware | Job id + wait HTTP | jobs.events | jobs.watch, archive.query via aggregator |
|
||||
| verae-middleware | Job id + wait HTTP | jobs.events | jobs.watch |
|
||||
| verae-activate | Pushable Zapier app | — | — |
|
||||
| verae-zapier-app | Full Zapier nouns | — | — |
|
||||
| request-splitter | Hash vs files | — | archive.put |
|
||||
| archive-worm | Bloom WORM node | archive.query, archive.put | archive.reply.* (hit only) |
|
||||
| archive-aggregator | Merge archive replies | archive.reply.* | archive.query |
|
||||
|
||||
Full contracts: `../docs/02-architecture/modules-and-nats.md` and `archive-nats.md` in the monorepo / on the website.
|
||||
## Documents in this repo
|
||||
|
||||
- [MESSAGE-FLOWS.md](MESSAGE-FLOWS.md) — numbered request paths
|
||||
- [modules-and-nats.md](modules-and-nats.md) — address table
|
||||
- [archive-nats.md](archive-nats.md) — bloom / multi-receipt design
|
||||
- [composition.md](composition.md) — HTTPS hops
|
||||
- `modules/<name>/SUMMARY.md` and `NATS.md`
|
||||
|
|
|
|||
10
packages/docs-master/modules/verae-activate/NATS.md
Normal file
10
packages/docs-master/modules/verae-activate/NATS.md
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
# NATS — verae-activate
|
||||
|
||||
This Zapier Platform app **does not use NATS**.
|
||||
|
||||
| Direction | Address | Peer | Body |
|
||||
|-----------|---------|------|------|
|
||||
| IN | Zapier UI / runtime | user Zap | `number1`, `number2`, `text`, `data` / `sha256` |
|
||||
| OUT HTTPS (optional) | zappier-edge `/v1/add` or `/v1/timestamp` | only if `api_base` + `api_key` set | JSON |
|
||||
|
||||
Blank connection fields → local compute only.
|
||||
10
packages/docs-master/modules/verae-zapier/NATS.md
Normal file
10
packages/docs-master/modules/verae-zapier/NATS.md
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
# NATS — verae-zapier-app
|
||||
|
||||
This Zapier Platform app **does not use NATS**.
|
||||
|
||||
| Direction | Address | Peer | Body |
|
||||
|-----------|---------|------|------|
|
||||
| IN | Zapier runtime | user Zap | create/search/trigger fields |
|
||||
| OUT HTTPS | middleware `/zapier/v1/timestamp`, `/wait`, `/verify`, `/status/{id}`, `/hashes/{sha256}`, REST Hook subscribe | verae-middleware | Bearer `zmw_` |
|
||||
|
||||
Job completion is a REST Hook HTTP POST from webhook-deliver, not a NATS client in Zapier.
|
||||
10
packages/docs-master/modules/zappier/NATS.md
Normal file
10
packages/docs-master/modules/zappier/NATS.md
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
# NATS — zappier-edge
|
||||
|
||||
This process **does not subscribe or publish** on NATS.
|
||||
|
||||
| Direction | Address | Peer | Body |
|
||||
|-----------|---------|------|------|
|
||||
| IN HTTPS | `/v1/*` | Zapier Platform app | JSON + `x-api-key` |
|
||||
| OUT HTTPS | middleware `/zapier/v1/*` | verae-middleware | same tenant request |
|
||||
|
||||
NATS is private to middleware workers and archives.
|
||||
10
packages/verae-activate/NATS.md
Normal file
10
packages/verae-activate/NATS.md
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
# NATS — verae-activate
|
||||
|
||||
This Zapier Platform app **does not use NATS**.
|
||||
|
||||
| Direction | Address | Peer | Body |
|
||||
|-----------|---------|------|------|
|
||||
| IN | Zapier UI / runtime | user Zap | `number1`, `number2`, `text`, `data` / `sha256` |
|
||||
| OUT HTTPS (optional) | zappier-edge `/v1/add` or `/v1/timestamp` | only if `api_base` + `api_key` set | JSON |
|
||||
|
||||
Blank connection fields → local compute only.
|
||||
10
packages/verae-zapier/NATS.md
Normal file
10
packages/verae-zapier/NATS.md
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
# NATS — verae-zapier-app
|
||||
|
||||
This Zapier Platform app **does not use NATS**.
|
||||
|
||||
| Direction | Address | Peer | Body |
|
||||
|-----------|---------|------|------|
|
||||
| IN | Zapier runtime | user Zap | create/search/trigger fields |
|
||||
| OUT HTTPS | middleware `/zapier/v1/timestamp`, `/wait`, `/verify`, `/status/{id}`, `/hashes/{sha256}`, REST Hook subscribe | verae-middleware | Bearer `zmw_` |
|
||||
|
||||
Job completion is a REST Hook HTTP POST from webhook-deliver, not a NATS client in Zapier.
|
||||
10
packages/zappier/NATS.md
Normal file
10
packages/zappier/NATS.md
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
# NATS — zappier-edge
|
||||
|
||||
This process **does not subscribe or publish** on NATS.
|
||||
|
||||
| Direction | Address | Peer | Body |
|
||||
|-----------|---------|------|------|
|
||||
| IN HTTPS | `/v1/*` | Zapier Platform app | JSON + `x-api-key` |
|
||||
| OUT HTTPS | middleware `/zapier/v1/*` | verae-middleware | same tenant request |
|
||||
|
||||
NATS is private to middleware workers and archives.
|
||||
Loading…
Add table
Add a link
Reference in a new issue