koa: Introduce Koa.Middleware type and add 'kcors' definition (#13447)

kcors/index.d.ts

@@ -0,0 +1,21 @@
+// Type definitions for kcors 2.2
+// Project: https://github.com/koajs/cors
+// Definitions by: Xavier Stouder <https://github.com/Xstoudi>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+import * as Koa from "koa";
+
+declare function cors(options?: cors.Options): Koa.Middleware;
+export = cors;
+
+declare namespace cors {
+    interface Options {
+        origin?: (req: Koa.Request) => string | string;
+        allowMethods?: string[] | string;
+        exposeHeaders?: string[] | string;
+        allowHeaders: string[] | string;
+        maxAge?: number | string;
+        credentials?: boolean;
+        keepHeadersOnError?: boolean;
+    }
+}

kcors/kcors-tests.ts

@@ -0,0 +1,5 @@
+import koa = require('koa');
+import cors = require('kcors');
+
+const app = new koa();
+app.use(cors());

kcors/tsconfig.json

@@ -0,0 +1,20 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "target": "es6",
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "kcors-tests.ts"
+    ]
+}

kcors/tslint.json

@@ -0,0 +1 @@
+{ "extends": "../tslint.json" }

koa-bodyparser/index.d.ts

@@ -61,7 +61,7 @@ declare function bodyParser(opts?: {
      * support custom error handle
      */
     onerror?: (err: Error, ctx: Koa.Context) => void;
-}): { (ctx: Koa.Context, next?: () => any): any };
+}): Koa.Middleware;
 
 declare namespace bodyParser { }
 export = bodyParser;

koa-compress/index.d.ts

@@ -35,7 +35,7 @@ declare module "koa-compress" {
     /**
      * Compress middleware for Koa
      */
-    function compress(options?: CompressOptions): { (ctx: Koa.Context, next?: () => any): any };
+    function compress(options?: CompressOptions): Koa.Middleware;
 
     namespace compress {}
     export = compress;

koa-favicon/index.d.ts

@@ -26,7 +26,7 @@ declare function favicon(path: string, options?: {
      */
     maxage?: number;
 
-}): { (ctx: Koa.Context, next?: () => any): any };
+}): Koa.Middleware;
 
 declare namespace favicon {}
 export = favicon;

koa-json-error/index.d.ts

