@eggjs/koa 3.1.0-beta.20 → 3.1.0-beta.21

package/dist/application.d.ts

@@ -0,0 +1,127 @@
+import util from 'node:util';
+import Emitter from 'node:events';
+import type { AsyncLocalStorage } from 'node:async_hooks';
+import http, { type IncomingMessage, type ServerResponse } from 'node:http';
+import { Context } from './context.ts';
+import { Request } from './request.ts';
+import { Response } from './response.ts';
+import type { CustomError, AnyProto } from './types.ts';
+export type ProtoImplClass<T = object> = new (...args: any[]) => T;
+export type Next = () => Promise<void>;
+type _MiddlewareFunc<T> = (ctx: T, next: Next) => Promise<void> | void;
+export type MiddlewareFunc<T extends Context = Context> = _MiddlewareFunc<T> & {
+    _name?: string;
+};
+/**
+ * Expose `Application` class.
+ * Inherits from `Emitter.prototype`.
+ */
+export declare class Application extends Emitter {
+    [key: symbol]: unknown;
+    /**
+     * 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>;
+    protected _proxy: boolean;
+    protected _env: string;
+    subdomainOffset: number;
+    proxyIpHeader: string;
+    maxIpsCount: number;
+    protected _keys?: string[];
+    middleware: MiddlewareFunc<Context>[];
+    ctxStorage: AsyncLocalStorage<Context>;
+    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] Environment, default is `development`
+     * @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[];
+    });
+    get keys(): string[] | undefined;
+    set keys(value: string[] | undefined);
+    get env(): string;
+    set env(value: string);
+    get proxy(): boolean;
+    set proxy(value: boolean);
+    /**
+     * 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`.
+     */
+    use<T extends Context = Context>(fn: MiddlewareFunc<T>): 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(): Context | undefined;
+    /**
+     * Handle request in callback.
+     * @private
+     */
+    protected handleRequest(ctx: Context, fnMiddleware: (ctx: Context) => Promise<void>): Promise<void | http.ServerResponse<http.IncomingMessage>>;
+    /**
+     * Initialize a new context.
+     * @private
+     */
+    createContext(req: IncomingMessage, res: ServerResponse): Context;
+    /**
+     * Default error handler.
+     * @private
+     */
+    protected onerror(err: CustomError): void;
+    /**
+     * Response helper.
+     */
+    protected _respond(ctx: Context): http.ServerResponse<http.IncomingMessage> | undefined;
+}
+export {};

package/dist/application.js

