web_api_base 6.0.3 → 6.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web_api_base",
-  "version": "6.0.3",
+  "version": "6.1.1",
   "description": "web api base",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,11 +29,10 @@
   "devDependencies": {
     "@types/express": "^4.17.15",
     "@types/formidable": "^3.4.5",
-    "@types/jest": "^29.2.4",
+    "@types/jest": "^29.5.13",
     "@types/node": "^18.11.17",
     "@types/reflect-metadata": "^0.1.0",
-    "jest": "^29.3.1",
-    "ts-jest": "^29.0.3",
-    "ts-node": "^10.9.1"
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5"
   }
 }

package/readme.md

@@ -96,10 +96,10 @@ export class SampleService extends SampleServiceAbstract
     }
 }
 
-export class AnotherService extends SampleServiceAbstract
+export class GenericService<T>
 {
-    public DoSomething(): void {
-        console.log("Doing another job in AnotherService");
+    public SomeGenericResult<T>(obj : T) {
+        console.log("typeof obj: " + typeof obj);
     }
 }
 ```
@@ -111,7 +111,7 @@ We can use the DI service like this
 ```typescript
 
 import { ControllerBase, Route, GET, Inject } from "web_api_base";
-import {SampleServiceAbstract } from '../services/SampleService.ts';
+import {SampleServiceAbstract, GenericService } from '../services/SampleService.ts';
 
 @Route()
 export default class SampleController extends ControllerBase
@@ -119,10 +119,18 @@ export default class SampleController extends ControllerBase
     @Inject() // say to DI that this property will be inject on the instance
     public SomeDepency : SampleServiceAbstract;
 
-    constructor(someDependecy : SampleServiceAbstract)
+    @Inject() // say to DI that this property will be inject on the instance
+    //the type argument do not exists on runtime, on .js result files. The DI system will work fine and we 
+    //will still have the type check on development time 
+    public SomeGenericDepency : GenericService<string> ;
+
+    constructor(someDependecy : SampleServiceAbstract, someGenericDepency: GenericService<string>)
     {
         super();
-        this.SomeDepency = someDependecy ;        
+        this.SomeDepency = someDependecy ;  
+        this.SomeGenericDepency = someGenericDepency;
+        this.SomeGenericDepency.SomeGenericresult("Test") // typeof obj: string
+        //this.SomeGenericDepency.SomeGenericresult(10) // compiler error
     }
      
     @GET()
@@ -142,7 +150,7 @@ And we can register our dependecies in Application ConfigureAsync method
 
 import { Application, IApplicationConfiguration} from "web_api_base";
 
-import { SampleService, SampleServiceAbstract } from './service/SampleService';
+import { SampleService, SampleServiceAbstract, GenericService  } from './service/SampleService';
 
 
 export default class App extends Application
@@ -157,8 +165,21 @@ export default class App extends Application
         this.UseCors();
 
         //DI AddScoped, AddTransient and AddSingleton
-        App.AddScoped(SampleServiceAbstract, SampleService);     
-
+        appConfig.AddScoped(SampleServiceAbstract, SampleService);    
+        appConfig.AddScoped(GenericService) // will register for all generic type arguments
+       
+       //will register only for GenericService<User>. We need use  @InjectTypeArgument(User) on dependecy
+       //to work fine
+       //appConfig.AddGenericScoped(GenericService, User) 
+
+       //will register only for GenericService<User>. We need use  @InjectTypeArgument(User) on dependecy
+       //to work fine
+       //appConfig.AddGenericScoped(GenericService, undefined, undefined, typeArgument =>
+       //{ 
+       //   here we can determine how to create the instance. We have access of type argument on typeArgument 
+       //   argument. After this function execution, the instance will pass for DI pipeline to get all 
+       //   dependecies
+       //}) 
         this.UseControllers();
 
     }  
@@ -222,13 +243,16 @@ Send a status code and a optional body
 Append a delegate to execute **before** the controller´s action
 ```typescript
 @Route("/status")
-@UseBefore(context => 
+@UseBefore(async context => 
 {
 
     if(context.Request.headers["token"] != "we have access to request object")
+    {
          context.Response.json({Message : "we have access to response object"});
+         return;
+    }
     else
-         context.Next(); // call next function in the pipeline
+         return await context.Next(); // call next function in the pipeline
 })
 export default class StatusController extends ControllerBase
 {
@@ -238,7 +262,7 @@ export default class StatusController extends ControllerBase
 Append a delegate to execute **after** the controller´s action
 ```typescript
 @Route("/status")
-@UseAfter(actionResult => 
+@UseAfter(async actionResult => 
 {
 
       if(actionResult.Exception) // if a exception was launched

package/dist/Application.d.ts

@@ -1,28 +0,0 @@
-import { Express } from "express";
-import IApplication, { ApplicationExceptionHandler } from "./interfaces/IApplication";
-import IApplicationConfiguration from "./interfaces/IApplicationConfiguration";
-import { ControllerBase } from "./controllers/base/ControllerBase";
-import AbstractMultiPartRequestService from "./file/AbstractMultiPartRequestService";
-export default abstract class Application implements IApplication {
-    static Configurations: IApplicationConfiguration;
-    private _createdControllers;
-    private _URIs;
-    ApplicationConfiguration: IApplicationConfiguration;
-    Express: Express;
-    ApplicationThreadExeptionHandler?: ApplicationExceptionHandler;
-    constructor();
-    StartAsync(): Promise<void>;
-    protected UseCors(): void;
-    private GetIgnoredPaths;
-    private TryFindControllerFolder;
-    protected UseControllersAsync(root?: string): Promise<void>;
-    protected UseCustomMultiPartRequestHandler<T extends AbstractMultiPartRequestService>(cTor: new (...args: any[]) => T): void;
-    protected AppendController<T extends ControllerBase>(ctor: {
-        new (...args: any[]): T;
-    }): void;
-    CreateDocumentation(): void;
-    private SendResponseIfNecessary;
-    private CastToExpection;
-    private CallErrorHandler;
-    abstract ConfigureAsync(appConfig: IApplicationConfiguration): Promise<void>;
-}