@enshou/di 0.1.2 → 0.2.0

package/dist/index.d.ts

@@ -9,15 +9,32 @@ declare function createToken<T>(description: string): Token<T>;
 //#endregion
 //#region src/container.d.ts
 type Scope = "singleton" | "transient";
+type ProviderToken<T> = Token<T> | string | Class<T>;
+interface ClassProvider<T> {
+  provide: ProviderToken<T>;
+  useClass: Class<T>;
+  scope?: Scope;
+}
+interface ValueProvider<T> {
+  provide: ProviderToken<T>;
+  useValue: T;
+}
+interface FactoryProvider<T> {
+  provide: ProviderToken<T>;
+  useFactory: (container: Container) => T;
+  scope?: Scope;
+}
+type Provider<T> = ClassProvider<T> | ValueProvider<T> | FactoryProvider<T>;
 declare class Container {
   private readonly providers;
   private readonly singletonCache;
-  registerValue(token: Token<unknown> | string, value: unknown): void;
-  registerClass(token: Token<unknown> | string | Class<any>, value: Class<any>, scope?: Scope): void;
-  resolve<T>(token: Token<T> | string | Class<any>): T;
+  register<T>(provider: Provider<T>): void;
+  registerValue(token: ProviderToken<unknown>, value: unknown): void;
+  registerClass(token: ProviderToken<unknown>, value: Class<any>, scope?: Scope): void;
+  resolve<T>(token: ProviderToken<T>): T;
 }
 //#endregion
 //#region src/inject.d.ts
 declare function Inject(tokens: Array<Token<any> | string | Class<any>>): (target: any, _context?: ClassDecoratorContext) => void;
 //#endregion
-export { Container, Inject, type Scope, type Token, createToken };
+export { type ClassProvider, Container, type FactoryProvider, Inject, type Provider, type ProviderToken, type Scope, type Token, type ValueProvider, createToken };

package/dist/index.js

@@ -10,12 +10,35 @@ function Inject(tokens) {
 var Container = class {
 	providers = /* @__PURE__ */ new Map();
 	singletonCache = /* @__PURE__ */ new Map();
+	register(provider) {
+		this.singletonCache.delete(provider.provide);
+		if ("useValue" in provider) {
+			this.singletonCache.set(provider.provide, provider.useValue);
+			return;
+		}
+		if ("useFactory" in provider) {
+			this.providers.set(provider.provide, {
+				kind: "factory",
+				useFactory: provider.useFactory,
+				scope: provider.scope ?? "singleton"
+			});
+			return;
+		}
+		this.providers.set(provider.provide, {
+			kind: "class",
+			useClass: provider.useClass,
+			scope: provider.scope ?? "singleton"
+		});
+	}
 	registerValue(token, value) {
-		this.singletonCache.set(token, value);
+		this.register({
+			provide: token,
+			useValue: value
+		});
 	}
 	registerClass(token, value, scope = "singleton") {
-		this.providers.set(token, {
-			kind: "class",
+		this.register({
+			provide: token,
 			useClass: value,
 			scope
 		});
@@ -24,8 +47,12 @@ var Container = class {
 		if (this.singletonCache.has(token)) return this.singletonCache.get(token);
 		const provider = this.providers.get(token);
 		if (!provider) throw Error(`No provider for ${String(token)}`);
-		const deps = (provider.useClass[INJECTS_KEY] ?? []).map(this.resolve.bind(this));
-		const value = new provider.useClass(...deps);
+		let value;
+		if (provider.kind === "factory") value = provider.useFactory(this);
+		else {
+			const deps = (provider.useClass[INJECTS_KEY] ?? []).map(this.resolve.bind(this));
+			value = new provider.useClass(...deps);
+		}
 		if (provider.scope === "singleton") this.singletonCache.set(token, value);
 		return value;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enshou/di",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "private": false,
   "license": "Apache-2.0",
   "author": "Ivan Popov <iiivanpopov999@gmail.com>",

package/README.md

@@ -1,131 +0,0 @@
-# @enshou/di
-
-A small dependency injection container for TypeScript.
-
-It gives you a typed token system, a simple container, and an explicit
-`@Inject(...)` decorator for constructor dependencies.
-
-## Quick example
-
-```ts
-import { Container, Inject, createToken } from '@enshou/di'
-
-type AppConfig = {
-  apiUrl: string
-}
-
-const CONFIG = createToken<AppConfig>('config')
-const LOGGER = createToken<Logger>('logger')
-const API = createToken<ApiClient>('api')
-
-class Logger {
-  log(message: string) {
-    console.log(message)
-  }
-}
-
-@Inject([CONFIG, LOGGER])
-class ApiClient {
-  constructor(
-    private readonly config: AppConfig,
-    private readonly logger: Logger,
-  ) {}
-
-  ping() {
-    this.logger.log(`GET ${this.config.apiUrl}/ping`)
-  }
-}
-
-const container = new Container()
-
-container.registerValue(CONFIG, {
-  apiUrl: 'https://example.dev',
-})
-
-container.registerClass(LOGGER, Logger)
-container.registerClass(API, ApiClient)
-
-const api = container.resolve(API)
-api.ping()
-```
-
-## API
-
-### `createToken<T>(description)`
-
-Creates a unique, typed token.
-
-```ts
-const USER_REPOSITORY = createToken<UserRepository>('user-repository')
-```
-
-### `new Container()`
-
-Creates a new dependency container.
-
-### `container.registerValue(token, value)`
-
-Registers a prebuilt value.
-
-Values are stored in the singleton cache, so resolving the same token always
-returns the same instance.
-
-```ts
-container.registerValue(CONFIG, { apiUrl: 'https://example.dev' })
-```
-
-### `container.registerClass(token, Class, scope?)`
-
-Registers a class provider for a token.
-
-- `singleton` by default: the instance is created once and reused
-- `transient`: a new instance is created on every `resolve`
-
-```ts
-container.registerClass(LOGGER, Logger, 'singleton')
-container.registerClass(API, ApiClient, 'transient')
-```
-
-### `container.resolve(token)`
-
-Resolves a dependency by token.
-
-Throws if no provider has been registered for that token.
-
-```ts
-const logger = container.resolve(LOGGER)
-```
-
-### `@Inject(tokens)`
-
-Declares the constructor dependencies for a class.
-
-The order of tokens must match the order of constructor parameters.
-
-```ts
-@Inject([CONFIG, LOGGER])
-class ApiClient {
-  constructor(config: AppConfig, logger: Logger) {}
-}
-```
-
-## Container behavior
-
-- `registerValue` always stores the value in the singleton cache
-- class dependencies are resolved recursively through `resolve`
-- singleton instances are created lazily on first resolution
-- transient instances are never cached
-
-## Limitations
-
-- dependencies are declared explicitly with `@Inject(...)`; constructor types are not read automatically
-- the container only supports class providers and value providers
-- circular dependencies are not handled specially
-- tokens are compared by identity, so you must use the same token instance for registration and resolution
-
-## Exports
-
-```ts
-import { Container, Inject, createToken } from '@enshou/di'
-import type { Scope, Token } from '@enshou/di'
-```