ts-ioc-container 72.0.0 → 72.1.0

package/README.md

@@ -52,6 +52,7 @@ provider pipelines, aliases, and custom injector strategies.
 - [Registration](#registration) `@register`
   - [Token](#token) `bindTo`
   - [Scope](#scope) `scope`
+  - [Composing decorators](#composing-decorators) `createComposeClassDecorator`
 - [Module](#module)
 - [Hook](#hook) `@hook`
   - [Hook domains](#hook-domains) `ScopeHook` `InjectorHook` `ProviderHook`
@@ -164,6 +165,7 @@ describe('Quickstart', function () {
 - Custom inject function: `@inject(({ scope, args }) => ...)`
 - Map an injected value: `@inject(pipe(by('Key'), sanitize(), validate()))`
 - Property inject: `@hook('onInit', injectProp(by('Key')))`
+- Name a decorator stack: `const repository = (token) => createComposeClassDecorator(register(token, singleton()), addClassMeta('injection-token', () => token))`
 
 > [!TIP]
 > For classes, prefer the `@register(bindTo('Key'))` decorator over the fluent
@@ -2793,6 +2795,98 @@ describe('Scopes', function () {
 
 ```
 
+### Composing decorators
+
+A decorator stack repeated on every class of a layer is worth a name.
+`createComposeClassDecorator(...decorators)` gives it one: it returns a single
+`ClassDecorator` which applies the stack **bottom-up, exactly as stacking would**,
+so `@createComposeClassDecorator(a, b)` behaves like `@a @b`. A decorator which
+returns a replacement class hands it to the next one, the way the runtime threads
+a stack.
+
+`createComposeMethodDecorator` and `createComposeParameterDecorator` do the same
+for methods and constructor parameters. The method form threads the property
+descriptor, so wrapping decorators (`@once`, `@throttle`, ...) compose too.
+
+```typescript
+import {
+  addClassMeta,
+  Container,
+  createComposeClassDecorator,
+  createComposeParameterDecorator,
+  getClassMeta,
+  inject,
+  by,
+  addParamLabel,
+  getParamLabels,
+  register,
+  Registration as R,
+  scope,
+  singleton,
+  SingleToken,
+} from 'ts-ioc-container';
+
+/**
+ * A decorator stack repeated on every class of a layer is worth a name.
+ * `createComposeClassDecorator` (and its `createComposeMethodDecorator` /
+ * `createComposeParameterDecorator` siblings) turns one into a single decorator,
+ * applied bottom-up exactly as stacking would.
+ */
+describe('composing decorators', () => {
+  const INJECTION_TOKEN = 'injection-token';
+
+  // Every repository binds to its own token, is an application-scoped singleton,
+  // and remembers the token it was registered under.
+  const repository = <T>(token: SingleToken<T>) =>
+    createComposeClassDecorator(
+      register(
+        token,
+        scope((s) => s.hasTag('application')),
+        singleton(),
+      ),
+      addClassMeta(INJECTION_TOKEN, () => token),
+    );
+
+  it('should apply the whole stack the composed decorator stands for', () => {
+    const UserRepositoryToken = new SingleToken<UserRepository>('IUserRepository');
+
+    @repository(UserRepositoryToken)
+    class UserRepository {
+      findById(id: string) {
+        return { id };
+      }
+    }
+
+    const app = new Container({ tags: ['application'] }).addRegistration(R.fromClass(UserRepository));
+
+    expect(UserRepositoryToken.resolve(app)).toBeInstanceOf(UserRepository);
+    // singleton() applied, so the same instance comes back
+    expect(UserRepositoryToken.resolve(app)).toBe(UserRepositoryToken.resolve(app));
+    // and the class still carries the metadata written beside the registration
+    expect(getClassMeta(UserRepository, INJECTION_TOKEN)).toBe(UserRepositoryToken);
+  });
+
+  it('should compose parameter decorators the same way', () => {
+    const ConfigToken = new SingleToken<{ apiUrl: string }>('IConfig');
+
+    // @inject plus a label describing where the value came from
+    const fromConfig = createComposeParameterDecorator(inject(by(ConfigToken)), addParamLabel('source', 'config'));
+
+    class ApiClient {
+      constructor(@fromConfig public config: { apiUrl: string }) {}
+    }
+
+    const app = new Container({ tags: ['application'] }).addRegistration(
+      R.fromValue({ apiUrl: 'https://api.example.com' }).bindTo(ConfigToken),
+    );
+
+    expect(app.resolve(ApiClient).config.apiUrl).toBe('https://api.example.com');
+    expect(getParamLabels(ApiClient, 0).get('source')).toBe('config');
+  });
+});
+
+```
+
 ## Module
 
 Sometimes you want to encapsulate registration logic in separate module. This is what `IContainerModule` is for.

package/cjm/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 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.by = exports.argsFn = exports.args = exports.arg = exports.inject = exports.MetadataInjector = exports.Injector = exports.EmptyContainer = exports.AutoResolveModule = exports.Container = exports.isDependencyKey = void 0;
-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.toToken = exports.forwardArgs = exports.isInjectionToken = exports.InjectionToken = exports.toTask = exports.HookCollector = exports.oncePerInstance = exports.parallel = exports.sequential = exports.injectProp = void 0;
-exports.isSerializable = exports.Is = exports.unwrapProxy = exports.ProxyRegistry = exports.findOrFail = exports.pipe = exports.select = void 0;
+exports.once = exports.shallowCache = exports.debounce = exports.throttle = exports.runAtOnce = exports.runInOrder = exports.handleAsyncError = exports.handleError = exports.createComposeMethodDecorator = exports.getMethodTags = exports.addMethodTag = exports.getMethodLabels = exports.addMethodLabel = exports.getMethodMeta = exports.addMethodMeta = exports.createComposeParameterDecorator = exports.getParamTags = exports.addParamTag = exports.getParamLabels = exports.addParamLabel = exports.getParamMeta = exports.addParamMeta = exports.createComposeClassDecorator = 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.toToken = exports.forwardArgs = exports.isInjectionToken = exports.InjectionToken = exports.toTask = exports.HookCollector = exports.oncePerInstance = exports.parallel = exports.sequential = exports.injectProp = void 0;
+exports.isSerializable = exports.Is = exports.unwrapProxy = exports.ProxyRegistry = exports.findOrFail = exports.pipe = exports.select = exports.TypedEvent = exports.getConstructorChain = exports.memoize = 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");
@@ -118,6 +118,7 @@ Object.defineProperty(exports, "addClassLabel", { enumerable: true, get: functio
 Object.defineProperty(exports, "getClassLabels", { enumerable: true, get: function () { return class_1.getClassLabels; } });
 Object.defineProperty(exports, "addClassTag", { enumerable: true, get: function () { return class_1.addClassTag; } });
 Object.defineProperty(exports, "getClassTags", { enumerable: true, get: function () { return class_1.getClassTags; } });
+Object.defineProperty(exports, "createComposeClassDecorator", { enumerable: true, get: function () { return class_1.createComposeClassDecorator; } });
 var parameter_1 = require("./metadata/parameter");
 Object.defineProperty(exports, "addParamMeta", { enumerable: true, get: function () { return parameter_1.addParamMeta; } });
 Object.defineProperty(exports, "getParamMeta", { enumerable: true, get: function () { return parameter_1.getParamMeta; } });
@@ -125,6 +126,7 @@ Object.defineProperty(exports, "addParamLabel", { enumerable: true, get: functio
 Object.defineProperty(exports, "getParamLabels", { enumerable: true, get: function () { return parameter_1.getParamLabels; } });
 Object.defineProperty(exports, "addParamTag", { enumerable: true, get: function () { return parameter_1.addParamTag; } });
 Object.defineProperty(exports, "getParamTags", { enumerable: true, get: function () { return parameter_1.getParamTags; } });
+Object.defineProperty(exports, "createComposeParameterDecorator", { enumerable: true, get: function () { return parameter_1.createComposeParameterDecorator; } });
 var method_1 = require("./metadata/method");
 Object.defineProperty(exports, "addMethodMeta", { enumerable: true, get: function () { return method_1.addMethodMeta; } });
 Object.defineProperty(exports, "getMethodMeta", { enumerable: true, get: function () { return method_1.getMethodMeta; } });
@@ -132,6 +134,7 @@ Object.defineProperty(exports, "addMethodLabel", { enumerable: true, get: functi
 Object.defineProperty(exports, "getMethodLabels", { enumerable: true, get: function () { return method_1.getMethodLabels; } });
 Object.defineProperty(exports, "addMethodTag", { enumerable: true, get: function () { return method_1.addMethodTag; } });
 Object.defineProperty(exports, "getMethodTags", { enumerable: true, get: function () { return method_1.getMethodTags; } });
+Object.defineProperty(exports, "createComposeMethodDecorator", { enumerable: true, get: function () { return method_1.createComposeMethodDecorator; } });
 var errorHandler_1 = require("./utils/errorHandler");
 Object.defineProperty(exports, "handleError", { enumerable: true, get: function () { return errorHandler_1.handleError; } });
 Object.defineProperty(exports, "handleAsyncError", { enumerable: true, get: function () { return errorHandler_1.handleAsyncError; } });

package/cjm/metadata/class.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getClassTags = exports.addClassTag = exports.getClassLabels = exports.addClassLabel = exports.addClassMeta = void 0;
+exports.createComposeClassDecorator = exports.getClassTags = exports.addClassTag = exports.getClassLabels = exports.addClassLabel = exports.addClassMeta = void 0;
 exports.getClassMeta = getClassMeta;
 const target_1 = require("./target");
 const addClassMeta = (key, mapFn) => (target) => {
@@ -19,3 +19,5 @@ const addClassTag = (tag) => (0, exports.addClassMeta)('tag', (prev = new Set())
 exports.addClassTag = addClassTag;
 const getClassTags = (target) => getClassMeta(target, 'tag') ?? new Set();
 exports.getClassTags = getClassTags;
+const createComposeClassDecorator = (...decorators) => (target) => decorators.reduceRight((acc, decorate) => decorate(acc) ?? acc, target);
+exports.createComposeClassDecorator = createComposeClassDecorator;

package/cjm/metadata/method.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMethodTags = exports.addMethodTag = exports.getMethodLabels = exports.addMethodLabel = exports.getMethodMeta = exports.addMethodMeta = void 0;
+exports.createComposeMethodDecorator = exports.getMethodTags = exports.addMethodTag = exports.getMethodLabels = exports.addMethodLabel = exports.getMethodMeta = exports.addMethodMeta = void 0;
 const target_1 = require("./target");
 const addMethodMeta = (key, mapFn) => (target, propertyKey) => {
     const metadata = Reflect.getMetadata(key, target.constructor, propertyKey);
@@ -17,3 +17,5 @@ const addMethodTag = (tag) => (0, exports.addMethodMeta)('tag', (prev = new Set(
 exports.addMethodTag = addMethodTag;
 const getMethodTags = (target, propertyKey) => (0, exports.getMethodMeta)('tag', target, propertyKey) ?? new Set();
 exports.getMethodTags = getMethodTags;
+const createComposeMethodDecorator = (...decorators) => (target, propertyKey, descriptor) => decorators.reduceRight((acc, decorate) => decorate(target, propertyKey, acc) ?? acc, descriptor);
+exports.createComposeMethodDecorator = createComposeMethodDecorator;

package/cjm/metadata/parameter.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getParamTags = exports.addParamTag = exports.getParamLabels = exports.addParamLabel = exports.getParamMeta = exports.addParamMeta = void 0;
+exports.createComposeParameterDecorator = exports.getParamTags = exports.addParamTag = exports.getParamLabels = exports.addParamLabel = exports.getParamMeta = exports.addParamMeta = void 0;
 const target_1 = require("./target");
 const addParamMeta = (key, mapFn) => (target, _, parameterIndex) => {
     const metadata = Reflect.getOwnMetadata(key, target) ?? [];
@@ -32,3 +32,9 @@ const getParamTags = (target, parameterIndex) => {
     return all[parameterIndex] ?? new Set();
 };
 exports.getParamTags = getParamTags;
+const createComposeParameterDecorator = (...decorators) => (target, propertyKey, parameterIndex) => {
+    for (let i = decorators.length - 1; i >= 0; i--) {
+        decorators[i](target, propertyKey, parameterIndex);
+    }
+};
+exports.createComposeParameterDecorator = createComposeParameterDecorator;

package/esm/index.js

@@ -35,9 +35,9 @@ export { FunctionToken } from './token/FunctionToken.js';
 export { ConstantToken } from './token/ConstantToken.js';
 export { GroupInstanceToken } from './token/GroupInstanceToken.js';
 export { resolveConstructor } from './metadata/target.js';
-export { addClassMeta, getClassMeta, addClassLabel, getClassLabels, addClassTag, getClassTags } from './metadata/class.js';
-export { addParamMeta, getParamMeta, addParamLabel, getParamLabels, addParamTag, getParamTags, } from './metadata/parameter.js';
-export { addMethodMeta, getMethodMeta, addMethodLabel, getMethodLabels, addMethodTag, getMethodTags, } from './metadata/method.js';
+export { addClassMeta, getClassMeta, addClassLabel, getClassLabels, addClassTag, getClassTags, createComposeClassDecorator, } from './metadata/class.js';
+export { addParamMeta, getParamMeta, addParamLabel, getParamLabels, addParamTag, getParamTags, createComposeParameterDecorator, } from './metadata/parameter.js';
+export { addMethodMeta, getMethodMeta, addMethodLabel, getMethodLabels, addMethodTag, getMethodTags, createComposeMethodDecorator, } from './metadata/method.js';
 export { handleError, handleAsyncError } from './utils/errorHandler.js';
 export { runInOrder, runAtOnce } from './utils/task.js';
 export { throttle } from './utils/throttle.js';

package/esm/metadata/class.js

@@ -10,3 +10,4 @@ export const addClassLabel = (key, label) => addClassMeta('label', (prev = new M
 export const getClassLabels = (target) => getClassMeta(target, 'label') ?? new Map();
 export const addClassTag = (tag) => addClassMeta('tag', (prev = new Set()) => prev.add(tag));
 export const getClassTags = (target) => getClassMeta(target, 'tag') ?? new Set();
+export const createComposeClassDecorator = (...decorators) => (target) => decorators.reduceRight((acc, decorate) => decorate(acc) ?? acc, target);

package/esm/metadata/method.js

@@ -8,3 +8,4 @@ export const addMethodLabel = (key, label) => addMethodMeta('label', (prev = new
 export const getMethodLabels = (target, propertyKey) => getMethodMeta('label', target, propertyKey) ?? new Map();
 export const addMethodTag = (tag) => addMethodMeta('tag', (prev = new Set()) => prev.add(tag));
 export const getMethodTags = (target, propertyKey) => getMethodMeta('tag', target, propertyKey) ?? new Set();
+export const createComposeMethodDecorator = (...decorators) => (target, propertyKey, descriptor) => decorators.reduceRight((acc, decorate) => decorate(target, propertyKey, acc) ?? acc, descriptor);

package/esm/metadata/parameter.js

@@ -23,3 +23,8 @@ export const getParamTags = (target, parameterIndex) => {
     const all = getParamMeta('tag', target);
     return all[parameterIndex] ?? new Set();
 };
+export const createComposeParameterDecorator = (...decorators) => (target, propertyKey, parameterIndex) => {
+    for (let i = decorators.length - 1; i >= 0; i--) {
+        decorators[i](target, propertyKey, parameterIndex);
+    }
+};

package/package.json

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

@@ -36,9 +36,9 @@ export { FunctionToken } from './token/FunctionToken.js';
 export { ConstantToken } from './token/ConstantToken.js';
 export { type InstancePredicate, GroupInstanceToken } from './token/GroupInstanceToken.js';
 export { resolveConstructor } from './metadata/target.js';
-export { addClassMeta, getClassMeta, addClassLabel, getClassLabels, addClassTag, getClassTags } from './metadata/class.js';
-export { addParamMeta, getParamMeta, addParamLabel, getParamLabels, addParamTag, getParamTags, } from './metadata/parameter.js';
-export { addMethodMeta, getMethodMeta, addMethodLabel, getMethodLabels, addMethodTag, getMethodTags, } from './metadata/method.js';
+export { addClassMeta, getClassMeta, addClassLabel, getClassLabels, addClassTag, getClassTags, createComposeClassDecorator, } from './metadata/class.js';
+export { addParamMeta, getParamMeta, addParamLabel, getParamLabels, addParamTag, getParamTags, createComposeParameterDecorator, } from './metadata/parameter.js';
+export { addMethodMeta, getMethodMeta, addMethodLabel, getMethodLabels, addMethodTag, getMethodTags, createComposeMethodDecorator, } from './metadata/method.js';
 export { handleError, handleAsyncError, type HandleErrorParams } from './utils/errorHandler.js';
 export { runInOrder, runAtOnce, type Task } from './utils/task.js';
 export { throttle } from './utils/throttle.js';

package/typings/metadata/class.d.ts

@@ -4,3 +4,4 @@ export declare const addClassLabel: (key: string, label: string) => ClassDecorat
 export declare const getClassLabels: (target: object) => Map<string, string>;
 export declare const addClassTag: (tag: string) => ClassDecorator;
 export declare const getClassTags: (target: object) => Set<string>;
+export declare const createComposeClassDecorator: (...decorators: ClassDecorator[]) => ClassDecorator;

package/typings/metadata/method.d.ts

@@ -4,3 +4,4 @@ export declare const addMethodLabel: (key: string, label: string) => MethodDecor
 export declare const getMethodLabels: (target: object, propertyKey: string) => Map<string, string>;
 export declare const addMethodTag: (tag: string) => MethodDecorator;
 export declare const getMethodTags: (target: object, propertyKey: string) => Set<string>;
+export declare const createComposeMethodDecorator: (...decorators: MethodDecorator[]) => MethodDecorator;

package/typings/metadata/parameter.d.ts

@@ -4,3 +4,4 @@ export declare const addParamLabel: (key: string, label: string) => ParameterDec
 export declare const getParamLabels: (target: object, parameterIndex: number) => Map<string, string>;
 export declare const addParamTag: (tag: string) => ParameterDecorator;
 export declare const getParamTags: (target: object, parameterIndex: number) => Set<string>;
+export declare const createComposeParameterDecorator: (...decorators: ParameterDecorator[]) => ParameterDecorator;