master-zapier-plan-draft/docs/modules/verae-zapier-middleware/nats/connection.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

2.1 KiB
Raw Permalink Blame History

verae-zapier-middleware/nats/connection

Package: verae-zapier-middleware
Source: packages/verae-zapier-middleware/src/nats/connection.js
Lines: 117

What this module is

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

Exports

connectNats, getNatsConnection, ensureStreams, closeNats, getJetStream, isNatsConnected

Types / interfaces / classes

None extracted.

Functions

Name Parameters Param types (JSDoc) Returns Calls (same file / helpers)
connectNats url = config.natsUrl url: string Promise<{ nc: import('nats').NatsConnection, js: import('nats').JetStreamClient, jsm: import('nats').JetStreamManager — >} see Call graph
getNatsConnection (none) `import('nats').NatsConnection null`
ensureStreams manager manager: import('nats').JetStreamManager Promise<void> see Call graph
closeNats (none) Promise<void> see Call graph
getJetStream (none) `import('nats').JetStreamClient null`
isNatsConnected (none) boolean see Call graph

What it imports / requires

  • ../debug/logger.js
  • ../config.js
  • ./subjects.js

Call graph (identifiers invoked)

createDebugger, import, connectNats, debug, disabled, info, connect, jetstream, jetstreamManager, getNatsConnection, ensureStreams, add, closeNats, drain, getJetStream, isNatsConnected, isClosed

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.