ts-ioc-container 56.4.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`
@@ -708,7 +710,7 @@ The `lazy()` registerPipe can be used in two ways: with the `@register` decorato
 import 'reflect-metadata';
 import {
   appendArgs,
-  args,
+  arg,
   bindTo,
   Container,
   inject,
@@ -1017,8 +1019,8 @@ describe('lazy registerPipe', () => {
     @register(bindTo('Config'))
     class ConfigService {
       constructor(
-        @inject(args(0)) public apiUrl: string,
-        @inject(args(1)) public timeout: number,
+        @inject(arg(0)) public apiUrl: string,
+        @inject(arg(1)) public timeout: number,
       ) {
         initLog.push(`ConfigService initialized with ${apiUrl}`);
       }
@@ -1391,7 +1393,7 @@ Provider is dependency factory which creates dependency.
 - `new Provider((container, options) => container.resolve(Logger, options))`
 
 ```typescript
-import { args, bindTo, Container, inject, lazy, Provider, register, Registration as R } from 'ts-ioc-container';
+import { arg, bindTo, Container, inject, lazy, Provider, register, Registration as R } from 'ts-ioc-container';
 
 /**
  * Data Processing Pipeline - Provider Patterns
@@ -1458,7 +1460,7 @@ describe('Provider', () => {
 
   it('supports args decorator for providing extra arguments', () => {
     class FileService {
-      constructor(@inject(args(0)) readonly basePath: string) {}
+      constructor(@inject(arg(0)) readonly basePath: string) {}
     }
 
     const container = new Container().register(
@@ -1472,7 +1474,7 @@ describe('Provider', () => {
 
   it('supports argsFn decorator for dynamic arguments', () => {
     class Database {
-      constructor(@inject(args(0)) readonly connectionString: string) {}
+      constructor(@inject(arg(0)) readonly connectionString: string) {}
     }
 
     const container = new Container().register('DbPath', Provider.fromValue('localhost:5432')).register(
@@ -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.
@@ -1632,14 +1781,15 @@ When you pass an `InjectionToken` via `token.args(...)`, the container resolves
 - `ServiceToken.args(new ClassToken(SomeService))` — `SomeService` is constructed by the container
 - `ServiceToken.args('literal')` — literal value passed directly
 
-### Positional arg injection with `args(index)` and `argsFn`
+### Positional arg injection with `arg(index)`, `args`, and `argsFn`
 
-Constructor parameters that should pick up positional args from `ProviderOptions` must be annotated with `@inject(args(index))`. Parameters without `@inject` resolve to `undefined`.
+Constructor parameters that should pick up positional args from `ProviderOptions` must be annotated with `@inject(arg(index))`. Parameters without `@inject` resolve to `undefined`.
 
-- `@inject(args(0))` — resolves the first element of the `args` array passed at resolution time
+- `@inject(arg(0))` — resolves the first element of the `args` array passed at resolution time
+- `@inject(args)` — resolves the whole runtime `args` array
 - Works together with `token.args(...)` to pass typed dependencies through the args context
 
-`argsFn(predicate)` is the general form: it iterates the runtime `args` array and returns the **first argument matching** `predicate(value, index)` — think `args.find(predicate)`. `args(index)` is just a shortcut for matching by position: `args(0)` is `argsFn((value, index) => index === 0)`. Every `InjectFn` receives `(scope, options)`, where `options.args` is the runtime args array.
+`argsFn(predicate)` is the general form: it iterates the runtime `args` array and returns the **first argument matching** `predicate(value, index)` — think `args.find(predicate)`. `arg(index)` is just a shortcut for matching by position: `arg(0)` is `argsFn((value, index) => index === 0)`. `args` is `(scope, options) => options.args`, i.e. it returns the runtime args array as-is. Every `InjectFn` receives `(scope, options)`, where `options.args` is the runtime args array.
 
 ### Immutable token chaining
 
@@ -1654,7 +1804,7 @@ const userToken = ApiToken.args('https://users.api.com', 1000);
 
 ```typescript
 import {
-  args,
+  arg,
   appendArgs,
   appendArgsFn,
   bindTo,
@@ -1686,7 +1836,7 @@ describe('IProvider', function () {
       // Pre-configure the logger with a filename
       @register(appendArgs('/var/log/app.log'))
       class FileLogger {
-        constructor(@inject(args(0)) public filename: string) {}
+        constructor(@inject(arg(0)) public filename: string) {}
       }
 
       const root = createContainer().addRegistration(R.fromClass(FileLogger));
@@ -1700,8 +1850,8 @@ describe('IProvider', function () {
       @register(appendArgs('ConfiguredContext'))
       class Logger {
         constructor(
-          @inject(args(0)) public runtimeContext: string,
-          @inject(args(1)) public configuredContext: string,
+          @inject(arg(0)) public runtimeContext: string,
+          @inject(arg(1)) public configuredContext: string,
         ) {}
       }
 
@@ -1723,7 +1873,7 @@ describe('IProvider', function () {
       // Extract 'env' from Config service dynamically
       @register(appendArgsFn((scope) => [scope.resolve<Config>('Config').env]))
       class Service {
-        constructor(@inject(args(0)) public env: string) {}
+        constructor(@inject(arg(0)) public env: string) {}
       }
 
       const root = createContainer()
@@ -1740,8 +1890,8 @@ describe('IProvider', function () {
       @register(appendArgs('configured'))
       class Service {
         constructor(
-          @inject(args(0)) public runtime: string,
-          @inject(args(1)) public configured: string,
+          @inject(arg(0)) public runtime: string,
+          @inject(arg(1)) public configured: string,
         ) {}
       }
 
@@ -1760,9 +1910,9 @@ describe('IProvider', function () {
       @register(appendArgs('fixed'), appendArgsFn((scope) => [scope.resolve<Config>('Config').tenant]))
       class Service {
         constructor(
-          @inject(args(0)) public runtime: string,
-          @inject(args(1)) public fixed: string,
-          @inject(args(2)) public tenant: string,
+          @inject(arg(0)) public runtime: string,
+          @inject(arg(1)) public fixed: string,
+          @inject(arg(2)) public tenant: string,
         ) {}
       }
 
@@ -1799,7 +1949,7 @@ describe('IProvider', function () {
 
     // EntityManager is generic - it works with ANY repository.
     // The repository is the first arg passed via `EntityManagerToken.args(...)`.
-    // `@inject(args(0))` reads it; the container auto-resolves InjectionToken args
+    // `@inject(arg(0))` reads it; the container auto-resolves InjectionToken args
     // before they reach the constructor.
     const EntityManagerToken = new SingleToken<EntityManager>('EntityManager');
 
@@ -1808,7 +1958,7 @@ describe('IProvider', function () {
       singleton((arg1) => (arg1 as SingleToken).token), // Cache unique instance per repository type
     )
     class EntityManager {
-      constructor(@inject(args(0)) public repository: IRepository) {}
+      constructor(@inject(arg(0)) public repository: IRepository) {}
     }
 
     class App {
@@ -2117,7 +2267,7 @@ Sometimes you want to decorate you class with some logic. Use the `decorate(...)
 
 ```typescript
 import {
-  args,
+  arg,
   bindTo,
   Container,
   decorate,
@@ -2171,7 +2321,7 @@ describe('Decorator Pattern', () => {
   // Decorator: Wraps any IRepository with logging behavior
   class LoggingRepository implements IRepository {
     constructor(
-      @inject(args(0)) private repository: IRepository,
+      @inject(arg(0)) private repository: IRepository,
       @inject(s.token('Logger').lazy()) private logger: Logger,
     ) {}
 

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.onContainerDisposedHooksRunner = 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.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 = 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");
@@ -13,6 +15,7 @@ Object.defineProperty(exports, "Injector", { enumerable: true, get: function ()
 var MetadataInjector_1 = require("./injector/MetadataInjector");
 Object.defineProperty(exports, "MetadataInjector", { enumerable: true, get: function () { return MetadataInjector_1.MetadataInjector; } });
 Object.defineProperty(exports, "inject", { enumerable: true, get: function () { return MetadataInjector_1.inject; } });
+Object.defineProperty(exports, "arg", { enumerable: true, get: function () { return MetadataInjector_1.arg; } });
 Object.defineProperty(exports, "args", { enumerable: true, get: function () { return MetadataInjector_1.args; } });
 Object.defineProperty(exports, "argsFn", { enumerable: true, get: function () { return MetadataInjector_1.argsFn; } });
 Object.defineProperty(exports, "resolveArgs", { enumerable: true, get: function () { return MetadataInjector_1.resolveArgs; } });
@@ -28,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/injector/MetadataInjector.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveArgs = exports.args = exports.argsFn = exports.MetadataInjector = void 0;
+exports.resolveArgs = exports.args = exports.arg = exports.argsFn = exports.MetadataInjector = void 0;
 exports.inject = inject;
 const IInjector_1 = require("./IInjector");
 const basic_1 = require("../utils/basic");
@@ -21,7 +21,9 @@ function inject(fn, ...mappers) {
 }
 const argsFn = (predicate) => (c, { args = [] }) => args.find((value, index) => predicate(value, index));
 exports.argsFn = argsFn;
-const args = (index) => (0, exports.argsFn)((value, i) => i === index);
+const arg = (index) => (0, exports.argsFn)((value, i) => i === index);
+exports.arg = arg;
+const args = (c, { args = [] }) => args;
 exports.args = args;
 const resolveArgs = (Target, methodName) => {
     const tokens = (0, parameter_1.getParamMeta)(hookMetaKey(methodName), Target);

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, args, argsFn, resolveArgs } from './injector/MetadataInjector.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/injector/MetadataInjector.js

@@ -15,7 +15,8 @@ export function inject(fn, ...mappers) {
     };
 }
 export const argsFn = (predicate) => (c, { args = [] }) => args.find((value, index) => predicate(value, index));
-export const args = (index) => argsFn((value, i) => i === index);
+export const arg = (index) => argsFn((value, i) => i === index);
+export const args = (c, { args = [] }) => args;
 export const resolveArgs = (Target, methodName) => {
     const tokens = getParamMeta(hookMetaKey(methodName), Target);
     return (scope, { args = [], lazy }) => tokens.map((fn) => fn.resolve(scope, { args: args.map(argToToken).map((t) => t.resolve(scope)), lazy }));

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": "56.4.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,13 +1,14 @@
-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, args, argsFn, resolveArgs } from './injector/MetadataInjector.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 { 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/injector/MetadataInjector.d.ts

@@ -20,5 +20,6 @@ export declare function inject<T, B, C, D, E, F, G, H, I, J>(fn: Injectable<T>,
 export declare function inject<T, B, C, D, E, F, G, H, I, J, K>(fn: Injectable<T>, fn1: MapFn<T, B>, fn2: MapFn<B, C>, fn3: MapFn<C, D>, fn4: MapFn<D, E>, fn5: MapFn<E, F>, fn6: MapFn<F, G>, fn7: MapFn<G, H>, fn8: MapFn<H, I>, fn9: MapFn<I, J>, fn10: MapFn<J, K>): ParameterDecorator;
 export declare function inject<T>(fn: Injectable<T>, ...mappers: MapFn<T>[]): ParameterDecorator;
 export declare const argsFn: <T = unknown>(predicate: (value: unknown, index: number) => boolean) => InjectFn<T>;
-export declare const args: <T = unknown>(index: number) => InjectFn<T>;
+export declare const arg: <T = unknown>(index: number) => InjectFn<T>;
+export declare const args: InjectFn<unknown[]>;
 export declare const resolveArgs: (Target: constructor<unknown>, methodName?: string) => (scope: IContainer, { args, lazy }: ProviderOptions) => unknown[];

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>;