Modules and DI

Module Shape

import { Module } from "@smounters/imperium/decorators";

@Module({
  imports: [],
  providers: [],
  controllers: [],
  httpControllers: [],
  exports: [],
  global: false,
})
class AppModule {}

Provider Types

• Class provider: providers: [UsersService]
• useClass
• useValue
• useFactory
• useExisting

const TOKENS = {
  Config: Symbol("Config"),
  Clock: Symbol("Clock"),
};

@Module({
  providers: [
    UsersService,
    { provide: TOKENS.Config, useValue: { env: "prod" } },
    { provide: TOKENS.Clock, useFactory: () => Date.now() },
    { provide: "UsersServiceAlias", useExisting: UsersService },
  ],
  exports: [UsersService, TOKENS.Config],
})
class UsersModule {}

Injection Decorators

import { Inject, InjectAll, Injectable, Optional } from "@smounters/imperium/decorators";

@Injectable()
class BillingService {
  constructor(
    @Inject("UsersServiceAlias") private readonly users: UsersService,
    @Optional(Symbol.for("Cache")) private readonly cache?: unknown,
  ) {}
}

Multi Providers

multi is supported for explicit intent in provider metadata.

const AML_RULES = Symbol("AML_RULES");

@Module({
  providers: [
    { provide: AML_RULES, multi: true, useClass: SanctionsRule },
    { provide: AML_RULES, multi: true, useClass: MixerRule },
    { provide: AML_RULES, multi: true, useClass: FreshAddressRule },
  ],
  exports: [AML_RULES],
})
class AmlModule {}

@Injectable()
class AmlEngine {
  constructor(@InjectAll(AML_RULES) private readonly rules: AmlRule[]) {}
}

You can also resolve multi providers manually:

const rules = app.resolveAll<AmlRule>(AML_RULES);

Global Enhancers

Use app-level enhancer tokens from @smounters/imperium/core:

• APP_GUARD
• APP_PIPE
• APP_INTERCEPTOR
• APP_FILTER

import { APP_FILTER } from "@smounters/imperium/core";

@Module({
  providers: [
    {
      provide: APP_FILTER,
      useClass: GlobalExceptionFilter,
    },
  ],
})
class AppModule {}