ts-ioc-container 56.3.0 → 57.0.0

package/README.md

@@ -708,7 +708,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 +1017,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 +1391,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 +1458,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 +1472,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(
@@ -1632,14 +1632,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 +1655,7 @@ const userToken = ApiToken.args('https://users.api.com', 1000);
 
 ```typescript
 import {
-  args,
+  arg,
   appendArgs,
   appendArgsFn,
   bindTo,
@@ -1686,7 +1687,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 +1701,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 +1724,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 +1741,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 +1761,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 +1800,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 +1809,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 +2118,7 @@ Sometimes you want to decorate you class with some logic. Use the `decorate(...)
 
 ```typescript
 import {
-  args,
+  arg,
   bindTo,
   Container,
   decorate,
@@ -2171,7 +2172,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/index.js

@@ -1,7 +1,7 @@
 "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.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;
 var IContainer_1 = require("./container/IContainer");
 Object.defineProperty(exports, "isDependencyKey", { enumerable: true, get: function () { return IContainer_1.isDependencyKey; } });
 var Container_1 = require("./container/Container");
@@ -13,6 +13,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; } });

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/esm/index.js

@@ -2,7 +2,7 @@ export { isDependencyKey, } from './container/IContainer.js';
 export { Container } from './container/Container.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';

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-ioc-container",
-  "version": "56.3.0",
+  "version": "57.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/index.d.ts

@@ -2,7 +2,7 @@ export { type IContainer, type Resolvable, type IContainerModule, type Dependenc
 export { Container } from './container/Container.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';

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