inversify-typesafe-decorators

Intro

Typescript 5 made it possible for legacy experimental decorators to check the types of the things they are applied to.

This repository contains helper libraries to enforce the correct types of injected services at compile time, for your favorite ioc container.

Usage

Install

1npm i --save inversify-typesafe-decorators

Use the builtin ServiceIdentifier<T> type to annotate your injection tokens

1import { interfaces } from 'inversify';
2const FOO_TOKEN: interfaces.ServiceIdentifier<IFooService> = 'FOO_SERVICE_TOKEN';

Replace @inject(...) decorators with @TypedInject(...)

Narrowing of injection tokens

I recommend to put your injection tokens in a separate .token.ts file. Typescript does some agressive type narrowing, so the following (wrong) code actually typechecks:

1import { ContainerModule, injectable, interfaces } from 'inversify';
2import { TypedInject } from 'inversify-typesafe-decorators';
3
4interface IFooService { bar(): string; }
5interface IBarService { bar(): string; }
6
7const FOO_TOKEN: interfaces.ServiceIdentifier<IFooService> = Symbol('FOO_TOKEN');
8const BAR_TOKEN: interfaces.ServiceIdentifier<IBarService> = Symbol('BAR_TOKEN');
9
10@injectable()
11class FooService { foo() { return ''; } }
12
13export const getModule = () => new ContainerModule(bind => {
14  // Notice the error here
15  bind(BAR_TOKEN).to(FooService);
16});

In this example, the type of BAR_TOKEN is narrowed to symbol, and because of that bind infers unknown as the service type.

There are a few possible solutions to prevent type narrowing:

• Put the tokens in a separate source file. This is the recommended approach.
• or use const BAR_TOKEN = Symbol('BAR_TOKEN') as interfaces.ServiceIdentifier<IBarService>;
• or use const BAR_TOKEN: interfaces.ServiceIdentifier<IBarService> = Symbol('BAR_TOKEN') as any;

Future

Eventually I'd love to see stricter types integrated into TypeScript, Nest and Inversify. Until that, we can use these libraries.