web_api_base 3.5.0 → 3.6.2

package/dist/documentation/JS.js

@@ -0,0 +1,239 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const Application_1 = __importDefault(require("../Application"));
+class JS {
+    static Append(text) {
+        JS._js += text;
+    }
+    static Save() {
+        let app = "";
+        let version = "";
+        let description = "";
+        try {
+            if (fs_1.default.existsSync(`${Application_1.default.Configurations.RootPath}\\package.json`)) {
+                let j = JSON.parse(fs_1.default.readFileSync(`${Application_1.default.Configurations.RootPath}\\package.json`, 'utf-8'));
+                app = j.name;
+                version = j.version;
+                description = j.description;
+                this._js = this._js.replace('??APP', `${app} ${version}`);
+                this._js = this._js.replace('??DESC', `${description}`);
+            }
+        }
+        catch (err) {
+            console.error(err);
+        }
+        fs_1.default.writeFileSync(`${__dirname}\\script.js`, JS._js, 'utf-8');
+    }
+}
+exports.default = JS;
+JS._js = `
+    document.getElementById('root').innerHTML += '<div class="header" ><div class="DivHeader"><p>Made with <a href="https://www.npmjs.com/package/web_api_base" target="_blank">web_api_base</a></p></div></div>';
+    document.getElementsByClassName('header')[0].innerHTML += '<div class="DivHeader DivHeaderRight"><p class="pTitle" style="font-size: 14px;font-weight:600;">??APP</p><p>??DESC</p></div>';
+    
+        function AddResource(route)
+        {    
+            console.log(route);
+    
+            document.getElementById('root').innerHTML += '<div id="'+ route.Controller.toLowerCase()+'" class="card"></div>';
+    
+            let root = document.getElementById(route.Controller.toLowerCase());           
+               
+            root.innerHTML += '<h1 >'+route.Controller+'</h1>';
+           
+            for(let r of route.Resources)
+            {
+        
+                let expandId = { ID : 'link_' + r.Id, RID : r.Id};
+        
+                try{
+                    r.Template = JSON.stringify(JSON.parse(r.Template), null, 2);
+                }catch{}
+        
+                let verbClass = "OTHER";
+    
+                if(["GET", "POST", "PUT", "DELETE"].includes(r.Verb))
+                {
+                    verbClass = r.Verb
+                }
+    
+                root.innerHTML += '<h2 id="'+ expandId.ID +'"><verb class="'+ verbClass+'">'+r.Verb+'</verb> '+window.location.origin+r.Route+'</h2>';
+                root.innerHTML += '<div id="'+r.Id+'_container" class="container"></div>';
+                let container = document.getElementById(r.Id + '_container');
+    
+                for(let c of r.FromQuery)
+                {
+                    container.innerHTML += '<div class="token-container"><input type="text" id="key-'+r.Id+r.FromQuery.indexOf(c)+'" placeholder="'+c.Field+'"></div>';
+                }
+    
+                if(r.FromBody.length > 0)
+                    container.innerHTML += '<textarea id="body-'+r.Id+'" placeholder="{}" spellcheck="false">'+r.Template+'</textarea>';
+    
+                    
+                if(r.Description)
+                {
+                    container.innerHTML += '<h3>'+r.Description+'</h3>';
+    
+                }else {
+    
+                    container.innerHTML += '<h3>Use @Description(...) to add a description to a action</h3>';
+                }
+                
+               
+                container.innerHTML += '<div class="btn-container" ><button id="bt-'+expandId.ID+'">Send</button></div>';
+                
+                if(r.Response.length > 0 && r.Response[0].JSON?.length > 0)
+                {
+                    container.innerHTML += '<h3 id="response-bar-'+r.Id+'">Response'+(r.Response.length > 1 ? 's': '')+':</h3>';
+    
+                    container.innerHTML += '<div id="status-bar-'+r.Id+'" class="btn-container" ></div>';              
+    
+    
+                    for(let s of r.Response.sort((a, b)=> a.Status - b.Status))
+                    { 
+                        let bar = document.getElementById('status-bar-'+r.Id);
+    
+                        let classValue = "Info";
+        
+                        if(s.Status.toString().indexOf('2') == 0)
+                        {
+                            classValue = "OK";  
+        
+                        }else if(s.Status.toString().indexOf('4') == 0)
+                        {
+                            classValue = "ErrorClient";
+                        }
+                        else if(s.Status.toString().indexOf('5') == 0)
+                        {
+                            classValue = "ErrorServer";
+                        }    
+                        
+                       
+                        bar.innerHTML += '<div><status id="status-'+r.Id+s.Status+'" class="'+classValue+'"> '+s.Status+ '</status> <tx>' + (s.Description ?? '')+'</tx></div>';
+    
+                        document.addEventListener('DOMContentLoaded', function() {
+    
+                            document.getElementById('status-'+r.Id+s.Status).addEventListener('click', function (evt) {
+                
+                                let textarea = document.getElementById('response-area-'+r.Id);
+                                textarea.value = s.JSON;
+                               
+                            });
+    
+                           
+                        });
+    
+                        
+                    }
+    
+                   
+                }else{
+    
+                    container.innerHTML += '<h3 id="response-bar-'+r.Id+'">Response:</h3>';
+                    container.innerHTML += '<div id="status-bar-'+r.Id+'" class="btn-container" style="display:none;" ></div>';
+                }
+    
+                document.addEventListener('DOMContentLoaded', function() {
+                                 
+    
+                    document.getElementById('bt-'+expandId.ID).addEventListener('click', (evt) => 
+                    {
+                        let body = document.getElementById('body-'+r.Id);   
+                        let resp = document.getElementById('response-area-'+r.Id);   
+                        let bar = document.getElementById('status-bar-'+r.Id);
+                        let h3 = document.getElementById('response-bar-'+r.Id);                
+    
+                        let req = new XMLHttpRequest();
+                        let args = '?';
+                        for(let c of r.FromQuery)
+                        {
+                            let input = document.getElementById('key-'+r.Id+r.FromQuery.indexOf(c));
+    
+                            args+= c.Field + '="' + input.value + '"&';
+                        }
+    
+                        if(args.length > 1){
+                            args = args.substring(0, args.length -1);
+                        }else 
+                        {
+                            args = '';
+                        }
+    
+                        req.open(r.Verb, window.location.origin+r.Route+args, true);
+                        req.setRequestHeader('Content-type', 'application/json');
+                        req.onerror = ()=>
+                        {
+                            h3.innerText = "Current response:";
+                            bar.style.display = "flex";
+                            resp.value = 'Error to send the request';
+                            bar.innerHTML = '<div><status class="ErrorServer">-1</status> <tx>Error on request</tx></div>';
+                        }
+    
+                      
+                        req.onreadystatechange = ()=>
+                        {
+                            if(req.readyState == 4 && req.status > 0)
+                            {
+                                h3.innerText = "Current response:";
+    
+                                bar.style.display = "flex";
+    
+                                let classValue = "Info";
+                
+                                if(req.status.toString().indexOf('2') == 0)
+                                {
+                                    classValue = "OK";  
+                
+                                }else if(req.status.toString().indexOf('4') == 0)
+                                {
+                                    classValue = "ErrorClient";
+                                }
+                                else if(req.status.toString().indexOf('5') == 0)
+                                {
+                                    classValue = "ErrorServer";
+                                }
+                            
+                                console.log(req);
+                                bar.innerHTML = '<div><status class="'+classValue+'"> '+req.status+ '</status> <tx>New request</tx></div>';
+                                resp.value = JSON.stringify(JSON.parse(req.responseText), null, 2);
+                            }
+                        }
+    
+                        if(body){
+                            req.send(body.value);
+                        }else
+                        {
+                            req.send();
+                        }
+                        
+                    });
+                });            
+                
+                container.innerHTML += '<textarea id="response-area-'+r.Id+'" style="margin-top:5px"; spellcheck="false" ></textarea>';          
+                
+               
+                document.addEventListener('DOMContentLoaded', function() {
+                    document.getElementById(expandId.ID).addEventListener('click', function (evt) {
+        
+                        let div = document.getElementById(expandId.RID + '_container');
+        
+                        if(div.style.display == "flex")
+                            div.style.display = "none";
+                        else
+                            div.style.display = "flex";
+                    });
+                    
+                });
+                    
+            }    
+        
+            
+            
+        }
+
+
+    `;
+//# sourceMappingURL=JS.js.map

