ts-ioc-container 68.0.0 → 69.0.0

package/README.md

@@ -1774,13 +1774,16 @@ Sometimes you want to bind some arguments to provider.
 - `provider(appendArgsFn((container) => [container.resolve(Logger), 'someValue']))`
 - `Provider.fromClass(Logger).pipe(appendArgs('someArgument'))`
 
-### Token as argument
+### Dependencies as arguments
 
-When you pass an `InjectionToken` via `token.args(...)`, the container resolves it before the value reaches the constructor. Bare constructors are **not** auto-resolved — wrap a class in `ClassToken` to opt into resolution.
+Args are passed to the constructor **as-is** — the library never resolves an `InjectionToken` (or a bare constructor) it finds in the args list. Resolve it at the call site with `argsFn`:
 
-- `ServiceToken.args(ValueToken)` — `ValueToken` is resolved from the container, its value is passed as arg
-- `ServiceToken.args(new ClassToken(SomeService))` — `SomeService` is constructed by the container
+- `ServiceToken.argsFn((scope) => [ValueToken.resolve(scope)])` — `ValueToken` is resolved from the container, its value is passed as arg
+- `ServiceToken.argsFn((scope) => [scope.resolve(SomeService)])` — `SomeService` is constructed by the container
 - `ServiceToken.args('literal')` — literal value passed directly
+- `ServiceToken.args(ValueToken)` — the token object itself is passed as arg
+
+`argToToken(value)` is the helper for a call site that wants "resolve tokens, pass literals through": it returns an `InjectionToken` as-is and wraps anything else in a `ConstantToken`, so `@inject((scope, { args = [] }) => argToToken(args[0]).resolve(scope))` accepts either.
 
 ### Positional arg injection with `arg(index)`, `args`, and `argsFn`
 
@@ -1788,10 +1791,73 @@ Constructor parameters that should pick up positional args from `ProviderOptions
 
 - `@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
+- Works together with `token.args(...)` / `token.argsFn(...)` 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)`. `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.
 
+`findOrFail(predicate)` is the strict, variadic counterpart for places that take the raw args list — `singleton(findOrFail(isUserId))` keys a per-argument singleton, for example. It returns the first argument matching `predicate(value)` and throws `ArgumentNotFoundError` when none does, instead of silently handing out `undefined`.
+
+### Runtime args flow through tokens
+
+Every container-backed token (`SingleToken`, `ClassToken`, `SingleAliasToken`, `GroupAliasToken`, `FunctionToken`) forwards the `args` of its own `resolve` call to the provider, exactly like `container.resolve(key, { args })` does. `token.args(...)` and `token.argsFn(...)` **append after** the runtime args, so `token.args('x').resolve(container, { args: ['r'] })` hands the provider `['r', 'x']`.
+
+Because `@inject(token)` parameters are resolved with the args of the class being constructed, those args **cascade** into every injected dependency: they reach the dependency's provider, its `@inject(arg(index))` parameters, its `scopeAccess` rule and its `singleton()` cache key. That is what lets a per-user `UserService` share a per-user `UserRepository` without passing the id along by hand:
+
+```typescript
+import {
+  arg,
+  bindTo,
+  Container,
+  findOrFail,
+  inject,
+  register,
+  Registration as R,
+  singleton,
+  SingleToken,
+} from 'ts-ioc-container';
+
+interface IUserRepository {
+  userId: string;
+}
+
+const IUserRepositoryKey = new SingleToken<IUserRepository>('IUserRepository');
+const isUserId = (value: unknown): value is string => typeof value === 'string';
+
+// one repository per user id - the id is the singleton cache key
+@register(bindTo(IUserRepositoryKey), singleton(findOrFail<string>(isUserId)))
+class UserRepository implements IUserRepository {
+  constructor(@inject(arg(0)) public userId: string) {}
+}
+
+class UserService {
+  constructor(@inject(IUserRepositoryKey) public repository: IUserRepository) {}
+}
+
+describe('Token Runtime Arguments', function () {
+  it('should forward runtime args to the provider behind the token', function () {
+    const container = new Container().addRegistration(R.fromClass(UserRepository));
+
+    expect(IUserRepositoryKey.resolve(container, { args: ['user-1'] }).userId).toBe('user-1');
+  });
+
+  it('should cascade the runtime args of a class into its injected dependencies', function () {
+    const container = new Container().addRegistration(R.fromClass(UserRepository));
+
+    const service = container.resolve(UserService, { args: ['user-1'] });
+    const sameUser = container.resolve(UserService, { args: ['user-1'] });
+    const otherUser = container.resolve(UserService, { args: ['user-2'] });
+
+    expect(service.repository.userId).toBe('user-1');
+    expect(sameUser.repository).toBe(service.repository);
+    expect(otherUser.repository.userId).toBe('user-2');
+  });
+});
+
+```
+
+> [!IMPORTANT]
+> Runtime args come first. A dependency that reads `@inject(arg(0))` sees the *caller's* first runtime arg whenever the caller was resolved with args, even if its token was specialized with `token.args(...)`. Pick args by shape (`argsFn(predicate)`, `findOrFail(predicate)`) rather than by position when a class can be resolved with runtime args and its dependencies are specialized with `token.args(...)`.
+
 ### Immutable token chaining
 
 `token.args(...)`, `token.argsFn(...)`, and `token.lazy()` all return **new token instances** — the parent token is never mutated. This allows the same token to be specialized in multiple independent ways (one-way linked list: parent → many children).
