moost 0.2.27 → 0.2.28

package/dist/index.mjs

@@ -18,6 +18,8 @@ LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
 OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
+/* global Reflect, Promise */
+
 
 function __awaiter(thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -39,7 +41,7 @@ const moostMate = new Mate(METADATA_WORKSPACE, {
             return !!(classMeta === null || classMeta === void 0 ? void 0 : classMeta.inherit);
         }
         if (level === 'PROP') {
-            return !!(targetMeta === null || targetMeta === void 0 ? void 0 : targetMeta.inherit) || !!((classMeta === null || classMeta === void 0 ? void 0 : classMeta.inherit) && !targetMeta);
+            return (!!(targetMeta === null || targetMeta === void 0 ? void 0 : targetMeta.inherit) || !!((classMeta === null || classMeta === void 0 ? void 0 : classMeta.inherit) && !targetMeta));
         }
         return !!(targetMeta === null || targetMeta === void 0 ? void 0 : targetMeta.inherit);
     },
@@ -73,22 +75,32 @@ function getNewMoostInfact() {
                 constructorParams: (meta === null || meta === void 0 ? void 0 : meta.params) || [],
                 provide: meta === null || meta === void 0 ? void 0 : meta.provide,
                 properties: (meta === null || meta === void 0 ? void 0 : meta.properties) || [],
-                scopeId: (meta === null || meta === void 0 ? void 0 : meta.injectable) === 'FOR_EVENT' ? useEventId().getId() : undefined,
+                scopeId: (meta === null || meta === void 0 ? void 0 : meta.injectable) === 'FOR_EVENT'
+                    ? useEventId().getId()
+                    : undefined,
             };
             return infactMeta;
         },
         resolveParam({ paramMeta, classMeta, customData }) {
             if (paramMeta && customData && customData.pipes) {
-                return runPipes(customData.pipes, undefined, { paramMeta, classMeta: classMeta }, 'PARAM');
+                return runPipes(customData.pipes, undefined, {
+                    paramMeta,
+                    classMeta: classMeta,
+                }, 'PARAM');
             }
         },
         describeProp(classConstructor, key) {
             const meta = getMoostMate().read(classConstructor, key);
             return meta;
         },
