Getting Started

1. Install Dependencies

pnpm add @smounters/imperium reflect-metadata tsyringe fastify @connectrpc/connect @connectrpc/connect-fastify zod

2. Enable Decorator Metadata

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  }
}

3. Create Your First Module

import "reflect-metadata";

import { Application } from "@smounters/imperium/core";
import { Body, HttpController, Injectable, Module, Post } from "@smounters/imperium/decorators";

@Injectable()
class AuthService {
  signIn(email: string) {
    return { email, ok: true };
  }
}

@HttpController("/auth")
class AuthController {
  constructor(private readonly authService: AuthService) {}

  @Post("/sign-in")
  signIn(@Body("email") email: string) {
    return this.authService.signIn(email);
  }
}

@Module({
  providers: [AuthService],
  httpControllers: [AuthController],
})
class AppModule {}

const app = new Application(AppModule, {
  host: "0.0.0.0",
  port: 3000,
  accessLogs: true,
});

await app.start();

4. Add Config Validation (Optional)

import { ConfigService } from "@smounters/imperium/services";
import { appConfigSchema, type AppConfig } from "@smounters/imperium/validation";

const app = new Application(AppModule, { host: "0.0.0.0" });

app.configureConfig(appConfigSchema, process.env);
const config = app.resolve(ConfigService<AppConfig>).getAll();

await app.start({ port: config.APP_PORT });