master-zapier-plan-draft/docs/modules/zappier/portal.md
George Lambert 10c663cc0c Milestone 2: module/model docs (MD, Sphinx RST, PDF) and work log
74 source modules documented with extracted signatures, JSDoc params,
imports, and call graphs. 10 first-class models (PriceRule through
StatusResponse) have their own MD/RST/PDF. Sphinx HTML builds from
docs/sphinx. Per-module PDFs in docs/modules-pdf and docs/models-pdf.

Middleware gates 2–6 and 10 pass on MOCK_VERAE without NATS.

Learned: RST includes are relative to the RST file; keep one PDF per
module; Add Numbers remains the only push required tomorrow.
2026-09-09 02:44:51 -04:00

2.3 KiB
Raw Blame History

zappier/portal

Package: zappier
Source: packages/zappier/src/portal.ts
Lines: 285

What this module is

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

Exports

PaymentResult, PaymentClient, PortalDeps, portalRouter

Types / interfaces / classes

Kind Name
interface PaymentResult
interface PaymentClient
interface PortalDeps

Functions

Name Parameters Param types (JSDoc) Returns Calls (same file / helpers)
publicProfile c: Customer unknown see Call graph
Profile payload safe to return to the customer (no hashes/secrets).
sessionAuth deps: PortalDeps unknown see Call graph
save deps: PortalDeps, customer: Customer unknown see Call graph
portalRouter deps: PortalDeps unknown see Call graph

Methods (class / object)

Name Parameters
reload customer: Customer, amountCents: number
return req, res, next

What it imports / requires

  • crypto
  • express
  • ./accounts
  • ./admin
  • ./auth
  • ./billing/credit
  • ./invoicing
  • ./pricing
  • ./usage

Call graph (identifiers invoked)

now, reload, customer, publicProfile, sessionAuth, header, startsWith, slice, get, list, find, status, json, next, save, portalRouter, post, trim, test, hashPassword, findByEmail, randomBytes, toString, create, verifyPassword, verifyTotp, use, delete, setUTCDate, setUTCHours, summaryFor, tiers, applyMonthlyCredit, rateCard, type, send, renderInvoiceHtml, async, generateTotpSecret, totpUri, qr, isInteger, put

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.