Context
Surfaced during a usability/extensibility survey. The extension points exist (messaging adapters, external delivery) but are undocumented, so integrators must read source.
Suggested content (docs/extending.md)
- How to add a messaging provider (email/SMS) via the
@seamless-auth/messaging transport contract and src/config/directMessaging.ts.
- How external delivery mode works end to end (
x-seamless-auth-delivery-mode: external, service token in production) and when to use it.
- Guidance and boundaries for customizing token claims or adding middleware, and what is intentionally not extensible.
Acceptance
- A new integrator can plug in a provider or use external delivery without reading the source.
Context
Surfaced during a usability/extensibility survey. The extension points exist (messaging adapters, external delivery) but are undocumented, so integrators must read source.
Suggested content (docs/extending.md)
@seamless-auth/messagingtransport contract andsrc/config/directMessaging.ts.x-seamless-auth-delivery-mode: external, service token in production) and when to use it.Acceptance