@brianmcd/di 0.0.1

package/dist/cjs/lib/container-builder.js

@@ -0,0 +1,283 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContainerBuilder = void 0;
+const container_js_1 = require("./container.js");
+const scope_js_1 = require("./types/scope.js");
+const token_to_string_js_1 = require("./utils/token-to-string.js");
+/**
+ * ContainerBuilder is the class you use to configure a Container.
+ *
+ * The ContainerBuilder has 2 main responsibilities:
+ *   1. Collect all provider registrations, which can be defined in any order.
+ *     - Handled by register* methods.
+ *   2. Instantiate instances and register them in a new Container.
+ *     - Handled by `.build()`.
+ *
+ * The ContainerBuilder does a topological sort to ensure that instances are created and destroyed
+ * in the correct order (e.g. all of a providers dependencies must be created before that
+ * provider's instance can be created, and destruction needs to happen in the opposite order).
+ */
+class ContainerBuilder {
+    registrations = new Map();
+    /**
+     * Register a static value.
+     */
+    registerValue(token, value) {
+        this.addRegistration(token, { type: 'value', scope: scope_js_1.Scope.Singleton, token, value });
+        return this;
+    }
+    /**
+     * Register a class with static deps property.
+     * Dependencies are resolved automatically during build().
+     * Type safety between the deps array and constructor params is enforced at this method.
+     */
+    registerClass(Class, options) {
+        const token = Class;
+        this.addRegistration(token, {
+            type: 'class',
+            scope: options?.scope ?? scope_js_1.Scope.Singleton,
+            token,
+            Class,
+            deps: Class.deps,
+        });
+        return this;
+    }
+    /**
+     * Register a factory provider, which can be async or sync and can inject other dependencies.
+     */
+    registerFactory(provider, options) {
+        const token = provider.provide;
+        this.addRegistration(token, {
+            type: 'factory',
+            scope: options?.scope ?? scope_js_1.Scope.Singleton,
+            token,
+            provider,
+            deps: provider.deps,
+        });
+        return this;
+    }
+    /**
+     * Merge providers from another container.
+     *
+     * This is useful for creating standalone packages/libraries that export a ContainerBuilder.
+     * You can use `merge` to bring these standalone packages together into a single Container.
+     */
+    merge(other) {
+        for (const [token, registration] of other.registrations) {
+            this.addRegistration(token, registration);
+        }
+        return this;
+    }
+    /**
+     * Override an existing provider with a value; intended for mocking during tests.
+     */
+    override(token, value) {
+        if (!this.registrations.has(token)) {
+            throw new Error(`Cannot override: ${(0, token_to_string_js_1.tokenToString)(token)} is not registered`);
+        }
+        this.registrations.set(token, { type: 'value', scope: scope_js_1.Scope.Singleton, token, value });
+        return this;
+    }
+    /**
+     * Build the container - topologically sorts providers and instantiates singletons.
+     * Scoped providers are validated but not instantiated - they're stored for later use in Scopes.
+     * By default, also initializes the container (calls onInit on all services).
+     */
+    async build(options) {
+        const sorted = this.topologicalSort();
+        // Build the state that Container needs
+        const state = {
+            instances: new Map(),
+            factoryProviders: new Map(),
+            valueProviders: new Set(),
+            initOrder: [],
+            scopedClassProviders: new Map(),
+            scopedFactoryProviders: new Map(),
+        };
+        for (const token of sorted) {
+            const registration = this.registrations.get(token);
+            switch (registration.type) {
+                case 'value': {
+                    state.instances.set(token, registration.value);
+                    state.valueProviders.add(token);
+                    state.initOrder.push(token);
+                    break;
+                }
+                case 'class': {
+                    if (registration.scope === scope_js_1.Scope.Scoped) {
+                        // Store registration data for scope creation - don't instantiate
+                        state.scopedClassProviders.set(token, {
+                            Class: registration.Class,
+                            deps: registration.deps,
+                        });
+                    }
+                    else {
+                        const resolvedDeps = this.resolveDeps(registration.deps, state.instances);
+                        const instance = new registration.Class(...resolvedDeps);
+                        state.instances.set(token, instance);
+                        state.initOrder.push(token);
+                    }
+                    break;
+                }
+                case 'factory': {
+                    if (registration.scope === scope_js_1.Scope.Scoped) {
+                        // Store registration data for scope creation - don't instantiate
+                        state.scopedFactoryProviders.set(token, registration.provider);
+                    }
+                    else {
+                        const resolvedDeps = this.resolveDeps(registration.deps, state.instances);
+                        const instance = await registration.provider.factory(...resolvedDeps);
+                        state.instances.set(token, instance);
+                        state.factoryProviders.set(token, registration.provider);
+                        state.initOrder.push(token);
+                    }
+                    break;
+                }
+            }
+        }
+        const container = new container_js_1.Container(state);
+        if (options?.init !== false) {
+            await container.init();
+        }
+        return container;
+    }
+    /**
+     * Topologically sort providers by their dependencies using Kahn's algorithm.
+     *
+     * This ensures that dependent providers are created and initialized BEFORE the providers that
+     * depend on them, and that dependent providers are destroyed AFTER providers that depend on them.
+     *
+     * Also validates that singleton providers do not depend on scoped providers.
+     */
+    topologicalSort() {
+        // inDegree tracks the number of dependencies a given token has.
+        const inDegree = new Map();
+        const dependents = new Map();
+        // Initialize all nodes.
+        for (const token of this.registrations.keys()) {
+            inDegree.set(token, 0);
+            dependents.set(token, new Set());
+        }
+        // Build graph edges (dependents and inDegree maps).
+        for (const [token, registration] of this.registrations) {
+            if (!('deps' in registration)) {
+                continue;
+            }
+            for (const dep of registration.deps) {
+                if (!this.registrations.has(dep)) {
+                    const dependent = (0, token_to_string_js_1.tokenToString)(token);
+                    const dependency = (0, token_to_string_js_1.tokenToString)(dep);
+                    throw new Error(`Missing dependency: ${dependent} depends on ${dependency}, which is not registered`);
+                }
+                // Validate: singleton cannot depend on scoped
+                const depRegistration = this.registrations.get(dep);
+                if (this.isSingleton(registration) && this.isScoped(depRegistration)) {
+                    throw new Error(`Invalid dependency: singleton ${(0, token_to_string_js_1.tokenToString)(token)} cannot depend on scoped ${(0, token_to_string_js_1.tokenToString)(dep)}`);
+                }
+                // dep -> token (token depends on dep)
+                dependents.get(dep).add(token);
+                inDegree.set(token, (inDegree.get(token) ?? 0) + 1);
+            }
+        }
+        // Start with nodes that have no dependencies
+        const queue = [];
+        for (const [token, degree] of inDegree) {
+            if (degree === 0) {
+                queue.push(token);
+            }
+        }
+        const sorted = [];
+        // Iteratively push tokens that have no unsorted dependencies to the sorted list.
+        // When a token is pushed, we reduce the inDegree for any dependent providers.
+        while (queue.length > 0) {
+            const current = queue.shift();
+            sorted.push(current);
+            // Reduce in-degree of dependents.
+            for (const dependent of dependents.get(current) ?? []) {
+                const newDegree = (inDegree.get(dependent) ?? 0) - 1;
+                inDegree.set(dependent, newDegree);
+                if (newDegree === 0) {
+                    queue.push(dependent);
+                }
+            }
+        }
+        // Check for circular dependencies.
+        if (sorted.length !== this.registrations.size) {
+            const cyclePath = this.findCyclePath();
+            const cycleStr = cyclePath.map((t) => (0, token_to_string_js_1.tokenToString)(t)).join(' -> ');
+            throw new Error(`Circular dependency detected: ${cycleStr}`);
+        }
+        return sorted;
+    }
+    /**
+     * Find a cycle path using DFS with coloring.
+     * Returns the cycle as an array of tokens ending with the repeated token.
+     */
+    findCyclePath() {
+        const WHITE = 0; // Unvisited
+        const GRAY = 1; // Currently visiting (in stack)
+        const BLACK = 2; // Finished visiting
+        const color = new Map();
+        for (const token of this.registrations.keys()) {
+            color.set(token, WHITE);
+        }
+        const path = [];
+        const dfs = (token) => {
+            color.set(token, GRAY);
+            path.push(token);
+            const registration = this.registrations.get(token);
+            const deps = registration && 'deps' in registration ? registration.deps : [];
+            for (const dep of deps) {
+                if (color.get(dep) === GRAY) {
+                    // Found cycle - return path from dep to current + dep again
+                    const cycleStart = path.indexOf(dep);
+                    return [...path.slice(cycleStart), dep];
+                }
+                if (color.get(dep) === WHITE) {
+                    const cycle = dfs(dep);
+                    if (cycle) {
+                        return cycle;
+                    }
+                }
+            }
+            color.set(token, BLACK);
+            path.pop();
+            return null;
+        };
+        for (const token of this.registrations.keys()) {
+            if (color.get(token) === WHITE) {
+                const cycle = dfs(token);
+                if (cycle) {
+                    return cycle;
+                }
+            }
+        }
+        return []; // Should not reach here if called after detecting a cycle
+    }
+    addRegistration(token, registration) {
+        if (this.registrations.has(token)) {
+            throw new Error(`Token already registered: ${(0, token_to_string_js_1.tokenToString)(token)}`);
+        }
+        this.registrations.set(token, registration);
+    }
+    isScoped(registration) {
+        return registration.scope === scope_js_1.Scope.Scoped;
+    }
+    isSingleton(registration) {
+        return registration.scope === scope_js_1.Scope.Singleton;
+    }
+    /**
+     * Resolve dependencies from the instances map.
+     */
+    resolveDeps(deps, instances) {
+        return deps.map((dep) => {
+            const instance = instances.get(dep);
+            if (instance === undefined) {
+                throw new Error(`Dependency not found: ${(0, token_to_string_js_1.tokenToString)(dep)}`);
+            }
+            return instance;
+        });
+    }
+}
+exports.ContainerBuilder = ContainerBuilder;
+//# sourceMappingURL=container-builder.js.map

