ts-ioc-container 57.0.0 → 57.1.0

package/README.md

@@ -43,6 +43,7 @@ provider pipelines, aliases, and custom injector strategies.
   - [Proxy](#proxy)
 - [Provider](#provider) `provider`
   - [Singleton](#singleton) `singleton`
+  - [Auto resolve](#auto-resolve) `autoResolve`
   - [Arguments](#arguments) `appendArgs` `appendArgsFn`
   - [Visibility](#visibility) `visible`
   - [Alias](#alias) `asAlias`
@@ -153,6 +154,7 @@ describe('Quickstart', function () {
 - Register value: `R.fromValue(config).bindTo('Config')`
 - Register factory: `R.fromFn((c) => createX(c)).bindTo('X')`
 - Singleton: `@register(singleton())`
+- Eager service: `@register(autoResolve())` + `container.useModule(new AutoResolveModule())`
 - Scoped registration: `@register(scope((s) => s.hasTag('request')))`
 - Resolve by alias: `container.resolveByAlias('Alias')`
 - Current scope token: `select.scope.current`
@@ -1616,6 +1618,153 @@ describe('Singleton', function () {
 
 ```
 
+### Auto resolve
+
+Some services are never injected anywhere - they subscribe to a queue, start a
+timer, or warm a cache as soon as their scope exists. Lazy resolution would
+never create them, because nothing asks for them.
+
+- `@register(autoResolve())` marks a provider as eager
+- `container.useModule(new AutoResolveModule())` enables eager resolution for
+  every scope created afterwards
+- `container.autoResolve()` resolves the eager providers of one container on demand
+
+Both accept an optional `AutoResolveOptions` (`{ args?: unknown[] }`) whose `args`
+are forwarded to every eagerly resolved provider, exactly as `resolve` forwards
+them - so they reach `@inject(arg(0))` parameters, `scopeAccess` rules and the
+`singleton()` cache key. `new AutoResolveModule({ args })` applies the same args
+to every created scope; call `scope.autoResolve({ args })` yourself when the
+value differs per scope.
+
+> [!IMPORTANT]
+> `autoResolve()` on its own does nothing - the container has to opt in with
+> `AutoResolveModule`. The container the module is applied to is not a created
+> scope, so call `container.autoResolve()` explicitly to eagerly resolve its own
+> providers.
+
+Eager resolution goes through the provider unchanged, so `singleton()` still
+returns the eagerly created instance later, and providers which are not
+registered in the created scope (`scope(...)`) or deny access to it
+(`scopeAccess(...)`) are skipped.
+
+```typescript
+import 'reflect-metadata';
+import {
+  arg,
+  autoResolve,
+  AutoResolveModule,
+  bindTo,
+  Container,
+  type IContainer,
+  inject,
+  register,
+  Registration as R,
+  scope,
+  singleton,
+} from 'ts-ioc-container';
+
+/**
+ * User Management Domain - Eager Services
+ *
+ * Some services are never injected anywhere: they subscribe to a queue, start a
+ * timer, or warm a cache as soon as their scope exists. Nothing resolves them,
+ * so lazy resolution would never create them at all.
+ *
+ * `autoResolve()` marks such a provider as eager, and `AutoResolveModule`
+ * resolves every eager provider of a scope right after the scope is created.
+ */
+
+const auditTrail: string[] = [];
+const openedLogs: string[] = [];
+
+// Started for every request, even though no other class injects it
+@register(bindTo('IRequestAuditor'), scope((s) => s.hasTag('request')), autoResolve(), singleton())
+class RequestAuditor {
+  constructor() {
+    auditTrail.push('request started');
+  }
+}
+
+// Eager too, but parameterized - the args come from whoever triggers eager resolution
+@register(bindTo('IRequestLog'), scope((s) => s.hasTag('request')), autoResolve())
+class RequestLog {
+  constructor(@inject(arg(0)) readonly requestId: string = 'anonymous') {
+    openedLogs.push(requestId);
+  }
+}
+
+// Resolved on demand, the usual way
+@register(bindTo('IUserRepository'), singleton())
+class UserRepository {
+  findById(id: string): string {
+    return `user_${id}`;
+  }
+}
+
+describe('Auto resolve', function () {
+  function createAppContainer(options: { args?: unknown[] } = {}): IContainer {
+    return new Container({ tags: ['application'] })
+      .useModule(new AutoResolveModule(options))
+      .addRegistration(R.fromClass(RequestAuditor))
+      .addRegistration(R.fromClass(RequestLog))
+      .addRegistration(R.fromClass(UserRepository));
+  }
+
+  beforeEach(() => {
+    auditTrail.length = 0;
+    openedLogs.length = 0;
+  });
+
+  it('should create eager services as soon as a scope is created', function () {
+    const app = createAppContainer();
+
+    // Nothing has been created yet - the application container is not a created scope
+    expect(auditTrail).toEqual([]);
+
+    app.createScope({ tags: ['request'] });
+    app.createScope({ tags: ['request'] });
+
+    // One auditor per request scope, without anybody resolving it
+    expect(auditTrail).toEqual(['request started', 'request started']);
+  });
+
+  it('should reuse the eagerly created instance', function () {
+    const requestScope = createAppContainer().createScope({ tags: ['request'] });
+
+    const auditor = requestScope.resolve<RequestAuditor>('IRequestAuditor');
+
+    expect(auditTrail).toEqual(['request started']);
+    expect(requestScope.resolve<RequestAuditor>('IRequestAuditor')).toBe(auditor);
+  });
+
+  it('should treat resolve options as optional', function () {
+    createAppContainer().createScope({ tags: ['request'] });
+
+    expect(openedLogs).toEqual(['anonymous']);
+  });
+
+  it('should forward args to every eagerly resolved provider', function () {
+    // The same args reach every scope the module creates...
+    createAppContainer({ args: ['req-42'] }).createScope({ tags: ['request'] });
+
+    expect(openedLogs).toEqual(['req-42']);
+
+    // ...or pass a per-scope value by calling autoResolve yourself
+    const requestScope = createAppContainer().createScope({ tags: ['request'] });
+    requestScope.autoResolve({ args: ['req-43'] });
+
+    expect(openedLogs).toEqual(['req-42', 'anonymous', 'req-43']);
+  });
+
+  it('should leave other providers lazy', function () {
+    const requestScope = createAppContainer().createScope({ tags: ['request'] });
+
+    expect(requestScope.resolve<UserRepository>('IUserRepository').findById('1')).toBe('user_1');
+  });
+});
+
+```
+
 ### Arguments
 
 Sometimes you want to bind some arguments to provider.

package/cjm/container/AutoResolveModule.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoResolveModule = void 0;
+class AutoResolveModule {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    applyTo(container) {
+        container.addOnScopeCreatedHook((scope) => scope.autoResolve(this.options));
+    }
+}
+exports.AutoResolveModule = AutoResolveModule;

package/cjm/container/Container.js

@@ -20,6 +20,7 @@ class Container {
     injector;
     onConstructHookList = [];
     onDisposeHookList = [];
+    onScopeCreatedHookList = [];
     constructor(options = {}) {
         this.injector = options.injector ?? new MetadataInjector_1.MetadataInjector();
         this.parent = options.parent ?? new EmptyContainer_1.EmptyContainer();
@@ -73,13 +74,26 @@ class Container {
         this.validateContainer();
         const scope = new Container({ injector: this.injector, parent: this, tags })
             .addOnConstructHook(...this.onConstructHookList)
-            .addOnDisposeHook(...this.onDisposeHookList);
+            .addOnDisposeHook(...this.onDisposeHookList)
+            .addOnScopeCreatedHook(...this.onScopeCreatedHookList);
         for (const registration of this.getRegistrations()) {
             registration.applyTo(scope);
         }
         this.scopes.push(scope);
+        for (const onScopeCreated of this.onScopeCreatedHookList) {
+            onScopeCreated(scope);
+        }
         return scope;
     }
+    autoResolve({ args = [] } = {}) {
+        this.validateContainer();
+        for (const provider of this.providers.values()) {
+            if (provider.isAutoResolvable() && provider.hasAccess({ invocationScope: this, providerScope: this, args })) {
+                provider.resolve(this, { args });
+            }
+        }
+        return this;
+    }
     dispose() {
         this.validateContainer();
         this.isDisposed = true;
@@ -97,6 +111,7 @@ class Container {
         this.instances = [];
         this.registrations = [];
         this.onConstructHookList.length = 0;
+        this.onScopeCreatedHookList.length = 0;
     }
     addRegistration(registration) {
         this.registrations.push(registration);
@@ -117,6 +132,10 @@ class Container {
         this.onDisposeHookList.push(...hooks);
         return this;
     }
+    addOnScopeCreatedHook(...hooks) {
+        this.onScopeCreatedHookList.push(...hooks);
+        return this;
+    }
     addInstance(instance) {
         this.instances.push(instance);
         for (const onConstruct of this.onConstructHookList) {

package/cjm/container/EmptyContainer.js

@@ -27,6 +27,9 @@ class EmptyContainer {
     createScope() {
         throw new MethodNotImplementedError_1.MethodNotImplementedError();
     }
+    autoResolve(options) {
+        throw new MethodNotImplementedError_1.MethodNotImplementedError();
+    }
     dispose() {
         throw new MethodNotImplementedError_1.MethodNotImplementedError();
     }
@@ -67,5 +70,8 @@ class EmptyContainer {
     addOnConstructHook(...hooks) {
         throw new MethodNotImplementedError_1.MethodNotImplementedError();
     }
+    addOnScopeCreatedHook(...hooks) {
+        throw new MethodNotImplementedError_1.MethodNotImplementedError();
+    }
 }
 exports.EmptyContainer = EmptyContainer;

package/cjm/index.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AddOnConstructAsyncHookModule = exports.onConstructAsync = exports.onConstructAsyncHooksRunner = exports.AddOnConstructHookModule = exports.onConstruct = exports.onConstructHooksRunner = exports.injectProp = exports.createHookContext = exports.createHookContextFactory = exports.HookContext = exports.prepend = exports.append = exports.prependHooks = exports.appendHooks = exports.hasHooks = exports.hook = exports.getHooks = exports.UnsupportedTokenTypeError = exports.CannonSingletonApplyTwiceError = exports.UnexpectedHookResultError = exports.ProviderDisposedError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.ContainerNotFoundError = exports.DependencyNotFoundError = exports.ContainerError = exports.Registration = exports.appendArgsFn = exports.appendArgs = exports.decorate = exports.singleton = exports.lazy = exports.scopeAccess = exports.scope = exports.bindTo = exports.register = exports.Provider = exports.ProxyInjector = exports.SimpleInjector = exports.resolveArgs = exports.argsFn = exports.args = exports.arg = exports.inject = exports.MetadataInjector = exports.Injector = exports.EmptyContainer = exports.Container = exports.isDependencyKey = void 0;
-exports.resolveConstructor = exports.Is = exports.pipe = exports.select = exports.once = exports.shallowCache = exports.debounce = exports.throttle = exports.handleAsyncError = exports.handleError = exports.getMethodTags = exports.addMethodTag = exports.getMethodLabels = exports.addMethodLabel = exports.getMethodMeta = exports.addMethodMeta = exports.getParamTags = exports.addParamTag = exports.getParamLabels = exports.addParamLabel = exports.getParamMeta = exports.addParamMeta = exports.getClassTags = exports.addClassTag = exports.getClassLabels = exports.addClassLabel = exports.getClassMeta = exports.addClassMeta = exports.GroupInstanceToken = exports.ConstantToken = exports.FunctionToken = exports.SingleToken = exports.ClassToken = exports.toSingleAlias = exports.SingleAliasToken = exports.toGroupAlias = exports.GroupAliasToken = exports.argToToken = exports.toMappedToken = exports.toToken = exports.InjectionToken = exports.HooksRunner = exports.AddOnDisposeHookModule = exports.onContainerDisposed = exports.onContainerDisposedHooksRunner = void 0;
+exports.onConstructAsyncHooksRunner = exports.AddOnConstructHookModule = exports.onConstruct = exports.onConstructHooksRunner = exports.injectProp = exports.createHookContext = exports.createHookContextFactory = exports.HookContext = exports.prepend = exports.append = exports.prependHooks = exports.appendHooks = exports.hasHooks = exports.hook = exports.getHooks = exports.UnsupportedTokenTypeError = exports.CannonSingletonApplyTwiceError = exports.UnexpectedHookResultError = exports.ProviderDisposedError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.ContainerNotFoundError = exports.DependencyNotFoundError = exports.ContainerError = exports.Registration = exports.appendArgsFn = exports.appendArgs = exports.decorate = exports.singleton = exports.autoResolve = exports.lazy = exports.scopeAccess = exports.scope = exports.bindTo = exports.register = exports.Provider = exports.ProxyInjector = exports.SimpleInjector = exports.resolveArgs = exports.argsFn = exports.args = exports.arg = exports.inject = exports.MetadataInjector = exports.Injector = exports.EmptyContainer = exports.AutoResolveModule = exports.Container = exports.isDependencyKey = void 0;
+exports.resolveConstructor = exports.Is = exports.pipe = exports.select = exports.once = exports.shallowCache = exports.debounce = exports.throttle = exports.handleAsyncError = exports.handleError = exports.getMethodTags = exports.addMethodTag = exports.getMethodLabels = exports.addMethodLabel = exports.getMethodMeta = exports.addMethodMeta = exports.getParamTags = exports.addParamTag = exports.getParamLabels = exports.addParamLabel = exports.getParamMeta = exports.addParamMeta = exports.getClassTags = exports.addClassTag = exports.getClassLabels = exports.addClassLabel = exports.getClassMeta = exports.addClassMeta = exports.GroupInstanceToken = exports.ConstantToken = exports.FunctionToken = exports.SingleToken = exports.ClassToken = exports.toSingleAlias = exports.SingleAliasToken = exports.toGroupAlias = exports.GroupAliasToken = exports.argToToken = exports.toMappedToken = exports.toToken = exports.InjectionToken = exports.HooksRunner = exports.AddOnDisposeHookModule = exports.onContainerDisposed = exports.onContainerDisposedHooksRunner = exports.AddOnConstructAsyncHookModule = exports.onConstructAsync = void 0;
 var IContainer_1 = require("./container/IContainer");
 Object.defineProperty(exports, "isDependencyKey", { enumerable: true, get: function () { return IContainer_1.isDependencyKey; } });
 var Container_1 = require("./container/Container");
 Object.defineProperty(exports, "Container", { enumerable: true, get: function () { return Container_1.Container; } });
+var AutoResolveModule_1 = require("./container/AutoResolveModule");
+Object.defineProperty(exports, "AutoResolveModule", { enumerable: true, get: function () { return AutoResolveModule_1.AutoResolveModule; } });
 var EmptyContainer_1 = require("./container/EmptyContainer");
 Object.defineProperty(exports, "EmptyContainer", { enumerable: true, get: function () { return EmptyContainer_1.EmptyContainer; } });
 var IInjector_1 = require("./injector/IInjector");
@@ -29,6 +31,7 @@ Object.defineProperty(exports, "bindTo", { enumerable: true, get: function () {
 Object.defineProperty(exports, "scope", { enumerable: true, get: function () { return IRegistration_1.scope; } });
 Object.defineProperty(exports, "scopeAccess", { enumerable: true, get: function () { return IRegistration_1.scopeAccess; } });
 Object.defineProperty(exports, "lazy", { enumerable: true, get: function () { return IRegistration_1.lazy; } });
+Object.defineProperty(exports, "autoResolve", { enumerable: true, get: function () { return IRegistration_1.autoResolve; } });
 Object.defineProperty(exports, "singleton", { enumerable: true, get: function () { return IRegistration_1.singleton; } });
 Object.defineProperty(exports, "decorate", { enumerable: true, get: function () { return IRegistration_1.decorate; } });
 Object.defineProperty(exports, "appendArgs", { enumerable: true, get: function () { return IRegistration_1.appendArgs; } });

package/cjm/provider/Provider.js

@@ -18,6 +18,7 @@ class Provider {
     accessRules = [];
     mappers = [];
     isLazy = false;
+    isAutoResolve = false;
     cache = new Map();
     getKey;
     isDisposed = false;
@@ -54,6 +55,14 @@ class Provider {
         this.isLazy = true;
         return this;
     }
+    autoResolve() {
+        this.isAutoResolve = true;
+        return this;
+    }
+    isAutoResolvable() {
+        ProviderDisposedError_1.ProviderDisposedError.assert(!this.isDisposed, 'Provider is already disposed');
+        return this.isAutoResolve;
+    }
     addArgsFn(...fns) {
         this.argsFnList.push(...fns);
         return this;
@@ -70,6 +79,7 @@ class Provider {
     dispose() {
         ProviderDisposedError_1.ProviderDisposedError.assert(!this.isDisposed, 'Provider is already disposed');
         this.isDisposed = true;
+        this.isAutoResolve = false;
         this.getKey = undefined;
         this.cache.clear();
         this.accessRules.splice(0, this.accessRules.length);

package/cjm/registration/IRegistration.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.singleton = exports.decorate = exports.lazy = exports.scopeAccess = exports.appendArgsFn = exports.appendArgs = exports.scope = exports.bindTo = exports.register = exports.getTransformers = exports.registerPipe = exports.isProviderPipe = void 0;
+exports.singleton = exports.decorate = exports.autoResolve = exports.lazy = exports.scopeAccess = exports.appendArgsFn = exports.appendArgs = exports.scope = exports.bindTo = exports.register = exports.getTransformers = exports.registerPipe = exports.isProviderPipe = void 0;
 const IContainer_1 = require("../container/IContainer");
 const SingleToken_1 = require("../token/SingleToken");
 const BindToken_1 = require("../token/BindToken");
@@ -44,6 +44,8 @@ const scopeAccess = (rule) => (0, exports.registerPipe)((p) => p.addAccessRule(r
 exports.scopeAccess = scopeAccess;
 const lazy = () => (0, exports.registerPipe)((p) => p.lazy());
 exports.lazy = lazy;
+const autoResolve = () => (0, exports.registerPipe)((p) => p.autoResolve());
+exports.autoResolve = autoResolve;
 const decorate = (...fns) => (0, exports.registerPipe)((p) => p.map(...fns));
 exports.decorate = decorate;
 const singleton = (getCacheKey) => (0, exports.registerPipe)((p) => p.singleton(getCacheKey));

package/esm/container/AutoResolveModule.js

@@ -0,0 +1,9 @@
+export class AutoResolveModule {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    applyTo(container) {
+        container.addOnScopeCreatedHook((scope) => scope.autoResolve(this.options));
+    }
+}

package/esm/container/Container.js

@@ -17,6 +17,7 @@ export class Container {
     injector;
     onConstructHookList = [];
     onDisposeHookList = [];
+    onScopeCreatedHookList = [];
     constructor(options = {}) {
         this.injector = options.injector ?? new MetadataInjector();
         this.parent = options.parent ?? new EmptyContainer();
@@ -70,13 +71,26 @@ export class Container {
         this.validateContainer();
         const scope = new Container({ injector: this.injector, parent: this, tags })
             .addOnConstructHook(...this.onConstructHookList)
-            .addOnDisposeHook(...this.onDisposeHookList);
+            .addOnDisposeHook(...this.onDisposeHookList)
+            .addOnScopeCreatedHook(...this.onScopeCreatedHookList);
         for (const registration of this.getRegistrations()) {
             registration.applyTo(scope);
         }
         this.scopes.push(scope);
+        for (const onScopeCreated of this.onScopeCreatedHookList) {
+            onScopeCreated(scope);
+        }
         return scope;
     }
+    autoResolve({ args = [] } = {}) {
+        this.validateContainer();
+        for (const provider of this.providers.values()) {
+            if (provider.isAutoResolvable() && provider.hasAccess({ invocationScope: this, providerScope: this, args })) {
+                provider.resolve(this, { args });
+            }
+        }
+        return this;
+    }
     dispose() {
         this.validateContainer();
         this.isDisposed = true;
@@ -94,6 +108,7 @@ export class Container {
         this.instances = [];
         this.registrations = [];
         this.onConstructHookList.length = 0;
+        this.onScopeCreatedHookList.length = 0;
     }
     addRegistration(registration) {
         this.registrations.push(registration);
@@ -114,6 +129,10 @@ export class Container {
         this.onDisposeHookList.push(...hooks);
         return this;
     }
+    addOnScopeCreatedHook(...hooks) {
+        this.onScopeCreatedHookList.push(...hooks);
+        return this;
+    }
     addInstance(instance) {
         this.instances.push(instance);
         for (const onConstruct of this.onConstructHookList) {

package/esm/container/EmptyContainer.js

@@ -24,6 +24,9 @@ export class EmptyContainer {
     createScope() {
         throw new MethodNotImplementedError();
     }
+    autoResolve(options) {
+        throw new MethodNotImplementedError();
+    }
     dispose() {
         throw new MethodNotImplementedError();
     }
@@ -64,4 +67,7 @@ export class EmptyContainer {
     addOnConstructHook(...hooks) {
         throw new MethodNotImplementedError();
     }
+    addOnScopeCreatedHook(...hooks) {
+        throw new MethodNotImplementedError();
+    }
 }

package/esm/index.js

@@ -1,12 +1,13 @@
 export { isDependencyKey, } from './container/IContainer.js';
 export { Container } from './container/Container.js';
+export { AutoResolveModule } from './container/AutoResolveModule.js';
 export { EmptyContainer } from './container/EmptyContainer.js';
 export { Injector } from './injector/IInjector.js';
 export { MetadataInjector, inject, arg, args, argsFn, resolveArgs } from './injector/MetadataInjector.js';
 export { SimpleInjector } from './injector/SimpleInjector.js';
 export { ProxyInjector } from './injector/ProxyInjector.js';
 export { Provider } from './provider/Provider.js';
-export { register, bindTo, scope, scopeAccess, lazy, singleton, decorate, appendArgs, appendArgsFn, } from './registration/IRegistration.js';
+export { register, bindTo, scope, scopeAccess, lazy, autoResolve, singleton, decorate, appendArgs, appendArgsFn, } from './registration/IRegistration.js';
 export { Registration } from './registration/Registration.js';
 export { ContainerError } from './errors/ContainerError.js';
 export { DependencyNotFoundError } from './errors/DependencyNotFoundError.js';

package/esm/provider/Provider.js

@@ -15,6 +15,7 @@ export class Provider {
     accessRules = [];
     mappers = [];
     isLazy = false;
+    isAutoResolve = false;
     cache = new Map();
     getKey;
     isDisposed = false;
@@ -51,6 +52,14 @@ export class Provider {
         this.isLazy = true;
         return this;
     }
+    autoResolve() {
+        this.isAutoResolve = true;
+        return this;
+    }
+    isAutoResolvable() {
+        ProviderDisposedError.assert(!this.isDisposed, 'Provider is already disposed');
+        return this.isAutoResolve;
+    }
     addArgsFn(...fns) {
         this.argsFnList.push(...fns);
         return this;
@@ -67,6 +76,7 @@ export class Provider {
     dispose() {
         ProviderDisposedError.assert(!this.isDisposed, 'Provider is already disposed');
         this.isDisposed = true;
+        this.isAutoResolve = false;
         this.getKey = undefined;
         this.cache.clear();
         this.accessRules.splice(0, this.accessRules.length);

package/esm/registration/IRegistration.js

@@ -31,5 +31,6 @@ export const appendArgs = (...extraArgs) => registerPipe((p) => p.addArgsFn((_,
 export const appendArgsFn = (fn) => registerPipe((p) => p.addArgsFn((scope, options) => [...(options?.args ?? []), ...fn(scope, options)]));
 export const scopeAccess = (rule) => registerPipe((p) => p.addAccessRule(rule));
 export const lazy = () => registerPipe((p) => p.lazy());
+export const autoResolve = () => registerPipe((p) => p.autoResolve());
 export const decorate = (...fns) => registerPipe((p) => p.map(...fns));
 export const singleton = (getCacheKey) => registerPipe((p) => p.singleton(getCacheKey));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-ioc-container",
-  "version": "57.0.0",
+  "version": "57.1.0",
   "description": "Fast, lightweight TypeScript dependency injection container with a clean API, scoped lifecycles, decorators, tokens, hooks, lazy injection, customizable providers, and no global container objects.",
   "publishConfig": {
     "access": "public",

package/typings/container/AutoResolveModule.d.ts

@@ -0,0 +1,6 @@
+import { type AutoResolveOptions, type IContainer, type IContainerModule } from './IContainer.js';
+export declare class AutoResolveModule implements IContainerModule {
+    private readonly options;
+    constructor(options?: AutoResolveOptions);
+    applyTo(container: IContainer): void;
+}

package/typings/container/Container.d.ts

@@ -1,4 +1,4 @@
-import { type CreateScopeOptions, type DependencyKey, type IContainer, type IContainerModule, type RegisterOptions, ResolveManyOptions, type ResolveOneOptions, type Tag } from './IContainer.js';
+import { type AutoResolveOptions, type CreateScopeOptions, type DependencyKey, type IContainer, type IContainerModule, type OnScopeCreatedHook, type RegisterOptions, ResolveManyOptions, type ResolveOneOptions, type Tag } from './IContainer.js';
 import { type IInjector } from '../injector/IInjector.js';
 import { type IProvider } from '../provider/IProvider.js';
 import { type IRegistration } from '../registration/IRegistration.js';
@@ -17,6 +17,7 @@ export declare class Container implements IContainer {
     private readonly injector;
     private readonly onConstructHookList;
     private readonly onDisposeHookList;
+    private readonly onScopeCreatedHookList;
     constructor(options?: {
         injector?: IInjector;
         parent?: IContainer;
@@ -27,12 +28,14 @@ export declare class Container implements IContainer {
     resolveByAlias<T>(alias: DependencyKey, { args, child, lazy, excludedKeys }?: ResolveManyOptions): T[];
     resolveOneByAlias<T>(alias: DependencyKey, { args, child, lazy }?: ResolveOneOptions): T;
     createScope({ tags }?: CreateScopeOptions): IContainer;
+    autoResolve({ args }?: AutoResolveOptions): this;
     dispose(): void;
     addRegistration(registration: IRegistration): this;
     getRegistrations(): IRegistration[];
     hasRegistration(key: DependencyKey): boolean;
     addOnConstructHook(...hooks: OnConstructHook[]): this;
     addOnDisposeHook(...hooks: OnDisposeHook[]): this;
+    addOnScopeCreatedHook(...hooks: OnScopeCreatedHook[]): this;
     addInstance(instance: Instance): void;
     getScopes(): IContainer[];
     hasInstance(instance: object): boolean;

package/typings/container/EmptyContainer.d.ts

@@ -1,4 +1,4 @@
-import { type DependencyKey, type IContainer, type IContainerModule, type ResolveManyOptions, type ResolveOneOptions, type Tag } from './IContainer.js';
+import { type AutoResolveOptions, type DependencyKey, type IContainer, type IContainerModule, type OnScopeCreatedHook, type ResolveManyOptions, type ResolveOneOptions, type Tag } from './IContainer.js';
 import { type IProvider } from '../provider/IProvider.js';
 import { type IRegistration } from '../registration/IRegistration.js';
 import { OnDisposeHook } from '../hooks/onContainerDisposed.js';
@@ -13,6 +13,7 @@ export declare class EmptyContainer implements IContainer {
     getInstances(): never[];
     hasInstance(instance: object): boolean;
     createScope(): IContainer;
+    autoResolve(options?: AutoResolveOptions): this;
     dispose(): void;
     register(key: DependencyKey, value: IProvider): this;
     hasTag(tag: Tag): boolean;
@@ -27,4 +28,5 @@ export declare class EmptyContainer implements IContainer {
     resolveOneByAlias<T>(alias: DependencyKey, options?: ResolveOneOptions): T;
     addOnDisposeHook(...hooks: OnDisposeHook[]): this;
     addOnConstructHook(...hooks: OnConstructHook[]): this;
+    addOnScopeCreatedHook(...hooks: OnScopeCreatedHook[]): this;
 }

package/typings/container/IContainer.d.ts

@@ -2,6 +2,7 @@ import { type IProvider, ProviderOptions } from '../provider/IProvider.js';
 import { type IRegistration } from '../registration/IRegistration.js';
 import { OnConstructHook } from '../hooks/onConstruct.js';
 import { OnDisposeHook } from '../hooks/onContainerDisposed.js';
+import { type WithArgs } from '../injector/IInjector.js';
 import { type constructor, Instance } from '../utils/basic.js';
 export type DependencyKey = string | symbol;
 export declare function isDependencyKey(target: unknown): target is DependencyKey;
@@ -28,6 +29,8 @@ export interface IContainerModule {
     applyTo(container: IContainer): void;
 }
 export type CreateScopeOptions = Partial<WithTags>;
+export type AutoResolveOptions = Partial<WithArgs>;
+export type OnScopeCreatedHook = (scope: IContainer) => void;
 export type RegisterOptions = {
     aliases?: DependencyKey[];
 };
@@ -35,6 +38,7 @@ export interface IContainer extends Tagged {
     readonly isDisposed: boolean;
     addOnConstructHook(...hooks: OnConstructHook[]): this;
     addOnDisposeHook(...hooks: OnDisposeHook[]): this;
+    addOnScopeCreatedHook(...hooks: OnScopeCreatedHook[]): this;
     register(key: DependencyKey, value: IProvider, options?: RegisterOptions): this;
     addRegistration(registration: IRegistration): this;
     getRegistrations(): IRegistration[];
@@ -43,6 +47,7 @@ export interface IContainer extends Tagged {
     resolveByAlias<T>(alias: DependencyKey, options?: ResolveManyOptions): T[];
     resolveOneByAlias<T>(alias: DependencyKey, options?: ResolveOneOptions): T;
     createScope(options?: CreateScopeOptions): IContainer;
+    autoResolve(options?: AutoResolveOptions): this;
     getScopes(): IContainer[];
     getScopeByInstanceOrFail(instance: object): IContainer;
     removeScope(child: IContainer): void;

package/typings/index.d.ts

@@ -1,5 +1,6 @@
-export { type IContainer, type Resolvable, type IContainerModule, type DependencyKey, type Tag, type Tagged, type ResolveOneOptions, type ResolveManyOptions, isDependencyKey, } from './container/IContainer.js';
+export { type IContainer, type Resolvable, type IContainerModule, type DependencyKey, type Tag, type Tagged, type ResolveOneOptions, type ResolveManyOptions, type OnScopeCreatedHook, type AutoResolveOptions, isDependencyKey, } from './container/IContainer.js';
 export { Container } from './container/Container.js';
+export { AutoResolveModule } from './container/AutoResolveModule.js';
 export { EmptyContainer } from './container/EmptyContainer.js';
 export { type IInjector, type InjectOptions, type IInjectFnResolver, Injector } from './injector/IInjector.js';
 export { MetadataInjector, inject, arg, args, argsFn, resolveArgs } from './injector/MetadataInjector.js';
@@ -7,7 +8,7 @@ export { SimpleInjector } from './injector/SimpleInjector.js';
 export { ProxyInjector } from './injector/ProxyInjector.js';
 export { type ResolveDependency, type IProvider, type DecorateFn, type ArgsFn, type ProviderOptions, type GetCacheKey, type ScopeAccessOptions, type ScopeAccessRule, } from './provider/IProvider.js';
 export { Provider } from './provider/Provider.js';
-export { type IRegistration, type ReturnTypeOfRegistration, type ScopeMatchRule, type ProviderPipe, register, bindTo, scope, scopeAccess, lazy, singleton, decorate, appendArgs, appendArgsFn, } from './registration/IRegistration.js';
+export { type IRegistration, type ReturnTypeOfRegistration, type ScopeMatchRule, type ProviderPipe, register, bindTo, scope, scopeAccess, lazy, autoResolve, singleton, decorate, appendArgs, appendArgsFn, } from './registration/IRegistration.js';
 export { Registration } from './registration/Registration.js';
 export { ContainerError } from './errors/ContainerError.js';
 export { DependencyNotFoundError } from './errors/DependencyNotFoundError.js';

package/typings/provider/IProvider.d.ts

@@ -21,6 +21,8 @@ export interface IProvider<T = any> {
     addAccessRule(...rules: ScopeAccessRule[]): this;
     addArgsFn(argsFn: ArgsFn): this;
     lazy(): this;
+    autoResolve(): this;
+    isAutoResolvable(): boolean;
     singleton(getCacheKey?: GetCacheKey): this;
     dispose(): void;
 }

package/typings/provider/Provider.d.ts

@@ -10,6 +10,7 @@ export declare class Provider<T = any> implements IProvider<T> {
     private readonly accessRules;
     private readonly mappers;
     private isLazy;
+    private isAutoResolve;
     private cache;
     private getKey;
     private isDisposed;
@@ -19,6 +20,8 @@ export declare class Provider<T = any> implements IProvider<T> {
     map(...mappers: DecorateFn<T>[]): this;
     addAccessRule(...rules: ScopeAccessRule[]): this;
     lazy(): this;
+    autoResolve(): this;
+    isAutoResolvable(): boolean;
     addArgsFn(...fns: ArgsFn[]): this;
     hasAccess(options: ScopeAccessOptions): boolean;
     singleton(getCacheKey?: GetCacheKey): this;

package/typings/registration/IRegistration.d.ts

@@ -27,5 +27,6 @@ export declare const appendArgs: <T>(...extraArgs: unknown[]) => ProviderPipe<T>
 export declare const appendArgsFn: <T>(fn: ArgsFn) => ProviderPipe<T>;
 export declare const scopeAccess: <T>(rule: ScopeAccessRule) => ProviderPipe<T>;
 export declare const lazy: <T>() => ProviderPipe<T>;
+export declare const autoResolve: <T>() => ProviderPipe<T>;
 export declare const decorate: (...fns: DecorateFn[]) => ProviderPipe<unknown>;
 export declare const singleton: <T = unknown>(getCacheKey?: GetCacheKey) => ProviderPipe<T>;