Zapier cloud runs this app against verae-middleware over HTTPS with a
customer zmw_ key; the middleware owns keys, plans, job watching, webhooks,
and the api.veraetime.net client. This commit makes the app cover the whole
middleware surface and match its documented behaviour.
New operations
- creates: batch_verify (POST /verify/batch), batch_status
(POST /status/batch), get_receipt (GET /receipts/{jobId}, optional PDF via
z.stashFile)
- searches: job_verification (GET /status/{jobId}/verification), usage
(GET /auth/me -> plan and month-to-date usage vs limits)
- triggers: timestamp_failed REST Hook alongside timestamp_completed
Behaviour changes
- Create Timestamp / Create Timestamp and Wait accept Data or a 64-hex
SHA256, plus optional public/private metadata dicts, per the user guide.
- Searches return [] on 404 instead of failing the Zap; other errors carry
the middleware message.
- Hook items get id = jobId so Zapier can dedupe; subscribeData is
{ id, event }; performUnsubscribe accepts the legacy bare id.
- The API key is sent as Authorization: Bearer and as x-api-key so the app
works through the middleware today and the access planes / billing edge
that forward only x-api-key.
- afterResponse maps every middleware error body; QUOTA_EXCEEDED,
PLAN_UPGRADE_REQUIRED and BATCH_LIMIT_EXCEEDED include the upgrade URL;
429 becomes a ThrottledError.
- MIDDLEWARE_PATH_PREFIX (default /zapier/v1) for a fronting edge.
Shared code
- lib/middleware.js: base URL, error parsing, 404-as-no-match search
helper, timestamp input/body builder, shared samples and output fields.
- lib/hookTrigger.js: REST Hook factory.
Repo health
- Remove creates/add_numbers.js, which required a file from the sibling
verae-activate package and prevented the app from loading.
- Fix the npm test glob for Node 22; add .gitignore and package-lock.json.
- Version 1.1.0.
Tests and docs
- test/app.test.js rewritten: 25 unit tests with a fake z, no network.
- test/e2e.test.js: opt-in run through zapier-platform-core against a live
middleware (MIDDLEWARE_BASE_URL + MIDDLEWARE_API_KEY); plan-aware and
E2E_SKIP_HOOK_DELIVERY for the lab. Passes on pro and free tenants.
- README: module table, live-lab origins and which are usable, env, and an
"open items" status section; SUMMARY and NATS updated.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
220559d257