package/dist/cjs/lib/container-builder.js.map

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

package/dist/cjs/lib/container.d.ts

@@ -0,0 +1,52 @@
+import type { FactoryProvider } from './types/factory-provider.js';
+import type { InjectableClass } from './types/injectable-class.js';
+import type { Token } from './types/tokens.js';
+import { ScopedContainer } from './scoped-container.js';
+/**
+ * Data for a scoped class registration.
+ */
+export interface ScopedClassData<T = unknown> {
+    Class: InjectableClass<T>;
+    deps: readonly Token<unknown>[];
+}
+/**
+ * Data required to construct a Container.
+ * This is the "state" that ContainerBuilder prepares.
+ */
+export interface ContainerState {
+    instances: Map<Token<unknown>, unknown>;
+    factoryProviders: Map<Token<unknown>, FactoryProvider<any, any, any>>;
+    valueProviders: Set<Token<unknown>>;
+    initOrder: Token<unknown>[];
+    scopedClassProviders: Map<Token<unknown>, ScopedClassData>;
+    scopedFactoryProviders: Map<Token<unknown>, FactoryProvider<any, any, any>>;
+}
+export declare class Container {
+    private readonly instances;
+    private readonly factoryProviders;
+    private readonly valueProviders;
+    private readonly initOrder;
+    private readonly scopedClassProviders;
+    private readonly scopedFactoryProviders;
+    private isInitialized;
+    constructor(state: ContainerState);
+    /**
+     * Get an instance by its token.
+     */
+    get<T>(token: Token<T>): T;
+    /**
+     * Create a new scoped container for scoped instances.
+     * Scoped instances are created on-demand within the container and destroyed when the scoped container is destroyed.
+     */
+    createScope(): ScopedContainer;
+    /**
+     * Initialize all instances - calls onInit() in topological order (dependencies before dependents).
+     * Only class-registered instances have onInit called (not values or factories).
+     */
+    init(): Promise<void>;
+    /**
+     * Destroy all instances - calls onDestroy() in reverse topological order (dependents before dependencies).
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=container.d.ts.map

package/dist/cjs/lib/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../src/lib/container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAKxD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,SAAS,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACxC,gBAAgB,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACtE,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IAE5B,oBAAoB,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC;IAC3D,sBAAsB,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;CAC7E;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsD;IACvF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuC;IAC5E,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAsD;IAC7F,OAAO,CAAC,aAAa,CAAS;gBAEX,KAAK,EAAE,cAAc;IASxC;;OAEG;IACI,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IAWjC;;;OAGG;IACI,WAAW,IAAI,eAAe;IAQrC;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBlC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAiDtC"}

package/dist/cjs/lib/container.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Container = void 0;
+const scoped_container_js_1 = require("./scoped-container.js");
+const has_on_destroy_js_1 = require("./utils/has-on-destroy.js");
+const has_on_init_js_1 = require("./utils/has-on-init.js");
+const token_to_string_js_1 = require("./utils/token-to-string.js");
+class Container {
+    instances;
+    factoryProviders;
+    valueProviders;
+    initOrder;
+    scopedClassProviders;
+    scopedFactoryProviders;
+    isInitialized = false;
+    constructor(state) {
+        this.instances = state.instances;
+        this.factoryProviders = state.factoryProviders;
+        this.valueProviders = state.valueProviders;
+        this.initOrder = state.initOrder;
+        this.scopedClassProviders = state.scopedClassProviders;
+        this.scopedFactoryProviders = state.scopedFactoryProviders;
+    }
+    /**
+     * Get an instance by its token.
+     */
+    get(token) {
+        if (!this.isInitialized) {
+            throw new Error('Container not initialized. Call init() before getting instances.');
+        }
+        const instance = this.instances.get(token);
+        if (instance === undefined) {
+            throw new Error(`Token not registered: ${(0, token_to_string_js_1.tokenToString)(token)}`);
+        }
+        return instance;
+    }
+    /**
+     * Create a new scoped container for scoped instances.
+     * Scoped instances are created on-demand within the container and destroyed when the scoped container is destroyed.
+     */
+    createScope() {
+        return new scoped_container_js_1.ScopedContainer(this.instances, this.scopedClassProviders, this.scopedFactoryProviders);
+    }
+    /**
+     * Initialize all instances - calls onInit() in topological order (dependencies before dependents).
+     * Only class-registered instances have onInit called (not values or factories).
+     */
+    async init() {
+        if (this.isInitialized) {
+            throw new Error('Container already initialized');
+        }
+        for (const token of this.initOrder) {
+            // Skip externally-managed instances (values and factories)
+            if (this.valueProviders.has(token) || this.factoryProviders.has(token)) {
+                continue;
+            }
+            const instance = this.instances.get(token);
+            if ((0, has_on_init_js_1.hasOnInit)(instance)) {
+                await instance.onInit();
+            }
+        }
+        this.isInitialized = true;
+    }
+    /**
+     * Destroy all instances - calls onDestroy() in reverse topological order (dependents before dependencies).
+     */
+    async destroy() {
+        const errors = [];
+        for (const token of [...this.initOrder].reverse()) {
+            const factoryProvider = this.factoryProviders.get(token);
+            try {
+                // There's an important nuance here: if an instance was provided via a factory or value,
+                // then we don't want invoke onDestroy on the instance, even if it exists. There could be a
+                // scenario where a factory is providing an instance of a third party dependency, and that
+                // third party may happen to have an `onDestroy` method. We don't want to blindly invoke
+                // that `onDestroy`, so if an instance was provided via a factory, we never check for an
+                // `onDestroy` on that instance.
+                if (factoryProvider) {
+                    if (factoryProvider?.onDestroy) {
+                        const hookDeps = factoryProvider.onDestroy.deps ?? [];
+                        const resolvedDeps = hookDeps.map((d) => this.get(d));
+                        await factoryProvider.onDestroy.handler(...resolvedDeps);
+                    }
+                    continue;
+                }
+                // Skip value-provided instances - they are externally managed.
+                if (this.valueProviders.has(token)) {
+                    continue;
+                }
+                // Only class-registered instances get onDestroy called.
+                const instance = this.instances.get(token);
+                if ((0, has_on_destroy_js_1.hasOnDestroy)(instance)) {
+                    await instance.onDestroy();
+                }
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        this.instances.clear();
+        this.factoryProviders.clear();
+        this.valueProviders.clear();
+        this.initOrder.length = 0;
+        this.scopedClassProviders.clear();
+        this.scopedFactoryProviders.clear();
+        this.isInitialized = false;
+        if (errors.length > 0) {
+            throw new AggregateError(errors, 'Errors during container destruction');
+        }
+    }
+}
+exports.Container = Container;
+//# sourceMappingURL=container.js.map

package/dist/cjs/lib/container.js.map

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

package/dist/cjs/lib/scoped-container.d.ts

@@ -0,0 +1,36 @@
+import type { FactoryProvider } from './types/factory-provider.js';
+import type { Token } from './types/tokens.js';
+import type { ScopedClassData } from './container.js';
+/**
+ * A ScopedContainer represents a context for scoped instances.
+ * Scoped instances are created on-demand and cached within this container.
+ * When the scoped container is destroyed, all scoped instances are cleaned up.
+ */
+export declare class ScopedContainer {
+    private readonly parentInstances;
+    private readonly scopedClassProviders;
+    private readonly scopedFactoryProviders;
+    private readonly instances;
+    private readonly creationOrder;
+    private _isDestroyed;
+    constructor(parentInstances: Map<Token<unknown>, unknown>, scopedClassProviders: Map<Token<unknown>, ScopedClassData>, scopedFactoryProviders: Map<Token<unknown>, FactoryProvider<any, any, any>>);
+    get isDestroyed(): boolean;
+    /**
+     * Get an instance by its token.
+     * - For scoped tokens: creates/caches instance within this scope
+     * - For singleton tokens: returns instance from parent container
+     */
+    get<T>(token: Token<T>): Promise<T>;
+    /**
+     * Calls onDestroy on all created instances in reverse creation order.
+     */
+    destroy(): Promise<void>;
+    private createScopedClassInstance;
+    private createScopedFactoryInstance;
+    /**
+     * Internal resolution logic shared by get() and dependency resolution.
+     * Does not check if scope is destroyed - caller must handle that.
+     */
+    private resolve;
+}
+//# sourceMappingURL=scoped-container.d.ts.map

package/dist/cjs/lib/scoped-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-container.d.ts","sourceRoot":"","sources":["../../../src/lib/scoped-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtD;;;;GAIG;AACH,qBAAa,eAAe;IAMxB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAPzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,YAAY,CAAS;gBAGV,eAAe,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAC7C,oBAAoB,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,EAC1D,sBAAsB,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAG9F,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;;OAIG;IACU,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAOhD;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YA0CvB,yBAAyB;YAgBzB,2BAA2B;IAazC;;;OAGG;YACW,OAAO;CAuBtB"}

package/dist/cjs/lib/scoped-container.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopedContainer = void 0;
+const has_on_destroy_js_1 = require("./utils/has-on-destroy.js");
+const has_on_init_js_1 = require("./utils/has-on-init.js");
+const token_to_string_js_1 = require("./utils/token-to-string.js");
+/**
+ * A ScopedContainer represents a context for scoped instances.
+ * Scoped instances are created on-demand and cached within this container.
+ * When the scoped container is destroyed, all scoped instances are cleaned up.
+ */
+class ScopedContainer {
+    parentInstances;
+    scopedClassProviders;
+    scopedFactoryProviders;
+    instances = new Map();
+    creationOrder = [];
+    _isDestroyed = false;
+    constructor(parentInstances, scopedClassProviders, scopedFactoryProviders) {
+        this.parentInstances = parentInstances;
+        this.scopedClassProviders = scopedClassProviders;
+        this.scopedFactoryProviders = scopedFactoryProviders;
+    }
+    get isDestroyed() {
+        return this._isDestroyed;
+    }
+    /**
+     * Get an instance by its token.
+     * - For scoped tokens: creates/caches instance within this scope
+     * - For singleton tokens: returns instance from parent container
+     */
+    async get(token) {
+        if (this._isDestroyed) {
+            throw new Error('Scope has been destroyed');
+        }
+        return this.resolve(token);
+    }
+    /**
+     * Calls onDestroy on all created instances in reverse creation order.
+     */
+    async destroy() {
+        if (this._isDestroyed) {
+            return;
+        }
+        this._isDestroyed = true;
+        const errors = [];
+        // Destroy in reverse creation order
+        for (const token of [...this.creationOrder].reverse()) {
+            try {
+                // Check if it was a scoped factory with onDestroy hook
+                const factoryProvider = this.scopedFactoryProviders.get(token);
+                if (factoryProvider?.onDestroy) {
+                    const hookDeps = factoryProvider.onDestroy.deps ?? [];
+                    const resolvedDeps = await Promise.all(hookDeps.map((dep) => this.resolve(dep)));
+                    await factoryProvider.onDestroy.handler(...resolvedDeps);
+                    continue;
+                }
+                // For scoped class instances, call onDestroy if implemented
+                const instance = this.instances.get(token);
+                if ((0, has_on_destroy_js_1.hasOnDestroy)(instance)) {
+                    await instance.onDestroy();
+                }
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        this.instances.clear();
+        this.creationOrder.length = 0;
+        if (errors.length > 0) {
+            throw new AggregateError(errors, 'Errors during scope destruction');
+        }
+    }
+    async createScopedClassInstance(token) {
+        const registration = this.scopedClassProviders.get(token);
+        const resolvedDeps = await Promise.all(registration.deps.map((dep) => this.resolve(dep)));
+        const instance = new registration.Class(...resolvedDeps);
+        this.instances.set(token, instance);
+        this.creationOrder.push(token);
+        // Call onInit if implemented
+        if ((0, has_on_init_js_1.hasOnInit)(instance)) {
+            await instance.onInit();
+        }
+        return instance;
+    }
+    async createScopedFactoryInstance(token) {
+        const provider = this.scopedFactoryProviders.get(token);
+        const resolvedDeps = await Promise.all(provider.deps.map((dep) => this.resolve(dep)));
+        const instance = await provider.factory(...resolvedDeps);
+        this.instances.set(token, instance);
+        this.creationOrder.push(token);
+        return instance;
+    }
+    /**
+     * Internal resolution logic shared by get() and dependency resolution.
+     * Does not check if scope is destroyed - caller must handle that.
+     */
+    async resolve(token) {
+        // Check if already cached in this scope
+        if (this.instances.has(token)) {
+            return this.instances.get(token);
+        }
+        // Check if it's a scoped class
+        if (this.scopedClassProviders.has(token)) {
+            return this.createScopedClassInstance(token);
+        }
+        // Check if it's a scoped factory
+        if (this.scopedFactoryProviders.has(token)) {
+            return this.createScopedFactoryInstance(token);
+        }
+        // Fall back to parent container
+        if (this.parentInstances.has(token)) {
+            return this.parentInstances.get(token);
+        }
+        throw new Error(`Token not registered: ${(0, token_to_string_js_1.tokenToString)(token)}`);
+    }
+}
+exports.ScopedContainer = ScopedContainer;
+//# sourceMappingURL=scoped-container.js.map

package/dist/cjs/lib/scoped-container.js.map

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