@frontmcp/di 0.0.1 → 0.7.2

package/decorators/async-with.decorator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @AsyncWith decorator for async dependency resolution.
+ *
+ * Use this decorator when a class needs async initialization or when
+ * you want to avoid TDZ (Temporal Dead Zone) issues with circular imports.
+ */
+import 'reflect-metadata';
+import type { Token } from '../interfaces/base.interface.js';
+/**
+ * Decorator that marks a class for async initialization.
+ *
+ * When a class is decorated with @AsyncWith, the DI container will:
+ * 1. Resolve the specified dependency tokens
+ * 2. Call the static `with(...deps)` method instead of the constructor
+ * 3. Await the result if it's a Promise
+ *
+ * This is useful for:
+ * - Async initialization that requires resolved dependencies
+ * - Avoiding TDZ issues with ESM circular imports
+ * - Lazy dependency declaration
+ *
+ * @param tokensFactory - Function returning array of dependency tokens
+ * @returns Class decorator
+ *
+ * @example
+ * ```typescript
+ * @AsyncWith(() => [DatabaseConnection, Logger])
+ * class UserRepository {
+ *   private constructor(private db: DatabaseConnection, private logger: Logger) {}
+ *
+ *   static async with(db: DatabaseConnection, logger: Logger): Promise<UserRepository> {
+ *     const repo = new UserRepository(db, logger);
+ *     await repo.initialize();
+ *     return repo;
+ *   }
+ *
+ *   private async initialize() {
+ *     // Async setup
+ *   }
+ * }
+ * ```
+ */
+export declare function AsyncWith<T extends readonly Token[]>(tokensFactory: () => T): ClassDecorator;

package/decorators/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Decorators for dependency injection.
+ */
+export { AsyncWith } from './async-with.decorator.js';