package/dist/documentation/JS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JS.js","sourceRoot":"","sources":["../../documentation/JS.ts"],"names":[],"mappings":";;;;;AAAA,4CAAoB;AACpB,iEAAyC;AAEzC,MAAqB,EAAE;IAiNZ,MAAM,CAAC,MAAM,CAAC,IAAa;QAE9B,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC;IACnB,CAAC;IAEM,MAAM,CAAC,IAAI;QAEd,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,WAAW,GAAG,EAAE,CAAC;QAErB,IAAG;YAEC,IAAG,YAAE,CAAC,UAAU,CAAC,GAAG,qBAAW,CAAC,cAAc,CAAC,QAAQ,gBAAgB,CAAC,EACxE;gBACI,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,GAAG,qBAAW,CAAC,cAAc,CAAC,QAAQ,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;gBACrG,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC;gBACb,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;gBACpB,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;gBAE5B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC;gBAC1D,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;aAC3D;SAEJ;QAAA,OAAM,GAAG,EACV;YACI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACtB;QAED,YAAE,CAAC,aAAa,CAAC,GAAG,SAAS,aAAa,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;;AA/OL,qBAgPC;AA9OkB,MAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6MpB,CAAC"}

package/dist/exceptions/ArgumentNullException.d.ts

@@ -0,0 +1,3 @@
+import Exception from "./Exception";
+export default class ArgumentNullException extends Exception {
+}

