Container

Container is the only class TinyDI has. An instance owns a set of registrations, keyed by token.

const container = new Container();

registerInstance

Registers an instance you already created. It is always treated as Singleton — every resolve() call returns that exact object.

const ConfigToken = createToken<Config>('Config');
container.registerInstance(ConfigToken, { apiUrl: 'https://example.com' });

registerFactory

Registers a factory used to build the service lazily, on first resolution. The factory receives the container itself, so it can resolve its own dependencies explicitly.

container.registerFactory(
  UserServiceToken,
  (c) => new UserService(c.resolve(UserRepositoryToken)),
);

The third, optional argument is a ServiceLifetime — it defaults to Singleton.

resolve

Resolves the service registered under a token, fully typed with no explicit generic.

const userService = container.resolve(UserServiceToken);

has, remove, clear

Manage the registration set directly: has(token) checks whether a token is registered, remove(token) removes a single registration, and clear() removes all of them.

container.has(ConfigToken); // true
 
container.remove(ConfigToken);
container.has(ConfigToken); // false
 
container.clear(); // removes every registration