egg 3.26.1 → 4.0.0-beta.0

package/dist/esm/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/esm/index.js

@@ -0,0 +1,65 @@
+/**
+ * @namespace Egg
+ */
+import { BaseContextClass } from './lib/core/base_context_class.js';
+import { startEgg } from './lib/start.js';
+// export types
+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
+ */
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore
+export { startCluster } from 'egg-cluster';
+/**
+ * Start egg application with single process mode
+ * @since 1.0.0
+ */
+export const start = 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 const Controller = BaseContextClass;
+/**
+ * @member {Service} Egg#Service
+ * @since 1.1.0
+ */
+export const Service = BaseContextClass;
+/**
+ * @member {Subscription} Egg#Subscription
+ * @since 1.10.0
+ */
+export const Subscription = 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';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFFSCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUNwRSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFMUMsZUFBZTtBQUNmLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsZ0JBQWdCLENBQUM7QUFFL0I7OztHQUdHO0FBQ0gsNkRBQTZEO0FBQzdELGFBQWE7QUFDYixPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRTNDOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUM7QUFFOUI7OztHQUdHO0FBQ0gsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBRW5EOzs7R0FHRztBQUNILE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUV2Qzs7O0dBR0c7QUFFSDs7O0dBR0c7QUFFSCxPQUFPLEVBQUUsZUFBZSxFQUFFLGlCQUFpQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFM0U7OztHQUdHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHLGdCQUFnQixDQUFDO0FBRTNDOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLE9BQU8sR0FBRyxnQkFBZ0IsQ0FBQztBQUV4Qzs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxZQUFZLEdBQUcsZ0JBQWdCLENBQUM7QUFFN0M7OztHQUdHO0FBQ0gsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFFcEU7O0dBRUc7QUFDSCxPQUFPLEVBQUUsYUFBYSxJQUFJLElBQUksRUFBRSxNQUFNLCtCQUErQixDQUFDIn0=

package/dist/esm/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/esm/lib/agent.js

@@ -0,0 +1,54 @@
+import { EggApplicationCore } from './egg.js';
+import { AgentWorkerLoader } from './loader/index.js';
+const EGG_LOADER = Symbol.for('egg#loader');
+/**
+ * Singleton instance in Agent Worker, extend {@link EggApplicationCore}
+ * @augments EggApplicationCore
+ */
+export class Agent extends 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 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();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL2FnZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxrQkFBa0IsRUFBNkIsTUFBTSxVQUFVLENBQUM7QUFDekUsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFFdEQsTUFBTSxVQUFVLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsQ0FBQztBQUU1Qzs7O0dBR0c7QUFDSCxNQUFNLE9BQU8sS0FBTSxTQUFRLGtCQUFrQjtJQUNsQyxrQkFBa0IsQ0FBaUI7SUFFNUM7OztPQUdHO0lBQ0gsWUFBWSxPQUFpRDtRQUMzRCxLQUFLLENBQUM7WUFDSixHQUFHLE9BQU87WUFDVixJQUFJLEVBQUUsT0FBTztTQUNkLENBQUMsQ0FBQztRQUVILHFEQUFxRDtRQUNyRCxJQUFJLENBQUMsa0JBQWtCLEdBQUcsV0FBVyxDQUFDLEdBQUcsRUFBRTtZQUN6QyxJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUM3QixDQUFDLEVBQUUsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDMUIsQ0FBQztJQUVELElBQUksQ0FBQyxVQUFVLENBQUM7UUFDZCxPQUFPLGlCQUFpQixDQUFDO0lBQzNCLENBQUM7SUFFRCxjQUFjO1FBQ1osS0FBSyxNQUFNLFVBQVUsSUFBSTtZQUN2QixXQUFXO1lBQ1gsUUFBUTtZQUNSLFdBQVc7WUFDWCxhQUFhO1lBQ2IsWUFBWTtTQUNiLEVBQUUsQ0FBQztZQUNGLFVBQVUsQ0FBQyxVQUFVLEVBQUUsSUFBSSxDQUFDLFNBQVMsRUFBRSxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDMUQsQ0FBQztRQUVELFNBQVMsVUFBVSxDQUFDLFVBQWtCLEVBQUUsU0FBYyxFQUFFLE1BQWlCO1lBQ3ZFLE1BQU0sWUFBWSxHQUFHLFNBQVMsQ0FBQyxVQUFVLENBQUMsQ0FBQztZQUMzQyxTQUFTLENBQUMsVUFBVSxDQUFDLEdBQUcsVUFBUyxHQUFHLElBQVc7Z0JBQzdDLE1BQU0sS0FBSyxHQUFHLElBQUksS0FBSyxFQUFFLENBQUMsS0FBTSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO2dCQUNqRSxNQUFNLENBQUMsSUFBSSxDQUNULCtDQUErQyxFQUMvQyxVQUFVLEVBQ1YsS0FBSyxDQUNOLENBQUM7Z0JBQ0YsWUFBWSxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLENBQUM7WUFDakMsQ0FBQyxDQUFDO1lBQ0YsU0FBUyxDQUFDLG1CQUFtQixDQUFDLFdBQVcsRUFBRSxHQUFHLEVBQUU7Z0JBQzlDLFNBQVMsQ0FBQyxVQUFVLENBQUMsR0FBRyxZQUFZLENBQUM7WUFDdkMsQ0FBQyxDQUFDLENBQUM7UUFDTCxDQUFDO0lBQ0gsQ0FBQztJQUVELEtBQUssQ0FBQyxLQUFLO1FBQ1QsYUFBYSxDQUFDLElBQUksQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDO1FBQ3ZDLE1BQU0sS0FBSyxDQUFDLEtBQUssRUFBRSxDQUFDO0lBQ3RCLENBQUM7Q0FDRiJ9

