Expand description
Opinionated async Rust framework for building Mae-Technologies micro-services.
Use with mae_macros (#[run_app], #[schema],
#[mae_test]). API request/response types belong in your service or a models crate.
§Public surface (stable for service authors)
app— configuration,DeriveContext, Actix serverruncontext— [RequestContext] (pool + session + custom config per request)repo— typed Postgres layer:WithExecutor, filters,DomainStatusposting— multi-step post orchestration (PostingController)route—Success,ServiceError, health routesmiddleware— session / micro-service auth (installed by#[run_app])session— logged-in user identityservice—HttpServiceClientfor downstream HTTPcrypto/totp— optional field encryption and TOTP helpersutil— small shared helperstesting— integration-test utilities (test-utilsfeature only)
Internal modules (repo::__private__, container refcount guards, etc.) are not API.
Modules§
- app
- Application lifecycle helpers for Mae micro-services.
- context
- Per-request context: Postgres pool/transaction, session, and service-specific config.
- crypto
- Symmetric encryption for secrets at rest (AES-256-GCM).
- middleware
- Actix-Web middleware for session validation and request context injection.
- posting
- Multi-step posting orchestration (Command + Facade).
- repo
- Typed async repository layer over SQLx/Postgres.
- route
- service
- HTTP client for proxying requests between Mae micro-services.
- session
- telemetry
- testing
- Testing utilities for Mae-based services.
- totp
- TOTP helpers (RFC 6238) for authenticator-app 2FA.
- util