@radatek/microserver 2.1.0 → 2.2.0

package/dist/microserver.d.ts

@@ -1,6 +1,6 @@
 /**
  * MicroServer
- * @version 2.1.0
+ * @version 2.2.0
  * @package @radatek/microserver
  * @copyright Darius Kisonas 2022
  * @license MIT
@@ -40,8 +40,9 @@ export type Routes = () => {
 export declare abstract class Plugin {
     name?: string;
     priority?: number;
-    handler?(req: ServerRequest, res: ServerResponse, next: Function): void;
-    routes?: () => Routes | Routes;
+    handler?(req: ServerRequest, res: ServerResponse, next: Function): Promise<string | object | void> | string | object | void;
+    routes?(): Promise<Routes> | Routes;
+    initialise?(): Promise<void> | void;
     constructor(router: Router, ...args: any);
 }
 interface PluginClass {
@@ -222,6 +223,14 @@ export interface Middleware {
     priority?: number;
     plugin?: Plugin;
 }
+declare class Waiter {
+    get busy(): boolean;
+    startJob(): void;
+    endJob(id?: string): void;
+    get nextId(): string;
+    wait(id: string): Promise<void>;
+    resolve(id: string): void;
+}
 /** Router */
 export declare class Router extends EventEmitter {
     server: MicroServer;
@@ -229,8 +238,11 @@ export declare class Router extends EventEmitter {
     plugins: {
         [key: string]: Plugin;
     };
+    _waiter: Waiter;
     /** @param {MicroServer} server  */
     constructor(server: MicroServer);
+    /** bind middleware or create one from string like: 'redirect:302,https://redirect.to', 'error:422', 'param:name=value', 'acl:users/get', 'model:User', 'group:Users', 'user:admin' */
+    bind(fn: string | Function | object): Function;
     /** Handler */
     handler(req: ServerRequest, res: ServerResponse, next: Function, method?: string): any;
     /** Clear routes and middlewares */
@@ -241,54 +253,55 @@ export declare class Router extends EventEmitter {
      *
      * @signature add(plugin: Plugin)
      * @param {Plugin} plugin plugin module instance
-     * @return {Router} current router
+     * @return {Promise<>}
      *
      * @signature add(pluginid: string, ...args: any)
      * @param {string} pluginid pluginid module
      * @param {...any} args arguments passed to constructor
-     * @return {Router} current router
+     * @return {Promise<>}
      *
      * @signature add(pluginClass: typeof Plugin, ...args: any)
      * @param {typeof Plugin} pluginClass plugin class
      * @param {...any} args arguments passed to constructor
-     * @return {Router} current router
+     * @return {Promise<>}
      *
      * @signature add(middleware: Middleware)
      * @param {Middleware} middleware
-     * @return {Router} current router
+     * @return {Promise<>}
      *
      * @signature add(methodUrl: string, ...middlewares: any)
      * @param {string} methodUrl 'METHOD /url' or '/url'
      * @param {...any} middlewares
-     * @return {Router} current router
+     * @return {Promise<>}
      *
      * @signature add(methodUrl: string, controllerClass: typeof Controller)
      * @param {string} methodUrl 'METHOD /url' or '/url'
      * @param {typeof Controller} controllerClass
-     * @return {Router} current router
+     * @return {Promise<>}
      *
      * @signature add(methodUrl: string, routes: Array<Array<any>>)
      * @param {string} methodUrl 'METHOD /url' or '/url'
      * @param {Array<Array<any>>} routes list with subroutes: ['METHOD /suburl', ...middlewares]
-     * @return {Router} current router
+     * @return {Promise<>}
      *
      * @signature add(methodUrl: string, routes: Array<Array<any>>)
      * @param {string} methodUrl 'METHOD /url' or '/url'
      * @param {Array<Array<any>>} routes list with subroutes: ['METHOD /suburl', ...middlewares]
-     * @return {Router} current router
+     * @return {Promise<>}
      *
      * @signature add(routes: { [key: string]: Array<any> })
      * @param { {[key: string]: Array<any>} } routes list with subroutes: 'METHOD /suburl': [...middlewares]
-     * @return {Router} current router
+     * @return {Promise<>}
      *
      * @signature add(methodUrl: string, routes: { [key: string]: Array<any> })
      * @param {string} methodUrl 'METHOD /url' or '/url'
      * @param { {[key: string]: Array<any>} } routes list with subroutes: 'METHOD /suburl': [...middlewares]
-     * @return {Router} current router
+     * @return {Promise<>}
      */
-    use(...args: any): Router;
+    use(...args: any): Promise<void>;
+    waitPlugin(id: string): Promise<Plugin>;
     /** Add hook */
-    hook(url: string, ...mid: Middleware[]): Router;
+    hook(url: string, ...mid: Middleware[]): void;
     /** Check if middleware allready added */
     has(mid: Middleware): boolean;
 }
@@ -364,23 +377,22 @@ export declare class MicroServer extends EventEmitter {
     sockets: Set<net.Socket>;
     /** server instances */
     servers: Set<net.Server>;
+    _waiter: Waiter;
     static plugins: {
         [key: string]: PluginClass;
     };
-    get plugins(): {
-        [key: string]: Plugin;
-    };
     constructor(config: MicroServerConfig);
     /** Add one time listener or call immediatelly for 'ready' */
     once(name: string, cb: Function): this;
     /** Add listener and call immediatelly for 'ready'  */
     on(name: string, cb: Function): this;
+    isReady(): boolean;
+    waitReady(): Promise<void>;
+    waitPlugin(id: string): Promise<void>;
     /** Listen server, should be used only if config.listen is not set */
-    listen(config?: ListenConfig): Promise<unknown>;
-    /** bind middleware or create one from string like: 'redirect:302,https://redirect.to', 'error:422', 'param:name=value', 'acl:users/get', 'model:User', 'group:Users', 'user:admin' */
-    bind(fn: string | Function | object): Function;
+    listen(config?: ListenConfig): Promise<void>;
     /** Add middleware, routes, etc.. see {router.use} */
-    use(...args: any): MicroServer;
+    use(...args: any): Promise<void>;
     /** Default server handler */
     handler(req: ServerRequest, res: ServerResponse): void;
     protected requestInit(req: ServerRequest, res?: ServerResponse): void;