@noego/ioc 0.0.11 → 0.2.0

package/dist/framework/decorators/Provider.cjs

@@ -0,0 +1,40 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Provider_exports = {};
+__export(Provider_exports, {
+  Provider: () => Provider
+});
+module.exports = __toCommonJS(Provider_exports);
+var import_reflect_metadata = require("reflect-metadata");
+var import_metadataKeys = require("./metadataKeys.cjs");
+var import_LoadAs = require("../implementation/LoadAs.cjs");
+function Provider(options = {}) {
+  return (target) => {
+    const finalOptions = {
+      scope: options.scope ?? import_LoadAs.LoadAs.Scoped
+    };
+    Reflect.defineMetadata(import_metadataKeys.COMPONENT_OPTIONS_METADATA_KEY, finalOptions, target);
+    Reflect.defineMetadata("ComponentOptions", finalOptions, target);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Provider
+});
+//# sourceMappingURL=Provider.cjs.map

package/dist/framework/decorators/Provider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../framework/decorators/Provider.ts"],"sourcesContent":["// framework/decorators/Provider.ts\nimport 'reflect-metadata';\nimport { COMPONENT_OPTIONS_METADATA_KEY } from './metadataKeys.cjs';\nimport { LoadAs } from '../implementation/LoadAs.cjs';\nimport { ComponentOptions } from './Component.cjs';\n\n/**\n * Marks a class as a provider managed by the IOC container.\n * Providers are scoped by default, making them ideal for the provider pattern\n * where instances should be scoped to a particular container context.\n *\n * This is equivalent to @Component({ scope: LoadAs.Scoped })\n *\n * @param options Configuration options. Defaults to Scoped lifetime.\n *\n * @example\n * ```typescript\n * import { Provider, SCOPED_CONTAINER, IContainer } from '@noego/ioc';\n *\n * @Provider()\n * class ServiceFactory {\n *   constructor(@Inject(SCOPED_CONTAINER) private container: IContainer) {}\n *\n *   async createService(name: string) {\n *     return this.container.instance(MyService);\n *   }\n * }\n * ```\n */\nexport function Provider(options: ComponentOptions = {}): ClassDecorator {\n    return (target: Function) => {\n        // Default to Scoped for providers\n        const finalOptions: Required<ComponentOptions> = {\n            scope: options.scope ?? LoadAs.Scoped,\n        };\n\n        // Define metadata on the class constructor\n        Reflect.defineMetadata(COMPONENT_OPTIONS_METADATA_KEY, finalOptions, target);\n\n        // Also define with string key for easier debugging\n        Reflect.defineMetadata('ComponentOptions', finalOptions, target);\n    };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,8BAAO;AACP,0BAA+C;AAC/C,oBAAuB;AA0BhB,SAAS,SAAS,UAA4B,CAAC,GAAmB;AACrE,SAAO,CAAC,WAAqB;AAEzB,UAAM,eAA2C;AAAA,MAC7C,OAAO,QAAQ,SAAS,qBAAO;AAAA,IACnC;AAGA,YAAQ,eAAe,oDAAgC,cAAc,MAAM;AAG3E,YAAQ,eAAe,oBAAoB,cAAc,MAAM;AAAA,EACnE;AACJ;","names":[]}

package/dist/framework/decorators/Provider.d.cts

@@ -0,0 +1,29 @@
+import { ComponentOptions } from './Component.cjs';
+import '../implementation/LoadAs.cjs';
+
+/**
+ * Marks a class as a provider managed by the IOC container.
+ * Providers are scoped by default, making them ideal for the provider pattern
+ * where instances should be scoped to a particular container context.
+ *
+ * This is equivalent to @Component({ scope: LoadAs.Scoped })
+ *
+ * @param options Configuration options. Defaults to Scoped lifetime.
+ *
+ * @example
+ * ```typescript
+ * import { Provider, SCOPED_CONTAINER, IContainer } from '@noego/ioc';
+ *
+ * @Provider()
+ * class ServiceFactory {
+ *   constructor(@Inject(SCOPED_CONTAINER) private container: IContainer) {}
+ *
+ *   async createService(name: string) {
+ *     return this.container.instance(MyService);
+ *   }
+ * }
+ * ```
+ */
+declare function Provider(options?: ComponentOptions): ClassDecorator;
+
+export { Provider };

package/dist/framework/decorators/Provider.d.ts

@@ -0,0 +1,29 @@
+import { ComponentOptions } from './Component.js';
+import '../implementation/LoadAs.js';
+
+/**
+ * Marks a class as a provider managed by the IOC container.
+ * Providers are scoped by default, making them ideal for the provider pattern
+ * where instances should be scoped to a particular container context.
+ *
+ * This is equivalent to @Component({ scope: LoadAs.Scoped })
+ *
+ * @param options Configuration options. Defaults to Scoped lifetime.
+ *
+ * @example
+ * ```typescript
+ * import { Provider, SCOPED_CONTAINER, IContainer } from '@noego/ioc';
+ *
+ * @Provider()
+ * class ServiceFactory {
+ *   constructor(@Inject(SCOPED_CONTAINER) private container: IContainer) {}
+ *
+ *   async createService(name: string) {
+ *     return this.container.instance(MyService);
+ *   }
+ * }
+ * ```
+ */
+declare function Provider(options?: ComponentOptions): ClassDecorator;
+
+export { Provider };

package/dist/framework/decorators/Provider.js

@@ -0,0 +1,16 @@
+import "reflect-metadata";
+import { COMPONENT_OPTIONS_METADATA_KEY } from "./metadataKeys.js";
+import { LoadAs } from "../implementation/LoadAs.js";
+function Provider(options = {}) {
+  return (target) => {
+    const finalOptions = {
+      scope: options.scope ?? LoadAs.Scoped
+    };
+    Reflect.defineMetadata(COMPONENT_OPTIONS_METADATA_KEY, finalOptions, target);
+    Reflect.defineMetadata("ComponentOptions", finalOptions, target);
+  };
+}
+export {
+  Provider
+};
+//# sourceMappingURL=Provider.js.map

package/dist/framework/decorators/Provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../framework/decorators/Provider.ts"],"sourcesContent":["// framework/decorators/Provider.ts\nimport 'reflect-metadata';\nimport { COMPONENT_OPTIONS_METADATA_KEY } from './metadataKeys.js';\nimport { LoadAs } from '../implementation/LoadAs.js';\nimport { ComponentOptions } from './Component.js';\n\n/**\n * Marks a class as a provider managed by the IOC container.\n * Providers are scoped by default, making them ideal for the provider pattern\n * where instances should be scoped to a particular container context.\n *\n * This is equivalent to @Component({ scope: LoadAs.Scoped })\n *\n * @param options Configuration options. Defaults to Scoped lifetime.\n *\n * @example\n * ```typescript\n * import { Provider, SCOPED_CONTAINER, IContainer } from '@noego/ioc';\n *\n * @Provider()\n * class ServiceFactory {\n *   constructor(@Inject(SCOPED_CONTAINER) private container: IContainer) {}\n *\n *   async createService(name: string) {\n *     return this.container.instance(MyService);\n *   }\n * }\n * ```\n */\nexport function Provider(options: ComponentOptions = {}): ClassDecorator {\n    return (target: Function) => {\n        // Default to Scoped for providers\n        const finalOptions: Required<ComponentOptions> = {\n            scope: options.scope ?? LoadAs.Scoped,\n        };\n\n        // Define metadata on the class constructor\n        Reflect.defineMetadata(COMPONENT_OPTIONS_METADATA_KEY, finalOptions, target);\n\n        // Also define with string key for easier debugging\n        Reflect.defineMetadata('ComponentOptions', finalOptions, target);\n    };\n}\n"],"mappings":"AACA,OAAO;AACP,SAAS,sCAAsC;AAC/C,SAAS,cAAc;AA0BhB,SAAS,SAAS,UAA4B,CAAC,GAAmB;AACrE,SAAO,CAAC,WAAqB;AAEzB,UAAM,eAA2C;AAAA,MAC7C,OAAO,QAAQ,SAAS,OAAO;AAAA,IACnC;AAGA,YAAQ,eAAe,gCAAgC,cAAc,MAAM;AAG3E,YAAQ,eAAe,oBAAoB,cAAc,MAAM;AAAA,EACnE;AACJ;","names":[]}

package/dist/framework/decorators/index.cjs

@@ -20,16 +20,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var decorators_exports = {};
 __export(decorators_exports, {
   Component: () => import_Component.Component,
-  Inject: () => import_Inject.Inject
+  Inject: () => import_Inject.Inject,
+  Provider: () => import_Provider.Provider
 });
 module.exports = __toCommonJS(decorators_exports);
 var import_Component = require("./Component.cjs");
+var import_Provider = require("./Provider.cjs");
 var import_Inject = require("./Inject.cjs");
 __reExport(decorators_exports, require("./metadataKeys.cjs"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Component,
   Inject,
+  Provider,
   ...require("./metadataKeys.cjs")
 });
 //# sourceMappingURL=index.cjs.map

