egg 3.29.0 → 4.0.0-beta.10

package/dist/commonjs/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @namespace Egg
+ */
+import { BaseContextClass } from './lib/core/base_context_class.js';
+import { startEgg } from './lib/start.js';
+import Helper from './app/extend/helper.js';
+export { Helper };
+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 * from '@eggjs/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,91 @@
+"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);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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.Helper = void 0;
+const base_context_class_js_1 = require("./lib/core/base_context_class.js");
+const start_js_1 = require("./lib/start.js");
+const helper_js_1 = __importDefault(require("./app/extend/helper.js"));
+exports.Helper = helper_js_1.default;
+// 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
+ */
+__exportStar(require("@eggjs/cluster"), exports);
+/**
+ * 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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOztHQUVHOzs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUVILDRFQUFvRTtBQUNwRSw2Q0FBMEM7QUFDMUMsdUVBQTRDO0FBR25DLGlCQUhGLG1CQUFNLENBR0U7QUFFZixlQUFlO0FBQ2YsK0NBQTZCO0FBQzdCLGdEQUE4QjtBQUM5QixpREFBK0I7QUFFL0I7OztHQUdHO0FBQ0gsaURBQStCO0FBRS9COzs7R0FHRztBQUNVLFFBQUEsS0FBSyxHQUFHLG1CQUFRLENBQUM7QUFFOUI7OztHQUdHO0FBQ0gsdURBQW1EO0FBQTFDLDZHQUFBLFdBQVcsT0FBQTtBQUVwQjs7O0dBR0c7QUFDSCwyQ0FBdUM7QUFBOUIsaUdBQUEsS0FBSyxPQUFBO0FBRWQ7OztHQUdHO0FBRUg7OztHQUdHO0FBRUgsa0RBQTJFO0FBQWxFLDJHQUFBLGVBQWUsT0FBQTtBQUFFLDZHQUFBLGlCQUFpQixPQUFBO0FBRTNDOzs7R0FHRztBQUNVLFFBQUEsVUFBVSxHQUFHLHdDQUFnQixDQUFDO0FBRTNDOzs7R0FHRztBQUNVLFFBQUEsT0FBTyxHQUFHLHdDQUFnQixDQUFDO0FBRXhDOzs7R0FHRztBQUNVLFFBQUEsWUFBWSxHQUFHLHdDQUFnQixDQUFDO0FBRTdDOzs7R0FHRztBQUNILDBFQUFvRTtBQUEzRCx5SEFBQSxnQkFBZ0IsT0FBQTtBQUV6Qjs7R0FFRztBQUNILG9FQUFzRTtBQUE3RCwwR0FBQSxhQUFhLE9BQVEifQ==

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,59 @@
+import http from 'node:http';
+import { Socket } from 'node:net';
+import { EggApplicationCore, type EggApplicationCoreOptions, type ContextDelegation } from './egg.js';
+import { AppWorkerLoader } from './loader/index.js';
+import Helper from '../app/extend/helper.js';
+declare const EGG_LOADER: unique symbol;
+/**
+ * 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 Helper;
+    /**
+     * @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: ContextDelegation) => Promise<void>, req?: unknown): 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: ContextDelegation) => 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,270 @@
+"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"));
+const graceful_1 = 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 helper_js_1 = __importDefault(require("../app/extend/helper.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;
+}
+/**
+ * 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 = helper_js_1.default;
+    /**
+     * @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) {
+        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 || [];
+        (0, graceful_1.graceful)({
+            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, req) {
+        const ctx = this.createAnonymousContext(req);
+        if (!scope.name) {
+            Reflect.set(scope, '_name', core_1.utils.getCalleeFromStack(true));
+        }
+        this.ctxStorage.run(ctx, () => {
+            return 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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL2FwcGxpY2F0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLDBEQUE2QjtBQUM3QixzREFBeUI7QUFDekIsMERBQTZCO0FBRTdCLHVDQUFvQztBQUNwQyxxQ0FBaUM7QUFDakMsc0NBQWdEO0FBQ2hELHFDQUlrQjtBQUNsQixnREFBb0Q7QUFDcEQsd0VBQTZDO0FBRTdDLE1BQU0sVUFBVSxHQUFHLE1BQU0sQ0FBQyxHQUFHLENBQUMsWUFBWSxDQUFDLENBQUM7QUFFNUMsa0NBQWtDO0FBQ2xDLHNGQUFzRjtBQUN0RixNQUFNLHdCQUF3QixHQUFHOzs7Ozs7VUFNdkIsQ0FBQztBQUNYLE1BQU0sK0JBQStCLEdBQUcsTUFBTSxDQUFDLFVBQVUsQ0FBQyx3QkFBd0IsQ0FBQyxDQUFDO0FBQ3BGLE1BQU0sNEJBQTRCLEdBQ2hDLCtDQUErQywrQkFBK0IsRUFBRTtJQUNoRixXQUFXLHdCQUF3QixFQUFFLENBQUM7QUFFeEMsbUZBQW1GO0FBQ25GLFNBQVMsaUJBQWlCLENBQUMsS0FBYTtJQUN0QyxpRUFBaUU7SUFDakUsc0RBQXNEO0lBQ3RELE9BQU8sUUFBUSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxnQkFBZ0IsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDO0FBQzVFLENBQUM7QUFFRDs7O0dBR0c7QUFDSCxNQUFhLFdBQVksU0FBUSwyQkFBa0I7SUFDakQsMENBQTBDO0lBQzFDLE1BQU0sQ0FBZTtJQUNyQixPQUFPLEdBQXdCLEVBQUUsQ0FBQztJQUNsQzs7O09BR0c7SUFDSCxNQUFNLEdBQUcsbUJBQU0sQ0FBQztJQUVoQjs7O09BR0c7SUFDSCxZQUFZLE9BQWlEO1FBQzNELEtBQUssQ0FBQztZQUNKLEdBQUcsT0FBTztZQUNWLElBQUks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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 { ContextDelegation } 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: ContextDelegation;
+    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;
+}