master-zapier-plan-draft/packages/verae-zapier
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
..
creates Milestone 1: Add Numbers Zapier app, /v1/add, developer setup guide 2026-09-09 02:41:34 -04:00
searches Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
test Milestone 1: Add Numbers Zapier app, /v1/add, developer setup guide 2026-09-09 02:41:34 -04:00
triggers Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
authentication.js Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
index.js Milestone 1: Add Numbers Zapier app, /v1/add, developer setup guide 2026-09-09 02:41:34 -04:00
package.json Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
README.md Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00

verae-zapier

Zapier Platform CLI app for Verae. Phase 11 in ../TODO.md.

Role

Runs on Zapiers servers. Calls only the middleware HTTPS API (MIDDLEWARE_BASE_URL), never NATS and never api.veraetime.net directly.

Planned modules

File Purpose
authentication.js Custom API key auth → GET /zapier/v1/auth/me
index.js App definition, beforeRequest, afterResponse error mapping
creates/timestamp_and_wait.js Primary action
creates/create_timestamp.js Async jobId action
creates/verify_timestamp.js Verify certificate
creates/batch_timestamp.js Batch create
searches/job_status.js Lookup by jobId
triggers/timestamp_completed.js REST Hook

See ../docs/developer/modules/function-reference.md for I/O contracts.

Env

export MIDDLEWARE_BASE_URL=https://your-middleware.example.com

Gate

npm run gate:11   # from monorepo root, after Phase 11 implementation