package/dist/exceptions/ArgumentNullException.js

@@ -0,0 +1,10 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Exception_1 = __importDefault(require("./Exception"));
+class ArgumentNullException extends Exception_1.default {
+}
+exports.default = ArgumentNullException;
+//# sourceMappingURL=ArgumentNullException.js.map

package/dist/exceptions/ArgumentNullException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArgumentNullException.js","sourceRoot":"","sources":["../../exceptions/ArgumentNullException.ts"],"names":[],"mappings":";;;;;AAAA,4DAAoC;AAGpC,MAAqB,qBAAsB,SAAQ,mBAAS;CAC3D;AADD,wCACC"}

package/dist/exceptions/FindDependencyException.d.ts

@@ -0,0 +1,3 @@
+import Exception from "./Exception";
+export default class FindDependencyException extends Exception {
+}

package/dist/exceptions/FindDependencyException.js

@@ -0,0 +1,10 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Exception_1 = __importDefault(require("./Exception"));
+class FindDependencyException extends Exception_1.default {
+}
+exports.default = FindDependencyException;
+//# sourceMappingURL=FindDependencyException.js.map

package/dist/exceptions/FindDependencyException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FindDependencyException.js","sourceRoot":"","sources":["../../exceptions/FindDependencyException.ts"],"names":[],"mappings":";;;;;AAAA,4DAAoC;AAIpC,MAAqB,uBAAwB,SAAQ,mBAAS;CAC7D;AADD,0CACC"}

package/dist/index.d.ts

@@ -3,12 +3,14 @@ export { default as ApplicationConfiguration } from "./ApplicationConfiguration"
 export { default as ControllersDecorators } from "./decorators/controllers/ControllerDecorators";
 export { ControllerBase } from "./controllers/base/ControllerBase";
 export { HTTPVerbs } from './enums/httpVerbs/HttpVerbs';