package/dist/framework/decorators/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../framework/decorators/index.ts"],"sourcesContent":["// Export decorators\nexport { Component } from './Component.cjs';\nexport { Inject } from './Inject.cjs';\nexport * from './metadataKeys.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,uBAA0B;AAC1B,oBAAuB;AACvB,+BAAc,+BAHd;","names":[]}
+{"version":3,"sources":["../../../framework/decorators/index.ts"],"sourcesContent":["// Export decorators\nexport { Component } from './Component.cjs';\nexport { Provider } from './Provider.cjs';\nexport { Inject } from './Inject.cjs';\nexport * from './metadataKeys.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,uBAA0B;AAC1B,sBAAyB;AACzB,oBAAuB;AACvB,+BAAc,+BAJd;","names":[]}

package/dist/framework/decorators/index.d.cts

@@ -1,4 +1,5 @@
 export { Component } from './Component.cjs';
+export { Provider } from './Provider.cjs';
 export { Inject } from './Inject.cjs';
 export { COMPONENT_OPTIONS_METADATA_KEY, INJECT_TOKEN_METADATA_KEY, PARAM_TYPES_METADATA_KEY } from './metadataKeys.cjs';
 import '../implementation/LoadAs.cjs';

package/dist/framework/decorators/index.d.ts

@@ -1,4 +1,5 @@
 export { Component } from './Component.js';
+export { Provider } from './Provider.js';
 export { Inject } from './Inject.js';
 export { COMPONENT_OPTIONS_METADATA_KEY, INJECT_TOKEN_METADATA_KEY, PARAM_TYPES_METADATA_KEY } from './metadataKeys.js';
 import '../implementation/LoadAs.js';

package/dist/framework/decorators/index.js

@@ -1,8 +1,10 @@
 import { Component } from "./Component.js";
+import { Provider } from "./Provider.js";
 import { Inject } from "./Inject.js";
 export * from "./metadataKeys.js";
 export {
   Component,
-  Inject
+  Inject,
+  Provider
 };
 //# sourceMappingURL=index.js.map

package/dist/framework/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../framework/decorators/index.ts"],"sourcesContent":["// Export decorators\nexport { Component } from './Component.js';\nexport { Inject } from './Inject.js';\nexport * from './metadataKeys.js';\n"],"mappings":"AACA,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AACvB,cAAc;","names":[]}
+{"version":3,"sources":["../../../framework/decorators/index.ts"],"sourcesContent":["// Export decorators\nexport { Component } from './Component.js';\nexport { Provider } from './Provider.js';\nexport { Inject } from './Inject.js';\nexport * from './metadataKeys.js';\n"],"mappings":"AACA,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,cAAc;AACvB,cAAc;","names":[]}

package/dist/framework/implementation/Container.cjs

@@ -29,6 +29,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var Container_exports = {};
 __export(Container_exports, {
   Container: () => Container,
+  SCOPED_CONTAINER: () => SCOPED_CONTAINER,
   createContainer: () => createContainer,
   isPromise: () => isPromise
 });
@@ -41,6 +42,7 @@ var import_DecoratorSupport = require("./DecoratorSupport.cjs");
 var import_ProxyFactory = require("./ProxyFactory.cjs");
 var TraceLoggerModule = __toESM(require("./TraceLogger.cjs"), 1);
 var import_TraceCleanup = require("./TraceCleanup.cjs");
+const SCOPED_CONTAINER = Symbol.for("ioc:scoped-container");
 var ContainerRouting = /* @__PURE__ */ ((ContainerRouting2) => {
   ContainerRouting2["FUNCTIONAL"] = "FUNCTIONAL";
   ContainerRouting2["CLASS"] = "CLASS";
@@ -220,8 +222,8 @@ class Container {
       return "transient";
     }
   }
-  // Central resolution logic
-  async loadInstance(label, params = [], resolutionChain = [], parentProxyId) {
+  // Central resolution logic - sync-first, returns T or Promise<T>
+  loadInstance(label, params = [], resolutionChain = [], parentProxyId) {
     const currentLabelStr = typeof label === "function" && label.name ? label.name : String(label);
     if (resolutionChain.includes(currentLabelStr)) {
       console.error(`[IOC LoadInstance] Circular dependency detected: ${[...resolutionChain, currentLabelStr].join(" -> ")}`);
@@ -230,11 +232,14 @@ class Container {
     const nextResolutionChain = [...resolutionChain, currentLabelStr];
     if (label instanceof import_Parameter.Parameter) {
       try {
-        return Promise.resolve(this.resolveParameterValue(label, [...params]));
+        return this.resolveParameterValue(label, [...params]);
       } catch (e) {
-        return Promise.reject(e);
+        throw e;
       }
     }
+    if (label === SCOPED_CONTAINER) {
+      return this;
+    }
     if (this.isRegisteredAsClass(label)) {
       return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);
     }
@@ -279,58 +284,52 @@ class Container {
       futureProxyId = (0, import_ProxyFactory.reserveProxyId)();
     }
     const paramsCopy = [...params];
-    const resolutionPromises = dependenciesToResolve.map(
-      (dependencyIdentifier) => this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain, futureProxyId)
-      // Recursive call handles auto-registration
-    );
-    let finalInstance = Promise.all(resolutionPromises).catch((error) => {
+    const resolvedDependencies = [];
+    let hasAsyncDependency = false;
+    for (const dependencyIdentifier of dependenciesToResolve) {
+      const resolved = this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain, futureProxyId);
+      resolvedDependencies.push(resolved);
+      if (isPromise(resolved)) {
+        hasAsyncDependency = true;
+      }
+    }
+    const instantiate = (deps) => {
+      try {
+        const instance = new classDefinition(...deps);
+        if (this._enableTracing && futureProxyId !== void 0) {
+          return (0, import_ProxyFactory.wrapWithProxy)(instance, className, parentProxyId, futureProxyId);
+        }
+        return instance;
+      } catch (err) {
+        console.error(`[IOC LoadClass] Error during instantiation of ${className}: ${err.message}`, err.stack);
+        throw err;
+      }
+    };
+    if (!hasAsyncDependency) {
+      const instance = instantiate(resolvedDependencies);
+      if (storageType && storageType !== "transient") {
+        this.setInstance(classDefinition, instance, storageType);
+      }
+      return instance;
+    }
+    const asyncInstance = Promise.all(resolvedDependencies).then((deps) => {
+      const instance = instantiate(deps);
+      if (storageType && storageType !== "transient") {
+        this.setInstance(classDefinition, instance, storageType);
+      }
+      return instance;
+    }).catch((error) => {
       console.error(`[IOC LoadClass] Failed to resolve one or more dependencies for ${className}:`, error);
       if (storageType && this.isRegisteredAsClass(classDefinition)) {
         if (storageType === "singleton") this._classStorageSingleton.delete(classDefinition);
         if (storageType === "scoped") this._classStorageScoped.delete(classDefinition);
       }
       throw error;
-    }).then(async (resolvedDependencies) => {
-      let instancePromise;
-      if (storageType && !this.hasInstance(classDefinition)) {
-        instancePromise = (async () => {
-          try {
-            const instance = new classDefinition(...resolvedDependencies);
-            let wrappedInstance = instance;
-            if (this._enableTracing && futureProxyId !== void 0) {
-              wrappedInstance = (0, import_ProxyFactory.wrapWithProxy)(instance, className, parentProxyId, futureProxyId);
-            }
-            this.setInstance(classDefinition, wrappedInstance, storageType);
-            return wrappedInstance;
-          } catch (err) {
-            console.error(`[IOC LoadClass] Error during instantiation of ${className}: ${err.message}`, err.stack);
-            if (storageType === "singleton") this._classStorageSingleton.delete(classDefinition);
-            if (storageType === "scoped") this._classStorageScoped.delete(classDefinition);
-            throw err;
-          }
-        })();
-        this.setInstance(classDefinition, instancePromise, storageType);
-      } else {
-        instancePromise = (async () => {
-          try {
-            const instance = new classDefinition(...resolvedDependencies);
-            let wrappedInstance = instance;
-            if (this._enableTracing && futureProxyId !== void 0) {
-              wrappedInstance = (0, import_ProxyFactory.wrapWithProxy)(instance, className, parentProxyId, futureProxyId);
-            }
-            return wrappedInstance;
-          } catch (err) {
-            console.error(`[IOC LoadClass] Error during instantiation of transient ${className}: ${err.message}`, err.stack);
-            throw err;
-          }
-        })();
-      }
-      return await instancePromise;
     });
     if (storageType && storageType !== "transient") {
-      this.setInstance(classDefinition, finalInstance, storageType);
+      this.setInstance(classDefinition, asyncInstance, storageType);
     }
-    return finalInstance;
+    return asyncInstance;
   }
   loadFunctionInstance(funcLabel, params, resolutionChain) {
     const functionConfig = this._functionDefinition.get(funcLabel);
@@ -398,6 +397,7 @@ function createContainer() {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Container,
+  SCOPED_CONTAINER,
   createContainer,
   isPromise
 });

package/dist/framework/implementation/Container.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../framework/implementation/Container.ts"],"sourcesContent":["import 'reflect-metadata'; // Ensure polyfill is loaded conceptually\nimport type { ContainerOptions, IContainerClient, IContainerFunctionDefinition, IContainerSetup } from \"../interface/Container.cjs\";\nimport { LoadAs } from \"./LoadAs.cjs\";\nimport { Parameter } from \"./Parameter.cjs\";\nimport type { ParameterValue } from \"./Parameter.cjs\";\nimport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError } from \"../errors/ContainerErrors.cjs\";\nimport {\n    getScope,\n    getComponentOptions, // Use helper\n    getResolvedDependencies // Use helper\n} from './DecoratorSupport'; // Assume helpers exist or create them\nimport { wrapWithProxy, setTraceLogger, reserveProxyId } from \"./ProxyFactory.cjs\";\nimport * as TraceLoggerModule from \"./TraceLogger.cjs\";\nimport { TraceCleanup } from \"./TraceCleanup.cjs\";\n\nenum ContainerRouting {\n    FUNCTIONAL = \"FUNCTIONAL\",\n    CLASS = \"CLASS\"\n    // No need for COMPONENT route, just check metadata if CLASS/FUNCTIONAL fails\n}\n\ntype StorageType = 'singleton' | 'scoped' | 'transient';\n\nexport class Container implements IContainerClient, IContainerSetup {\n    // Routing and definition maps\n    private _routing: Map<any, ContainerRouting> = new Map();\n    private _functionDefinition: Map<any, IContainerFunctionDefinition> = new Map();\n    private _classDefinition: Map<Function, Partial<ContainerOptions>> = new Map();\n\n    // Storage maps\n    private _functionStorageSingleton: Map<any, any> = new Map();\n    private _functionStorageScoped: Map<any, any> = new Map();\n    private _classStorageSingleton: Map<Function, any> = new Map();\n    private _classStorageScoped: Map<Function, any> = new Map();\n\n    // Tracing configuration\n    private _enableTracing: boolean = false;\n    private _traceRetentionMinutes: number = 5;\n\n    // Registration methods\n    registerClass<T>(classDefinition: new (...args: any[]) => T, options?: Partial<ContainerOptions>): void {\n        // Basic validation\n        if (typeof classDefinition !== 'function' || !classDefinition.prototype) {\n             console.warn(`[IOC] Attempted to register non-class: ${String(classDefinition)}`);\n             // Optional: throw error instead?\n             // throw new NotAClassDefinitionError(`Attempted to register non-class: ${String(classDefinition)}`);\n             return; // Don't proceed if not a class constructor\n        }\n\n        // Always clear previous definitions for this exact class constructor\n        this.clearDefinitions(classDefinition);\n\n        // Always set the routing type so 'isClassDefinition' works\n        this._routing.set(classDefinition, ContainerRouting.CLASS);\n\n        // Store manual options *only if they are actually provided and have content*\n        if (options && Object.keys(options).length > 0) {\n            this._classDefinition.set(classDefinition, options);\n            // console.log(`[IOC RegClass] Manually registered ${classDefinition.name} with options:`, options);\n        } else {\n            // console.log(`[IOC RegClass] Manually registered ${classDefinition.name} with no specific options (will use decorators if present).`);\n             // If no options are provided, we don't store anything in _classDefinition,\n             // effectively clearing any previous manual config and letting decorators take over if present.\n        }\n    }\n\n    registerFunction<T extends (...arg: any[]) => any>(label: any, func: T, options: Partial<ContainerOptions> = {} as any): void {\n        this.clearDefinitions(label);\n        this._routing.set(label, ContainerRouting.FUNCTIONAL);\n        this._functionDefinition.set(label, { function: func, options });\n        // console.log(`[IOC RegFunc] Registered function with label ${String(label)} and options:`, options);\n    }\n\n    // Instance resolution methods - Simplify to just call loadInstance\n    instance<T, Args extends any[]>(classDefinition: new (...args: Args) => T, params: ParameterValue<any>[] = []): Promise<T> {\n        // Basic check upfront\n        if (typeof classDefinition !== 'function' || !classDefinition.prototype) {\n             throw new NotAClassDefinitionError(`Cannot resolve instance for non-class: ${String(classDefinition)}`);\n        }\n        return this.loadInstance(classDefinition, params) as Promise<T>;\n    }\n\n    get<T>(label: any, param: ParameterValue<any>[] = []): Promise<T> | T {\n        // Just delegate to loadInstance, which handles routing and auto-registration\n        return this.loadInstance(label, param);\n    }\n\n    extend(): IContainerClient & IContainerSetup {\n        const childContainer = createContainer() as Container;\n\n        // Copy routing and definition maps (share the registration knowledge)\n        childContainer._routing = new Map(this._routing);\n        childContainer._functionDefinition = new Map(this._functionDefinition);\n        childContainer._classDefinition = new Map(this._classDefinition);\n\n        // Share singleton storage (singletons are shared across all containers)\n        childContainer._functionStorageSingleton = this._functionStorageSingleton;\n        childContainer._classStorageSingleton = this._classStorageSingleton;\n\n        // Do NOT share scoped storage (new container = new scope)\n        // Child gets its own empty scoped storage\n\n        // Share tracing configuration\n        childContainer._enableTracing = this._enableTracing;\n        childContainer._traceRetentionMinutes = this._traceRetentionMinutes;\n\n        // console.log('[IOC Extend] Created child container.');\n        return childContainer;\n    }\n\n    // Tracing API\n    setTracingEnabled(enabled: boolean): void {\n        this._enableTracing = enabled;\n        if (enabled && !TraceCleanup.isCleanupRunning()) {\n            // Set the trace logger for the ProxyFactory\n            setTraceLogger(TraceLoggerModule as any);\n            // Start automatic cleanup\n            TraceCleanup.start(this._traceRetentionMinutes);\n        }\n    }\n\n    isTracingEnabled(): boolean {\n        return this._enableTracing;\n    }\n\n    setTraceRetentionMinutes(minutes: number): void {\n        this._traceRetentionMinutes = Math.max(1, minutes);\n    }\n\n    getTraces(retentionMinutes?: number): any[] {\n        const retention = retentionMinutes ?? this._traceRetentionMinutes;\n        return TraceLoggerModule.getRecentTraces(retention);\n    }\n\n    getAllTraces(): any[] {\n        return TraceLoggerModule.getAllTraces();\n    }\n\n    clearTraces(): void {\n        TraceLoggerModule.clearAllTraces();\n    }\n\n    exportTraces(filepath: string): void {\n        const data = TraceLoggerModule.exportTracesToJson();\n        const fs = require('fs');\n        fs.writeFileSync(filepath, JSON.stringify(data, null, 2));\n    }\n\n    getTraceStatistics(): any {\n        return TraceLoggerModule.getTraceStatistics();\n    }\n\n    // Private helper methods\n    private clearDefinitions(label: any): void {\n        this._routing.delete(label);\n        this._functionDefinition.delete(label);\n        // Only delete from classDefinition if the label is actually a function constructor\n        if (typeof label === 'function') {\n            this._classDefinition.delete(label);\n        }\n    }\n\n    // Checks if the label is *currently* registered as a class\n    private isRegisteredAsClass(label: any): boolean {\n        return this._routing.get(label) === ContainerRouting.CLASS;\n    }\n\n     // Checks if the label is *currently* registered as a function\n     private isRegisteredAsFunction(label: any): boolean {\n         return this._routing.get(label) === ContainerRouting.FUNCTIONAL;\n     }\n\n\n    private hasInstance(label: any): boolean {\n        const storageType = this.getStorageType(label); // This checks decorators if needed\n\n        if (!storageType) {\n            // Transient instances are never stored\n            return false;\n        }\n\n        // Determine if it's treated as a class (registered or decorated) *after* getting type\n        const isClass = this.isClassType(label); // Use a helper that checks routing OR decorator\n\n        if (isClass) {\n            return storageType === 'singleton'\n                ? this._classStorageSingleton.has(label)\n                : this._classStorageScoped.has(label);\n        } else { // Must be a function if not a class\n            return storageType === 'singleton'\n                ? this._functionStorageSingleton.has(label)\n                : this._functionStorageScoped.has(label);\n        }\n    }\n\n     // Helper to determine if something should be treated as a class (registered or decorated)\n     private isClassType(label: any): boolean {\n         if (this.isRegisteredAsClass(label)) {\n             return true;\n         }\n         // If not explicitly registered as a class, check if it's a function with @Component\n         if (typeof label === 'function' && label.prototype && !this.isRegisteredAsFunction(label)) {\n              return getComponentOptions(label) !== null;\n         }\n         return false;\n     }\n\n    private getInstance(label: any): any {\n        const storageType = this.getStorageType(label); // Checks decorators if needed\n\n         if (!storageType) {\n             // This should ideally not be reached if called after hasInstance check\n             console.error(`[IOC GetInstance] Attempted to get instance for non-stored type: ${String(label)}`);\n             throw new InstanceNotCreatedError();\n         }\n\n        const isClass = this.isClassType(label); // Check routing OR decorator\n\n        if (isClass) {\n            return storageType === 'singleton'\n                ? this._classStorageSingleton.get(label)\n                : this._classStorageScoped.get(label);\n        } else { // Must be a function\n            return storageType === 'singleton'\n                ? this._functionStorageSingleton.get(label)\n                : this._functionStorageScoped.get(label);\n        }\n    }\n\n    private setInstance(label: any, instance: any, storageType?: StorageType): void { // Made storageType non-optional\n        const isClass = this.isClassType(label); // Determine type based on routing OR decorator\n\n        if (isClass) {\n            if (storageType === 'singleton') {\n                this._classStorageSingleton.set(label, instance);\n            } else if (storageType == 'scoped'){ // storageType === 'scoped'\n                this._classStorageScoped.set(label, instance);\n            }\n        } else { // Must be a function\n            if (storageType === 'singleton') {\n                this._functionStorageSingleton.set(label, instance);\n            } else if(storageType === \"scoped\"){ // storageType === 'scoped'\n                this._functionStorageScoped.set(label, instance);\n            }\n        }\n    }\n\n    private getStorageType(label: any): StorageType {\n        let manualLoadAs: LoadAs | undefined;\n        let decoratorScope: LoadAs | undefined;\n        const isPotentialClass = typeof label === 'function' && label.prototype;\n\n        // Get manual registration options if available\n        if (this.isRegisteredAsClass(label)) { // Use helper\n            manualLoadAs = this._classDefinition.get(label)?.loadAs;\n        } else if (this.isRegisteredAsFunction(label)) { // Use helper\n            manualLoadAs = this._functionDefinition.get(label)?.options?.loadAs;\n        }\n\n        // Get decorator scope only if it's potentially a class *and not explicitly registered as a function*\n        if (isPotentialClass && !this.isRegisteredAsFunction(label)) {\n            decoratorScope = getScope(label); // Uses getComponentOptions internally\n        }\n\n        // Determine final scope: Manual > Decorator > Default (Transient)\n        const finalScope = manualLoadAs ?? decoratorScope ?? LoadAs.Transient;\n\n        if (finalScope === LoadAs.Singleton) {\n            return 'singleton';\n        } else if (finalScope === LoadAs.Scoped) {\n            return 'scoped';\n        }else{\n            return 'transient'; // Transient\n        }\n    }\n\n    // Central resolution logic\n    protected async loadInstance(\n        label: any,\n        params: ParameterValue<any>[] = [],\n        resolutionChain: string[] = [], // Track resolution path\n        parentProxyId?: number // For proxy hierarchy tracking\n    ): Promise<any> {\n\n        // --- Circular Dependency Check ---\n        const currentLabelStr = (typeof label === 'function' && label.name) ? label.name : String(label);\n        if (resolutionChain.includes(currentLabelStr)) {\n            console.error(`[IOC LoadInstance] Circular dependency detected: ${[...resolutionChain, currentLabelStr].join(' -> ')}`);\n            throw new CircularDependencyError([...resolutionChain, currentLabelStr]);\n        }\n        const nextResolutionChain = [...resolutionChain, currentLabelStr];\n        // --- End Circular Dependency Check ---\n\n        // --- Handle Parameters ---\n        if (label instanceof Parameter) {\n            try {\n                // Pass a *copy* of params to avoid side effects in resolveParameterValue\n                return Promise.resolve(this.resolveParameterValue(label, [...params]));\n            } catch (e) {\n                // console.error(`[IOC LoadInstance] Error resolving parameter ${param.toString()}:`, e);\n                return Promise.reject(e);\n            }\n        }\n        // --- End Handle Parameters ---\n\n\n        // --- Check Explicit Registrations ---\n        if (this.isRegisteredAsClass(label)) {\n            // console.log(`[IOC LoadInstance] Resolving explicitly registered class: ${currentLabelStr}`);\n            return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);\n        }\n        if (this.isRegisteredAsFunction(label)) {\n             // console.log(`[IOC LoadInstance] Resolving explicitly registered function: ${currentLabelStr}`);\n            return this.loadFunctionInstance(label, params, nextResolutionChain);\n        }\n        // --- End Check Explicit Registrations ---\n\n\n        // --- Attempt Auto-Registration/Resolution for Decorated Classes ---\n        if (typeof label === 'function' && label.prototype) {\n            const componentOptions = getComponentOptions(label); // Check for @Component\n            if (componentOptions !== null) {\n                 // console.log(`[IOC LoadInstance] Auto-resolving @Component class: ${currentLabelStr}`);\n                // Set routing *now* so subsequent internal checks work correctly\n                if (!this._routing.has(label)) { // Only set if not already set\n                     this._routing.set(label, ContainerRouting.CLASS);\n                     // console.log(`[IOC LoadInstance] Set routing for auto-resolved class: ${currentLabelStr}`);\n                }\n                // Proceed to load it as a class\n                return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);\n            }\n        }\n        // --- End Auto-Registration ---\n\n\n        // --- Dependency Not Found ---\n        console.error(`[IOC LoadInstance] Dependency not found and cannot be resolved: ${currentLabelStr}`);\n        throw new DependencyNotFoundError(currentLabelStr);\n    }\n\n\n    private resolveParameterValue(param: Parameter, params: ParameterValue<any>[]): any { // No mutation\n        // Find the *last* provided value for the parameter\n        const valueContainer = [...params].reverse().find((p) => p.belongsTo(param));\n        if (!valueContainer) {\n             // console.error(`[IOC ResolveParam] Parameter not found: ${param.toString()}`);\n            throw new ParameterNotFoundError(param.toString());\n        }\n        // console.log(`[IOC ResolveParam] Resolved parameter ${param.toString()}`);\n        return valueContainer.value;\n    }\n\n    private loadClassInstance(\n        classDefinition: any, // Should be a class constructor here\n        params: ParameterValue<any>[],\n        resolutionChain: string[],\n        parentProxyId?: number\n    ): Promise<any> {\n        const storageType = this.getStorageType(classDefinition);\n        const className = classDefinition.name || '[Anonymous Class]';\n\n        // Check storage first (handle stored promises)\n        if (storageType && this.hasInstance(classDefinition)) {\n            const instance = this.getInstance(classDefinition);\n            // console.log(`[IOC LoadClass] Found existing ${storageType} instance for ${className}. IsPromise: ${isPromise(instance)}`);\n            return instance\n        }\n         // console.log(`[IOC LoadClass] Creating new ${storageType || 'transient'} instance for ${className}`);\n\n        // --- Determine Dependencies ---\n        const manualOptions = this._classDefinition.get(classDefinition) as ContainerOptions | undefined;\n        let dependenciesToResolve: any[];\n\n        if (manualOptions?.param && Array.isArray(manualOptions.param)) {\n            dependenciesToResolve = manualOptions.param;\n            // console.log(`[IOC LoadClass] Using manual dependencies for ${className}`);\n        } else {\n            // Use decorator-derived dependencies\n            dependenciesToResolve = getResolvedDependencies(classDefinition);\n             // console.log(`[IOC LoadClass] Using decorator/reflected dependencies for ${className}:`, dependenciesToResolve.map(d => typeof d === 'function' ? d.name : String(d)));\n        }\n        // --- End Determine Dependencies ---\n\n        // Reserve a proxy ID if tracing is enabled\n        let futureProxyId: number | undefined;\n        if (this._enableTracing) {\n            futureProxyId = reserveProxyId();\n        }\n\n        // --- Resolve Dependencies ---\n        // Create a *copy* of params to pass down for dependency resolution\n        const paramsCopy = [...params];\n        const resolutionPromises = dependenciesToResolve.map(dependencyIdentifier =>\n            this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain, futureProxyId) // Recursive call handles auto-registration\n        );\n\n        let finalInstance = Promise.all(resolutionPromises)\n        .catch((error)=>{\n            console.error(`[IOC LoadClass] Failed to resolve one or more dependencies for ${className}:`, error);\n            // Clean up potential partially stored promise if this was going to be singleton/scoped\n            if (storageType && this.isRegisteredAsClass(classDefinition)) { // Check if it was actually *being* stored\n                if (storageType === 'singleton') this._classStorageSingleton.delete(classDefinition);\n                if (storageType === 'scoped') this._classStorageScoped.delete(classDefinition);\n            }\n            throw error; // Re-throw dependency resolution error\n        }).then(async(resolvedDependencies)=>{\n            // --- Instantiate Class ---\n            // Store the promise *before* starting instantiation for concurrent requests\n            let instancePromise: Promise<any> | undefined;\n            if (storageType && !this.hasInstance(classDefinition)) { // Check again in case of race condition?\n                // Create the promise wrapper immediately\n                instancePromise = (async () => {\n                    try {\n                        // console.log(`[IOC LoadClass] Instantiating ${className} with ${resolvedDependencies.length} args.`);\n                        const instance = new classDefinition(...resolvedDependencies);\n\n                        // Wrap with proxy if tracing is enabled\n                        let wrappedInstance = instance;\n                        if (this._enableTracing && futureProxyId !== undefined) {\n                            wrappedInstance = wrapWithProxy(instance, className, parentProxyId, futureProxyId);\n                        }\n\n                        // Overwrite the stored promise with the actual instance *after* it's created\n                        this.setInstance(classDefinition, wrappedInstance, storageType); // Use the correct storageType\n                        // console.log(`[IOC LoadClass] Stored actual ${storageType} instance for ${className}`);\n                        return wrappedInstance;\n                    } catch (err: any) {\n                        console.error(`[IOC LoadClass] Error during instantiation of ${className}: ${err.message}`, err.stack);\n                        // Clean up the stored promise on failure\n                        if (storageType === 'singleton') this._classStorageSingleton.delete(classDefinition);\n                        if (storageType === 'scoped') this._classStorageScoped.delete(classDefinition);\n                        throw err; // Re-throw instantiation error\n                    }\n                })();\n                 // console.log(`[IOC LoadClass] Storing promise for concurrent requests (${storageType}) for ${className}`);\n                this.setInstance(classDefinition, instancePromise, storageType);\n            } else {\n                 // If already has instance (from storage check) or is transient, just instantiate directly\n                 instancePromise = (async () => {\n                      try {\n                          // console.log(`[IOC LoadClass] Instantiating transient ${className} with ${resolvedDependencies.length} args.`);\n                           const instance = new classDefinition(...resolvedDependencies);\n\n                           // Wrap with proxy if tracing is enabled\n                           let wrappedInstance = instance;\n                           if (this._enableTracing && futureProxyId !== undefined) {\n                               wrappedInstance = wrapWithProxy(instance, className, parentProxyId, futureProxyId);\n                           }\n\n                           // No storing for transient\n                           return wrappedInstance;\n                      } catch (err: any) {\n                           console.error(`[IOC LoadClass] Error during instantiation of transient ${className}: ${err.message}`, err.stack);\n                           throw err; // Re-throw instantiation error\n                      }\n                 })();\n            }\n            // --- End Instantiate Class ---\n            // Await and return the final instance (either newly created or from the stored promise)\n            return await instancePromise;\n        });\n\n        if(storageType && storageType !== 'transient'){\n            this.setInstance(classDefinition, finalInstance, storageType); // Store the promise\n        }\n        return finalInstance\n    }\n\n    private loadFunctionInstance(\n        funcLabel: any,\n        params: ParameterValue<any>[],\n        resolutionChain: string[]\n    ): Promise<any> { // Always return Promise<any> since this is an async function\n        const functionConfig = this._functionDefinition.get(funcLabel)!; // Assumed to exist by caller\n        const storageType = this.getStorageType(funcLabel); // Only uses manual options for functions\n        const labelStr = String(funcLabel);\n\n        // Check storage first\n        if (storageType && this.hasInstance(funcLabel)) {\n            const instance = this.getInstance(funcLabel);\n            // console.log(`[IOC LoadFunc] Found existing ${storageType} instance for ${labelStr}. IsPromise: ${isPromise(instance)}`);\n            return instance;\n        }\n         // console.log(`[IOC LoadFunc] Creating new ${storageType || 'transient'} instance for ${labelStr}`);\n\n        const ioc_func = functionConfig.function;\n        const options = functionConfig.options;\n        const dependenciesToResolve: any[] = options?.param || [];\n\n        // --- Resolve Dependencies ---\n        const paramsCopy = [...params]; // Create a copy\n        const resolutionPromises = dependenciesToResolve.map(dependencyIdentifier =>\n            this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain)\n        );\n\n        let finalInstance = Promise.all(resolutionPromises).catch((error)=>{\n            console.error(`[IOC LoadFunc] Failed to resolve dependencies for function ${labelStr}:`, error);\n           // Clean up potential partial storage\n           if (storageType && this.isRegisteredAsFunction(funcLabel)) {\n                if (storageType === 'singleton') this._functionStorageSingleton.delete(funcLabel);\n                if (storageType === 'scoped') this._functionStorageScoped.delete(funcLabel);\n           }\n           throw error;\n        }).then(async(resolvedArgs)=>{\n            let instancePromise: Promise<any> | undefined;\n        if (storageType && !this.hasInstance(funcLabel)) {\n             instancePromise = (async () => {\n                 try {\n                     // console.log(`[IOC LoadFunc] Invoking ${labelStr} with ${resolvedArgs.length} args.`);\n                     const result = await ioc_func.apply(null, resolvedArgs); // Await in case function is async\n                     // Overwrite stored promise with actual result\n                     this.setInstance(funcLabel, result, storageType);\n                     // console.log(`[IOC LoadFunc] Stored actual ${storageType} instance for ${labelStr}`);\n                     return result;\n                 } catch (err: any) {\n                     console.error(`[IOC LoadFunc] Error executing function ${labelStr}: ${err.message}`, err.stack);\n                     // Clean up stored promise on failure\n                     if (storageType === 'singleton') this._functionStorageSingleton.delete(funcLabel);\n                     if (storageType === 'scoped') this._functionStorageScoped.delete(funcLabel);\n                     throw err;\n                 }\n             })();\n              // console.log(`[IOC LoadFunc] Storing promise for concurrent requests (${storageType}) for ${labelStr}`);\n             this.setInstance(funcLabel, instancePromise, storageType);\n        } else {\n             // Transient or already resolved from storage check\n             instancePromise = (async () => {\n                  try {\n                     // console.log(`[IOC LoadFunc] Invoking transient ${labelStr} with ${resolvedArgs.length} args.`);\n                      const result = await ioc_func.apply(null, resolvedArgs); // Await in case function is async\n                      // No storing for transient\n                      return result;\n                  } catch (err: any) {\n                      console.error(`[IOC LoadFunc] Error executing transient function ${labelStr}: ${err.message}`, err.stack);\n                      throw err;\n                  }\n             })();\n        }\n        // --- End Invoke Function ---\n\n        return await instancePromise; // Return the final (awaited) result\n        });\n\n        if(storageType && storageType !== 'transient'){\n            this.setInstance(funcLabel, finalInstance, storageType); // Store the promise\n        }\n\n        return finalInstance;\n    }\n}\n\n// Helper functions\nexport function isPromise(obj: any): obj is Promise<any> {\n    // Simplified check - more robust check might be needed depending on environment\n    return !!obj && typeof obj.then === 'function';\n}\n\nexport function createContainer(): IContainerClient & IContainerSetup {\n    return new Container();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8BAAO;AAEP,oBAAuB;AACvB,uBAA0B;AAE1B,6BAA4I;AAC5I,8BAIO;AACP,0BAA8D;AAC9D,wBAAmC;AACnC,0BAA6B;AAE7B,IAAK,mBAAL,kBAAKA,sBAAL;AACI,EAAAA,kBAAA,gBAAa;AACb,EAAAA,kBAAA,WAAQ;AAFP,SAAAA;AAAA,GAAA;AAQE,MAAM,UAAuD;AAAA,EAA7D;AAEH;AAAA,SAAQ,WAAuC,oBAAI,IAAI;AACvD,SAAQ,sBAA8D,oBAAI,IAAI;AAC9E,SAAQ,mBAA6D,oBAAI,IAAI;AAG7E;AAAA,SAAQ,4BAA2C,oBAAI,IAAI;AAC3D,SAAQ,yBAAwC,oBAAI,IAAI;AACxD,SAAQ,yBAA6C,oBAAI,IAAI;AAC7D,SAAQ,sBAA0C,oBAAI,IAAI;AAG1D;AAAA,SAAQ,iBAA0B;AAClC,SAAQ,yBAAiC;AAAA;AAAA;AAAA,EAGzC,cAAiB,iBAA4C,SAA2C;AAEpG,QAAI,OAAO,oBAAoB,cAAc,CAAC,gBAAgB,WAAW;AACpE,cAAQ,KAAK,0CAA0C,OAAO,eAAe,CAAC,EAAE;AAGhF;AAAA,IACL;AAGA,SAAK,iBAAiB,eAAe;AAGrC,SAAK,SAAS,IAAI,iBAAiB,mBAAsB;AAGzD,QAAI,WAAW,OAAO,KAAK,OAAO,EAAE,SAAS,GAAG;AAC5C,WAAK,iBAAiB,IAAI,iBAAiB,OAAO;AAAA,IAEtD,OAAO;AAAA,IAIP;AAAA,EACJ;AAAA,EAEA,iBAAmD,OAAY,MAAS,UAAqC,CAAC,GAAgB;AAC1H,SAAK,iBAAiB,KAAK;AAC3B,SAAK,SAAS,IAAI,OAAO,6BAA2B;AACpD,SAAK,oBAAoB,IAAI,OAAO,EAAE,UAAU,MAAM,QAAQ,CAAC;AAAA,EAEnE;AAAA;AAAA,EAGA,SAAgC,iBAA2C,SAAgC,CAAC,GAAe;AAEvH,QAAI,OAAO,oBAAoB,cAAc,CAAC,gBAAgB,WAAW;AACpE,YAAM,IAAI,gDAAyB,0CAA0C,OAAO,eAAe,CAAC,EAAE;AAAA,IAC3G;AACA,WAAO,KAAK,aAAa,iBAAiB,MAAM;AAAA,EACpD;AAAA,EAEA,IAAO,OAAY,QAA+B,CAAC,GAAmB;AAElE,WAAO,KAAK,aAAa,OAAO,KAAK;AAAA,EACzC;AAAA,EAEA,SAA6C;AACzC,UAAM,iBAAiB,gBAAgB;AAGvC,mBAAe,WAAW,IAAI,IAAI,KAAK,QAAQ;AAC/C,mBAAe,sBAAsB,IAAI,IAAI,KAAK,mBAAmB;AACrE,mBAAe,mBAAmB,IAAI,IAAI,KAAK,gBAAgB;AAG/D,mBAAe,4BAA4B,KAAK;AAChD,mBAAe,yBAAyB,KAAK;AAM7C,mBAAe,iBAAiB,KAAK;AACrC,mBAAe,yBAAyB,KAAK;AAG7C,WAAO;AAAA,EACX;AAAA;AAAA,EAGA,kBAAkB,SAAwB;AACtC,SAAK,iBAAiB;AACtB,QAAI,WAAW,CAAC,iCAAa,iBAAiB,GAAG;AAE7C,8CAAe,iBAAwB;AAEvC,uCAAa,MAAM,KAAK,sBAAsB;AAAA,IAClD;AAAA,EACJ;AAAA,EAEA,mBAA4B;AACxB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,yBAAyB,SAAuB;AAC5C,SAAK,yBAAyB,KAAK,IAAI,GAAG,OAAO;AAAA,EACrD;AAAA,EAEA,UAAU,kBAAkC;AACxC,UAAM,YAAY,oBAAoB,KAAK;AAC3C,WAAO,kBAAkB,gBAAgB,SAAS;AAAA,EACtD;AAAA,EAEA,eAAsB;AAClB,WAAO,kBAAkB,aAAa;AAAA,EAC1C;AAAA,EAEA,cAAoB;AAChB,sBAAkB,eAAe;AAAA,EACrC;AAAA,EAEA,aAAa,UAAwB;AACjC,UAAM,OAAO,kBAAkB,mBAAmB;AAClD,UAAM,KAAK,QAAQ,IAAI;AACvB,OAAG,cAAc,UAAU,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA,EAC5D;AAAA,EAEA,qBAA0B;AACtB,WAAO,kBAAkB,mBAAmB;AAAA,EAChD;AAAA;AAAA,EAGQ,iBAAiB,OAAkB;AACvC,SAAK,SAAS,OAAO,KAAK;AAC1B,SAAK,oBAAoB,OAAO,KAAK;AAErC,QAAI,OAAO,UAAU,YAAY;AAC7B,WAAK,iBAAiB,OAAO,KAAK;AAAA,IACtC;AAAA,EACJ;AAAA;AAAA,EAGQ,oBAAoB,OAAqB;AAC7C,WAAO,KAAK,SAAS,IAAI,KAAK,MAAM;AAAA,EACxC;AAAA;AAAA,EAGS,uBAAuB,OAAqB;AAChD,WAAO,KAAK,SAAS,IAAI,KAAK,MAAM;AAAA,EACxC;AAAA,EAGO,YAAY,OAAqB;AACrC,UAAM,cAAc,KAAK,eAAe,KAAK;AAE7C,QAAI,CAAC,aAAa;AAEd,aAAO;AAAA,IACX;AAGA,UAAM,UAAU,KAAK,YAAY,KAAK;AAEtC,QAAI,SAAS;AACT,aAAO,gBAAgB,cACjB,KAAK,uBAAuB,IAAI,KAAK,IACrC,KAAK,oBAAoB,IAAI,KAAK;AAAA,IAC5C,OAAO;AACH,aAAO,gBAAgB,cACjB,KAAK,0BAA0B,IAAI,KAAK,IACxC,KAAK,uBAAuB,IAAI,KAAK;AAAA,IAC/C;AAAA,EACJ;AAAA;AAAA,EAGS,YAAY,OAAqB;AACrC,QAAI,KAAK,oBAAoB,KAAK,GAAG;AACjC,aAAO;AAAA,IACX;AAEA,QAAI,OAAO,UAAU,cAAc,MAAM,aAAa,CAAC,KAAK,uBAAuB,KAAK,GAAG;AACtF,iBAAO,6CAAoB,KAAK,MAAM;AAAA,IAC3C;AACA,WAAO;AAAA,EACX;AAAA,EAEO,YAAY,OAAiB;AACjC,UAAM,cAAc,KAAK,eAAe,KAAK;AAE5C,QAAI,CAAC,aAAa;AAEd,cAAQ,MAAM,oEAAoE,OAAO,KAAK,CAAC,EAAE;AACjG,YAAM,IAAI,+CAAwB;AAAA,IACtC;AAED,UAAM,UAAU,KAAK,YAAY,KAAK;AAEtC,QAAI,SAAS;AACT,aAAO,gBAAgB,cACjB,KAAK,uBAAuB,IAAI,KAAK,IACrC,KAAK,oBAAoB,IAAI,KAAK;AAAA,IAC5C,OAAO;AACH,aAAO,gBAAgB,cACjB,KAAK,0BAA0B,IAAI,KAAK,IACxC,KAAK,uBAAuB,IAAI,KAAK;AAAA,IAC/C;AAAA,EACJ;AAAA,EAEQ,YAAY,OAAY,UAAe,aAAiC;AAC5E,UAAM,UAAU,KAAK,YAAY,KAAK;AAEtC,QAAI,SAAS;AACT,UAAI,gBAAgB,aAAa;AAC7B,aAAK,uBAAuB,IAAI,OAAO,QAAQ;AAAA,MACnD,WAAW,eAAe,UAAS;AAC/B,aAAK,oBAAoB,IAAI,OAAO,QAAQ;AAAA,MAChD;AAAA,IACJ,OAAO;AACH,UAAI,gBAAgB,aAAa;AAC7B,aAAK,0BAA0B,IAAI,OAAO,QAAQ;AAAA,MACtD,WAAU,gBAAgB,UAAS;AAC/B,aAAK,uBAAuB,IAAI,OAAO,QAAQ;AAAA,MACnD;AAAA,IACJ;AAAA,EACJ;AAAA,EAEQ,eAAe,OAAyB;AAC5C,QAAI;AACJ,QAAI;AACJ,UAAM,mBAAmB,OAAO,UAAU,cAAc,MAAM;AAG9D,QAAI,KAAK,oBAAoB,KAAK,GAAG;AACjC,qBAAe,KAAK,iBAAiB,IAAI,KAAK,GAAG;AAAA,IACrD,WAAW,KAAK,uBAAuB,KAAK,GAAG;AAC3C,qBAAe,KAAK,oBAAoB,IAAI,KAAK,GAAG,SAAS;AAAA,IACjE;AAGA,QAAI,oBAAoB,CAAC,KAAK,uBAAuB,KAAK,GAAG;AACzD,2BAAiB,kCAAS,KAAK;AAAA,IACnC;AAGA,UAAM,aAAa,gBAAgB,kBAAkB,qBAAO;AAE5D,QAAI,eAAe,qBAAO,WAAW;AACjC,aAAO;AAAA,IACX,WAAW,eAAe,qBAAO,QAAQ;AACrC,aAAO;AAAA,IACX,OAAK;AACD,aAAO;AAAA,IACX;AAAA,EACJ;AAAA;AAAA,EAGA,MAAgB,aACZ,OACA,SAAgC,CAAC,GACjC,kBAA4B,CAAC,GAC7B,eACY;AAGZ,UAAM,kBAAmB,OAAO,UAAU,cAAc,MAAM,OAAQ,MAAM,OAAO,OAAO,KAAK;AAC/F,QAAI,gBAAgB,SAAS,eAAe,GAAG;AAC3C,cAAQ,MAAM,oDAAoD,CAAC,GAAG,iBAAiB,eAAe,EAAE,KAAK,MAAM,CAAC,EAAE;AACtH,YAAM,IAAI,+CAAwB,CAAC,GAAG,iBAAiB,eAAe,CAAC;AAAA,IAC3E;AACA,UAAM,sBAAsB,CAAC,GAAG,iBAAiB,eAAe;AAIhE,QAAI,iBAAiB,4BAAW;AAC5B,UAAI;AAEA,eAAO,QAAQ,QAAQ,KAAK,sBAAsB,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AAAA,MACzE,SAAS,GAAG;AAER,eAAO,QAAQ,OAAO,CAAC;AAAA,MAC3B;AAAA,IACJ;AAKA,QAAI,KAAK,oBAAoB,KAAK,GAAG;AAEjC,aAAO,KAAK,kBAAkB,OAAO,QAAQ,qBAAqB,aAAa;AAAA,IACnF;AACA,QAAI,KAAK,uBAAuB,KAAK,GAAG;AAEpC,aAAO,KAAK,qBAAqB,OAAO,QAAQ,mBAAmB;AAAA,IACvE;AAKA,QAAI,OAAO,UAAU,cAAc,MAAM,WAAW;AAChD,YAAM,uBAAmB,6CAAoB,KAAK;AAClD,UAAI,qBAAqB,MAAM;AAG3B,YAAI,CAAC,KAAK,SAAS,IAAI,KAAK,GAAG;AAC1B,eAAK,SAAS,IAAI,OAAO,mBAAsB;AAAA,QAEpD;AAEA,eAAO,KAAK,kBAAkB,OAAO,QAAQ,qBAAqB,aAAa;AAAA,MACnF;AAAA,IACJ;AAKA,YAAQ,MAAM,mEAAmE,eAAe,EAAE;AAClG,UAAM,IAAI,+CAAwB,eAAe;AAAA,EACrD;AAAA,EAGQ,sBAAsB,OAAkB,QAAoC;AAEhF,UAAM,iBAAiB,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,KAAK,CAAC;AAC3E,QAAI,CAAC,gBAAgB;AAEjB,YAAM,IAAI,8CAAuB,MAAM,SAAS,CAAC;AAAA,IACrD;AAEA,WAAO,eAAe;AAAA,EAC1B;AAAA,EAEQ,kBACJ,iBACA,QACA,iBACA,eACY;AACZ,UAAM,cAAc,KAAK,eAAe,eAAe;AACvD,UAAM,YAAY,gBAAgB,QAAQ;AAG1C,QAAI,eAAe,KAAK,YAAY,eAAe,GAAG;AAClD,YAAM,WAAW,KAAK,YAAY,eAAe;AAEjD,aAAO;AAAA,IACX;AAIA,UAAM,gBAAgB,KAAK,iBAAiB,IAAI,eAAe;AAC/D,QAAI;AAEJ,QAAI,eAAe,SAAS,MAAM,QAAQ,cAAc,KAAK,GAAG;AAC5D,8BAAwB,cAAc;AAAA,IAE1C,OAAO;AAEH,kCAAwB,iDAAwB,eAAe;AAAA,IAEnE;AAIA,QAAI;AACJ,QAAI,KAAK,gBAAgB;AACrB,0BAAgB,oCAAe;AAAA,IACnC;AAIA,UAAM,aAAa,CAAC,GAAG,MAAM;AAC7B,UAAM,qBAAqB,sBAAsB;AAAA,MAAI,0BACjD,KAAK,aAAa,sBAAsB,YAAY,iBAAiB,aAAa;AAAA;AAAA,IACtF;AAEA,QAAI,gBAAgB,QAAQ,IAAI,kBAAkB,EACjD,MAAM,CAAC,UAAQ;AACZ,cAAQ,MAAM,kEAAkE,SAAS,KAAK,KAAK;AAEnG,UAAI,eAAe,KAAK,oBAAoB,eAAe,GAAG;AAC1D,YAAI,gBAAgB,YAAa,MAAK,uBAAuB,OAAO,eAAe;AACnF,YAAI,gBAAgB,SAAU,MAAK,oBAAoB,OAAO,eAAe;AAAA,MACjF;AACA,YAAM;AAAA,IACV,CAAC,EAAE,KAAK,OAAM,yBAAuB;AAGjC,UAAI;AACJ,UAAI,eAAe,CAAC,KAAK,YAAY,eAAe,GAAG;AAEnD,2BAAmB,YAAY;AAC3B,cAAI;AAEA,kBAAM,WAAW,IAAI,gBAAgB,GAAG,oBAAoB;AAG5D,gBAAI,kBAAkB;AACtB,gBAAI,KAAK,kBAAkB,kBAAkB,QAAW;AACpD,oCAAkB,mCAAc,UAAU,WAAW,eAAe,aAAa;AAAA,YACrF;AAGA,iBAAK,YAAY,iBAAiB,iBAAiB,WAAW;AAE9D,mBAAO;AAAA,UACX,SAAS,KAAU;AACf,oBAAQ,MAAM,iDAAiD,SAAS,KAAK,IAAI,OAAO,IAAI,IAAI,KAAK;AAErG,gBAAI,gBAAgB,YAAa,MAAK,uBAAuB,OAAO,eAAe;AACnF,gBAAI,gBAAgB,SAAU,MAAK,oBAAoB,OAAO,eAAe;AAC7E,kBAAM;AAAA,UACV;AAAA,QACJ,GAAG;AAEH,aAAK,YAAY,iBAAiB,iBAAiB,WAAW;AAAA,MAClE,OAAO;AAEF,2BAAmB,YAAY;AAC1B,cAAI;AAEC,kBAAM,WAAW,IAAI,gBAAgB,GAAG,oBAAoB;AAG5D,gBAAI,kBAAkB;AACtB,gBAAI,KAAK,kBAAkB,kBAAkB,QAAW;AACpD,oCAAkB,mCAAc,UAAU,WAAW,eAAe,aAAa;AAAA,YACrF;AAGA,mBAAO;AAAA,UACZ,SAAS,KAAU;AACd,oBAAQ,MAAM,2DAA2D,SAAS,KAAK,IAAI,OAAO,IAAI,IAAI,KAAK;AAC/G,kBAAM;AAAA,UACX;AAAA,QACL,GAAG;AAAA,MACR;AAGA,aAAO,MAAM;AAAA,IACjB,CAAC;AAED,QAAG,eAAe,gBAAgB,aAAY;AAC1C,WAAK,YAAY,iBAAiB,eAAe,WAAW;AAAA,IAChE;AACA,WAAO;AAAA,EACX;AAAA,EAEQ,qBACJ,WACA,QACA,iBACY;AACZ,UAAM,iBAAiB,KAAK,oBAAoB,IAAI,SAAS;AAC7D,UAAM,cAAc,KAAK,eAAe,SAAS;AACjD,UAAM,WAAW,OAAO,SAAS;AAGjC,QAAI,eAAe,KAAK,YAAY,SAAS,GAAG;AAC5C,YAAM,WAAW,KAAK,YAAY,SAAS;AAE3C,aAAO;AAAA,IACX;AAGA,UAAM,WAAW,eAAe;AAChC,UAAM,UAAU,eAAe;AAC/B,UAAM,wBAA+B,SAAS,SAAS,CAAC;AAGxD,UAAM,aAAa,CAAC,GAAG,MAAM;AAC7B,UAAM,qBAAqB,sBAAsB;AAAA,MAAI,0BACjD,KAAK,aAAa,sBAAsB,YAAY,eAAe;AAAA,IACvE;AAEA,QAAI,gBAAgB,QAAQ,IAAI,kBAAkB,EAAE,MAAM,CAAC,UAAQ;AAC/D,cAAQ,MAAM,8DAA8D,QAAQ,KAAK,KAAK;AAE/F,UAAI,eAAe,KAAK,uBAAuB,SAAS,GAAG;AACtD,YAAI,gBAAgB,YAAa,MAAK,0BAA0B,OAAO,SAAS;AAChF,YAAI,gBAAgB,SAAU,MAAK,uBAAuB,OAAO,SAAS;AAAA,MAC/E;AACA,YAAM;AAAA,IACT,CAAC,EAAE,KAAK,OAAM,iBAAe;AACzB,UAAI;AACR,UAAI,eAAe,CAAC,KAAK,YAAY,SAAS,GAAG;AAC5C,2BAAmB,YAAY;AAC3B,cAAI;AAEA,kBAAM,SAAS,MAAM,SAAS,MAAM,MAAM,YAAY;AAEtD,iBAAK,YAAY,WAAW,QAAQ,WAAW;AAE/C,mBAAO;AAAA,UACX,SAAS,KAAU;AACf,oBAAQ,MAAM,2CAA2C,QAAQ,KAAK,IAAI,OAAO,IAAI,IAAI,KAAK;AAE9F,gBAAI,gBAAgB,YAAa,MAAK,0BAA0B,OAAO,SAAS;AAChF,gBAAI,gBAAgB,SAAU,MAAK,uBAAuB,OAAO,SAAS;AAC1E,kBAAM;AAAA,UACV;AAAA,QACJ,GAAG;AAEH,aAAK,YAAY,WAAW,iBAAiB,WAAW;AAAA,MAC7D,OAAO;AAEF,2BAAmB,YAAY;AAC1B,cAAI;AAEA,kBAAM,SAAS,MAAM,SAAS,MAAM,MAAM,YAAY;AAEtD,mBAAO;AAAA,UACX,SAAS,KAAU;AACf,oBAAQ,MAAM,qDAAqD,QAAQ,KAAK,IAAI,OAAO,IAAI,IAAI,KAAK;AACxG,kBAAM;AAAA,UACV;AAAA,QACL,GAAG;AAAA,MACR;AAGA,aAAO,MAAM;AAAA,IACb,CAAC;AAED,QAAG,eAAe,gBAAgB,aAAY;AAC1C,WAAK,YAAY,WAAW,eAAe,WAAW;AAAA,IAC1D;AAEA,WAAO;AAAA,EACX;AACJ;AAGO,SAAS,UAAU,KAA+B;AAErD,SAAO,CAAC,CAAC,OAAO,OAAO,IAAI,SAAS;AACxC;AAEO,SAAS,kBAAsD;AAClE,SAAO,IAAI,UAAU;AACzB;","names":["ContainerRouting"]}
+{"version":3,"sources":["../../../framework/implementation/Container.ts"],"sourcesContent":["import 'reflect-metadata'; // Ensure polyfill is loaded conceptually\nimport type { ContainerOptions, IContainerClient, IContainerFunctionDefinition, IContainerSetup } from \"../interface/Container.cjs\";\nimport { LoadAs } from \"./LoadAs.cjs\";\nimport { Parameter } from \"./Parameter.cjs\";\nimport type { ParameterValue } from \"./Parameter.cjs\";\nimport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError } from \"../errors/ContainerErrors.cjs\";\nimport {\n    getScope,\n    getComponentOptions, // Use helper\n    getResolvedDependencies // Use helper\n} from './DecoratorSupport'; // Assume helpers exist or create them\nimport { wrapWithProxy, setTraceLogger, reserveProxyId } from \"./ProxyFactory.cjs\";\nimport * as TraceLoggerModule from \"./TraceLogger.cjs\";\nimport { TraceCleanup } from \"./TraceCleanup.cjs\";\n\n/**\n * A special injection token that resolves to the current scoped container.\n * Use this as a dependency in param arrays to have the container inject itself.\n * This allows provider classes to resolve additional dependencies on demand.\n */\nexport const SCOPED_CONTAINER = Symbol.for(\"ioc:scoped-container\");\n\nenum ContainerRouting {\n    FUNCTIONAL = \"FUNCTIONAL\",\n    CLASS = \"CLASS\"\n    // No need for COMPONENT route, just check metadata if CLASS/FUNCTIONAL fails\n}\n\ntype StorageType = 'singleton' | 'scoped' | 'transient';\n\nexport class Container implements IContainerClient, IContainerSetup {\n    // Routing and definition maps\n    private _routing: Map<any, ContainerRouting> = new Map();\n    private _functionDefinition: Map<any, IContainerFunctionDefinition> = new Map();\n    private _classDefinition: Map<Function, Partial<ContainerOptions>> = new Map();\n\n    // Storage maps\n    private _functionStorageSingleton: Map<any, any> = new Map();\n    private _functionStorageScoped: Map<any, any> = new Map();\n    private _classStorageSingleton: Map<Function, any> = new Map();\n    private _classStorageScoped: Map<Function, any> = new Map();\n\n    // Tracing configuration\n    private _enableTracing: boolean = false;\n    private _traceRetentionMinutes: number = 5;\n\n    // Registration methods\n    registerClass<T>(classDefinition: new (...args: any[]) => T, options?: Partial<ContainerOptions>): void {\n        // Basic validation\n        if (typeof classDefinition !== 'function' || !classDefinition.prototype) {\n             console.warn(`[IOC] Attempted to register non-class: ${String(classDefinition)}`);\n             // Optional: throw error instead?\n             // throw new NotAClassDefinitionError(`Attempted to register non-class: ${String(classDefinition)}`);\n             return; // Don't proceed if not a class constructor\n        }\n\n        // Always clear previous definitions for this exact class constructor\n        this.clearDefinitions(classDefinition);\n\n        // Always set the routing type so 'isClassDefinition' works\n        this._routing.set(classDefinition, ContainerRouting.CLASS);\n\n        // Store manual options *only if they are actually provided and have content*\n        if (options && Object.keys(options).length > 0) {\n            this._classDefinition.set(classDefinition, options);\n            // console.log(`[IOC RegClass] Manually registered ${classDefinition.name} with options:`, options);\n        } else {\n            // console.log(`[IOC RegClass] Manually registered ${classDefinition.name} with no specific options (will use decorators if present).`);\n             // If no options are provided, we don't store anything in _classDefinition,\n             // effectively clearing any previous manual config and letting decorators take over if present.\n        }\n    }\n\n    registerFunction<T extends (...arg: any[]) => any>(label: any, func: T, options: Partial<ContainerOptions> = {} as any): void {\n        this.clearDefinitions(label);\n        this._routing.set(label, ContainerRouting.FUNCTIONAL);\n        this._functionDefinition.set(label, { function: func, options });\n        // console.log(`[IOC RegFunc] Registered function with label ${String(label)} and options:`, options);\n    }\n\n    // Instance resolution methods - Simplify to just call loadInstance\n    instance<T, Sync extends boolean = false>(classDefinition: new (...args: any[]) => T, params: ParameterValue<any>[] = []): Sync extends true ? T : Promise<T> | T {\n        // Basic check upfront\n        if (typeof classDefinition !== 'function' || !classDefinition.prototype) {\n             throw new NotAClassDefinitionError(`Cannot resolve instance for non-class: ${String(classDefinition)}`);\n        }\n        return this.loadInstance(classDefinition, params);\n    }\n\n    get<T, Sync extends boolean = false>(label: any, param: ParameterValue<any>[] = []): Sync extends true ? T : Promise<T> | T {\n        // Just delegate to loadInstance, which handles routing and auto-registration\n        return this.loadInstance(label, param);\n    }\n\n    extend(): IContainerClient & IContainerSetup {\n        const childContainer = createContainer() as Container;\n\n        // Copy routing and definition maps (share the registration knowledge)\n        childContainer._routing = new Map(this._routing);\n        childContainer._functionDefinition = new Map(this._functionDefinition);\n        childContainer._classDefinition = new Map(this._classDefinition);\n\n        // Share singleton storage (singletons are shared across all containers)\n        childContainer._functionStorageSingleton = this._functionStorageSingleton;\n        childContainer._classStorageSingleton = this._classStorageSingleton;\n\n        // Do NOT share scoped storage (new container = new scope)\n        // Child gets its own empty scoped storage\n\n        // Share tracing configuration\n        childContainer._enableTracing = this._enableTracing;\n        childContainer._traceRetentionMinutes = this._traceRetentionMinutes;\n\n        // console.log('[IOC Extend] Created child container.');\n        return childContainer;\n    }\n\n    // Tracing API\n    setTracingEnabled(enabled: boolean): void {\n        this._enableTracing = enabled;\n        if (enabled && !TraceCleanup.isCleanupRunning()) {\n            // Set the trace logger for the ProxyFactory\n            setTraceLogger(TraceLoggerModule as any);\n            // Start automatic cleanup\n            TraceCleanup.start(this._traceRetentionMinutes);\n        }\n    }\n\n    isTracingEnabled(): boolean {\n        return this._enableTracing;\n    }\n\n    setTraceRetentionMinutes(minutes: number): void {\n        this._traceRetentionMinutes = Math.max(1, minutes);\n    }\n\n    getTraces(retentionMinutes?: number): any[] {\n        const retention = retentionMinutes ?? this._traceRetentionMinutes;\n        return TraceLoggerModule.getRecentTraces(retention);\n    }\n\n    getAllTraces(): any[] {\n        return TraceLoggerModule.getAllTraces();\n    }\n\n    clearTraces(): void {\n        TraceLoggerModule.clearAllTraces();\n    }\n\n    exportTraces(filepath: string): void {\n        const data = TraceLoggerModule.exportTracesToJson();\n        const fs = require('fs');\n        fs.writeFileSync(filepath, JSON.stringify(data, null, 2));\n    }\n\n    getTraceStatistics(): any {\n        return TraceLoggerModule.getTraceStatistics();\n    }\n\n    // Private helper methods\n    private clearDefinitions(label: any): void {\n        this._routing.delete(label);\n        this._functionDefinition.delete(label);\n        // Only delete from classDefinition if the label is actually a function constructor\n        if (typeof label === 'function') {\n            this._classDefinition.delete(label);\n        }\n    }\n\n    // Checks if the label is *currently* registered as a class\n    private isRegisteredAsClass(label: any): boolean {\n        return this._routing.get(label) === ContainerRouting.CLASS;\n    }\n\n     // Checks if the label is *currently* registered as a function\n     private isRegisteredAsFunction(label: any): boolean {\n         return this._routing.get(label) === ContainerRouting.FUNCTIONAL;\n     }\n\n\n    private hasInstance(label: any): boolean {\n        const storageType = this.getStorageType(label); // This checks decorators if needed\n\n        if (!storageType) {\n            // Transient instances are never stored\n            return false;\n        }\n\n        // Determine if it's treated as a class (registered or decorated) *after* getting type\n        const isClass = this.isClassType(label); // Use a helper that checks routing OR decorator\n\n        if (isClass) {\n            return storageType === 'singleton'\n                ? this._classStorageSingleton.has(label)\n                : this._classStorageScoped.has(label);\n        } else { // Must be a function if not a class\n            return storageType === 'singleton'\n                ? this._functionStorageSingleton.has(label)\n                : this._functionStorageScoped.has(label);\n        }\n    }\n\n     // Helper to determine if something should be treated as a class (registered or decorated)\n     private isClassType(label: any): boolean {\n         if (this.isRegisteredAsClass(label)) {\n             return true;\n         }\n         // If not explicitly registered as a class, check if it's a function with @Component\n         if (typeof label === 'function' && label.prototype && !this.isRegisteredAsFunction(label)) {\n              return getComponentOptions(label) !== null;\n         }\n         return false;\n     }\n\n    private getInstance(label: any): any {\n        const storageType = this.getStorageType(label); // Checks decorators if needed\n\n         if (!storageType) {\n             // This should ideally not be reached if called after hasInstance check\n             console.error(`[IOC GetInstance] Attempted to get instance for non-stored type: ${String(label)}`);\n             throw new InstanceNotCreatedError();\n         }\n\n        const isClass = this.isClassType(label); // Check routing OR decorator\n\n        if (isClass) {\n            return storageType === 'singleton'\n                ? this._classStorageSingleton.get(label)\n                : this._classStorageScoped.get(label);\n        } else { // Must be a function\n            return storageType === 'singleton'\n                ? this._functionStorageSingleton.get(label)\n                : this._functionStorageScoped.get(label);\n        }\n    }\n\n    private setInstance(label: any, instance: any, storageType?: StorageType): void { // Made storageType non-optional\n        const isClass = this.isClassType(label); // Determine type based on routing OR decorator\n\n        if (isClass) {\n            if (storageType === 'singleton') {\n                this._classStorageSingleton.set(label, instance);\n            } else if (storageType == 'scoped'){ // storageType === 'scoped'\n                this._classStorageScoped.set(label, instance);\n            }\n        } else { // Must be a function\n            if (storageType === 'singleton') {\n                this._functionStorageSingleton.set(label, instance);\n            } else if(storageType === \"scoped\"){ // storageType === 'scoped'\n                this._functionStorageScoped.set(label, instance);\n            }\n        }\n    }\n\n    private getStorageType(label: any): StorageType {\n        let manualLoadAs: LoadAs | undefined;\n        let decoratorScope: LoadAs | undefined;\n        const isPotentialClass = typeof label === 'function' && label.prototype;\n\n        // Get manual registration options if available\n        if (this.isRegisteredAsClass(label)) { // Use helper\n            manualLoadAs = this._classDefinition.get(label)?.loadAs;\n        } else if (this.isRegisteredAsFunction(label)) { // Use helper\n            manualLoadAs = this._functionDefinition.get(label)?.options?.loadAs;\n        }\n\n        // Get decorator scope only if it's potentially a class *and not explicitly registered as a function*\n        if (isPotentialClass && !this.isRegisteredAsFunction(label)) {\n            decoratorScope = getScope(label); // Uses getComponentOptions internally\n        }\n\n        // Determine final scope: Manual > Decorator > Default (Transient)\n        const finalScope = manualLoadAs ?? decoratorScope ?? LoadAs.Transient;\n\n        if (finalScope === LoadAs.Singleton) {\n            return 'singleton';\n        } else if (finalScope === LoadAs.Scoped) {\n            return 'scoped';\n        }else{\n            return 'transient'; // Transient\n        }\n    }\n\n    // Central resolution logic - sync-first, returns T or Promise<T>\n    protected loadInstance(\n        label: any,\n        params: ParameterValue<any>[] = [],\n        resolutionChain: string[] = [], // Track resolution path\n        parentProxyId?: number // For proxy hierarchy tracking\n    ): any {\n\n        // --- Circular Dependency Check ---\n        const currentLabelStr = (typeof label === 'function' && label.name) ? label.name : String(label);\n        if (resolutionChain.includes(currentLabelStr)) {\n            console.error(`[IOC LoadInstance] Circular dependency detected: ${[...resolutionChain, currentLabelStr].join(' -> ')}`);\n            throw new CircularDependencyError([...resolutionChain, currentLabelStr]);\n        }\n        const nextResolutionChain = [...resolutionChain, currentLabelStr];\n        // --- End Circular Dependency Check ---\n\n        // --- Handle Parameters ---\n        if (label instanceof Parameter) {\n            try {\n                // Pass a *copy* of params to avoid side effects in resolveParameterValue\n                return this.resolveParameterValue(label, [...params]);\n            } catch (e) {\n                // console.error(`[IOC LoadInstance] Error resolving parameter ${param.toString()}:`, e);\n                throw e;\n            }\n        }\n        // --- End Handle Parameters ---\n\n        // --- Handle Scoped Container Injection ---\n        if (label === SCOPED_CONTAINER) {\n            return this;\n        }\n        // --- End Handle Scoped Container Injection ---\n\n        // --- Check Explicit Registrations ---\n        if (this.isRegisteredAsClass(label)) {\n            // console.log(`[IOC LoadInstance] Resolving explicitly registered class: ${currentLabelStr}`);\n            return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);\n        }\n        if (this.isRegisteredAsFunction(label)) {\n             // console.log(`[IOC LoadInstance] Resolving explicitly registered function: ${currentLabelStr}`);\n            return this.loadFunctionInstance(label, params, nextResolutionChain);\n        }\n        // --- End Check Explicit Registrations ---\n\n\n        // --- Attempt Auto-Registration/Resolution for Decorated Classes ---\n        if (typeof label === 'function' && label.prototype) {\n            const componentOptions = getComponentOptions(label); // Check for @Component\n            if (componentOptions !== null) {\n                 // console.log(`[IOC LoadInstance] Auto-resolving @Component class: ${currentLabelStr}`);\n                // Set routing *now* so subsequent internal checks work correctly\n                if (!this._routing.has(label)) { // Only set if not already set\n                     this._routing.set(label, ContainerRouting.CLASS);\n                     // console.log(`[IOC LoadInstance] Set routing for auto-resolved class: ${currentLabelStr}`);\n                }\n                // Proceed to load it as a class\n                return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);\n            }\n        }\n        // --- End Auto-Registration ---\n\n\n        // --- Dependency Not Found ---\n        console.error(`[IOC LoadInstance] Dependency not found and cannot be resolved: ${currentLabelStr}`);\n        throw new DependencyNotFoundError(currentLabelStr);\n    }\n\n\n    private resolveParameterValue(param: Parameter, params: ParameterValue<any>[]): any { // No mutation\n        // Find the *last* provided value for the parameter\n        const valueContainer = [...params].reverse().find((p) => p.belongsTo(param));\n        if (!valueContainer) {\n             // console.error(`[IOC ResolveParam] Parameter not found: ${param.toString()}`);\n            throw new ParameterNotFoundError(param.toString());\n        }\n        // console.log(`[IOC ResolveParam] Resolved parameter ${param.toString()}`);\n        return valueContainer.value;\n    }\n\n    private loadClassInstance(\n        classDefinition: any, // Should be a class constructor here\n        params: ParameterValue<any>[],\n        resolutionChain: string[],\n        parentProxyId?: number\n    ): any {\n        const storageType = this.getStorageType(classDefinition);\n        const className = classDefinition.name || '[Anonymous Class]';\n\n        // Check storage first (may be sync value or Promise)\n        if (storageType && this.hasInstance(classDefinition)) {\n            const instance = this.getInstance(classDefinition);\n            // console.log(`[IOC LoadClass] Found existing ${storageType} instance for ${className}. IsPromise: ${isPromise(instance)}`);\n            return instance;\n        }\n         // console.log(`[IOC LoadClass] Creating new ${storageType || 'transient'} instance for ${className}`);\n\n        // --- Determine Dependencies ---\n        const manualOptions = this._classDefinition.get(classDefinition) as ContainerOptions | undefined;\n        let dependenciesToResolve: any[];\n\n        if (manualOptions?.param && Array.isArray(manualOptions.param)) {\n            dependenciesToResolve = manualOptions.param;\n            // console.log(`[IOC LoadClass] Using manual dependencies for ${className}`);\n        } else {\n            // Use decorator-derived dependencies\n            dependenciesToResolve = getResolvedDependencies(classDefinition);\n             // console.log(`[IOC LoadClass] Using decorator/reflected dependencies for ${className}:`, dependenciesToResolve.map(d => typeof d === 'function' ? d.name : String(d)));\n        }\n        // --- End Determine Dependencies ---\n\n        // Reserve a proxy ID if tracing is enabled\n        let futureProxyId: number | undefined;\n        if (this._enableTracing) {\n            futureProxyId = reserveProxyId();\n        }\n\n        // --- Resolve Dependencies (sync-first) ---\n        const paramsCopy = [...params];\n        const resolvedDependencies: any[] = [];\n        let hasAsyncDependency = false;\n\n        // Resolve each dependency and check if any return Promises\n        for (const dependencyIdentifier of dependenciesToResolve) {\n            const resolved = this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain, futureProxyId);\n            resolvedDependencies.push(resolved);\n            if (isPromise(resolved)) {\n                hasAsyncDependency = true;\n            }\n        }\n\n        // Helper to instantiate the class\n        const instantiate = (deps: any[]): any => {\n            try {\n                const instance = new classDefinition(...deps);\n\n                // Wrap with proxy if tracing is enabled\n                if (this._enableTracing && futureProxyId !== undefined) {\n                    return wrapWithProxy(instance, className, parentProxyId, futureProxyId);\n                }\n                return instance;\n            } catch (err: any) {\n                console.error(`[IOC LoadClass] Error during instantiation of ${className}: ${err.message}`, err.stack);\n                throw err;\n            }\n        };\n\n        // --- Sync Path: All dependencies resolved synchronously ---\n        if (!hasAsyncDependency) {\n            const instance = instantiate(resolvedDependencies);\n\n            // Store if singleton/scoped\n            if (storageType && storageType !== 'transient') {\n                this.setInstance(classDefinition, instance, storageType);\n            }\n            return instance;\n        }\n\n        // --- Async Path: At least one dependency is a Promise ---\n        const asyncInstance = Promise.all(resolvedDependencies)\n            .then((deps) => {\n                const instance = instantiate(deps);\n\n                // Store if singleton/scoped (overwrite the promise with the instance)\n                if (storageType && storageType !== 'transient') {\n                    this.setInstance(classDefinition, instance, storageType);\n                }\n                return instance;\n            })\n            .catch((error) => {\n                console.error(`[IOC LoadClass] Failed to resolve one or more dependencies for ${className}:`, error);\n                // Clean up stored promise on failure\n                if (storageType && this.isRegisteredAsClass(classDefinition)) {\n                    if (storageType === 'singleton') this._classStorageSingleton.delete(classDefinition);\n                    if (storageType === 'scoped') this._classStorageScoped.delete(classDefinition);\n                }\n                throw error;\n            });\n\n        // Store the promise for singleton/scoped to handle concurrent requests\n        if (storageType && storageType !== 'transient') {\n            this.setInstance(classDefinition, asyncInstance, storageType);\n        }\n\n        return asyncInstance;\n    }\n\n    private loadFunctionInstance(\n        funcLabel: any,\n        params: ParameterValue<any>[],\n        resolutionChain: string[]\n    ): Promise<any> { // Always return Promise<any> since this is an async function\n        const functionConfig = this._functionDefinition.get(funcLabel)!; // Assumed to exist by caller\n        const storageType = this.getStorageType(funcLabel); // Only uses manual options for functions\n        const labelStr = String(funcLabel);\n\n        // Check storage first\n        if (storageType && this.hasInstance(funcLabel)) {\n            const instance = this.getInstance(funcLabel);\n            // console.log(`[IOC LoadFunc] Found existing ${storageType} instance for ${labelStr}. IsPromise: ${isPromise(instance)}`);\n            return instance;\n        }\n         // console.log(`[IOC LoadFunc] Creating new ${storageType || 'transient'} instance for ${labelStr}`);\n\n        const ioc_func = functionConfig.function;\n        const options = functionConfig.options;\n        const dependenciesToResolve: any[] = options?.param || [];\n\n        // --- Resolve Dependencies ---\n        const paramsCopy = [...params]; // Create a copy\n        const resolutionPromises = dependenciesToResolve.map(dependencyIdentifier =>\n            this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain)\n        );\n\n        let finalInstance = Promise.all(resolutionPromises).catch((error)=>{\n            console.error(`[IOC LoadFunc] Failed to resolve dependencies for function ${labelStr}:`, error);\n           // Clean up potential partial storage\n           if (storageType && this.isRegisteredAsFunction(funcLabel)) {\n                if (storageType === 'singleton') this._functionStorageSingleton.delete(funcLabel);\n                if (storageType === 'scoped') this._functionStorageScoped.delete(funcLabel);\n           }\n           throw error;\n        }).then(async(resolvedArgs)=>{\n            let instancePromise: Promise<any> | undefined;\n        if (storageType && !this.hasInstance(funcLabel)) {\n             instancePromise = (async () => {\n                 try {\n                     // console.log(`[IOC LoadFunc] Invoking ${labelStr} with ${resolvedArgs.length} args.`);\n                     const result = await ioc_func.apply(null, resolvedArgs); // Await in case function is async\n                     // Overwrite stored promise with actual result\n                     this.setInstance(funcLabel, result, storageType);\n                     // console.log(`[IOC LoadFunc] Stored actual ${storageType} instance for ${labelStr}`);\n                     return result;\n                 } catch (err: any) {\n                     console.error(`[IOC LoadFunc] Error executing function ${labelStr}: ${err.message}`, err.stack);\n                     // Clean up stored promise on failure\n                     if (storageType === 'singleton') this._functionStorageSingleton.delete(funcLabel);\n                     if (storageType === 'scoped') this._functionStorageScoped.delete(funcLabel);\n                     throw err;\n                 }\n             })();\n              // console.log(`[IOC LoadFunc] Storing promise for concurrent requests (${storageType}) for ${labelStr}`);\n             this.setInstance(funcLabel, instancePromise, storageType);\n        } else {\n             // Transient or already resolved from storage check\n             instancePromise = (async () => {\n                  try {\n                     // console.log(`[IOC LoadFunc] Invoking transient ${labelStr} with ${resolvedArgs.length} args.`);\n                      const result = await ioc_func.apply(null, resolvedArgs); // Await in case function is async\n                      // No storing for transient\n                      return result;\n                  } catch (err: any) {\n                      console.error(`[IOC LoadFunc] Error executing transient function ${labelStr}: ${err.message}`, err.stack);\n                      throw err;\n                  }\n             })();\n        }\n        // --- End Invoke Function ---\n\n        return await instancePromise; // Return the final (awaited) result\n        });\n\n        if(storageType && storageType !== 'transient'){\n            this.setInstance(funcLabel, finalInstance, storageType); // Store the promise\n        }\n\n        return finalInstance;\n    }\n}\n\n// Helper functions\nexport function isPromise(obj: any): obj is Promise<any> {\n    // Simplified check - more robust check might be needed depending on environment\n    return !!obj && typeof obj.then === 'function';\n}\n\nexport function createContainer(): IContainerClient & IContainerSetup {\n    return new Container();\n}\n"],"mappings":"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","names":["ContainerRouting"]}

package/dist/framework/implementation/Container.d.cts

@@ -2,6 +2,12 @@ import { IContainerClient, IContainerSetup, ContainerOptions } from '../interfac
 import { ParameterValue } from './Parameter.cjs';
 import './LoadAs.cjs';
 
+/**
+ * A special injection token that resolves to the current scoped container.
+ * Use this as a dependency in param arrays to have the container inject itself.
+ * This allows provider classes to resolve additional dependencies on demand.
+ */
+declare const SCOPED_CONTAINER: unique symbol;
 declare class Container implements IContainerClient, IContainerSetup {
     private _routing;
     private _functionDefinition;
@@ -14,8 +20,8 @@ declare class Container implements IContainerClient, IContainerSetup {
     private _traceRetentionMinutes;
     registerClass<T>(classDefinition: new (...args: any[]) => T, options?: Partial<ContainerOptions>): void;
     registerFunction<T extends (...arg: any[]) => any>(label: any, func: T, options?: Partial<ContainerOptions>): void;
-    instance<T, Args extends any[]>(classDefinition: new (...args: Args) => T, params?: ParameterValue<any>[]): Promise<T>;
-    get<T>(label: any, param?: ParameterValue<any>[]): Promise<T> | T;
+    instance<T, Sync extends boolean = false>(classDefinition: new (...args: any[]) => T, params?: ParameterValue<any>[]): Sync extends true ? T : Promise<T> | T;
+    get<T, Sync extends boolean = false>(label: any, param?: ParameterValue<any>[]): Sync extends true ? T : Promise<T> | T;
     extend(): IContainerClient & IContainerSetup;
     setTracingEnabled(enabled: boolean): void;
     isTracingEnabled(): boolean;
@@ -34,7 +40,7 @@ declare class Container implements IContainerClient, IContainerSetup {
     private setInstance;
     private getStorageType;
     protected loadInstance(label: any, params?: ParameterValue<any>[], resolutionChain?: string[], // Track resolution path
-    parentProxyId?: number): Promise<any>;
+    parentProxyId?: number): any;
     private resolveParameterValue;
     private loadClassInstance;
     private loadFunctionInstance;
@@ -42,4 +48,4 @@ declare class Container implements IContainerClient, IContainerSetup {
 declare function isPromise(obj: any): obj is Promise<any>;
 declare function createContainer(): IContainerClient & IContainerSetup;
 
-export { Container, createContainer, isPromise };
+export { Container, SCOPED_CONTAINER, createContainer, isPromise };

package/dist/framework/implementation/Container.d.ts

@@ -2,6 +2,12 @@ import { IContainerClient, IContainerSetup, ContainerOptions } from '../interfac
 import { ParameterValue } from './Parameter.js';
 import './LoadAs.js';
 
+/**
+ * A special injection token that resolves to the current scoped container.
+ * Use this as a dependency in param arrays to have the container inject itself.
+ * This allows provider classes to resolve additional dependencies on demand.
+ */
+declare const SCOPED_CONTAINER: unique symbol;
 declare class Container implements IContainerClient, IContainerSetup {
     private _routing;
     private _functionDefinition;
@@ -14,8 +20,8 @@ declare class Container implements IContainerClient, IContainerSetup {
     private _traceRetentionMinutes;
     registerClass<T>(classDefinition: new (...args: any[]) => T, options?: Partial<ContainerOptions>): void;
     registerFunction<T extends (...arg: any[]) => any>(label: any, func: T, options?: Partial<ContainerOptions>): void;
-    instance<T, Args extends any[]>(classDefinition: new (...args: Args) => T, params?: ParameterValue<any>[]): Promise<T>;
-    get<T>(label: any, param?: ParameterValue<any>[]): Promise<T> | T;
+    instance<T, Sync extends boolean = false>(classDefinition: new (...args: any[]) => T, params?: ParameterValue<any>[]): Sync extends true ? T : Promise<T> | T;
+    get<T, Sync extends boolean = false>(label: any, param?: ParameterValue<any>[]): Sync extends true ? T : Promise<T> | T;
     extend(): IContainerClient & IContainerSetup;
     setTracingEnabled(enabled: boolean): void;
     isTracingEnabled(): boolean;
@@ -34,7 +40,7 @@ declare class Container implements IContainerClient, IContainerSetup {
     private setInstance;
     private getStorageType;
     protected loadInstance(label: any, params?: ParameterValue<any>[], resolutionChain?: string[], // Track resolution path
-    parentProxyId?: number): Promise<any>;
+    parentProxyId?: number): any;
     private resolveParameterValue;
     private loadClassInstance;
     private loadFunctionInstance;
@@ -42,4 +48,4 @@ declare class Container implements IContainerClient, IContainerSetup {
 declare function isPromise(obj: any): obj is Promise<any>;
 declare function createContainer(): IContainerClient & IContainerSetup;
 
-export { Container, createContainer, isPromise };
+export { Container, SCOPED_CONTAINER, createContainer, isPromise };

package/dist/framework/implementation/Container.js

@@ -10,6 +10,7 @@ import {
 import { wrapWithProxy, setTraceLogger, reserveProxyId } from "./ProxyFactory.js";
 import * as TraceLoggerModule from "./TraceLogger.js";
 import { TraceCleanup } from "./TraceCleanup.js";
+const SCOPED_CONTAINER = Symbol.for("ioc:scoped-container");
 var ContainerRouting = /* @__PURE__ */ ((ContainerRouting2) => {
   ContainerRouting2["FUNCTIONAL"] = "FUNCTIONAL";
   ContainerRouting2["CLASS"] = "CLASS";
@@ -189,8 +190,8 @@ class Container {
       return "transient";
     }
   }
-  // Central resolution logic
-  async loadInstance(label, params = [], resolutionChain = [], parentProxyId) {
+  // Central resolution logic - sync-first, returns T or Promise<T>
+  loadInstance(label, params = [], resolutionChain = [], parentProxyId) {
     const currentLabelStr = typeof label === "function" && label.name ? label.name : String(label);
     if (resolutionChain.includes(currentLabelStr)) {
       console.error(`[IOC LoadInstance] Circular dependency detected: ${[...resolutionChain, currentLabelStr].join(" -> ")}`);
@@ -199,11 +200,14 @@ class Container {
     const nextResolutionChain = [...resolutionChain, currentLabelStr];
     if (label instanceof Parameter) {
       try {
-        return Promise.resolve(this.resolveParameterValue(label, [...params]));
+        return this.resolveParameterValue(label, [...params]);
       } catch (e) {
-        return Promise.reject(e);
+        throw e;
       }
     }
+    if (label === SCOPED_CONTAINER) {
+      return this;
+    }
     if (this.isRegisteredAsClass(label)) {
       return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);
     }
@@ -248,58 +252,52 @@ class Container {
       futureProxyId = reserveProxyId();
     }
     const paramsCopy = [...params];
-    const resolutionPromises = dependenciesToResolve.map(
-      (dependencyIdentifier) => this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain, futureProxyId)
-      // Recursive call handles auto-registration
-    );
-    let finalInstance = Promise.all(resolutionPromises).catch((error) => {
+    const resolvedDependencies = [];
+    let hasAsyncDependency = false;
+    for (const dependencyIdentifier of dependenciesToResolve) {
+      const resolved = this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain, futureProxyId);
+      resolvedDependencies.push(resolved);
+      if (isPromise(resolved)) {
+        hasAsyncDependency = true;
+      }
+    }
+    const instantiate = (deps) => {
+      try {
+        const instance = new classDefinition(...deps);
+        if (this._enableTracing && futureProxyId !== void 0) {
+          return wrapWithProxy(instance, className, parentProxyId, futureProxyId);
+        }
+        return instance;
+      } catch (err) {
+        console.error(`[IOC LoadClass] Error during instantiation of ${className}: ${err.message}`, err.stack);
+        throw err;
+      }
+    };
+    if (!hasAsyncDependency) {
+      const instance = instantiate(resolvedDependencies);
+      if (storageType && storageType !== "transient") {
+        this.setInstance(classDefinition, instance, storageType);
+      }
+      return instance;
+    }
+    const asyncInstance = Promise.all(resolvedDependencies).then((deps) => {
+      const instance = instantiate(deps);
+      if (storageType && storageType !== "transient") {
+        this.setInstance(classDefinition, instance, storageType);
+      }
+      return instance;
+    }).catch((error) => {
       console.error(`[IOC LoadClass] Failed to resolve one or more dependencies for ${className}:`, error);
       if (storageType && this.isRegisteredAsClass(classDefinition)) {
         if (storageType === "singleton") this._classStorageSingleton.delete(classDefinition);
         if (storageType === "scoped") this._classStorageScoped.delete(classDefinition);
       }
       throw error;
-    }).then(async (resolvedDependencies) => {
-      let instancePromise;
-      if (storageType && !this.hasInstance(classDefinition)) {
-        instancePromise = (async () => {
-          try {
-            const instance = new classDefinition(...resolvedDependencies);
-            let wrappedInstance = instance;
-            if (this._enableTracing && futureProxyId !== void 0) {
-              wrappedInstance = wrapWithProxy(instance, className, parentProxyId, futureProxyId);
-            }
-            this.setInstance(classDefinition, wrappedInstance, storageType);
-            return wrappedInstance;
-          } catch (err) {
-            console.error(`[IOC LoadClass] Error during instantiation of ${className}: ${err.message}`, err.stack);
-            if (storageType === "singleton") this._classStorageSingleton.delete(classDefinition);
-            if (storageType === "scoped") this._classStorageScoped.delete(classDefinition);
-            throw err;
-          }
-        })();
-        this.setInstance(classDefinition, instancePromise, storageType);
-      } else {
-        instancePromise = (async () => {
-          try {
-            const instance = new classDefinition(...resolvedDependencies);
-            let wrappedInstance = instance;
-            if (this._enableTracing && futureProxyId !== void 0) {
-              wrappedInstance = wrapWithProxy(instance, className, parentProxyId, futureProxyId);
-            }
-            return wrappedInstance;
-          } catch (err) {
-            console.error(`[IOC LoadClass] Error during instantiation of transient ${className}: ${err.message}`, err.stack);
-            throw err;
-          }
-        })();
-      }
-      return await instancePromise;
     });
     if (storageType && storageType !== "transient") {
-      this.setInstance(classDefinition, finalInstance, storageType);
+      this.setInstance(classDefinition, asyncInstance, storageType);
     }
-    return finalInstance;
+    return asyncInstance;
   }
   loadFunctionInstance(funcLabel, params, resolutionChain) {
     const functionConfig = this._functionDefinition.get(funcLabel);
@@ -366,6 +364,7 @@ function createContainer() {
 }
 export {
   Container,
+  SCOPED_CONTAINER,
   createContainer,
   isPromise
 };

package/dist/framework/implementation/Container.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../framework/implementation/Container.ts"],"sourcesContent":["import 'reflect-metadata'; // Ensure polyfill is loaded conceptually\nimport type { ContainerOptions, IContainerClient, IContainerFunctionDefinition, IContainerSetup } from \"../interface/Container.js\";\nimport { LoadAs } from \"./LoadAs.js\";\nimport { Parameter } from \"./Parameter.js\";\nimport type { ParameterValue } from \"./Parameter.js\";\nimport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError } from \"../errors/ContainerErrors.js\";\nimport {\n    getScope,\n    getComponentOptions, // Use helper\n    getResolvedDependencies // Use helper\n} from './DecoratorSupport'; // Assume helpers exist or create them\nimport { wrapWithProxy, setTraceLogger, reserveProxyId } from \"./ProxyFactory.js\";\nimport * as TraceLoggerModule from \"./TraceLogger.js\";\nimport { TraceCleanup } from \"./TraceCleanup.js\";\n\nenum ContainerRouting {\n    FUNCTIONAL = \"FUNCTIONAL\",\n    CLASS = \"CLASS\"\n    // No need for COMPONENT route, just check metadata if CLASS/FUNCTIONAL fails\n}\n\ntype StorageType = 'singleton' | 'scoped' | 'transient';\n\nexport class Container implements IContainerClient, IContainerSetup {\n    // Routing and definition maps\n    private _routing: Map<any, ContainerRouting> = new Map();\n    private _functionDefinition: Map<any, IContainerFunctionDefinition> = new Map();\n    private _classDefinition: Map<Function, Partial<ContainerOptions>> = new Map();\n\n    // Storage maps\n    private _functionStorageSingleton: Map<any, any> = new Map();\n    private _functionStorageScoped: Map<any, any> = new Map();\n    private _classStorageSingleton: Map<Function, any> = new Map();\n    private _classStorageScoped: Map<Function, any> = new Map();\n\n    // Tracing configuration\n    private _enableTracing: boolean = false;\n    private _traceRetentionMinutes: number = 5;\n\n    // Registration methods\n    registerClass<T>(classDefinition: new (...args: any[]) => T, options?: Partial<ContainerOptions>): void {\n        // Basic validation\n        if (typeof classDefinition !== 'function' || !classDefinition.prototype) {\n             console.warn(`[IOC] Attempted to register non-class: ${String(classDefinition)}`);\n             // Optional: throw error instead?\n             // throw new NotAClassDefinitionError(`Attempted to register non-class: ${String(classDefinition)}`);\n             return; // Don't proceed if not a class constructor\n        }\n\n        // Always clear previous definitions for this exact class constructor\n        this.clearDefinitions(classDefinition);\n\n        // Always set the routing type so 'isClassDefinition' works\n        this._routing.set(classDefinition, ContainerRouting.CLASS);\n\n        // Store manual options *only if they are actually provided and have content*\n        if (options && Object.keys(options).length > 0) {\n            this._classDefinition.set(classDefinition, options);\n            // console.log(`[IOC RegClass] Manually registered ${classDefinition.name} with options:`, options);\n        } else {\n            // console.log(`[IOC RegClass] Manually registered ${classDefinition.name} with no specific options (will use decorators if present).`);\n             // If no options are provided, we don't store anything in _classDefinition,\n             // effectively clearing any previous manual config and letting decorators take over if present.\n        }\n    }\n\n    registerFunction<T extends (...arg: any[]) => any>(label: any, func: T, options: Partial<ContainerOptions> = {} as any): void {\n        this.clearDefinitions(label);\n        this._routing.set(label, ContainerRouting.FUNCTIONAL);\n        this._functionDefinition.set(label, { function: func, options });\n        // console.log(`[IOC RegFunc] Registered function with label ${String(label)} and options:`, options);\n    }\n\n    // Instance resolution methods - Simplify to just call loadInstance\n    instance<T, Args extends any[]>(classDefinition: new (...args: Args) => T, params: ParameterValue<any>[] = []): Promise<T> {\n        // Basic check upfront\n        if (typeof classDefinition !== 'function' || !classDefinition.prototype) {\n             throw new NotAClassDefinitionError(`Cannot resolve instance for non-class: ${String(classDefinition)}`);\n        }\n        return this.loadInstance(classDefinition, params) as Promise<T>;\n    }\n\n    get<T>(label: any, param: ParameterValue<any>[] = []): Promise<T> | T {\n        // Just delegate to loadInstance, which handles routing and auto-registration\n        return this.loadInstance(label, param);\n    }\n\n    extend(): IContainerClient & IContainerSetup {\n        const childContainer = createContainer() as Container;\n\n        // Copy routing and definition maps (share the registration knowledge)\n        childContainer._routing = new Map(this._routing);\n        childContainer._functionDefinition = new Map(this._functionDefinition);\n        childContainer._classDefinition = new Map(this._classDefinition);\n\n        // Share singleton storage (singletons are shared across all containers)\n        childContainer._functionStorageSingleton = this._functionStorageSingleton;\n        childContainer._classStorageSingleton = this._classStorageSingleton;\n\n        // Do NOT share scoped storage (new container = new scope)\n        // Child gets its own empty scoped storage\n\n        // Share tracing configuration\n        childContainer._enableTracing = this._enableTracing;\n        childContainer._traceRetentionMinutes = this._traceRetentionMinutes;\n\n        // console.log('[IOC Extend] Created child container.');\n        return childContainer;\n    }\n\n    // Tracing API\n    setTracingEnabled(enabled: boolean): void {\n        this._enableTracing = enabled;\n        if (enabled && !TraceCleanup.isCleanupRunning()) {\n            // Set the trace logger for the ProxyFactory\n            setTraceLogger(TraceLoggerModule as any);\n            // Start automatic cleanup\n            TraceCleanup.start(this._traceRetentionMinutes);\n        }\n    }\n\n    isTracingEnabled(): boolean {\n        return this._enableTracing;\n    }\n\n    setTraceRetentionMinutes(minutes: number): void {\n        this._traceRetentionMinutes = Math.max(1, minutes);\n    }\n\n    getTraces(retentionMinutes?: number): any[] {\n        const retention = retentionMinutes ?? this._traceRetentionMinutes;\n        return TraceLoggerModule.getRecentTraces(retention);\n    }\n\n    getAllTraces(): any[] {\n        return TraceLoggerModule.getAllTraces();\n    }\n\n    clearTraces(): void {\n        TraceLoggerModule.clearAllTraces();\n    }\n\n    exportTraces(filepath: string): void {\n        const data = TraceLoggerModule.exportTracesToJson();\n        const fs = require('fs');\n        fs.writeFileSync(filepath, JSON.stringify(data, null, 2));\n    }\n\n    getTraceStatistics(): any {\n        return TraceLoggerModule.getTraceStatistics();\n    }\n\n    // Private helper methods\n    private clearDefinitions(label: any): void {\n        this._routing.delete(label);\n        this._functionDefinition.delete(label);\n        // Only delete from classDefinition if the label is actually a function constructor\n        if (typeof label === 'function') {\n            this._classDefinition.delete(label);\n        }\n    }\n\n    // Checks if the label is *currently* registered as a class\n    private isRegisteredAsClass(label: any): boolean {\n        return this._routing.get(label) === ContainerRouting.CLASS;\n    }\n\n     // Checks if the label is *currently* registered as a function\n     private isRegisteredAsFunction(label: any): boolean {\n         return this._routing.get(label) === ContainerRouting.FUNCTIONAL;\n     }\n\n\n    private hasInstance(label: any): boolean {\n        const storageType = this.getStorageType(label); // This checks decorators if needed\n\n        if (!storageType) {\n            // Transient instances are never stored\n            return false;\n        }\n\n        // Determine if it's treated as a class (registered or decorated) *after* getting type\n        const isClass = this.isClassType(label); // Use a helper that checks routing OR decorator\n\n        if (isClass) {\n            return storageType === 'singleton'\n                ? this._classStorageSingleton.has(label)\n                : this._classStorageScoped.has(label);\n        } else { // Must be a function if not a class\n            return storageType === 'singleton'\n                ? this._functionStorageSingleton.has(label)\n                : this._functionStorageScoped.has(label);\n        }\n    }\n\n     // Helper to determine if something should be treated as a class (registered or decorated)\n     private isClassType(label: any): boolean {\n         if (this.isRegisteredAsClass(label)) {\n             return true;\n         }\n         // If not explicitly registered as a class, check if it's a function with @Component\n         if (typeof label === 'function' && label.prototype && !this.isRegisteredAsFunction(label)) {\n              return getComponentOptions(label) !== null;\n         }\n         return false;\n     }\n\n    private getInstance(label: any): any {\n        const storageType = this.getStorageType(label); // Checks decorators if needed\n\n         if (!storageType) {\n             // This should ideally not be reached if called after hasInstance check\n             console.error(`[IOC GetInstance] Attempted to get instance for non-stored type: ${String(label)}`);\n             throw new InstanceNotCreatedError();\n         }\n\n        const isClass = this.isClassType(label); // Check routing OR decorator\n\n        if (isClass) {\n            return storageType === 'singleton'\n                ? this._classStorageSingleton.get(label)\n                : this._classStorageScoped.get(label);\n        } else { // Must be a function\n            return storageType === 'singleton'\n                ? this._functionStorageSingleton.get(label)\n                : this._functionStorageScoped.get(label);\n        }\n    }\n\n    private setInstance(label: any, instance: any, storageType?: StorageType): void { // Made storageType non-optional\n        const isClass = this.isClassType(label); // Determine type based on routing OR decorator\n\n        if (isClass) {\n            if (storageType === 'singleton') {\n                this._classStorageSingleton.set(label, instance);\n            } else if (storageType == 'scoped'){ // storageType === 'scoped'\n                this._classStorageScoped.set(label, instance);\n            }\n        } else { // Must be a function\n            if (storageType === 'singleton') {\n                this._functionStorageSingleton.set(label, instance);\n            } else if(storageType === \"scoped\"){ // storageType === 'scoped'\n                this._functionStorageScoped.set(label, instance);\n            }\n        }\n    }\n\n    private getStorageType(label: any): StorageType {\n        let manualLoadAs: LoadAs | undefined;\n        let decoratorScope: LoadAs | undefined;\n        const isPotentialClass = typeof label === 'function' && label.prototype;\n\n        // Get manual registration options if available\n        if (this.isRegisteredAsClass(label)) { // Use helper\n            manualLoadAs = this._classDefinition.get(label)?.loadAs;\n        } else if (this.isRegisteredAsFunction(label)) { // Use helper\n            manualLoadAs = this._functionDefinition.get(label)?.options?.loadAs;\n        }\n\n        // Get decorator scope only if it's potentially a class *and not explicitly registered as a function*\n        if (isPotentialClass && !this.isRegisteredAsFunction(label)) {\n            decoratorScope = getScope(label); // Uses getComponentOptions internally\n        }\n\n        // Determine final scope: Manual > Decorator > Default (Transient)\n        const finalScope = manualLoadAs ?? decoratorScope ?? LoadAs.Transient;\n\n        if (finalScope === LoadAs.Singleton) {\n            return 'singleton';\n        } else if (finalScope === LoadAs.Scoped) {\n            return 'scoped';\n        }else{\n            return 'transient'; // Transient\n        }\n    }\n\n    // Central resolution logic\n    protected async loadInstance(\n        label: any,\n        params: ParameterValue<any>[] = [],\n        resolutionChain: string[] = [], // Track resolution path\n        parentProxyId?: number // For proxy hierarchy tracking\n    ): Promise<any> {\n\n        // --- Circular Dependency Check ---\n        const currentLabelStr = (typeof label === 'function' && label.name) ? label.name : String(label);\n        if (resolutionChain.includes(currentLabelStr)) {\n            console.error(`[IOC LoadInstance] Circular dependency detected: ${[...resolutionChain, currentLabelStr].join(' -> ')}`);\n            throw new CircularDependencyError([...resolutionChain, currentLabelStr]);\n        }\n        const nextResolutionChain = [...resolutionChain, currentLabelStr];\n        // --- End Circular Dependency Check ---\n\n        // --- Handle Parameters ---\n        if (label instanceof Parameter) {\n            try {\n                // Pass a *copy* of params to avoid side effects in resolveParameterValue\n                return Promise.resolve(this.resolveParameterValue(label, [...params]));\n            } catch (e) {\n                // console.error(`[IOC LoadInstance] Error resolving parameter ${param.toString()}:`, e);\n                return Promise.reject(e);\n            }\n        }\n        // --- End Handle Parameters ---\n\n\n        // --- Check Explicit Registrations ---\n        if (this.isRegisteredAsClass(label)) {\n            // console.log(`[IOC LoadInstance] Resolving explicitly registered class: ${currentLabelStr}`);\n            return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);\n        }\n        if (this.isRegisteredAsFunction(label)) {\n             // console.log(`[IOC LoadInstance] Resolving explicitly registered function: ${currentLabelStr}`);\n            return this.loadFunctionInstance(label, params, nextResolutionChain);\n        }\n        // --- End Check Explicit Registrations ---\n\n\n        // --- Attempt Auto-Registration/Resolution for Decorated Classes ---\n        if (typeof label === 'function' && label.prototype) {\n            const componentOptions = getComponentOptions(label); // Check for @Component\n            if (componentOptions !== null) {\n                 // console.log(`[IOC LoadInstance] Auto-resolving @Component class: ${currentLabelStr}`);\n                // Set routing *now* so subsequent internal checks work correctly\n                if (!this._routing.has(label)) { // Only set if not already set\n                     this._routing.set(label, ContainerRouting.CLASS);\n                     // console.log(`[IOC LoadInstance] Set routing for auto-resolved class: ${currentLabelStr}`);\n                }\n                // Proceed to load it as a class\n                return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);\n            }\n        }\n        // --- End Auto-Registration ---\n\n\n        // --- Dependency Not Found ---\n        console.error(`[IOC LoadInstance] Dependency not found and cannot be resolved: ${currentLabelStr}`);\n        throw new DependencyNotFoundError(currentLabelStr);\n    }\n\n\n    private resolveParameterValue(param: Parameter, params: ParameterValue<any>[]): any { // No mutation\n        // Find the *last* provided value for the parameter\n        const valueContainer = [...params].reverse().find((p) => p.belongsTo(param));\n        if (!valueContainer) {\n             // console.error(`[IOC ResolveParam] Parameter not found: ${param.toString()}`);\n            throw new ParameterNotFoundError(param.toString());\n        }\n        // console.log(`[IOC ResolveParam] Resolved parameter ${param.toString()}`);\n        return valueContainer.value;\n    }\n\n    private loadClassInstance(\n        classDefinition: any, // Should be a class constructor here\n        params: ParameterValue<any>[],\n        resolutionChain: string[],\n        parentProxyId?: number\n    ): Promise<any> {\n        const storageType = this.getStorageType(classDefinition);\n        const className = classDefinition.name || '[Anonymous Class]';\n\n        // Check storage first (handle stored promises)\n        if (storageType && this.hasInstance(classDefinition)) {\n            const instance = this.getInstance(classDefinition);\n            // console.log(`[IOC LoadClass] Found existing ${storageType} instance for ${className}. IsPromise: ${isPromise(instance)}`);\n            return instance\n        }\n         // console.log(`[IOC LoadClass] Creating new ${storageType || 'transient'} instance for ${className}`);\n\n        // --- Determine Dependencies ---\n        const manualOptions = this._classDefinition.get(classDefinition) as ContainerOptions | undefined;\n        let dependenciesToResolve: any[];\n\n        if (manualOptions?.param && Array.isArray(manualOptions.param)) {\n            dependenciesToResolve = manualOptions.param;\n            // console.log(`[IOC LoadClass] Using manual dependencies for ${className}`);\n        } else {\n            // Use decorator-derived dependencies\n            dependenciesToResolve = getResolvedDependencies(classDefinition);\n             // console.log(`[IOC LoadClass] Using decorator/reflected dependencies for ${className}:`, dependenciesToResolve.map(d => typeof d === 'function' ? d.name : String(d)));\n        }\n        // --- End Determine Dependencies ---\n\n        // Reserve a proxy ID if tracing is enabled\n        let futureProxyId: number | undefined;\n        if (this._enableTracing) {\n            futureProxyId = reserveProxyId();\n        }\n\n        // --- Resolve Dependencies ---\n        // Create a *copy* of params to pass down for dependency resolution\n        const paramsCopy = [...params];\n        const resolutionPromises = dependenciesToResolve.map(dependencyIdentifier =>\n            this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain, futureProxyId) // Recursive call handles auto-registration\n        );\n\n        let finalInstance = Promise.all(resolutionPromises)\n        .catch((error)=>{\n            console.error(`[IOC LoadClass] Failed to resolve one or more dependencies for ${className}:`, error);\n            // Clean up potential partially stored promise if this was going to be singleton/scoped\n            if (storageType && this.isRegisteredAsClass(classDefinition)) { // Check if it was actually *being* stored\n                if (storageType === 'singleton') this._classStorageSingleton.delete(classDefinition);\n                if (storageType === 'scoped') this._classStorageScoped.delete(classDefinition);\n            }\n            throw error; // Re-throw dependency resolution error\n        }).then(async(resolvedDependencies)=>{\n            // --- Instantiate Class ---\n            // Store the promise *before* starting instantiation for concurrent requests\n            let instancePromise: Promise<any> | undefined;\n            if (storageType && !this.hasInstance(classDefinition)) { // Check again in case of race condition?\n                // Create the promise wrapper immediately\n                instancePromise = (async () => {\n                    try {\n                        // console.log(`[IOC LoadClass] Instantiating ${className} with ${resolvedDependencies.length} args.`);\n                        const instance = new classDefinition(...resolvedDependencies);\n\n                        // Wrap with proxy if tracing is enabled\n                        let wrappedInstance = instance;\n                        if (this._enableTracing && futureProxyId !== undefined) {\n                            wrappedInstance = wrapWithProxy(instance, className, parentProxyId, futureProxyId);\n                        }\n\n                        // Overwrite the stored promise with the actual instance *after* it's created\n                        this.setInstance(classDefinition, wrappedInstance, storageType); // Use the correct storageType\n                        // console.log(`[IOC LoadClass] Stored actual ${storageType} instance for ${className}`);\n                        return wrappedInstance;\n                    } catch (err: any) {\n                        console.error(`[IOC LoadClass] Error during instantiation of ${className}: ${err.message}`, err.stack);\n                        // Clean up the stored promise on failure\n                        if (storageType === 'singleton') this._classStorageSingleton.delete(classDefinition);\n                        if (storageType === 'scoped') this._classStorageScoped.delete(classDefinition);\n                        throw err; // Re-throw instantiation error\n                    }\n                })();\n                 // console.log(`[IOC LoadClass] Storing promise for concurrent requests (${storageType}) for ${className}`);\n                this.setInstance(classDefinition, instancePromise, storageType);\n            } else {\n                 // If already has instance (from storage check) or is transient, just instantiate directly\n                 instancePromise = (async () => {\n                      try {\n                          // console.log(`[IOC LoadClass] Instantiating transient ${className} with ${resolvedDependencies.length} args.`);\n                           const instance = new classDefinition(...resolvedDependencies);\n\n                           // Wrap with proxy if tracing is enabled\n                           let wrappedInstance = instance;\n                           if (this._enableTracing && futureProxyId !== undefined) {\n                               wrappedInstance = wrapWithProxy(instance, className, parentProxyId, futureProxyId);\n                           }\n\n                           // No storing for transient\n                           return wrappedInstance;\n                      } catch (err: any) {\n                           console.error(`[IOC LoadClass] Error during instantiation of transient ${className}: ${err.message}`, err.stack);\n                           throw err; // Re-throw instantiation error\n                      }\n                 })();\n            }\n            // --- End Instantiate Class ---\n            // Await and return the final instance (either newly created or from the stored promise)\n            return await instancePromise;\n        });\n\n        if(storageType && storageType !== 'transient'){\n            this.setInstance(classDefinition, finalInstance, storageType); // Store the promise\n        }\n        return finalInstance\n    }\n\n    private loadFunctionInstance(\n        funcLabel: any,\n        params: ParameterValue<any>[],\n        resolutionChain: string[]\n    ): Promise<any> { // Always return Promise<any> since this is an async function\n        const functionConfig = this._functionDefinition.get(funcLabel)!; // Assumed to exist by caller\n        const storageType = this.getStorageType(funcLabel); // Only uses manual options for functions\n        const labelStr = String(funcLabel);\n\n        // Check storage first\n        if (storageType && this.hasInstance(funcLabel)) {\n            const instance = this.getInstance(funcLabel);\n            // console.log(`[IOC LoadFunc] Found existing ${storageType} instance for ${labelStr}. IsPromise: ${isPromise(instance)}`);\n            return instance;\n        }\n         // console.log(`[IOC LoadFunc] Creating new ${storageType || 'transient'} instance for ${labelStr}`);\n\n        const ioc_func = functionConfig.function;\n        const options = functionConfig.options;\n        const dependenciesToResolve: any[] = options?.param || [];\n\n        // --- Resolve Dependencies ---\n        const paramsCopy = [...params]; // Create a copy\n        const resolutionPromises = dependenciesToResolve.map(dependencyIdentifier =>\n            this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain)\n        );\n\n        let finalInstance = Promise.all(resolutionPromises).catch((error)=>{\n            console.error(`[IOC LoadFunc] Failed to resolve dependencies for function ${labelStr}:`, error);\n           // Clean up potential partial storage\n           if (storageType && this.isRegisteredAsFunction(funcLabel)) {\n                if (storageType === 'singleton') this._functionStorageSingleton.delete(funcLabel);\n                if (storageType === 'scoped') this._functionStorageScoped.delete(funcLabel);\n           }\n           throw error;\n        }).then(async(resolvedArgs)=>{\n            let instancePromise: Promise<any> | undefined;\n        if (storageType && !this.hasInstance(funcLabel)) {\n             instancePromise = (async () => {\n                 try {\n                     // console.log(`[IOC LoadFunc] Invoking ${labelStr} with ${resolvedArgs.length} args.`);\n                     const result = await ioc_func.apply(null, resolvedArgs); // Await in case function is async\n                     // Overwrite stored promise with actual result\n                     this.setInstance(funcLabel, result, storageType);\n                     // console.log(`[IOC LoadFunc] Stored actual ${storageType} instance for ${labelStr}`);\n                     return result;\n                 } catch (err: any) {\n                     console.error(`[IOC LoadFunc] Error executing function ${labelStr}: ${err.message}`, err.stack);\n                     // Clean up stored promise on failure\n                     if (storageType === 'singleton') this._functionStorageSingleton.delete(funcLabel);\n                     if (storageType === 'scoped') this._functionStorageScoped.delete(funcLabel);\n                     throw err;\n                 }\n             })();\n              // console.log(`[IOC LoadFunc] Storing promise for concurrent requests (${storageType}) for ${labelStr}`);\n             this.setInstance(funcLabel, instancePromise, storageType);\n        } else {\n             // Transient or already resolved from storage check\n             instancePromise = (async () => {\n                  try {\n                     // console.log(`[IOC LoadFunc] Invoking transient ${labelStr} with ${resolvedArgs.length} args.`);\n                      const result = await ioc_func.apply(null, resolvedArgs); // Await in case function is async\n                      // No storing for transient\n                      return result;\n                  } catch (err: any) {\n                      console.error(`[IOC LoadFunc] Error executing transient function ${labelStr}: ${err.message}`, err.stack);\n                      throw err;\n                  }\n             })();\n        }\n        // --- End Invoke Function ---\n\n        return await instancePromise; // Return the final (awaited) result\n        });\n\n        if(storageType && storageType !== 'transient'){\n            this.setInstance(funcLabel, finalInstance, storageType); // Store the promise\n        }\n\n        return finalInstance;\n    }\n}\n\n// Helper functions\nexport function isPromise(obj: any): obj is Promise<any> {\n    // Simplified check - more robust check might be needed depending on environment\n    return !!obj && typeof obj.then === 'function';\n}\n\nexport function createContainer(): IContainerClient & IContainerSetup {\n    return new Container();\n}\n"],"mappings":"AAAA,OAAO;AAEP,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAE1B,SAAS,0BAA0B,wBAAwB,yBAAyB,yBAAyB,+BAA+B;AAC5I;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP,SAAS,eAAe,gBAAgB,sBAAsB;AAC9D,YAAY,uBAAuB;AACnC,SAAS,oBAAoB;AAE7B,IAAK,mBAAL,kBAAKA,sBAAL;AACI,EAAAA,kBAAA,gBAAa;AACb,EAAAA,kBAAA,WAAQ;AAFP,SAAAA;AAAA,GAAA;AAQE,MAAM,UAAuD;AAAA,EAA7D;AAEH;AAAA,SAAQ,WAAuC,oBAAI,IAAI;AACvD,SAAQ,sBAA8D,oBAAI,IAAI;AAC9E,SAAQ,mBAA6D,oBAAI,IAAI;AAG7E;AAAA,SAAQ,4BAA2C,oBAAI,IAAI;AAC3D,SAAQ,yBAAwC,oBAAI,IAAI;AACxD,SAAQ,yBAA6C,oBAAI,IAAI;AAC7D,SAAQ,sBAA0C,oBAAI,IAAI;AAG1D;AAAA,SAAQ,iBAA0B;AAClC,SAAQ,yBAAiC;AAAA;AAAA;AAAA,EAGzC,cAAiB,iBAA4C,SAA2C;AAEpG,QAAI,OAAO,oBAAoB,cAAc,CAAC,gBAAgB,WAAW;AACpE,cAAQ,KAAK,0CAA0C,OAAO,eAAe,CAAC,EAAE;AAGhF;AAAA,IACL;AAGA,SAAK,iBAAiB,eAAe;AAGrC,SAAK,SAAS,IAAI,iBAAiB,mBAAsB;AAGzD,QAAI,WAAW,OAAO,KAAK,OAAO,EAAE,SAAS,GAAG;AAC5C,WAAK,iBAAiB,IAAI,iBAAiB,OAAO;AAAA,IAEtD,OAAO;AAAA,IAIP;AAAA,EACJ;AAAA,EAEA,iBAAmD,OAAY,MAAS,UAAqC,CAAC,GAAgB;AAC1H,SAAK,iBAAiB,KAAK;AAC3B,SAAK,SAAS,IAAI,OAAO,6BAA2B;AACpD,SAAK,oBAAoB,IAAI,OAAO,EAAE,UAAU,MAAM,QAAQ,CAAC;AAAA,EAEnE;AAAA;AAAA,EAGA,SAAgC,iBAA2C,SAAgC,CAAC,GAAe;AAEvH,QAAI,OAAO,oBAAoB,cAAc,CAAC,gBAAgB,WAAW;AACpE,YAAM,IAAI,yBAAyB,0CAA0C,OAAO,eAAe,CAAC,EAAE;AAAA,IAC3G;AACA,WAAO,KAAK,aAAa,iBAAiB,MAAM;AAAA,EACpD;AAAA,EAEA,IAAO,OAAY,QAA+B,CAAC,GAAmB;AAElE,WAAO,KAAK,aAAa,OAAO,KAAK;AAAA,EACzC;AAAA,EAEA,SAA6C;AACzC,UAAM,iBAAiB,gBAAgB;AAGvC,mBAAe,WAAW,IAAI,IAAI,KAAK,QAAQ;AAC/C,mBAAe,sBAAsB,IAAI,IAAI,KAAK,mBAAmB;AACrE,mBAAe,mBAAmB,IAAI,IAAI,KAAK,gBAAgB;AAG/D,mBAAe,4BAA4B,KAAK;AAChD,mBAAe,yBAAyB,KAAK;AAM7C,mBAAe,iBAAiB,KAAK;AACrC,mBAAe,yBAAyB,KAAK;AAG7C,WAAO;AAAA,EACX;AAAA;AAAA,EAGA,kBAAkB,SAAwB;AACtC,SAAK,iBAAiB;AACtB,QAAI,WAAW,CAAC,aAAa,iBAAiB,GAAG;AAE7C,qBAAe,iBAAwB;AAEvC,mBAAa,MAAM,KAAK,sBAAsB;AAAA,IAClD;AAAA,EACJ;AAAA,EAEA,mBAA4B;AACxB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,yBAAyB,SAAuB;AAC5C,SAAK,yBAAyB,KAAK,IAAI,GAAG,OAAO;AAAA,EACrD;AAAA,EAEA,UAAU,kBAAkC;AACxC,UAAM,YAAY,oBAAoB,KAAK;AAC3C,WAAO,kBAAkB,gBAAgB,SAAS;AAAA,EACtD;AAAA,EAEA,eAAsB;AAClB,WAAO,kBAAkB,aAAa;AAAA,EAC1C;AAAA,EAEA,cAAoB;AAChB,sBAAkB,eAAe;AAAA,EACrC;AAAA,EAEA,aAAa,UAAwB;AACjC,UAAM,OAAO,kBAAkB,mBAAmB;AAClD,UAAM,KAAK,QAAQ,IAAI;AACvB,OAAG,cAAc,UAAU,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA,EAC5D;AAAA,EAEA,qBAA0B;AACtB,WAAO,kBAAkB,mBAAmB;AAAA,EAChD;AAAA;AAAA,EAGQ,iBAAiB,OAAkB;AACvC,SAAK,SAAS,OAAO,KAAK;AAC1B,SAAK,oBAAoB,OAAO,KAAK;AAErC,QAAI,OAAO,UAAU,YAAY;AAC7B,WAAK,iBAAiB,OAAO,KAAK;AAAA,IACtC;AAAA,EACJ;AAAA;AAAA,EAGQ,oBAAoB,OAAqB;AAC7C,WAAO,KAAK,SAAS,IAAI,KAAK,MAAM;AAAA,EACxC;AAAA;AAAA,EAGS,uBAAuB,OAAqB;AAChD,WAAO,KAAK,SAAS,IAAI,KAAK,MAAM;AAAA,EACxC;AAAA,EAGO,YAAY,OAAqB;AACrC,UAAM,cAAc,KAAK,eAAe,KAAK;AAE7C,QAAI,CAAC,aAAa;AAEd,aAAO;AAAA,IACX;AAGA,UAAM,UAAU,KAAK,YAAY,KAAK;AAEtC,QAAI,SAAS;AACT,aAAO,gBAAgB,cACjB,KAAK,uBAAuB,IAAI,KAAK,IACrC,KAAK,oBAAoB,IAAI,KAAK;AAAA,IAC5C,OAAO;AACH,aAAO,gBAAgB,cACjB,KAAK,0BAA0B,IAAI,KAAK,IACxC,KAAK,uBAAuB,IAAI,KAAK;AAAA,IAC/C;AAAA,EACJ;AAAA;AAAA,EAGS,YAAY,OAAqB;AACrC,QAAI,KAAK,oBAAoB,KAAK,GAAG;AACjC,aAAO;AAAA,IACX;AAEA,QAAI,OAAO,UAAU,cAAc,MAAM,aAAa,CAAC,KAAK,uBAAuB,KAAK,GAAG;AACtF,aAAO,oBAAoB,KAAK,MAAM;AAAA,IAC3C;AACA,WAAO;AAAA,EACX;AAAA,EAEO,YAAY,OAAiB;AACjC,UAAM,cAAc,KAAK,eAAe,KAAK;AAE5C,QAAI,CAAC,aAAa;AAEd,cAAQ,MAAM,oEAAoE,OAAO,KAAK,CAAC,EAAE;AACjG,YAAM,IAAI,wBAAwB;AAAA,IACtC;AAED,UAAM,UAAU,KAAK,YAAY,KAAK;AAEtC,QAAI,SAAS;AACT,aAAO,gBAAgB,cACjB,KAAK,uBAAuB,IAAI,KAAK,IACrC,KAAK,oBAAoB,IAAI,KAAK;AAAA,IAC5C,OAAO;AACH,aAAO,gBAAgB,cACjB,KAAK,0BAA0B,IAAI,KAAK,IACxC,KAAK,uBAAuB,IAAI,KAAK;AAAA,IAC/C;AAAA,EACJ;AAAA,EAEQ,YAAY,OAAY,UAAe,aAAiC;AAC5E,UAAM,UAAU,KAAK,YAAY,KAAK;AAEtC,QAAI,SAAS;AACT,UAAI,gBAAgB,aAAa;AAC7B,aAAK,uBAAuB,IAAI,OAAO,QAAQ;AAAA,MACnD,WAAW,eAAe,UAAS;AAC/B,aAAK,oBAAoB,IAAI,OAAO,QAAQ;AAAA,MAChD;AAAA,IACJ,OAAO;AACH,UAAI,gBAAgB,aAAa;AAC7B,aAAK,0BAA0B,IAAI,OAAO,QAAQ;AAAA,MACtD,WAAU,gBAAgB,UAAS;AAC/B,aAAK,uBAAuB,IAAI,OAAO,QAAQ;AAAA,MACnD;AAAA,IACJ;AAAA,EACJ;AAAA,EAEQ,eAAe,OAAyB;AAC5C,QAAI;AACJ,QAAI;AACJ,UAAM,mBAAmB,OAAO,UAAU,cAAc,MAAM;AAG9D,QAAI,KAAK,oBAAoB,KAAK,GAAG;AACjC,qBAAe,KAAK,iBAAiB,IAAI,KAAK,GAAG;AAAA,IACrD,WAAW,KAAK,uBAAuB,KAAK,GAAG;AAC3C,qBAAe,KAAK,oBAAoB,IAAI,KAAK,GAAG,SAAS;AAAA,IACjE;AAGA,QAAI,oBAAoB,CAAC,KAAK,uBAAuB,KAAK,GAAG;AACzD,uBAAiB,SAAS,KAAK;AAAA,IACnC;AAGA,UAAM,aAAa,gBAAgB,kBAAkB,OAAO;AAE5D,QAAI,eAAe,OAAO,WAAW;AACjC,aAAO;AAAA,IACX,WAAW,eAAe,OAAO,QAAQ;AACrC,aAAO;AAAA,IACX,OAAK;AACD,aAAO;AAAA,IACX;AAAA,EACJ;AAAA;AAAA,EAGA,MAAgB,aACZ,OACA,SAAgC,CAAC,GACjC,kBAA4B,CAAC,GAC7B,eACY;AAGZ,UAAM,kBAAmB,OAAO,UAAU,cAAc,MAAM,OAAQ,MAAM,OAAO,OAAO,KAAK;AAC/F,QAAI,gBAAgB,SAAS,eAAe,GAAG;AAC3C,cAAQ,MAAM,oDAAoD,CAAC,GAAG,iBAAiB,eAAe,EAAE,KAAK,MAAM,CAAC,EAAE;AACtH,YAAM,IAAI,wBAAwB,CAAC,GAAG,iBAAiB,eAAe,CAAC;AAAA,IAC3E;AACA,UAAM,sBAAsB,CAAC,GAAG,iBAAiB,eAAe;AAIhE,QAAI,iBAAiB,WAAW;AAC5B,UAAI;AAEA,eAAO,QAAQ,QAAQ,KAAK,sBAAsB,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AAAA,MACzE,SAAS,GAAG;AAER,eAAO,QAAQ,OAAO,CAAC;AAAA,MAC3B;AAAA,IACJ;AAKA,QAAI,KAAK,oBAAoB,KAAK,GAAG;AAEjC,aAAO,KAAK,kBAAkB,OAAO,QAAQ,qBAAqB,aAAa;AAAA,IACnF;AACA,QAAI,KAAK,uBAAuB,KAAK,GAAG;AAEpC,aAAO,KAAK,qBAAqB,OAAO,QAAQ,mBAAmB;AAAA,IACvE;AAKA,QAAI,OAAO,UAAU,cAAc,MAAM,WAAW;AAChD,YAAM,mBAAmB,oBAAoB,KAAK;AAClD,UAAI,qBAAqB,MAAM;AAG3B,YAAI,CAAC,KAAK,SAAS,IAAI,KAAK,GAAG;AAC1B,eAAK,SAAS,IAAI,OAAO,mBAAsB;AAAA,QAEpD;AAEA,eAAO,KAAK,kBAAkB,OAAO,QAAQ,qBAAqB,aAAa;AAAA,MACnF;AAAA,IACJ;AAKA,YAAQ,MAAM,mEAAmE,eAAe,EAAE;AAClG,UAAM,IAAI,wBAAwB,eAAe;AAAA,EACrD;AAAA,EAGQ,sBAAsB,OAAkB,QAAoC;AAEhF,UAAM,iBAAiB,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,KAAK,CAAC;AAC3E,QAAI,CAAC,gBAAgB;AAEjB,YAAM,IAAI,uBAAuB,MAAM,SAAS,CAAC;AAAA,IACrD;AAEA,WAAO,eAAe;AAAA,EAC1B;AAAA,EAEQ,kBACJ,iBACA,QACA,iBACA,eACY;AACZ,UAAM,cAAc,KAAK,eAAe,eAAe;AACvD,UAAM,YAAY,gBAAgB,QAAQ;AAG1C,QAAI,eAAe,KAAK,YAAY,eAAe,GAAG;AAClD,YAAM,WAAW,KAAK,YAAY,eAAe;AAEjD,aAAO;AAAA,IACX;AAIA,UAAM,gBAAgB,KAAK,iBAAiB,IAAI,eAAe;AAC/D,QAAI;AAEJ,QAAI,eAAe,SAAS,MAAM,QAAQ,cAAc,KAAK,GAAG;AAC5D,8BAAwB,cAAc;AAAA,IAE1C,OAAO;AAEH,8BAAwB,wBAAwB,eAAe;AAAA,IAEnE;AAIA,QAAI;AACJ,QAAI,KAAK,gBAAgB;AACrB,sBAAgB,eAAe;AAAA,IACnC;AAIA,UAAM,aAAa,CAAC,GAAG,MAAM;AAC7B,UAAM,qBAAqB,sBAAsB;AAAA,MAAI,0BACjD,KAAK,aAAa,sBAAsB,YAAY,iBAAiB,aAAa;AAAA;AAAA,IACtF;AAEA,QAAI,gBAAgB,QAAQ,IAAI,kBAAkB,EACjD,MAAM,CAAC,UAAQ;AACZ,cAAQ,MAAM,kEAAkE,SAAS,KAAK,KAAK;AAEnG,UAAI,eAAe,KAAK,oBAAoB,eAAe,GAAG;AAC1D,YAAI,gBAAgB,YAAa,MAAK,uBAAuB,OAAO,eAAe;AACnF,YAAI,gBAAgB,SAAU,MAAK,oBAAoB,OAAO,eAAe;AAAA,MACjF;AACA,YAAM;AAAA,IACV,CAAC,EAAE,KAAK,OAAM,yBAAuB;AAGjC,UAAI;AACJ,UAAI,eAAe,CAAC,KAAK,YAAY,eAAe,GAAG;AAEnD,2BAAmB,YAAY;AAC3B,cAAI;AAEA,kBAAM,WAAW,IAAI,gBAAgB,GAAG,oBAAoB;AAG5D,gBAAI,kBAAkB;AACtB,gBAAI,KAAK,kBAAkB,kBAAkB,QAAW;AACpD,gCAAkB,cAAc,UAAU,WAAW,eAAe,aAAa;AAAA,YACrF;AAGA,iBAAK,YAAY,iBAAiB,iBAAiB,WAAW;AAE9D,mBAAO;AAAA,UACX,SAAS,KAAU;AACf,oBAAQ,MAAM,iDAAiD,SAAS,KAAK,IAAI,OAAO,IAAI,IAAI,KAAK;AAErG,gBAAI,gBAAgB,YAAa,MAAK,uBAAuB,OAAO,eAAe;AACnF,gBAAI,gBAAgB,SAAU,MAAK,oBAAoB,OAAO,eAAe;AAC7E,kBAAM;AAAA,UACV;AAAA,QACJ,GAAG;AAEH,aAAK,YAAY,iBAAiB,iBAAiB,WAAW;AAAA,MAClE,OAAO;AAEF,2BAAmB,YAAY;AAC1B,cAAI;AAEC,kBAAM,WAAW,IAAI,gBAAgB,GAAG,oBAAoB;AAG5D,gBAAI,kBAAkB;AACtB,gBAAI,KAAK,kBAAkB,kBAAkB,QAAW;AACpD,gCAAkB,cAAc,UAAU,WAAW,eAAe,aAAa;AAAA,YACrF;AAGA,mBAAO;AAAA,UACZ,SAAS,KAAU;AACd,oBAAQ,MAAM,2DAA2D,SAAS,KAAK,IAAI,OAAO,IAAI,IAAI,KAAK;AAC/G,kBAAM;AAAA,UACX;AAAA,QACL,GAAG;AAAA,MACR;AAGA,aAAO,MAAM;AAAA,IACjB,CAAC;AAED,QAAG,eAAe,gBAAgB,aAAY;AAC1C,WAAK,YAAY,iBAAiB,eAAe,WAAW;AAAA,IAChE;AACA,WAAO;AAAA,EACX;AAAA,EAEQ,qBACJ,WACA,QACA,iBACY;AACZ,UAAM,iBAAiB,KAAK,oBAAoB,IAAI,SAAS;AAC7D,UAAM,cAAc,KAAK,eAAe,SAAS;AACjD,UAAM,WAAW,OAAO,SAAS;AAGjC,QAAI,eAAe,KAAK,YAAY,SAAS,GAAG;AAC5C,YAAM,WAAW,KAAK,YAAY,SAAS;AAE3C,aAAO;AAAA,IACX;AAGA,UAAM,WAAW,eAAe;AAChC,UAAM,UAAU,eAAe;AAC/B,UAAM,wBAA+B,SAAS,SAAS,CAAC;AAGxD,UAAM,aAAa,CAAC,GAAG,MAAM;AAC7B,UAAM,qBAAqB,sBAAsB;AAAA,MAAI,0BACjD,KAAK,aAAa,sBAAsB,YAAY,eAAe;AAAA,IACvE;AAEA,QAAI,gBAAgB,QAAQ,IAAI,kBAAkB,EAAE,MAAM,CAAC,UAAQ;AAC/D,cAAQ,MAAM,8DAA8D,QAAQ,KAAK,KAAK;AAE/F,UAAI,eAAe,KAAK,uBAAuB,SAAS,GAAG;AACtD,YAAI,gBAAgB,YAAa,MAAK,0BAA0B,OAAO,SAAS;AAChF,YAAI,gBAAgB,SAAU,MAAK,uBAAuB,OAAO,SAAS;AAAA,MAC/E;AACA,YAAM;AAAA,IACT,CAAC,EAAE,KAAK,OAAM,iBAAe;AACzB,UAAI;AACR,UAAI,eAAe,CAAC,KAAK,YAAY,SAAS,GAAG;AAC5C,2BAAmB,YAAY;AAC3B,cAAI;AAEA,kBAAM,SAAS,MAAM,SAAS,MAAM,MAAM,YAAY;AAEtD,iBAAK,YAAY,WAAW,QAAQ,WAAW;AAE/C,mBAAO;AAAA,UACX,SAAS,KAAU;AACf,oBAAQ,MAAM,2CAA2C,QAAQ,KAAK,IAAI,OAAO,IAAI,IAAI,KAAK;AAE9F,gBAAI,gBAAgB,YAAa,MAAK,0BAA0B,OAAO,SAAS;AAChF,gBAAI,gBAAgB,SAAU,MAAK,uBAAuB,OAAO,SAAS;AAC1E,kBAAM;AAAA,UACV;AAAA,QACJ,GAAG;AAEH,aAAK,YAAY,WAAW,iBAAiB,WAAW;AAAA,MAC7D,OAAO;AAEF,2BAAmB,YAAY;AAC1B,cAAI;AAEA,kBAAM,SAAS,MAAM,SAAS,MAAM,MAAM,YAAY;AAEtD,mBAAO;AAAA,UACX,SAAS,KAAU;AACf,oBAAQ,MAAM,qDAAqD,QAAQ,KAAK,IAAI,OAAO,IAAI,IAAI,KAAK;AACxG,kBAAM;AAAA,UACV;AAAA,QACL,GAAG;AAAA,MACR;AAGA,aAAO,MAAM;AAAA,IACb,CAAC;AAED,QAAG,eAAe,gBAAgB,aAAY;AAC1C,WAAK,YAAY,WAAW,eAAe,WAAW;AAAA,IAC1D;AAEA,WAAO;AAAA,EACX;AACJ;AAGO,SAAS,UAAU,KAA+B;AAErD,SAAO,CAAC,CAAC,OAAO,OAAO,IAAI,SAAS;AACxC;AAEO,SAAS,kBAAsD;AAClE,SAAO,IAAI,UAAU;AACzB;","names":["ContainerRouting"]}
+{"version":3,"sources":["../../../framework/implementation/Container.ts"],"sourcesContent":["import 'reflect-metadata'; // Ensure polyfill is loaded conceptually\nimport type { ContainerOptions, IContainerClient, IContainerFunctionDefinition, IContainerSetup } from \"../interface/Container.js\";\nimport { LoadAs } from \"./LoadAs.js\";\nimport { Parameter } from \"./Parameter.js\";\nimport type { ParameterValue } from \"./Parameter.js\";\nimport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError } from \"../errors/ContainerErrors.js\";\nimport {\n    getScope,\n    getComponentOptions, // Use helper\n    getResolvedDependencies // Use helper\n} from './DecoratorSupport'; // Assume helpers exist or create them\nimport { wrapWithProxy, setTraceLogger, reserveProxyId } from \"./ProxyFactory.js\";\nimport * as TraceLoggerModule from \"./TraceLogger.js\";\nimport { TraceCleanup } from \"./TraceCleanup.js\";\n\n/**\n * A special injection token that resolves to the current scoped container.\n * Use this as a dependency in param arrays to have the container inject itself.\n * This allows provider classes to resolve additional dependencies on demand.\n */\nexport const SCOPED_CONTAINER = Symbol.for(\"ioc:scoped-container\");\n\nenum ContainerRouting {\n    FUNCTIONAL = \"FUNCTIONAL\",\n    CLASS = \"CLASS\"\n    // No need for COMPONENT route, just check metadata if CLASS/FUNCTIONAL fails\n}\n\ntype StorageType = 'singleton' | 'scoped' | 'transient';\n\nexport class Container implements IContainerClient, IContainerSetup {\n    // Routing and definition maps\n    private _routing: Map<any, ContainerRouting> = new Map();\n    private _functionDefinition: Map<any, IContainerFunctionDefinition> = new Map();\n    private _classDefinition: Map<Function, Partial<ContainerOptions>> = new Map();\n\n    // Storage maps\n    private _functionStorageSingleton: Map<any, any> = new Map();\n    private _functionStorageScoped: Map<any, any> = new Map();\n    private _classStorageSingleton: Map<Function, any> = new Map();\n    private _classStorageScoped: Map<Function, any> = new Map();\n\n    // Tracing configuration\n    private _enableTracing: boolean = false;\n    private _traceRetentionMinutes: number = 5;\n\n    // Registration methods\n    registerClass<T>(classDefinition: new (...args: any[]) => T, options?: Partial<ContainerOptions>): void {\n        // Basic validation\n        if (typeof classDefinition !== 'function' || !classDefinition.prototype) {\n             console.warn(`[IOC] Attempted to register non-class: ${String(classDefinition)}`);\n             // Optional: throw error instead?\n             // throw new NotAClassDefinitionError(`Attempted to register non-class: ${String(classDefinition)}`);\n             return; // Don't proceed if not a class constructor\n        }\n\n        // Always clear previous definitions for this exact class constructor\n        this.clearDefinitions(classDefinition);\n\n        // Always set the routing type so 'isClassDefinition' works\n        this._routing.set(classDefinition, ContainerRouting.CLASS);\n\n        // Store manual options *only if they are actually provided and have content*\n        if (options && Object.keys(options).length > 0) {\n            this._classDefinition.set(classDefinition, options);\n            // console.log(`[IOC RegClass] Manually registered ${classDefinition.name} with options:`, options);\n        } else {\n            // console.log(`[IOC RegClass] Manually registered ${classDefinition.name} with no specific options (will use decorators if present).`);\n             // If no options are provided, we don't store anything in _classDefinition,\n             // effectively clearing any previous manual config and letting decorators take over if present.\n        }\n    }\n\n    registerFunction<T extends (...arg: any[]) => any>(label: any, func: T, options: Partial<ContainerOptions> = {} as any): void {\n        this.clearDefinitions(label);\n        this._routing.set(label, ContainerRouting.FUNCTIONAL);\n        this._functionDefinition.set(label, { function: func, options });\n        // console.log(`[IOC RegFunc] Registered function with label ${String(label)} and options:`, options);\n    }\n\n    // Instance resolution methods - Simplify to just call loadInstance\n    instance<T, Sync extends boolean = false>(classDefinition: new (...args: any[]) => T, params: ParameterValue<any>[] = []): Sync extends true ? T : Promise<T> | T {\n        // Basic check upfront\n        if (typeof classDefinition !== 'function' || !classDefinition.prototype) {\n             throw new NotAClassDefinitionError(`Cannot resolve instance for non-class: ${String(classDefinition)}`);\n        }\n        return this.loadInstance(classDefinition, params);\n    }\n\n    get<T, Sync extends boolean = false>(label: any, param: ParameterValue<any>[] = []): Sync extends true ? T : Promise<T> | T {\n        // Just delegate to loadInstance, which handles routing and auto-registration\n        return this.loadInstance(label, param);\n    }\n\n    extend(): IContainerClient & IContainerSetup {\n        const childContainer = createContainer() as Container;\n\n        // Copy routing and definition maps (share the registration knowledge)\n        childContainer._routing = new Map(this._routing);\n        childContainer._functionDefinition = new Map(this._functionDefinition);\n        childContainer._classDefinition = new Map(this._classDefinition);\n\n        // Share singleton storage (singletons are shared across all containers)\n        childContainer._functionStorageSingleton = this._functionStorageSingleton;\n        childContainer._classStorageSingleton = this._classStorageSingleton;\n\n        // Do NOT share scoped storage (new container = new scope)\n        // Child gets its own empty scoped storage\n\n        // Share tracing configuration\n        childContainer._enableTracing = this._enableTracing;\n        childContainer._traceRetentionMinutes = this._traceRetentionMinutes;\n\n        // console.log('[IOC Extend] Created child container.');\n        return childContainer;\n    }\n\n    // Tracing API\n    setTracingEnabled(enabled: boolean): void {\n        this._enableTracing = enabled;\n        if (enabled && !TraceCleanup.isCleanupRunning()) {\n            // Set the trace logger for the ProxyFactory\n            setTraceLogger(TraceLoggerModule as any);\n            // Start automatic cleanup\n            TraceCleanup.start(this._traceRetentionMinutes);\n        }\n    }\n\n    isTracingEnabled(): boolean {\n        return this._enableTracing;\n    }\n\n    setTraceRetentionMinutes(minutes: number): void {\n        this._traceRetentionMinutes = Math.max(1, minutes);\n    }\n\n    getTraces(retentionMinutes?: number): any[] {\n        const retention = retentionMinutes ?? this._traceRetentionMinutes;\n        return TraceLoggerModule.getRecentTraces(retention);\n    }\n\n    getAllTraces(): any[] {\n        return TraceLoggerModule.getAllTraces();\n    }\n\n    clearTraces(): void {\n        TraceLoggerModule.clearAllTraces();\n    }\n\n    exportTraces(filepath: string): void {\n        const data = TraceLoggerModule.exportTracesToJson();\n        const fs = require('fs');\n        fs.writeFileSync(filepath, JSON.stringify(data, null, 2));\n    }\n\n    getTraceStatistics(): any {\n        return TraceLoggerModule.getTraceStatistics();\n    }\n\n    // Private helper methods\n    private clearDefinitions(label: any): void {\n        this._routing.delete(label);\n        this._functionDefinition.delete(label);\n        // Only delete from classDefinition if the label is actually a function constructor\n        if (typeof label === 'function') {\n            this._classDefinition.delete(label);\n        }\n    }\n\n    // Checks if the label is *currently* registered as a class\n    private isRegisteredAsClass(label: any): boolean {\n        return this._routing.get(label) === ContainerRouting.CLASS;\n    }\n\n     // Checks if the label is *currently* registered as a function\n     private isRegisteredAsFunction(label: any): boolean {\n         return this._routing.get(label) === ContainerRouting.FUNCTIONAL;\n     }\n\n\n    private hasInstance(label: any): boolean {\n        const storageType = this.getStorageType(label); // This checks decorators if needed\n\n        if (!storageType) {\n            // Transient instances are never stored\n            return false;\n        }\n\n        // Determine if it's treated as a class (registered or decorated) *after* getting type\n        const isClass = this.isClassType(label); // Use a helper that checks routing OR decorator\n\n        if (isClass) {\n            return storageType === 'singleton'\n                ? this._classStorageSingleton.has(label)\n                : this._classStorageScoped.has(label);\n        } else { // Must be a function if not a class\n            return storageType === 'singleton'\n                ? this._functionStorageSingleton.has(label)\n                : this._functionStorageScoped.has(label);\n        }\n    }\n\n     // Helper to determine if something should be treated as a class (registered or decorated)\n     private isClassType(label: any): boolean {\n         if (this.isRegisteredAsClass(label)) {\n             return true;\n         }\n         // If not explicitly registered as a class, check if it's a function with @Component\n         if (typeof label === 'function' && label.prototype && !this.isRegisteredAsFunction(label)) {\n              return getComponentOptions(label) !== null;\n         }\n         return false;\n     }\n\n    private getInstance(label: any): any {\n        const storageType = this.getStorageType(label); // Checks decorators if needed\n\n         if (!storageType) {\n             // This should ideally not be reached if called after hasInstance check\n             console.error(`[IOC GetInstance] Attempted to get instance for non-stored type: ${String(label)}`);\n             throw new InstanceNotCreatedError();\n         }\n\n        const isClass = this.isClassType(label); // Check routing OR decorator\n\n        if (isClass) {\n            return storageType === 'singleton'\n                ? this._classStorageSingleton.get(label)\n                : this._classStorageScoped.get(label);\n        } else { // Must be a function\n            return storageType === 'singleton'\n                ? this._functionStorageSingleton.get(label)\n                : this._functionStorageScoped.get(label);\n        }\n    }\n\n    private setInstance(label: any, instance: any, storageType?: StorageType): void { // Made storageType non-optional\n        const isClass = this.isClassType(label); // Determine type based on routing OR decorator\n\n        if (isClass) {\n            if (storageType === 'singleton') {\n                this._classStorageSingleton.set(label, instance);\n            } else if (storageType == 'scoped'){ // storageType === 'scoped'\n                this._classStorageScoped.set(label, instance);\n            }\n        } else { // Must be a function\n            if (storageType === 'singleton') {\n                this._functionStorageSingleton.set(label, instance);\n            } else if(storageType === \"scoped\"){ // storageType === 'scoped'\n                this._functionStorageScoped.set(label, instance);\n            }\n        }\n    }\n\n    private getStorageType(label: any): StorageType {\n        let manualLoadAs: LoadAs | undefined;\n        let decoratorScope: LoadAs | undefined;\n        const isPotentialClass = typeof label === 'function' && label.prototype;\n\n        // Get manual registration options if available\n        if (this.isRegisteredAsClass(label)) { // Use helper\n            manualLoadAs = this._classDefinition.get(label)?.loadAs;\n        } else if (this.isRegisteredAsFunction(label)) { // Use helper\n            manualLoadAs = this._functionDefinition.get(label)?.options?.loadAs;\n        }\n\n        // Get decorator scope only if it's potentially a class *and not explicitly registered as a function*\n        if (isPotentialClass && !this.isRegisteredAsFunction(label)) {\n            decoratorScope = getScope(label); // Uses getComponentOptions internally\n        }\n\n        // Determine final scope: Manual > Decorator > Default (Transient)\n        const finalScope = manualLoadAs ?? decoratorScope ?? LoadAs.Transient;\n\n        if (finalScope === LoadAs.Singleton) {\n            return 'singleton';\n        } else if (finalScope === LoadAs.Scoped) {\n            return 'scoped';\n        }else{\n            return 'transient'; // Transient\n        }\n    }\n\n    // Central resolution logic - sync-first, returns T or Promise<T>\n    protected loadInstance(\n        label: any,\n        params: ParameterValue<any>[] = [],\n        resolutionChain: string[] = [], // Track resolution path\n        parentProxyId?: number // For proxy hierarchy tracking\n    ): any {\n\n        // --- Circular Dependency Check ---\n        const currentLabelStr = (typeof label === 'function' && label.name) ? label.name : String(label);\n        if (resolutionChain.includes(currentLabelStr)) {\n            console.error(`[IOC LoadInstance] Circular dependency detected: ${[...resolutionChain, currentLabelStr].join(' -> ')}`);\n            throw new CircularDependencyError([...resolutionChain, currentLabelStr]);\n        }\n        const nextResolutionChain = [...resolutionChain, currentLabelStr];\n        // --- End Circular Dependency Check ---\n\n        // --- Handle Parameters ---\n        if (label instanceof Parameter) {\n            try {\n                // Pass a *copy* of params to avoid side effects in resolveParameterValue\n                return this.resolveParameterValue(label, [...params]);\n            } catch (e) {\n                // console.error(`[IOC LoadInstance] Error resolving parameter ${param.toString()}:`, e);\n                throw e;\n            }\n        }\n        // --- End Handle Parameters ---\n\n        // --- Handle Scoped Container Injection ---\n        if (label === SCOPED_CONTAINER) {\n            return this;\n        }\n        // --- End Handle Scoped Container Injection ---\n\n        // --- Check Explicit Registrations ---\n        if (this.isRegisteredAsClass(label)) {\n            // console.log(`[IOC LoadInstance] Resolving explicitly registered class: ${currentLabelStr}`);\n            return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);\n        }\n        if (this.isRegisteredAsFunction(label)) {\n             // console.log(`[IOC LoadInstance] Resolving explicitly registered function: ${currentLabelStr}`);\n            return this.loadFunctionInstance(label, params, nextResolutionChain);\n        }\n        // --- End Check Explicit Registrations ---\n\n\n        // --- Attempt Auto-Registration/Resolution for Decorated Classes ---\n        if (typeof label === 'function' && label.prototype) {\n            const componentOptions = getComponentOptions(label); // Check for @Component\n            if (componentOptions !== null) {\n                 // console.log(`[IOC LoadInstance] Auto-resolving @Component class: ${currentLabelStr}`);\n                // Set routing *now* so subsequent internal checks work correctly\n                if (!this._routing.has(label)) { // Only set if not already set\n                     this._routing.set(label, ContainerRouting.CLASS);\n                     // console.log(`[IOC LoadInstance] Set routing for auto-resolved class: ${currentLabelStr}`);\n                }\n                // Proceed to load it as a class\n                return this.loadClassInstance(label, params, nextResolutionChain, parentProxyId);\n            }\n        }\n        // --- End Auto-Registration ---\n\n\n        // --- Dependency Not Found ---\n        console.error(`[IOC LoadInstance] Dependency not found and cannot be resolved: ${currentLabelStr}`);\n        throw new DependencyNotFoundError(currentLabelStr);\n    }\n\n\n    private resolveParameterValue(param: Parameter, params: ParameterValue<any>[]): any { // No mutation\n        // Find the *last* provided value for the parameter\n        const valueContainer = [...params].reverse().find((p) => p.belongsTo(param));\n        if (!valueContainer) {\n             // console.error(`[IOC ResolveParam] Parameter not found: ${param.toString()}`);\n            throw new ParameterNotFoundError(param.toString());\n        }\n        // console.log(`[IOC ResolveParam] Resolved parameter ${param.toString()}`);\n        return valueContainer.value;\n    }\n\n    private loadClassInstance(\n        classDefinition: any, // Should be a class constructor here\n        params: ParameterValue<any>[],\n        resolutionChain: string[],\n        parentProxyId?: number\n    ): any {\n        const storageType = this.getStorageType(classDefinition);\n        const className = classDefinition.name || '[Anonymous Class]';\n\n        // Check storage first (may be sync value or Promise)\n        if (storageType && this.hasInstance(classDefinition)) {\n            const instance = this.getInstance(classDefinition);\n            // console.log(`[IOC LoadClass] Found existing ${storageType} instance for ${className}. IsPromise: ${isPromise(instance)}`);\n            return instance;\n        }\n         // console.log(`[IOC LoadClass] Creating new ${storageType || 'transient'} instance for ${className}`);\n\n        // --- Determine Dependencies ---\n        const manualOptions = this._classDefinition.get(classDefinition) as ContainerOptions | undefined;\n        let dependenciesToResolve: any[];\n\n        if (manualOptions?.param && Array.isArray(manualOptions.param)) {\n            dependenciesToResolve = manualOptions.param;\n            // console.log(`[IOC LoadClass] Using manual dependencies for ${className}`);\n        } else {\n            // Use decorator-derived dependencies\n            dependenciesToResolve = getResolvedDependencies(classDefinition);\n             // console.log(`[IOC LoadClass] Using decorator/reflected dependencies for ${className}:`, dependenciesToResolve.map(d => typeof d === 'function' ? d.name : String(d)));\n        }\n        // --- End Determine Dependencies ---\n\n        // Reserve a proxy ID if tracing is enabled\n        let futureProxyId: number | undefined;\n        if (this._enableTracing) {\n            futureProxyId = reserveProxyId();\n        }\n\n        // --- Resolve Dependencies (sync-first) ---\n        const paramsCopy = [...params];\n        const resolvedDependencies: any[] = [];\n        let hasAsyncDependency = false;\n\n        // Resolve each dependency and check if any return Promises\n        for (const dependencyIdentifier of dependenciesToResolve) {\n            const resolved = this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain, futureProxyId);\n            resolvedDependencies.push(resolved);\n            if (isPromise(resolved)) {\n                hasAsyncDependency = true;\n            }\n        }\n\n        // Helper to instantiate the class\n        const instantiate = (deps: any[]): any => {\n            try {\n                const instance = new classDefinition(...deps);\n\n                // Wrap with proxy if tracing is enabled\n                if (this._enableTracing && futureProxyId !== undefined) {\n                    return wrapWithProxy(instance, className, parentProxyId, futureProxyId);\n                }\n                return instance;\n            } catch (err: any) {\n                console.error(`[IOC LoadClass] Error during instantiation of ${className}: ${err.message}`, err.stack);\n                throw err;\n            }\n        };\n\n        // --- Sync Path: All dependencies resolved synchronously ---\n        if (!hasAsyncDependency) {\n            const instance = instantiate(resolvedDependencies);\n\n            // Store if singleton/scoped\n            if (storageType && storageType !== 'transient') {\n                this.setInstance(classDefinition, instance, storageType);\n            }\n            return instance;\n        }\n\n        // --- Async Path: At least one dependency is a Promise ---\n        const asyncInstance = Promise.all(resolvedDependencies)\n            .then((deps) => {\n                const instance = instantiate(deps);\n\n                // Store if singleton/scoped (overwrite the promise with the instance)\n                if (storageType && storageType !== 'transient') {\n                    this.setInstance(classDefinition, instance, storageType);\n                }\n                return instance;\n            })\n            .catch((error) => {\n                console.error(`[IOC LoadClass] Failed to resolve one or more dependencies for ${className}:`, error);\n                // Clean up stored promise on failure\n                if (storageType && this.isRegisteredAsClass(classDefinition)) {\n                    if (storageType === 'singleton') this._classStorageSingleton.delete(classDefinition);\n                    if (storageType === 'scoped') this._classStorageScoped.delete(classDefinition);\n                }\n                throw error;\n            });\n\n        // Store the promise for singleton/scoped to handle concurrent requests\n        if (storageType && storageType !== 'transient') {\n            this.setInstance(classDefinition, asyncInstance, storageType);\n        }\n\n        return asyncInstance;\n    }\n\n    private loadFunctionInstance(\n        funcLabel: any,\n        params: ParameterValue<any>[],\n        resolutionChain: string[]\n    ): Promise<any> { // Always return Promise<any> since this is an async function\n        const functionConfig = this._functionDefinition.get(funcLabel)!; // Assumed to exist by caller\n        const storageType = this.getStorageType(funcLabel); // Only uses manual options for functions\n        const labelStr = String(funcLabel);\n\n        // Check storage first\n        if (storageType && this.hasInstance(funcLabel)) {\n            const instance = this.getInstance(funcLabel);\n            // console.log(`[IOC LoadFunc] Found existing ${storageType} instance for ${labelStr}. IsPromise: ${isPromise(instance)}`);\n            return instance;\n        }\n         // console.log(`[IOC LoadFunc] Creating new ${storageType || 'transient'} instance for ${labelStr}`);\n\n        const ioc_func = functionConfig.function;\n        const options = functionConfig.options;\n        const dependenciesToResolve: any[] = options?.param || [];\n\n        // --- Resolve Dependencies ---\n        const paramsCopy = [...params]; // Create a copy\n        const resolutionPromises = dependenciesToResolve.map(dependencyIdentifier =>\n            this.loadInstance(dependencyIdentifier, paramsCopy, resolutionChain)\n        );\n\n        let finalInstance = Promise.all(resolutionPromises).catch((error)=>{\n            console.error(`[IOC LoadFunc] Failed to resolve dependencies for function ${labelStr}:`, error);\n           // Clean up potential partial storage\n           if (storageType && this.isRegisteredAsFunction(funcLabel)) {\n                if (storageType === 'singleton') this._functionStorageSingleton.delete(funcLabel);\n                if (storageType === 'scoped') this._functionStorageScoped.delete(funcLabel);\n           }\n           throw error;\n        }).then(async(resolvedArgs)=>{\n            let instancePromise: Promise<any> | undefined;\n        if (storageType && !this.hasInstance(funcLabel)) {\n             instancePromise = (async () => {\n                 try {\n                     // console.log(`[IOC LoadFunc] Invoking ${labelStr} with ${resolvedArgs.length} args.`);\n                     const result = await ioc_func.apply(null, resolvedArgs); // Await in case function is async\n                     // Overwrite stored promise with actual result\n                     this.setInstance(funcLabel, result, storageType);\n                     // console.log(`[IOC LoadFunc] Stored actual ${storageType} instance for ${labelStr}`);\n                     return result;\n                 } catch (err: any) {\n                     console.error(`[IOC LoadFunc] Error executing function ${labelStr}: ${err.message}`, err.stack);\n                     // Clean up stored promise on failure\n                     if (storageType === 'singleton') this._functionStorageSingleton.delete(funcLabel);\n                     if (storageType === 'scoped') this._functionStorageScoped.delete(funcLabel);\n                     throw err;\n                 }\n             })();\n              // console.log(`[IOC LoadFunc] Storing promise for concurrent requests (${storageType}) for ${labelStr}`);\n             this.setInstance(funcLabel, instancePromise, storageType);\n        } else {\n             // Transient or already resolved from storage check\n             instancePromise = (async () => {\n                  try {\n                     // console.log(`[IOC LoadFunc] Invoking transient ${labelStr} with ${resolvedArgs.length} args.`);\n                      const result = await ioc_func.apply(null, resolvedArgs); // Await in case function is async\n                      // No storing for transient\n                      return result;\n                  } catch (err: any) {\n                      console.error(`[IOC LoadFunc] Error executing transient function ${labelStr}: ${err.message}`, err.stack);\n                      throw err;\n                  }\n             })();\n        }\n        // --- End Invoke Function ---\n\n        return await instancePromise; // Return the final (awaited) result\n        });\n\n        if(storageType && storageType !== 'transient'){\n            this.setInstance(funcLabel, finalInstance, storageType); // Store the promise\n        }\n\n        return finalInstance;\n    }\n}\n\n// Helper functions\nexport function isPromise(obj: any): obj is Promise<any> {\n    // Simplified check - more robust check might be needed depending on environment\n    return !!obj && typeof obj.then === 'function';\n}\n\nexport function createContainer(): IContainerClient & IContainerSetup {\n    return new Container();\n}\n"],"mappings":"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","names":["ContainerRouting"]}

package/dist/framework/interface/Container.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../framework/interface/Container.ts"],"sourcesContent":["import type { ParameterValue } from \"../implementation/Parameter.cjs\"\r\nimport type { LoadAs } from \"../implementation/LoadAs.cjs\"\r\n\r\nexport interface IContainerClient {\r\n    instance<T, Args extends any[]>(classDefinition: new (...args: Args) => T,params?:ParameterValue<any>[]): Promise<T>\r\n    get<T>(label:any,param?:ParameterValue<any>[]):Promise<T>|T\r\n    extend(): IContainerClient & IContainerSetup\r\n}\r\n\r\n\r\nexport interface IContainerSetup{\r\n    registerClass<T, Args extends any[]>(classDefinition: { new (...args: Args): T }, options?: Partial<ContainerOptions>): void\r\n    registerFunction<T extends (...arg:any[])=>any>(label:any,func: T, options?: ContainerOptions): void\r\n\r\n    // Tracing API\r\n    setTracingEnabled(enabled: boolean): void\r\n    isTracingEnabled(): boolean\r\n    setTraceRetentionMinutes(minutes: number): void\r\n    getTraces(retentionMinutes?: number): any[]\r\n    getAllTraces(): any[]\r\n    clearTraces(): void\r\n    exportTraces(filepath: string): void\r\n    getTraceStatistics(): any\r\n}\r\n\r\n\r\nexport type IContainer = IContainerClient & IContainerSetup\r\n\r\nexport type ContainerOptions = {\r\n    param?: any[]\r\n    loadAs?: LoadAs\r\n}\r\n\r\n\r\nexport interface IContainerFunctionDefinition{\r\n    function:Function\r\n    options:Partial<ContainerOptions>\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../../framework/interface/Container.ts"],"sourcesContent":["import type { ParameterValue } from \"../implementation/Parameter.cjs\"\r\nimport type { LoadAs } from \"../implementation/LoadAs.cjs\"\r\n\r\nexport interface IContainerClient {\r\n    instance<T, Sync extends boolean = false>(classDefinition: new (...args: any[]) => T,params?:ParameterValue<any>[]): Sync extends true ? T : Promise<T> | T\r\n    get<T, Sync extends boolean = false>(label:any,param?:ParameterValue<any>[]):Sync extends true ? T : Promise<T> | T\r\n    extend(): IContainerClient & IContainerSetup\r\n}\r\n\r\n\r\nexport interface IContainerSetup{\r\n    registerClass<T, Args extends any[]>(classDefinition: { new (...args: Args): T }, options?: Partial<ContainerOptions>): void\r\n    registerFunction<T extends (...arg:any[])=>any>(label:any,func: T, options?: ContainerOptions): void\r\n\r\n    // Tracing API\r\n    setTracingEnabled(enabled: boolean): void\r\n    isTracingEnabled(): boolean\r\n    setTraceRetentionMinutes(minutes: number): void\r\n    getTraces(retentionMinutes?: number): any[]\r\n    getAllTraces(): any[]\r\n    clearTraces(): void\r\n    exportTraces(filepath: string): void\r\n    getTraceStatistics(): any\r\n}\r\n\r\n\r\nexport type IContainer = IContainerClient & IContainerSetup\r\n\r\nexport type ContainerOptions = {\r\n    param?: any[]\r\n    loadAs?: LoadAs\r\n}\r\n\r\n\r\nexport interface IContainerFunctionDefinition{\r\n    function:Function\r\n    options:Partial<ContainerOptions>\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/framework/interface/Container.d.cts

@@ -2,8 +2,8 @@ import { ParameterValue } from '../implementation/Parameter.cjs';
 import { LoadAs } from '../implementation/LoadAs.cjs';
 
 interface IContainerClient {
-    instance<T, Args extends any[]>(classDefinition: new (...args: Args) => T, params?: ParameterValue<any>[]): Promise<T>;
-    get<T>(label: any, param?: ParameterValue<any>[]): Promise<T> | T;
+    instance<T, Sync extends boolean = false>(classDefinition: new (...args: any[]) => T, params?: ParameterValue<any>[]): Sync extends true ? T : Promise<T> | T;
+    get<T, Sync extends boolean = false>(label: any, param?: ParameterValue<any>[]): Sync extends true ? T : Promise<T> | T;
     extend(): IContainerClient & IContainerSetup;
 }
 interface IContainerSetup {

package/dist/framework/interface/Container.d.ts

@@ -2,8 +2,8 @@ import { ParameterValue } from '../implementation/Parameter.js';
 import { LoadAs } from '../implementation/LoadAs.js';
 
 interface IContainerClient {
-    instance<T, Args extends any[]>(classDefinition: new (...args: Args) => T, params?: ParameterValue<any>[]): Promise<T>;
-    get<T>(label: any, param?: ParameterValue<any>[]): Promise<T> | T;
+    instance<T, Sync extends boolean = false>(classDefinition: new (...args: any[]) => T, params?: ParameterValue<any>[]): Sync extends true ? T : Promise<T> | T;
+    get<T, Sync extends boolean = false>(label: any, param?: ParameterValue<any>[]): Sync extends true ? T : Promise<T> | T;
     extend(): IContainerClient & IContainerSetup;
 }
 interface IContainerSetup {

package/dist/index.cjs

@@ -28,6 +28,8 @@ __export(index_exports, {
   NotAClassDefinitionError: () => import_ContainerErrors.NotAClassDefinitionError,
   Parameter: () => import_Parameter.Parameter,
   ParameterNotFoundError: () => import_ContainerErrors.ParameterNotFoundError,
+  Provider: () => import_decorators.Provider,
+  SCOPED_CONTAINER: () => import_Container.SCOPED_CONTAINER,
   createContainer: () => import_Container3.createContainer,
   default: () => index_default
 });
@@ -53,6 +55,8 @@ var index_default = import_Container.createContainer;
   NotAClassDefinitionError,
   Parameter,
   ParameterNotFoundError,
+  Provider,
+  SCOPED_CONTAINER,
   createContainer
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts"],"sourcesContent":["import 'reflect-metadata';\nimport { createContainer } from \"./framework/implementation/Container.cjs\"\nimport { Container } from \"./framework/implementation/Container.cjs\"\nimport { LoadAs } from \"./framework/implementation/LoadAs.cjs\"\nimport { Parameter } from \"./framework/implementation/Parameter.cjs\"\nimport type { IContainer, IContainerClient, IContainerSetup } from \"./framework/interface/Container.cjs\"\nimport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError } from \"./framework/errors/ContainerErrors.cjs\"\nimport { Component, Inject } from \"./framework/decorators/index.cjs\"\n\nexport type { IContainer, IContainerClient, IContainerSetup }\nexport { LoadAs }\nexport { Parameter }\nexport { Container }\nexport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError }\nexport { Component, Inject }\nexport { createContainer } from \"./framework/implementation/Container.cjs\"\nexport default createContainer\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8BAAO;AACP,uBAAgC;AAChC,IAAAA,oBAA0B;AAC1B,oBAAuB;AACvB,uBAA0B;AAE1B,6BAA4I;AAC5I,wBAAkC;AAQlC,IAAAA,oBAAgC;AAChC,IAAO,gBAAQ;","names":["import_Container"]}
+{"version":3,"sources":["../index.ts"],"sourcesContent":["import 'reflect-metadata';\nimport { createContainer, SCOPED_CONTAINER } from \"./framework/implementation/Container.cjs\"\nimport { Container } from \"./framework/implementation/Container.cjs\"\nimport { LoadAs } from \"./framework/implementation/LoadAs.cjs\"\nimport { Parameter } from \"./framework/implementation/Parameter.cjs\"\nimport type { IContainer, IContainerClient, IContainerSetup } from \"./framework/interface/Container.cjs\"\nimport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError } from \"./framework/errors/ContainerErrors.cjs\"\nimport { Component, Provider, Inject } from \"./framework/decorators/index.cjs\"\n\nexport type { IContainer, IContainerClient, IContainerSetup }\nexport { LoadAs }\nexport { Parameter }\nexport { Container }\nexport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError }\nexport { Component, Provider, Inject }\nexport { SCOPED_CONTAINER }\nexport { createContainer } from \"./framework/implementation/Container.cjs\"\nexport default createContainer\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8BAAO;AACP,uBAAkD;AAClD,IAAAA,oBAA0B;AAC1B,oBAAuB;AACvB,uBAA0B;AAE1B,6BAA4I;AAC5I,wBAA4C;AAS5C,IAAAA,oBAAgC;AAChC,IAAO,gBAAQ;","names":["import_Container"]}

package/dist/index.d.cts

@@ -1,10 +1,11 @@
 import { createContainer } from './framework/implementation/Container.cjs';
-export { Container } from './framework/implementation/Container.cjs';
+export { Container, SCOPED_CONTAINER } from './framework/implementation/Container.cjs';
 export { LoadAs } from './framework/implementation/LoadAs.cjs';
 export { Parameter } from './framework/implementation/Parameter.cjs';
 export { IContainer, IContainerClient, IContainerSetup } from './framework/interface/Container.cjs';
 export { CircularDependencyError, DependencyNotFoundError, InstanceNotCreatedError, NotAClassDefinitionError, ParameterNotFoundError } from './framework/errors/ContainerErrors.cjs';
 export { Component } from './framework/decorators/Component.cjs';
+export { Provider } from './framework/decorators/Provider.cjs';
 export { Inject } from './framework/decorators/Inject.cjs';
 
 

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 import { createContainer } from './framework/implementation/Container.js';
-export { Container } from './framework/implementation/Container.js';
+export { Container, SCOPED_CONTAINER } from './framework/implementation/Container.js';
 export { LoadAs } from './framework/implementation/LoadAs.js';
 export { Parameter } from './framework/implementation/Parameter.js';
 export { IContainer, IContainerClient, IContainerSetup } from './framework/interface/Container.js';
 export { CircularDependencyError, DependencyNotFoundError, InstanceNotCreatedError, NotAClassDefinitionError, ParameterNotFoundError } from './framework/errors/ContainerErrors.js';
 export { Component } from './framework/decorators/Component.js';
+export { Provider } from './framework/decorators/Provider.js';
 export { Inject } from './framework/decorators/Inject.js';
 
 

package/dist/index.js

@@ -1,10 +1,10 @@
 import "reflect-metadata";
-import { createContainer } from "./framework/implementation/Container.js";
+import { createContainer, SCOPED_CONTAINER } from "./framework/implementation/Container.js";
 import { Container } from "./framework/implementation/Container.js";
 import { LoadAs } from "./framework/implementation/LoadAs.js";
 import { Parameter } from "./framework/implementation/Parameter.js";
 import { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError } from "./framework/errors/ContainerErrors.js";
-import { Component, Inject } from "./framework/decorators/index.js";
+import { Component, Provider, Inject } from "./framework/decorators/index.js";
 import { createContainer as createContainer2 } from "./framework/implementation/Container.js";
 var index_default = createContainer;
 export {
@@ -18,6 +18,8 @@ export {
   NotAClassDefinitionError,
   Parameter,
   ParameterNotFoundError,
+  Provider,
+  SCOPED_CONTAINER,
   createContainer2 as createContainer,
   index_default as default
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts"],"sourcesContent":["import 'reflect-metadata';\nimport { createContainer } from \"./framework/implementation/Container.js\"\nimport { Container } from \"./framework/implementation/Container.js\"\nimport { LoadAs } from \"./framework/implementation/LoadAs.js\"\nimport { Parameter } from \"./framework/implementation/Parameter.js\"\nimport type { IContainer, IContainerClient, IContainerSetup } from \"./framework/interface/Container.js\"\nimport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError } from \"./framework/errors/ContainerErrors.js\"\nimport { Component, Inject } from \"./framework/decorators/index.js\"\n\nexport type { IContainer, IContainerClient, IContainerSetup }\nexport { LoadAs }\nexport { Parameter }\nexport { Container }\nexport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError }\nexport { Component, Inject }\nexport { createContainer } from \"./framework/implementation/Container.js\"\nexport default createContainer\n"],"mappings":"AAAA,OAAO;AACP,SAAS,uBAAuB;AAChC,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAE1B,SAAS,0BAA0B,wBAAwB,yBAAyB,yBAAyB,+BAA+B;AAC5I,SAAS,WAAW,cAAc;AAQlC,SAAS,mBAAAA,wBAAuB;AAChC,IAAO,gBAAQ;","names":["createContainer"]}
+{"version":3,"sources":["../index.ts"],"sourcesContent":["import 'reflect-metadata';\nimport { createContainer, SCOPED_CONTAINER } from \"./framework/implementation/Container.js\"\nimport { Container } from \"./framework/implementation/Container.js\"\nimport { LoadAs } from \"./framework/implementation/LoadAs.js\"\nimport { Parameter } from \"./framework/implementation/Parameter.js\"\nimport type { IContainer, IContainerClient, IContainerSetup } from \"./framework/interface/Container.js\"\nimport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError } from \"./framework/errors/ContainerErrors.js\"\nimport { Component, Provider, Inject } from \"./framework/decorators/index.js\"\n\nexport type { IContainer, IContainerClient, IContainerSetup }\nexport { LoadAs }\nexport { Parameter }\nexport { Container }\nexport { NotAClassDefinitionError, ParameterNotFoundError, DependencyNotFoundError, InstanceNotCreatedError, CircularDependencyError }\nexport { Component, Provider, Inject }\nexport { SCOPED_CONTAINER }\nexport { createContainer } from \"./framework/implementation/Container.js\"\nexport default createContainer\n"],"mappings":"AAAA,OAAO;AACP,SAAS,iBAAiB,wBAAwB;AAClD,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAE1B,SAAS,0BAA0B,wBAAwB,yBAAyB,yBAAyB,+BAA+B;AAC5I,SAAS,WAAW,UAAU,cAAc;AAS5C,SAAS,mBAAAA,wBAAuB;AAChC,IAAO,gBAAQ;","names":["createContainer"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noego/ioc",
-  "version": "0.0.11",
+  "version": "0.2.0",
   "description": "A self contained IoC container for Node.js",
   "type": "module",
   "main": "dist/index.js",

package/readme.md

@@ -10,9 +10,11 @@ A lightweight, flexible Inversion of Control (IoC) container for Node.js and Typ
 - **Class & Function Registration**: Register both classes and functions as dependencies
 - **Parameter Injection**: Inject parameter values at resolution time
 - **Container Extension**: Create child containers that inherit parent registrations
-- **Decorator Support**: Use @Component and @Inject decorators for clean, declarative DI
+- **Container Self-Injection**: Use the provider pattern with `SCOPED_CONTAINER` for dynamic service creation and factories
+- **Decorator Support**: Use @Component, @Provider, and @Inject decorators for clean, declarative DI
 - **TypeScript Support**: Built with full TypeScript support for type safety
-- **Async Resolution**: Support for asynchronous dependency resolution
+- **Sync-First Resolution**: Synchronous resolution when all dependencies are sync, with async fallback when needed
+- **Type-Safe Sync Mode**: Generic `Sync` parameter on `get` and `instance` for compile-time type narrowing
 - **Method Call Tracing**: Automatic tracing of method calls with performance metrics and dependency hierarchies
 - **Trace Analytics**: Export and analyze traces, track statistics, and monitor dependency interactions
 - **Lightweight**: Small footprint with minimal external dependencies
@@ -395,6 +397,21 @@ Manual registration options take precedence over decorators:
 
 This allows you to change behavior at registration time without modifying the decorated class.
 
+### Sync Resolution
+
+By default, `get` and `instance` return `Promise<T> | T`. When your entire dependency graph is synchronous (no async factory functions), the container resolves synchronously. If you know at the call site that resolution will be sync, pass `true` as the second generic parameter to get a narrowed `T` return type:
+
+```typescript
+// Default — returns Promise<T> | T
+const service = container.instance(UserService);
+
+// When you know the dependency graph is sync — returns T
+const service = container.instance<UserService, true>(UserService);
+const logger = container.get<Logger, true>(Logger);
+```
+
+This is purely a compile-time hint — no runtime behavior changes. If a dependency turns out to be async at runtime, you'll get a Promise back regardless of the type annotation.
+
 ### Extending Containers
 
 You can create a child container that inherits all the registrations from the parent but allows overriding:
@@ -414,6 +431,76 @@ childContainer.registerClass(Database, { /* different configuration */ });
 // Child container uses the new registration
 ```
 
+### Provider Pattern with SCOPED_CONTAINER
+
+The `@Provider` decorator creates factory classes that can dynamically resolve dependencies at runtime. Use `@Inject(SCOPED_CONTAINER)` to inject the container itself, enabling polymorphic service creation based on runtime conditions.
+
+```typescript
+import createContainer, { Provider, Inject, SCOPED_CONTAINER, IContainer, Component } from "@noego/ioc";
+
+// Define payment processor implementations
+interface PaymentProcessor {
+  process(amount: number): Promise<string>;
+}
+
+@Component()
+class StripeProcessor implements PaymentProcessor {
+  async process(amount: number) {
+    return `Processed $${amount} via Stripe`;
+  }
+}
+
+@Component()
+class PayPalProcessor implements PaymentProcessor {
+  async process(amount: number) {
+    return `Processed $${amount} via PayPal`;
+  }
+}
+
+// Provider that creates the right processor at runtime
+@Provider()
+class PaymentProcessorFactory {
+  constructor(
+    @Inject(SCOPED_CONTAINER) private container: IContainer
+  ) {}
+
+  async getProcessor(type: 'stripe' | 'paypal'): Promise<PaymentProcessor> {
+    switch (type) {
+      case 'stripe':
+        return this.container.instance(StripeProcessor);
+      case 'paypal':
+        return this.container.instance(PayPalProcessor);
+      default:
+        throw new Error(`Unknown payment processor: ${type}`);
+    }
+  }
+}
+
+// Service that injects the factory and changes behavior at runtime
+@Component()
+class OrderService {
+  constructor(private paymentFactory: PaymentProcessorFactory) {}
+
+  async processOrder(amount: number, paymentMethod: 'stripe' | 'paypal') {
+    // Get the right processor based on runtime parameter
+    const processor = await this.paymentFactory.getProcessor(paymentMethod);
+
+    // Behavior changes based on what the user selected
+    const result = await processor.process(amount);
+    return { success: true, message: result };
+  }
+}
+
+// Usage - behavior determined at runtime
+const container = createContainer();
+const orderService = await container.instance(OrderService);
+
+await orderService.processOrder(100, 'stripe');  // Uses Stripe
+await orderService.processOrder(200, 'paypal');  // Uses PayPal
+```
+
+This pattern is ideal for plugin systems, multi-tenancy, polymorphic services, and any scenario where you need to select implementations based on runtime data. The `@Provider` decorator defaults to `Scoped` lifetime, making instances scoped per container context.
+
 ### Method Call Tracing and Monitoring
 
 The container supports automatic tracing of method calls on resolved instances. This is useful for debugging, monitoring, and understanding dependency interactions in your application.
@@ -539,8 +626,8 @@ await service.getUsers();
 - `createContainer()`: Creates a new IoC container
 - `registerClass<T>(classDefinition, options?)`: Register a class
 - `registerFunction(label, function, options?)`: Register a function
-- `instance<T>(classDefinition, params?)`: Resolve a class instance
-- `get<T>(label, params?)`: Resolve a dependency by key
+- `instance<T, Sync>(classDefinition, params?)`: Resolve a class instance. Pass `Sync = true` for sync type narrowing
+- `get<T, Sync>(label, params?)`: Resolve a dependency by key. Pass `Sync = true` for sync type narrowing
 - `extend()`: Create a child container
 - `setTracingEnabled(enabled: boolean)`: Enable/disable method call tracing
 - `isTracingEnabled(): boolean`: Check if tracing is enabled
@@ -553,7 +640,8 @@ await service.getUsers();
 
 ### Decorators
 
-- `@Component(options?)`: Mark a class as container-managed
+- `@Component(options?)`: Mark a class as container-managed (defaults to Transient scope)
+- `@Provider(options?)`: Mark a class as a provider (defaults to Scoped scope, ideal for factories)
 - `@Inject(token)`: Specify a token for a constructor parameter
 
 ### Options
@@ -580,6 +668,10 @@ enum LoadAs {
 - `Parameter.create()`: Create a new parameter
 - `parameter.value(value)`: Create a parameter value
 
+### Injectable Tokens
+
+- `SCOPED_CONTAINER`: A special injection token that resolves to the current container instance. Use this in parameter arrays or with `@Inject` to enable the provider pattern and dynamic dependency resolution.
+
 ### Component Options
 
 ```typescript