egg 3.29.0 → 4.0.0-beta.2

package/dist/commonjs/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @namespace Egg
+ */
+import { BaseContextClass } from './lib/core/base_context_class.js';
+import { startEgg } from './lib/start.js';
+export * from './lib/egg.js';
+export * from './lib/type.js';
+export * from './lib/start.js';
+/**
+ * Start egg application with cluster mode
+ * @since 1.0.0
+ */
+export { startCluster } from 'egg-cluster';
+/**
+ * Start egg application with single process mode
+ * @since 1.0.0
+ */
+export declare const start: typeof startEgg;
+/**
+ * @member {Application} Egg#Application
+ * @since 1.0.0
+ */
+export { Application } from './lib/application.js';
+/**
+ * @member {Agent} Egg#Agent
+ * @since 1.0.0
+ */
+export { Agent } from './lib/agent.js';
+/**
+ * @member {AppWorkerLoader} Egg#AppWorkerLoader
+ * @since 1.0.0
+ */
+/**
+ * @member {AgentWorkerLoader} Egg#AgentWorkerLoader
+ * @since 1.0.0
+ */
+export { AppWorkerLoader, AgentWorkerLoader } from './lib/loader/index.js';
+/**
+ * @member {Controller} Egg#Controller
+ * @since 1.1.0
+ */
+export declare const Controller: typeof BaseContextClass;
+/**
+ * @member {Service} Egg#Service
+ * @since 1.1.0
+ */
+export declare const Service: typeof BaseContextClass;
+/**
+ * @member {Subscription} Egg#Subscription
+ * @since 1.10.0
+ */
+export declare const Subscription: typeof BaseContextClass;
+/**
+ * @member {BaseContextClass} Egg#BaseContextClass
+ * @since 1.2.0
+ */
+export { BaseContextClass } from './lib/core/base_context_class.js';
+/**
+ * @member {Boot} Egg#Boot
+ */
+export { BaseHookClass as Boot } from './lib/core/base_hook_class.js';

