webmail-client/backend/app/api/__init__.py

"""REST API routers (SPEC §9.1). One module per route group."""

from __future__ import annotations

from fastapi import FastAPI


def register_routers(app: FastAPI) -> None:
    """Mount all API routers under the ``/api`` prefix.

    Routers are added milestone by milestone; imports are local so the app
    factory stays importable while modules are still being built out.
    """
    from app.api.accounts import router as accounts_router
    from app.api.actions import router as actions_router
    from app.api.avatar import router as avatar_router
    from app.api.compose import router as compose_router
    from app.api.mailboxes import router as mailboxes_router
    from app.api.messages import router as messages_router
    from app.api.plugins import router as plugins_router
    from app.api.recipients import router as recipients_router
    from app.api.saved_searches import router as saved_searches_router
    from app.api.search import router as search_router
    from app.api.settings import router as settings_router
    from app.api.threads import router as threads_router
    from app.identity.routes import router as auth_router
    from app.ws import router as ws_router

    for router in (
        auth_router,
        accounts_router,
        threads_router,
        messages_router,
        search_router,
        actions_router,
        compose_router,
        recipients_router,
        settings_router,
        mailboxes_router,
        saved_searches_router,
        avatar_router,
        plugins_router,
    ):
        app.include_router(router, prefix="/api")
    app.include_router(ws_router, prefix="/api")

    # Mount discovered plugin routers at /api/plugins/{name} (SPEC §11). Hooks are
    # subscribed in the lifespan startup so they register once per process.
    from app.plugins import loader

    loader.mount_routers(app)