@js-injection/service-provider 1.0.0-alpha.1

package/LICENSE.md

@@ -0,0 +1,15 @@
+The ISC License
+
+Copyright (c) Peter Flannery and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# Type-Safe Dependency Injection Container
+
+[![Pipeline status](https://gitlab.com/js-injection/service-provider/badges/master/pipeline.svg)](https://gitlab.com/js-injection/service-provider/-/pipelines)
+[![NPM version](https://img.shields.io/npm/v/%40js-injection/service-provider.svg)](https://www.npmjs.org/package/%40js-injection/service-provider)
+[![NPM downloads](https://img.shields.io/npm/dm/%40js-injection/service-provider.svg)](https://npmjs.org/package/%40js-injection/service-provider "View this project on NPM")
+
+[![BuyMeACoffee](https://www.buymeacoffee.com/assets/img/custom_images/purple_img.png)](https://www.buymeacoffee.com/peterf)
+
+A lightweight, fully type-safe Dependency Injection (DI) container for TypeScript. Designed for reliability, developer experience, and minification safety.
+
+## Table of Contents
+- [Overview](#overview)
+- [Key Features](#key-features)
+- [Basic Usage](#basic-usage)
+- [Cheatsheet](docs/CHEATSHEET.md)
+- [Development](#development)
+- [License](#license)
+
+## Overview
+
+This project provides a robust DI container that leverages TypeScript's powerful type system to ensure that your dependencies are always resolved correctly. It focuses on a "Pure DI" approach, where dependencies are ideally resolved at the composition root.
+
+## Key Features
+
+- **Strict Type Safety**: Full Intellisense and compile-time validation for all registered services.
+- **Multiple Lifetimes**: Support for `Singleton` (global) and `Scoped` (per-context) services.
+- **Async Support**: Seamless integration with asynchronous factories and functions, including async disposal.
+- **Circular Dependency Detection**: Immediate, descriptive errors if a circular dependency is detected during resolution.
+- **Minification Proof**: Built-in stable identity system ensures that resolution by Class reference works even when class names are mangled.
+- **Zero Runtime Dependencies**: A lean implementation with no external dependencies.
+
+## Basic Usage
+
+```typescript
+import { ServiceCollection } from '@js-injection/service-provider';
+
+interface ILogger { log(msg: string): void; }
+
+class ConsoleLogger implements ILogger { log(msg: string) { console.log(msg); } }
+
+class UserService {
+  constructor(public logger: ILogger) {}
+}
+
+// 1. Define your container structure
+interface MyMap {
+  logger: ILogger;
+  userService: UserService;
+}
+
+// 2. Register services
+const sp = new ServiceCollection<MyMap>()
+  .addSingletonFactory('logger', () => new ConsoleLogger())
+  .addSingletonClass(UserService, 'logger') // Injecting by key
+  .build();
+
+// 3. Resolve services
+const userService = sp.getService(UserService);
+const logger = sp.getService('logger');
+```
+
+## Development
+
+- **Build**: `npm run bundle`
+- **Test**: `npm test`
+- **Smoke Tests**: `npm start` (Runs end-to-end scenarios against bundled code)
+
+## License
+
+Licensed under [ISC](http://opensource.org/licenses/ISC).
+
+Copyright &copy; 2026+ [contributors](https://gitlab.com/js-injection/service-provider/-/graphs/master)

package/dist/index.js

@@ -0,0 +1,2 @@
+var h=class extends Error{constructor(e){super(`Circular dependency detected: ${e}`),this.name="CircularDependencyError"}},p=class extends Error{constructor(e){super(`Service not registered for identifier: ${e}`),this.name="ServiceNotFoundError"}},l=class extends Error{constructor(e){super(e),this.name="RegistrationError"}},m=class extends Error{constructor(){super("ServiceProvider has been disposed and cannot resolve services."),this.name="ServiceProviderDisposedError"}},f=class extends Error{constructor(e){super(`Service "${e}" requires asynchronous disposal but a synchronous dispose was called. Please use await disposeAsync() instead.`),this.name="AsyncDisposalError"}};var v=new WeakMap;function c(y){let e=v.get(y);return e||(e=Symbol(y.name||"AnonymousClass"),v.set(y,e)),e}var u=class y{constructor(e,t,s,n=!1){this.name=e;this.definitions=t;this.parent=s;this.isAsyncScope=n}instances=new Map;resolving=new Set;path=[];disposed=!1;createScope(e="scope"){let t=this.parent||this;return new y(e,this.definitions,t,!1)}createAsyncScope(e="async-scope"){let t=this.parent||this;return new y(e,this.definitions,t,!0)}getService(e){if(this.disposed)throw new m;let t=this.getKey(e);if(this.parent&&this.definitions[t]?.lifetime==="singleton")return this.parent.getService(t);let s=this.definitions[t];if(!s){let i=typeof e=="string"||typeof e=="symbol"?String(e):e.name||String(e);throw new p(i)}let n=s.uid;if(this.instances.has(n))return this.instances.get(n);if(this.resolving.has(n)){let i=this.path.map(r=>typeof r=="symbol"?r.description||String(r):r).concat(typeof t=="symbol"?t.description||String(t):t).join(" -> ");throw new h(i)}this.resolving.add(n),this.path.push(t);try{return s.kind==="value"?this.resolveValue(n,s.value):Array.isArray(s.type)?this.resolveArray(n,s.type):s.kind==="function"&&s.func?this.resolveFunc(n,s.func,s.params):s.factory?this.resolveFactory(n,s.factory):this.resolveClass(n,s.type,s.params)}finally{this.resolving.delete(n),this.path.pop()}}dispose(){if(this.disposed)return;if(this.isAsyncScope)throw new f(this.name);this.disposed=!0;let e=Array.from(this.instances.entries()).reverse();for(let[t,s]of e)if(s&&typeof s.dispose=="function"){if(s.dispose()instanceof Promise)throw new f(typeof t=="symbol"&&t.description||String(t))}else if(s&&typeof s.disposeAsync=="function")throw new f(typeof t=="symbol"&&t.description||String(t));this.instances.clear()}async disposeAsync(){if(this.disposed)return;this.disposed=!0;let e=Array.from(this.instances.values()).reverse();for(let t of e)if(t&&typeof t.disposeAsync=="function")await t.disposeAsync();else if(t&&typeof t.dispose=="function"){let s=t.dispose();s instanceof Promise&&await s}this.instances.clear()}resolveValue(e,t){return this.instances.set(e,t),t}resolveArray(e,t){let s=t.map(n=>this.getService(n));return this.instances.set(e,s),s}resolveFactory(e,t){let s=this.createContainerProxy(),n=t(s,this);return this.instances.set(e,n),n}resolveFunc(e,t,s){let i=(s||[]).map(o=>{let a=this.tryGetKey(o);return a?this.getService(a):o}),r=t(...i);return this.instances.set(e,r),r}resolveClass(e,t,s){let i=(s||[]).map(o=>{let a=this.tryGetKey(o);return a?this.getService(a):o}),r=new t(...i);return this.instances.set(e,r),r}createContainerProxy(){return new Proxy({},{get:(e,t)=>{if(!(typeof t!="string"&&typeof t!="symbol"))return this.getService(t)}})}getKey(e){if(typeof e=="string"||typeof e=="symbol")return e;let t=this.tryGetKey(e);if(t)return t;let s=Array.isArray(e)?`[${e.map(n=>n.name).join(", ")}]`:e.name||String(e);throw new p(s)}tryGetKey(e){if(typeof e=="string"||typeof e=="symbol"){if(e in this.definitions)return e;if(typeof e=="string"){let t=Reflect.ownKeys(this.definitions).find(s=>{let n=this.definitions[s];return n.kind==="service"&&!Array.isArray(n.type)&&n.type?.name===e});if(t)return t}return}if(typeof e=="function"||Array.isArray(e)){let t=c(e);if(t in this.definitions)return t;let s=Reflect.ownKeys(this.definitions).find(n=>{let i=this.definitions[n];return i.kind==="service"&&i.type===e});if(s)return s}}};var K=class{definitions={};typeMap;constructor(){this.typeMap={}}addSingletonFactory(e,t){let s,n,i=!1;if(typeof e=="string"||typeof e=="symbol")s=e,n=this.typeMap[s],i=!0;else{let a=this.resolveKeyAndType(e);s=a.key,n=a.type}let r=i?s:c(n),o={kind:"service",lifetime:"singleton",uid:r,type:n,factory:t};return this.definitions[s]=o,s!==r&&(this.definitions[r]=o),this}addServiceProvider(e){return this.addSingletonFactory(e,(t,s)=>s)}addScopedFactory(e,t){let s,n,i=!1;if(typeof e=="string"||typeof e=="symbol")s=e,n=this.typeMap[s],i=!0;else{let a=this.resolveKeyAndType(e);s=a.key,n=a.type}let r=i?s:c(n),o={kind:"service",lifetime:"scoped",uid:r,type:n,factory:t};return this.definitions[s]=o,s!==r&&(this.definitions[r]=o),this}addSingletonClass(e,...t){let{key:s,type:n}=this.resolveKeyAndType(e),i=c(n),r={kind:"service",lifetime:"singleton",uid:i,type:n,params:t};return this.definitions[s]=r,this.definitions[i]=r,this}addScopedClass(e,...t){let{key:s,type:n}=this.resolveKeyAndType(e),i=c(n),r={kind:"service",lifetime:"scoped",uid:i,type:n,params:t};return this.definitions[s]=r,this.definitions[i]=r,this}addSingletonArray(e,...t){let s={kind:"service",lifetime:"singleton",uid:e,type:t};this.typeMap[e]=t,this.definitions[e]=s;let n=t;for(let i of n){if(Reflect.ownKeys(this.typeMap).find(g=>this.typeMap[g]===i))continue;let o=i.name;if(!o)throw new l(`Class in array "${String(e)}" is missing a name and cannot be auto-registered.`);let a=c(i),d={kind:"service",lifetime:"singleton",uid:a,type:i,params:[]};this.typeMap[o]=i,this.definitions[o]=d,this.definitions[a]=d}return this}addScopedArray(e,...t){let s={kind:"service",lifetime:"scoped",uid:e,type:t};this.typeMap[e]=t,this.definitions[e]=s;let n=t;for(let i of n){if(Reflect.ownKeys(this.typeMap).find(g=>this.typeMap[g]===i))continue;let o=i.name;if(!o)throw new l(`Class in array "${String(e)}" is missing a name and cannot be auto-registered.`);let a=c(i),d={kind:"service",lifetime:"scoped",uid:a,type:i,params:[]};this.typeMap[o]=i,this.definitions[o]=d,this.definitions[a]=d}return this}addSingletonFunc(e,t,...s){return this.definitions[e]={kind:"function",lifetime:"singleton",uid:e,func:t,params:s},this}addScopedFunc(e,t,...s){return this.definitions[e]={kind:"function",lifetime:"scoped",uid:e,func:t,params:s},this}addSingletonValue(e,t){return this.definitions[e]={kind:"value",lifetime:"singleton",uid:e,value:t},this}addScopedValue(e,t){return this.definitions[e]={kind:"value",lifetime:"scoped",uid:e,value:t},this}resolveKeyAndType(e){let t,s=Reflect.ownKeys(this.typeMap).find(n=>this.typeMap[n]===e);return s?t=s:(t=e.name||c(e),this.typeMap[t]=e),{key:t,type:e}}build(e="root"){for(let t of Reflect.ownKeys(this.definitions)){let s=this.definitions[t];if(!(s.kind!=="service"||!Array.isArray(s.type)))for(let n of s.type){let i=n.name,r=this.definitions[i];if(r&&r.params&&r.params.length===0&&n.length>0)throw new l(`Class "${i}" in array "${String(t)}" requires constructor arguments and must be registered independently using addSingletonClass or addScopedClass.`)}}return new u(e,this.definitions)}};export{f as AsyncDisposalError,h as CircularDependencyError,l as RegistrationError,K as ServiceCollection,p as ServiceNotFoundError,u as ServiceProvider,m as ServiceProviderDisposedError};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts", "../src/registry.ts", "../src/service-provider.ts", "../src/service-collection.ts"],
+  "sourcesContent": ["/**\n * Thrown when a circular dependency is detected.\n */\nexport class CircularDependencyError extends Error {\n  constructor(path: string) {\n    super(`Circular dependency detected: ${path}`);\n    this.name = 'CircularDependencyError';\n  }\n}\n\n/**\n * Thrown when a service cannot be resolved.\n */\nexport class ServiceNotFoundError extends Error {\n  constructor(identifier: string) {\n    super(`Service not registered for identifier: ${identifier}`);\n    this.name = 'ServiceNotFoundError';\n  }\n}\n\n/**\n * Thrown when a registration is invalid.\n */\nexport class RegistrationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'RegistrationError';\n  }\n}\n\n/**\n * Thrown when a service provider has been disposed.\n */\nexport class ServiceProviderDisposedError extends Error {\n  constructor() {\n    super('ServiceProvider has been disposed and cannot resolve services.');\n    this.name = 'ServiceProviderDisposedError';\n  }\n}\n\n/**\n * Thrown when a synchronous dispose is called on a scope containing services that require asynchronous disposal.\n */\nexport class AsyncDisposalError extends Error {\n  constructor(serviceKey: string) {\n    super(`Service \"${serviceKey}\" requires asynchronous disposal but a synchronous dispose was called. Please use await disposeAsync() instead.`);\n    this.name = 'AsyncDisposalError';\n  }\n}\n", "import type { Class } from './types.js';\r\n\r\nconst classKeyRegistry = new WeakMap<Class, symbol>();\r\n\r\n/**\r\n * Resolves a stable Symbol for a given class constructor.\r\n * This is used to ensure that DI resolution remains stable even after minification.\r\n * @param type The class constructor.\r\n */\r\nexport function getStableKey(type: Class): symbol {\r\n  let key = classKeyRegistry.get(type);\r\n  if (!key) {\r\n    key = Symbol(type.name || 'AnonymousClass');\r\n    classKeyRegistry.set(type, key);\r\n  }\r\n  return key;\r\n}\r\n", "import {\n  AsyncDisposalError,\n  CircularDependencyError,\n  ServiceNotFoundError,\n  ServiceProviderDisposedError,\n} from './errors.js';\nimport { getStableKey } from './registry.js';\nimport type {\n  Class,\n  ConcreteClass,\n  ImplementationFactory,\n  IServiceProvider,\n  MapToInstance,\n  ResolvedTypeMap,\n  ServiceDefinitionMap,\n  TypeMap,\n} from './types.js';\n\nexport class ServiceProvider<T extends TypeMap> implements IServiceProvider<T> {\n  private instances = new Map<string | symbol, any>();\n  private resolving = new Set<string | symbol>();\n  private path: (string | symbol)[] = [];\n  private disposed = false;\n\n  /**\n   * @param name The name of the service provider.\n   * @param definitions The service definitions map.\n   * @param parent The parent service provider, if any.\n   * @param isAsyncScope Whether this is an asynchronous scope.\n   */\n  constructor(\n    public readonly name: string,\n    private definitions: ServiceDefinitionMap,\n    private parent?: ServiceProvider<T>,\n    private readonly isAsyncScope: boolean = false\n  ) { }\n\n  /**\n   * Creates a new scoped ServiceProvider.\n   * @param name The name of the scope.\n   * @example\n   * const scope = di.createScope('request-scope');\n   */\n  createScope(name: string = 'scope'): IServiceProvider<T> {\n    const root = this.parent || this;\n    return new ServiceProvider<T>(name, this.definitions, root, false);\n  }\n\n  /**\n   * Creates a new scoped ServiceProvider that supports asynchronous disposal.\n   * @param name The name of the scope.\n   * @example\n   * const scope = di.createAsyncScope('worker-scope');\n   */\n  createAsyncScope(name: string = 'async-scope'): IServiceProvider<T> {\n    const root = this.parent || this;\n    return new ServiceProvider<T>(name, this.definitions, root, true);\n  }\n\n  /**\n   * Resolves a service by its key.\n   * @param key The key to resolve.\n   * @example\n   * const logger = di.getService('Logger');\n   */\n  getService<K extends keyof T & (string | symbol)>(key: K): MapToInstance<T[K]>;\n\n  /**\n   * Resolves a service by its Class type.\n   * @param type The class type to resolve.\n   * @example\n   * const logger = di.getService(Logger);\n   */\n  getService<C extends Class>(type: C): InstanceType<C>;\n\n  getService<K extends keyof T & (string | symbol)>(keyOrType: K | T[K]): MapToInstance<T[K]> {\n    if (this.disposed) {\n      throw new ServiceProviderDisposedError();\n    }\n\n    const key = this.getKey(keyOrType);\n\n    if (this.parent && this.definitions[key]?.lifetime === 'singleton') {\n      return this.parent.getService(key as any);\n    }\n\n    const item = this.definitions[key];\n    if (!item) {\n      const name = (typeof keyOrType === 'string' || typeof keyOrType === 'symbol')\n        ? String(keyOrType)\n        : (keyOrType as any).name || String(keyOrType);\n      throw new ServiceNotFoundError(name);\n    }\n\n    const uid = item.uid;\n\n    if (this.instances.has(uid)) {\n      return this.instances.get(uid);\n    }\n\n    if (this.resolving.has(uid)) {\n      const pathStr = this.path.map(k => (typeof k === 'symbol' ? k.description || String(k) : k)).concat(typeof key === 'symbol' ? key.description || String(key) : key).join(' -> ');\n      throw new CircularDependencyError(pathStr);\n    }\n\n    this.resolving.add(uid);\n    this.path.push(key);\n\n    try {\n      if (item.kind === 'value') return this.resolveValue(uid, item.value);\n\n      if (Array.isArray(item.type)) return this.resolveArray(uid, item.type);\n\n      if (item.kind === 'function' && item.func) return this.resolveFunc(uid, item.func, item.params);\n\n      if (item.factory) return this.resolveFactory(uid, item.factory);\n\n      return this.resolveClass(uid, item.type as Class, item.params);\n    } finally {\n      this.resolving.delete(uid);\n      this.path.pop();\n    }\n  }\n\n  /**\n   * Synchronously disposes of all resolved services.\n   * Throws AsyncDisposalError if this is an async scope or if any service disposal returns a Promise.\n   */\n  dispose(): void {\n    if (this.disposed) return;\n\n    if (this.isAsyncScope) {\n      throw new AsyncDisposalError(this.name);\n    }\n\n    this.disposed = true;\n\n    const entries = Array.from(this.instances.entries()).reverse();\n\n    for (const [uid, inst] of entries) {\n      if (inst && typeof inst.dispose === 'function') {\n        const result = inst.dispose();\n        if (result instanceof Promise) {\n          throw new AsyncDisposalError(typeof uid === 'symbol' ? uid.description || String(uid) : String(uid));\n        }\n      } else if (inst && typeof inst.disposeAsync === 'function') {\n        throw new AsyncDisposalError(typeof uid === 'symbol' ? uid.description || String(uid) : String(uid));\n      }\n    }\n\n    this.instances.clear();\n  }\n\n  /**\n   * Asynchronously disposes of all resolved services.\n   */\n  async disposeAsync(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n\n    const entries = Array.from(this.instances.values()).reverse();\n\n    for (const inst of entries) {\n      if (inst && typeof inst.disposeAsync === 'function') {\n        await inst.disposeAsync();\n      } else if (inst && typeof inst.dispose === 'function') {\n        const result = inst.dispose();\n        if (result instanceof Promise) {\n          await result;\n        }\n      }\n    }\n\n    this.instances.clear();\n  }\n\n  /**\n   * Resolves a singleton value.\n   * @param uid The unique ID of the value.\n   * @param value The value to resolve.\n   */\n  private resolveValue(uid: string | symbol, value: any): any {\n    this.instances.set(uid, value);\n    return value;\n  }\n\n  /**\n   * Resolves an array of services.\n   * @param uid The unique ID of the service array.\n   * @param types The class types to resolve for the array.\n   */\n  private resolveArray(uid: string | symbol, types: Class[]): any {\n    const instances = types.map((cls) => {\n      const inst = this.getService(cls);\n      return inst;\n    });\n\n    this.instances.set(uid, instances);\n    return instances;\n  }\n\n  /**\n   * Resolves a service via a factory.\n   * @param uid The unique ID of the service.\n   * @param factory The factory to use for resolution.\n   */\n  private resolveFactory(uid: string | symbol, factory: ImplementationFactory<any, any>): any {\n    const container = this.createContainerProxy();\n    const result = factory(container, this);\n    this.instances.set(uid, result);\n    return result;\n  }\n\n  /**\n   * Resolves a service via a function.\n   * @param uid The unique ID of the service.\n   * @param func The function to use for resolution.\n   * @param params The arguments for the function.\n   */\n  private resolveFunc(uid: string | symbol, func: (...args: any[]) => any, params?: any[]): any {\n    const rawParams = params || [];\n    const resolvedParams = rawParams.map((param) => {\n      const paramKey = this.tryGetKey(param);\n      const inst = paramKey ? this.getService(paramKey) : param;\n      return inst;\n    });\n\n    const result = func(...resolvedParams);\n    this.instances.set(uid, result);\n    return result;\n  }\n\n  /**\n   * Resolves a service via its class type.\n   * @param uid The unique ID of the service.\n   * @param type The class type to instantiate.\n   * @param params The constructor arguments.\n   */\n  private resolveClass(uid: string | symbol, type: Class, params?: any[]): any {\n    const rawParams = params || [];\n    const resolvedParams = rawParams.map((param) => {\n      const paramKey = this.tryGetKey(param);\n      const inst = paramKey ? this.getService(paramKey) : param;\n      return inst;\n    });\n\n    const instance = new (type as ConcreteClass)(...resolvedParams);\n    this.instances.set(uid, instance);\n    return instance;\n  }\n\n  /**\n   * Creates a proxy for the type map to allow resolving services by property access.\n   */\n  private createContainerProxy(): ResolvedTypeMap<T> {\n    return new Proxy({} as ResolvedTypeMap<T>, {\n      get: (_, prop) => {\n        if (typeof prop !== 'string' && typeof prop !== 'symbol') return undefined;\n        return this.getService(prop as any);\n      }\n    });\n  }\n\n  /**\n   * Gets the key for a given key or class type.\n   * @param keyOrType The key or class type.\n   */\n  private getKey<K extends keyof T & (string | symbol)>(keyOrType: K | T[K]): string | symbol {\n    if (typeof keyOrType === 'string' || typeof keyOrType === 'symbol') return keyOrType;\n\n    const key = this.tryGetKey(keyOrType);\n    if (key) return key;\n\n    const name = Array.isArray(keyOrType)\n      ? `[${keyOrType.map((c: any) => (c as any).name).join(', ')}]`\n      : (keyOrType as any).name || String(keyOrType);\n    throw new ServiceNotFoundError(name);\n  }\n\n  /**\n   * Attempts to get the key for a given key or class type without throwing.\n   * @param keyOrType The key or class type.\n   */\n  private tryGetKey(keyOrType: any): string | symbol | undefined {\n    if (typeof keyOrType === 'string' || typeof keyOrType === 'symbol') {\n      if (keyOrType in this.definitions) return keyOrType;\n      \n      // Fallback for string names (backward compatibility)\n      if (typeof keyOrType === 'string') {\n        const entry = Reflect.ownKeys(this.definitions).find((k) => {\n          const v = this.definitions[k as any];\n          return v.kind === 'service' && !Array.isArray(v.type) && (v.type as any)?.name === keyOrType;\n        });\n        if (entry) return entry as string | symbol;\n      }\n      return undefined;\n    }\n\n    if (typeof keyOrType === 'function' || Array.isArray(keyOrType)) {\n      // Check the stable registry first (minification proof)\n      const stableKey = getStableKey(keyOrType as any);\n      if (stableKey in this.definitions) return stableKey;\n\n      // Fallback to searching by reference (for explicit symbols or non-auto registrations)\n      const entry = Reflect.ownKeys(this.definitions).find((k) => {\n        const v = this.definitions[k as any];\n        return v.kind === 'service' && v.type === keyOrType;\n      });\n      if (entry) return entry as string | symbol;\n    }\n\n    return undefined;\n  }\n}\n", "import {\n  RegistrationError,\n} from './errors.js';\nimport { getStableKey } from './registry.js';\nimport { ServiceProvider } from './service-provider.js';\nimport type {\n  Class,\n  ClassArgs,\n  FilterKeys,\n  FilterValueKeys,\n  FilterFuncKeys,\n  FuncArgs,\n  ImplementationFactory,\n  MapToInstance,\n  ServiceDefinitionMap,\n  TypeMap,\n  ServiceDefinition\n} from './types.js';\n\n/**\n * Fluent builder for service collections using a lookup map.\n */\nexport class ServiceCollection<T extends TypeMap> {\n  private definitions: ServiceDefinitionMap = {};\n  private typeMap: T;\n\n  /**\n   * Initializes a new instance of the ServiceCollection class.\n   */\n  constructor() {\n    this.typeMap = {} as T;\n  }\n\n  /**\n   * Adds a singleton service using a factory function.\n   * Key is derived from the class.\n   * @param type The class to register.\n   * @param factory The factory function to create the service instance.\n   * @example\n   * .addSingletonFactory(UserRepo, (c) => new UserRepo(c.UserService))\n   */\n  addSingletonFactory<Key extends keyof T & (string | symbol), C extends Class>(\n    type: C,\n    factory: ImplementationFactory<T, InstanceType<C>>\n  ): this;\n\n  /**\n   * Adds a singleton service using a factory function and a key.\n   * @param key The key to register the service under.\n   * @param factory The factory function to create the service instance.\n   * @example\n   * .addSingletonFactory(\"UserRepo\", (c) => new UserRepo(c.UserService))\n   */\n  addSingletonFactory<Key extends keyof T & (string | symbol)>(\n    key: Key,\n    factory: ImplementationFactory<T, MapToInstance<T[Key]>>\n  ): this;\n\n  addSingletonFactory<Key extends keyof T & (string | symbol)>(\n    keyOrType: Key | Class,\n    factory: ImplementationFactory<T, any>\n  ): this {\n    let key: string | symbol;\n    let type: any;\n    let isExplicitKey = false;\n\n    if (typeof keyOrType === 'string' || typeof keyOrType === 'symbol') {\n      key = keyOrType;\n      type = this.typeMap[key];\n      isExplicitKey = true;\n    } else {\n      const resolved = this.resolveKeyAndType<Key>(keyOrType as any);\n      key = resolved.key;\n      type = resolved.type;\n    }\n\n    const uid = isExplicitKey ? key : getStableKey(type);\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'singleton', uid, type, factory };\n    this.definitions[key] = def;\n    if (key !== uid) this.definitions[uid] = def;\n\n    return this;\n  }\n\n  /**\n   * Registers the ServiceProvider itself as a service.\n   * This allows services to depend on the ServiceProvider to resolve other services dynamically.\n   * @param key The key to register the ServiceProvider under.\n   * @example\n   * .addServiceProvider(\"ServiceProvider\")\n   */\n  addServiceProvider<Key extends keyof T & (string | symbol)>(key: Key) {\n    return this.addSingletonFactory(key as any, (_, sp) => sp)\n  }\n\n  /**\n   * Adds a scoped service using a factory function.\n   * Key is derived from the class.\n   * @param type The class to register.\n   * @param factory The factory function to create the service instance.\n   * @example\n   * .addScopedFactory(UserRepo, (c) => new UserRepo(c.UserService))\n   */\n  addScopedFactory<Key extends keyof T & (string | symbol), C extends Class>(\n    type: C,\n    factory: ImplementationFactory<T, InstanceType<C>>\n  ): this;\n\n  /**\n   * Adds a scoped service using a factory function and a key.\n   * @param key The key to register the service under.\n   * @param factory The factory function to create the service instance.\n   * @example\n   * .addScopedFactory(\"UserRepo\", (c) => new UserRepo(c.UserService))\n   */\n  addScopedFactory<Key extends keyof T & (string | symbol)>(\n    key: Key,\n    factory: ImplementationFactory<T, MapToInstance<T[Key]>>\n  ): this;\n\n  addScopedFactory<Key extends keyof T & (string | symbol)>(\n    keyOrType: Key | Class,\n    factory: ImplementationFactory<T, any>\n  ): this {\n    let key: string | symbol;\n    let type: any;\n    let isExplicitKey = false;\n\n    if (typeof keyOrType === 'string' || typeof keyOrType === 'symbol') {\n      key = keyOrType;\n      type = this.typeMap[key];\n      isExplicitKey = true;\n    } else {\n      const resolved = this.resolveKeyAndType<Key>(keyOrType as any);\n      key = resolved.key;\n      type = resolved.type;\n    }\n\n    const uid = isExplicitKey ? key : getStableKey(type);\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'scoped', uid, type, factory };\n    this.definitions[key] = def;\n    if (key !== uid) this.definitions[uid] = def;\n\n    return this;\n  }\n\n  /**\n   * Adds a singleton service using constructor injection.\n   * Key is derived from the container map based on the Class.\n   * @param type The class to register.\n   * @param params The constructor arguments.\n   * @example\n   * .addSingletonClass(UserService, \"admin\", \"password\")\n   */\n  addSingletonClass<C extends Class>(\n    type: C,\n    ...params: ClassArgs<C, keyof T & (string | symbol)>\n  ): this {\n    const { key, type: typeRef } = this.resolveKeyAndType(type as any);\n    const uid = getStableKey(typeRef);\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'singleton', uid, type: typeRef, params };\n    this.definitions[key] = def;\n    this.definitions[uid] = def;\n    return this;\n  }\n\n  /**\n   * Adds a scoped service using constructor injection.\n   * Key is derived from the container map based on the Class.\n   * @param type The class to register.\n   * @param params The constructor arguments.\n   * @example\n   * .addScopedClass(UserService, \"admin\", \"password\")\n   */\n  addScopedClass<C extends Class>(\n    type: C,\n    ...params: ClassArgs<C, keyof T & (string | symbol)>\n  ): this {\n    const { key, type: typeRef } = this.resolveKeyAndType(type as any);\n    const uid = getStableKey(typeRef);\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'scoped', uid, type: typeRef, params };\n    this.definitions[key] = def;\n    this.definitions[uid] = def;\n    return this;\n  }\n\n  /**\n   * Adds an array of singleton services.\n   * Automatically registers individual classes if not already registered.\n   * @param key The key for the service array.\n   * @param types The classes to register in the array.\n   * @example\n   * .addSingletonArray(\"MessageCommand\", HelloCommand, ByeCommand)\n   */\n  addSingletonArray<\n    Key extends FilterKeys<T, any[]>,\n    C extends (new (...args: any[]) => MapToInstance<T[Key]>[number])[]\n  >(\n    key: Key,\n    ...types: C\n  ): this {\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'singleton', uid: key, type: types };\n    (this.typeMap as any)[key] = types;\n    this.definitions[key] = def;\n\n    // Auto-register individual classes if not already registered\n    const typeArray = types as Class[];\n    for (const type of typeArray) {\n      const foundKey = Reflect.ownKeys(this.typeMap).find(k => this.typeMap[k as any] === type);\n      if (foundKey) continue;\n\n      const name = type.name;\n      if (!name) {\n        throw new RegistrationError(`Class in array \"${String(key)}\" is missing a name and cannot be auto-registered.`);\n      }\n\n      const uid = getStableKey(type);\n      const classDef: ServiceDefinition<any> = { kind: 'service', lifetime: 'singleton', uid, type, params: [] };\n      (this.typeMap as any)[name] = type;\n      this.definitions[name] = classDef;\n      this.definitions[uid] = classDef;\n    }\n\n    return this;\n  }\n\n  /**\n   * Adds an array of scoped services.\n   * Automatically registers individual classes as scoped if not already registered.\n   * @param key The key for the service array.\n   * @param types The classes to register in the array.\n   * @example\n   * .addScopedArray(\"MessageCommand\", HelloCommand, ByeCommand)\n   */\n  addScopedArray<\n    Key extends FilterKeys<T, any[]>,\n    C extends (new (...args: any[]) => MapToInstance<T[Key]>[number])[]\n  >(\n    key: Key,\n    ...types: C\n  ): this {\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'scoped', uid: key, type: types };\n    (this.typeMap as any)[key] = types;\n    this.definitions[key] = def;\n\n    // Auto-register individual classes if not already registered\n    const typeArray = types as Class[];\n    for (const type of typeArray) {\n      const foundKey = Reflect.ownKeys(this.typeMap).find(k => this.typeMap[k as any] === type);\n      if (foundKey) continue;\n\n      const name = type.name;\n      if (!name) {\n        throw new RegistrationError(`Class in array \"${String(key)}\" is missing a name and cannot be auto-registered.`);\n      }\n\n      const uid = getStableKey(type);\n      const classDef: ServiceDefinition<any> = { kind: 'service', lifetime: 'scoped', uid, type, params: [] };\n      (this.typeMap as any)[name] = type;\n      this.definitions[name] = classDef;\n      this.definitions[uid] = classDef;\n    }\n\n    return this;\n  }\n\n  /**\n   * Adds a singleton service using a function.\n   * @param key The key for the service.\n   * @param func The function to register.\n   * @param params The function arguments.\n   * @example\n   * .addSingletonFunc(\"Logger\", createLogger, \"Config\")\n   */\n  addSingletonFunc<Key extends FilterFuncKeys<T>, F extends (...args: any[]) => T[Key]>(\n    key: Key,\n    func: F,\n    ...params: FuncArgs<F, T>\n  ): this {\n    this.definitions[key] = { kind: 'function', lifetime: 'singleton', uid: key, func, params };\n    return this;\n  }\n\n  /**\n   * Adds a scoped service using a function.\n   * @param key The key for the service.\n   * @param func The function to register.\n   * @param params The function arguments.\n   * @example\n   * .addScopedFunc(\"Logger\", createLogger, \"Config\")\n   */\n  addScopedFunc<Key extends FilterFuncKeys<T>, F extends (...args: any[]) => T[Key]>(\n    key: Key,\n    func: F,\n    ...params: FuncArgs<F, T>\n  ): this {\n    this.definitions[key] = { kind: 'function', lifetime: 'scoped', uid: key, func, params };\n    return this;\n  }\n\n  /**\n   * Adds a singleton value.\n   * @param key The key for the value.\n   * @param value The value to register.\n   * @example\n   * .addSingletonValue(\"connectionString\", \"test connection string\")\n   */\n  addSingletonValue<Key extends FilterValueKeys<T>>(\n    key: Key,\n    value: T[Key]\n  ): this {\n    this.definitions[key] = { kind: 'value', lifetime: 'singleton', uid: key, value };\n    return this;\n  }\n\n  /**\n   * Adds a scoped value.\n   * @param key The key for the value.\n   * @param value The value to register.\n   * @example\n   * .addScopedValue(\"connectionString\", \"test connection string\")\n   */\n  addScopedValue<Key extends FilterValueKeys<T>>(\n    key: Key,\n    value: T[Key]\n  ): this {\n    this.definitions[key] = { kind: 'value', lifetime: 'scoped', uid: key, value };\n    return this;\n  }\n\n  /**\n   * Resolves the string key and Class reference for a given type.\n   * If the type is already mapped in the TypeMap, the existing key is used.\n   * Otherwise, it auto-registers the type using its class name as the key.\n   * @param type The class reference to resolve.\n   * @throws RegistrationError if the class name cannot be determined (e.g. anonymous class).\n   * @example\n   * const { key, type } = this.resolveKeyAndType(UserService);\n   */\n  private resolveKeyAndType<Key extends keyof T & (string | symbol)>(type: T[Key] & Class): { key: Key, type: T[Key] } {\n    let key: Key;\n\n    const foundKey = Reflect.ownKeys(this.typeMap).find(\n      (k) => this.typeMap[k as any] === type\n    );\n    if (foundKey) {\n      key = foundKey as Key;\n    } else {\n      // Auto-register using class name for backward compatibility\n      key = (type.name || getStableKey(type)) as any as Key;\n      (this.typeMap as any)[key] = type;\n    }\n\n    return { key, type };\n  }\n\n  /**\n   * Builds the ServiceProvider.\n   * @param name The name of the service provider.\n   * @example\n   * const di = new ServiceCollection<LocalMap>()\n   *   .addSingletonClass(MyService)\n   *   .build();\n   */\n  build(name: string = 'root'): ServiceProvider<T> {\n    // Validate all registered services\n    for (const key of Reflect.ownKeys(this.definitions)) {\n      const item = this.definitions[key as any];\n      if (item.kind !== 'service' || !Array.isArray(item.type)) continue;\n\n      // This is an array of services\n      for (const type of item.type as Class[]) {\n        const name = type.name;\n        const definitionsItem = this.definitions[name];\n\n        // Check if this class was auto-registered (params is empty array) but requires arguments\n        if (definitionsItem && definitionsItem.params && definitionsItem.params.length === 0 && type.length > 0) {\n          throw new RegistrationError(`Class \"${name}\" in array \"${String(key)}\" requires constructor arguments and must be registered independently using addSingletonClass or addScopedClass.`);\n        }\n      }\n    }\n\n    return new ServiceProvider<T>(name, this.definitions);\n  }\n}\n"],
+  "mappings": "AAGO,IAAMA,EAAN,cAAsC,KAAM,CACjD,YAAYC,EAAc,CACxB,MAAM,iCAAiCA,CAAI,EAAE,EAC7C,KAAK,KAAO,yBACd,CACF,EAKaC,EAAN,cAAmC,KAAM,CAC9C,YAAYC,EAAoB,CAC9B,MAAM,0CAA0CA,CAAU,EAAE,EAC5D,KAAK,KAAO,sBACd,CACF,EAKaC,EAAN,cAAgC,KAAM,CAC3C,YAAYC,EAAiB,CAC3B,MAAMA,CAAO,EACb,KAAK,KAAO,mBACd,CACF,EAKaC,EAAN,cAA2C,KAAM,CACtD,aAAc,CACZ,MAAM,gEAAgE,EACtE,KAAK,KAAO,8BACd,CACF,EAKaC,EAAN,cAAiC,KAAM,CAC5C,YAAYC,EAAoB,CAC9B,MAAM,YAAYA,CAAU,iHAAiH,EAC7I,KAAK,KAAO,oBACd,CACF,EC9CA,IAAMC,EAAmB,IAAI,QAOtB,SAASC,EAAaC,EAAqB,CAChD,IAAIC,EAAMH,EAAiB,IAAIE,CAAI,EACnC,OAAKC,IACHA,EAAM,OAAOD,EAAK,MAAQ,gBAAgB,EAC1CF,EAAiB,IAAIE,EAAMC,CAAG,GAEzBA,CACT,CCEO,IAAMC,EAAN,MAAMC,CAAkE,CAY7E,YACkBC,EACRC,EACAC,EACSC,EAAwB,GACzC,CAJgB,UAAAH,EACR,iBAAAC,EACA,YAAAC,EACS,kBAAAC,CACf,CAhBI,UAAY,IAAI,IAChB,UAAY,IAAI,IAChB,KAA4B,CAAC,EAC7B,SAAW,GAqBnB,YAAYH,EAAe,QAA8B,CACvD,IAAMI,EAAO,KAAK,QAAU,KAC5B,OAAO,IAAIL,EAAmBC,EAAM,KAAK,YAAaI,EAAM,EAAK,CACnE,CAQA,iBAAiBJ,EAAe,cAAoC,CAClE,IAAMI,EAAO,KAAK,QAAU,KAC5B,OAAO,IAAIL,EAAmBC,EAAM,KAAK,YAAaI,EAAM,EAAI,CAClE,CAkBA,WAAkDC,EAA0C,CAC1F,GAAI,KAAK,SACP,MAAM,IAAIC,EAGZ,IAAMC,EAAM,KAAK,OAAOF,CAAS,EAEjC,GAAI,KAAK,QAAU,KAAK,YAAYE,CAAG,GAAG,WAAa,YACrD,OAAO,KAAK,OAAO,WAAWA,CAAU,EAG1C,IAAMC,EAAO,KAAK,YAAYD,CAAG,EACjC,GAAI,CAACC,EAAM,CACT,IAAMR,EAAQ,OAAOK,GAAc,UAAY,OAAOA,GAAc,SAChE,OAAOA,CAAS,EACfA,EAAkB,MAAQ,OAAOA,CAAS,EAC/C,MAAM,IAAII,EAAqBT,CAAI,CACrC,CAEA,IAAMU,EAAMF,EAAK,IAEjB,GAAI,KAAK,UAAU,IAAIE,CAAG,EACxB,OAAO,KAAK,UAAU,IAAIA,CAAG,EAG/B,GAAI,KAAK,UAAU,IAAIA,CAAG,EAAG,CAC3B,IAAMC,EAAU,KAAK,KAAK,IAAIC,GAAM,OAAOA,GAAM,SAAWA,EAAE,aAAe,OAAOA,CAAC,EAAIA,CAAE,EAAE,OAAO,OAAOL,GAAQ,SAAWA,EAAI,aAAe,OAAOA,CAAG,EAAIA,CAAG,EAAE,KAAK,MAAM,EAC/K,MAAM,IAAIM,EAAwBF,CAAO,CAC3C,CAEA,KAAK,UAAU,IAAID,CAAG,EACtB,KAAK,KAAK,KAAKH,CAAG,EAElB,GAAI,CACF,OAAIC,EAAK,OAAS,QAAgB,KAAK,aAAaE,EAAKF,EAAK,KAAK,EAE/D,MAAM,QAAQA,EAAK,IAAI,EAAU,KAAK,aAAaE,EAAKF,EAAK,IAAI,EAEjEA,EAAK,OAAS,YAAcA,EAAK,KAAa,KAAK,YAAYE,EAAKF,EAAK,KAAMA,EAAK,MAAM,EAE1FA,EAAK,QAAgB,KAAK,eAAeE,EAAKF,EAAK,OAAO,EAEvD,KAAK,aAAaE,EAAKF,EAAK,KAAeA,EAAK,MAAM,CAC/D,QAAE,CACA,KAAK,UAAU,OAAOE,CAAG,EACzB,KAAK,KAAK,IAAI,CAChB,CACF,CAMA,SAAgB,CACd,GAAI,KAAK,SAAU,OAEnB,GAAI,KAAK,aACP,MAAM,IAAII,EAAmB,KAAK,IAAI,EAGxC,KAAK,SAAW,GAEhB,IAAMC,EAAU,MAAM,KAAK,KAAK,UAAU,QAAQ,CAAC,EAAE,QAAQ,EAE7D,OAAW,CAACL,EAAKM,CAAI,IAAKD,EACxB,GAAIC,GAAQ,OAAOA,EAAK,SAAY,YAElC,GADeA,EAAK,QAAQ,YACN,QACpB,MAAM,IAAIF,EAAmB,OAAOJ,GAAQ,UAAWA,EAAI,aAAe,OAAOA,CAAG,CAAe,UAE5FM,GAAQ,OAAOA,EAAK,cAAiB,WAC9C,MAAM,IAAIF,EAAmB,OAAOJ,GAAQ,UAAWA,EAAI,aAAe,OAAOA,CAAG,CAAe,EAIvG,KAAK,UAAU,MAAM,CACvB,CAKA,MAAM,cAA8B,CAClC,GAAI,KAAK,SAAU,OACnB,KAAK,SAAW,GAEhB,IAAMK,EAAU,MAAM,KAAK,KAAK,UAAU,OAAO,CAAC,EAAE,QAAQ,EAE5D,QAAWC,KAAQD,EACjB,GAAIC,GAAQ,OAAOA,EAAK,cAAiB,WACvC,MAAMA,EAAK,aAAa,UACfA,GAAQ,OAAOA,EAAK,SAAY,WAAY,CACrD,IAAMC,EAASD,EAAK,QAAQ,EACxBC,aAAkB,SACpB,MAAMA,CAEV,CAGF,KAAK,UAAU,MAAM,CACvB,CAOQ,aAAaP,EAAsBQ,EAAiB,CAC1D,YAAK,UAAU,IAAIR,EAAKQ,CAAK,EACtBA,CACT,CAOQ,aAAaR,EAAsBS,EAAqB,CAC9D,IAAMC,EAAYD,EAAM,IAAKE,GACd,KAAK,WAAWA,CAAG,CAEjC,EAED,YAAK,UAAU,IAAIX,EAAKU,CAAS,EAC1BA,CACT,CAOQ,eAAeV,EAAsBY,EAA+C,CAC1F,IAAMC,EAAY,KAAK,qBAAqB,EACtCN,EAASK,EAAQC,EAAW,IAAI,EACtC,YAAK,UAAU,IAAIb,EAAKO,CAAM,EACvBA,CACT,CAQQ,YAAYP,EAAsBc,EAA+BC,EAAqB,CAE5F,IAAMC,GADYD,GAAU,CAAC,GACI,IAAKE,GAAU,CAC9C,IAAMC,EAAW,KAAK,UAAUD,CAAK,EAErC,OADaC,EAAW,KAAK,WAAWA,CAAQ,EAAID,CAEtD,CAAC,EAEKV,EAASO,EAAK,GAAGE,CAAc,EACrC,YAAK,UAAU,IAAIhB,EAAKO,CAAM,EACvBA,CACT,CAQQ,aAAaP,EAAsBmB,EAAaJ,EAAqB,CAE3E,IAAMC,GADYD,GAAU,CAAC,GACI,IAAKE,GAAU,CAC9C,IAAMC,EAAW,KAAK,UAAUD,CAAK,EAErC,OADaC,EAAW,KAAK,WAAWA,CAAQ,EAAID,CAEtD,CAAC,EAEKG,EAAW,IAAKD,EAAuB,GAAGH,CAAc,EAC9D,YAAK,UAAU,IAAIhB,EAAKoB,CAAQ,EACzBA,CACT,CAKQ,sBAA2C,CACjD,OAAO,IAAI,MAAM,CAAC,EAAyB,CACzC,IAAK,CAACC,EAAGC,IAAS,CAChB,GAAI,SAAOA,GAAS,UAAY,OAAOA,GAAS,UAChD,OAAO,KAAK,WAAWA,CAAW,CACpC,CACF,CAAC,CACH,CAMQ,OAA8C3B,EAAsC,CAC1F,GAAI,OAAOA,GAAc,UAAY,OAAOA,GAAc,SAAU,OAAOA,EAE3E,IAAME,EAAM,KAAK,UAAUF,CAAS,EACpC,GAAIE,EAAK,OAAOA,EAEhB,IAAMP,EAAO,MAAM,QAAQK,CAAS,EAChC,IAAIA,EAAU,IAAK4B,GAAYA,EAAU,IAAI,EAAE,KAAK,IAAI,CAAC,IACxD5B,EAAkB,MAAQ,OAAOA,CAAS,EAC/C,MAAM,IAAII,EAAqBT,CAAI,CACrC,CAMQ,UAAUK,EAA6C,CAC7D,GAAI,OAAOA,GAAc,UAAY,OAAOA,GAAc,SAAU,CAClE,GAAIA,KAAa,KAAK,YAAa,OAAOA,EAG1C,GAAI,OAAOA,GAAc,SAAU,CACjC,IAAM6B,EAAQ,QAAQ,QAAQ,KAAK,WAAW,EAAE,KAAMtB,GAAM,CAC1D,IAAMuB,EAAI,KAAK,YAAYvB,CAAQ,EACnC,OAAOuB,EAAE,OAAS,WAAa,CAAC,MAAM,QAAQA,EAAE,IAAI,GAAMA,EAAE,MAAc,OAAS9B,CACrF,CAAC,EACD,GAAI6B,EAAO,OAAOA,CACpB,CACA,MACF,CAEA,GAAI,OAAO7B,GAAc,YAAc,MAAM,QAAQA,CAAS,EAAG,CAE/D,IAAM+B,EAAYC,EAAahC,CAAgB,EAC/C,GAAI+B,KAAa,KAAK,YAAa,OAAOA,EAG1C,IAAMF,EAAQ,QAAQ,QAAQ,KAAK,WAAW,EAAE,KAAMtB,GAAM,CAC1D,IAAMuB,EAAI,KAAK,YAAYvB,CAAQ,EACnC,OAAOuB,EAAE,OAAS,WAAaA,EAAE,OAAS9B,CAC5C,CAAC,EACD,GAAI6B,EAAO,OAAOA,CACpB,CAGF,CACF,ECnSO,IAAMI,EAAN,KAA2C,CACxC,YAAoC,CAAC,EACrC,QAKR,aAAc,CACZ,KAAK,QAAU,CAAC,CAClB,CA2BA,oBACEC,EACAC,EACM,CACN,IAAIC,EACAC,EACAC,EAAgB,GAEpB,GAAI,OAAOJ,GAAc,UAAY,OAAOA,GAAc,SACxDE,EAAMF,EACNG,EAAO,KAAK,QAAQD,CAAG,EACvBE,EAAgB,OACX,CACL,IAAMC,EAAW,KAAK,kBAAuBL,CAAgB,EAC7DE,EAAMG,EAAS,IACfF,EAAOE,EAAS,IAClB,CAEA,IAAMC,EAAMF,EAAgBF,EAAMK,EAAaJ,CAAI,EAC7CK,EAA8B,CAAE,KAAM,UAAW,SAAU,YAAa,IAAAF,EAAK,KAAAH,EAAM,QAAAF,CAAQ,EACjG,YAAK,YAAYC,CAAG,EAAIM,EACpBN,IAAQI,IAAK,KAAK,YAAYA,CAAG,EAAIE,GAElC,IACT,CASA,mBAA4DN,EAAU,CACpE,OAAO,KAAK,oBAAoBA,EAAY,CAACO,EAAGC,IAAOA,CAAE,CAC3D,CA2BA,iBACEV,EACAC,EACM,CACN,IAAIC,EACAC,EACAC,EAAgB,GAEpB,GAAI,OAAOJ,GAAc,UAAY,OAAOA,GAAc,SACxDE,EAAMF,EACNG,EAAO,KAAK,QAAQD,CAAG,EACvBE,EAAgB,OACX,CACL,IAAMC,EAAW,KAAK,kBAAuBL,CAAgB,EAC7DE,EAAMG,EAAS,IACfF,EAAOE,EAAS,IAClB,CAEA,IAAMC,EAAMF,EAAgBF,EAAMK,EAAaJ,CAAI,EAC7CK,EAA8B,CAAE,KAAM,UAAW,SAAU,SAAU,IAAAF,EAAK,KAAAH,EAAM,QAAAF,CAAQ,EAC9F,YAAK,YAAYC,CAAG,EAAIM,EACpBN,IAAQI,IAAK,KAAK,YAAYA,CAAG,EAAIE,GAElC,IACT,CAUA,kBACEL,KACGQ,EACG,CACN,GAAM,CAAE,IAAAT,EAAK,KAAMU,CAAQ,EAAI,KAAK,kBAAkBT,CAAW,EAC3DG,EAAMC,EAAaK,CAAO,EAC1BJ,EAA8B,CAAE,KAAM,UAAW,SAAU,YAAa,IAAAF,EAAK,KAAMM,EAAS,OAAAD,CAAO,EACzG,YAAK,YAAYT,CAAG,EAAIM,EACxB,KAAK,YAAYF,CAAG,EAAIE,EACjB,IACT,CAUA,eACEL,KACGQ,EACG,CACN,GAAM,CAAE,IAAAT,EAAK,KAAMU,CAAQ,EAAI,KAAK,kBAAkBT,CAAW,EAC3DG,EAAMC,EAAaK,CAAO,EAC1BJ,EAA8B,CAAE,KAAM,UAAW,SAAU,SAAU,IAAAF,EAAK,KAAMM,EAAS,OAAAD,CAAO,EACtG,YAAK,YAAYT,CAAG,EAAIM,EACxB,KAAK,YAAYF,CAAG,EAAIE,EACjB,IACT,CAUA,kBAIEN,KACGW,EACG,CACN,IAAML,EAA8B,CAAE,KAAM,UAAW,SAAU,YAAa,IAAKN,EAAK,KAAMW,CAAM,EACnG,KAAK,QAAgBX,CAAG,EAAIW,EAC7B,KAAK,YAAYX,CAAG,EAAIM,EAGxB,IAAMM,EAAYD,EAClB,QAAWV,KAAQW,EAAW,CAE5B,GADiB,QAAQ,QAAQ,KAAK,OAAO,EAAE,KAAKC,GAAK,KAAK,QAAQA,CAAQ,IAAMZ,CAAI,EAC1E,SAEd,IAAMa,EAAOb,EAAK,KAClB,GAAI,CAACa,EACH,MAAM,IAAIC,EAAkB,mBAAmB,OAAOf,CAAG,CAAC,oDAAoD,EAGhH,IAAMI,EAAMC,EAAaJ,CAAI,EACvBe,EAAmC,CAAE,KAAM,UAAW,SAAU,YAAa,IAAAZ,EAAK,KAAAH,EAAM,OAAQ,CAAC,CAAE,EACxG,KAAK,QAAgBa,CAAI,EAAIb,EAC9B,KAAK,YAAYa,CAAI,EAAIE,EACzB,KAAK,YAAYZ,CAAG,EAAIY,CAC1B,CAEA,OAAO,IACT,CAUA,eAIEhB,KACGW,EACG,CACN,IAAML,EAA8B,CAAE,KAAM,UAAW,SAAU,SAAU,IAAKN,EAAK,KAAMW,CAAM,EAChG,KAAK,QAAgBX,CAAG,EAAIW,EAC7B,KAAK,YAAYX,CAAG,EAAIM,EAGxB,IAAMM,EAAYD,EAClB,QAAWV,KAAQW,EAAW,CAE5B,GADiB,QAAQ,QAAQ,KAAK,OAAO,EAAE,KAAKC,GAAK,KAAK,QAAQA,CAAQ,IAAMZ,CAAI,EAC1E,SAEd,IAAMa,EAAOb,EAAK,KAClB,GAAI,CAACa,EACH,MAAM,IAAIC,EAAkB,mBAAmB,OAAOf,CAAG,CAAC,oDAAoD,EAGhH,IAAMI,EAAMC,EAAaJ,CAAI,EACvBe,EAAmC,CAAE,KAAM,UAAW,SAAU,SAAU,IAAAZ,EAAK,KAAAH,EAAM,OAAQ,CAAC,CAAE,EACrG,KAAK,QAAgBa,CAAI,EAAIb,EAC9B,KAAK,YAAYa,CAAI,EAAIE,EACzB,KAAK,YAAYZ,CAAG,EAAIY,CAC1B,CAEA,OAAO,IACT,CAUA,iBACEhB,EACAiB,KACGR,EACG,CACN,YAAK,YAAYT,CAAG,EAAI,CAAE,KAAM,WAAY,SAAU,YAAa,IAAKA,EAAK,KAAAiB,EAAM,OAAAR,CAAO,EACnF,IACT,CAUA,cACET,EACAiB,KACGR,EACG,CACN,YAAK,YAAYT,CAAG,EAAI,CAAE,KAAM,WAAY,SAAU,SAAU,IAAKA,EAAK,KAAAiB,EAAM,OAAAR,CAAO,EAChF,IACT,CASA,kBACET,EACAkB,EACM,CACN,YAAK,YAAYlB,CAAG,EAAI,CAAE,KAAM,QAAS,SAAU,YAAa,IAAKA,EAAK,MAAAkB,CAAM,EACzE,IACT,CASA,eACElB,EACAkB,EACM,CACN,YAAK,YAAYlB,CAAG,EAAI,CAAE,KAAM,QAAS,SAAU,SAAU,IAAKA,EAAK,MAAAkB,CAAM,EACtE,IACT,CAWQ,kBAA2DjB,EAAkD,CACnH,IAAID,EAEEmB,EAAW,QAAQ,QAAQ,KAAK,OAAO,EAAE,KAC5CN,GAAM,KAAK,QAAQA,CAAQ,IAAMZ,CACpC,EACA,OAAIkB,EACFnB,EAAMmB,GAGNnB,EAAOC,EAAK,MAAQI,EAAaJ,CAAI,EACpC,KAAK,QAAgBD,CAAG,EAAIC,GAGxB,CAAE,IAAAD,EAAK,KAAAC,CAAK,CACrB,CAUA,MAAMa,EAAe,OAA4B,CAE/C,QAAWd,KAAO,QAAQ,QAAQ,KAAK,WAAW,EAAG,CACnD,IAAMoB,EAAO,KAAK,YAAYpB,CAAU,EACxC,GAAI,EAAAoB,EAAK,OAAS,WAAa,CAAC,MAAM,QAAQA,EAAK,IAAI,GAGvD,QAAWnB,KAAQmB,EAAK,KAAiB,CACvC,IAAMN,EAAOb,EAAK,KACZoB,EAAkB,KAAK,YAAYP,CAAI,EAG7C,GAAIO,GAAmBA,EAAgB,QAAUA,EAAgB,OAAO,SAAW,GAAKpB,EAAK,OAAS,EACpG,MAAM,IAAIc,EAAkB,UAAUD,CAAI,eAAe,OAAOd,CAAG,CAAC,kHAAkH,CAE1L,CACF,CAEA,OAAO,IAAIsB,EAAmBR,EAAM,KAAK,WAAW,CACtD,CACF",
+  "names": ["CircularDependencyError", "path", "ServiceNotFoundError", "identifier", "RegistrationError", "message", "ServiceProviderDisposedError", "AsyncDisposalError", "serviceKey", "classKeyRegistry", "getStableKey", "type", "key", "ServiceProvider", "_ServiceProvider", "name", "definitions", "parent", "isAsyncScope", "root", "keyOrType", "ServiceProviderDisposedError", "key", "item", "ServiceNotFoundError", "uid", "pathStr", "k", "CircularDependencyError", "AsyncDisposalError", "entries", "inst", "result", "value", "types", "instances", "cls", "factory", "container", "func", "params", "resolvedParams", "param", "paramKey", "type", "instance", "_", "prop", "c", "entry", "v", "stableKey", "getStableKey", "ServiceCollection", "keyOrType", "factory", "key", "type", "isExplicitKey", "resolved", "uid", "getStableKey", "def", "_", "sp", "params", "typeRef", "types", "typeArray", "k", "name", "RegistrationError", "classDef", "func", "value", "foundKey", "item", "definitionsItem", "ServiceProvider"]
+}

package/dist/legacy.cjs

@@ -0,0 +1,2 @@
+"use strict";var v=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var x=(o,e)=>{for(var t in e)v(o,t,{get:e[t],enumerable:!0})},w=(o,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of b(e))!T.call(o,n)&&n!==t&&v(o,n,{get:()=>e[n],enumerable:!(s=C(e,n))||s.enumerable});return o};var F=o=>w(v({},"__esModule",{value:!0}),o);var A={};x(A,{AsyncDisposalError:()=>f,CircularDependencyError:()=>h,RegistrationError:()=>l,ServiceCollection:()=>K,ServiceNotFoundError:()=>p,ServiceProvider:()=>u,ServiceProviderDisposedError:()=>m});module.exports=F(A);var h=class extends Error{constructor(e){super(`Circular dependency detected: ${e}`),this.name="CircularDependencyError"}},p=class extends Error{constructor(e){super(`Service not registered for identifier: ${e}`),this.name="ServiceNotFoundError"}},l=class extends Error{constructor(e){super(e),this.name="RegistrationError"}},m=class extends Error{constructor(){super("ServiceProvider has been disposed and cannot resolve services."),this.name="ServiceProviderDisposedError"}},f=class extends Error{constructor(e){super(`Service "${e}" requires asynchronous disposal but a synchronous dispose was called. Please use await disposeAsync() instead.`),this.name="AsyncDisposalError"}};var S=new WeakMap;function c(o){let e=S.get(o);return e||(e=Symbol(o.name||"AnonymousClass"),S.set(o,e)),e}var u=class o{constructor(e,t,s,n=!1){this.name=e;this.definitions=t;this.parent=s;this.isAsyncScope=n}instances=new Map;resolving=new Set;path=[];disposed=!1;createScope(e="scope"){let t=this.parent||this;return new o(e,this.definitions,t,!1)}createAsyncScope(e="async-scope"){let t=this.parent||this;return new o(e,this.definitions,t,!0)}getService(e){if(this.disposed)throw new m;let t=this.getKey(e);if(this.parent&&this.definitions[t]?.lifetime==="singleton")return this.parent.getService(t);let s=this.definitions[t];if(!s){let i=typeof e=="string"||typeof e=="symbol"?String(e):e.name||String(e);throw new p(i)}let n=s.uid;if(this.instances.has(n))return this.instances.get(n);if(this.resolving.has(n)){let i=this.path.map(r=>typeof r=="symbol"?r.description||String(r):r).concat(typeof t=="symbol"?t.description||String(t):t).join(" -> ");throw new h(i)}this.resolving.add(n),this.path.push(t);try{return s.kind==="value"?this.resolveValue(n,s.value):Array.isArray(s.type)?this.resolveArray(n,s.type):s.kind==="function"&&s.func?this.resolveFunc(n,s.func,s.params):s.factory?this.resolveFactory(n,s.factory):this.resolveClass(n,s.type,s.params)}finally{this.resolving.delete(n),this.path.pop()}}dispose(){if(this.disposed)return;if(this.isAsyncScope)throw new f(this.name);this.disposed=!0;let e=Array.from(this.instances.entries()).reverse();for(let[t,s]of e)if(s&&typeof s.dispose=="function"){if(s.dispose()instanceof Promise)throw new f(typeof t=="symbol"&&t.description||String(t))}else if(s&&typeof s.disposeAsync=="function")throw new f(typeof t=="symbol"&&t.description||String(t));this.instances.clear()}async disposeAsync(){if(this.disposed)return;this.disposed=!0;let e=Array.from(this.instances.values()).reverse();for(let t of e)if(t&&typeof t.disposeAsync=="function")await t.disposeAsync();else if(t&&typeof t.dispose=="function"){let s=t.dispose();s instanceof Promise&&await s}this.instances.clear()}resolveValue(e,t){return this.instances.set(e,t),t}resolveArray(e,t){let s=t.map(n=>this.getService(n));return this.instances.set(e,s),s}resolveFactory(e,t){let s=this.createContainerProxy(),n=t(s,this);return this.instances.set(e,n),n}resolveFunc(e,t,s){let i=(s||[]).map(a=>{let y=this.tryGetKey(a);return y?this.getService(y):a}),r=t(...i);return this.instances.set(e,r),r}resolveClass(e,t,s){let i=(s||[]).map(a=>{let y=this.tryGetKey(a);return y?this.getService(y):a}),r=new t(...i);return this.instances.set(e,r),r}createContainerProxy(){return new Proxy({},{get:(e,t)=>{if(!(typeof t!="string"&&typeof t!="symbol"))return this.getService(t)}})}getKey(e){if(typeof e=="string"||typeof e=="symbol")return e;let t=this.tryGetKey(e);if(t)return t;let s=Array.isArray(e)?`[${e.map(n=>n.name).join(", ")}]`:e.name||String(e);throw new p(s)}tryGetKey(e){if(typeof e=="string"||typeof e=="symbol"){if(e in this.definitions)return e;if(typeof e=="string"){let t=Reflect.ownKeys(this.definitions).find(s=>{let n=this.definitions[s];return n.kind==="service"&&!Array.isArray(n.type)&&n.type?.name===e});if(t)return t}return}if(typeof e=="function"||Array.isArray(e)){let t=c(e);if(t in this.definitions)return t;let s=Reflect.ownKeys(this.definitions).find(n=>{let i=this.definitions[n];return i.kind==="service"&&i.type===e});if(s)return s}}};var K=class{definitions={};typeMap;constructor(){this.typeMap={}}addSingletonFactory(e,t){let s,n,i=!1;if(typeof e=="string"||typeof e=="symbol")s=e,n=this.typeMap[s],i=!0;else{let y=this.resolveKeyAndType(e);s=y.key,n=y.type}let r=i?s:c(n),a={kind:"service",lifetime:"singleton",uid:r,type:n,factory:t};return this.definitions[s]=a,s!==r&&(this.definitions[r]=a),this}addServiceProvider(e){return this.addSingletonFactory(e,(t,s)=>s)}addScopedFactory(e,t){let s,n,i=!1;if(typeof e=="string"||typeof e=="symbol")s=e,n=this.typeMap[s],i=!0;else{let y=this.resolveKeyAndType(e);s=y.key,n=y.type}let r=i?s:c(n),a={kind:"service",lifetime:"scoped",uid:r,type:n,factory:t};return this.definitions[s]=a,s!==r&&(this.definitions[r]=a),this}addSingletonClass(e,...t){let{key:s,type:n}=this.resolveKeyAndType(e),i=c(n),r={kind:"service",lifetime:"singleton",uid:i,type:n,params:t};return this.definitions[s]=r,this.definitions[i]=r,this}addScopedClass(e,...t){let{key:s,type:n}=this.resolveKeyAndType(e),i=c(n),r={kind:"service",lifetime:"scoped",uid:i,type:n,params:t};return this.definitions[s]=r,this.definitions[i]=r,this}addSingletonArray(e,...t){let s={kind:"service",lifetime:"singleton",uid:e,type:t};this.typeMap[e]=t,this.definitions[e]=s;let n=t;for(let i of n){if(Reflect.ownKeys(this.typeMap).find(g=>this.typeMap[g]===i))continue;let a=i.name;if(!a)throw new l(`Class in array "${String(e)}" is missing a name and cannot be auto-registered.`);let y=c(i),d={kind:"service",lifetime:"singleton",uid:y,type:i,params:[]};this.typeMap[a]=i,this.definitions[a]=d,this.definitions[y]=d}return this}addScopedArray(e,...t){let s={kind:"service",lifetime:"scoped",uid:e,type:t};this.typeMap[e]=t,this.definitions[e]=s;let n=t;for(let i of n){if(Reflect.ownKeys(this.typeMap).find(g=>this.typeMap[g]===i))continue;let a=i.name;if(!a)throw new l(`Class in array "${String(e)}" is missing a name and cannot be auto-registered.`);let y=c(i),d={kind:"service",lifetime:"scoped",uid:y,type:i,params:[]};this.typeMap[a]=i,this.definitions[a]=d,this.definitions[y]=d}return this}addSingletonFunc(e,t,...s){return this.definitions[e]={kind:"function",lifetime:"singleton",uid:e,func:t,params:s},this}addScopedFunc(e,t,...s){return this.definitions[e]={kind:"function",lifetime:"scoped",uid:e,func:t,params:s},this}addSingletonValue(e,t){return this.definitions[e]={kind:"value",lifetime:"singleton",uid:e,value:t},this}addScopedValue(e,t){return this.definitions[e]={kind:"value",lifetime:"scoped",uid:e,value:t},this}resolveKeyAndType(e){let t,s=Reflect.ownKeys(this.typeMap).find(n=>this.typeMap[n]===e);return s?t=s:(t=e.name||c(e),this.typeMap[t]=e),{key:t,type:e}}build(e="root"){for(let t of Reflect.ownKeys(this.definitions)){let s=this.definitions[t];if(!(s.kind!=="service"||!Array.isArray(s.type)))for(let n of s.type){let i=n.name,r=this.definitions[i];if(r&&r.params&&r.params.length===0&&n.length>0)throw new l(`Class "${i}" in array "${String(t)}" requires constructor arguments and must be registered independently using addSingletonClass or addScopedClass.`)}}return new u(e,this.definitions)}};0&&(module.exports={AsyncDisposalError,CircularDependencyError,RegistrationError,ServiceCollection,ServiceNotFoundError,ServiceProvider,ServiceProviderDisposedError});
+//# sourceMappingURL=legacy.cjs.map

package/dist/legacy.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/errors.ts", "../src/registry.ts", "../src/service-provider.ts", "../src/service-collection.ts"],
+  "sourcesContent": ["export * from './errors.js';\nexport * from './service-collection.js';\nexport * from './service-provider.js';\nexport * from './types.js';\n", "/**\n * Thrown when a circular dependency is detected.\n */\nexport class CircularDependencyError extends Error {\n  constructor(path: string) {\n    super(`Circular dependency detected: ${path}`);\n    this.name = 'CircularDependencyError';\n  }\n}\n\n/**\n * Thrown when a service cannot be resolved.\n */\nexport class ServiceNotFoundError extends Error {\n  constructor(identifier: string) {\n    super(`Service not registered for identifier: ${identifier}`);\n    this.name = 'ServiceNotFoundError';\n  }\n}\n\n/**\n * Thrown when a registration is invalid.\n */\nexport class RegistrationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'RegistrationError';\n  }\n}\n\n/**\n * Thrown when a service provider has been disposed.\n */\nexport class ServiceProviderDisposedError extends Error {\n  constructor() {\n    super('ServiceProvider has been disposed and cannot resolve services.');\n    this.name = 'ServiceProviderDisposedError';\n  }\n}\n\n/**\n * Thrown when a synchronous dispose is called on a scope containing services that require asynchronous disposal.\n */\nexport class AsyncDisposalError extends Error {\n  constructor(serviceKey: string) {\n    super(`Service \"${serviceKey}\" requires asynchronous disposal but a synchronous dispose was called. Please use await disposeAsync() instead.`);\n    this.name = 'AsyncDisposalError';\n  }\n}\n", "import type { Class } from './types.js';\r\n\r\nconst classKeyRegistry = new WeakMap<Class, symbol>();\r\n\r\n/**\r\n * Resolves a stable Symbol for a given class constructor.\r\n * This is used to ensure that DI resolution remains stable even after minification.\r\n * @param type The class constructor.\r\n */\r\nexport function getStableKey(type: Class): symbol {\r\n  let key = classKeyRegistry.get(type);\r\n  if (!key) {\r\n    key = Symbol(type.name || 'AnonymousClass');\r\n    classKeyRegistry.set(type, key);\r\n  }\r\n  return key;\r\n}\r\n", "import {\n  AsyncDisposalError,\n  CircularDependencyError,\n  ServiceNotFoundError,\n  ServiceProviderDisposedError,\n} from './errors.js';\nimport { getStableKey } from './registry.js';\nimport type {\n  Class,\n  ConcreteClass,\n  ImplementationFactory,\n  IServiceProvider,\n  MapToInstance,\n  ResolvedTypeMap,\n  ServiceDefinitionMap,\n  TypeMap,\n} from './types.js';\n\nexport class ServiceProvider<T extends TypeMap> implements IServiceProvider<T> {\n  private instances = new Map<string | symbol, any>();\n  private resolving = new Set<string | symbol>();\n  private path: (string | symbol)[] = [];\n  private disposed = false;\n\n  /**\n   * @param name The name of the service provider.\n   * @param definitions The service definitions map.\n   * @param parent The parent service provider, if any.\n   * @param isAsyncScope Whether this is an asynchronous scope.\n   */\n  constructor(\n    public readonly name: string,\n    private definitions: ServiceDefinitionMap,\n    private parent?: ServiceProvider<T>,\n    private readonly isAsyncScope: boolean = false\n  ) { }\n\n  /**\n   * Creates a new scoped ServiceProvider.\n   * @param name The name of the scope.\n   * @example\n   * const scope = di.createScope('request-scope');\n   */\n  createScope(name: string = 'scope'): IServiceProvider<T> {\n    const root = this.parent || this;\n    return new ServiceProvider<T>(name, this.definitions, root, false);\n  }\n\n  /**\n   * Creates a new scoped ServiceProvider that supports asynchronous disposal.\n   * @param name The name of the scope.\n   * @example\n   * const scope = di.createAsyncScope('worker-scope');\n   */\n  createAsyncScope(name: string = 'async-scope'): IServiceProvider<T> {\n    const root = this.parent || this;\n    return new ServiceProvider<T>(name, this.definitions, root, true);\n  }\n\n  /**\n   * Resolves a service by its key.\n   * @param key The key to resolve.\n   * @example\n   * const logger = di.getService('Logger');\n   */\n  getService<K extends keyof T & (string | symbol)>(key: K): MapToInstance<T[K]>;\n\n  /**\n   * Resolves a service by its Class type.\n   * @param type The class type to resolve.\n   * @example\n   * const logger = di.getService(Logger);\n   */\n  getService<C extends Class>(type: C): InstanceType<C>;\n\n  getService<K extends keyof T & (string | symbol)>(keyOrType: K | T[K]): MapToInstance<T[K]> {\n    if (this.disposed) {\n      throw new ServiceProviderDisposedError();\n    }\n\n    const key = this.getKey(keyOrType);\n\n    if (this.parent && this.definitions[key]?.lifetime === 'singleton') {\n      return this.parent.getService(key as any);\n    }\n\n    const item = this.definitions[key];\n    if (!item) {\n      const name = (typeof keyOrType === 'string' || typeof keyOrType === 'symbol')\n        ? String(keyOrType)\n        : (keyOrType as any).name || String(keyOrType);\n      throw new ServiceNotFoundError(name);\n    }\n\n    const uid = item.uid;\n\n    if (this.instances.has(uid)) {\n      return this.instances.get(uid);\n    }\n\n    if (this.resolving.has(uid)) {\n      const pathStr = this.path.map(k => (typeof k === 'symbol' ? k.description || String(k) : k)).concat(typeof key === 'symbol' ? key.description || String(key) : key).join(' -> ');\n      throw new CircularDependencyError(pathStr);\n    }\n\n    this.resolving.add(uid);\n    this.path.push(key);\n\n    try {\n      if (item.kind === 'value') return this.resolveValue(uid, item.value);\n\n      if (Array.isArray(item.type)) return this.resolveArray(uid, item.type);\n\n      if (item.kind === 'function' && item.func) return this.resolveFunc(uid, item.func, item.params);\n\n      if (item.factory) return this.resolveFactory(uid, item.factory);\n\n      return this.resolveClass(uid, item.type as Class, item.params);\n    } finally {\n      this.resolving.delete(uid);\n      this.path.pop();\n    }\n  }\n\n  /**\n   * Synchronously disposes of all resolved services.\n   * Throws AsyncDisposalError if this is an async scope or if any service disposal returns a Promise.\n   */\n  dispose(): void {\n    if (this.disposed) return;\n\n    if (this.isAsyncScope) {\n      throw new AsyncDisposalError(this.name);\n    }\n\n    this.disposed = true;\n\n    const entries = Array.from(this.instances.entries()).reverse();\n\n    for (const [uid, inst] of entries) {\n      if (inst && typeof inst.dispose === 'function') {\n        const result = inst.dispose();\n        if (result instanceof Promise) {\n          throw new AsyncDisposalError(typeof uid === 'symbol' ? uid.description || String(uid) : String(uid));\n        }\n      } else if (inst && typeof inst.disposeAsync === 'function') {\n        throw new AsyncDisposalError(typeof uid === 'symbol' ? uid.description || String(uid) : String(uid));\n      }\n    }\n\n    this.instances.clear();\n  }\n\n  /**\n   * Asynchronously disposes of all resolved services.\n   */\n  async disposeAsync(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n\n    const entries = Array.from(this.instances.values()).reverse();\n\n    for (const inst of entries) {\n      if (inst && typeof inst.disposeAsync === 'function') {\n        await inst.disposeAsync();\n      } else if (inst && typeof inst.dispose === 'function') {\n        const result = inst.dispose();\n        if (result instanceof Promise) {\n          await result;\n        }\n      }\n    }\n\n    this.instances.clear();\n  }\n\n  /**\n   * Resolves a singleton value.\n   * @param uid The unique ID of the value.\n   * @param value The value to resolve.\n   */\n  private resolveValue(uid: string | symbol, value: any): any {\n    this.instances.set(uid, value);\n    return value;\n  }\n\n  /**\n   * Resolves an array of services.\n   * @param uid The unique ID of the service array.\n   * @param types The class types to resolve for the array.\n   */\n  private resolveArray(uid: string | symbol, types: Class[]): any {\n    const instances = types.map((cls) => {\n      const inst = this.getService(cls);\n      return inst;\n    });\n\n    this.instances.set(uid, instances);\n    return instances;\n  }\n\n  /**\n   * Resolves a service via a factory.\n   * @param uid The unique ID of the service.\n   * @param factory The factory to use for resolution.\n   */\n  private resolveFactory(uid: string | symbol, factory: ImplementationFactory<any, any>): any {\n    const container = this.createContainerProxy();\n    const result = factory(container, this);\n    this.instances.set(uid, result);\n    return result;\n  }\n\n  /**\n   * Resolves a service via a function.\n   * @param uid The unique ID of the service.\n   * @param func The function to use for resolution.\n   * @param params The arguments for the function.\n   */\n  private resolveFunc(uid: string | symbol, func: (...args: any[]) => any, params?: any[]): any {\n    const rawParams = params || [];\n    const resolvedParams = rawParams.map((param) => {\n      const paramKey = this.tryGetKey(param);\n      const inst = paramKey ? this.getService(paramKey) : param;\n      return inst;\n    });\n\n    const result = func(...resolvedParams);\n    this.instances.set(uid, result);\n    return result;\n  }\n\n  /**\n   * Resolves a service via its class type.\n   * @param uid The unique ID of the service.\n   * @param type The class type to instantiate.\n   * @param params The constructor arguments.\n   */\n  private resolveClass(uid: string | symbol, type: Class, params?: any[]): any {\n    const rawParams = params || [];\n    const resolvedParams = rawParams.map((param) => {\n      const paramKey = this.tryGetKey(param);\n      const inst = paramKey ? this.getService(paramKey) : param;\n      return inst;\n    });\n\n    const instance = new (type as ConcreteClass)(...resolvedParams);\n    this.instances.set(uid, instance);\n    return instance;\n  }\n\n  /**\n   * Creates a proxy for the type map to allow resolving services by property access.\n   */\n  private createContainerProxy(): ResolvedTypeMap<T> {\n    return new Proxy({} as ResolvedTypeMap<T>, {\n      get: (_, prop) => {\n        if (typeof prop !== 'string' && typeof prop !== 'symbol') return undefined;\n        return this.getService(prop as any);\n      }\n    });\n  }\n\n  /**\n   * Gets the key for a given key or class type.\n   * @param keyOrType The key or class type.\n   */\n  private getKey<K extends keyof T & (string | symbol)>(keyOrType: K | T[K]): string | symbol {\n    if (typeof keyOrType === 'string' || typeof keyOrType === 'symbol') return keyOrType;\n\n    const key = this.tryGetKey(keyOrType);\n    if (key) return key;\n\n    const name = Array.isArray(keyOrType)\n      ? `[${keyOrType.map((c: any) => (c as any).name).join(', ')}]`\n      : (keyOrType as any).name || String(keyOrType);\n    throw new ServiceNotFoundError(name);\n  }\n\n  /**\n   * Attempts to get the key for a given key or class type without throwing.\n   * @param keyOrType The key or class type.\n   */\n  private tryGetKey(keyOrType: any): string | symbol | undefined {\n    if (typeof keyOrType === 'string' || typeof keyOrType === 'symbol') {\n      if (keyOrType in this.definitions) return keyOrType;\n      \n      // Fallback for string names (backward compatibility)\n      if (typeof keyOrType === 'string') {\n        const entry = Reflect.ownKeys(this.definitions).find((k) => {\n          const v = this.definitions[k as any];\n          return v.kind === 'service' && !Array.isArray(v.type) && (v.type as any)?.name === keyOrType;\n        });\n        if (entry) return entry as string | symbol;\n      }\n      return undefined;\n    }\n\n    if (typeof keyOrType === 'function' || Array.isArray(keyOrType)) {\n      // Check the stable registry first (minification proof)\n      const stableKey = getStableKey(keyOrType as any);\n      if (stableKey in this.definitions) return stableKey;\n\n      // Fallback to searching by reference (for explicit symbols or non-auto registrations)\n      const entry = Reflect.ownKeys(this.definitions).find((k) => {\n        const v = this.definitions[k as any];\n        return v.kind === 'service' && v.type === keyOrType;\n      });\n      if (entry) return entry as string | symbol;\n    }\n\n    return undefined;\n  }\n}\n", "import {\n  RegistrationError,\n} from './errors.js';\nimport { getStableKey } from './registry.js';\nimport { ServiceProvider } from './service-provider.js';\nimport type {\n  Class,\n  ClassArgs,\n  FilterKeys,\n  FilterValueKeys,\n  FilterFuncKeys,\n  FuncArgs,\n  ImplementationFactory,\n  MapToInstance,\n  ServiceDefinitionMap,\n  TypeMap,\n  ServiceDefinition\n} from './types.js';\n\n/**\n * Fluent builder for service collections using a lookup map.\n */\nexport class ServiceCollection<T extends TypeMap> {\n  private definitions: ServiceDefinitionMap = {};\n  private typeMap: T;\n\n  /**\n   * Initializes a new instance of the ServiceCollection class.\n   */\n  constructor() {\n    this.typeMap = {} as T;\n  }\n\n  /**\n   * Adds a singleton service using a factory function.\n   * Key is derived from the class.\n   * @param type The class to register.\n   * @param factory The factory function to create the service instance.\n   * @example\n   * .addSingletonFactory(UserRepo, (c) => new UserRepo(c.UserService))\n   */\n  addSingletonFactory<Key extends keyof T & (string | symbol), C extends Class>(\n    type: C,\n    factory: ImplementationFactory<T, InstanceType<C>>\n  ): this;\n\n  /**\n   * Adds a singleton service using a factory function and a key.\n   * @param key The key to register the service under.\n   * @param factory The factory function to create the service instance.\n   * @example\n   * .addSingletonFactory(\"UserRepo\", (c) => new UserRepo(c.UserService))\n   */\n  addSingletonFactory<Key extends keyof T & (string | symbol)>(\n    key: Key,\n    factory: ImplementationFactory<T, MapToInstance<T[Key]>>\n  ): this;\n\n  addSingletonFactory<Key extends keyof T & (string | symbol)>(\n    keyOrType: Key | Class,\n    factory: ImplementationFactory<T, any>\n  ): this {\n    let key: string | symbol;\n    let type: any;\n    let isExplicitKey = false;\n\n    if (typeof keyOrType === 'string' || typeof keyOrType === 'symbol') {\n      key = keyOrType;\n      type = this.typeMap[key];\n      isExplicitKey = true;\n    } else {\n      const resolved = this.resolveKeyAndType<Key>(keyOrType as any);\n      key = resolved.key;\n      type = resolved.type;\n    }\n\n    const uid = isExplicitKey ? key : getStableKey(type);\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'singleton', uid, type, factory };\n    this.definitions[key] = def;\n    if (key !== uid) this.definitions[uid] = def;\n\n    return this;\n  }\n\n  /**\n   * Registers the ServiceProvider itself as a service.\n   * This allows services to depend on the ServiceProvider to resolve other services dynamically.\n   * @param key The key to register the ServiceProvider under.\n   * @example\n   * .addServiceProvider(\"ServiceProvider\")\n   */\n  addServiceProvider<Key extends keyof T & (string | symbol)>(key: Key) {\n    return this.addSingletonFactory(key as any, (_, sp) => sp)\n  }\n\n  /**\n   * Adds a scoped service using a factory function.\n   * Key is derived from the class.\n   * @param type The class to register.\n   * @param factory The factory function to create the service instance.\n   * @example\n   * .addScopedFactory(UserRepo, (c) => new UserRepo(c.UserService))\n   */\n  addScopedFactory<Key extends keyof T & (string | symbol), C extends Class>(\n    type: C,\n    factory: ImplementationFactory<T, InstanceType<C>>\n  ): this;\n\n  /**\n   * Adds a scoped service using a factory function and a key.\n   * @param key The key to register the service under.\n   * @param factory The factory function to create the service instance.\n   * @example\n   * .addScopedFactory(\"UserRepo\", (c) => new UserRepo(c.UserService))\n   */\n  addScopedFactory<Key extends keyof T & (string | symbol)>(\n    key: Key,\n    factory: ImplementationFactory<T, MapToInstance<T[Key]>>\n  ): this;\n\n  addScopedFactory<Key extends keyof T & (string | symbol)>(\n    keyOrType: Key | Class,\n    factory: ImplementationFactory<T, any>\n  ): this {\n    let key: string | symbol;\n    let type: any;\n    let isExplicitKey = false;\n\n    if (typeof keyOrType === 'string' || typeof keyOrType === 'symbol') {\n      key = keyOrType;\n      type = this.typeMap[key];\n      isExplicitKey = true;\n    } else {\n      const resolved = this.resolveKeyAndType<Key>(keyOrType as any);\n      key = resolved.key;\n      type = resolved.type;\n    }\n\n    const uid = isExplicitKey ? key : getStableKey(type);\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'scoped', uid, type, factory };\n    this.definitions[key] = def;\n    if (key !== uid) this.definitions[uid] = def;\n\n    return this;\n  }\n\n  /**\n   * Adds a singleton service using constructor injection.\n   * Key is derived from the container map based on the Class.\n   * @param type The class to register.\n   * @param params The constructor arguments.\n   * @example\n   * .addSingletonClass(UserService, \"admin\", \"password\")\n   */\n  addSingletonClass<C extends Class>(\n    type: C,\n    ...params: ClassArgs<C, keyof T & (string | symbol)>\n  ): this {\n    const { key, type: typeRef } = this.resolveKeyAndType(type as any);\n    const uid = getStableKey(typeRef);\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'singleton', uid, type: typeRef, params };\n    this.definitions[key] = def;\n    this.definitions[uid] = def;\n    return this;\n  }\n\n  /**\n   * Adds a scoped service using constructor injection.\n   * Key is derived from the container map based on the Class.\n   * @param type The class to register.\n   * @param params The constructor arguments.\n   * @example\n   * .addScopedClass(UserService, \"admin\", \"password\")\n   */\n  addScopedClass<C extends Class>(\n    type: C,\n    ...params: ClassArgs<C, keyof T & (string | symbol)>\n  ): this {\n    const { key, type: typeRef } = this.resolveKeyAndType(type as any);\n    const uid = getStableKey(typeRef);\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'scoped', uid, type: typeRef, params };\n    this.definitions[key] = def;\n    this.definitions[uid] = def;\n    return this;\n  }\n\n  /**\n   * Adds an array of singleton services.\n   * Automatically registers individual classes if not already registered.\n   * @param key The key for the service array.\n   * @param types The classes to register in the array.\n   * @example\n   * .addSingletonArray(\"MessageCommand\", HelloCommand, ByeCommand)\n   */\n  addSingletonArray<\n    Key extends FilterKeys<T, any[]>,\n    C extends (new (...args: any[]) => MapToInstance<T[Key]>[number])[]\n  >(\n    key: Key,\n    ...types: C\n  ): this {\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'singleton', uid: key, type: types };\n    (this.typeMap as any)[key] = types;\n    this.definitions[key] = def;\n\n    // Auto-register individual classes if not already registered\n    const typeArray = types as Class[];\n    for (const type of typeArray) {\n      const foundKey = Reflect.ownKeys(this.typeMap).find(k => this.typeMap[k as any] === type);\n      if (foundKey) continue;\n\n      const name = type.name;\n      if (!name) {\n        throw new RegistrationError(`Class in array \"${String(key)}\" is missing a name and cannot be auto-registered.`);\n      }\n\n      const uid = getStableKey(type);\n      const classDef: ServiceDefinition<any> = { kind: 'service', lifetime: 'singleton', uid, type, params: [] };\n      (this.typeMap as any)[name] = type;\n      this.definitions[name] = classDef;\n      this.definitions[uid] = classDef;\n    }\n\n    return this;\n  }\n\n  /**\n   * Adds an array of scoped services.\n   * Automatically registers individual classes as scoped if not already registered.\n   * @param key The key for the service array.\n   * @param types The classes to register in the array.\n   * @example\n   * .addScopedArray(\"MessageCommand\", HelloCommand, ByeCommand)\n   */\n  addScopedArray<\n    Key extends FilterKeys<T, any[]>,\n    C extends (new (...args: any[]) => MapToInstance<T[Key]>[number])[]\n  >(\n    key: Key,\n    ...types: C\n  ): this {\n    const def: ServiceDefinition<any> = { kind: 'service', lifetime: 'scoped', uid: key, type: types };\n    (this.typeMap as any)[key] = types;\n    this.definitions[key] = def;\n\n    // Auto-register individual classes if not already registered\n    const typeArray = types as Class[];\n    for (const type of typeArray) {\n      const foundKey = Reflect.ownKeys(this.typeMap).find(k => this.typeMap[k as any] === type);\n      if (foundKey) continue;\n\n      const name = type.name;\n      if (!name) {\n        throw new RegistrationError(`Class in array \"${String(key)}\" is missing a name and cannot be auto-registered.`);\n      }\n\n      const uid = getStableKey(type);\n      const classDef: ServiceDefinition<any> = { kind: 'service', lifetime: 'scoped', uid, type, params: [] };\n      (this.typeMap as any)[name] = type;\n      this.definitions[name] = classDef;\n      this.definitions[uid] = classDef;\n    }\n\n    return this;\n  }\n\n  /**\n   * Adds a singleton service using a function.\n   * @param key The key for the service.\n   * @param func The function to register.\n   * @param params The function arguments.\n   * @example\n   * .addSingletonFunc(\"Logger\", createLogger, \"Config\")\n   */\n  addSingletonFunc<Key extends FilterFuncKeys<T>, F extends (...args: any[]) => T[Key]>(\n    key: Key,\n    func: F,\n    ...params: FuncArgs<F, T>\n  ): this {\n    this.definitions[key] = { kind: 'function', lifetime: 'singleton', uid: key, func, params };\n    return this;\n  }\n\n  /**\n   * Adds a scoped service using a function.\n   * @param key The key for the service.\n   * @param func The function to register.\n   * @param params The function arguments.\n   * @example\n   * .addScopedFunc(\"Logger\", createLogger, \"Config\")\n   */\n  addScopedFunc<Key extends FilterFuncKeys<T>, F extends (...args: any[]) => T[Key]>(\n    key: Key,\n    func: F,\n    ...params: FuncArgs<F, T>\n  ): this {\n    this.definitions[key] = { kind: 'function', lifetime: 'scoped', uid: key, func, params };\n    return this;\n  }\n\n  /**\n   * Adds a singleton value.\n   * @param key The key for the value.\n   * @param value The value to register.\n   * @example\n   * .addSingletonValue(\"connectionString\", \"test connection string\")\n   */\n  addSingletonValue<Key extends FilterValueKeys<T>>(\n    key: Key,\n    value: T[Key]\n  ): this {\n    this.definitions[key] = { kind: 'value', lifetime: 'singleton', uid: key, value };\n    return this;\n  }\n\n  /**\n   * Adds a scoped value.\n   * @param key The key for the value.\n   * @param value The value to register.\n   * @example\n   * .addScopedValue(\"connectionString\", \"test connection string\")\n   */\n  addScopedValue<Key extends FilterValueKeys<T>>(\n    key: Key,\n    value: T[Key]\n  ): this {\n    this.definitions[key] = { kind: 'value', lifetime: 'scoped', uid: key, value };\n    return this;\n  }\n\n  /**\n   * Resolves the string key and Class reference for a given type.\n   * If the type is already mapped in the TypeMap, the existing key is used.\n   * Otherwise, it auto-registers the type using its class name as the key.\n   * @param type The class reference to resolve.\n   * @throws RegistrationError if the class name cannot be determined (e.g. anonymous class).\n   * @example\n   * const { key, type } = this.resolveKeyAndType(UserService);\n   */\n  private resolveKeyAndType<Key extends keyof T & (string | symbol)>(type: T[Key] & Class): { key: Key, type: T[Key] } {\n    let key: Key;\n\n    const foundKey = Reflect.ownKeys(this.typeMap).find(\n      (k) => this.typeMap[k as any] === type\n    );\n    if (foundKey) {\n      key = foundKey as Key;\n    } else {\n      // Auto-register using class name for backward compatibility\n      key = (type.name || getStableKey(type)) as any as Key;\n      (this.typeMap as any)[key] = type;\n    }\n\n    return { key, type };\n  }\n\n  /**\n   * Builds the ServiceProvider.\n   * @param name The name of the service provider.\n   * @example\n   * const di = new ServiceCollection<LocalMap>()\n   *   .addSingletonClass(MyService)\n   *   .build();\n   */\n  build(name: string = 'root'): ServiceProvider<T> {\n    // Validate all registered services\n    for (const key of Reflect.ownKeys(this.definitions)) {\n      const item = this.definitions[key as any];\n      if (item.kind !== 'service' || !Array.isArray(item.type)) continue;\n\n      // This is an array of services\n      for (const type of item.type as Class[]) {\n        const name = type.name;\n        const definitionsItem = this.definitions[name];\n\n        // Check if this class was auto-registered (params is empty array) but requires arguments\n        if (definitionsItem && definitionsItem.params && definitionsItem.params.length === 0 && type.length > 0) {\n          throw new RegistrationError(`Class \"${name}\" in array \"${String(key)}\" requires constructor arguments and must be registered independently using addSingletonClass or addScopedClass.`);\n        }\n      }\n    }\n\n    return new ServiceProvider<T>(name, this.definitions);\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["index_exports", "__export", "AsyncDisposalError", "CircularDependencyError", "RegistrationError", "ServiceCollection", "ServiceNotFoundError", "ServiceProvider", "ServiceProviderDisposedError", "__toCommonJS", "CircularDependencyError", "path", "ServiceNotFoundError", "identifier", "RegistrationError", "message", "ServiceProviderDisposedError", "AsyncDisposalError", "serviceKey", "classKeyRegistry", "getStableKey", "type", "key", "ServiceProvider", "_ServiceProvider", "name", "definitions", "parent", "isAsyncScope", "root", "keyOrType", "ServiceProviderDisposedError", "key", "item", "ServiceNotFoundError", "uid", "pathStr", "k", "CircularDependencyError", "AsyncDisposalError", "entries", "inst", "result", "value", "types", "instances", "cls", "factory", "container", "func", "params", "resolvedParams", "param", "paramKey", "type", "instance", "_", "prop", "c", "entry", "v", "stableKey", "getStableKey", "ServiceCollection", "keyOrType", "factory", "key", "type", "isExplicitKey", "resolved", "uid", "getStableKey", "def", "_", "sp", "params", "typeRef", "types", "typeArray", "k", "name", "RegistrationError", "classDef", "func", "value", "foundKey", "item", "definitionsItem", "ServiceProvider"]
+}

package/dist/types/src/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Thrown when a circular dependency is detected.
+ */
+export declare class CircularDependencyError extends Error {
+    constructor(path: string);
+}
+/**
+ * Thrown when a service cannot be resolved.
+ */
+export declare class ServiceNotFoundError extends Error {
+    constructor(identifier: string);
+}
+/**
+ * Thrown when a registration is invalid.
+ */
+export declare class RegistrationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when a service provider has been disposed.
+ */
+export declare class ServiceProviderDisposedError extends Error {
+    constructor();
+}
+/**
+ * Thrown when a synchronous dispose is called on a scope containing services that require asynchronous disposal.
+ */
+export declare class AsyncDisposalError extends Error {
+    constructor(serviceKey: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,IAAI,EAAE,MAAM;CAIzB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,UAAU,EAAE,MAAM;CAI/B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;;CAKtD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,UAAU,EAAE,MAAM;CAI/B"}

package/dist/types/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from './errors.js';
+export * from './service-collection.js';
+export * from './service-provider.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/types/src/registry.d.ts

@@ -0,0 +1,8 @@
+import type { Class } from './types.js';
+/**
+ * Resolves a stable Symbol for a given class constructor.
+ * This is used to ensure that DI resolution remains stable even after minification.
+ * @param type The class constructor.
+ */
+export declare function getStableKey(type: Class): symbol;
+//# sourceMappingURL=registry.d.ts.map

package/dist/types/src/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAOhD"}

package/dist/types/src/service-collection.d.ts

@@ -0,0 +1,145 @@
+import { ServiceProvider } from './service-provider.js';
+import type { Class, ClassArgs, FilterKeys, FilterValueKeys, FilterFuncKeys, FuncArgs, ImplementationFactory, MapToInstance, TypeMap } from './types.js';
+/**
+ * Fluent builder for service collections using a lookup map.
+ */
+export declare class ServiceCollection<T extends TypeMap> {
+    private definitions;
+    private typeMap;
+    /**
+     * Initializes a new instance of the ServiceCollection class.
+     */
+    constructor();
+    /**
+     * Adds a singleton service using a factory function.
+     * Key is derived from the class.
+     * @param type The class to register.
+     * @param factory The factory function to create the service instance.
+     * @example
+     * .addSingletonFactory(UserRepo, (c) => new UserRepo(c.UserService))
+     */
+    addSingletonFactory<Key extends keyof T & (string | symbol), C extends Class>(type: C, factory: ImplementationFactory<T, InstanceType<C>>): this;
+    /**
+     * Adds a singleton service using a factory function and a key.
+     * @param key The key to register the service under.
+     * @param factory The factory function to create the service instance.
+     * @example
+     * .addSingletonFactory("UserRepo", (c) => new UserRepo(c.UserService))
+     */
+    addSingletonFactory<Key extends keyof T & (string | symbol)>(key: Key, factory: ImplementationFactory<T, MapToInstance<T[Key]>>): this;
+    /**
+     * Registers the ServiceProvider itself as a service.
+     * This allows services to depend on the ServiceProvider to resolve other services dynamically.
+     * @param key The key to register the ServiceProvider under.
+     * @example
+     * .addServiceProvider("ServiceProvider")
+     */
+    addServiceProvider<Key extends keyof T & (string | symbol)>(key: Key): this;
+    /**
+     * Adds a scoped service using a factory function.
+     * Key is derived from the class.
+     * @param type The class to register.
+     * @param factory The factory function to create the service instance.
+     * @example
+     * .addScopedFactory(UserRepo, (c) => new UserRepo(c.UserService))
+     */
+    addScopedFactory<Key extends keyof T & (string | symbol), C extends Class>(type: C, factory: ImplementationFactory<T, InstanceType<C>>): this;
+    /**
+     * Adds a scoped service using a factory function and a key.
+     * @param key The key to register the service under.
+     * @param factory The factory function to create the service instance.
+     * @example
+     * .addScopedFactory("UserRepo", (c) => new UserRepo(c.UserService))
+     */
+    addScopedFactory<Key extends keyof T & (string | symbol)>(key: Key, factory: ImplementationFactory<T, MapToInstance<T[Key]>>): this;
+    /**
+     * Adds a singleton service using constructor injection.
+     * Key is derived from the container map based on the Class.
+     * @param type The class to register.
+     * @param params The constructor arguments.
+     * @example
+     * .addSingletonClass(UserService, "admin", "password")
+     */
+    addSingletonClass<C extends Class>(type: C, ...params: ClassArgs<C, keyof T & (string | symbol)>): this;
+    /**
+     * Adds a scoped service using constructor injection.
+     * Key is derived from the container map based on the Class.
+     * @param type The class to register.
+     * @param params The constructor arguments.
+     * @example
+     * .addScopedClass(UserService, "admin", "password")
+     */
+    addScopedClass<C extends Class>(type: C, ...params: ClassArgs<C, keyof T & (string | symbol)>): this;
+    /**
+     * Adds an array of singleton services.
+     * Automatically registers individual classes if not already registered.
+     * @param key The key for the service array.
+     * @param types The classes to register in the array.
+     * @example
+     * .addSingletonArray("MessageCommand", HelloCommand, ByeCommand)
+     */
+    addSingletonArray<Key extends FilterKeys<T, any[]>, C extends (new (...args: any[]) => MapToInstance<T[Key]>[number])[]>(key: Key, ...types: C): this;
+    /**
+     * Adds an array of scoped services.
+     * Automatically registers individual classes as scoped if not already registered.
+     * @param key The key for the service array.
+     * @param types The classes to register in the array.
+     * @example
+     * .addScopedArray("MessageCommand", HelloCommand, ByeCommand)
+     */
+    addScopedArray<Key extends FilterKeys<T, any[]>, C extends (new (...args: any[]) => MapToInstance<T[Key]>[number])[]>(key: Key, ...types: C): this;
+    /**
+     * Adds a singleton service using a function.
+     * @param key The key for the service.
+     * @param func The function to register.
+     * @param params The function arguments.
+     * @example
+     * .addSingletonFunc("Logger", createLogger, "Config")
+     */
+    addSingletonFunc<Key extends FilterFuncKeys<T>, F extends (...args: any[]) => T[Key]>(key: Key, func: F, ...params: FuncArgs<F, T>): this;
+    /**
+     * Adds a scoped service using a function.
+     * @param key The key for the service.
+     * @param func The function to register.
+     * @param params The function arguments.
+     * @example
+     * .addScopedFunc("Logger", createLogger, "Config")
+     */
+    addScopedFunc<Key extends FilterFuncKeys<T>, F extends (...args: any[]) => T[Key]>(key: Key, func: F, ...params: FuncArgs<F, T>): this;
+    /**
+     * Adds a singleton value.
+     * @param key The key for the value.
+     * @param value The value to register.
+     * @example
+     * .addSingletonValue("connectionString", "test connection string")
+     */
+    addSingletonValue<Key extends FilterValueKeys<T>>(key: Key, value: T[Key]): this;
+    /**
+     * Adds a scoped value.
+     * @param key The key for the value.
+     * @param value The value to register.
+     * @example
+     * .addScopedValue("connectionString", "test connection string")
+     */
+    addScopedValue<Key extends FilterValueKeys<T>>(key: Key, value: T[Key]): this;
+    /**
+     * Resolves the string key and Class reference for a given type.
+     * If the type is already mapped in the TypeMap, the existing key is used.
+     * Otherwise, it auto-registers the type using its class name as the key.
+     * @param type The class reference to resolve.
+     * @throws RegistrationError if the class name cannot be determined (e.g. anonymous class).
+     * @example
+     * const { key, type } = this.resolveKeyAndType(UserService);
+     */
+    private resolveKeyAndType;
+    /**
+     * Builds the ServiceProvider.
+     * @param name The name of the service provider.
+     * @example
+     * const di = new ServiceCollection<LocalMap>()
+     *   .addSingletonClass(MyService)
+     *   .build();
+     */
+    build(name?: string): ServiceProvider<T>;
+}
+//# sourceMappingURL=service-collection.d.ts.map

package/dist/types/src/service-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-collection.d.ts","sourceRoot":"","sources":["../../../src/service-collection.ts"],"names":[],"mappings":"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"}