marchon/master-zapier-plan-draft
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
Verae Time x Zapier monorepo plan draft
27 commits 2 branches 0 tags 93 MiB
Find a file
George Lambert 1b199ca4d4
Some checks are pending
offline / test (push) Waiting to run
Details
Separate Zapier, web, API, and leaf access planes with NATS authz 
Zapier is one ingress. Direct web, customer API, and S2S leaf nodes are their own services. Every hop to an internal subject must pass verae.access.authz.check (default deny by plane).
2026-09-11 16:05:05 -04:00
.github/workflows Keep-going: tree shares, health flags, CI, compose, timestamp Zapier action 2026-09-09 03:02:08 -04:00
docs Separate Zapier, web, API, and leaf access planes with NATS authz 2026-09-11 16:05:05 -04:00
harness Keep-going: tree shares, health flags, CI, compose, timestamp Zapier action 2026-09-09 03:02:08 -04:00
packages Separate Zapier, web, API, and leaf access planes with NATS authz 2026-09-11 16:05:05 -04:00
research Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
scripts Separate Zapier, web, API, and leaf access planes with NATS authz 2026-09-11 16:05:05 -04:00
vendor Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
.gitignore Publish docs site for zapier.georgelambert.org and archive-NATS design 2026-09-11 12:23:23 -04:00
package.json Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00
README.MD Fix catalog PDF links; add bring-online guide; feature zappier billing 2026-09-11 14:59:13 -04:00
restart.sh Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
TODO.md Milestone 3: NATS wait (gate 9), hash lookup, zappier timestamp, NS1 tunnel 2026-09-09 02:54:02 -04:00

README.MD

Verae Time × Zapier

Workspace that composes two existing systems and the official Zapier Platform SDK:

  1. packages/zappier — custom pricing, API keys, customer portal, admin, Stripe, invoices.
  2. packages/verae-zapier-middleware — timestamp adapter to api.veraetime.net (or MOCK_VERAE) plus NATS workers.
  3. packages/verae-zapier — Zapier Platform CLI app.
  4. vendor/zapier-platform — upstream CLI/core/schema/examples (reference).
  5. research/zapier — vendor research, scrapes, cloned Zapier repos, playbooks (research/README.md).

They are imported, not yet wired. Public Zapier traffic should eventually hit zappier (x-api-key), which meters the call and proxies to the Verae middleware. See docs/02-architecture/composition.md.

Original brief (features a–m): docs/00-sources/workspace-brief.md.
Where each tree came from: docs/00-sources/provenance.md.

Tomorrow morning: docs/04-activate/SETUP-ZAPIER-DEVELOPER.md — create a Zapier developer account and push Add Numbers.

Quick start

# Billing platform (portal :3000, admin, /docs)
cd packages/zappier && npm install && npm test && npm run dev

# Verae middleware (HTTP :3100, optional NATS)
cd packages/verae-zapier-middleware && npm install
cd ../.. && npm run gate:0

Gates (npm run gate:N) continue the middleware plan in TODO.md. Phases 0–8, 10, 11 already passed in the source tree; 9 and 12+ are still open. Path prefixes now use packages/.

Bring online: https://zapier.georgelambert.org/packages/verae-ops/GETTING-STARTED.pdf
Live catalog (PDF default): https://zapier.georgelambert.org/ · Markdown indexes
Billing / users (zappier-edge): https://zapier.georgelambert.org/packages/zappier/docs/USER-MANUAL.pdf
Sphinx: https://zapier.georgelambert.org/sphinx/ · LaTeX PDF

Documentation map

Doc Contents
docs/01-product/features-a-m.md Requested Zapier surface vs owners
docs/01-product/api-gap-analysis.md Live Verae OpenAPI vs a–m
docs/01-product/billing-and-keys.md Keys, rate card, invoices
docs/02-architecture/overview.md Adapter internals (imported)
docs/03-zapier/operations.md Platform nouns
research/README.md Imported Zapier vendor research
docs/04-activate/SETUP-ZAPIER-DEVELOPER.md Morning: Zapier developer account + push Add Numbers
docs/modules/README.md Per-module API sheets (params, callees, returns)
docs/models/README.md Data models
docs/sphinx/_build/html/index.html Sphinx HTML (rebuild: npm run docs:sphinx)

Environment (middleware)

Variable Default Purpose
PORT 3100 Middleware HTTP
VERAE_API_BASE_URL http://localhost:8080 Upstream Verae
MOCK_VERAE false Local mock of Verae HTTP
NATS_ENABLED false JetStream workers vs in-process poller

Zappier uses PORT (3000), ZAPPIER_DB, ADMIN_KEY, STRIPE_SECRET_KEY — see packages/zappier/README.md.