from litestar import Controller, get, post, delete, patch, put
from litestar.di import Provide
from litestar.params import Parameter
from litestar_vite.inertia import InertiaResponse

class FeatureController(Controller):
    path = "/feature"
    tags = ["Feature"]

    @get("/")
    async def list(self, service: FeatureService) -> InertiaResponse:
        items = await service.list()
        return InertiaResponse(
            component="Feature/List",
            props={"items": items}
        )

    @get("/{item_id:uuid}")
    async def show(
        self,
        item_id: UUID,
        service: FeatureService,
    ) -> InertiaResponse:
        item = await service.get(item_id)
        return InertiaResponse(
            component="Feature/Show",
            props={"item": item}
        )

    @post("/")
    async def create(
        self,
        data: CreateDTO,
        service: FeatureService,
    ) -> InertiaResponse:
        item = await service.create(data)
        return InertiaResponse(
            component="Feature/Show",
            props={"item": item}
        )

from litestar.di import Provide

def provide_service(db_session: AsyncSession) -> FeatureService:
    return FeatureService(session=db_session)

# In controller
dependencies = {"service": Provide(provide_service)}

from litestar.connection import ASGIConnection
from litestar.handlers import BaseRouteHandler

async def require_auth(
    connection: ASGIConnection,
    _: BaseRouteHandler,
) -> None:
    if not connection.user:
        raise PermissionDeniedException("Authentication required")

from litestar_vite.inertia import InertiaResponse

# Page response
return InertiaResponse(
    component="Feature/List",  # Maps to resources/pages/Feature/List.tsx
    props={"items": items, "meta": meta}
)

# Redirect
return InertiaResponse.redirect("/feature")

app_config.route_handlers.extend([
    FeatureController,
])

mcp__context7__get-library-docs(
    context7CompatibleLibraryID="/litestar-org/litestar",
    topic="controllers",  # or: routing, di, guards, middleware
    mode="code"
)