+export { default as Exception } from './exceptions/Exception';
 export { default as DependecyService } from "./dependencyInjection/DependecyService";
 export { default as IMidleware } from './midlewares/IMidleware';
 export { default as IApplicationConfiguration } from "./interfaces/IApplicationConfiguration";
 export { default as IApplication } from "./interfaces/IApplication";
 export { default as IApplicatiIControllernConfiguration } from "./interfaces/IController";
 export { IHTTPRequestContext, IRequestResult, IRequestResultHandler } from "./midlewares/IMidleware";
+import { DocumentationDecorators } from "./decorators/documentation/DocumentationDecorators";
 import { HTTPVerbs } from "./enums/httpVerbs/HttpVerbs";
 import IMidleware, { IRequestResultHandler } from "./midlewares/IMidleware";
 export declare function UseBefore(midleware: IMidleware): (target: Function) => void;
@@ -21,6 +23,9 @@ export declare function GET(action?: string): (target: Object, methodName: strin
 export declare function POST(action?: string): (target: Object, methodName: string, propertyDescriptor: PropertyDescriptor) => void;
 export declare function PUT(action?: string): (target: Object, methodName: string, propertyDescriptor: PropertyDescriptor) => void;
 export declare function DELETE(action?: string): (target: Object, methodName: string, propertyDescriptor: PropertyDescriptor) => void;
+export declare function Description(description: string): (target: Object, methodName: string, propertyDescriptor: PropertyDescriptor) => void;
+export declare function RequestJson(json: string): (target: Object, methodName: string, propertyDescriptor: PropertyDescriptor) => void;
+export declare function ProducesResponse(response: Parameters<typeof DocumentationDecorators.ProducesResponse>[0]): (target: Object, methodName: string, propertyDescriptor: PropertyDescriptor) => void;
 export declare function Verb(verb: HTTPVerbs): (target: Object, methodName: string, propertyDescriptor: PropertyDescriptor) => void;
 export declare function Inject(): (target: Object, property: string | symbol) => void;
 export declare function InjectAbstract(cTor: Function): (target: Object, property: string | symbol) => void;

package/dist/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FromQuery = exports.FromBody = exports.Rule = exports.Regex = exports.Min = exports.Max = exports.MinLenght = exports.MaxLenght = exports.Required = exports.ValidateObject = exports.Validate = exports.InjectAbstract = exports.Inject = exports.Verb = exports.DELETE = exports.PUT = exports.POST = exports.GET = exports.Route = exports.Action = exports.RunAfter = exports.UseAfter = exports.RunBefore = exports.UseBefore = exports.DependecyService = exports.HTTPVerbs = exports.ControllerBase = exports.ControllersDecorators = exports.ApplicationConfiguration = exports.Application = void 0;
+exports.FromQuery = exports.FromBody = exports.Rule = exports.Regex = exports.Min = exports.Max = exports.MinLenght = exports.MaxLenght = exports.Required = exports.ValidateObject = exports.Validate = exports.InjectAbstract = exports.Inject = exports.Verb = exports.ProducesResponse = exports.RequestJson = exports.Description = exports.DELETE = exports.PUT = exports.POST = exports.GET = exports.Route = exports.Action = exports.RunAfter = exports.UseAfter = exports.RunBefore = exports.UseBefore = exports.DependecyService = exports.Exception = exports.HTTPVerbs = exports.ControllerBase = exports.ControllersDecorators = exports.ApplicationConfiguration = exports.Application = void 0;
 var Application_1 = require("./Application");
 Object.defineProperty(exports, "Application", { enumerable: true, get: function () { return __importDefault(Application_1).default; } });
 var ApplicationConfiguration_1 = require("./ApplicationConfiguration");
@@ -14,9 +14,12 @@ var ControllerBase_1 = require("./controllers/base/ControllerBase");
 Object.defineProperty(exports, "ControllerBase", { enumerable: true, get: function () { return ControllerBase_1.ControllerBase; } });
 var HttpVerbs_1 = require("./enums/httpVerbs/HttpVerbs");
 Object.defineProperty(exports, "HTTPVerbs", { enumerable: true, get: function () { return HttpVerbs_1.HTTPVerbs; } });
+var Exception_1 = require("./exceptions/Exception");
+Object.defineProperty(exports, "Exception", { enumerable: true, get: function () { return __importDefault(Exception_1).default; } });
 var DependecyService_1 = require("./dependencyInjection/DependecyService");
 Object.defineProperty(exports, "DependecyService", { enumerable: true, get: function () { return __importDefault(DependecyService_1).default; } });
 const ControllerDecorators_2 = __importDefault(require("./decorators/controllers/ControllerDecorators"));
+const DocumentationDecorators_1 = require("./decorators/documentation/DocumentationDecorators");
 const ValidationDecorators_1 = __importDefault(require("./decorators/validations/ValidationDecorators"));
 const DependecyService_2 = __importDefault(require("./dependencyInjection/DependecyService"));
 const HttpVerbs_2 = require("./enums/httpVerbs/HttpVerbs");
@@ -70,6 +73,21 @@ function DELETE(action) {
 }
 exports.DELETE = DELETE;
 ;
+function Description(description) {
+    return DocumentationDecorators_1.DocumentationDecorators.Description(description);
+}
+exports.Description = Description;
+;
+function RequestJson(json) {
+    return DocumentationDecorators_1.DocumentationDecorators.RequestJson(json);
+}
+exports.RequestJson = RequestJson;
+;
+function ProducesResponse(response) {
+    return DocumentationDecorators_1.DocumentationDecorators.ProducesResponse(response);
+}
+exports.ProducesResponse = ProducesResponse;
+;
 function Verb(verb) {
     return ControllerDecorators_2.default.Verb(verb);
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/IApplication.d.ts

@@ -6,6 +6,7 @@ export default interface IApplication {
     ApplicationThreadExeptionHandler?: ApplicationExceptionHandler;
     StartAsync(): Promise<void>;
     ConfigureAsync(appConfig: IApplicationConfiguration): Promise<void>;
+    CreateDocumentation(): void;
 }
 export interface ApplicationExceptionHandler {
     (request: Request, response: Response, exception: Exception): void;

package/dist/interfaces/IApplicationConfiguration.d.ts

@@ -2,8 +2,9 @@ export default interface IApplicationConfiguration {
     Host: string;
     Port: number;
     RootPath: string;
+    DEBUG: boolean;
     EnviromentVariables: {
-        [ket: string]: string;
+        [key: string]: any;
     };
     AddScoped(type: Function, ctor?: (new (...args: any[]) => any) | undefined, builder?: (() => any) | undefined): void;
     AddTransient(type: Function, ctor?: (new (...args: any[]) => any) | undefined, builder?: (() => any) | undefined): void;

package/dist/metadata/Type.d.ts

@@ -0,0 +1,4 @@
+export default class Type {
+    static CreateTemplateFrom<T extends object>(ctor: new (...args: any[]) => T): T;
+    static FillObject<T extends object>(obj: T): T;
+}

package/dist/metadata/Type.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class Type {
+    static CreateTemplateFrom(ctor) {
+        let base = Reflect.construct(ctor, []);
+        for (let map in base) {
+            let designType = Reflect.getMetadata("design:type", ctor, map);
+            if (designType) {
+                if (designType != Array)
+                    base[map] = Type.FillObject(Reflect.construct(designType, []));
+                else
+                    base[map] = [Type.FillObject(Reflect.construct(designType, []))];
+            }
+        }
+        return Type.FillObject(base);
+    }
+    static FillObject(obj) {
+        for (let c in obj) {
+            let d = Reflect.getMetadata("design:type", obj, c);
+            if (!d)
+                continue;
+            if (d.name === "Number")
+                obj[c] = -1;
+            else if (d.name === "String")
+                obj[c] = c;
+            else if (d.name === "Boolean")
+                obj[c] = false;
+            else if (d.name === "Date")
+                obj[c] = new Date();
+            else if (d.name === "Object")
+                obj[c] = {};
+        }
+        return obj;
+    }
+}
+exports.default = Type;
+//# sourceMappingURL=Type.js.map

package/dist/metadata/Type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Type.js","sourceRoot":"","sources":["../../metadata/Type.ts"],"names":[],"mappings":";;AAEA,MAAqB,IAAI;IAEd,MAAM,CAAC,kBAAkB,CAAmB,IAA+B;QAC9E,IAAI,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAM,CAAC;QAE5C,KAAK,IAAI,GAAG,IAAI,IAAI,EAAE;YAElB,IAAI,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YAE/D,IAAI,UAAU,EAAE;gBACZ,IAAI,UAAU,IAAI,KAAK;oBAClB,IAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAW,CAAC,CAAC;;oBAGjF,IAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAW,CAAC,CAAC,CAAC;aAC3F;SACJ;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAEM,MAAM,CAAC,UAAU,CAAmB,GAAM;QAE7C,KAAK,IAAI,CAAC,IAAI,GAAG,EAAE;YACf,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAEnD,IAAI,CAAC,CAAC;gBACF,SAAS;YAEb,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAClB,GAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;iBACpB,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBACvB,GAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;iBACnB,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;gBACxB,GAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;iBACvB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;gBACrB,GAAW,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;iBAC5B,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBACvB,GAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;SAC5B;QAED,OAAO,GAAG,CAAC;IACf,CAAC;CAIJ;AA9CD,uBA8CC"}

package/dist/midlewares/IMidleware.d.ts

@@ -1,4 +1,5 @@
 import { Request, Response } from "express";
+import Exception from "../exceptions/Exception";
 export default interface IMidleware {
     (context: IHTTPRequestContext): void;
 }
@@ -11,7 +12,7 @@ export interface IHTTPRequestContext {
     Next: () => void;
 }
 export interface IRequestResult {
-    Exception?: Error;
+    Exception?: Exception;
     Result?: any;
     Request: Request;
     Response: Response;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web_api_base",
-  "version": "3.5.0",
+  "version": "3.6.2",
   "description": "web api base",  
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/readme.md

@@ -64,7 +64,7 @@ export default class App extends Application
         this.UseCors();
 
         //if the controlles follow the naming rules, the method UseControllers will automatically append them
-        this.UseControllers();   
+        this.UseControllersAsync();   
 
     }  
 }
@@ -217,7 +217,44 @@ Send status 500 and a optional body
 Send a status code and a optional body
 
 
+# Filters
+### @UseBefore()
+Append a delegate to execute **before** the controller´s action
+```typescript
+@Route("/status")
+@UseBefore(context => 
+{
+
+    if(context.Request.headers["token"] != "we have access to request object")
+         context.Response.json({Message : "we have access to response object"});
+    else
+         context.Next(); // call next function in the pipeline
+})
+export default class StatusController extends ControllerBase
+{
+```
+
+### @UseAfter()
+Append a delegate to execute **after** the controller´s action
+```typescript
+@Route("/status")
+@UseAfter(actionResult => 
+{
+
+      if(actionResult.Exception) // if a exception was launched
+      {
+          actionResult.Response.status(500);  // we can access the original request
+          actionResult.Response.json({Error : actionResult.Exception.Message});
+          return;
+      }
 
+      actionResult.Response.status(200);  // we can access the original response
+      actionResult.Response.json(actionResult.Result); // we can acess the return of controller´s action   
+
+})
+export default class StatusController extends ControllerBase
+{
+```
 
 
 # Model Bind decorators
@@ -419,6 +456,32 @@ export default class ValidatedObject
 }
 ```
 
+# Auto-generated documentation
+
+We can create a API playground(host/playground) using the Aplication.CreateDocumentation method inside the Application.ConfigureAsync
+
+```typescript
+ public override async ConfigureAsync(appConfig: IApplicationConfiguration): Promise<void>
+    {  
+        this.UseCors();         
+        
+        await this.UseControllersAsync();
+
+        appConfig.AddScoped(SampleServiceAbstract, AnotherService);
+
+        if(Application.DEBUG)
+            this.CreateDocumentation();
+
+    }    
+```
+
+### To use the default theme, run the API with **--debug** argument
+
+[![Alt text](https://raw.githubusercontent.com/adrianomarino1992/web_api_base/master/light.png)](https://raw.githubusercontent.com/adrianomarino1992/web_api_base/master/light.png)
+
+### To use the dark theme, run the API with **--debug --dark** arguments
+[![Alt text](https://raw.githubusercontent.com/adrianomarino1992/web_api_base/5057c23221750ea4315142e88c7af80c2370682c/dark.png)](https://raw.githubusercontent.com/adrianomarino1992/web_api_base/5057c23221750ea4315142e88c7af80c2370682c/dark.png)
+
 
 ## Contributing
 

package/dist/temp/Application.d.ts

@@ -1,5 +0,0 @@
-import { Application, IApplicationConfiguration } from "../index";
-export default class App extends Application {
-    constructor();
-    ConfigureAsync(appConfig: IApplicationConfiguration): Promise<void>;
-}

package/dist/temp/Application.js

@@ -1,27 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("../index");
-const SampleService_1 = require("./service/SampleService");
-class App extends index_1.Application {
-    constructor() {
-        super();
-    }
-    ConfigureAsync(appConfig) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.UseCors();
-            appConfig.AddScoped(SampleService_1.SampleServiceAbstract, SampleService_1.AnotherService);
-            this.UseControllers();
-        });
-    }
-}
-exports.default = App;
-//# sourceMappingURL=Application.js.map

package/dist/temp/Application.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Application.js","sourceRoot":"","sources":["../../temp/Application.ts"],"names":[],"mappings":";;;;;;;;;;;AAEA,oCAAkE;AAElE,2DAAgF;AAGhF,MAAqB,GAAI,SAAQ,mBAAW;IAExC;QAEI,KAAK,EAAE,CAAC;IACZ,CAAC;IAEqB,cAAc,CAAC,SAAoC;;YAErE,IAAI,CAAC,OAAO,EAAE,CAAC;YAEf,SAAS,CAAC,SAAS,CAAC,qCAAqB,EAAE,8BAAc,CAAC,CAAC;YAE3D,IAAI,CAAC,cAAc,EAAE,CAAC;QAE1B,CAAC;KAAA;CAGJ;AAlBD,sBAkBC"}

package/dist/temp/Index.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/temp/Index.js

@@ -1,19 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const Application_1 = __importDefault(require("./Application"));
-(() => __awaiter(void 0, void 0, void 0, function* () {
-    yield new Application_1.default().StartAsync();
-}))();
-//# sourceMappingURL=Index.js.map

package/dist/temp/Index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Index.js","sourceRoot":"","sources":["../../temp/Index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,gEAAwC;AAExC,CAAC,GAAQ,EAAE;IAEP,MAAM,IAAI,qBAAW,EAAE,CAAC,UAAU,EAAE,CAAC;AAEzC,CAAC,CAAA,CAAC,EAAE,CAAC"}

package/dist/temp/controllers/StatusController.d.ts

@@ -1,21 +0,0 @@
-import { ControllerBase } from "../../index";
-import { SampleServiceAbstract } from "../service/SampleService";
-export default class StatusController extends ControllerBase {
-    SomeService: SampleServiceAbstract;
-    TypeInferedInjection?: SampleServiceAbstract;
-    constructor(some: SampleServiceAbstract);
-    CheckStatus(s: string, some: SampleServiceAbstract): {
-        status: string;
-    } | undefined;
-    TestAction(name: string): void;
-    TestActionTwo(name: string, age: number): void;
-    PostAction(user: {
-        Name: string;
-        Age: number;
-    }): void;
-    PutAction(user: {
-        Name: string;
-        Age: number;
-    }): void;
-    DeleteAction(id: number): number;
-}