assemblerjs 0.1.0 → 0.3.0

package/README.md

@@ -21,3 +21,11 @@ npm install assemblerjs
 ```
 
 ## Usage
+
+### Order of execution
+
+- `onRegister` Static hook called when registering the assemblage.
+- `constructor` Build the instance.
+- `onInit` Called on every dependency when all dependencies have been built.
+
+- `onDispose` Called when disposing the assembler via `dispose` method injected by the `@Context` decorator.

package/dist/index.d.ts

@@ -32,10 +32,14 @@ export declare abstract class AbstractAssemblage {
      * Dispose the assemblage instance.
      */
     abstract dispose?(): void;
+    /**
+     * When decorated with '@Waitable', waits for a specific property to be truthy before resolving.
+     */
+    abstract whenReady?(): Promise<void>;
 }
 
-export declare abstract class AbstractAssembler {
-    abstract context: AssemblerContext;
+export declare abstract class AbstractAssembler extends AbstractEventManager {
+    abstract privateContext: AssemblerContext;
     abstract size: number;
     abstract register<T>(injection: Injection<T>): Injectable<T>;
     abstract has<T>(identifier: Identifier<T>): boolean;
@@ -45,6 +49,7 @@ export declare abstract class AbstractAssembler {
 }
 
 export declare abstract class AbstractEventManager {
+    abstract channels: Set<string>;
     abstract dispose(): void;
     abstract addChannels(...channels: string[]): AbstractEventManager;
     abstract removeChannels(...channels: string[]): AbstractEventManager;
@@ -76,10 +81,17 @@ declare interface AssemblageDefinition {
     metadata?: Record<string, any>;
 }
 
-export declare class Assembler implements AbstractAssembler {
+export declare class Assembler extends EventManager implements AbstractAssembler {
     protected injectables: Map<Identifier<unknown>, Injectable<unknown>>;
-    readonly context: AssemblerContext;
-    static build(entry: Concrete<any>): Assembler;
+    /**
+     * Context passed to internal classes.
+     */
+    readonly privateContext: AssemblerPrivateContext;
+    /**
+     * Context passed to assemblages.
+     */
+    readonly publicContext: AssemblerContext;
+    static build<T>(entry: Concrete<T>): T;
     private constructor();
     dispose(): void;
     /**
@@ -121,13 +133,37 @@ export declare interface AssemblerContext {
     has: AbstractAssembler['has'];
     require: AbstractAssembler['require'];
     tagged: AbstractAssembler['tagged'];
+    on: AbstractAssembler['on'];
+    once: AbstractAssembler['once'];
+    off: AbstractAssembler['off'];
+    events: AbstractAssembler['channels'];
 }
 
+export declare type AssemblerDispose = AbstractAssembler['dispose'];
+
+declare interface AssemblerPrivateContext extends AssemblerContext {
+    dispose: AssemblerDispose;
+    emit: AbstractAssembler['emit'];
+    addChannels: AbstractAssembler['addChannels'];
+    removeChannels: AbstractAssembler['removeChannels'];
+}
+
+export declare const Awaitable: (property: string, millis?: number) => (_target: any, _propertyKey: string, descriptor: TypedPropertyDescriptor<(...params: any[]) => Promise<any>>) => void;
+
 /**
  * Injectable binds a concrete class to an abstract class as identifier without configuration.
  */
 declare type BaseInjection<T> = Tuple<[Abstract<T>, Concrete<T>]>;
 
+/**
+ * Describes a buildable object.
+ */
+declare interface Buildable<T> {
+    identifier: Identifier<T>;
+    concrete: Concrete<T>;
+    configuration: Record<string, any>;
+}
+
 /**
  * A concrete (newable) class.
  */
@@ -165,10 +201,12 @@ export declare const Context: () => ParameterDecorator;
 
 export declare const Definition: () => ParameterDecorator;
 
+export declare const Dispose: () => ParameterDecorator;
+
 export declare class EventManager implements AbstractEventManager {
     private readonly listeners;
     private readonly onceListeners;
-    private readonly channels;
+    readonly channels: Set<string>;
     constructor(...allowedChannels: string[]);
     dispose(): void;
     addChannels(...channels: string[]): EventManager;
@@ -187,16 +225,18 @@ export declare class EventManager implements AbstractEventManager {
 declare type Identifier<T> = Concrete<T> | Abstract<T>;
 
 declare class Injectable<T> {
-    readonly context: AssemblerContext;
+    readonly privateContext: AssemblerPrivateContext;
+    readonly publicContext: AssemblerContext;
     readonly identifier: Identifier<T>;
     readonly concrete: Concrete<T>;
     readonly configuration: Record<string, any>;
     private dependenciesIds;
     private singletonInstance;
-    static of<TNew>(injection: Injection<TNew>, context: AssemblerContext): Injectable<TNew>;
+    static of<TNew>(buildable: Buildable<TNew>, privateContext: AssemblerPrivateContext, publicContext: AssemblerContext): Injectable<TNew>;
     private constructor();
     /**
-     * Dispose the injectable by deleting its singleton if exists.
+     * Dispose the injectable by deleting its singleton if exists
+     * and deleting all injectable's properties.
      */
     dispose(): void;
     /**

package/dist/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="assemblage_definition",t="context_param_index",n="config_param_index",r="definition_param_index",s=(e,t,n)=>{Reflect.defineMetadata(`__${e}__`,t,n)},i=(e,t)=>Reflect.getOwnMetadata(`__${e}__`,t),o=e=>Reflect.getMetadata("design:paramtypes",e)||[],c={singleton:{test:e=>"boolean"==typeof e||void 0===e,throw:()=>{throw new Error("'singleton' property must be of type 'boolean' or 'undefined'.")},transform:e=>void 0===e},events:{test:e=>void 0===e||Array.isArray(e)&&e.every((e=>"string"==typeof e)),throw:()=>{throw new Error("'events' property must be an array of strings or 'undefined'.")},transform:e=>e},inject:{test:e=>void 0===e||Array.isArray(e)&&e.every((e=>Array.isArray(e)&&e.length>=1&&e.length<=3)),throw:()=>{throw new Error("'inject' property must be an array of tuples of length 1, 2 or 3.")},transform:e=>e},tags:{test:e=>void 0===e||"string"==typeof e||Array.isArray(e)&&e.every((e=>"string"==typeof e)),throw:()=>{throw new Error("'tags' property must be a string or an array of strings.")},transform:e=>"string"==typeof e?[e]:e},controller:{test:e=>"boolean"==typeof e||void 0===e,throw:()=>{throw new Error("'controller' property must be of type 'boolean' or 'undefined'.")},transform:e=>e},path:{test:e=>"string"==typeof e||void 0===e,throw:()=>{throw new Error("'path' property must be of type 'string' or 'undefined'.")},transform:e=>{if(e){let t=e.replace(/\/+/g,"/").replace(/\s/g,"");if(t.startsWith("/")||(t=`/${t}`),t.endsWith("/")){const e=t.length-1;t=t.split("").splice(0,e).join("")}return t}return e}},metadata:{test:e=>("object"==typeof e||void 0===e)&&!Array.isArray(e),throw:()=>{throw new Error("'metadata' property must be of type 'object' or 'undefined'.")},transform:e=>e}},a=e=>{const t={...e};for(const n in t){if(!Object.keys(c).includes(n))throw new Error(`Property '${n}' is not a valid assemblage definition property.`);const e=c[n].test,r=c[n].throw,s=c[n].transform;if(e(t[n])||r(),"controller"===n&&!Object.keys(t).includes("path"))throw new Error("Assemblage marked as 'controller' must define a 'path'.");if("path"===n&&!Object.keys(t).includes("controller"))throw new Error("Assemblage that defines a 'path' must be marked as 'controller'.");t[n]=s(t[n])}return t},l=t=>i(e,t),h=(e,t)=>l(t)[e],u=e=>()=>(t,n,r)=>{const o=i(e,t)||[];o.push(r),s(e,o,t)},f=u(t),d=u(n),g=u(r),p=e=>{const s=(e=>i(t,e)||[])(e),o=(e=>i(r,e)||[])(e),c=(e=>i(n,e)||[])(e);return{context:s,definition:o,configuration:c}};const b=(...e)=>{},y=(...e)=>t=>{if(e.includes(typeof t))return typeof t},m=e=>!(e=>void 0===e)(e)&&!(e=>null===e)(e),w=e=>e&&"function"==typeof e&&void 0!==e.constructor,v=e=>"function"==typeof e&&"AsyncFunction"===e.constructor.name,j=(e,...t)=>{t.map(((e,n)=>{const r=/\S/.test(e);return r&&(t[n]=t[n].trim()),r?-1:n})).filter((e=>e>=0)).every((e=>{t[e]=" ",((e,t,n)=>{const r=e[t];e.splice(t,1),e.splice(n,0,r)})(t,e,t.length-1)})),t=(e=>Array.from(new Set(e)))(t);const n=new RegExp(`[^A-Za-zÀ-ÖØ-öø-ÿ0-9${t.join("")}]`,"gi");return e.replace(n,"")},x=(...e)=>t=>e.reduce(((e,t)=>t(e)),t),O=e=>t=>e.if(t)?e.then(t):e.else?e.else(t):void 0,A=e=>t=>{const n=Array.isArray(e)?e=>parseInt(e):b;for(const[r,s]of Object.entries(e))t(s,n(r))},E=(e,t)=>{const n=new Proxy(e,{get:function(n,r){return r===Symbol.iterator?n[Symbol.iterator].bind(n):((e,t)=>[...Object.getOwnPropertyNames(t.prototype),...Object.getOwnPropertyNames(Object.getPrototypeOf(e)),...Object.getOwnPropertyNames(e)])(e,t).includes(r)?n[r]:n.collection[r]},set:function(e,t,n){return Reflect.set(e,t,n)}});return n},P=(e,t)=>{const n=e;for(const r of((e,t)=>[...Object.getOwnPropertyNames(t.prototype),...Object.getOwnPropertyNames(Object.getPrototypeOf(e)),...Object.getOwnPropertyNames(e)])(e,t))delete n[r]},C=(e,t,n)=>new Promise((r=>{const s=e[t];if(s){if(v(s))return void s.bind(e)(n).then((()=>{r()}));r(s.bind(e)(n))}}));let _=Symbol.iterator;class I{dispose(){P(this,I)}add(...e){const t=e=>this.collection[e.channel].push(e.listener),n=O({if:()=>2===e.length,then:()=>({channel:e[0],listener:e[1]}),else:()=>{const t=e[0];return{channel:t[0],listener:t[1]}}}),r=O({if:e=>!m(this.collection[e.channel]),then:e=>{this.collection[e.channel]=[],t(e)},else:e=>{t(e)}});return x(n,r)(),this}remove(e,t){const n=t=>this.collection[e].splice(t,1),r=O({if:()=>this.collection[e]&&0===this.collection[e].length,then:()=>delete this.collection[e]}),s=O({if:()=>m(t),then:()=>n(this.collection[e].indexOf(t)),else:()=>delete this.collection[e]}),i=O({if:e=>this.has(e),then:e=>this.collection[e]});return x(i,s,r)(),this}has(...e){return y("string")(e[0])?Object.keys(this.collection).includes(e[0]):!!y("function")(e[0])&&Object.values(this.collection).flat().includes(e[0])}get(...e){return y("string")(e[0])?this.collection[e[0]]:y("function")(e[0])?Object.values(this.collection).flat().filter((t=>t===e[0])):[]}clear(){const e=(e=>t=>{const n=Array.isArray(e)?e=>parseInt(e):e=>e;for(const r in e)t(n(r))})(this.collection),t=e=>A(this.collection[e])((t=>this.remove(e,t)));return e((e=>t(e))),this}get listeners(){return Object.values(this.collection).flat()}get channels(){return Object.keys(this.collection)}get length(){return Object.values(this.collection).flat().length}[_](){let e=-1;const t=this.collection?Object.keys(this.collection):[];return{next:()=>({value:t[++e],done:!(e in t)})}}constructor(){!function(e,t,n){t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n}(this,"collection",{});return E(this,I)}}function S(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}class ${dispose(){this.listeners.dispose(),this.channels.clear(),P(this,$)}addChannels(...e){return A(e)((e=>{const t=this.cleanChannel(e);if(this.channels.has(t))throw new Error(`Channel '${t}' already exists.`);this.channels.add(t)})),this}removeChannels(...e){return A(e)((e=>{const t=this.cleanChannel(e);"*"!==t&&this.channels.has(t)&&(this.channels.delete(t),this.listeners.remove(t),this.onceListeners.remove(t))})),this}on(e,t){const n=this.cleanChannel(e);if(!this.channels.has(n))throw new Error(`Channel '${n}' was not registered.`);return this.listeners.add(n,t),this}once(e,t){const n=this.cleanChannel(e);if(!this.channels.has(n))throw new Error(`Channel '${n}' was not registered.`);return this.onceListeners.add(n,t),this}off(e,t){const n=this.cleanChannel(e);return this.listeners.remove(n,t),this}emit(e,...t){const n=this.cleanChannel(e);if(this.channels.has(n)){const e=this.onceListeners.get("*")||[],r=this.listeners.get("*")||[],s=this.onceListeners.get(n)||[],i=this.listeners.get(n)||[],o=A(e),c=A(r),a=A(s),l=A(i);o((e=>{this.run(e,...t),this.onceListeners.remove("*",e)})),c((e=>{this.run(e,...t)})),a((e=>{this.run(e,...t),this.onceListeners.remove(n,e)})),l((e=>{this.run(e,...t)}))}return this}run(e,...t){if(v(e)){return e(...t).then((()=>Promise.resolve()))}e(...t)}cleanChannel(e){return j(e,"*")}constructor(...e){S(this,"listeners",new I),S(this,"onceListeners",new I),S(this,"channels",new Set(["*"])),this.addChannels(...e)}}const k=e=>{const t=()=>w(e[0])&&(e=>"object"==typeof e&&!Array.isArray(e)&&!w(e))(e[1]);return x(O({if:()=>w(e[0])&&w(e[1]),then:()=>({identifier:e[0],concrete:e[1],configuration:{}})}),O({if:()=>t(),then:()=>({identifier:e[0],concrete:e[0],configuration:e[1]}),else:e=>e}))()},L=e=>((e,t)=>(n,...r)=>e[n]?e[n](...r):t?t(n,...r):void 0)({1:()=>(e=>({identifier:e[0],concrete:e[0],configuration:{}}))(e),2:()=>k(e),3:()=>(e=>({identifier:e[0],concrete:e[1],configuration:e[2]}))(e)},(()=>{throw new Error("Injection tuple must be of length 1, 2 or 3.")}))(e.length);function M(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}class R{static of(e,t){return new R(e,t)}dispose(){this.singletonInstance&&C(this.singletonInstance,"onDispose",this.context),P(this,R)}build(){if(this.singletonInstance)return this.singletonInstance;const e=(e=>{const t=[],n=o(e.concrete),r=p(e.concrete);let s=0;for(const i of n)r.context.includes(s)?(t.push(e.context),s++):r.configuration.includes(s)?(t.push(e.configuration),s++):r.definition.includes(s)?(t.push(e.definition),s++):(t.push(e.context.require(i)),s++);return t})(this),t=new this.concrete(...e);return this.concrete.prototype instanceof $&&t.addChannels(...this.events),C(t,"onInit",this.context),this.isSingleton&&(this.singletonInstance=t),t}get dependencies(){return this.dependenciesIds}get definition(){return l(this.concrete)||{}}get isSingleton(){return h("singleton",this.concrete)||!0}get singleton(){return this.singletonInstance}get injections(){return h("inject",this.concrete)||[]}get tags(){return h("tags",this.concrete)||[]}get events(){return h("events",this.concrete)||[]}constructor(e,t){M(this,"context",void 0),M(this,"identifier",void 0),M(this,"concrete",void 0),M(this,"configuration",void 0),M(this,"dependenciesIds",void 0),M(this,"singletonInstance",void 0),this.context=t,this.dependenciesIds=[];const n=L(e);this.identifier=n.identifier,this.concrete=n.concrete,this.configuration=n.configuration;A(this.injections)((e=>this.context.register(e))),this.dependenciesIds=(e=>{const t=[],n=o(e),r=p(e);let s=0;for(const i of n)r.context.includes(s)||r.configuration.includes(s)||r.definition.includes(s)||t.push(i),s++;return t})(this.concrete),this.isSingleton&&this.build()}}function N(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}class q{static build(e){return new q(e)}dispose(){for(const[e,t]of this.injectables)t.dispose();P(this,q)}register(e){const t=R.of(e,this.context);if(this.has(t.identifier))throw new Error(`An assemblage is already registered with identifier '${t.identifier.name}'.`);return this.injectables.set(t.identifier,t),C(t.concrete,"onRegister",this.context),t}has(e){return this.injectables.has(e)}require(e){if(!this.injectables.has(e))throw new Error(`Assemblage with identifier '${e.name}' has not been registered.`);return this.injectables.get(e).build()}tagged(...e){const t=[];for(const n of e)for(const[e,r]of this.injectables)r.tags.includes(n)&&t.push(r.build());return t}get size(){return this.injectables.size}constructor(e){N(this,"injectables",new Map),N(this,"context",void 0),this.context={register:this.register.bind(this),has:this.has.bind(this),require:this.require.bind(this),tagged:this.tagged.bind(this)},((e,t,n)=>{const r=l(n);r[e]=t,a(r)})("singleton",!0,e);const t=this.register([e]);return this.require(t.identifier)}}exports.AbstractAssemblage=class{static onRegister(e){}},exports.AbstractAssembler=class{},exports.AbstractEventManager=class{},exports.Assemblage=t=>{const n=t?a(t):{};return t=>(s("is_assemblage",!0,t),s(e,n,t),t)},exports.Assembler=q,exports.Configuration=d,exports.Context=f,exports.Definition=g,exports.EventManager=$;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=(...e)=>{},t=(...e)=>t=>{if(e.includes(typeof t))return typeof t},n=e=>!(e=>void 0===e)(e)&&!(e=>null===e)(e),s=e=>e&&"function"==typeof e&&void 0!==e.constructor,i=e=>"function"==typeof e&&"AsyncFunction"===e.constructor.name,r=(e,...t)=>{t.map(((e,n)=>{const s=/\S/.test(e);return s&&(t[n]=t[n].trim()),s?-1:n})).filter((e=>e>=0)).every((e=>{t[e]=" ",((e,t,n)=>{const s=e[t];e.splice(t,1),e.splice(n,0,s)})(t,e,t.length-1)})),t=(e=>Array.from(new Set(e)))(t);const n=new RegExp(`[^A-Za-zÀ-ÖØ-öø-ÿ0-9${t.join("")}]`,"gi");return e.replace(n,"")},o=(...e)=>t=>e.reduce(((e,t)=>t(e)),t),c=e=>t=>e.if(t)?e.then(t):e.else?e.else(t):void 0,a=t=>n=>{const s=Array.isArray(t)?e=>parseInt(e):e;for(const[e,i]of Object.entries(t))n(i,s(e))},l=(e,t)=>{const n=new Proxy(e,{get:function(n,s){return s===Symbol.iterator?n[Symbol.iterator].bind(n):((e,t)=>[...Object.getOwnPropertyNames(t.prototype),...Object.getOwnPropertyNames(Object.getPrototypeOf(e)),...Object.getOwnPropertyNames(e)])(e,t).includes(s)?n[s]:n.collection[s]},set:function(e,t,n){return Reflect.set(e,t,n)}});return n},h=(e,t)=>{const n=e;for(const s of((e,t)=>[...Object.getOwnPropertyNames(t.prototype),...Object.getOwnPropertyNames(Object.getPrototypeOf(e)),...Object.getOwnPropertyNames(e)])(e,t))delete n[s]};let d=Symbol.iterator;class u{dispose(){h(this,u)}add(...e){const t=e=>this.collection[e.channel].push(e.listener),s=c({if:()=>2===e.length,then:()=>({channel:e[0],listener:e[1]}),else:()=>{const t=e[0];return{channel:t[0],listener:t[1]}}}),i=c({if:e=>!n(this.collection[e.channel]),then:e=>{this.collection[e.channel]=[],t(e)},else:e=>{t(e)}});return o(s,i)(),this}remove(e,t){const s=t=>this.collection[e].splice(t,1),i=c({if:()=>this.collection[e]&&0===this.collection[e].length,then:()=>delete this.collection[e]}),r=c({if:()=>n(t),then:()=>s(this.collection[e].indexOf(t)),else:()=>delete this.collection[e]}),a=c({if:e=>this.has(e),then:e=>this.collection[e]});return o(a,r,i)(),this}has(...e){return t("string")(e[0])?Object.keys(this.collection).includes(e[0]):!!t("function")(e[0])&&Object.values(this.collection).flat().includes(e[0])}get(...e){return t("string")(e[0])?this.collection[e[0]]:t("function")(e[0])?Object.values(this.collection).flat().filter((t=>t===e[0])):[]}clear(){const e=(e=>t=>{const n=Array.isArray(e)?e=>parseInt(e):e=>e;for(const s in e)t(n(s))})(this.collection),t=e=>a(this.collection[e])((t=>this.remove(e,t)));return e((e=>t(e))),this}get listeners(){return Object.values(this.collection).flat()}get channels(){return Object.keys(this.collection)}get length(){return Object.values(this.collection).flat().length}[d](){let e=-1;const t=this.collection?Object.keys(this.collection):[];return{next:()=>({value:t[++e],done:!(e in t)})}}constructor(){!function(e,t,n){t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n}(this,"collection",{});return l(this,u)}}function f(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}class p{dispose(){this.listeners.dispose(),this.channels.clear(),h(this,p)}addChannels(...e){return a(e)((e=>{const t=this.cleanChannel(e);if(this.channels.has(t))throw new Error(`Channel '${t}' already exists.`);this.channels.add(t)})),this}removeChannels(...e){return a(e)((e=>{const t=this.cleanChannel(e);"*"!==t&&this.channels.has(t)&&(this.channels.delete(t),this.listeners.remove(t),this.onceListeners.remove(t))})),this}on(e,t){const n=this.cleanChannel(e);if(!this.channels.has(n))throw new Error(`Channel '${n}' was not registered.`);return this.listeners.add(n,t),this}once(e,t){const n=this.cleanChannel(e);if(!this.channels.has(n))throw new Error(`Channel '${n}' was not registered.`);return this.onceListeners.add(n,t),this}off(e,t){const n=this.cleanChannel(e);return this.listeners.remove(n,t),this}emit(e,...t){const n=this.cleanChannel(e);if(this.channels.has(n)){const e=this.onceListeners.get("*")||[],s=this.listeners.get("*")||[],i=this.onceListeners.get(n)||[],r=this.listeners.get(n)||[],o=a(e),c=a(s),l=a(i),h=a(r);o((e=>{this.run(e,...t),this.onceListeners.remove("*",e)})),c((e=>{this.run(e,...t)})),l((e=>{this.run(e,...t),this.onceListeners.remove(n,e)})),h((e=>{this.run(e,...t)}))}return this}run(e,...t){if(i(e)){return e(...t).then((()=>Promise.resolve()))}e(...t)}cleanChannel(e){return r(e,"*")}constructor(...e){f(this,"listeners",new u),f(this,"onceListeners",new u),f(this,"channels",new Set(["*"])),this.addChannels(...e)}}const g="is_assemblage",b="assemblage_definition",y="context_param_index",v="config_param_index",m="definition_param_index",w="dispose_param_index",x=(e,t,n)=>{Reflect.defineMetadata(`__${e}__`,t,n)},C=(e,t)=>Reflect.getOwnMetadata(`__${e}__`,t),j=e=>Reflect.getMetadata("design:paramtypes",e)||[],O={singleton:{test:e=>"boolean"==typeof e||void 0===e,throw:()=>{throw new Error("'singleton' property must be of type 'boolean' or 'undefined'.")},transform:e=>void 0===e},events:{test:e=>void 0===e||Array.isArray(e)&&e.every((e=>"string"==typeof e)),throw:()=>{throw new Error("'events' property must be an array of strings or 'undefined'.")},transform:e=>e},inject:{test:e=>void 0===e||Array.isArray(e)&&e.every((e=>Array.isArray(e)&&e.length>=1&&e.length<=3)),throw:()=>{throw new Error("'inject' property must be an array of tuples of length 1, 2 or 3.")},transform:e=>e},tags:{test:e=>void 0===e||"string"==typeof e||Array.isArray(e)&&e.every((e=>"string"==typeof e)),throw:()=>{throw new Error("'tags' property must be a string or an array of strings.")},transform:e=>"string"==typeof e?[e]:e},controller:{test:e=>"boolean"==typeof e||void 0===e,throw:()=>{throw new Error("'controller' property must be of type 'boolean' or 'undefined'.")},transform:e=>e},path:{test:e=>"string"==typeof e||void 0===e,throw:()=>{throw new Error("'path' property must be of type 'string' or 'undefined'.")},transform:e=>{if(e){let t=e.replace(/\/+/g,"/").replace(/\s/g,"");if(t.startsWith("/")||(t=`/${t}`),t.endsWith("/")){const e=t.length-1;t=t.split("").splice(0,e).join("")}return t}return e}},metadata:{test:e=>("object"==typeof e||void 0===e)&&!Array.isArray(e),throw:()=>{throw new Error("'metadata' property must be of type 'object' or 'undefined'.")},transform:e=>e}},A=e=>{const t={...e};for(const n in t){if(!Object.keys(O).includes(n))throw new Error(`Property '${n}' is not a valid assemblage definition property.`);const e=O[n].test,s=O[n].throw,i=O[n].transform;if(e(t[n])||s(),"controller"===n&&!Object.keys(t).includes("path"))throw new Error("Assemblage marked as 'controller' must define a 'path'.");if("path"===n&&!Object.keys(t).includes("controller"))throw new Error("Assemblage that defines a 'path' must be marked as 'controller'.");t[n]=i(t[n])}return t},E=e=>C(b,e),I=(e,t)=>E(t)[e],P=(e,t,n)=>new Promise((s=>{const r=e[t];if(r){if(i(r))return void r.bind(e)(n).then((()=>{s()}));s(r.bind(e)(n))}})),_=e=>{const t=(e=>C(y,e)||[])(e),n=(e=>C(m,e)||[])(e),s=(e=>C(v,e)||[])(e),i=(e=>C(w,e)||[])(e);return{context:t,definition:n,configuration:s,dispose:i}};function S(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}class ${static of(e,t,n){return new $(e,t,n)}dispose(){this.singletonInstance&&(((e,t)=>{if(e.concrete.prototype instanceof p){const n=t;for(const t of e.events)n.off(t);n.removeChannels(...e.events),e.privateContext.removeChannels(...e.events)}})(this,this.singletonInstance),P(this.singletonInstance,"onDispose",this.publicContext),h(this.singletonInstance,this.concrete)),h(this,$)}build(){if(this.singletonInstance)return this.singletonInstance;if(!(e=>C(g,e)||!1)(this.concrete))throw new Error(`Class '${this.concrete}' is not an Assemblage.`);const e=(e=>{const t=[],n=j(e.concrete),s=_(e.concrete);let i=0;for(const r of n)s.context.includes(i)?(t.push(e.publicContext),i++):s.configuration.includes(i)?(t.push(e.configuration),i++):s.definition.includes(i)?(t.push(e.definition),i++):s.dispose.includes(i)?(t.push(e.privateContext.dispose),i++):(t.push(e.privateContext.require(r)),i++);return t})(this),t=new this.concrete(...e);return((e,t)=>{if(e.concrete.prototype instanceof p){const n=t,s=n.channels;for(const t of e.events)s.has(t)||n.addChannels(t),e.privateContext.events.has(t)||e.privateContext.addChannels(t);for(const i of e.events)t.on(i,((...t)=>{e.privateContext.emit(i,...t)}))}})(this,t),P(t,"onInit",this.publicContext),this.isSingleton&&(this.singletonInstance=t),t}get dependencies(){return this.dependenciesIds}get definition(){return E(this.concrete)||{}}get isSingleton(){return I("singleton",this.concrete)||!0}get singleton(){return this.singletonInstance}get injections(){return I("inject",this.concrete)||[]}get tags(){return I("tags",this.concrete)||[]}get events(){return I("events",this.concrete)||[]}constructor(e,t,n){S(this,"privateContext",void 0),S(this,"publicContext",void 0),S(this,"identifier",void 0),S(this,"concrete",void 0),S(this,"configuration",void 0),S(this,"dependenciesIds",void 0),S(this,"singletonInstance",void 0),this.privateContext=t,this.publicContext=n,this.dependenciesIds=[],this.identifier=e.identifier,this.concrete=e.concrete,this.configuration=e.configuration;a(this.injections)((e=>this.privateContext.register(e))),this.dependenciesIds=(e=>{const t=[],n=j(e),s=_(e);let i=0;for(const r of n)s.context.includes(i)||s.configuration.includes(i)||s.definition.includes(i)||s.dispose.includes(i)||t.push(r),i++;return t})(this.concrete),this.isSingleton&&this.build()}}const k=e=>{const t=()=>s(e[0])&&(e=>"object"==typeof e&&!Array.isArray(e)&&!s(e))(e[1]);return o(c({if:()=>s(e[0])&&s(e[1]),then:()=>({identifier:e[0],concrete:e[1],configuration:{}})}),c({if:()=>t(),then:()=>({identifier:e[0],concrete:e[0],configuration:e[1]}),else:e=>e}))()};function L(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}class M extends p{static build(e){const t=new M;((e,t,n)=>{const s=E(n);s[e]=t,A(s)})("singleton",!0,e);const n=t.register([e]);return t.require(n.identifier)}dispose(){for(const[e,t]of this.injectables)t.dispose();h(this,M)}register(e){const t=(n=e,((e,t)=>(n,...s)=>e[n]?e[n](...s):t?t(n,...s):void 0)({1:()=>(e=>({identifier:e[0],concrete:e[0],configuration:{}}))(n),2:()=>k(n),3:()=>(e=>({identifier:e[0],concrete:e[1],configuration:e[2]}))(n)},(()=>{throw new Error("Injection tuple must be of length 1, 2 or 3.")}))(n.length));var n;if(this.has(t.identifier))throw new Error(`An assemblage is already registered with identifier '${t.identifier.name}'.`);const s=$.of(t,this.privateContext,this.publicContext);return this.injectables.set(s.identifier,s),P(s.concrete,"onRegister",this.publicContext),s}has(e){return this.injectables.has(e)}require(e){if(!this.injectables.has(e))throw new Error(`Assemblage with identifier '${e.name}' has not been registered.`);return this.injectables.get(e).build()}tagged(...e){const t=[];for(const n of e)for(const[e,s]of this.injectables)s.tags.includes(n)&&t.push(s.build());return t}get size(){return this.injectables.size}constructor(){super(),L(this,"injectables",new Map),L(this,"privateContext",void 0),L(this,"publicContext",void 0),this.publicContext={register:this.register.bind(this),has:this.has.bind(this),require:this.require.bind(this),tagged:this.tagged.bind(this),on:this.on.bind(this),once:this.once.bind(this),off:this.off.bind(this),events:this.channels},this.privateContext={...this.publicContext,emit:this.emit.bind(this),addChannels:this.addChannels.bind(this),removeChannels:this.removeChannels.bind(this),dispose:this.dispose.bind(this)}}}const R=e=>()=>(t,n,s)=>{const i=C(e,t)||[];i.push(s),x(e,i,t)},N=R(y),q=R(v),z=R(m),D=R(w);class W{}exports.AbstractAssemblage=class{static onRegister(e){}},exports.AbstractAssembler=class extends W{},exports.AbstractEventManager=W,exports.Assemblage=e=>{const t=e?A(e):{};return e=>(x(g,!0,e),x(b,t,e),e)},exports.Assembler=M,exports.Awaitable=(e,t=25)=>(n,s,i)=>{let r=i.value;i.value=async function(){return new Promise((n=>{if(this[e])r.apply(this),n();else{const s=setInterval((()=>{this[e]&&(clearInterval(s),r.apply(this),n())}),t)}}))}},exports.Configuration=q,exports.Context=N,exports.Definition=z,exports.Dispose=D,exports.EventManager=p;

package/dist/index.mjs

@@ -1,171 +1,3 @@
-class AbstractAssemblage {
-    static onRegister(s) {}
-}
-
-const ReflectParamTypes = 'design:paramtypes';
-const ReflectPrefix = '__';
-const ReflectSuffix = '__';
-const ReflectIsAssemblageFlag = `is_assemblage`;
-const ReflectDefinition = 'assemblage_definition';
-const ReflectContextParamIndex = `context_param_index`;
-const ReflectConfigurationParamIndex = `config_param_index`;
-const ReflectDefinitionParamIndex = `definition_param_index`;
-const defineCustomMetadata = (e, t, a)=>{
-    Reflect.defineMetadata(`${ReflectPrefix}${e}${ReflectSuffix}`, t, a);
-};
-const getOwnCustomMetadata = (e, t)=>{
-    return Reflect.getOwnMetadata(`${ReflectPrefix}${e}${ReflectSuffix}`, t);
-};
-const getParamTypes = (e)=>{
-    return Reflect.getMetadata(ReflectParamTypes, e) || [];
-};
-
-const r = {
-    singleton: {
-        test: (t)=>typeof t === 'boolean' || typeof t === 'undefined',
-        throw: ()=>{
-            throw new Error(`'singleton' property must be of type 'boolean' or 'undefined'.`);
-        },
-        transform: (t)=>typeof t === 'undefined' ? true : false
-    },
-    events: {
-        test: (t)=>typeof t === 'undefined' || Array.isArray(t) && t.every((t)=>typeof t === 'string'),
-        throw: ()=>{
-            throw new Error(`'events' property must be an array of strings or 'undefined'.`);
-        },
-        transform: (t)=>t
-    },
-    inject: {
-        test: (t)=>typeof t === 'undefined' || Array.isArray(t) && t.every((t)=>Array.isArray(t) && t.length >= 1 && t.length <= 3),
-        throw: ()=>{
-            throw new Error(`'inject' property must be an array of tuples of length 1, 2 or 3.`);
-        },
-        transform: (t)=>t
-    },
-    tags: {
-        test: (t)=>typeof t === 'undefined' || typeof t === 'string' || Array.isArray(t) && t.every((t)=>typeof t === 'string'),
-        throw: ()=>{
-            throw new Error(`'tags' property must be a string or an array of strings.`);
-        },
-        transform: (t)=>typeof t === 'string' ? [
-                t
-            ] : t
-    },
-    controller: {
-        test: (t)=>typeof t === 'boolean' || typeof t === 'undefined',
-        throw: ()=>{
-            throw new Error(`'controller' property must be of type 'boolean' or 'undefined'.`);
-        },
-        transform: (t)=>t
-    },
-    path: {
-        test: (t)=>typeof t === 'string' || typeof t === 'undefined',
-        throw: ()=>{
-            throw new Error(`'path' property must be of type 'string' or 'undefined'.`);
-        },
-        transform: (t)=>{
-            if (t) {
-                let e = t.replace(/\/+/g, '/').replace(/\s/g, '');
-                if (!e.startsWith('/')) {
-                    e = `/${e}`;
-                }
-                if (e.endsWith('/')) {
-                    const t = e.length - 1;
-                    e = e.split('').splice(0, t).join('');
-                }
-                return e;
-            }
-            return t;
-        }
-    },
-    metadata: {
-        test: (t)=>(typeof t === 'object' || typeof t === 'undefined') && !Array.isArray(t),
-        throw: ()=>{
-            throw new Error(`'metadata' property must be of type 'object' or 'undefined'.`);
-        },
-        transform: (t)=>t
-    }
-};
-const validateDefinition = (t)=>{
-    const e = {
-        ...t
-    };
-    for(const t in e){
-        if (!Object.keys(r).includes(t)) {
-            throw new Error(`Property '${t}' is not a valid assemblage definition property.`);
-        }
-        const o = r[t].test;
-        const n = r[t].throw;
-        const s = r[t].transform;
-        if (!o(e[t])) {
-            n();
-        }
-        if (t === 'controller' && !Object.keys(e).includes('path')) {
-            throw new Error(`Assemblage marked as 'controller' must define a 'path'.`);
-        }
-        if (t === 'path' && !Object.keys(e).includes('controller')) {
-            throw new Error(`Assemblage that defines a 'path' must be marked as 'controller'.`);
-        }
-        e[t] = s(e[t]);
-    }
-    return e;
-};
-const getDefinition = (r)=>{
-    return getOwnCustomMetadata(ReflectDefinition, r);
-};
-const getDefinitionValue = (t, e)=>{
-    const r = getDefinition(e);
-    return r[t];
-};
-const setDefinitionValue = (t, e, r)=>{
-    const o = getDefinition(r);
-    o[t] = e;
-    const n = validateDefinition(o);
-    return n;
-};
-
-const Assemblage = (o)=>{
-    const s = o ? validateDefinition(o) : {};
-    return (o)=>{
-        defineCustomMetadata(ReflectIsAssemblageFlag, true, o);
-        defineCustomMetadata(ReflectDefinition, s, o);
-        return o;
-    };
-};
-
-const i$1 = (t)=>()=>{
-        return (n, e, i)=>{
-            const s = getOwnCustomMetadata(t, n) || [];
-            s.push(i);
-            defineCustomMetadata(t, s, n);
-        };
-    };
-const s = i$1(ReflectContextParamIndex);
-const x = i$1(ReflectConfigurationParamIndex);
-const c$1 = i$1(ReflectDefinitionParamIndex);
-const getContextIndex = (t)=>{
-    return getOwnCustomMetadata(ReflectContextParamIndex, t) || [];
-};
-const getConfigurationIndex = (n)=>{
-    return getOwnCustomMetadata(ReflectConfigurationParamIndex, n) || [];
-};
-const getDefinitionIndex = (t)=>{
-    return getOwnCustomMetadata(ReflectDefinitionParamIndex, t) || [];
-};
-const getDecoratedParametersIndexes = (t)=>{
-    const n = getContextIndex(t);
-    const e = getDefinitionIndex(t);
-    const o = getConfigurationIndex(t);
-    return {
-        context: n,
-        definition: e,
-        configuration: o
-    };
-};
-
-class AbstractAssembler {
-}
-
 const NoOp = (...e)=>{};
 const isOfType = (...e)=>(t)=>{
         if (!e.includes(typeof t)) return undefined;
@@ -253,21 +85,6 @@ const clearInstance = (e, t)=>{
     }
 };
 
-const callHook = (n, r, t)=>{
-    return new Promise((i)=>{
-        const e = n[r];
-        if (e) {
-            if (isAsync(e)) {
-                e.bind(n)(t).then(()=>{
-                    i();
-                });
-                return;
-            }
-            i(e.bind(n)(t));
-        }
-    });
-};
-
 function e$3(e, t, n) {
     if (t in e) {
         Object.defineProperty(e, t, {
@@ -494,127 +311,291 @@ class EventManager {
     }
 }
 
-const i = (n)=>{
-    return {
-        identifier: n[0],
-        concrete: n[0],
-        configuration: {}
+const ReflectParamTypes = 'design:paramtypes';
+const ReflectPrefix = '__';
+const ReflectSuffix = '__';
+const ReflectIsAssemblageFlag = `is_assemblage`;
+const ReflectDefinition = 'assemblage_definition';
+const ReflectContextParamIndex = `context_param_index`;
+const ReflectConfigurationParamIndex = `config_param_index`;
+const ReflectDefinitionParamIndex = `definition_param_index`;
+const ReflectDisposeParamIndex = `dispose_param_index`;
+
+const defineCustomMetadata = (t, o, n)=>{
+    Reflect.defineMetadata(`${ReflectPrefix}${t}${ReflectSuffix}`, o, n);
+};
+const getOwnCustomMetadata = (t, o)=>{
+    return Reflect.getOwnMetadata(`${ReflectPrefix}${t}${ReflectSuffix}`, o);
+};
+const getParamTypes = (e)=>{
+    return Reflect.getMetadata(ReflectParamTypes, e) || [];
+};
+
+const r = {
+    singleton: {
+        test: (t)=>typeof t === 'boolean' || typeof t === 'undefined',
+        throw: ()=>{
+            throw new Error(`'singleton' property must be of type 'boolean' or 'undefined'.`);
+        },
+        transform: (t)=>typeof t === 'undefined' ? true : false
+    },
+    events: {
+        test: (t)=>typeof t === 'undefined' || Array.isArray(t) && t.every((t)=>typeof t === 'string'),
+        throw: ()=>{
+            throw new Error(`'events' property must be an array of strings or 'undefined'.`);
+        },
+        transform: (t)=>t
+    },
+    inject: {
+        test: (t)=>typeof t === 'undefined' || Array.isArray(t) && t.every((t)=>Array.isArray(t) && t.length >= 1 && t.length <= 3),
+        throw: ()=>{
+            throw new Error(`'inject' property must be an array of tuples of length 1, 2 or 3.`);
+        },
+        transform: (t)=>t
+    },
+    tags: {
+        test: (t)=>typeof t === 'undefined' || typeof t === 'string' || Array.isArray(t) && t.every((t)=>typeof t === 'string'),
+        throw: ()=>{
+            throw new Error(`'tags' property must be a string or an array of strings.`);
+        },
+        transform: (t)=>typeof t === 'string' ? [
+                t
+            ] : t
+    },
+    controller: {
+        test: (t)=>typeof t === 'boolean' || typeof t === 'undefined',
+        throw: ()=>{
+            throw new Error(`'controller' property must be of type 'boolean' or 'undefined'.`);
+        },
+        transform: (t)=>t
+    },
+    path: {
+        test: (t)=>typeof t === 'string' || typeof t === 'undefined',
+        throw: ()=>{
+            throw new Error(`'path' property must be of type 'string' or 'undefined'.`);
+        },
+        transform: (t)=>{
+            if (t) {
+                let e = t.replace(/\/+/g, '/').replace(/\s/g, '');
+                if (!e.startsWith('/')) {
+                    e = `/${e}`;
+                }
+                if (e.endsWith('/')) {
+                    const t = e.length - 1;
+                    e = e.split('').splice(0, t).join('');
+                }
+                return e;
+            }
+            return t;
+        }
+    },
+    metadata: {
+        test: (t)=>(typeof t === 'object' || typeof t === 'undefined') && !Array.isArray(t),
+        throw: ()=>{
+            throw new Error(`'metadata' property must be of type 'object' or 'undefined'.`);
+        },
+        transform: (t)=>t
+    }
+};
+const validateDefinition = (t)=>{
+    const e = {
+        ...t
+    };
+    for(const t in e){
+        if (!Object.keys(r).includes(t)) {
+            throw new Error(`Property '${t}' is not a valid assemblage definition property.`);
+        }
+        const o = r[t].test;
+        const n = r[t].throw;
+        const s = r[t].transform;
+        if (!o(e[t])) {
+            n();
+        }
+        if (t === 'controller' && !Object.keys(e).includes('path')) {
+            throw new Error(`Assemblage marked as 'controller' must define a 'path'.`);
+        }
+        if (t === 'path' && !Object.keys(e).includes('controller')) {
+            throw new Error(`Assemblage that defines a 'path' must be marked as 'controller'.`);
+        }
+        e[t] = s(e[t]);
+    }
+    return e;
+};
+const getDefinition = (r)=>{
+    return getOwnCustomMetadata(ReflectDefinition, r);
+};
+const getDefinitionValue = (t, e)=>{
+    const r = getDefinition(e);
+    return r[t];
+};
+const setDefinitionValue = (t, e, r)=>{
+    const o = getDefinition(r);
+    o[t] = e;
+    const n = validateDefinition(o);
+    return n;
+};
+
+const Assemblage = (r)=>{
+    const n = r ? validateDefinition(r) : {};
+    return (r)=>{
+        defineCustomMetadata(ReflectIsAssemblageFlag, true, r);
+        defineCustomMetadata(ReflectDefinition, n, r);
+        return r;
     };
 };
-const c = (r)=>{
-    const i = ()=>isClass(r[0]) && isClass(r[1]);
-    const c = ()=>isClass(r[0]) && isObject(r[1]);
-    const u = ()=>pipe(conditionally({
-            if: ()=>i(),
-            then: ()=>{
-                return {
-                    identifier: r[0],
-                    concrete: r[1],
-                    configuration: {}
-                };
+const isAssemblage = (e)=>{
+    return getOwnCustomMetadata(ReflectIsAssemblageFlag, e) || false;
+};
+
+const callHook = (o, r, t)=>{
+    return new Promise((i)=>{
+        const e = o[r];
+        if (e) {
+            if (isAsync(e)) {
+                e.bind(o)(t).then(()=>{
+                    i();
+                });
+                return;
             }
-        }), conditionally({
-            if: ()=>c(),
-            then: ()=>{
-                return {
-                    identifier: r[0],
-                    concrete: r[0],
-                    configuration: r[1]
-                };
-            },
-            else: (n)=>n
-        }))();
-    return u();
+            i(e.bind(o)(t));
+        }
+    });
 };
-const u = (n)=>{
+
+const getContextIndex = (e)=>{
+    return getOwnCustomMetadata(ReflectContextParamIndex, e) || [];
+};
+const getConfigurationIndex = (t)=>{
+    return getOwnCustomMetadata(ReflectConfigurationParamIndex, t) || [];
+};
+const getDefinitionIndex = (e)=>{
+    return getOwnCustomMetadata(ReflectDefinitionParamIndex, e) || [];
+};
+const getDisposeIndex = (e)=>{
+    return getOwnCustomMetadata(ReflectDisposeParamIndex, e) || [];
+};
+const getDecoratedParametersIndexes = (e)=>{
+    const t = getContextIndex(e);
+    const n = getDefinitionIndex(e);
+    const o = getConfigurationIndex(e);
+    const r = getDisposeIndex(e);
     return {
-        identifier: n[0],
-        concrete: n[1],
-        configuration: n[2]
+        context: t,
+        definition: n,
+        configuration: o,
+        dispose: r
     };
 };
-const resolveInjectionTuple = (n)=>switchCase({
-        1: ()=>i(n),
-        2: ()=>c(n),
-        3: ()=>u(n)
-    }, ()=>{
-        throw new Error(`Injection tuple must be of length 1, 2 or 3.`);
-    })(n.length);
 
 const resolveParameters = (o)=>{
     const t = [];
-    const c = getParamTypes(o.concrete);
-    const i = getDecoratedParametersIndexes(o.concrete);
-    let s = 0;
-    for (const n of c){
-        if (i.context.includes(s)) {
-            t.push(o.context);
-            s++;
+    const i = getParamTypes(o.concrete);
+    const s = getDecoratedParametersIndexes(o.concrete);
+    let c = 0;
+    for (const e of i){
+        if (s.context.includes(c)) {
+            t.push(o.publicContext);
+            c++;
             continue;
         }
-        if (i.configuration.includes(s)) {
+        if (s.configuration.includes(c)) {
             t.push(o.configuration);
-            s++;
+            c++;
             continue;
         }
-        if (i.definition.includes(s)) {
+        if (s.definition.includes(c)) {
             t.push(o.definition);
-            s++;
+            c++;
+            continue;
+        }
+        if (s.dispose.includes(c)) {
+            t.push(o.privateContext.dispose);
+            c++;
             continue;
         }
-        t.push(o.context.require(n));
-        s++;
+        t.push(o.privateContext.require(e));
+        c++;
     }
     return t;
 };
 const resolveDependencies = (o)=>{
     const t = [];
-    const c = getParamTypes(o);
-    const i = getDecoratedParametersIndexes(o);
-    let s = 0;
-    for (const n of c){
-        if (i.context.includes(s) || i.configuration.includes(s) || i.definition.includes(s)) {
-            s++;
+    const i = getParamTypes(o);
+    const s = getDecoratedParametersIndexes(o);
+    let c = 0;
+    for (const e of i){
+        if (s.context.includes(c) || s.configuration.includes(c) || s.definition.includes(c) || s.dispose.includes(c)) {
+            c++;
             continue;
         }
-        t.push(n);
-        s++;
+        t.push(e);
+        c++;
     }
     return t;
 };
 
-function e$1(e, t, n) {
+const registerEvents = (t, n)=>{
+    const o = 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);
+            });
+        }
+    }
+};
+const unregisterEvents = (t, n)=>{
+    const o = 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);
+    }
+};
+
+function e$1(e, t, i) {
     if (t in e) {
         Object.defineProperty(e, t, {
-            value: n,
+            value: i,
             enumerable: true,
             configurable: true,
             writable: true
         });
     } else {
-        e[t] = n;
+        e[t] = i;
     }
     return e;
 }
 class Injectable {
-    static of(e, t) {
-        return new Injectable(e, t);
+    static of(e, t, i) {
+        return new Injectable(e, t, i);
     }
     dispose() {
         if (this.singletonInstance) {
-            callHook(this.singletonInstance, 'onDispose', this.context);
+            unregisterEvents(this, this.singletonInstance);
+            callHook(this.singletonInstance, 'onDispose', this.publicContext);
+            clearInstance(this.singletonInstance, this.concrete);
         }
         clearInstance(this, Injectable);
     }
     build() {
         if (this.singletonInstance) return this.singletonInstance;
+        if (!isAssemblage(this.concrete)) {
+            throw new Error(`Class '${this.concrete}' is not an Assemblage.`);
+        }
         const e = resolveParameters(this);
         const t = new this.concrete(...e);
-        const n = this.concrete.prototype instanceof EventManager;
-        if (n) {
-            t.addChannels(...this.events);
-        }
-        callHook(t, 'onInit', this.context);
+        registerEvents(this, t);
+        callHook(t, 'onInit', this.publicContext);
         if (this.isSingleton) {
             this.singletonInstance = t;
         }
@@ -641,21 +622,22 @@ class Injectable {
     get events() {
         return getDefinitionValue('events', this.concrete) || [];
     }
-    constructor(t, i){
-        e$1(this, "context", undefined);
+    constructor(t, n, s){
+        e$1(this, "privateContext", undefined);
+        e$1(this, "publicContext", undefined);
         e$1(this, "identifier", undefined);
         e$1(this, "concrete", undefined);
         e$1(this, "configuration", undefined);
         e$1(this, "dependenciesIds", undefined);
         e$1(this, "singletonInstance", undefined);
-        this.context = i;
+        this.privateContext = n;
+        this.publicContext = s;
         this.dependenciesIds = [];
-        const s = resolveInjectionTuple(t);
-        this.identifier = s.identifier;
-        this.concrete = s.concrete;
-        this.configuration = s.configuration;
+        this.identifier = t.identifier;
+        this.concrete = t.concrete;
+        this.configuration = t.configuration;
         const o = forOf(this.injections);
-        o((e)=>this.context.register(e));
+        o((e)=>this.privateContext.register(e));
         this.dependenciesIds = resolveDependencies(this.concrete);
         if (this.isSingleton) {
             this.build();
@@ -663,6 +645,53 @@ class Injectable {
     }
 }
 
+const i$1 = (n)=>{
+    return {
+        identifier: n[0],
+        concrete: n[0],
+        configuration: {}
+    };
+};
+const c$1 = (o)=>{
+    const i = ()=>isClass(o[0]) && isClass(o[1]);
+    const c = ()=>isClass(o[0]) && isObject(o[1]);
+    const u = ()=>pipe(conditionally({
+            if: ()=>i(),
+            then: ()=>{
+                return {
+                    identifier: o[0],
+                    concrete: o[1],
+                    configuration: {}
+                };
+            }
+        }), conditionally({
+            if: ()=>c(),
+            then: ()=>{
+                return {
+                    identifier: o[0],
+                    concrete: o[0],
+                    configuration: o[1]
+                };
+            },
+            else: (n)=>n
+        }))();
+    return u();
+};
+const u = (n)=>{
+    return {
+        identifier: n[0],
+        concrete: n[1],
+        configuration: n[2]
+    };
+};
+const resolveInjectionTuple = (n)=>switchCase({
+        1: ()=>i$1(n),
+        2: ()=>c$1(n),
+        3: ()=>u(n)
+    }, ()=>{
+        throw new Error(`Injection tuple must be of length 1, 2 or 3.`);
+    })(n.length);
+
 function e(e, t, i) {
     if (t in e) {
         Object.defineProperty(e, t, {
@@ -676,9 +705,14 @@ function e(e, t, i) {
     }
     return e;
 }
-class Assembler {
+class Assembler extends EventManager {
     static build(e) {
-        return new Assembler(e);
+        const t = new Assembler();
+        setDefinitionValue('singleton', true, e);
+        const i = t.register([
+            e
+        ]);
+        return t.require(i.identifier);
     }
     dispose() {
         for (const [e, t] of this.injectables){
@@ -687,13 +721,14 @@ class Assembler {
         clearInstance(this, Assembler);
     }
     register(e) {
-        const t = Injectable.of(e, this.context);
+        const t = resolveInjectionTuple(e);
         if (this.has(t.identifier)) {
             throw new Error(`An assemblage is already registered with identifier '${t.identifier.name}'.`);
         }
-        this.injectables.set(t.identifier, t);
-        callHook(t.concrete, 'onRegister', this.context);
-        return t;
+        const i = Injectable.of(t, this.privateContext, this.publicContext);
+        this.injectables.set(i.identifier, i);
+        callHook(i.concrete, 'onRegister', this.publicContext);
+        return i;
     }
     has(e) {
         return this.injectables.has(e);
@@ -717,24 +752,70 @@ class Assembler {
     get size() {
         return this.injectables.size;
     }
-    constructor(t){
-        e(this, "injectables", new Map());
-        e(this, "context", undefined);
-        this.context = {
+    constructor(){
+        super(), e(this, "injectables", new Map()), e(this, "privateContext", undefined), e(this, "publicContext", undefined);
+        this.publicContext = {
             register: this.register.bind(this),
             has: this.has.bind(this),
             require: this.require.bind(this),
-            tagged: this.tagged.bind(this)
+            tagged: this.tagged.bind(this),
+            on: this.on.bind(this),
+            once: this.once.bind(this),
+            off: this.off.bind(this),
+            events: this.channels
+        };
+        this.privateContext = {
+            ...this.publicContext,
+            emit: this.emit.bind(this),
+            addChannels: this.addChannels.bind(this),
+            removeChannels: this.removeChannels.bind(this),
+            dispose: this.dispose.bind(this)
         };
-        setDefinitionValue('singleton', true, t);
-        const i = this.register([
-            t
-        ]);
-        return this.require(i.identifier);
     }
 }
 
+const c = (o)=>()=>{
+        return (t, n, e)=>{
+            const c = getOwnCustomMetadata(o, t) || [];
+            c.push(e);
+            defineCustomMetadata(o, c, t);
+        };
+    };
+const i = c(ReflectContextParamIndex);
+const f = c(ReflectConfigurationParamIndex);
+const p = c(ReflectDefinitionParamIndex);
+const m = c(ReflectDisposeParamIndex);
+
+const Awaitable = (e, t = 25)=>{
+    return (a, l, n)=>{
+        let s = n.value;
+        n.value = async function() {
+            return new Promise((a)=>{
+                if (this[e]) {
+                    s.apply(this);
+                    a();
+                } else {
+                    const l = setInterval(()=>{
+                        if (this[e]) {
+                            clearInterval(l);
+                            s.apply(this);
+                            a();
+                        }
+                    }, t);
+                }
+            });
+        };
+    };
+};
+
+class AbstractAssemblage {
+    static onRegister(s) {}
+}
+
 class AbstractEventManager {
 }
 
-export { AbstractAssemblage, AbstractAssembler, AbstractEventManager, Assemblage, Assembler, x as Configuration, s as Context, c$1 as Definition, EventManager };
+class AbstractAssembler extends AbstractEventManager {
+}
+
+export { AbstractAssemblage, AbstractAssembler, AbstractEventManager, Assemblage, Assembler, Awaitable, f as Configuration, i as Context, p as Definition, m as Dispose, EventManager };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "assemblerjs",
   "description": "A simple and zero-dependency DI package written in typescript.",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "author": "Benoît LAHOZ <info@benoitlahoz.io>",
   "bugs": "https://github.com/benoitlahoz/assemblerjs/issues",
   "devDependencies": {
@@ -16,6 +16,7 @@
     "terser": "^5.34.1",
     "vite": "6.0.2",
     "vite-plugin-dts": "^4.4.0",
+    "vitepress": "^1.5.0",
     "vitest": "^2.1.1"
   },
   "exports": {
@@ -37,7 +38,7 @@
     "agencement",
     "multi",
     "machine",
-    "decorators",
+    "decorator",
     "dependency",
     "di",
     "injection",
@@ -55,7 +56,10 @@
   "scripts": {
     "build": "vite build",
     "coverage": "vitest run --coverage --passWithNoTests && istanbul-badges-readme",
-    "test": "vitest --coverage --passWithNoTests"
+    "test": "vitest --coverage --passWithNoTests",
+    "docs:dev": "vitepress dev docs --host",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
   },
   "types": "dist/index.d.ts"
 }