FlareBase

class FlareBase

Root injectable base class extended by all controllers, middleware, error handlers, and services.

Provides DI via inject() and config access via config(). Lifecycle hooks (onStart, onStop, dispose) are NOT available here. Services that require lifecycle management should extend FlareService instead.

How you get one

new FlareBase()

Constructor

new FlareBase(): FlareBase

Properties

config

config: readonly ConfigToken<unknown>[]

Declares the config tokens this class requires.

Parallel to static deps. When declared, this.config(token) validates that the token is in this array before resolving, identical to how this.inject(token) validates static deps.

deps

deps: readonly ServiceToken<FlareService>[] | undefined

Declares the service tokens this class is allowed to inject().

Tokens not listed here cause inject() to throw at the call site, naming both the class and the offending token.

Methods

config()

config<T>(token: ConfigToken<T>): T

Resolves a typed config section by token.

Mirrors inject() + static deps: the class must declare a static config array, and the requested token must appear in it. Both checks throw a developer-facing error when violated.

token ConfigToken<T>

returns T

Example:

class DbService extends FlareService {
  static config = [DbConfig];

  async onStart() {
    const { url } = this.config(DbConfig);
  }
}

Throws:

When the class has no static config declaration.

Throws:

When the token is not present in static config.

inject()

inject<T extends FlareService>(token: ServiceToken<T>): Injected<T>

Resolves a dependency declared on static deps, returning the service with framework members hidden from its static type.

token ServiceToken<T>

returns Injected<T>

Throws:

When the token is not present in this class’s static deps array.

Learn: Overview