@@ -0,0 +1,274 @@
+import util, { debuglog } from 'node:util';
+import Emitter from 'node:events';
+import Stream from 'node:stream';
+import http, {} from 'node:http';
+import { getAsyncLocalStorage } from 'gals';
+import { isGeneratorFunction } from 'is-type-of';
+import onFinished from 'on-finished';
+import statuses from 'statuses';
+import compose from 'koa-compose';
+import { HttpError } from 'http-errors';
+import { Context } from "./context.js";
+import { Request } from "./request.js";
+import { Response } from "./response.js";
+const debug = debuglog('egg/koa/application');
+/**
+ * Expose `Application` class.
+ * Inherits from `Emitter.prototype`.
+ */
+export 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 = HttpError;
+    _proxy;
+    _env;
+    subdomainOffset;
+    proxyIpHeader;
+    maxIpsCount;
+    _keys;
+    middleware;
+    ctxStorage;
+    silent;
+    ContextClass;
+    context;
+    RequestClass;
+    request;
+    ResponseClass;
+    response;
+    /**
+     * Initialize a new `Application`.
+     *
+     * @param {object} [options] Application options
+     * @param {string} [options.env] Environment, default is `development`
+     * @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 = getAsyncLocalStorage();
+        this.silent = false;
+        this.ContextClass = class ApplicationContext extends Context {
+        };
+        this.context = this.ContextClass.prototype;
+        this.RequestClass = class ApplicationRequest extends Request {
+        };
+        this.request = this.RequestClass.prototype;
+        this.ResponseClass = class ApplicationResponse extends Response {
+        };
+        this.response = this.ResponseClass.prototype;
+    }
+    get keys() {
+        return this._keys;
+    }
+    set keys(value) {
+        this._keys = value;
+    }
+    get env() {
+        return this._env;
+    }
+    set env(value) {
+        this._env = value;
+    }
+    get proxy() {
+        return this._proxy;
+    }
+    set proxy(value) {
+        this._proxy = value;
+    }
+    /**
+     * Shorthand for:
+     *
+     *    http.createServer(app.callback()).listen(...)
+     */
+    // oxlint-disable-next-line typescript/no-explicit-any
+    listen(...args) {
+        debug('listen with args: %o', args);
+        const server = http.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();
+    }
+    [util.inspect.custom]() {
+        return this.inspect();
+    }
+    /**
+     * Use the given middleware `fn`.
+     */
+    use(fn) {
+        if (typeof fn !== 'function')
+            throw new TypeError('middleware must be a function!');
+        const name = fn._name || fn.name || '-';
+        if (isGeneratorFunction(fn)) {
+            throw new TypeError(`Support for generators was removed, middleware: ${name}. ` +
+                'See the documentation for examples of how to convert old middleware ' +
+                'https://github.com/koajs/koa/blob/master/docs/migration.md');
+        }
+        debug('use %o #%d', name, this.middleware.length);
+        this.middleware.push(fn);
+        return this;
+    }
+    /**
+     * Return a request handler callback
+     * for node's native http server.
+     */
+    callback() {
+        const fn = compose(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) {
+        this.emit('request', ctx);
+        const res = ctx.res;
+        res.statusCode = 404;
+        const onerror = (err) => ctx.onerror(err);
+        // oxlint-disable-next-line promise/prefer-await-to-callbacks
+        onFinished(res, (err) => {
+            if (err) {
+                onerror(err);
+            }
+            this.emit('response', ctx);
+        });
+        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(util.format('non-error thrown: %j', err));
+        if (err.status === 404 || err.expose)
+            return;
+        if (this.silent)
+            return;
+        const msg = err.stack || err.toString();
+        // oxlint-disable-next-line no-console
+        console.error(`\n${msg.replaceAll(/^/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.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 || body === undefined) {
+            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 Stream)
+            return body.pipe(res);
+        // body: json
+        body = JSON.stringify(body);
+        if (!res.headersSent) {
+            ctx.length = Buffer.byteLength(body);
+        }
+        res.end(body);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvYXBwbGljYXRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxJQUFJLEVBQUUsRUFBRSxRQUFRLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFDM0MsT0FBTyxPQUFPLE1BQU0sYUFBYSxDQUFDO0FBQ2xDLE9BQU8sTUFBTSxNQUFNLGFBQWEsQ0FBQztBQUVqQyxPQUFPLElBQUksRUFBRSxFQUE2QyxNQUFNLFdBQVcsQ0FBQztBQUU1RSxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFDNUMsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQ2pELE9BQU8sVUFBVSxNQUFNLGFBQWEsQ0FBQztBQUNyQyxPQUFPLFFBQVEsTUFBTSxVQUFVLENBQUM7QUFDaEMsT0FBTyxPQUFPLE1BQU0sYUFBYSxDQUFDO0FBRWxDLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDeEMsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUN2QyxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBQ3ZDLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFHekMsTUFBTSxLQUFLLEdBQUcsUUFBUSxDQUFDLHFCQUFxQixDQUFDLENBQUM7QUFVOUM7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLFdBQVksU0FBUSxPQUFPO0lBRXRDOzs7T0FHRztJQUNILE1BQU0sQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFDO0lBRW5CLE1BQU0sQ0FBVTtJQUNoQixJQUFJLENBQVM7SUFDdkIsZUFBZSxDQUFTO0lBQ3hCLGFBQWEsQ0FBUztJQUN0QixXQUFXLENBQVM7SUFDVixLQUFLLENBQVk7SUFDM0IsVUFBVSxDQUE0QjtJQUN0QyxVQUFVLENBQTZCO0lBQ3ZDLE1BQU0sQ0FBVTtJQUNoQixZ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

package/dist/context.d.ts

@@ -0,0 +1,225 @@
+import util from 'node:util';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ParsedUrlQuery } from 'node:querystring';
+import Cookies from 'cookies';
+import type { Accepts } from 'accepts';
+import type { Application } from './application.ts';
+import type { Request } from './request.ts';
+import type { Response } from './response.ts';
+import type { CustomError, AnyProto } from './types.ts';
+export declare class Context {
+    #private;
+    [key: symbol | string]: unknown;
+    app: Application;
+    req: IncomingMessage;
+    res: ServerResponse;
+    request: Request & AnyProto;
+    response: Response & AnyProto;
+    originalUrl: string;
+    respond?: boolean;
+    constructor(app: Application, req: IncomingMessage, res: ServerResponse);
+    /**
+     * util.inspect() implementation, which
+     * just returns the JSON output.
+     */
+    inspect(): {
+        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;
+        socket: string;
+    };
+    /**
+     * Custom inspection implementation for newer Node.js versions.
+     */
+    [util.inspect.custom](): {
+        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;
+        socket: string;
+    };
+    /**
+     * Return JSON representation.
+     *
+     * Here we explicitly invoke .toJSON() on each
+     * object, as iteration will otherwise fail due
+     * to the getters and cause utilities such as
+     * clone() to fail.
+     */
+    toJSON(): {
+        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;
+        socket: string;
+    };
+    /**
+     * Similar to .throw(), adds assertion.
+     *
+     * ```ts
+     * this.assert(this.user, 401, 'Please login!');
+     * ```
+     */
+    assert(value: unknown, status?: number, errorProps?: Record<string, unknown>): void;
+    assert(value: unknown, status?: number, errorMessage?: string, errorProps?: Record<string, unknown>): void;
+    /**
+     * Throw an error with `status` (default 500) and
+     * `msg`. Note that these are user-level
+     * errors, and the message may be exposed to the client.
+     *
+     *    this.throw(403)
+     *    this.throw(400, 'name required')
+     *    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} status error, msg or status
+     * @param {String|Number|Error|Object} [error] error, msg, status or errorProps
+     * @param {Object} [errorProps] error object properties
+     */
+    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
+     */
+    onerror(err: CustomError): void;
+    protected _cookies: Cookies | undefined;
+    get cookies(): Cookies;
+    set cookies(cookies: Cookies);
+    get state(): Record<string, any>;
+    /**
+     * Request delegation.
+     */
+    acceptsLanguages(): string[];
+    acceptsLanguages(languages: string[]): string | false;
+    acceptsLanguages(...languages: string[]): string | false;
+    acceptsEncodings(): string[];
+    acceptsEncodings(encodings: string[]): string | false;
+    acceptsEncodings(...encodings: string[]): string | false;
+    acceptsCharsets(): string[];
+    acceptsCharsets(charsets: string[]): string | false;
+    acceptsCharsets(...charsets: string[]): string | false;
+    accepts(args: string[]): string | string[] | false;
+    accepts(...args: string[]): string | string[] | false;
+    get<T = string | string[]>(field: string): T;
+    is(type?: string | string[], ...types: string[]): string | false | null;
+    get querystring(): string;
+    set querystring(str: string);
+    get idempotent(): boolean;
+    get socket(): import("./request.ts").RequestSocket;
+    get search(): string;
+    set search(str: string);
+    get method(): string;
+    set method(method: string);
+    get query(): ParsedUrlQuery;
+    set query(obj: ParsedUrlQuery);
+    get path(): string;
+    set path(path: string);
+    get url(): string;
+    set url(url: string);
+    get accept(): Accepts;
+    set accept(accept: Accepts);
+    get origin(): string;
+    get href(): string;
+    get subdomains(): string[];
+    get protocol(): string;
+    get host(): string;
+    get hostname(): string;
+    get URL(): URL;
+    get header(): import("http").IncomingHttpHeaders;
+    get headers(): import("http").IncomingHttpHeaders;
+    get secure(): boolean;
+    get stale(): boolean;
+    get fresh(): boolean;
+    get ips(): string[];
+    get ip(): string;
+    /**
+     * Response delegation.
+     */
+    attachment(...args: Parameters<Response['attachment']>): void;
+    redirect(...args: Parameters<Response['redirect']>): void;
+    remove(...args: Parameters<Response['remove']>): void;
+    vary(...args: Parameters<Response['vary']>): void;
+    has(...args: Parameters<Response['has']>): boolean;
+    set(...args: Parameters<Response['set']>): void;
+    append(...args: Parameters<Response['append']>): void;
+    flushHeaders(...args: Parameters<Response['flushHeaders']>): void;
+    get status(): number;
+    set status(status: number);
+    get message(): string;
+    set message(msg: string);
+    get body(): any;
+    set body(val: any);
+    get length(): number | undefined;
+    set length(n: number | string | undefined);
+    get type(): string;
+    set type(type: string | null | undefined);
+    get lastModified(): string | Date | undefined;
+    set lastModified(val: string | Date | undefined);
+    get etag(): string;
+    set etag(val: string);
+    get headerSent(): boolean;
+    get writable(): boolean;
+}