Glossary
This glossary keeps SPAPS terms consistent across product, code, and operations pages. Use the code term when the code has a clear name, even when a downstream app uses a friendlier label.
| Term | Meaning |
|---|---|
| Application | A SPAPS client app row with keys, allowed origins, settings, and related access rules. |
| API key | A publishable, secret, or legacy key used to identify the calling application. |
| Publishable key | Browser-facing key, typically spaps_pub_*, constrained by endpoint scope and origin validation. |
| Secret key | Server-side key, typically spaps_sec_* or spaps_*, allowed to call privileged app endpoints. |
| Legacy key | Deprecated plaintext or hashed value stored in applications.api_key; production startup checks require legacy auth to be disabled. |
| Local mode | Development/test mode that can provide a local application and local personas without full auth setup. |
| Principal | The authenticated user represented by JWT claims or a local-mode persona. |
| Entitlement | A feature-access grant, usually projected from Stripe, wallet payment, manual admin action, or policy. |
| Wallet auth | A signature-verification flow for chains such as Solana and Ethereum. |
| Response envelope | The standard JSON wrapper applied by ResponseEnvelopeMiddleware. |
| Startup invariant | A fail-fast safety rule checked during application lifespan before traffic is served. |
| Downstream service | Another backend that uses the quickstart package or calls SPAPS through server-side clients. |
| Golden app pack | A reference contract for browser auth, Stripe checkout, entitlement projection, and paid-access policy. |
Cross-links
Discovery terms
Use this section when search terms come from package names, command families, or runtime domains instead of product prose.
Package names
| Search term | Opens |
|---|---|
spaps / npx spaps | SPAPS CLI Quickstart |
spaps-sdk | SPAPS SDK (TypeScript) |
spaps-server-quickstart | First Service |
spaps-types | Companion packages |
spaps-wallet-utils | Companion packages |
spaps-issue-reporting-react | Companion packages |
Command families
| Search term | Opens |
|---|---|
spaps local, spaps status, spaps doctor | Local runtime |
spaps quickstart, spaps create, spaps verify, spaps tools | SPAPS CLI Quickstart |
spaps fixtures init, spaps fixtures apply, spaps fixtures storage-state | SPAPS CLI Quickstart |
spaps login, spaps connect, spaps whoami, spaps token, spaps logout | SPAPS CLI Quickstart |
spaps dayrate config, spaps email send, spaps policy list, spaps webhook register | SPAPS CLI Quickstart |
Core domains
| Search term | Opens |
|---|---|
| Auth, sessions, users, wallets | Domain catalog |
| Admin applications, entitlements, mappings | Billing and entitlements |
| Stripe checkout, subscriptions, portal, webhook delivery | Webhooks and event delivery |
| Email, secure messages, policies | Domain catalog |