package/dist/commonjs/index.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * @namespace Egg
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Boot = exports.BaseContextClass = exports.Subscription = exports.Service = exports.Controller = exports.AgentWorkerLoader = exports.AppWorkerLoader = exports.Agent = exports.Application = exports.start = exports.startCluster = void 0;
+const base_context_class_js_1 = require("./lib/core/base_context_class.js");
+const start_js_1 = require("./lib/start.js");
+// export types
+__exportStar(require("./lib/egg.js"), exports);
+__exportStar(require("./lib/type.js"), exports);
+__exportStar(require("./lib/start.js"), exports);
+/**
+ * Start egg application with cluster mode
+ * @since 1.0.0
+ */
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore
+var egg_cluster_1 = require("egg-cluster");
+Object.defineProperty(exports, "startCluster", { enumerable: true, get: function () { return egg_cluster_1.startCluster; } });
+/**
+ * Start egg application with single process mode
+ * @since 1.0.0
+ */
+exports.start = start_js_1.startEgg;
+/**
+ * @member {Application} Egg#Application
+ * @since 1.0.0
+ */
+var application_js_1 = require("./lib/application.js");
+Object.defineProperty(exports, "Application", { enumerable: true, get: function () { return application_js_1.Application; } });
+/**
+ * @member {Agent} Egg#Agent
+ * @since 1.0.0
+ */
+var agent_js_1 = require("./lib/agent.js");
+Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_js_1.Agent; } });
+/**
+ * @member {AppWorkerLoader} Egg#AppWorkerLoader
+ * @since 1.0.0
+ */
+/**
+ * @member {AgentWorkerLoader} Egg#AgentWorkerLoader
+ * @since 1.0.0
+ */
+var index_js_1 = require("./lib/loader/index.js");
+Object.defineProperty(exports, "AppWorkerLoader", { enumerable: true, get: function () { return index_js_1.AppWorkerLoader; } });
+Object.defineProperty(exports, "AgentWorkerLoader", { enumerable: true, get: function () { return index_js_1.AgentWorkerLoader; } });
+/**
+ * @member {Controller} Egg#Controller
+ * @since 1.1.0
+ */
+exports.Controller = base_context_class_js_1.BaseContextClass;
+/**
+ * @member {Service} Egg#Service
+ * @since 1.1.0
+ */
+exports.Service = base_context_class_js_1.BaseContextClass;
+/**
+ * @member {Subscription} Egg#Subscription
+ * @since 1.10.0
+ */
+exports.Subscription = base_context_class_js_1.BaseContextClass;
+/**
+ * @member {BaseContextClass} Egg#BaseContextClass
+ * @since 1.2.0
+ */
+var base_context_class_js_2 = require("./lib/core/base_context_class.js");
+Object.defineProperty(exports, "BaseContextClass", { enumerable: true, get: function () { return base_context_class_js_2.BaseContextClass; } });
+/**
+ * @member {Boot} Egg#Boot
+ */
+var base_hook_class_js_1 = require("./lib/core/base_hook_class.js");
+Object.defineProperty(exports, "Boot", { enumerable: true, get: function () { return base_hook_class_js_1.BaseHookClass; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOztHQUVHOzs7Ozs7Ozs7Ozs7Ozs7OztBQUVILDRFQUFvRTtBQUNwRSw2Q0FBMEM7QUFFMUMsZUFBZTtBQUNmLCtDQUE2QjtBQUM3QixnREFBOEI7QUFDOUIsaURBQStCO0FBRS9COzs7R0FHRztBQUNILDZEQUE2RDtBQUM3RCxhQUFhO0FBQ2IsMkNBQTJDO0FBQWxDLDJHQUFBLFlBQVksT0FBQTtBQUVyQjs7O0dBR0c7QUFDVSxRQUFBLEtBQUssR0FBRyxtQkFBUSxDQUFDO0FBRTlCOzs7R0FHRztBQUNILHVEQUFtRDtBQUExQyw2R0FBQSxXQUFXLE9BQUE7QUFFcEI7OztHQUdHO0FBQ0gsMkNBQXVDO0FBQTlCLGlHQUFBLEtBQUssT0FBQTtBQUVkOzs7R0FHRztBQUVIOzs7R0FHRztBQUVILGtEQUEyRTtBQUFsRSwyR0FBQSxlQUFlLE9BQUE7QUFBRSw2R0FBQSxpQkFBaUIsT0FBQTtBQUUzQzs7O0dBR0c7QUFDVSxRQUFBLFVBQVUsR0FBRyx3Q0FBZ0IsQ0FBQztBQUUzQzs7O0dBR0c7QUFDVSxRQUFBLE9BQU8sR0FBRyx3Q0FBZ0IsQ0FBQztBQUV4Qzs7O0dBR0c7QUFDVSxRQUFBLFlBQVksR0FBRyx3Q0FBZ0IsQ0FBQztBQUU3Qzs7O0dBR0c7QUFDSCwwRUFBb0U7QUFBM0QseUhBQUEsZ0JBQWdCLE9BQUE7QUFFekI7O0dBRUc7QUFDSCxvRUFBc0U7QUFBN0QsMEdBQUEsYUFBYSxPQUFRIn0=

package/dist/commonjs/lib/agent.d.ts

@@ -0,0 +1,19 @@
+import { EggApplicationCore, EggApplicationCoreOptions } from './egg.js';
+import { AgentWorkerLoader } from './loader/index.js';
+declare const EGG_LOADER: unique symbol;
+/**
+ * Singleton instance in Agent Worker, extend {@link EggApplicationCore}
+ * @augments EggApplicationCore
+ */
+export declare class Agent extends EggApplicationCore {
+    #private;
+    /**
+     * @class
+     * @param {Object} options - see {@link EggApplicationCore}
+     */
+    constructor(options?: Omit<EggApplicationCoreOptions, 'type'>);
+    get [EGG_LOADER](): typeof AgentWorkerLoader;
+    _wrapMessenger(): void;
+    close(): Promise<void>;
+}
+export {};

package/dist/commonjs/lib/agent.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = void 0;
+const egg_js_1 = require("./egg.js");
+const index_js_1 = require("./loader/index.js");
+const EGG_LOADER = Symbol.for('egg#loader');
+/**
+ * Singleton instance in Agent Worker, extend {@link EggApplicationCore}
+ * @augments EggApplicationCore
+ */
+class Agent extends egg_js_1.EggApplicationCore {
+    #agentAliveHandler;
+    /**
+     * @class
+     * @param {Object} options - see {@link EggApplicationCore}
+     */
+    constructor(options) {
+        super({
+            ...options,
+            type: 'agent',
+        });
+        // keep agent alive even it doesn't have any io tasks
+        this.#agentAliveHandler = setInterval(() => {
+            this.coreLogger.info('[]');
+        }, 24 * 60 * 60 * 1000);
+    }
+    get [EGG_LOADER]() {
+        return index_js_1.AgentWorkerLoader;
+    }
+    _wrapMessenger() {
+        for (const methodName of [
+            'broadcast',
+            'sendTo',
+            'sendToApp',
+            'sendToAgent',
+            'sendRandom',
+        ]) {
+            wrapMethod(methodName, this.messenger, this.coreLogger);
+        }
+        function wrapMethod(methodName, messenger, logger) {
+            const originMethod = messenger[methodName];
+            messenger[methodName] = function (...args) {
+                const stack = new Error().stack.split('\n').slice(1).join('\n');
+                logger.warn("agent can't call %s before server started\n%s", methodName, stack);
+                originMethod.apply(this, args);
+            };
+            messenger.prependOnceListener('egg-ready', () => {
+                messenger[methodName] = originMethod;
+            });
+        }
+    }
+    async close() {
+        clearInterval(this.#agentAliveHandler);
+        await super.close();
+    }
+}
+exports.Agent = Agent;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL2FnZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLHFDQUF5RTtBQUN6RSxnREFBc0Q7QUFFdEQsTUFBTSxVQUFVLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsQ0FBQztBQUU1Qzs7O0dBR0c7QUFDSCxNQUFhLEtBQU0sU0FBUSwyQkFBa0I7SUFDbEMsa0JBQWtCLENBQWlCO0lBRTVDOzs7T0FHRztJQUNILFlBQVksT0FBaUQ7UUFDM0QsS0FBSyxDQUFDO1lBQ0osR0FBRyxPQUFPO1lBQ1YsSUFBSSxFQUFFLE9BQU87U0FDZCxDQUFDLENBQUM7UUFFSCxxREFBcUQ7UUFDckQsSUFBSSxDQUFDLGtCQUFrQixHQUFHLFdBQVcsQ0FBQyxHQUFHLEVBQUU7WUFDekMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDN0IsQ0FBQyxFQUFFLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQzFCLENBQUM7SUFFRCxJQUFJLENBQUMsVUFBVSxDQUFDO1FBQ2QsT0FBTyw0QkFBaUIsQ0FBQztJQUMzQixDQUFDO0lBRUQsY0FBYztRQUNaLEtBQUssTUFBTSxVQUFVLElBQUk7WUFDdkIsV0FBVztZQUNYLFFBQVE7WUFDUixXQUFXO1lBQ1gsYUFBYTtZQUNiLFlBQVk7U0FDYixFQUFFLENBQUM7WUFDRixVQUFVLENBQUMsVUFBVSxFQUFFLElBQUksQ0FBQyxTQUFTLEVBQUUsSUFBSSxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBQzFELENBQUM7UUFFRCxTQUFTLFVBQVUsQ0FBQyxVQUFrQixFQUFFLFNBQWMsRUFBRSxNQUFpQjtZQUN2RSxNQUFNLFlBQVksR0FBRyxTQUFTLENBQUMsVUFBVSxDQUFDLENBQUM7WUFDM0MsU0FBUyxDQUFDLFVBQVUsQ0FBQyxHQUFHLFVBQVMsR0FBRyxJQUFXO2dCQUM3QyxNQUFNLEtBQUssR0FBRyxJQUFJLEtBQUssRUFBRSxDQUFDLEtBQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztnQkFDakUsTUFBTSxDQUFDLElBQUksQ0FDVCwrQ0FBK0MsRUFDL0MsVUFBVSxFQUNWLEtBQUssQ0FDTixDQUFDO2dCQUNGLFlBQVksQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxDQUFDO1lBQ2pDLENBQUMsQ0FBQztZQUNGLFNBQVMsQ0FBQyxtQkFBbUIsQ0FBQyxXQUFXLEVBQUUsR0FBRyxFQUFFO2dCQUM5QyxTQUFTLENBQUMsVUFBVSxDQUFDLEdBQUcsWUFBWSxDQUFDO1lBQ3ZDLENBQUMsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztJQUNILENBQUM7SUFFRCxLQUFLLENBQUMsS0FBSztRQUNULGFBQWEsQ0FBQyxJQUFJLENBQUMsa0JBQWtCLENBQUMsQ0FBQztRQUN2QyxNQUFNLEtBQUssQ0FBQyxLQUFLLEVBQUUsQ0FBQztJQUN0QixDQUFDO0NBQ0Y7QUF2REQsc0JBdURDIn0=

package/dist/commonjs/lib/application.d.ts

@@ -0,0 +1,66 @@
+import http from 'node:http';
+import { Socket } from 'node:net';
+import { EggApplicationCore, EggContext, EggApplicationCoreOptions } from './egg.js';
+import { AppWorkerLoader } from './loader/index.js';
+import { BaseContextClass } from './core/base_context_class.js';
+declare const EGG_LOADER: unique symbol;
+/**
+ * The Helper class which can be used as utility function.
+ * We support developers to extend Helper through ${baseDir}/app/extend/helper.js ,
+ * then you can use all method on `ctx.helper` that is a instance of Helper.
+ */
+declare class HelperClass extends BaseContextClass {
+}
+/**
+ * Singleton instance in App Worker, extend {@link EggApplicationCore}
+ * @augments EggApplicationCore
+ */
+export declare class Application extends EggApplicationCore {
+    #private;
+    server?: http.Server;
+    /**
+     * reference to {@link Helper}
+     * @member {Helper} Application#Helper
+     */
+    Helper: typeof HelperClass;
+    /**
+     * @class
+     * @param {Object} options - see {@link EggApplicationCore}
+     */
+    constructor(options?: Omit<EggApplicationCoreOptions, 'type'>);
+    protected load(): Promise<void>;
+    get [EGG_LOADER](): typeof AppWorkerLoader;
+    onClientError(err: any, socket: Socket): void;
+    onServer(server: http.Server): void;
+    /**
+     * global locals for view
+     * @member {Object} Application#locals
+     * @see Context#locals
+     */
+    get locals(): Record<string, any>;
+    set locals(val: Record<string, any>);
+    /**
+     * save routers to `run/router.json`
+     * @private
+     */
+    dumpConfig(): void;
+    /**
+     * Run async function in the background
+     * @see Context#runInBackground
+     * @param {Function} scope - the first args is an anonymous ctx
+     */
+    runInBackground(scope: (ctx: EggContext) => void): void;
+    /**
+     * Run async function in the anonymous context scope
+     * @see Context#runInAnonymousContextScope
+     * @param {Function} scope - the first args is an anonymous ctx, scope should be async function
+     * @param {Request} [req] - if you want to mock request like querystring, you can pass an object to this function.
+     */
+    runInAnonymousContextScope(scope: (ctx: EggContext) => Promise<void>, req?: unknown): Promise<void>;
+    /**
+     * secret key for Application
+     * @member {String} Application#keys
+     */
+    get keys(): string[];
+}
+export {};

package/dist/commonjs/lib/application.js

@@ -0,0 +1,281 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Application = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_http_1 = __importDefault(require("node:http"));
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore
+const graceful_1 = __importDefault(require("graceful"));
+const utility_1 = require("utility");
+const core_1 = require("@eggjs/core");
+const egg_js_1 = require("./egg.js");
+const index_js_1 = require("./loader/index.js");
+const base_context_class_js_1 = require("./core/base_context_class.js");
+const EGG_LOADER = Symbol.for('egg#loader');
+// client error => 400 Bad Request
+// Refs: https://nodejs.org/dist/latest-v8.x/docs/api/http.html#http_event_clienterror
+const DEFAULT_BAD_REQUEST_HTML = `<html>
+  <head><title>400 Bad Request</title></head>
+  <body bgcolor="white">
+  <center><h1>400 Bad Request</h1></center>
+  <hr><center>❤</center>
+  </body>
+  </html>`;
+const DEFAULT_BAD_REQUEST_HTML_LENGTH = Buffer.byteLength(DEFAULT_BAD_REQUEST_HTML);
+const DEFAULT_BAD_REQUEST_RESPONSE = `HTTP/1.1 400 Bad Request\r\nContent-Length: ${DEFAULT_BAD_REQUEST_HTML_LENGTH}` +
+    `\r\n\r\n${DEFAULT_BAD_REQUEST_HTML}`;
+// Refs: https://github.com/nodejs/node/blob/b38c81/lib/_http_outgoing.js#L706-L710
+function escapeHeaderValue(value) {
+    // Protect against response splitting. The regex test is there to
+    // minimize the performance impact in the common case.
+    return /[\r\n]/.test(value) ? value.replace(/[\r\n]+[ \t]*/g, '') : value;
+}
+/**
+ * The Helper class which can be used as utility function.
+ * We support developers to extend Helper through ${baseDir}/app/extend/helper.js ,
+ * then you can use all method on `ctx.helper` that is a instance of Helper.
+ */
+class HelperClass extends base_context_class_js_1.BaseContextClass {
+}
+/**
+ * Singleton instance in App Worker, extend {@link EggApplicationCore}
+ * @augments EggApplicationCore
+ */
+class Application extends egg_js_1.EggApplicationCore {
+    // will auto set after 'server' event emit
+    server;
+    #locals = {};
+    /**
+     * reference to {@link Helper}
+     * @member {Helper} Application#Helper
+     */
+    Helper = HelperClass;
+    /**
+     * @class
+     * @param {Object} options - see {@link EggApplicationCore}
+     */
+    constructor(options) {
+        super({
+            ...options,
+            type: 'application',
+        });
+    }
+    async load() {
+        await super.load();
+        this.#warnConfusedConfig();
+        this.#bindEvents();
+    }
+    get [EGG_LOADER]() {
+        return index_js_1.AppWorkerLoader;
+    }
+    #responseRaw(socket, raw) {
+        /* istanbul ignore next */
+        if (!socket.writable)
+            return;
+        if (!raw) {
+            return socket.end(DEFAULT_BAD_REQUEST_RESPONSE);
+        }
+        const body = (raw.body == null) ? DEFAULT_BAD_REQUEST_HTML : raw.body;
+        const headers = raw.headers || {};
+        const status = raw.status || 400;
+        let responseHeaderLines = '';
+        const firstLine = `HTTP/1.1 ${status} ${node_http_1.default.STATUS_CODES[status] || 'Unknown'}`;
+        // Not that safe because no validation for header keys.
+        // Refs: https://github.com/nodejs/node/blob/b38c81/lib/_http_outgoing.js#L451
+        for (const key of Object.keys(headers)) {
+            if (key.toLowerCase() === 'content-length') {
+                delete headers[key];
+                continue;
+            }
+            responseHeaderLines += `${key}: ${escapeHeaderValue(headers[key])}\r\n`;
+        }
+        responseHeaderLines += `Content-Length: ${Buffer.byteLength(body)}\r\n`;
+        socket.end(`${firstLine}\r\n${responseHeaderLines}\r\n${body.toString()}`);
+    }
+    onClientError(err, socket) {
+        // ignore when there is no http body, it almost like an ECONNRESET
+        if (err.rawPacket) {
+            this.logger.warn('[egg:application] A client (%s:%d) error [%s] occurred: %s', socket.remoteAddress, socket.remotePort, err.code, err.message);
+        }
+        if (typeof this.config.onClientError === 'function') {
+            const p = core_1.utils.callFn(this.config.onClientError, [err, socket, this]);
+            // the returned object should be something like:
+            //
+            //   {
+            //     body: '...',
+            //     headers: {
+            //       ...
+            //     },
+            //     status: 400
+            //   }
+            //
+            // default values:
+            //
+            // + body: ''
+            // + headers: {}
+            // + status: 400
+            p.then(ret => {
+                this.#responseRaw(socket, ret || {});
+            }).catch(err => {
+                this.logger.error(err);
+                this.#responseRaw(socket);
+            });
+        }
+        else {
+            // because it's a raw socket object, we should return the raw HTTP response
+            // packet.
+            this.#responseRaw(socket);
+        }
+    }
+    onServer(server) {
+        // expose app.server
+        this.server = server;
+        // set ignore code
+        const serverGracefulIgnoreCode = this.config.serverGracefulIgnoreCode || [];
+        /* istanbul ignore next */
+        (0, graceful_1.default)({
+            server: [server],
+            error: (err, throwErrorCount) => {
+                const originMessage = err.message;
+                if (originMessage) {
+                    // shouldjs will override error property but only getter
+                    // https://github.com/shouldjs/should.js/blob/889e22ebf19a06bc2747d24cf34b25cc00b37464/lib/assertion-error.js#L26
+                    Object.defineProperty(err, 'message', {
+                        get() {
+                            return `${originMessage} (uncaughtException throw ${throwErrorCount} times on pid: ${process.pid})`;
+                        },
+                        configurable: true,
+                        enumerable: false,
+                    });
+                }
+                this.coreLogger.error(err);
+            },
+            ignoreCode: serverGracefulIgnoreCode,
+        });
+        server.on('clientError', (err, socket) => this.onClientError(err, socket));
+        // server timeout
+        if (typeof this.config.serverTimeout === 'number') {
+            server.setTimeout(this.config.serverTimeout);
+        }
+    }
+    /**
+     * global locals for view
+     * @member {Object} Application#locals
+     * @see Context#locals
+     */
+    get locals() {
+        return this.#locals;
+    }
+    set locals(val) {
+        (0, utility_1.assign)(this.#locals, val);
+    }
+    /**
+     * save routers to `run/router.json`
+     * @private
+     */
+    dumpConfig() {
+        super.dumpConfig();
+        // dump routers to router.json
+        const rundir = this.config.rundir;
+        const FULLPATH = this.loader.FileLoader.FULLPATH;
+        try {
+            const dumpRouterFile = node_path_1.default.join(rundir, 'router.json');
+            const routers = [];
+            for (const layer of this.router.stack) {
+                routers.push({
+                    name: layer.name,
+                    methods: layer.methods,
+                    paramNames: layer.paramNames,
+                    path: layer.path,
+                    regexp: layer.regexp.toString(),
+                    stack: layer.stack.map((stack) => stack[FULLPATH] || stack._name || stack.name || 'anonymous'),
+                });
+            }
+            node_fs_1.default.writeFileSync(dumpRouterFile, JSON.stringify(routers, null, 2));
+        }
+        catch (err) {
+            this.coreLogger.warn(`dumpConfig router.json error: ${err.message}`);
+        }
+    }
+    /**
+     * Run async function in the background
+     * @see Context#runInBackground
+     * @param {Function} scope - the first args is an anonymous ctx
+     */
+    runInBackground(scope) {
+        const ctx = this.createAnonymousContext();
+        if (!scope.name) {
+            Reflect.set(scope, '_name', core_1.utils.getCalleeFromStack(true));
+        }
+        this.ctxStorage.run(ctx, () => {
+            ctx.runInBackground(scope);
+        });
+    }
+    /**
+     * Run async function in the anonymous context scope
+     * @see Context#runInAnonymousContextScope
+     * @param {Function} scope - the first args is an anonymous ctx, scope should be async function
+     * @param {Request} [req] - if you want to mock request like querystring, you can pass an object to this function.
+     */
+    async runInAnonymousContextScope(scope, req) {
+        const ctx = this.createAnonymousContext(req);
+        if (!scope.name) {
+            Reflect.set(scope, '_name', core_1.utils.getCalleeFromStack(true));
+        }
+        return await this.ctxStorage.run(ctx, async () => {
+            return await scope(ctx);
+        });
+    }
+    /**
+     * secret key for Application
+     * @member {String} Application#keys
+     */
+    get keys() {
+        if (!this._keys) {
+            if (!this.config.keys) {
+                if (this.config.env === 'local' || this.config.env === 'unittest') {
+                    const configPath = node_path_1.default.join(this.config.baseDir, 'config/config.default.js');
+                    console.error('Cookie need secret key to sign and encrypt.');
+                    console.error('Please add `config.keys` in %s', configPath);
+                }
+                throw new Error('Please set config.keys first');
+            }
+            this._keys = this.config.keys.split(',').map(s => s.trim());
+        }
+        return this._keys;
+    }
+    /**
+     * bind app's events
+     *
+     * @private
+     */
+    #bindEvents() {
+        // Browser Cookie Limits: http://browsercookielimits.squawky.net/
+        this.on('cookieLimitExceed', ({ name, value, ctx }) => {
+            const err = new Error(`cookie ${name}'s length(${value.length}) exceed the limit(4093)`);
+            err.name = 'CookieLimitExceedError';
+            ctx.coreLogger.error(err);
+        });
+        // expose server to support websocket
+        this.once('server', (server) => this.onServer(server));
+    }
+    /**
+     * warn when confused configurations are present
+     *
+     * @private
+     */
+    #warnConfusedConfig() {
+        const confusedConfigurations = this.config.confusedConfigurations;
+        Object.keys(confusedConfigurations).forEach(key => {
+            if (this.config[key] !== undefined) {
+                this.logger.warn('[egg:application] Unexpected config key `%o` exists, Please use `%o` instead.', key, confusedConfigurations[key]);
+            }
+        });
+    }
+}
+exports.Application = Application;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL2FwcGxpY2F0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLDBEQUE2QjtBQUM3QixzREFBeUI7QUFDekIsMERBQTZCO0FBRTdCLDZEQUE2RDtBQUM3RCxhQUFhO0FBQ2Isd0RBQWdDO0FBQ2hDLHFDQUFpQztBQUNqQyxzQ0FBZ0Q7QUFDaEQscUNBQXFGO0FBQ3JGLGdEQUFvRDtBQUNwRCx3RUFBZ0U7QUFFaEUsTUFBTSxVQUFVLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsQ0FBQztBQUU1QyxrQ0FBa0M7QUFDbEMsc0ZBQXNGO0FBQ3RGLE1BQU0sd0JBQXdCLEdBQUc7Ozs7OztVQU12QixDQUFDO0FBQ1gsTUFBTSwrQkFBK0IsR0FBRyxNQUFNLENBQUMsVUFBVSxDQUFDLHdCQUF3QixDQUFDLENBQUM7QUFDcEYsTUFBTSw0QkFBNEIsR0FDaEMsK0NBQStDLCtCQUErQixFQUFFO0lBQ2hGLFdBQVcsd0JBQXdCLEVBQUUsQ0FBQztBQUV4QyxtRkFBbUY7QUFDbkYsU0FBUyxpQkFBaUIsQ0FBQyxLQUFhO0lBQ3RDLGlFQUFpRTtJQUNqRSxzREFBc0Q7SUFDdEQsT0FBTyxRQUFRLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLGdCQUFnQixFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUM7QUFDNUUsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLFdBQVksU0FBUSx3Q0FBZ0I7Q0FBRztBQUU3Qzs7O0dBR0c7QUFDSCxNQUFhLFdBQVksU0FBUSwyQkFBa0I7SUFDakQsMENBQTBDO0lBQzFDLE1BQU0sQ0FBZTtJQUNyQixPQUFPLEdBQXdCLEVBQUUsQ0FBQztJQUNsQzs7O09BR0c7SUFDSCxNQUFNLEdBQUcsV0FBVyxDQUFDO0lB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

