assemblerjs 1.1.1 → 1.1.3

package/dist/index.d.ts

@@ -79,7 +79,8 @@ declare abstract class AbstractInjectable<T> {
     abstract readonly privateContext: AssemblerPrivateContext;
     abstract readonly publicContext: AssemblerContext;
     abstract readonly identifier: Identifier<T> | string | symbol;
-    abstract readonly concrete: Concrete<T>;
+    abstract readonly concrete?: Concrete<T>;
+    abstract readonly factory?: Factory<T>;
     abstract readonly configuration: Record<string, any>;
     abstract dependencies: (Identifier<unknown> | any)[];
     abstract definition: AssemblageDefinition;
@@ -310,6 +311,14 @@ export declare interface AssemblageDefinition {
  * `assembler.js` dependency injection container and handler.
  */
 export declare class Assembler extends EventManager implements AbstractAssembler {
+    /**
+     * Enable debug mode with optional configuration
+     */
+    static enableDebug(options?: AssemblerDebugOptions): void;
+    /**
+     * Disable debug mode
+     */
+    static disableDebug(): void;
     /**
      * Build the dependencies tree from an assemblage as entry point.
      *
@@ -370,6 +379,24 @@ export declare interface AssemblerContext {
     events: AbstractAssembler['channels'];
 }
 
+/**
+ * Debug options for Assembler build process
+ */
+export declare interface AssemblerDebugOptions {
+    enabled?: boolean;
+    logger?: (level: 'info' | 'warn' | 'error', message: string, data?: any) => void;
+    logPhases?: {
+        registration?: boolean;
+        resolution?: boolean;
+        construction?: boolean;
+        hooks?: boolean;
+        cache?: boolean;
+    };
+    logTimings?: boolean;
+    logDependencyTree?: boolean;
+    useColors?: boolean;
+}
+
 /**
  * `Assembler` dispose method type.
  */
@@ -429,8 +456,9 @@ export declare function Before(pointcut: string, priority?: number): (target: an
  */
 declare interface Buildable<T> {
     identifier: Identifier<T>;
-    concrete: Concrete<T>;
+    concrete?: Concrete<T>;
     instance?: T;
+    factory?: () => T;
     configuration: Record<string, any>;
 }
 
@@ -557,7 +585,7 @@ export declare const decorateGlobal: (identifier: string | symbol, target: any,
  * @param target The target class
  * @param index The parameter index
  */
-export declare const decorateUse: (identifier: string | symbol, target: any, index: number) => void;
+export declare const decorateUse: (identifier: UseIdentifier, target: any, index: number) => void;
 
 /**
  * Type for a function that creates a decorator.
@@ -621,6 +649,11 @@ export declare class EventManager implements AbstractEventManager {
     private cleanChannel;
 }
 
+/**
+ * Factory function that returns an instance of type T.
+ */
+declare type Factory<T> = () => T;
+
 export declare const getAssemblageContext: <T>(target: Concrete<T> | Function) => AssemblerContext;
 
 export declare const getAssemblageDefinition: <T>(target: Concrete<T>) => AssemblageDefinition;
@@ -698,7 +731,7 @@ declare class Injectable<T> implements AbstractInjectable<T> {
     /** Unique identifier for this injectable. */
     readonly identifier: Identifier<T> | string | symbol;
     /** The concrete class to instantiate. */
-    readonly concrete: Concrete<T>;
+    readonly concrete: Concrete<T> | undefined;
     /** Base configuration for this injectable. */
     readonly configuration: Record<string, any>;
     /** Merged configuration used during build (base + runtime). */
@@ -720,6 +753,7 @@ declare class Injectable<T> implements AbstractInjectable<T> {
     private dependenciesIds;
     protected singletonInstance: T | undefined;
     private builder;
+    readonly factory?: () => T;
     static of<TNew>(buildable: Buildable<TNew>, privateContext: AssemblerPrivateContext, publicContext: AssemblerContext): Injectable<TNew>;
     private constructor();
     /**
@@ -834,9 +868,10 @@ declare interface InjectableResolver {
 declare type Injection<T> = BaseInjection<T> | ConfiguredInjection<T> | ConcreteInjection<T> | ConcreteConfiguredInjection<T>;
 
 /**
- * Injectable binds an instance of a class to an identifier (abstract or concrete).
+ * Injectable binds an instance or factory of a class to an identifier (abstract or concrete).
+ * The second element can be either an instance or a factory function that returns an instance.
  */
-declare type InstanceInjection<T> = Tuple<[Identifier<T> | string | symbol, T]>;
+declare type InstanceInjection<T> = Tuple<[Identifier<T> | string | symbol, T | Factory<T>]>;
 
 /**
  * Check if a given class is an `Assemblage`.
@@ -1307,10 +1342,20 @@ export declare interface TransversalMetadata {
 }
 
 /**
- * Injects an object passed with `string` or `symbol` identifier.
+ * Injects an object passed with `string`, `symbol` or abstract class identifier.
+ * The identifier can be:
+ * - A string: @Use('logger')
+ * - A symbol: @Use(Symbol.for('logger'))
+ * - An abstract class: @Use(ILogger)
+ *
  * @param identifier The identifier of the object to inject
  * @returns A parameter decorator
  */
-export declare const Use: (param?: string | symbol | undefined) => ParameterDecorator;
+export declare const Use: (param?: UseIdentifier | undefined) => ParameterDecorator;
+
+/**
+ * Identifier can be a string, symbol, or an abstract class/interface.
+ */
+export declare type UseIdentifier = string | symbol | Function;
 
 export { }

package/dist/index13.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const core = require('@assemblerjs/core');
-const pointcutMatcher = require('./index39.js');
+const pointcutMatcher = require('./index40.js');
 const affect = require('./index12.js');
 const schema = require('./index30.js');
 

package/dist/index13.mjs

@@ -1,5 +1,5 @@
 import { isClass } from '@assemblerjs/core';
-import { PointcutMatcher } from './index39.mjs';
+import { PointcutMatcher } from './index40.mjs';
 import { getAffectedMethods } from './index12.mjs';
 import { getDefinition } from './index30.mjs';
 

package/dist/index18.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const parameterDecoratorFactory = require('./index17.js');
-const resolverStore = require('./index31.js');
+const resolverStore = require('./index32.js');
 
 let ContextResolver = class ContextResolver {
     resolve(e, r, t) {

package/dist/index18.mjs

@@ -1,5 +1,5 @@
 import { ParameterDecoratorFactory } from './index17.mjs';
-import { ResolverStore } from './index31.mjs';
+import { ResolverStore } from './index32.mjs';
 
 let ContextResolver = class ContextResolver {
     resolve(e, r, t) {

package/dist/index19.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const parameterDecoratorFactory = require('./index17.js');
-const resolverStore = require('./index31.js');
+const resolverStore = require('./index32.js');
 
 let ConfigurationResolver = class ConfigurationResolver {
     resolve(r, o, e, n) {

package/dist/index19.mjs

@@ -1,5 +1,5 @@
 import { ParameterDecoratorFactory } from './index17.mjs';
-import { ResolverStore } from './index31.mjs';
+import { ResolverStore } from './index32.mjs';
 
 let ConfigurationResolver = class ConfigurationResolver {
     resolve(r, o, e, n) {

package/dist/index20.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const parameterDecoratorFactory = require('./index17.js');
-const resolverStore = require('./index31.js');
+const resolverStore = require('./index32.js');
 
 let DefinitionResolver = class DefinitionResolver {
     resolve(e, r) {

package/dist/index20.mjs

@@ -1,5 +1,5 @@
 import { ParameterDecoratorFactory } from './index17.mjs';
-import { ResolverStore } from './index31.mjs';
+import { ResolverStore } from './index32.mjs';
 
 let DefinitionResolver = class DefinitionResolver {
     resolve(e, r) {

package/dist/index21.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const parameterDecoratorFactory = require('./index17.js');
-const resolverStore = require('./index31.js');
+const resolverStore = require('./index32.js');
 
 let DisposeResolver = class DisposeResolver {
     resolve(e, r, s) {

package/dist/index21.mjs

@@ -1,5 +1,5 @@
 import { ParameterDecoratorFactory } from './index17.mjs';
-import { ResolverStore } from './index31.mjs';
+import { ResolverStore } from './index32.mjs';
 
 let DisposeResolver = class DisposeResolver {
     resolve(e, r, s) {

package/dist/index22.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const reflection = require('./index29.js');
 const parameterDecoratorFactory = require('./index17.js');
 const helpers = require('./index25.js');
-const resolverStore = require('./index31.js');
+const resolverStore = require('./index32.js');
 
 let UseResolver = class UseResolver {
     resolve(r, o, t) {

package/dist/index22.mjs

@@ -1,7 +1,7 @@
 import { getOwnCustomMetadata } from './index29.mjs';
 import { ParameterDecoratorFactory } from './index17.mjs';
 import { getParamValueKey } from './index25.mjs';
-import { ResolverStore } from './index31.mjs';
+import { ResolverStore } from './index32.mjs';
 
 let UseResolver = class UseResolver {
     resolve(r, o, t) {

package/dist/index23.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const reflection = require('./index29.js');
 const parameterDecoratorFactory = require('./index17.js');
 const helpers = require('./index25.js');
-const resolverStore = require('./index31.js');
+const resolverStore = require('./index32.js');
 
 let GlobalResolver = class GlobalResolver {
     resolve(e, r, a) {

package/dist/index23.mjs

@@ -1,7 +1,7 @@
 import { getOwnCustomMetadata } from './index29.mjs';
 import { ParameterDecoratorFactory } from './index17.mjs';
 import { getParamValueKey } from './index25.mjs';
-import { ResolverStore } from './index31.mjs';
+import { ResolverStore } from './index32.mjs';
 
 let GlobalResolver = class GlobalResolver {
     resolve(e, r, a) {

package/dist/index24.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const reflection = require('./index29.js');
 const parameterDecoratorFactory = require('./index17.js');
 const helpers = require('./index25.js');
-const resolverStore = require('./index31.js');
+const resolverStore = require('./index32.js');
 
 let OptionalResolver = class OptionalResolver {
     resolve(o, t, n) {

package/dist/index24.mjs

@@ -1,7 +1,7 @@
 import { getParamTypes, getOwnCustomMetadata } from './index29.mjs';
 import { ParameterDecoratorFactory } from './index17.mjs';
 import { getParamValueKey } from './index25.mjs';
-import { ResolverStore } from './index31.mjs';
+import { ResolverStore } from './index32.mjs';
 
 let OptionalResolver = class OptionalResolver {
     resolve(o, t, n) {

package/dist/index27.js

@@ -1,5 +1,5 @@
 'use strict';
 
-const Reflect = require('./index44.js');
+const Reflect = require('./index45.js');
 
 Reflect.__require();

package/dist/index27.mjs

@@ -1,3 +1,3 @@
-import { __require as require_Reflect } from './index44.mjs';
+import { __require as require_Reflect } from './index45.mjs';
 
 require_Reflect();

package/dist/index30.js

@@ -31,9 +31,15 @@ const n = {
         transform: (r)=>r
     },
     use: {
-        test: (r)=>typeof r === 'undefined' || Array.isArray(r) && r.every((r)=>Array.isArray(r) && r.length == 2),
+        test: (r)=>typeof r === 'undefined' || Array.isArray(r) && r.every((r)=>{
+                if (!Array.isArray(r) || r.length !== 2) {
+                    return false;
+                }
+                const e = r[1];
+                return typeof e !== 'undefined';
+            }),
         throw: ()=>{
-            throw new Error(`'use' property must be an array of tuples of length 2.`);
+            throw new Error(`'use' property must be an array of tuples of length 2 with [identifier, instance | factory].`);
         },
         transform: (r)=>r
     },

package/dist/index30.mjs

@@ -27,9 +27,15 @@ const n = {
         transform: (r)=>r
     },
     use: {
-        test: (r)=>typeof r === 'undefined' || Array.isArray(r) && r.every((r)=>Array.isArray(r) && r.length == 2),
+        test: (r)=>typeof r === 'undefined' || Array.isArray(r) && r.every((r)=>{
+                if (!Array.isArray(r) || r.length !== 2) {
+                    return false;
+                }
+                const e = r[1];
+                return typeof e !== 'undefined';
+            }),
         throw: ()=>{
-            throw new Error(`'use' property must be an array of tuples of length 2.`);
+            throw new Error(`'use' property must be an array of tuples of length 2 with [identifier, instance | factory].`);
         },
         transform: (r)=>r
     },

package/dist/index31.js

@@ -2,27 +2,45 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-class ResolverStore {
-    static register(e, r) {
-        this.resolvers.set(e, r);
-    }
-    static getResolver(e) {
-        const r = this.resolvers.get(e);
-        if (!r) {
-            throw new Error(`No resolver found for decorator type: ${e}`);
+const eventManager = require('./index6.js');
+
+const registerEvents = (t, n)=>{
+    const o = t.concrete !== undefined && t.concrete.prototype instanceof eventManager.EventManager;
+    if (o) {
+        const e = n;
+        const o = e.channels;
+        for (const n of t.events){
+            if (!o.has(n)) e.addChannels(n);
+            if (!t.privateContext.events.has(n)) t.privateContext.addChannels(n);
+        }
+        for (const e of t.events){
+            n.on(e, (...n)=>{
+                t.privateContext.emit(e, ...n);
+            });
+        }
+    } else {
+        for (const e of t.events){
+            if (!t.privateContext.events.has(e)) t.privateContext.addChannels(e);
         }
-        return new r();
-    }
-    static hasResolver(e) {
-        return this.resolvers.has(e);
-    }
-    static getRegisteredTypes() {
-        return Array.from(this.resolvers.keys());
     }
-    static clear() {
-        this.resolvers.clear();
+};
+const unregisterEvents = (t, n)=>{
+    const o = t.concrete !== undefined && t.concrete.prototype instanceof eventManager.EventManager;
+    if (o) {
+        const e = n;
+        for (const n of t.events){
+            e.off(n);
+        }
+        e.removeChannels(...t.events);
+        t.privateContext.removeChannels(...t.events);
+    } else {
+        for (const e of t.events){
+            if (t.privateContext.events.has(e)) {
+                t.privateContext.removeChannels(e);
+            }
+        }
     }
-}
-ResolverStore.resolvers = new Map();
+};
 
-exports.ResolverStore = ResolverStore;
+exports.registerEvents = registerEvents;
+exports.unregisterEvents = unregisterEvents;

package/dist/index31.mjs

@@ -1,24 +1,41 @@
-class ResolverStore {
-    static register(e, r) {
-        this.resolvers.set(e, r);
-    }
-    static getResolver(e) {
-        const r = this.resolvers.get(e);
-        if (!r) {
-            throw new Error(`No resolver found for decorator type: ${e}`);
+import { EventManager } from './index6.mjs';
+
+const registerEvents = (t, n)=>{
+    const o = t.concrete !== undefined && t.concrete.prototype instanceof EventManager;
+    if (o) {
+        const e = n;
+        const o = e.channels;
+        for (const n of t.events){
+            if (!o.has(n)) e.addChannels(n);
+            if (!t.privateContext.events.has(n)) t.privateContext.addChannels(n);
+        }
+        for (const e of t.events){
+            n.on(e, (...n)=>{
+                t.privateContext.emit(e, ...n);
+            });
+        }
+    } else {
+        for (const e of t.events){
+            if (!t.privateContext.events.has(e)) t.privateContext.addChannels(e);
         }
-        return new r();
-    }
-    static hasResolver(e) {
-        return this.resolvers.has(e);
-    }
-    static getRegisteredTypes() {
-        return Array.from(this.resolvers.keys());
     }
-    static clear() {
-        this.resolvers.clear();
+};
+const unregisterEvents = (t, n)=>{
+    const o = t.concrete !== undefined && t.concrete.prototype instanceof EventManager;
+    if (o) {
+        const e = n;
+        for (const n of t.events){
+            e.off(n);
+        }
+        e.removeChannels(...t.events);
+        t.privateContext.removeChannels(...t.events);
+    } else {
+        for (const e of t.events){
+            if (t.privateContext.events.has(e)) {
+                t.privateContext.removeChannels(e);
+            }
+        }
     }
-}
-ResolverStore.resolvers = new Map();
+};
 
-export { ResolverStore };
+export { registerEvents, unregisterEvents };

package/dist/index32.js

@@ -2,68 +2,27 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const hookManager = require('./index34.js');
-const resolutionStrategies = require('./index42.js');
-const use = require('./index41.js');
-const inject = require('./index40.js');
-const injectable = require('./index43.js');
-
-class InjectableManager {
-    setContexts(e, t) {
-        this.privateContext = e;
-        this.publicContext = t;
-    }
-    register(r, n = false) {
-        const o = n === true ? use.resolveInstanceInjectionTuple(r) : inject.resolveInjectionTuple(r);
-        if (this.has(o.identifier)) {
-            throw new Error(`An assemblage is already registered with identifier '${o.identifier.name}'.`);
-        }
-        const a = injectable.Injectable.of(o, this.privateContext, this.publicContext);
-        this.injectables.set(a.identifier, a);
-        hookManager.HookManager.callHook(a.concrete, 'onRegister', this.publicContext, a.configuration);
-        return a;
-    }
-    has(e) {
-        return this.injectables.has(e);
-    }
-    require(e, t) {
-        if (!this.injectables.has(e)) {
-            throw new Error(`Class with identifier '${e.name}' has not been registered or is a circular dependency.`);
+class ResolverStore {
+    static register(e, r) {
+        this.resolvers.set(e, r);
+    }
+    static getResolver(e) {
+        const r = this.resolvers.get(e);
+        if (!r) {
+            throw new Error(`No resolver found for decorator type: ${e}`);
         }
-        const i = this.injectables.get(e);
-        if (i.isSingleton) {
-            return this.singletonStrategy.resolve(i, t);
-        } else {
-            return this.transientStrategy.resolve(i, t);
-        }
-    }
-    concrete(e) {
-        const t = this.injectables.get(e);
-        if (t) return t.concrete;
-        return;
+        return new r();
     }
-    tagged(...e) {
-        const t = [];
-        for (const i of e){
-            for (const [e, s] of this.injectables){
-                if (s.tags.includes(i)) t.push(s.build());
-            }
-        }
-        return t;
-    }
-    dispose() {
-        for (const [e, t] of this.injectables){
-            t.dispose();
-        }
+    static hasResolver(e) {
+        return this.resolvers.has(e);
     }
-    get size() {
-        return this.injectables.size;
+    static getRegisteredTypes() {
+        return Array.from(this.resolvers.keys());
     }
-    constructor(){
-        this.injectables = new Map();
-        this.singletonStrategy = new resolutionStrategies.SingletonStrategy();
-        this.transientStrategy = new resolutionStrategies.TransientStrategy();
+    static clear() {
+        this.resolvers.clear();
     }
 }
+ResolverStore.resolvers = new Map();
 
-exports.InjectableManager = InjectableManager;
+exports.ResolverStore = ResolverStore;

package/dist/index32.mjs

@@ -1,65 +1,24 @@
-import { HookManager } from './index34.mjs';
-import { SingletonStrategy, TransientStrategy } from './index42.mjs';
-import { resolveInstanceInjectionTuple } from './index41.mjs';
-import { resolveInjectionTuple } from './index40.mjs';
-import { Injectable } from './index43.mjs';
-
-class InjectableManager {
-    setContexts(e, t) {
-        this.privateContext = e;
-        this.publicContext = t;
-    }
-    register(r, n = false) {
-        const o = n === true ? resolveInstanceInjectionTuple(r) : resolveInjectionTuple(r);
-        if (this.has(o.identifier)) {
-            throw new Error(`An assemblage is already registered with identifier '${o.identifier.name}'.`);
-        }
-        const a = Injectable.of(o, this.privateContext, this.publicContext);
-        this.injectables.set(a.identifier, a);
-        HookManager.callHook(a.concrete, 'onRegister', this.publicContext, a.configuration);
-        return a;
-    }
-    has(e) {
-        return this.injectables.has(e);
-    }
-    require(e, t) {
-        if (!this.injectables.has(e)) {
-            throw new Error(`Class with identifier '${e.name}' has not been registered or is a circular dependency.`);
+class ResolverStore {
+    static register(e, r) {
+        this.resolvers.set(e, r);
+    }
+    static getResolver(e) {
+        const r = this.resolvers.get(e);
+        if (!r) {
+            throw new Error(`No resolver found for decorator type: ${e}`);
         }
-        const i = this.injectables.get(e);
-        if (i.isSingleton) {
-            return this.singletonStrategy.resolve(i, t);
-        } else {
-            return this.transientStrategy.resolve(i, t);
-        }
-    }
-    concrete(e) {
-        const t = this.injectables.get(e);
-        if (t) return t.concrete;
-        return;
+        return new r();
     }
-    tagged(...e) {
-        const t = [];
-        for (const i of e){
-            for (const [e, s] of this.injectables){
-                if (s.tags.includes(i)) t.push(s.build());
-            }
-        }
-        return t;
-    }
-    dispose() {
-        for (const [e, t] of this.injectables){
-            t.dispose();
-        }
+    static hasResolver(e) {
+        return this.resolvers.has(e);
     }
-    get size() {
-        return this.injectables.size;
+    static getRegisteredTypes() {
+        return Array.from(this.resolvers.keys());
     }
-    constructor(){
-        this.injectables = new Map();
-        this.singletonStrategy = new SingletonStrategy();
-        this.transientStrategy = new TransientStrategy();
+    static clear() {
+        this.resolvers.clear();
     }
 }
+ResolverStore.resolvers = new Map();
 
-export { InjectableManager };
+export { ResolverStore };