@@ -1949,14 +2015,16 @@ describe('IProvider', function () {
     }
 
     // EntityManager is generic - it works with ANY repository.
-    // The repository is the first arg passed via `EntityManagerToken.args(...)`.
-    // `@inject(arg(0))` reads it; the container auto-resolves InjectionToken args
-    // before they reach the constructor.
+    // The repository is the first arg; `@inject(arg(0))` reads it. Args are
+    // passed through as-is, so the call site resolves the repository token
+    // itself with `argsFn` before it reaches the constructor.
     const EntityManagerToken = new SingleToken<EntityManager>('EntityManager');
+    const withRepository = (token: SingleToken<IRepository>) =>
+      EntityManagerToken.argsFn((scope) => [token.resolve(scope)]);
 
     @register(
       bindTo(EntityManagerToken),
-      singleton((arg1) => (arg1 as SingleToken).token), // Cache unique instance per repository type
+      singleton((repository) => (repository as IRepository).name), // Cache unique instance per repository type
     )
     class EntityManager {
       constructor(@inject(arg(0)) public repository: IRepository) {}
@@ -1965,11 +2033,11 @@ describe('IProvider', function () {
     class App {
       constructor(
         // Inject EntityManager configured for Users
-        @inject(EntityManagerToken.args(UserRepositoryToken))
+        @inject(withRepository(UserRepositoryToken))
         public userManager: EntityManager,
 
         // Inject EntityManager configured for Todos
-        @inject(EntityManagerToken.args(TodoRepositoryToken))
+        @inject(withRepository(TodoRepositoryToken))
         public todoManager: EntityManager,
       ) {}
     }
@@ -1993,14 +2061,14 @@ describe('IProvider', function () {
         .addRegistration(R.fromClass(TodoRepository));
 
       // Resolve user manager twice
-      const userManager1 = EntityManagerToken.args(UserRepositoryToken).resolve(root);
-      const userManager2 = EntityManagerToken.args(UserRepositoryToken).resolve(root);
+      const userManager1 = withRepository(UserRepositoryToken).resolve(root);
+      const userManager2 = withRepository(UserRepositoryToken).resolve(root);
 
       // Should be same instance (cached)
       expect(userManager1).toBe(userManager2);
 
       // Resolve todo manager
-      const todoManager = EntityManagerToken.args(TodoRepositoryToken).resolve(root);
+      const todoManager = withRepository(TodoRepositoryToken).resolve(root);
 
       // Should be different from user manager
       expect(todoManager).not.toBe(userManager1);
@@ -3398,3 +3466,4 @@ The product-facing error contract is described in
 - [MethodNotImplementedError.ts](..%2F..%2Flib%2Ferrors%2FMethodNotImplementedError.ts)
 - [DependencyMissingKeyError.ts](..%2F..%2Flib%2Ferrors%2FDependencyMissingKeyError.ts)
 - [ContainerDisposedError.ts](..%2F..%2Flib%2Ferrors%2FContainerDisposedError.ts)
+- [ArgumentNotFoundError.ts](..%2F..%2Flib%2Ferrors%2FArgumentNotFoundError.ts)

package/cjm/errors/ArgumentNotFoundError.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgumentNotFoundError = void 0;
+const ContainerError_1 = require("./ContainerError");
+class ArgumentNotFoundError extends ContainerError_1.ContainerError {
+    name = 'ArgumentNotFoundError';
+    constructor(message = 'Argument not found') {
+        super(message);
+        Object.setPrototypeOf(this, ArgumentNotFoundError.prototype);
+    }
+}
+exports.ArgumentNotFoundError = ArgumentNotFoundError;

package/cjm/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sequential = exports.injectProp = exports.createHookExecutionContext = exports.createHookContextFactory = exports.HookContext = exports.toHookFn = exports.hasHooks = exports.hook = exports.getHooks = exports.TypedEventDisposedError = exports.UnsupportedTokenTypeError = exports.CannonSingletonApplyTwiceError = exports.ProviderDisposedError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.ContainerNotFoundError = exports.DependencyNotFoundError = exports.ContainerError = exports.Registration = exports.onResolve = exports.appendArgsFn = exports.appendArgs = exports.decorate = exports.singleton = exports.autoResolve = exports.lazy = exports.scopeAccess = exports.scope = exports.bindTo = exports.register = exports.toRegistrationFn = exports.toProviderFn = exports.toBindToken = exports.registerPipe = exports.isProviderPipe = 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.ProxyRegistry = exports.pipe = exports.select = exports.TypedEvent = exports.getConstructorChain = exports.memoize = exports.once = exports.shallowCache = exports.debounce = exports.throttle = exports.runAtOnce = exports.runInOrder = 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.resolveConstructor = 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.toTask = exports.HookCollector = exports.oncePerInstance = exports.parallel = void 0;
-exports.Is = exports.unwrapProxy = void 0;
+exports.injectProp = exports.createHookExecutionContext = exports.createHookContextFactory = exports.HookContext = exports.toHookFn = exports.hasHooks = exports.hook = exports.getHooks = exports.ArgumentNotFoundError = exports.TypedEventDisposedError = exports.UnsupportedTokenTypeError = exports.CannonSingletonApplyTwiceError = exports.ProviderDisposedError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.ContainerNotFoundError = exports.DependencyNotFoundError = exports.ContainerError = exports.Registration = exports.onResolve = exports.appendArgsFn = exports.appendArgs = exports.decorate = exports.singleton = exports.autoResolve = exports.lazy = exports.scopeAccess = exports.scope = exports.bindTo = exports.register = exports.toRegistrationFn = exports.toProviderFn = exports.toBindToken = exports.registerPipe = exports.isProviderPipe = 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.pipe = exports.select = exports.TypedEvent = exports.getConstructorChain = exports.memoize = exports.once = exports.shallowCache = exports.debounce = exports.throttle = exports.runAtOnce = exports.runInOrder = 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.resolveConstructor = 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.toTask = exports.HookCollector = exports.oncePerInstance = exports.parallel = exports.sequential = void 0;
+exports.Is = exports.unwrapProxy = exports.ProxyRegistry = exports.findOrFail = 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");
@@ -65,6 +65,8 @@ var UnsupportedTokenTypeError_1 = require("./errors/UnsupportedTokenTypeError");
 Object.defineProperty(exports, "UnsupportedTokenTypeError", { enumerable: true, get: function () { return UnsupportedTokenTypeError_1.UnsupportedTokenTypeError; } });
 var TypedEventDisposedError_1 = require("./errors/TypedEventDisposedError");
 Object.defineProperty(exports, "TypedEventDisposedError", { enumerable: true, get: function () { return TypedEventDisposedError_1.TypedEventDisposedError; } });
+var ArgumentNotFoundError_1 = require("./errors/ArgumentNotFoundError");
+Object.defineProperty(exports, "ArgumentNotFoundError", { enumerable: true, get: function () { return ArgumentNotFoundError_1.ArgumentNotFoundError; } });
 var hook_1 = require("./hooks/hook");
 Object.defineProperty(exports, "getHooks", { enumerable: true, get: function () { return hook_1.getHooks; } });
 Object.defineProperty(exports, "hook", { enumerable: true, get: function () { return hook_1.hook; } });
@@ -152,6 +154,8 @@ var select_1 = require("./select");
 Object.defineProperty(exports, "select", { enumerable: true, get: function () { return select_1.select; } });
 var fp_1 = require("./utils/fp");
 Object.defineProperty(exports, "pipe", { enumerable: true, get: function () { return fp_1.pipe; } });
+var array_1 = require("./utils/array");
+Object.defineProperty(exports, "findOrFail", { enumerable: true, get: function () { return array_1.findOrFail; } });
 var ProxyRegistry_1 = require("./utils/ProxyRegistry");
 Object.defineProperty(exports, "ProxyRegistry", { enumerable: true, get: function () { return ProxyRegistry_1.ProxyRegistry; } });
 Object.defineProperty(exports, "unwrapProxy", { enumerable: true, get: function () { return ProxyRegistry_1.unwrapProxy; } });

package/cjm/injector/MetadataInjector.js

@@ -27,6 +27,6 @@ const args = (c, { args = [] }) => args;
 exports.args = args;
 const resolveArgs = (target, methodName) => {
     const tokens = (0, parameter_1.getParamMeta)(hookMetaKey(methodName), target);
-    return (scope, { args = [], lazy }) => tokens.map((fn) => fn.resolve(scope, { args: args.map(toToken_1.argToToken).map((t) => t.resolve(scope)), lazy }));
+    return (scope, { args = [], lazy }) => tokens.map((fn) => fn.resolve(scope, { args, lazy }));
 };
 exports.resolveArgs = resolveArgs;

package/cjm/token/ClassToken.js

@@ -6,7 +6,7 @@ class ClassToken extends InjectionToken_1.InjectionToken {
     target;
     _getArgsFn;
     _isLazy;
-    constructor(target, { getArgsFn = () => [], isLazy = false } = {}) {
+    constructor(target, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
         super();
         this.target = target;
         this._getArgsFn = getArgsFn;

package/cjm/token/FunctionToken.js

@@ -6,7 +6,7 @@ class FunctionToken extends InjectionToken_1.InjectionToken {
     fn;
     _getArgsFn;
     _isLazy;
-    constructor(fn, { getArgsFn = (_, { args = [] } = {}) => args, isLazy = false } = {}) {
+    constructor(fn, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
         super();
         this.fn = fn;
         this._getArgsFn = getArgsFn;

package/cjm/token/GroupAliasToken.js

@@ -6,7 +6,7 @@ class GroupAliasToken extends InjectionToken_1.InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = () => [], isLazy = false } = {}) {
+    constructor(token, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
         super();
         this.token = token;
         this._getArgsFn = getArgsFn;

package/cjm/token/InjectionToken.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InjectionToken = void 0;
+exports.InjectionToken = exports.forwardArgs = void 0;
 exports.isInjectionToken = isInjectionToken;
 const basic_1 = require("../utils/basic");
+const forwardArgs = (_, { args = [] } = {}) => args;
+exports.forwardArgs = forwardArgs;
 class InjectionToken {
 }
 exports.InjectionToken = InjectionToken;

package/cjm/token/SingleAliasToken.js

@@ -6,7 +6,7 @@ class SingleAliasToken extends InjectionToken_1.InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = () => [], isLazy = false } = {}) {
+    constructor(token, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
         super();
         this.token = token;
         this._getArgsFn = getArgsFn;

package/cjm/token/SingleToken.js

@@ -6,7 +6,7 @@ class SingleToken extends InjectionToken_1.InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = () => [], isLazy = false } = {}) {
+    constructor(token, { getArgsFn = InjectionToken_1.forwardArgs, isLazy = false } = {}) {
         super();
         this.token = token;
         this._getArgsFn = getArgsFn;

package/cjm/utils/array.js

@@ -1,9 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Filter = void 0;
+exports.findOrFail = exports.Filter = void 0;
+const ArgumentNotFoundError_1 = require("../errors/ArgumentNotFoundError");
 exports.Filter = {
     exclude: (arr) => {
         const excludeSet = arr instanceof Array ? new Set(arr) : arr;
         return (v) => !excludeSet.has(v);
     },
 };
+const findOrFail = (predicate) => (...args) => {
+    const index = args.findIndex((arg) => predicate(arg));
+    if (index === -1) {
+        throw new ArgumentNotFoundError_1.ArgumentNotFoundError();
+    }
+    return args[index];
+};
+exports.findOrFail = findOrFail;

package/esm/errors/ArgumentNotFoundError.js

@@ -0,0 +1,8 @@
+import { ContainerError } from './ContainerError.js';
+export class ArgumentNotFoundError extends ContainerError {
+    name = 'ArgumentNotFoundError';
+    constructor(message = 'Argument not found') {
+        super(message);
+        Object.setPrototypeOf(this, ArgumentNotFoundError.prototype);
+    }
+}

package/esm/index.js

@@ -19,6 +19,7 @@ export { ProviderDisposedError } from './errors/ProviderDisposedError.js';
 export { CannonSingletonApplyTwiceError } from './errors/CannonSingletonApplyTwiceError.js';
 export { UnsupportedTokenTypeError } from './errors/UnsupportedTokenTypeError.js';
 export { TypedEventDisposedError } from './errors/TypedEventDisposedError.js';
+export { ArgumentNotFoundError } from './errors/ArgumentNotFoundError.js';
 export { getHooks, hook, hasHooks, toHookFn, } from './hooks/hook.js';
 export { HookContext, createHookContextFactory, createHookExecutionContext, } from './hooks/HookContext.js';
 export { injectProp } from './hooks/injectProp.js';
@@ -48,5 +49,6 @@ export { getConstructorChain } from './utils/getConstructorChain.js';
 export { TypedEvent } from './utils/TypedEvent.js';
 export { select } from './select.js';
 export { pipe } from './utils/fp.js';
+export { findOrFail } from './utils/array.js';
 export { ProxyRegistry, unwrapProxy } from './utils/ProxyRegistry.js';
 export { Is } from './utils/basic.js';

package/esm/injector/MetadataInjector.js

@@ -1,7 +1,7 @@
 import { Injector } from './IInjector.js';
 import { resolveConstructor } from '../metadata/target.js';
-import { getParamMeta, addParamMeta } from '../metadata/parameter.js';
-import { argToToken, toMappedToken } from '../token/toToken.js';
+import { addParamMeta, getParamMeta } from '../metadata/parameter.js';
+import { toMappedToken } from '../token/toToken.js';
 export class MetadataInjector extends Injector {
     createInstance(scope, Target, { args: deps = [] } = {}) {
         const args = resolveArgs(Target)(scope, { args: deps });
@@ -19,5 +19,5 @@ 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 }));
+    return (scope, { args = [], lazy }) => tokens.map((fn) => fn.resolve(scope, { args, lazy }));
 };

package/esm/token/ClassToken.js

@@ -1,9 +1,9 @@
-import { InjectionToken } from './InjectionToken.js';
+import { forwardArgs, InjectionToken } from './InjectionToken.js';
 export class ClassToken extends InjectionToken {
     target;
     _getArgsFn;
     _isLazy;
-    constructor(target, { getArgsFn = () => [], isLazy = false } = {}) {
+    constructor(target, { getArgsFn = forwardArgs, isLazy = false } = {}) {
         super();
         this.target = target;
         this._getArgsFn = getArgsFn;

package/esm/token/FunctionToken.js

@@ -1,9 +1,9 @@
-import { InjectionToken } from './InjectionToken.js';
+import { forwardArgs, InjectionToken } from './InjectionToken.js';
 export class FunctionToken extends InjectionToken {
     fn;
     _getArgsFn;
     _isLazy;
-    constructor(fn, { getArgsFn = (_, { args = [] } = {}) => args, isLazy = false } = {}) {
+    constructor(fn, { getArgsFn = forwardArgs, isLazy = false } = {}) {
         super();
         this.fn = fn;
         this._getArgsFn = getArgsFn;

package/esm/token/GroupAliasToken.js

@@ -1,9 +1,9 @@
-import { InjectionToken } from './InjectionToken.js';
+import { forwardArgs, InjectionToken } from './InjectionToken.js';
 export class GroupAliasToken extends InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = () => [], isLazy = false } = {}) {
+    constructor(token, { getArgsFn = forwardArgs, isLazy = false } = {}) {
         super();
         this.token = token;
         this._getArgsFn = getArgsFn;

package/esm/token/InjectionToken.js

@@ -1,4 +1,5 @@
 import { Is } from '../utils/basic.js';
+export const forwardArgs = (_, { args = [] } = {}) => args;
 export class InjectionToken {
 }
 export function isInjectionToken(target) {

package/esm/token/SingleAliasToken.js

@@ -1,9 +1,9 @@
-import { InjectionToken } from './InjectionToken.js';
+import { forwardArgs, InjectionToken } from './InjectionToken.js';
 export class SingleAliasToken extends InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = () => [], isLazy = false } = {}) {
+    constructor(token, { getArgsFn = forwardArgs, isLazy = false } = {}) {
         super();
         this.token = token;
         this._getArgsFn = getArgsFn;

package/esm/token/SingleToken.js

@@ -1,9 +1,9 @@
-import { InjectionToken } from './InjectionToken.js';
+import { forwardArgs, InjectionToken } from './InjectionToken.js';
 export class SingleToken extends InjectionToken {
     token;
     _getArgsFn;
     _isLazy;
-    constructor(token, { getArgsFn = () => [], isLazy = false } = {}) {
+    constructor(token, { getArgsFn = forwardArgs, isLazy = false } = {}) {
         super();
         this.token = token;
         this._getArgsFn = getArgsFn;

package/esm/utils/array.js

@@ -1,6 +1,14 @@
+import { ArgumentNotFoundError } from '../errors/ArgumentNotFoundError.js';
 export const Filter = {
     exclude: (arr) => {
         const excludeSet = arr instanceof Array ? new Set(arr) : arr;
         return (v) => !excludeSet.has(v);
     },
 };
+export const findOrFail = (predicate) => (...args) => {
+    const index = args.findIndex((arg) => predicate(arg));
+    if (index === -1) {
+        throw new ArgumentNotFoundError();
+    }
+    return args[index];
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-ioc-container",
-  "version": "68.0.0",
+  "version": "69.0.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/errors/ArgumentNotFoundError.d.ts

@@ -0,0 +1,5 @@
+import { ContainerError } from './ContainerError.js';
+export declare class ArgumentNotFoundError extends ContainerError {
+    name: string;
+    constructor(message?: string);
+}

package/typings/index.d.ts

@@ -20,6 +20,7 @@ export { ProviderDisposedError } from './errors/ProviderDisposedError.js';
 export { CannonSingletonApplyTwiceError } from './errors/CannonSingletonApplyTwiceError.js';
 export { UnsupportedTokenTypeError } from './errors/UnsupportedTokenTypeError.js';
 export { TypedEventDisposedError } from './errors/TypedEventDisposedError.js';
+export { ArgumentNotFoundError } from './errors/ArgumentNotFoundError.js';
 export { getHooks, hook, hasHooks, toHookFn, type HookFn, type HookClass, type HookType, type InjectFn, type HooksOfClass, } from './hooks/hook.js';
 export { HookContext, createHookContextFactory, createHookExecutionContext, type CreateHookExecutionContext, type IHookContext, } from './hooks/HookContext.js';
 export { injectProp } from './hooks/injectProp.js';
@@ -50,5 +51,6 @@ export { TypedEvent, type ITypedEvent, type TypedEventListener, type Unsubscribe
 export { type ExecutionContext } from './ExecutionContext.js';
 export { select } from './select.js';
 export { pipe, type MapFn } from './utils/fp.js';
+export { findOrFail, type Predicate } from './utils/array.js';
 export { ProxyRegistry, unwrapProxy, type IProxyRegistry } from './utils/ProxyRegistry.js';
 export { type Branded, type constructor, type Instance, Is } from './utils/basic.js';

package/typings/token/InjectionToken.d.ts

@@ -1,5 +1,6 @@
 import { type IContainer } from '../container/IContainer.js';
-import { ProviderOptions } from '../provider/IProvider.js';
+import { ArgsFn, ProviderOptions } from '../provider/IProvider.js';
+export declare const forwardArgs: ArgsFn;
 export declare abstract class InjectionToken<T = any> {
     abstract resolve(s: IContainer, options?: ProviderOptions): T;
     abstract args(...deps: unknown[]): InjectionToken<T>;

package/typings/utils/array.d.ts

@@ -1,3 +1,5 @@
+export type Predicate<T> = (value: T) => boolean;
 export declare const Filter: {
     exclude: <T>(arr: Set<T> | T[]) => (v: T) => boolean;
 };
+export declare const findOrFail: <T>(predicate: Predicate<T>) => (...args: unknown[]) => T;