master-zapier-plan-draft/docs/modules/zappier/app.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.9 KiB
Raw Blame History

zappier/app

Package: zappier
Source: packages/zappier/src/app.ts
Lines: 237

What this module is

Implementation module in zappier. The tables below are extracted from the source (signatures + JSDoc).

Exports

StoredItem, DEFAULT_CUSTOMERS, AppDeps, buildApp

Types / interfaces / classes

Kind Name
interface StoredItem
interface AppDeps

Functions

Name Parameters Param types (JSDoc) Returns Calls (same file / helpers)
buildApp deps: AppDeps = {} unknown see Call graph

What it imports / requires

  • path
  • crypto
  • express
  • express-openapi-validator
  • swagger-ui-express
  • yamljs
  • ./auth
  • ./meter
  • ./billing/credit
  • ./pricing
  • ./usage
  • ./admin
  • ./admin-users
  • ./accounts
  • ./invoicing
  • ./paths
  • ./portal

Call graph (identifiers invoked)

join, next, parse, status, json, buildApp, seeded, seedAdminUsersFromEnv, rateCard, getRateCard, tiers, getTiers, express, use, load, setup, adminLoginRouter, adminAuth, adminRouter, static, async, import, toDataURL, portalRouter, apiKeyAuth, middleware, get, meter, post, toUpperCase, toLowerCase, createHash, update, digest, randomUUID, toISOString, set, isFinite, map, unshift, filter, setUTCDate, setUTCHours, summaryFor, find, applyMonthlyCredit

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.