-        resolveProp({ instance, key, initialValue, propMeta, classMeta, customData }) {
+        resolveProp({ instance, key, initialValue, propMeta, classMeta, customData, }) {
             if (propMeta && customData && customData.pipes) {
-                return runPipes(customData.pipes, initialValue, { instance, key, propMeta, classMeta: classMeta }, 'PROP');
+                return runPipes(customData.pipes, initialValue, {
+                    instance,
+                    key,
+                    propMeta,
+                    classMeta: classMeta,
+                }, 'PROP');
             }
         },
         storeProvideRegByInstance: true,
@@ -102,13 +114,19 @@ function getInstanceOwnMethods(instance) {
         ...getParentProps(getConstructor(instance)),
         ...Object.getOwnPropertyNames(proto),
         ...Object.getOwnPropertyNames(instance),
-    ].filter(m => typeof instance[m] === 'function');
+    ].filter((m) => typeof instance[m] === 'function');
 }
 const fnProto = Object.getPrototypeOf(Function);
 function getParentProps(constructor) {
     const parent = Object.getPrototypeOf(constructor);
-    if (typeof parent === 'function' && parent !== fnProto && parent !== constructor && parent.prototype) {
-        return [...getParentProps(parent), ...Object.getOwnPropertyNames(parent.prototype)];
+    if (typeof parent === 'function' &&
+        parent !== fnProto &&
+        parent !== constructor &&
+        parent.prototype) {
+        return [
+            ...getParentProps(parent),
+            ...Object.getOwnPropertyNames(parent.prototype),
+        ];
     }
     return [];
 }
@@ -120,10 +138,14 @@ function getCallableFn(targetInstance, fn, restoreCtx, pipes, logger) {
         if (meta === null || meta === void 0 ? void 0 : meta.injectable) {
             const infact = getMoostInfact();
             infact.silent(true);
-            const instance = yield infact.getForInstance(targetInstance, fn, {
-                syncContextFn: () => { restoreCtx && restoreCtx(); },
-                customData: { pipes: [...(pipes || []), ...(meta.pipes || [])].sort((a, b) => a.priority - b.priority) },
-            });
+            const instance = (yield infact.getForInstance(targetInstance, fn, {
+                syncContextFn: () => {
+                    restoreCtx && restoreCtx();
+                },
+                customData: {
+                    pipes: [...(pipes || []), ...(meta.pipes || [])].sort((a, b) => a.priority - b.priority),
+                },
+            }));
             infact.silent(false);
             return ((...args) => {
                 return instance.handler(...args);
@@ -155,7 +177,15 @@ class InterceptorHandler {
             const { restoreCtx } = useEventContext();
             for (const handler of this.handlers) {
                 restoreCtx();
-                yield handler((fn) => { this.before.push(fn); }, (fn) => { this.after.unshift(fn); }, (fn) => { this.onError.unshift(fn); });
+                const response = yield handler((fn) => {
+                    this.before.push(fn);
+                }, (fn) => {
+                    this.after.unshift(fn);
+                }, (fn) => {
+                    this.onError.unshift(fn);
+                });
+                if (typeof response !== 'undefined')
+                    return response;
             }
         });
     }
@@ -193,6 +223,28 @@ class InterceptorHandler {
     }
 }
 
+const mate = getMoostMate();
+function getIterceptorHandlerFactory(interceptors, getTargetInstance, pipes, logger) {
+    return () => {
+        const interceptorHandlers = [];
+        for (const { handler } of interceptors) {
+            const interceptorMeta = mate.read(handler);
+            if (interceptorMeta === null || interceptorMeta === void 0 ? void 0 : interceptorMeta.injectable) {
+                interceptorHandlers.push((...args) => __awaiter(this, void 0, void 0, function* () {
+                    const { restoreCtx } = useEventContext();
+                    const targetInstance = yield getTargetInstance();
+                    restoreCtx();
+                    return (yield getCallableFn(targetInstance, handler, restoreCtx, pipes, logger))(...args);
+                }));
+            }
+            else {
+                interceptorHandlers.push(handler);
+            }
+        }
+        return Promise.resolve(new InterceptorHandler(interceptorHandlers));
+    };
+}
+
 function bindControllerMethods(options) {
     var _a;
     return __awaiter(this, void 0, void 0, function* () {
@@ -207,7 +259,9 @@ function bindControllerMethods(options) {
         const methods = getInstanceOwnMethods(fakeInstance);
         const mate = getMoostMate();
         const meta = mate.read(classConstructor) || {};
-        const ownPrefix = typeof opts.replaceOwnPrefix === 'string' ? opts.replaceOwnPrefix : (((_a = meta.controller) === null || _a === void 0 ? void 0 : _a.prefix) || '');
+        const ownPrefix = typeof opts.replaceOwnPrefix === 'string'
+            ? opts.replaceOwnPrefix
+            : ((_a = meta.controller) === null || _a === void 0 ? void 0 : _a.prefix) || '';
         const prefix = `${opts.globalPrefix}/${ownPrefix}`;
         for (const method of methods) {
             const methodMeta = getMoostMate().read(fakeInstance, method) || {};
@@ -215,25 +269,12 @@ function bindControllerMethods(options) {
                 continue;
             const pipes = [...(opts.pipes || []), ...(methodMeta.pipes || [])].sort((a, b) => a.priority - b.priority);
             // preparing interceptors
-            const interceptors = [...(opts.interceptors || []), ...(meta.interceptors || []), ...(methodMeta.interceptors || [])].sort((a, b) => a.priority - b.priority);
-            const getIterceptorHandler = () => {
-                const interceptorHandlers = [];
-                for (const { handler } of interceptors) {
-                    const interceptorMeta = mate.read(handler);
-                    if (interceptorMeta === null || interceptorMeta === void 0 ? void 0 : interceptorMeta.injectable) {
-                        interceptorHandlers.push((...args) => __awaiter(this, void 0, void 0, function* () {
-                            const { restoreCtx } = useEventContext();
-                            const targetInstance = yield getInstance();
-                            restoreCtx();
-                            return (yield getCallableFn(targetInstance, handler, restoreCtx, pipes, options.logger))(...args);
-                        }));
-                    }
-                    else {
-                        interceptorHandlers.push(handler);
-                    }
-                }
-                return Promise.resolve(new InterceptorHandler(interceptorHandlers));
-            };
+            const interceptors = [
+                ...(opts.interceptors || []),
+                ...(meta.interceptors || []),
+                ...(methodMeta.interceptors || []),
+            ].sort((a, b) => a.priority - b.priority);
+            const getIterceptorHandler = getIterceptorHandlerFactory(interceptors, getInstance, pipes, options.logger);
             // preparing pipes
             const argsPipes = [];
             for (const p of methodMeta.params || []) {
@@ -262,11 +303,6 @@ function bindControllerMethods(options) {
                     prefix,
                     fakeInstance,
                     getInstance,
-                    registerEventScope: (scopeId) => {
-                        const infact = getMoostInfact();
-                        infact.registerScope(scopeId);
-                        return () => infact.unregisterScope(scopeId);
-                    },
                     method,
                     handlers: methodMeta.handlers,
                     getIterceptorHandler,
@@ -278,21 +314,71 @@ function bindControllerMethods(options) {
     });
 }
 
+/**
+ * ## Label
+ * ### @Decorator
+ * _Common purpose decorator that may be used by various adapters for various purposes_
+ *
+ * Stores Label metadata
+ */
 function Label(value) {
     return getMoostMate().decorate('label', value);
 }
+/**
+ * ## Description
+ * ### @Decorator
+ * _Common purpose decorator that may be used by various adapters for various purposes_
+ *
+ * Stores Description metadata
+ */
+function Description(value) {
+    return getMoostMate().decorate('description', value);
+}
+/**
+ * ## Value
+ * ### @Decorator
+ * _Common purpose decorator that may be used by various adapters for various purposes_
+ *
+ * Stores Value metadata
+ */
+function Value(value) {
+    return getMoostMate().decorate('value', value);
+}
+/**
+ * ## Id
+ * ### @Decorator
+ * _Common purpose decorator that may be used by various adapters for various purposes_
+ *
+ * Stores Id metadata
+ */
 function Id(value) {
     return getMoostMate().decorate('id', value);
 }
+/**
+ * ## Optional
+ * ### @Decorator
+ * _Common purpose decorator that may be used by various adapters for various purposes_
+ *
+ * Stores Optional metadata
+ */
 function Optional() {
     return getMoostMate().decorate('optional', true);
 }
+/**
+ * ## Required
+ * ### @Decorator
+ * _Common purpose decorator that may be used by various adapters for various purposes_
+ *
+ * Stores Required metadata
+ */
 function Required() {
     const mate = getMoostMate();
     return mate.apply(mate.decorate('required', true), 
     // eslint-disable-next-line @typescript-eslint/no-unsafe-call
     mate.decorateClass((meta, level, key, index) => {
-        if (typeof index !== 'number' && meta && ['string', 'symbol'].includes(typeof key)) {
+        if (typeof index !== 'number' &&
+            meta &&
+            ['string', 'symbol'].includes(typeof key)) {
             // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
             meta.requiredProps = meta.requiredProps || [];
             // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
@@ -323,7 +409,7 @@ function Resolve(resolver, label) {
  * @paramType string
  */
 function Param(name) {
-    return Resolve(() => useRouteParams().get(name), name);
+    return getMoostMate().apply(getMoostMate().decorate('isRouteParam', name), Resolve(() => useRouteParams().get(name), name));
 }
 /**
  * Get Parsed Params from url parh
@@ -365,7 +451,9 @@ function fillLabel(target, key, index, name) {
     if (name) {
         const meta = getMoostMate().read(target, key);
         if (typeof index === 'number') {
-            if (!(meta === null || meta === void 0 ? void 0 : meta.params) || !(meta === null || meta === void 0 ? void 0 : meta.params[index]) || !(meta === null || meta === void 0 ? void 0 : meta.params[index].label)) {
+            if (!(meta === null || meta === void 0 ? void 0 : meta.params) ||
+                !(meta === null || meta === void 0 ? void 0 : meta.params[index]) ||
+                !(meta === null || meta === void 0 ? void 0 : meta.params[index].label)) {
                 Label(name)(target, key, index);
             }
         }
@@ -378,8 +466,9 @@ function fillLabel(target, key, index, name) {
 }
 
 /**
+ * ## Injectable
+ * ### @Decorator
  * Mark the Class as Injectable to enable it to be used in dependency injection
- * @decorator
  * @param scope - Scope for injection ("FOR_EVENT" | "SINGLETON" | true)
  * FOR_EVENT - will create a new instance for each incoming request
  * SINGLETON | true - will create a new instance only once
@@ -395,8 +484,9 @@ const insureInjectable = getMoostMate().decorate((meta) => {
 });
 
 /**
+ * ## Controller
+ * ### @Decorator
  * Set Class as a Controller
- * @decorator
  * @param prefix - define the prefix for all the paths of this controller
  */
 function Controller(prefix) {
@@ -406,8 +496,12 @@ function Controller(prefix) {
 function ImportController(prefix, controller, provide) {
     return getMoostMate().decorate('importController', {
         prefix: typeof prefix === 'string' ? prefix : undefined,
-        typeResolver: typeof prefix === 'string' ? controller : prefix,
-        provide: typeof prefix === 'string' ? provide || undefined : controller || undefined,
+        typeResolver: typeof prefix === 'string'
+            ? controller
+            : prefix,
+        provide: typeof prefix === 'string'
+            ? provide || undefined
+            : controller || undefined,
     }, true);
 }
 
@@ -425,26 +519,40 @@ var TInterceptorPriority;
     TInterceptorPriority[TInterceptorPriority["CATCH_ERROR"] = 5] = "CATCH_ERROR";
     TInterceptorPriority[TInterceptorPriority["AFTER_ALL"] = 6] = "AFTER_ALL";
 })(TInterceptorPriority || (TInterceptorPriority = {}));
+/**
+ * ## Intercept
+ * ### @Decorator
+ * Set interceptor
+ * @param handler interceptor fn (use defineInterceptorFn)
+ * @param priority interceptor priority
+ * @returns
+ */
 function Intercept(handler, priority) {
     return getMoostMate().decorate('interceptors', {
         handler,
-        priority: priority || handler.priority || TInterceptorPriority.INTERCEPTOR,
+        priority: priority ||
+            handler.priority ||
+            TInterceptorPriority.INTERCEPTOR,
     }, true);
 }
 
 /**
+ * ## Provide
+ * ### @Decorator
  * Defines provide registry for class (and all the children)
  * @param type - string or class constructor
  * @param fn - factory function for provided value
  */
 function Provide(type, fn) {
-    return getMoostMate().decorate(meta => {
+    return getMoostMate().decorate((meta) => {
         meta.provide = meta.provide || {};
         Object.assign(meta.provide, createProvideRegistry([type, fn]));
         return meta;
     });
 }
 /**
+ * ## Inject
+ * ### @Decorator
  * Defines a key from provide registry to inject value
  * (For optional values use with @Nullable())
  * @param type - string or class constructor
@@ -453,6 +561,8 @@ function Inject(type) {
     return getMoostMate().decorate('inject', type);
 }
 /**
+ * ## Nullable
+ * ### @Decorator
  * Makes injectable value optional
  * @param value default true
  */
@@ -494,6 +604,12 @@ function IsBoolean(...args) {
     return Validate(validoIsBoolean(...args));
 }
 
+/**
+ * ## Inherit
+ * ### @Decorator
+ * Inherit metadata from super class
+ * @returns
+ */
 const Inherit = () => getMoostMate().decorate('inherit', true);
 
 var TPipePriority;
@@ -509,7 +625,202 @@ var TPipePriority;
     TPipePriority[TPipePriority["AFTER_VALIDATE"] = 8] = "AFTER_VALIDATE";
 })(TPipePriority || (TPipePriority = {}));
 
-const resolvePipe = (_value, metas, level) => {
+const genericTypesCastPipe = (strict) => {
+    const handler = (value, { paramMeta: meta }) => {
+        if (meta === null || meta === void 0 ? void 0 : meta.type) {
+            if ((value === undefined ||
+                value === null ||
+                (meta.type !== String && value === '')) &&
+                meta.optional) {
+                return undefined;
+            }
+            switch (meta.type) {
+                case Date: {
+                    let d;
+                    if (typeof value === 'string') {
+                        d = new Date(/^\d+$/.test(value) ? Number(value) : value);
+                    }
+                    else {
+                        d = new Date(value);
+                    }
+                    if (strict && Number.isNaN(d.getTime())) {
+                        typeError(value, 'Date', meta.label);
+                    }
+                    return Number.isNaN(d.getTime()) ? value : d;
+                }
+                case Boolean:
+                    if ([
+                        true,
+                        'true',
+                        'TRUE',
+                        'True',
+                        1,
+                        '1',
+                        'X',
+                        'x',
+                    ].includes(value)) {
+                        return true;
+                    }
+                    if ([
+                        false,
+                        'false',
+                        'FALSE',
+                        'False',
+                        0,
+                        '0',
+                        '',
+                        ' ',
+                        null,
+                        undefined,
+                    ].includes(value)) {
+                        return false;
+                    }
+                    if (strict) {
+                        typeError(value, 'boolean', meta.label);
+                    }
+                    return value;
+                case Number: {
+                    if (strict && !value && value !== 0) {
+                        typeError(value, 'numeric', meta.label);
+                    }
+                    const n = typeof value === 'string' && value.length > 0
+                        ? Number(value)
+                        : NaN;
+                    if (strict && Number.isNaN(n)) {
+                        typeError(value, 'numeric', meta.label);
+                    }
+                    return Number.isNaN(n) ? value : n;
+                }
+                case String:
+                    if (strict &&
+                        ['object', 'function'].includes(typeof value)) {
+                        typeError(value, 'string', meta.label);
+                    }
+                    return (value && String(value)) || value;
+                default:
+                    return value;
+            }
+        }
+    };
+    handler.priority = TPipePriority.AFTER_TRANSFORM;
+    return handler;
+};
+function typeError(value, targetType, label) {
+    const prefix = label ? `Argument "${label}" with value ` : '';
+    throw new Error(`${prefix}${JSON.stringify(value)} is not a ${targetType} type`);
+}
+
+const valido = new Valido({
+    getDtoMeta(value, _type) {
+        let type = _type;
+        if (!type) {
+            type = getConstructor(value);
+        }
+        const mate = getMoostMate();
+        return mate.read(type);
+    },
+    getDtoParamMeta(value, type, key) {
+        const mate = getMoostMate();
+        return mate.read(type, key);
+    },
+});
+function getMoostValido() {
+    return valido;
+}
+
+const DEFAULT_ERROR_LIMIT = 10;
+function firstString(errors) {
+    const keys = Object.keys(errors);
+    for (const key of keys) {
+        if (typeof errors[key] === 'string')
+            return errors[key];
+        return firstString(errors[key]);
+    }
+    return '';
+}
+const validatePipe = (opts) => {
+    const pipe = (_value, metas, level) => __awaiter(void 0, void 0, void 0, function* () {
+        const { restoreCtx } = useEventContext();
+        const valido = getMoostValido();
+        let meta = {};
+        if (level === 'PARAM') {
+            meta = metas.paramMeta || {};
+        }
+        else if (level === 'PROP') {
+            meta = metas.propMeta || {};
+        }
+        else if (level === 'METHOD') {
+            meta = metas.methodMeta || {};
+        }
+        else if (level === 'CLASS') {
+            meta = metas.classMeta || {};
+        }
+        const result = yield valido.validateParam(_value, meta, metas.key, undefined, metas.instance, undefined, 0, 0, (opts === null || opts === void 0 ? void 0 : opts.errorLimit) || DEFAULT_ERROR_LIMIT, restoreCtx);
+        if (result !== true) {
+            const message = typeof result === 'string' ? result : firstString(result);
+            if (opts === null || opts === void 0 ? void 0 : opts.errorCb) {
+                opts.errorCb(message, result);
+            }
+            else {
+                throw new Error('Validation error: ' + message);
+            }
+        }
+        return _value;
+    });
+    pipe.priority = TPipePriority.VALIDATE;
+    return pipe;
+};
+
+/**
+ * ### Define Interceptor Function
+ *
+ * ```ts
+ * defineInterceptorFn((before, after, onError) => {
+ *         //init
+ *         before(() => {
+ *              // before handler
+ *         })
+ *         after((response, reply) => {
+ *              // after handler
+ *         })
+ *         onError((error, reply) => {
+ *              // when error occured
+ *         })
+ *     },
+ *     TInterceptorPriority.INTERCEPTOR,
+ * )
+ * ```
+ *
+ * @param fn interceptor function
+ * @param priority priority of the interceptor where BEFORE_ALL = 0, BEFORE_GUARD = 1, GUARD = 2, AFTER_GUARD = 3, INTERCEPTOR = 4, CATCH_ERROR = 5, AFTER_ALL = 6
+ * @returns
+ */
+function defineInterceptorFn(fn, priority = TInterceptorPriority.INTERCEPTOR) {
+    fn.priority = priority;
+    return fn;
+}
+/**
+ * ### Define Pipe Function
+ *
+ * ```ts
+ * // example of a transform pipe
+ * const uppercaseTransformPipe = definePipeFn((value, metas, level) => {
+ *         return typeof value === 'string' ? value.toUpperCase() : value
+ *     },
+ *     TPipePriority.TRANSFORM,
+ * )
+ * ```
+ *
+ * @param fn interceptor function
+ * @param priority priority of the pipe where BEFORE_RESOLVE = 0, RESOLVE = 1, AFTER_RESOLVE = 2, BEFORE_TRANSFORM = 3, TRANSFORM = 4, AFTER_TRANSFORM = 5, BEFORE_VALIDATE = 6, VALIDATE = 7, AFTER_VALIDATE = 8
+ * @returns
+ */
+function definePipeFn(fn, priority = TPipePriority.TRANSFORM) {
+    fn.priority = priority;
+    return fn;
+}
+
+const resolvePipe = definePipeFn((_value, metas, level) => {
     var _a, _b, _c, _d;
     let resolver;
     if (level === 'PARAM') {
@@ -528,8 +839,7 @@ const resolvePipe = (_value, metas, level) => {
         return resolver(metas, level);
     }
     return undefined;
-};
-resolvePipe.priority = TPipePriority.RESOLVE;
+}, TPipePriority.RESOLVE);
 
 const sharedPipes = [
     {
@@ -538,24 +848,6 @@ const sharedPipes = [
     },
 ];
 
-const valido = new Valido({
-    getDtoMeta(value, _type) {
-        let type = _type;
-        if (!type) {
-            type = getConstructor(value);
-        }
-        const mate = getMoostMate();
-        return mate.read(type);
-    },
-    getDtoParamMeta(value, type, key) {
-        const mate = getMoostMate();
-        return mate.read(type, key);
-    },
-});
-function getMoostValido() {
-    return valido;
-}
-
 function getDefaultLogger(topic) {
     return new ProstoLogger({
         level: 4,
@@ -567,6 +859,56 @@ function getDefaultLogger(topic) {
     }, topic);
 }
 
+/**
+ * ## Moost
+ * Main moostjs class that serves as a shell for Moost Adapters
+ *
+ * ### Usage with HTTP Adapter
+ * ```ts
+ * │  // HTTP server example
+ * │  import { MoostHttp, Get } from '@moostjs/event-http'
+ * │  import { Moost, Param } from 'moost'
+ * │
+ * │  class MyServer extends Moost {
+ * │      @Get('test/:name')
+ * │      test(@Param('name') name: string) {
+ * │          return { message: `Hello ${name}!` }
+ * │      }
+ * │  }
+ * │
+ * │  const app = new MyServer()
+ * │  const http = new MoostHttp()
+ * │  app.adapter(http).listen(3000, () => {
+ * │      app.getLogger('MyApp').log('Up on port 3000')
+ * │  })
+ * │  app.init()
+ * ```
+ * ### Usage with CLI Adapter
+ * ```ts
+ * │  // CLI example
+ * │  import { MoostCli, Cli, CliOption, cliHelpInterceptor } from '@moostjs/event-cli'
+ * │  import { Moost, Param } from 'moost'
+ * │
+ * │  class MyApp extends Moost {
+ * │      @Cli('command/:arg')
+ * │      command(
+ * │         @Param('arg')
+ * │         arg: string,
+ * │         @CliOption('test', 't')
+ * │         test: boolean,
+ * │      ) {
+ * │          return `command run with flag arg=${ arg }, test=${ test }`
+ * │      }
+ * │  }
+ * │
+ * │  const app = new MyApp()
+ * │  app.applyGlobalInterceptors(cliHelpInterceptor())
+ * │
+ * │  const cli = new MoostCli()
+ * │  app.adapter(cli)
+ * │  app.init()
+ * ```
+ */
 class Moost {
     constructor(options) {
         this.options = options;
@@ -580,6 +922,17 @@ class Moost {
         const mate = getMoostMate();
         Object.assign(mate, { logger: this.getLogger('mate') });
     }
+    /**
+     * ### getLogger
+     * Provides application logger
+     * ```js
+     * // get logger with topic = "App"
+     * const logger = app.getLogger('App')
+     * logger.log('...')
+     * ```
+     * @param topic
+     * @returns
+     */
     getLogger(topic) {
         if (this.logger instanceof ProstoLogger) {
             return this.logger.createTopic(topic);
@@ -590,13 +943,20 @@ class Moost {
         this.adapters.push(a);
         return a;
     }
+    /**
+     * ### init
+     * Ititializes adapter. Must be called after adapters are attached.
+     */
     init() {
         return __awaiter(this, void 0, void 0, function* () {
             this.setProvideRegistry(createProvideRegistry([Moost, () => this]));
             for (const a of this.adapters) {
                 const constructor = getConstructor(a);
                 if (constructor) {
-                    this.setProvideRegistry(createProvideRegistry([constructor, () => a]));
+                    this.setProvideRegistry(createProvideRegistry([
+                        constructor,
+                        () => a,
+                    ]));
                 }
                 if (typeof a.getProvideRegistry === 'function') {
                     this.setProvideRegistry(a.getProvideRegistry());
@@ -605,7 +965,7 @@ class Moost {
             this.unregisteredControllers.unshift(this);
             yield this.bindControllers();
             for (const a of this.adapters) {
-                yield (a.onInit && a.onInit());
+                yield (a.onInit && a.onInit(this));
             }
         });
     }
@@ -633,7 +993,9 @@ class Moost {
             const pipes = [...this.pipes, ...((classMeta === null || classMeta === void 0 ? void 0 : classMeta.pipes) || [])].sort((a, b) => a.priority - b.priority);
             let instance;
             const infactOpts = { provide, customData: { pipes } };
-            if (isControllerConsructor && ((classMeta === null || classMeta === void 0 ? void 0 : classMeta.injectable) === 'SINGLETON' || (classMeta === null || classMeta === void 0 ? void 0 : classMeta.injectable) === true)) {
+            if (isControllerConsructor &&
+                ((classMeta === null || classMeta === void 0 ? void 0 : classMeta.injectable) === 'SINGLETON' ||
+                    (classMeta === null || classMeta === void 0 ? void 0 : classMeta.injectable) === true)) {
                 instance = (yield infact.get(controller, infactOpts));
             }
             else if (!isControllerConsructor) {
@@ -641,16 +1003,20 @@ class Moost {
                 infact.setProvideRegByInstance(instance, provide);
             }
             // getInstance - instance factory for resolving SINGLETON and FOR_EVENT instance
-            const getInstance = instance ? () => Promise.resolve(instance) : () => __awaiter(this, void 0, void 0, function* () {
-                // if (!instance) {
-                infact.silent(true);
-                const { restoreCtx } = useEventContext();
-                const instance = yield infact.get(controller, Object.assign(Object.assign({}, infactOpts), { syncContextFn: restoreCtx }));
-                infact.silent(false);
-                // }
-                return instance;
-            });
-            const classConstructor = isConstructor(controller) ? controller : getConstructor(controller);
+            const getInstance = instance
+                ? () => Promise.resolve(instance)
+                : () => __awaiter(this, void 0, void 0, function* () {
+                    // if (!instance) {
+                    infact.silent(true);
+                    const { restoreCtx } = useEventContext();
+                    const instance = (yield infact.get(controller, Object.assign(Object.assign({}, infactOpts), { syncContextFn: restoreCtx })));
+                    infact.silent(false);
+                    // }
+                    return instance;
+                });
+            const classConstructor = isConstructor(controller)
+                ? controller
+                : getConstructor(controller);
             yield bindControllerMethods({
                 getInstance,
                 classConstructor,
@@ -663,7 +1029,9 @@ class Moost {
                 logger: this.logger,
             });
             if (classMeta && classMeta.importController) {
-                const prefix = typeof replaceOwnPrefix === 'string' ? replaceOwnPrefix : (_a = classMeta === null || classMeta === void 0 ? void 0 : classMeta.controller) === null || _a === void 0 ? void 0 : _a.prefix;
+                const prefix = typeof replaceOwnPrefix === 'string'
+                    ? replaceOwnPrefix
+                    : (_a = classMeta === null || classMeta === void 0 ? void 0 : classMeta.controller) === null || _a === void 0 ? void 0 : _a.prefix;
                 const mergedProvide = Object.assign(Object.assign({}, provide), ((classMeta === null || classMeta === void 0 ? void 0 : classMeta.provide) || {}));
                 for (const ic of classMeta.importController) {
                     if (ic.typeResolver) {
@@ -671,7 +1039,12 @@ class Moost {
                         const isFunc = typeof ic.typeResolver === 'function';
                         yield this.bindController(
                         // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-                        isConstr ? ic.typeResolver : isFunc ? yield ic.typeResolver() : ic.typeResolver, ic.provide ? Object.assign(Object.assign({}, mergedProvide), ic.provide) : mergedProvide, `${globalPrefix}/${(prefix || '')}`, ic.prefix);
+                        isConstr
+                            ? ic.typeResolver
+                            : isFunc
+                                ? yield ic.typeResolver()
+                                : ic.typeResolver, ic.provide
+                            ? Object.assign(Object.assign({}, mergedProvide), ic.provide) : mergedProvide, `${globalPrefix}/${prefix || ''}`, ic.prefix);
                     }
                 }
             }
@@ -682,7 +1055,9 @@ class Moost {
             if (typeof item === 'function') {
                 this.pipes.push({
                     handler: item,
-                    priority: typeof item.priority === 'number' ? item.priority : TPipePriority.TRANSFORM,
+                    priority: typeof item.priority === 'number'
+                        ? item.priority
+                        : TPipePriority.TRANSFORM,
                 });
             }
             else {
@@ -692,14 +1067,35 @@ class Moost {
                 });
             }
         }
+        this.globalInterceptorHandler = undefined;
         return this;
     }
+    /**
+     * Provides InterceptorHandler with global interceptors and pipes.
+     * Used to process interceptors when event handler was not found.
+     *
+     * @returns array of interceptors
+     */
+    getGlobalInterceptorHandler() {
+        if (!this.globalInterceptorHandler) {
+            const mate = getMoostMate();
+            const thisMeta = mate.read(this);
+            const pipes = [...(this.pipes || []), ...((thisMeta === null || thisMeta === void 0 ? void 0 : thisMeta.pipes) || [])].sort((a, b) => a.priority - b.priority);
+            const interceptors = [...this.interceptors, ...((thisMeta === null || thisMeta === void 0 ? void 0 : thisMeta.interceptors) || [])]
+                .sort((a, b) => a.priority - b.priority);
+            this.globalInterceptorHandler = getIterceptorHandlerFactory(interceptors, () => Promise.resolve(this), pipes, this.logger)();
+        }
+        return this.globalInterceptorHandler;
+    }
     applyGlobalInterceptors(...items) {
         for (const item of items) {
             if (typeof item === 'function') {
                 this.interceptors.push({
                     handler: item,
-                    priority: typeof item.priority === 'number' ? item.priority : TInterceptorPriority.INTERCEPTOR,
+                    priority: typeof item.priority === 'number'
+                        ? item
+                            .priority
+                        : TInterceptorPriority.INTERCEPTOR,
                 });
             }
             else {
@@ -709,6 +1105,7 @@ class Moost {
                 });
             }
         }
+        this.globalInterceptorHandler = undefined;
         return this;
     }
     /**
@@ -731,108 +1128,6 @@ class Moost {
     }
 }
 
-const genericTypesCastPipe = (strict) => {
-    const handler = (value, { paramMeta: meta }) => {
-        if (meta === null || meta === void 0 ? void 0 : meta.type) {
-            if ((value === undefined || value === null || (meta.type !== String && value === '')) && meta.optional) {
-                return undefined;
-            }
-            switch (meta.type) {
-                case Date: {
-                    let d;
-                    if (typeof value === 'string') {
-                        d = new Date(/^\d+$/.test(value) ? Number(value) : value);
-                    }
-                    else {
-                        d = new Date(value);
-                    }
-                    if (strict && Number.isNaN(d.getTime())) {
-                        typeError(value, 'Date', meta.label);
-                    }
-                    return Number.isNaN(d.getTime()) ? value : d;
-                }
-                case Boolean:
-                    if ([true, 'true', 'TRUE', 'True', 1, '1', 'X', 'x'].includes(value)) {
-                        return true;
-                    }
-                    if ([false, 'false', 'FALSE', 'False', 0, '0', '', ' ', null, undefined].includes(value)) {
-                        return false;
-                    }
-                    if (strict) {
-                        typeError(value, 'boolean', meta.label);
-                    }
-                    return value;
-                case Number: {
-                    if (strict && !value && value !== 0) {
-                        typeError(value, 'numeric', meta.label);
-                    }
-                    const n = typeof value === 'string' && value.length > 0 ? Number(value) : NaN;
-                    if (strict && Number.isNaN(n)) {
-                        typeError(value, 'numeric', meta.label);
-                    }
-                    return Number.isNaN(n) ? value : n;
-                }
-                case String:
-                    if (strict && ['object', 'function'].includes(typeof value)) {
-                        typeError(value, 'string', meta.label);
-                    }
-                    return value && String(value) || value;
-                default:
-                    return value;
-            }
-        }
-    };
-    handler.priority = TPipePriority.AFTER_TRANSFORM;
-    return handler;
-};
-function typeError(value, targetType, label) {
-    const prefix = label ? `Argument "${label}" with value ` : '';
-    throw new Error(`${prefix}${JSON.stringify(value)} is not a ${targetType} type`);
-}
-
-const DEFAULT_ERROR_LIMIT = 10;
-function firstString(errors) {
-    const keys = Object.keys(errors);
-    for (const key of keys) {
-        if (typeof errors[key] === 'string')
-            return errors[key];
-        return firstString(errors[key]);
-    }
-    return '';
-}
-const validatePipe = (opts) => {
-    const pipe = (_value, metas, level) => __awaiter(void 0, void 0, void 0, function* () {
-        const { restoreCtx } = useEventContext();
-        const valido = getMoostValido();
-        let meta = {};
-        if (level === 'PARAM') {
-            meta = metas.paramMeta || {};
-        }
-        else if (level === 'PROP') {
-            meta = metas.propMeta || {};
-        }
-        else if (level === 'METHOD') {
-            meta = metas.methodMeta || {};
-        }
-        else if (level === 'CLASS') {
-            meta = metas.classMeta || {};
-        }
-        const result = yield valido.validateParam(_value, meta, metas.key, undefined, metas.instance, undefined, 0, 0, (opts === null || opts === void 0 ? void 0 : opts.errorLimit) || DEFAULT_ERROR_LIMIT, restoreCtx);
-        if (result !== true) {
-            const message = typeof result === 'string' ? result : firstString(result);
-            if (opts === null || opts === void 0 ? void 0 : opts.errorCb) {
-                opts.errorCb(message, result);
-            }
-            else {
-                throw new Error('Validation error: ' + message);
-            }
-        }
-        return _value;
-    });
-    pipe.priority = TPipePriority.VALIDATE;
-    return pipe;
-};
-
 function setControllerContext(controller, method) {
     const { store } = useEventContext();
     const { set } = store('controller');
@@ -844,7 +1139,9 @@ function useControllerContext() {
     const { get } = store('controller');
     const getController = () => get('instance');
     const getMethod = () => get('method');
+    // todo: add generic types to getControllerMeta
     const getControllerMeta = () => getMoostMate().read(getController());
+    // todo: add generic types to getMethodMeta
     const getMethodMeta = () => getMoostMate().read(getController(), getMethod());
     return {
         getController,
@@ -854,4 +1151,118 @@ function useControllerContext() {
     };
 }
 
-export { Circular, Const, ConstFactory, Controller, Dto, Id, ImportController, Inherit, Inject, InjectEventLogger, Injectable, Intercept, InterceptorHandler, IsArray, IsBoolean, IsNumber, IsString, IsTypeOf, Label, Moost, Nullable, Optional, Param, Params, Provide, Required, Resolve, TInterceptorPriority, TPipePriority, Validate, genericTypesCastPipe, getMoostInfact, getMoostMate, getNewMoostInfact, resolvePipe, setControllerContext, useControllerContext, validatePipe };
+const infact = getMoostInfact();
+function registerEventScope(scopeId) {
+    infact.registerScope(scopeId);
+    return () => infact.unregisterScope(scopeId);
+}
+function defineMoostEventHandler(options) {
+    return () => __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const { restoreCtx } = useEventContext(options.contextType);
+        const scopeId = useEventId().getId();
+        const logger = useEventLogger(options.loggerTitle);
+        const unscope = registerEventScope(scopeId);
+        let response;
+        const hookOptions = {
+            restoreCtx,
+            scopeId,
+            logger,
+            unscope,
+            method: options.controllerMethod,
+            getResponse: () => response,
+            reply: (r) => response = r,
+        };
+        if ((_a = options.hooks) === null || _a === void 0 ? void 0 : _a.init) {
+            yield options.hooks.init(hookOptions);
+            restoreCtx();
+        }
+        const instance = yield options.getControllerInstance();
+        restoreCtx();
+        if (instance) {
+            setControllerContext(instance, options.controllerMethod || '');
+        }
+        const interceptorHandler = yield options.getIterceptorHandler();
+        if (interceptorHandler) {
+            restoreCtx();
+            try {
+                response = yield interceptorHandler.init();
+                if (typeof response !== 'undefined')
+                    return endWithResponse();
+            }
+            catch (e) {
+                options.logErrors && logger.error(e);
+                response = e;
+                return endWithResponse();
+            }
+        }
+        let args = [];
+        if (options.resolveArgs) {
+            // params
+            restoreCtx();
+            try {
+                // logger.trace(`resolving method args for "${ opts.method as string }"`)
+                args = yield options.resolveArgs();
+                // logger.trace(`args for method "${ opts.method as string }" resolved (count ${String(args.length)})`)
+            }
+            catch (e) {
+                options.logErrors && logger.error(e);
+                response = e;
+                return endWithResponse();
+            }
+        }
+        if (interceptorHandler) {
+            restoreCtx();
+            response = yield interceptorHandler.fireBefore(response);
+            if (typeof response !== 'undefined')
+                return endWithResponse();
+        }
+        // fire request handler
+        const callControllerMethod = () => {
+            restoreCtx();
+            if (options.callControllerMethod) {
+                return options.callControllerMethod(args);
+            }
+            else if (instance && options.controllerMethod && typeof instance[options.controllerMethod] === 'function') {
+                return instance[options.controllerMethod](...args);
+            }
+        };
+        try {
+            response = callControllerMethod();
+        }
+        catch (e) {
+            options.logErrors && logger.error(e);
+            response = e;
+        }
+        function endWithResponse() {
+            var _a;
+            return __awaiter(this, void 0, void 0, function* () {
+                // fire after interceptors
+                if (interceptorHandler) {
+                    restoreCtx();
+                    try {
+                        // logger.trace('firing after interceptors')
+                        response = yield interceptorHandler.fireAfter(response);
+                    }
+                    catch (e) {
+                        options.logErrors && logger.error(e);
+                        if (!options.manualUnscope) {
+                            unscope();
+                        }
+                        throw e;
+                    }
+                }
+                if (!options.manualUnscope) {
+                    unscope();
+                }
+                if ((_a = options.hooks) === null || _a === void 0 ? void 0 : _a.end) {
+                    yield options.hooks.end(hookOptions);
+                }
+                return response;
+            });
+        }
+        return yield endWithResponse();
+    });
+}
+
+export { Circular, Const, ConstFactory, Controller, Description, Dto, Id, ImportController, Inherit, Inject, InjectEventLogger, Injectable, Intercept, InterceptorHandler, IsArray, IsBoolean, IsNumber, IsString, IsTypeOf, Label, Moost, Nullable, Optional, Param, Params, Provide, Required, Resolve, TInterceptorPriority, TPipePriority, Validate, Value, defineInterceptorFn, defineMoostEventHandler, definePipeFn, genericTypesCastPipe, getMoostInfact, getMoostMate, getNewMoostInfact, registerEventScope, resolvePipe, setControllerContext, useControllerContext, validatePipe };