egg 3.29.0 → 4.0.0-beta.10

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

@@ -0,0 +1,66 @@
+/**
+ * @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 extends
+export { Helper };
+// 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
+ */
+export * from '@eggjs/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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFFSCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUNwRSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFDMUMsT0FBTyxNQUFNLE1BQU0sd0JBQXdCLENBQUM7QUFFNUMsaUJBQWlCO0FBQ2pCLE9BQU8sRUFBRSxNQUFNLEVBQUUsQ0FBQztBQUVsQixlQUFlO0FBQ2YsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxlQUFlLENBQUM7QUFDOUIsY0FBYyxnQkFBZ0IsQ0FBQztBQUUvQjs7O0dBR0c7QUFDSCxjQUFjLGdCQUFnQixDQUFDO0FBRS9COzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUM7QUFFOUI7OztHQUdHO0FBQ0gsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBRW5EOzs7R0FHRztBQUNILE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUV2Qzs7O0dBR0c7QUFFSDs7O0dBR0c7QUFFSCxPQUFPLEVBQUUsZUFBZSxFQUFFLGlCQUFpQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFM0U7OztHQUdHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHLGdCQUFnQixDQUFDO0FBRTNDOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLE9BQU8sR0FBRyxnQkFBZ0IsQ0FBQztBQUV4Qzs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxZQUFZLEdBQUcsZ0JBQWdCLENBQUM7QUFFN0M7OztHQUdHO0FBQ0gsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFFcEU7O0dBRUc7QUFDSCxPQUFPLEVBQUUsYUFBYSxJQUFJLElBQUksRUFBRSxNQUFNLCtCQUErQixDQUFDIn0=

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

@@ -0,0 +1,263 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import http from 'node:http';
+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 Helper from '../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
+ */
+export class Application extends EggApplicationCore {
+    // will auto set after 'server' event emit
+    server;
+    #locals = {};
+    /**
+     * reference to {@link Helper}
+     * @member {Helper} Application#Helper
+     */
+    Helper = Helper;
+    /**
+     * @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) {
+        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 || [];
+        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, req) {
+        const ctx = this.createAnonymousContext(req);
+        if (!scope.name) {
+            Reflect.set(scope, '_name', eggUtils.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', 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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL2FwcGxpY2F0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUM3QixPQUFPLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDekIsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBRTdCLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxVQUFVLENBQUM7QUFDcEMsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUNqQyxPQUFPLEVBQUUsS0FBSyxJQUFJLFFBQVEsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUNoRCxPQUFPLEVBQ0wsa0JBQWtCLEdBR25CLE1BQU0sVUFBVSxDQUFDO0FBQ2xCLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUNwRCxPQUFPLE1BQU0sTUFBTSx5QkFBeUIsQ0FBQztBQUU3QyxNQUFNLFVBQVUsR0FBRyxNQUFNLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxDQUFDO0FBRTVDLGtDQUFrQztBQUNsQyxzRkFBc0Y7QUFDdEYsTUFBTSx3QkFBd0IsR0FBRzs7Ozs7O1VBTXZCLENBQUM7QUFDWCxNQUFNLCtCQUErQixHQUFHLE1BQU0sQ0FBQyxVQUFVLENBQUMsd0JBQXdCLENBQUMsQ0FBQztBQUNwRixNQUFNLDRCQUE0QixHQUNoQywrQ0FBK0MsK0JBQStCLEVBQUU7SUFDaEYsV0FBVyx3QkFBd0IsRUFBRSxDQUFDO0FBRXhDLG1GQUFtRjtBQUNuRixTQUFTLGlCQUFpQixDQUFDLEtBQWE7SUFDdEMsaUVBQWlFO0lBQ2pFLHNEQUFzRDtJQUN0RCxPQUFPLFFBQVEsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsZ0JBQWdCLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLEtB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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 { 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/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;
+}