HTTP

Controller and Routes

import { Body, Get, HttpController, Param, Post, Query } from "@smounters/imperium/decorators";

@HttpController("/users")
class UsersHttpController {
  @Get("/")
  findAll(@Query("email") email?: string) {
    return { email };
  }

  @Get("/:id")
  findById(@Param("id") id: string) {
    return { id };
  }

  @Post("/")
  create(@Body() payload: { email: string }) {
    return payload;
  }
}

Parameter Decorators

• @Body(key?)
• @Query(key?)
• @Param(key?)
• @Header(key)
• @Req()
• @Res()

Prefixes

ServerOptions supports three levels:

• prefix (global)
• httpPrefix
• rpcPrefix

Final HTTP path = prefix + httpPrefix + routePath

CORS

await app.start({
  cors: {
    enabled: true,
    origin: ["https://app.example.com"],
    methods: ["GET", "POST", "PATCH", "DELETE"],
    allowedHeaders: ["content-type", "authorization"],
  },
});

Health Endpoint

await app.start({
  health: {
    enabled: true,
    path: "/health",
    check: async () => ({ ok: true, details: { db: "up" } }),
  },
});