package/dist/commonjs/lib/core/base_context_class.d.ts

@@ -0,0 +1,14 @@
+import { BaseContextClass as EggCoreBaseContextClass } from '@eggjs/core';
+import type { EggContext } from '../egg.js';
+import { BaseContextLogger } from './base_context_logger.js';
+/**
+ * BaseContextClass is a base class that can be extended,
+ * it's instantiated in context level,
+ * {@link Helper}, {@link Service} is extending it.
+ */
+export declare class BaseContextClass extends EggCoreBaseContextClass {
+    #private;
+    ctx: EggContext;
+    protected pathName?: string;
+    get logger(): BaseContextLogger;
+}

package/dist/commonjs/lib/core/base_context_class.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseContextClass = void 0;
+const core_1 = require("@eggjs/core");
+const base_context_logger_js_1 = require("./base_context_logger.js");
+/**
+ * BaseContextClass is a base class that can be extended,
+ * it's instantiated in context level,
+ * {@link Helper}, {@link Service} is extending it.
+ */
+class BaseContextClass extends core_1.BaseContextClass {
+    pathName;
+    #logger;
+    get logger() {
+        if (!this.#logger) {
+            this.#logger = new base_context_logger_js_1.BaseContextLogger(this.ctx, this.pathName);
+        }
+        return this.#logger;
+    }
+}
+exports.BaseContextClass = BaseContextClass;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFzZV9jb250ZXh0X2NsYXNzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9jb3JlL2Jhc2VfY29udGV4dF9jbGFzcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxzQ0FBMEU7QUFFMUUscUVBQTZEO0FBRTdEOzs7O0dBSUc7QUFDSCxNQUFhLGdCQUFpQixTQUFRLHVCQUF1QjtJQUVqRCxRQUFRLENBQVU7SUFDNUIsT0FBTyxDQUFxQjtJQUU1QixJQUFJLE1BQU07UUFDUixJQUFJLENBQUMsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQ2xCLElBQUksQ0FBQyxPQUFPLEdBQUcsSUFBSSwwQ0FBaUIsQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUNoRSxDQUFDO1FBQ0QsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDO0lBQ3RCLENBQUM7Q0FDRjtBQVhELDRDQVdDIn0=

package/dist/commonjs/lib/core/base_context_logger.d.ts

@@ -0,0 +1,36 @@
+import type { EggContext } from '../egg.js';
+export declare class BaseContextLogger {
+    #private;
+    /**
+     * @class
+     * @param {Context} ctx - context instance
+     * @param {String} pathName - class path name
+     * @since 1.0.0
+     */
+    constructor(ctx: EggContext, pathName?: string);
+    protected _log(method: 'info' | 'warn' | 'error' | 'debug', args: any[]): void;
+    /**
+     * @member {Function} BaseContextLogger#debug
+     * @param {...any} args - log msg
+     * @since 1.2.0
+     */
+    debug(...args: any[]): void;
+    /**
+     * @member {Function} BaseContextLogger#info
+     * @param {...any} args - log msg
+     * @since 1.2.0
+     */
+    info(...args: any[]): void;
+    /**
+     * @member {Function} BaseContextLogger#warn
+     * @param {...any} args - log msg
+     * @since 1.2.0
+     */
+    warn(...args: any[]): void;
+    /**
+     * @member {Function} BaseContextLogger#error
+     * @param {...any} args - log msg
+     * @since 1.2.0
+     */
+    error(...args: any[]): void;
+}