master-zapier-plan-draft/docs/sphinx/modules/verae-zapier-middleware/nats/wait.md
George Lambert 51ae79b75f Milestone 3: NATS wait (gate 9), hash lookup, zappier timestamp, NS1 tunnel
Wait-via-NATS returns completed or pending+jobId (GATE 9). Mock SHA256
idempotent register + GET /hashes/{sha256}. Zappier commercial edge has
POST /v1/timestamp and hash-lookup. GATE 12 smoke (signup + wait) passes.

NS1 NATS is 127.0.0.1:4222 on 70.88.205.138; SSH tunnel :14222. Local
nats-server -js used for isolated tests. Activate app adds Echo Text.

Learned: JetStream on NS1 is loopback-only; do not bind 4222 public.
2026-09-09 02:54:02 -04:00

1.5 KiB
Raw Permalink Blame History

verae-zapier-middleware/nats/wait

Package: verae-zapier-middleware
Source: packages/verae-zapier-middleware/src/nats/wait.js
Lines: 60

What this module is

Implementation module in verae-zapier-middleware. The tables below are extracted from the source (signatures + JSDoc).

Exports

waitForJobEvent

Types / interfaces / classes

None extracted.

Functions

Name Parameters Param types (JSDoc) Returns Calls (same file / helpers)
waitForJobEvent jobId, timeoutMs jobId: string, timeoutMs: number `Promise<object null>` — event payload or null on timeout
firstMatch async ( unknown see Call graph

What it imports / requires

  • ../debug/logger.js
  • ../debug/trace-context.js
  • ./subjects.js
  • ./connection.js

Call graph (identifiers invoked)

createDebugger, waitForJobEvent, getNatsConnection, connectNats, subscribe, getTraceId, debug, setTimeout, resolve, async, parse, string, race, unsubscribe

Each identifier is a call site in this file. Follow the import list to see the defining module; open that modules MD for parameter and return types.

Return values (how to read this)

  • HTTP route handlers return Express res.json(...) bodies (see route docs).
  • Zapier perform functions return a single object (creates) or an array (triggers/searches).
  • Pricing functions return integer cents on Quote.totalCents.