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
2 commits 2 branches 0 tags 66 MiB
Find a file
George Lambert b814501441 Milestone 1: Add Numbers Zapier app, /v1/add, developer setup guide 
packages/verae-activate is pushable with zapier-platform 19.1.0: local
Add Numbers (number1+number2=sum) needs no hosted API. zapier-platform
validate is clean (0 warnings). zappier POST /v1/add is a free metered
endpoint for the optional hosted path.

Tests: verae-activate 7/7, zappier 176/176, verae-zapier 5/5, middleware
gate 1 11/11. Morning steps: docs/04-activate/SETUP-ZAPIER-DEVELOPER.md

Learned: perform runs on Zapier cloud so arithmetic needs no public URL;
CLI and zapier-platform-core majors must match; do not mix zapier-sdk.
2026-09-09 02:41:34 -04:00
docs Milestone 1: Add Numbers Zapier app, /v1/add, developer setup guide 2026-09-09 02:41:34 -04:00
harness Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
packages Milestone 1: Add Numbers Zapier app, /v1/add, developer setup guide 2026-09-09 02:41:34 -04:00
research Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
scripts Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
vendor Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
.gitignore Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
package.json Milestone 1: Add Numbers Zapier app, /v1/add, developer setup guide 2026-09-09 02:41:34 -04:00
README.MD Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -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 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -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.

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/.

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

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.