@comity/auth-tokens
v0.9.0
Published
Token envelope and facade primitives for Comity.
Readme
@comity/auth-tokens
Token envelope and facade primitives for Comity.
Purpose
Defines token-facing contracts used to structure and issue authentication tokens. Provides a default facade that transports and authentication adapters consume without coupling to a specific token implementation.
Scope
This package:
- ✅ defines token envelope contracts for issued tokens
- ✅ provides a token facade contract and a default implementation
- ✅ exposes typed input structure for token issuance
This package does NOT:
- ❌ verify or sign tokens
- ❌ manage authentication sessions or assurance
- ❌ implement transport-level concerns
Public API
AuthTokenEnvelope— structured wrapper for issued token pairsAuthTokenFacade— domain-level contract for token operationsIssueTokensInput— typed input for token issuanceDefaultAuthTokenFacade— default encapsulation of token issuance
No exhaustive reference; see docs for constraints.
Documentation
- docs/overview.md
- docs/conventions.md
Related Packages
- @comity/auth — authentication domain contracts
- @comity/auth-jose — JOSE token adapter
Status
Stable
Review Completed: 2026-07-25 Reviewer: Hobiri MAGI (DeepSeek v4 Pro) Compliance Score: 99.5% (Green)
