@eggjs/koa 2.16.0 → 2.18.0

package/dist/commonjs/response.js

@@ -0,0 +1,453 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_path_1 = require("node:path");
+const node_util_1 = __importDefault(require("node:util"));
+const node_stream_1 = __importDefault(require("node:stream"));
+const content_disposition_1 = __importDefault(require("content-disposition"));
+const cache_content_type_1 = __importDefault(require("cache-content-type"));
+const on_finished_1 = __importDefault(require("on-finished"));
+const escape_html_1 = __importDefault(require("escape-html"));
+const type_is_1 = require("type-is");
+const statuses_1 = __importDefault(require("statuses"));
+const destroy_1 = __importDefault(require("destroy"));
+const vary_1 = __importDefault(require("vary"));
+const encodeurl_1 = __importDefault(require("encodeurl"));
+class Response {
+    app;
+    req;
+    res;
+    ctx;
+    request;
+    constructor(app, ctx, req, res) {
+        this.app = app;
+        this.req = req;
+        this.res = res;
+        this.ctx = ctx;
+    }
+    /**
+     * Return the request socket.
+     */
+    get socket() {
+        return this.res.socket;
+    }
+    /**
+     * Return response header.
+     */
+    get header() {
+        return this.res.getHeaders() || {};
+    }
+    /**
+     * Return response header, alias as response.header
+     */
+    get headers() {
+        return this.header;
+    }
+    _explicitStatus;
+    /**
+     * Get response status code.
+     */
+    get status() {
+        return this.res.statusCode;
+    }
+    /**
+     * Set response status code.
+     */
+    set status(code) {
+        if (this.headerSent)
+            return;
+        (0, node_assert_1.default)(Number.isInteger(code), 'status code must be a number');
+        (0, node_assert_1.default)(code >= 100 && code <= 999, `invalid status code: ${code}`);
+        this._explicitStatus = true;
+        this.res.statusCode = code;
+        if (this.req.httpVersionMajor < 2) {
+            this.res.statusMessage = statuses_1.default.message[code];
+        }
+        if (this.body && statuses_1.default.empty[code])
+            this.body = null;
+    }
+    /**
+     * Get response status message
+     */
+    get message() {
+        return this.res.statusMessage || statuses_1.default.message[this.status];
+    }
+    /**
+     * Set response status message
+     */
+    set message(msg) {
+        this.res.statusMessage = msg;
+    }
+    _body;
+    _explicitNullBody;
+    /**
+     * Get response body.
+     */
+    get body() {
+        return this._body;
+    }
+    /**
+     * Set response body.
+     */
+    set body(val) {
+        const original = this._body;
+        this._body = val;
+        // no content
+        if (val == null) {
+            if (!statuses_1.default.empty[this.status])
+                this.status = 204;
+            if (val === null)
+                this._explicitNullBody = true;
+            this.remove('Content-Type');
+            this.remove('Content-Length');
+            this.remove('Transfer-Encoding');
+            return;
+        }
+        // set the status
+        if (!this._explicitStatus)
+            this.status = 200;
+        // set the content-type only if not yet set
+        const setType = !this.has('Content-Type');
+        // string
+        if (typeof val === 'string') {
+            if (setType)
+                this.type = /^\s*</.test(val) ? 'html' : 'text';
+            this.length = Buffer.byteLength(val);
+            return;
+        }
+        // buffer
+        if (Buffer.isBuffer(val)) {
+            if (setType)
+                this.type = 'bin';
+            this.length = val.length;
+            return;
+        }
+        // stream
+        if (val instanceof node_stream_1.default) {
+            (0, on_finished_1.default)(this.res, destroy_1.default.bind(null, val));
+            // eslint-disable-next-line eqeqeq
+            if (original != val) {
+                val.once('error', err => this.ctx.onerror(err));
+                // overwriting
+                if (original != null)
+                    this.remove('Content-Length');
+            }
+            if (setType)
+                this.type = 'bin';
+            return;
+        }
+        // json
+        this.remove('Content-Length');
+        this.type = 'json';
+    }
+    /**
+     * Set Content-Length field to `n`.
+     */
+    set length(n) {
+        if (n === undefined)
+            return;
+        if (!this.has('Transfer-Encoding')) {
+            this.set('Content-Length', n);
+        }
+    }
+    /**
+     * Return parsed response Content-Length when present.
+     */
+    get length() {
+        if (this.has('Content-Length')) {
+            return parseInt(this.get('Content-Length'), 10) || 0;
+        }
+        const { body } = this;
+        if (!body || body instanceof node_stream_1.default)
+            return undefined;
+        if (typeof body === 'string')
+            return Buffer.byteLength(body);
+        if (Buffer.isBuffer(body))
+            return body.length;
+        return Buffer.byteLength(JSON.stringify(body));
+    }
+    /**
+     * Check if a header has been written to the socket.
+     */
+    get headerSent() {
+        return this.res.headersSent;
+    }
+    /**
+     * Vary on `field`.
+     */
+    vary(field) {
+        if (this.headerSent)
+            return;
+        (0, vary_1.default)(this.res, field);
+    }
+    /**
+     * Perform a 302 redirect to `url`.
+     *
+     * The string "back" is special-cased
+     * to provide Referrer support, when Referrer
+     * is not present `alt` or "/" is used.
+     *
+     * Examples:
+     *
+     *    this.redirect('back');
+     *    this.redirect('back', '/index.html');
+     *    this.redirect('/login');
+     *    this.redirect('http://google.com'); // will format to 'http://google.com/'
+     */
+    redirect(url, alt) {
+        // location
+        if (url === 'back')
+            url = this.ctx.get('Referrer') || alt || '/';
+        if (url.startsWith('https://') || url.startsWith('http://')) {
+            // formatting url again avoid security escapes
+            url = new URL(url).toString();
+        }
+        this.set('Location', (0, encodeurl_1.default)(url));
+        // status
+        if (!statuses_1.default.redirect[this.status])
+            this.status = 302;
+        // html
+        if (this.ctx.accepts('html')) {
+            url = (0, escape_html_1.default)(url);
+            this.type = 'text/html; charset=utf-8';
+            this.body = `Redirecting to <a href="${url}">${url}</a>.`;
+            return;
+        }
+        // text
+        this.type = 'text/plain; charset=utf-8';
+        this.body = `Redirecting to ${url}.`;
+    }
+    /**
+     * Set Content-Disposition header to "attachment" with optional `filename`.
+     */
+    attachment(filename, options) {
+        if (filename)
+            this.type = (0, node_path_1.extname)(filename);
+        this.set('Content-Disposition', (0, content_disposition_1.default)(filename, options));
+    }
+    /**
+     * Set Content-Type response header with `type` through `mime.lookup()`
+     * when it does not contain a charset.
+     *
+     * Examples:
+     *
+     *     this.type = '.html';
+     *     this.type = 'html';
+     *     this.type = 'json';
+     *     this.type = 'application/json';
+     *     this.type = 'png';
+     */
+    set type(type) {
+        if (!type) {
+            this.remove('Content-Type');
+            return;
+        }
+        const mimeType = (0, cache_content_type_1.default)(type);
+        if (mimeType) {
+            this.set('Content-Type', mimeType);
+        }
+    }
+    /**
+     * Return the response mime type void of
+     * parameters such as "charset".
+     */
+    get type() {
+        const type = this.get('Content-Type');
+        if (!type)
+            return '';
+        return type.split(';', 1)[0];
+    }
+    /**
+     * Check whether the response is one of the listed types.
+     * Pretty much the same as `this.request.is()`.
+     *
+     *     this.response.is('html')
+     *     this.response.is('html', 'json')
+     */
+    is(type, ...types) {
+        const testTypes = Array.isArray(type) ? type :
+            (type ? [type] : []);
+        return (0, type_is_1.is)(this.type, [...testTypes, ...types]);
+    }
+    /**
+     * Set the Last-Modified date using a string or a Date.
+     *
+     *     this.response.lastModified = new Date();
+     *     this.response.lastModified = '2013-09-13';
+     */
+    set lastModified(val) {
+        if (typeof val === 'string')
+            val = new Date(val);
+        if (val) {
+            this.set('Last-Modified', val.toUTCString());
+        }
+    }
+    /**
+     * Get the Last-Modified date in Date form, if it exists.
+     */
+    get lastModified() {
+        const date = this.get('last-modified');
+        if (date)
+            return new Date(date);
+    }
+    /**
+     * Set the ETag of a response.
+     * This will normalize the quotes if necessary.
+     *
+     *     this.response.etag = 'md5-hash-sum';
+     *     this.response.etag = '"md5-hash-sum"';
+     *     this.response.etag = 'W/"123456789"';
+     */
+    set etag(val) {
+        if (!/^(W\/)?"/.test(val))
+            val = `"${val}"`;
+        this.set('ETag', val);
+    }
+    /**
+     * Get the ETag of a response.
+     */
+    get etag() {
+        return this.get('ETag');
+    }
+    /**
+     * Return response header.
+     *
+     * Examples:
+     *
+     *     this.get('Content-Type');
+     *     // => "text/plain"
+     *
+     *     this.get('content-type');
+     *     // => "text/plain"
+     */
+    get(field) {
+        return (this.header[field.toLowerCase()] || '');
+    }
+    /**
+     * Returns true if the header identified by name is currently set in the outgoing headers.
+     * The header name matching is case-insensitive.
+     *
+     * Examples:
+     *
+     *     this.has('Content-Type');
+     *     // => true
+     *
+     *     this.get('content-type');
+     *     // => true
+     */
+    has(field) {
+        return this.res.hasHeader(field);
+    }
+    /**
+     * Set header `field` to `val` or pass
+     * an object of header fields.
+     *
+     * Examples:
+     *
+     *    this.set('Foo', ['bar', 'baz']);
+     *    this.set('Accept', 'application/json');
+     *    this.set({ Accept: 'text/plain', 'X-API-Key': 'tobi' });
+     */
+    set(field, val) {
+        if (this.headerSent)
+            return;
+        if (typeof field === 'string') {
+            if (Array.isArray(val)) {
+                val = val.map(v => {
+                    return typeof v === 'string' ? v : String(v);
+                });
+            }
+            else if (typeof val !== 'string') {
+                val = String(val);
+            }
+            this.res.setHeader(field, val);
+        }
+        else {
+            for (const key in field) {
+                this.set(key, field[key]);
+            }
+        }
+    }
+    /**
+     * Append additional header `field` with value `val`.
+     *
+     * Examples:
+     *
+     * ```
+     * this.append('Link', ['<http://localhost/>', '<http://localhost:3000/>']);
+     * this.append('Set-Cookie', 'foo=bar; Path=/; HttpOnly');
+     * this.append('Warning', '199 Miscellaneous warning');
+     */
+    append(field, val) {
+        const prev = this.get(field);
+        let value = val;
+        if (prev) {
+            value = Array.isArray(prev)
+                ? prev.concat(value)
+                : [prev].concat(val);
+        }
+        return this.set(field, value);
+    }
+    /**
+     * Remove header `field`.
+     */
+    remove(field) {
+        if (this.headerSent)
+            return;
+        this.res.removeHeader(field);
+    }
+    /**
+     * Checks if the request is writable.
+     * Tests for the existence of the socket
+     * as node sometimes does not set it.
+     */
+    get writable() {
+        // can't write any more after response finished
+        // response.writableEnded is available since Node > 12.9
+        // https://nodejs.org/api/http.html#http_response_writableended
+        // response.finished is undocumented feature of previous Node versions
+        // https://stackoverflow.com/questions/16254385/undocumented-response-finished-in-node-js
+        if (this.res.writableEnded || this.res.finished)
+            return false;
+        const socket = this.res.socket;
+        // There are already pending outgoing res, but still writable
+        // https://github.com/nodejs/node/blob/v4.4.7/lib/_http_server.js#L486
+        if (!socket)
+            return true;
+        return socket.writable;
+    }
+    /**
+     * Inspect implementation.
+     */
+    inspect() {
+        if (!this.res)
+            return;
+        const o = this.toJSON();
+        Reflect.set(o, 'body', this.body);
+        return o;
+    }
+    [node_util_1.default.inspect.custom]() {
+        return this.inspect();
+    }
+    /**
+     * Return JSON representation.
+     */
+    toJSON() {
+        return {
+            status: this.status,
+            message: this.message,
+            header: this.header,
+        };
+    }
+    /**
+     * Flush any set headers and begin the body
+     */
+    flushHeaders() {
+        this.res.flushHeaders();
+    }
+}
+exports.default = Response;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzcG9uc2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcmVzcG9uc2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQSw4REFBaUM7QUFDakMseUNBQW9DO0FBQ3BDLDBEQUE2QjtBQUM3Qiw4REFBaUM7QUFFakMsOEVBQXFEO0FBQ3JELDRFQUF5QztBQUN6Qyw4REFBbUM7QUFDbkMsOERBQWlDO0FBQ2pDLHFDQUF1QztBQUN2Qyx3REFBZ0M7QUFDaEMsc0RBQThCO0FBQzlCLGdEQUF3QjtBQUN4QiwwREFBa0M7QUFLbEMsTUFBcUIsUUFBUTtJQUMzQixHQUFHLENBQWM7SUFDakIsR0FBRyxDQUFrQjtJQUNyQixHQUFHLENBQWlCO0lBQ3BCLEdBQUcsQ0FBb0I7SUFDdkIsT0FBTyxDQUFVO0lBRWpCLFlBQVksR0FBZ0IsRUFBRSxHQUFzQixFQUFFLEdBQW9CLEVBQUUsR0FBbUI7UUFDN0YsSUFBSSxDQUFDLEdBQUcsR0FBRyxHQUFHLENBQUM7UUFDZixJQUFJLENBQUMsR0FBRyxHQUFHLEdBQUcsQ0FBQztRQUNmLElBQUksQ0FBQyxHQUFHLEdBQUcsR0FBRyxDQUFDO1FBQ2YsSUFBSSxDQUFDLEdBQUcsR0FBRyxHQUFHLENBQUM7SUFDakIsQ0FBQztJQUVEOztPQUVHO0lBQ0gsSUFBSSxNQUFNO1FBQ1IsT0FBTyxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQztJQUN6QixDQUFDO0lBRUQ7O09BRUc7SUFDSCxJQUFJLE1BQU07UUFDUixPQUFPLElBQUksQ0FBQyxHQUFHLENBQUMsVUFBVSxFQUFFLElBQUksRUFBRSxDQUFDO0lBQ3JDLENBQUM7SUFFRDs7T0FFRztJQUNILElBQUksT0FBTztRQUNULE9BQU8sSUFBSSxDQUFDLE1BQU0sQ0FBQztJQUNyQixDQUFDO0lBRUQsZUFBZSxDQUFVO0lBRXpCOztPQUVHO0lBQ0gsSUFBSSxNQUFNO1FBQ1IsT0FBTyxJQUFJLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FB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

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

@@ -1,11 +1,10 @@
 export type CustomError = Error & {
-    headers?: object;
+    headers?: Record<string, string>;
     status?: number;
     statusCode?: number;
     code?: string;
     expose?: boolean;
 };
-export type ProtoImplClass<T = object> = new (...args: any[]) => T;
 export type AnyProto = {
     [key: string]: any;
 };

package/{lib → dist/commonjs}/types.js

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist/esm/application.d.ts

@@ -0,0 +1,122 @@
+/// <reference types="http-errors" />
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import Emitter from 'node:events';
+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.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.js';
+/**
+ * Expose `Application` class.
+ * Inherits from `Emitter.prototype`.
+ */
+export default class Application extends Emitter {
+    #private;
+    /**
+     * Make HttpError available to consumers of the library so that consumers don't
+     * have a direct dependency upon `http-errors`
+     */
+    static HttpError: import("http-errors").HttpErrorConstructor<number>;
+    proxy: boolean;
+    subdomainOffset: number;
+    proxyIpHeader: string;
+    maxIpsCount: number;
+    env: string;
+    keys?: string[];
+    middleware: MiddlewareFunc[];
+    ctxStorage: AsyncLocalStorage<ContextDelegation>;
+    silent: boolean;
+    ContextClass: ProtoImplClass<Context>;
+    context: AnyProto;
+    RequestClass: ProtoImplClass<Request>;
+    request: AnyProto;
+    ResponseClass: ProtoImplClass<Response>;
+    response: AnyProto;
+    /**
+     * 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?: {
+        proxy?: boolean;
+        subdomainOffset?: number;
+        proxyIpHeader?: string;
+        maxIpsCount?: number;
+        env?: string;
+        keys?: string[];
+    });
+    /**
+     * Shorthand for:
+     *
+     *    http.createServer(app.callback()).listen(...)
+     */
+    listen(...args: any[]): http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
+    /**
+     * Return JSON representation.
+     * We only bother showing settings.
+     */
+    toJSON(): {
+        subdomainOffset: number;
+        proxy: boolean;
+        env: string;
+    };
+    /**
+     * Inspect implementation.
+     */
+    inspect(): {
+        subdomainOffset: number;
+        proxy: boolean;
+        env: string;
+    };
+    [util.inspect.custom](): {
+        subdomainOffset: number;
+        proxy: boolean;
+        env: string;
+    };
+    /**
+     * Use the given middleware `fn`.
+     *
+     * Old-style middleware will be converted.
+     */
+    use(fn: MiddlewareFunc): this;
+    /**
+     * Return a request handler callback
+     * for node's native http server.
+     */
+    callback(): (req: IncomingMessage, res: ServerResponse) => Promise<void | http.ServerResponse<http.IncomingMessage>>;
+    /**
+     * return current context from async local storage
+     */
+    get currentContext(): ContextDelegation | undefined;
+    /**
+     * Initialize a new context.
+     * @private
+     */
+    protected createContext(req: IncomingMessage, res: ServerResponse): ContextDelegation;
+    /**
+     * Default error handler.
+     * @private
+     */
+    protected onerror(err: CustomError): void;
+    /**
+     * Response helper.
+     */
+    protected _respond(ctx: ContextDelegation): http.ServerResponse<http.IncomingMessage> | undefined;
+}