Edit

Externals

External dependencies

Sometimes (for example when dealing with React components) it is necessary to inject dependencies into classes which are not @Components() themself and which could not be managed by TSDI.
This most likely happens if a third-party library creates your components using new.

In this cases your components should be marked with the @external decorator.
The decorator overrides the constructor() of all components and injects dependencies even if the lifecycle is uncontrolled.

import { TSDI, Component, External } from 'tsdi';

@Component
class A {}

@Component
class B {}

@External()
class C {
  @Inject()
  public a: A;

  public b: B;

  constructor(@Inject() b: B) {
    this.b = b;
  }

  @Initialize()
  public init() {}
}

const tsdi: TSDI = new TSDI();
tsdi.enableComponentScanner();

const c = new C();
console.log(c.a);

externalContainerResolver

To locate the container from external scope (internally to TSDI) the static method externalContainerResolver exists. By default it has a reference to the last created TSDI instance (most likely you have one container in production).

To be more customizable (for example have one container per request) it is possible to overwrite this method and resolve the required TSDI instance by yourself.

const createNamespace = require('cls-hooked').createNamespace;
const local = createNamespace('local');

TSDI.externalContainerResolver = () => local.get('tsdi');

server((req, res) => {
  // incoming http request
  local.run(() => {
    const tsdi = new TSDI();
    try {
      local.set('tsdi', tsdi);

      // handle request
    } finally {
      containers.delete(req);
      tsdi.close();
    }
  });
});