@@ -25,7 +25,7 @@ interface JSONErrorOptions {
 /**
  * Error handler for pure Koa 2.0.0+ JSON apps
  */
-declare function jsonError(options?: JSONErrorOptions) : { (ctx: Koa.Context, next?: () => any): any };
+declare function jsonError(options?: JSONErrorOptions) : Koa.Middleware;
 
 declare namespace jsonError {}
 export = jsonError;

koa-json/index.d.ts

@@ -7,7 +7,7 @@
 
     import * as Koa from 'koa';
     import * as json from 'koa-json';
-    
+
     const app = new Koa();
     app.use(json());
 
@@ -17,7 +17,7 @@ import * as Koa from "koa";
 
 declare function json(opts?: {
 
-    /** 
+    /**
      * default to pretty response [true]
     */
     pretty?: boolean,
@@ -31,6 +31,6 @@ declare function json(opts?: {
      * JSON spaces [2]
      */
     spaces?: number
-}): { (ctx: Koa.Context, next?: () => any): any };
+}): Koa.Middleware;
 declare namespace json { }
 export = json;

koa-logger/index.d.ts

@@ -7,5 +7,6 @@
 
 import * as Koa from 'koa';
 
-declare var KoaLogger: () => (ctx: Koa.Context, next: () => Promise<any>) => any;
+declare function KoaLogger(): Koa.Middleware;
+declare namespace KoaLogger {}
 export = KoaLogger;

koa-mount/index.d.ts

@@ -6,15 +6,13 @@
 
 import * as Koa from "koa";
 
-interface Function { (ctx: Koa.Context, next?: () => any): any }
+declare function mount(app: Koa.Middleware): Koa.Middleware;
 
-declare function mount(app: Function): Function;
+declare function mount(app: Koa): Koa.Middleware;
 
-declare function mount(app: Koa): Function;
+declare function mount(prefix: string, app: Koa.Middleware): Koa.Middleware;
 
-declare function mount(prefix: string, app: Function): Function;
-
-declare function mount(prefix: string, app: Koa): Function;
+declare function mount(prefix: string, app: Koa): Koa.Middleware;
 
 declare namespace mount { }
 

koa-passport/index.d.ts

@@ -32,23 +32,22 @@ declare module "koa" {
 
 import * as passport from "passport";
 
-interface Middleware { (ctx: Koa.Context, next: () => Promise<any>): any; }
 interface KoaPassport {
     use(strategy: passport.Strategy): this;
     use(name: string, strategy: passport.Strategy): this;
     unuse(name: string): this;
     framework(fw: passport.Framework): this;
-    initialize(options?: { userProperty: string; }): Middleware;
-    session(options?: { pauseStream: boolean; }): Middleware;
+    initialize(options?: { userProperty: string; }): Koa.Middleware;
+    session(options?: { pauseStream: boolean; }): Koa.Middleware;
 
-    authenticate(strategy: string, callback?: Function): Middleware;
-    authenticate(strategy: string, options: Object, callback?: Function): Middleware;
-    authenticate(strategies: string[], callback?: Function): Middleware;
-    authenticate(strategies: string[], options: Object, callback?: Function): Middleware;
-    authorize(strategy: string, callback?: Function): Middleware;
-    authorize(strategy: string, options: Object, callback?: Function): Middleware;
-    authorize(strategies: string[], callback?: Function): Middleware;
-    authorize(strategies: string[], options: Object, callback?: Function): Middleware;
+    authenticate(strategy: string, callback?: Function): Koa.Middleware;
+    authenticate(strategy: string, options: Object, callback?: Function): Koa.Middleware;
+    authenticate(strategies: string[], callback?: Function): Koa.Middleware;
+    authenticate(strategies: string[], options: Object, callback?: Function): Koa.Middleware;
+    authorize(strategy: string, callback?: Function): Koa.Middleware;
+    authorize(strategy: string, options: Object, callback?: Function): Koa.Middleware;
+    authorize(strategies: string[], callback?: Function): Koa.Middleware;
+    authorize(strategies: string[], options: Object, callback?: Function): Koa.Middleware;
     serializeUser(fn: (user: any, done: (err: any, id: any) => void) => void): void;
     deserializeUser(fn: (id: any, done: (err: any, user: any) => void) => void): void;
     transformAuthInfo(fn: (info: any, done: (err: any, info: any) => void) => void): void;

koa-session-minimal/index.d.ts

@@ -38,7 +38,7 @@ declare function session(opts?: {
      * session store
      */
     store?: any;
-}): { (ctx: Koa.Context, next?: () => any): any };
+}): Koa.Middleware;
 
 declare namespace session {}
 export = session;

koa-static/index.d.ts

@@ -42,6 +42,6 @@ declare function serve(root: string, opts?: {
      * Try to serve the gzipped version of a file automatically when gzip is supported by a client and if the requested file with .gz extension exists. defaults to true.
      */
     gzip?: boolean;
-}): { (ctx: Koa.Context, next?: () => any): any };
+}): Koa.Middleware;
 declare namespace serve{}
 export = serve;

koa/index.d.ts

@@ -145,6 +145,8 @@ declare namespace Koa {
         toJSON(): any;
         inspect(): any;
     }
+
+    export type Middleware = (ctx: Koa.Context, next: () => Promise<any>) => any;
 }
 
 declare class Koa extends EventEmitter {
@@ -174,7 +176,7 @@ declare class Koa extends EventEmitter {
 
     callback(): (req: http.IncomingMessage, res: http.ServerResponse) => void;
     onerror(err: any): void;
-    use(middleware: (ctx: Koa.Context, next: () => Promise<any>) => any): Koa;
+    use(middleware: Koa.Middleware): Koa;
 
     toJSON(): any;
     inspect(): any;