@eggjs/koa 2.17.0 → 2.18.0

package/Readme.md

@@ -1,6 +1,6 @@
 # @eggjs/koa
 
-@eggjs/koa is forked from [Koa v2.x](https://github.com/koajs/koa/tree/v2.x) for LTS and drop Node.js < 16.13.0 support.
+@eggjs/koa is forked from [Koa v2.x](https://github.com/koajs/koa/tree/v2.x) for LTS and drop Node.js < 18.7.0 support.
 
 <img height="240px" src="/docs/logo.png" alt="Koa middleware framework for nodejs"/>
 
@@ -19,7 +19,7 @@ Koa is not bundled with any middleware.
 
 ## Installation
 
-@eggjs/koa requires __node v16.3.0__ or higher for Node.js LTS support.
+@eggjs/koa requires __node v18.7.0__ or higher for Node.js LTS support.
 
 ```bash
 npm install @eggjs/koa
@@ -28,11 +28,12 @@ npm install @eggjs/koa
 ## Hello Koa
 
 ```ts
-const Koa = require('@eggjs/koa');
-const app = new Koa();
+import { Application } from '@eggjs/koa';
+
+const app = new Application();
 
 // response
-app.use(ctx => {
+app.use((ctx) => {
   ctx.body = 'Hello Koa';
 });
 
@@ -86,7 +87,7 @@ Each middleware receives a Koa `Context` object that encapsulates an incoming
 http message and the corresponding response to that message.  `ctx` is often used
 as the parameter name for the context object.
 
-```js
+```ts
 app.use(async (ctx, next) => {
   await next();
 });
@@ -180,6 +181,6 @@ See [AUTHORS](AUTHORS).
 - [Wiki](https://github.com/koajs/koa/wiki)
 - [中文文档 v2.x](https://github.com/demopark/koa-docs-Zh-CN)
 
-# License
+## License
 
-[MIT](https://github.com/eggjs/koa/blob/master/LICENSE)
+[MIT](LICENSE)

package/{lib → dist/commonjs}/application.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="http-errors" />
 /// <reference types="node" />
 /// <reference types="node" />
 /// <reference types="node" />
@@ -7,15 +8,15 @@ import util from 'node:util';
 import http from 'node:http';
 import type { AsyncLocalStorage } from 'node:async_hooks';
 import type { IncomingMessage, ServerResponse } from 'node:http';
-import Context from './context';
-import Request from './request';
-import Response from './response';
-import type { ContextDelegation } from './context';
-import type { CustomError, ProtoImplClass, AnyProto } from './types';
+import Context from './context.js';
+import Request from './request.js';
+import Response from './response.js';
+import type { ContextDelegation } from './context.js';
+import type { CustomError, AnyProto } from './types.js';
+export type ProtoImplClass<T = object> = new (...args: any[]) => T;
 export type Next = () => Promise<void>;
 export type MiddlewareFunc = (ctx: ContextDelegation, next: Next) => Promise<void> | void;
-export type { ContextDelegation as Context } from './context';
-export type { CustomError, ProtoImplClass } from './types';
+export type { ContextDelegation as Context } from './context.js';
 /**
  * Expose `Application` class.
  * Inherits from `Emitter.prototype`.
@@ -26,7 +27,7 @@ export default class Application extends Emitter {
      * Make HttpError available to consumers of the library so that consumers don't
      * have a direct dependency upon `http-errors`
      */
-    static HttpError: any;
+    static HttpError: import("http-errors").HttpErrorConstructor<number>;
     proxy: boolean;
     subdomainOffset: number;
     proxyIpHeader: string;
@@ -71,12 +72,24 @@ export default class Application extends Emitter {
      * Return JSON representation.
      * We only bother showing settings.
      */
-    toJSON(): any;
+    toJSON(): {
+        subdomainOffset: number;
+        proxy: boolean;
+        env: string;
+    };
     /**
      * Inspect implementation.
      */
-    inspect(): any;
-    [util.inspect.custom](): any;
+    inspect(): {
+        subdomainOffset: number;
+        proxy: boolean;
+        env: string;
+    };
+    [util.inspect.custom](): {
+        subdomainOffset: number;
+        proxy: boolean;
+        env: string;
+    };
     /**
      * Use the given middleware `fn`.
      *
@@ -89,7 +102,7 @@ export default class Application extends Emitter {
      */
     callback(): (req: IncomingMessage, res: ServerResponse) => Promise<void | http.ServerResponse<http.IncomingMessage>>;
     /**
-     * return currnect contenxt from async local storage
+     * return current context from async local storage
      */
     get currentContext(): ContextDelegation | undefined;
     /**
@@ -102,7 +115,6 @@ export default class Application extends Emitter {
      * @private
      */
     protected onerror(err: CustomError): void;
-    createAsyncCtxStorageMiddleware(): (ctx: ContextDelegation, next: Next) => Promise<void>;
     /**
      * Response helper.
      */

package/dist/commonjs/application.js

@@ -0,0 +1,255 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_util_1 = require("node:util");
+const node_events_1 = __importDefault(require("node:events"));
+const node_util_2 = __importDefault(require("node:util"));
+const node_stream_1 = __importDefault(require("node:stream"));
+const node_http_1 = __importDefault(require("node:http"));
+const gals_1 = require("gals");
+const is_type_of_1 = require("is-type-of");
+const on_finished_1 = __importDefault(require("on-finished"));
+const statuses_1 = __importDefault(require("statuses"));
+const koa_compose_1 = __importDefault(require("koa-compose"));
+const http_errors_1 = require("http-errors");
+const context_js_1 = __importDefault(require("./context.js"));
+const request_js_1 = __importDefault(require("./request.js"));
+const response_js_1 = __importDefault(require("./response.js"));
+const debug = (0, node_util_1.debuglog)('koa:application');
+/**
+ * Expose `Application` class.
+ * Inherits from `Emitter.prototype`.
+ */
+class Application extends node_events_1.default {
+    /**
+     * Make HttpError available to consumers of the library so that consumers don't
+     * have a direct dependency upon `http-errors`
+     */
+    static HttpError = http_errors_1.HttpError;
+    proxy;
+    subdomainOffset;
+    proxyIpHeader;
+    maxIpsCount;
+    env;
+    keys;
+    middleware;
+    ctxStorage;
+    silent;
+    ContextClass;
+    context;
+    RequestClass;
+    request;
+    ResponseClass;
+    response;
+    /**
+     * Initialize a new `Application`.
+      *
+      * @param {object} [options] Application options
+      * @param {string} [options.env='development'] Environment
+      * @param {string[]} [options.keys] Signed cookie keys
+      * @param {boolean} [options.proxy] Trust proxy headers
+      * @param {number} [options.subdomainOffset] Subdomain offset
+      * @param {string} [options.proxyIpHeader] Proxy IP header, defaults to X-Forwarded-For
+      * @param {number} [options.maxIpsCount] Max IPs read from proxy IP header, default to 0 (means infinity)
+      */
+    constructor(options) {
+        super();
+        options = options || {};
+        this.proxy = options.proxy || false;
+        this.subdomainOffset = options.subdomainOffset || 2;
+        this.proxyIpHeader = options.proxyIpHeader || 'X-Forwarded-For';
+        this.maxIpsCount = options.maxIpsCount || 0;
+        this.env = options.env || process.env.NODE_ENV || 'development';
+        if (options.keys)
+            this.keys = options.keys;
+        this.middleware = [];
+        this.ctxStorage = (0, gals_1.getAsyncLocalStorage)();
+        this.silent = false;
+        this.ContextClass = class ApplicationContext extends context_js_1.default {
+        };
+        this.context = this.ContextClass.prototype;
+        this.RequestClass = class ApplicationRequest extends request_js_1.default {
+        };
+        this.request = this.RequestClass.prototype;
+        this.ResponseClass = class ApplicationResponse extends response_js_1.default {
+        };
+        this.response = this.ResponseClass.prototype;
+    }
+    /**
+     * Shorthand for:
+     *
+     *    http.createServer(app.callback()).listen(...)
+     */
+    listen(...args) {
+        debug('listen');
+        const server = node_http_1.default.createServer(this.callback());
+        return server.listen(...args);
+    }
+    /**
+     * Return JSON representation.
+     * We only bother showing settings.
+     */
+    toJSON() {
+        return {
+            subdomainOffset: this.subdomainOffset,
+            proxy: this.proxy,
+            env: this.env,
+        };
+    }
+    /**
+     * Inspect implementation.
+     */
+    inspect() {
+        return this.toJSON();
+    }
+    [node_util_2.default.inspect.custom]() {
+        return this.inspect();
+    }
+    /**
+     * Use the given middleware `fn`.
+     *
+     * Old-style middleware will be converted.
+     */
+    use(fn) {
+        if (typeof fn !== 'function')
+            throw new TypeError('middleware must be a function!');
+        if ((0, is_type_of_1.isGeneratorFunction)(fn)) {
+            throw new TypeError('Support for generators was removed. ' +
+                'See the documentation for examples of how to convert old middleware ' +
+                'https://github.com/koajs/koa/blob/master/docs/migration.md');
+        }
+        debug('use %s #%d', fn._name || fn.name || '-', this.middleware.length);
+        this.middleware.push(fn);
+        return this;
+    }
+    /**
+     * Return a request handler callback
+     * for node's native http server.
+     */
+    callback() {
+        const fn = (0, koa_compose_1.default)(this.middleware);
+        if (!this.listenerCount('error')) {
+            this.on('error', this.onerror.bind(this));
+        }
+        const handleRequest = (req, res) => {
+            const ctx = this.createContext(req, res);
+            return this.ctxStorage.run(ctx, async () => {
+                return await this.#handleRequest(ctx, fn);
+            });
+        };
+        return handleRequest;
+    }
+    /**
+     * return current context from async local storage
+     */
+    get currentContext() {
+        return this.ctxStorage.getStore();
+    }
+    /**
+     * Handle request in callback.
+     * @private
+     */
+    async #handleRequest(ctx, fnMiddleware) {
+        const res = ctx.res;
+        res.statusCode = 404;
+        const onerror = (err) => ctx.onerror(err);
+        (0, on_finished_1.default)(res, onerror);
+        try {
+            await fnMiddleware(ctx);
+            return this._respond(ctx);
+        }
+        catch (err) {
+            return onerror(err);
+        }
+    }
+    /**
+     * Initialize a new context.
+     * @private
+     */
+    createContext(req, res) {
+        const context = new this.ContextClass(this, req, res);
+        return context;
+    }
+    /**
+     * Default error handler.
+     * @private
+     */
+    onerror(err) {
+        // When dealing with cross-globals a normal `instanceof` check doesn't work properly.
+        // See https://github.com/koajs/koa/issues/1466
+        // We can probably remove it once jest fixes https://github.com/facebook/jest/issues/2549.
+        const isNativeError = err instanceof Error ||
+            Object.prototype.toString.call(err) === '[object Error]';
+        if (!isNativeError)
+            throw new TypeError(node_util_2.default.format('non-error thrown: %j', err));
+        if (err.status === 404 || err.expose)
+            return;
+        if (this.silent)
+            return;
+        const msg = err.stack || err.toString();
+        console.error(`\n${msg.replace(/^/gm, '  ')}\n`);
+    }
+    /**
+     * Response helper.
+     */
+    _respond(ctx) {
+        // allow bypassing koa
+        if (ctx.respond === false)
+            return;
+        if (!ctx.writable)
+            return;
+        const res = ctx.res;
+        let body = ctx.body;
+        const code = ctx.status;
+        // ignore body
+        if (statuses_1.default.empty[code]) {
+            // strip headers
+            ctx.body = null;
+            return res.end();
+        }
+        if (ctx.method === 'HEAD') {
+            if (!res.headersSent && !ctx.response.has('Content-Length')) {
+                const { length } = ctx.response;
+                if (Number.isInteger(length))
+                    ctx.length = length;
+            }
+            return res.end();
+        }
+        // status body
+        if (body == null) {
+            if (ctx.response._explicitNullBody) {
+                ctx.response.remove('Content-Type');
+                ctx.response.remove('Transfer-Encoding');
+                return res.end();
+            }
+            if (ctx.req.httpVersionMajor >= 2) {
+                body = String(code);
+            }
+            else {
+                body = ctx.message || String(code);
+            }
+            if (!res.headersSent) {
+                ctx.type = 'text';
+                ctx.length = Buffer.byteLength(body);
+            }
+            return res.end(body);
+        }
+        // responses
+        if (Buffer.isBuffer(body))
+            return res.end(body);
+        if (typeof body === 'string')
+            return res.end(body);
+        if (body instanceof node_stream_1.default)
+            return body.pipe(res);
+        // body: json
+        body = JSON.stringify(body);
+        if (!res.headersSent) {
+            ctx.length = Buffer.byteLength(body);
+        }
+        res.end(body);
+    }
+}
+exports.default = Application;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYXBwbGljYXRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQSx5Q0FBcUM7QUFDckMsOERBQWtDO0FBQ2xDLDBEQUE2QjtBQUM3Qiw4REFBaUM7QUFDakMsMERBQTZCO0FBRzdCLCtCQUE0QztBQUM1QywyQ0FBaUQ7QUFDakQsOERBQXFDO0FBQ3JDLHdEQUFnQztBQUNoQyw4REFBa0M7QUFDbEMsNkNBQXdDO0FBQ3hDLDhEQUFtQztBQUNuQyw4REFBbUM7QUFDbkMsZ0VBQXFDO0FBSXJDLE1BQU0sS0FBSyxHQUFHLElBQUEsb0JBQVEsRUFBQyxpQkFBaUIsQ0FBQyxDQUFDO0FBTzFDOzs7R0FHRztBQUNILE1BQXFCLFdBQVksU0FBUSxxQkFBTztJQUM5Qzs7O09BR0c7SUFDSCxNQUFNLENBQUMsU0FBUyxHQUFHLHVCQUFTLENBQUM7SUFFN0IsS0FBSyxDQUFVO0lBQ2YsZUFBZSxDQUFTO0lBQ3hCLGFBQWEsQ0FBUztJQUN0QixXQUFXLENBQVM7SUFDcEIsR0FBRyxDQUFTO0lBQ1osSUFBSSxDQUFZO0lBQ2hCLFVBQVUsQ0FBbUI7SUFDN0IsVUFBVSxDQUF1QztJQUNqRCxNQUFNLENBQVU7SUFDaEIsWUFBWSxDQUEwQjtJQUN0QyxPQUFPLENBQVc7SUFDbEIsWUFBWSxDQUEwQjtJQUN0QyxPQUFPLENBQVc7SUFDbEIsYUFBYSxDQUEyQjtJQUN4QyxRQUFRLENBQVc7SUFFbkI7Ozs7Ozs7Ozs7UUFVSTtJQUVKLFlBQVksT0FPWDtRQUNDLEtBQUssRUFBRSxDQUFDO1FBQ1IsT0FBTyxHQUFHLE9BQU8sSUFBSSxFQUFFLENBQUM7UUFDeEIsSUFBSSxDQUFDLEtBQUssR0FBRyxPQUFPLENBQUMsS0FBSyxJQUFJLEtBQUssQ0FBQztRQUNwQyxJQUFJLENBQUMsZUFBZSxHQUFHLE9BQU8sQ0FBQyxlQUFlLElBQUksQ0FBQyxDQUFDO1FBQ3BELElBQUks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

package/{lib → dist/commonjs}/context.d.ts

@@ -3,10 +3,10 @@
 import util from 'node:util';
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import Cookies from 'cookies';
-import type Application from './application';
-import type Request from './request';
-import type Response from './response';
-import type { CustomError, AnyProto } from './types';
+import type Application from './application.js';
+import type Request from './request.js';
+import type Response from './response.js';
+import type { CustomError, AnyProto } from './types.js';
 export default class Context {
     #private;
     app: Application;
@@ -23,9 +23,21 @@ export default class Context {
      * just returns the JSON output.
      */
     inspect(): {
-        request: any;
-        response: any;
-        app: any;
+        request: {
+            method: string;
+            url: string;
+            header: import("http").IncomingHttpHeaders;
+        };
+        response: {
+            status: number;
+            message: string;
+            header: import("http").OutgoingHttpHeaders;
+        };
+        app: {
+            subdomainOffset: number;
+            proxy: boolean;
+            env: string;
+        };
         originalUrl: string;
         req: string;
         res: string;
@@ -35,9 +47,21 @@ export default class Context {
      * Custom inspection implementation for newer Node.js versions.
      */
     [util.inspect.custom](): {
-        request: any;
-        response: any;
-        app: any;
+        request: {
+            method: string;
+            url: string;
+            header: import("http").IncomingHttpHeaders;
+        };
+        response: {
+            status: number;
+            message: string;
+            header: import("http").OutgoingHttpHeaders;
+        };
+        app: {
+            subdomainOffset: number;
+            proxy: boolean;
+            env: string;
+        };
         originalUrl: string;
         req: string;
         res: string;
@@ -52,9 +76,21 @@ export default class Context {
      * clone() to fail.
      */
     toJSON(): {
-        request: any;
-        response: any;
-        app: any;
+        request: {
+            method: string;
+            url: string;
+            header: import("http").IncomingHttpHeaders;
+        };
+        response: {
+            status: number;
+            message: string;
+            header: import("http").OutgoingHttpHeaders;
+        };
+        app: {
+            subdomainOffset: number;
+            proxy: boolean;
+            env: string;
+        };
         originalUrl: string;
         req: string;
         res: string;
@@ -66,13 +102,12 @@ export default class Context {
      *    this.assert(this.user, 401, 'Please login!');
      *
      * See: https://github.com/jshttp/http-assert
-     *
-     * @param {Mixed} test
+     * @param {Mixed} value
      * @param {Number} status
-     * @param {String} message
-     * @public
+     * @param {String} opts
      */
-    assert(...args: any[]): any;
+    assert(value: any, status?: number, opts?: Record<string, any>): void;
+    assert(value: any, status?: number, msg?: string, opts?: Record<string, any>): void;
     /**
      * Throw an error with `status` (default 500) and
      * `msg`. Note that these are user-level
@@ -83,16 +118,31 @@ export default class Context {
      *    this.throw('something exploded')
      *    this.throw(new Error('invalid'))
      *    this.throw(400, new Error('invalid'))
+     *    this.throw(400, new Error('invalid'), { foo: 'bar' })
+     *    this.throw(new Error('invalid'), { foo: 'bar' })
      *
      * See: https://github.com/jshttp/http-errors
      *
      * Note: `status` should only be passed as the first parameter.
      *
-     * @param {String|Number|Error} err, msg or status
-     * @param {String|Number|Error} [err, msg or status]
-     * @param {Object} [props]
+     * @param {String|Number|Error} status error, msg or status
+     * @param {String|Number|Error|Object} [error] error, msg, status or errorProps
+     * @param {Object} [errorProps] error object properties
      */
-    throw(...args: any[]): void;
+    throw(status: number): void;
+    throw(status: number, errorProps: object): void;
+    throw(status: number, errorMessage: string): void;
+    throw(status: number, errorMessage: string, errorProps: object): void;
+    throw(status: number, error: Error): void;
+    throw(status: number, error: Error, errorProps: object): void;
+    throw(errorMessage: string): void;
+    throw(errorMessage: string, errorProps: object): void;
+    throw(errorMessage: string, status: number): void;
+    throw(errorMessage: string, status: number, errorProps: object): void;
+    throw(error: Error): void;
+    throw(error: Error, errorProps: object): void;
+    throw(error: Error, status: number): void;
+    throw(error: Error, status: number, errorProps: object): void;
     /**
      * Default error handling.
      * @private