package/dist/esm/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/esm/lib/application.js

@@ -0,0 +1,274 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import http from 'node:http';
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore
+import graceful from 'graceful';
+import { assign } from 'utility';
+import { utils as eggUtils } from '@eggjs/core';
+import { EggApplicationCore } from './egg.js';
+import { AppWorkerLoader } from './loader/index.js';
+import { BaseContextClass } from './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 BaseContextClass {
+}
+/**
+ * Singleton instance in App Worker, extend {@link EggApplicationCore}
+ * @augments EggApplicationCore
+ */
+export class Application extends 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 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} ${http.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 = eggUtils.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 */
+        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) {
+        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 = path.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'),
+                });
+            }
+            fs.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', eggUtils.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', eggUtils.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 = path.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]);
+            }
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL2FwcGxpY2F0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUM3QixPQUFPLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDekIsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBRTdCLDZEQUE2RDtBQUM3RCxhQUFhO0FBQ2IsT0FBTyxRQUFRLE1BQU0sVUFBVSxDQUFDO0FBQ2hDLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDakMsT0FBTyxFQUFFLEtBQUssSUFBSSxRQUFRLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDaEQsT0FBTyxFQUFFLGtCQUFrQixFQUF5QyxNQUFNLFVBQVUsQ0FBQztBQUNyRixPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDcEQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFFaEUsTUFBTSxVQUFVLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsQ0FBQztBQUU1QyxrQ0FBa0M7QUFDbEMsc0ZBQXNGO0FBQ3RGLE1BQU0sd0JBQXdCLEdBQUc7Ozs7OztVQU12QixDQUFDO0FBQ1gsTUFBTSwrQkFBK0IsR0FBRyxNQUFNLENBQUMsVUFBVSxDQUFDLHdCQUF3QixDQUFDLENBQUM7QUFDcEYsTUFBTSw0QkFBNEIsR0FDaEMsK0NBQStDLCtCQUErQixFQUFFO0lBQ2hGLFdBQVcsd0JBQXdCLEVBQUUsQ0FBQztBQUV4QyxtRkFBbUY7QUFDbkYsU0FBUyxpQkFBaUIsQ0FBQyxLQUFhO0lBQ3RDLGlFQUFpRTtJQUNqRSxzREFBc0Q7SUFDdEQsT0FBTyxRQUFRLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLGdCQUFnQixFQUFFLEVB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

package/dist/esm/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/esm/lib/core/base_context_class.js

@@ -0,0 +1,18 @@
+import { BaseContextClass as EggCoreBaseContextClass } from '@eggjs/core';
+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 class BaseContextClass extends EggCoreBaseContextClass {
+    pathName;
+    #logger;
+    get logger() {
+        if (!this.#logger) {
+            this.#logger = new BaseContextLogger(this.ctx, this.pathName);
+        }
+        return this.#logger;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFzZV9jb250ZXh0X2NsYXNzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9jb3JlL2Jhc2VfY29udGV4dF9jbGFzcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsZ0JBQWdCLElBQUksdUJBQXVCLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFMUUsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFFN0Q7Ozs7R0FJRztBQUNILE1BQU0sT0FBTyxnQkFBaUIsU0FBUSx1QkFBdUI7SUFFakQsUUFBUSxDQUFVO0lBQzVCLE9BQU8sQ0FBcUI7SUFFNUIsSUFBSSxNQUFNO1FBQ1IsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNsQixJQUFJLENBQUMsT0FBTyxHQUFHLElBQUksaUJBQWlCLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxJQUFJLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDaEUsQ0FBQztRQUNELE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQztJQUN0QixDQUFDO0NBQ0YifQ==

package/dist/esm/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;
+}