@eggjs/core 6.0.0-beta.0

package/dist/esm/egg.js

@@ -0,0 +1,339 @@
+/* eslint-disable prefer-spread */
+import assert from 'node:assert';
+import { debuglog } from 'node:util';
+import is from 'is-type-of';
+import KoaApplication from '@eggjs/koa';
+import { EggConsoleLogger } from 'egg-logger';
+import { EggRouter as Router } from '@eggjs/router';
+import { BaseContextClass } from './base_context_class.js';
+import { Timing } from './utils/timing.js';
+import { Lifecycle } from './lifecycle.js';
+import { EggLoader } from './loader/egg_loader.js';
+import utils from './utils/index.js';
+const debug = debuglog('@eggjs/core:egg');
+const EGG_LOADER = Symbol.for('egg#loader');
+export class EggCore extends KoaApplication {
+    options;
+    timing;
+    console;
+    BaseContextClass;
+    Controller;
+    Service;
+    Helper;
+    lifecycle;
+    loader;
+    #closePromise;
+    #router;
+    /** auto inject on loadService() */
+    serviceClasses = {};
+    /** auto inject on loadController() */
+    controller = {};
+    /** auto inject on loadMiddleware() */
+    middlewares = {};
+    /**
+     * @class
+     * @param {Object} options - options
+     * @param {String} [options.baseDir=process.cwd()] - the directory of application
+     * @param {String} [options.type=application|agent] - whether it's running in app worker or agent worker
+     * @param {Object} [options.plugins] - custom plugins
+     * @since 1.0.0
+     */
+    constructor(options = {}) {
+        options.baseDir = options.baseDir ?? process.cwd();
+        options.type = options.type ?? 'application';
+        assert(typeof options.baseDir === 'string', 'options.baseDir required, and must be a string');
+        // assert(fs.existsSync(options.baseDir), `Directory ${options.baseDir} not exists`);
+        // assert(fs.statSync(options.baseDir).isDirectory(), `Directory ${options.baseDir} is not a directory`);
+        assert(options.type === 'application' || options.type === 'agent', 'options.type should be application or agent');
+        super();
+        this.timing = new Timing();
+        /**
+         * @member {Object} EggCore#options
+         * @private
+         * @since 1.0.0
+         */
+        this.options = options;
+        /**
+         * logging for EggCore, avoid using console directly
+         * @member {Logger} EggCore#console
+         * @private
+         * @since 1.0.0
+         */
+        this.console = new EggConsoleLogger();
+        /**
+         * @member {BaseContextClass} EggCore#BaseContextClass
+         * @since 1.0.0
+         */
+        this.BaseContextClass = BaseContextClass;
+        /**
+         * Base controller to be extended by controller in `app.controller`
+         * @class Controller
+         * @augments BaseContextClass
+         * @example
+         * class UserController extends app.Controller {}
+         */
+        const Controller = this.BaseContextClass;
+        /**
+         * Retrieve base controller
+         * @member {Controller} EggCore#Controller
+         * @since 1.0.0
+         */
+        this.Controller = Controller;
+        /**
+         * Base service to be extended by services in `app.service`
+         * @class Service
+         * @augments BaseContextClass
+         * @example
+         * class UserService extends app.Service {}
+         */
+        const Service = this.BaseContextClass;
+        /**
+         * Retrieve base service
+         * @member {Service} EggCore#Service
+         * @since 1.0.0
+         */
+        this.Service = Service;
+        this.lifecycle = new Lifecycle({
+            baseDir: options.baseDir,
+            app: this,
+            logger: this.console,
+        });
+        this.lifecycle.on('error', err => this.emit('error', err));
+        this.lifecycle.on('ready_timeout', id => this.emit('ready_timeout', id));
+        this.lifecycle.on('ready_stat', data => this.emit('ready_stat', data));
+        /**
+         * The loader instance, the default class is {@link EggLoader}.
+         * If you want define
+         * @member {EggLoader} EggCore#loader
+         * @since 1.0.0
+         */
+        const Loader = this[EGG_LOADER];
+        assert(Loader, 'Symbol.for(\'egg#loader\') is required');
+        this.loader = new Loader({
+            baseDir: options.baseDir,
+            app: this,
+            plugins: options.plugins,
+            logger: this.console,
+            serverScope: options.serverScope,
+            env: options.env ?? '',
+            EggCoreClass: EggCore,
+        });
+    }
+    /**
+     * override koa's app.use, support generator function
+     * @since 1.0.0
+     */
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    use(fn) {
+        assert(is.function(fn), 'app.use() requires a function');
+        debug('[use] add middleware: %o', fn._name || fn.name || '-');
+        this.middleware.push(fn);
+        return this;
+    }
+    /**
+     * Whether `application` or `agent`
+     * @member {String}
+     * @since 1.0.0
+     */
+    get type() {
+        return this.options.type;
+    }
+    /**
+     * The current directory of application
+     * @member {String}
+     * @see {@link AppInfo#baseDir}
+     * @since 1.0.0
+     */
+    get baseDir() {
+        return this.options.baseDir;
+    }
+    /**
+     * Alias to {@link https://npmjs.com/package/depd}
+     * @member {Function}
+     * @since 1.0.0
+     */
+    get deprecate() {
+        return utils.deprecated;
+    }
+    /**
+     * The name of application
+     * @member {String}
+     * @see {@link AppInfo#name}
+     * @since 1.0.0
+     */
+    get name() {
+        return this.loader ? this.loader.pkg.name : '';
+    }
+    /**
+     * Retrieve enabled plugins
+     * @member {Object}
+     * @since 1.0.0
+     */
+    get plugins() {
+        return this.loader ? this.loader.plugins : {};
+    }
+    /**
+     * The configuration of application
+     * @member {Config}
+     * @since 1.0.0
+     */
+    get config() {
+        return this.loader ? this.loader.config : {};
+    }
+    /**
+     * Execute scope after loaded and before app start.
+     *
+     * Notice:
+     * This method is now NOT recommanded and reguarded as a deprecated one,
+     * For plugin development, we should use `didLoad` instead.
+     * For application development, we should use `willReady` instead.
+     *
+     * @see https://eggjs.org/en/advanced/loader.html#beforestart
+     *
+     * @param  {Function|AsyncFunction} scope function will execute before app start
+     * @param {string} [name] scope name, default is empty string
+     */
+    beforeStart(scope, name) {
+        this.deprecate('Please use "Life Cycles" instead, see https://www.eggjs.org/advanced/loader#life-cycles');
+        this.lifecycle.registerBeforeStart(scope, name ?? '');
+    }
+    /**
+     * register an callback function that will be invoked when application is ready.
+     * @see https://github.com/node-modules/get-ready
+     * @since 1.0.0
+     * @example
+     * const app = new Application(...);
+     * app.ready(err => {
+     *   if (err) throw err;
+     *   console.log('done');
+     * });
+     */
+    ready(flagOrFunction) {
+        return this.lifecycle.ready(flagOrFunction);
+    }
+    /**
+     * If a client starts asynchronously, you can register `readyCallback`,
+     * then the application will wait for the callback to ready
+     *
+     * It will log when the callback is not invoked after 10s
+     *
+     * Recommend to use {@link EggCore#beforeStart}
+     * @since 1.0.0
+     *
+     * @param {String} name - readyCallback task name
+     * @param {object} opts -
+     *   - {Number} [timeout=10000] - emit `ready_timeout` when it doesn't finish but reach the timeout
+     *   - {Boolean} [isWeakDep=false] - whether it's a weak dependency
+     * @return {Function} - a callback
+     * @example
+     * const done = app.readyCallback('mysql');
+     * mysql.ready(done);
+     */
+    readyCallback(name, opts) {
+        this.deprecate('Please use "Life Cycles" instead, see https://www.eggjs.org/advanced/loader#life-cycles');
+        return this.lifecycle.legacyReadyCallback(name, opts);
+    }
+    /**
+     * Register a function that will be called when app close.
+     *
+     * Notice:
+     * This method is now NOT recommanded directly used,
+     * Developers SHOULDN'T use app.beforeClose directly now,
+     * but in the form of class to implement beforeClose instead.
+     *
+     * @see https://eggjs.org/en/advanced/loader.html#beforeclose
+     *
+     * @param {Function} fn - the function that can be generator function or async function.
+     */
+    beforeClose(fn) {
+        this.deprecate('Please use "Life Cycles" instead, see https://www.eggjs.org/advanced/loader#life-cycles');
+        this.lifecycle.registerBeforeClose(fn);
+    }
+    /**
+     * Close all, it will close
+     * - callbacks registered by beforeClose
+     * - emit `close` event
+     * - remove add listeners
+     *
+     * If error is thrown when it's closing, the promise will reject.
+     * It will also reject after following call.
+     * @return {Promise} promise
+     * @since 1.0.0
+     */
+    async close() {
+        if (this.#closePromise)
+            return this.#closePromise;
+        this.#closePromise = this.lifecycle.close();
+        return this.#closePromise;
+    }
+    /**
+     * get router
+     * @member {Router} EggCore#router
+     * @since 1.0.0
+     */
+    get router() {
+        if (this.#router) {
+            return this.#router;
+        }
+        const router = this.#router = new Router({ sensitive: true }, this);
+        return router;
+    }
+    /**
+     * Alias to {@link Router#url}
+     * @param {String} name - Router name
+     * @param {Object} params - more parameters
+     * @return {String} url
+     */
+    url(name, params) {
+        return this.router.url(name, params);
+    }
+    head(...args) {
+        this.router.head.apply(this.router, args);
+        return this;
+    }
+    get(...args) {
+        this.router.get.apply(this.router, args);
+        return this;
+    }
+    put(...args) {
+        this.router.put.apply(this.router, args);
+        return this;
+    }
+    patch(...args) {
+        this.router.patch.apply(this.router, args);
+        return this;
+    }
+    post(...args) {
+        this.router.post.apply(this.router, args);
+        return this;
+    }
+    delete(...args) {
+        this.router.delete.apply(this.router, args);
+        return this;
+    }
+    del(...args) {
+        this.router.del.apply(this.router, args);
+        return this;
+    }
+    all(...args) {
+        this.router.all.apply(this.router, args);
+        return this;
+    }
+    resources(...args) {
+        this.router.resources.apply(this.router, args);
+        return this;
+    }
+    redirect(source, destination, status = 301) {
+        this.router.redirect(source, destination, status);
+        return this;
+    }
+    register(path, methods, middleware, opts) {
+        this.router.register(path, methods, middleware, opts);
+        return this;
+    }
+    get [EGG_LOADER]() {
+        return EggLoader;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZWdnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2VnZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxrQ0FBa0M7QUFDbEMsT0FBTyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBQ2pDLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFDckMsT0FBTyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQzVCLE9BQU8sY0FBYyxNQUFNLFlBQVksQ0FBQztBQUV4QyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFDOUMsT0FBTyxFQUF3QyxTQUFTLElBQUksTUFBTSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBRTFGLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzNELE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUUzQyxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFDM0MsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQ25ELE9BQU8sS0FBSyxNQUFNLGtCQUFrQixDQUFDO0FBRXJDLE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyxpQkFBaUIsQ0FBQyxDQUFDO0FBRTFDLE1BQU0sVUFBVSxHQUFHLE1BQU0sQ0FBQyxHQUFHLENBQUMsWUFBWSxDQUFDLENBQUM7QUF1QjVDLE1BQU0sT0FBTyxPQUFRLFNBQVEsY0FBYztJQUN6QyxPQUFPLENBQWlCO0lBQ3hCLE1BQU0sQ0FBUztJQUNmLE9BQU8sQ0FBbUI7SUFDMUIsZ0JBQWdCLENBQTBCO0lBQzFDLFVBQVUsQ0FBMEI7SUFDcEMsT0FBTyxDQUEwQjtJQUNqQyxNQUFNLENBQTJCO0lBQ2pDLFNBQVMsQ0FBWTtJQUNyQixNQUFNLENBQVk7SUFDbEIsYUFBYSxDQUFpQjtJQUM5QixPQUFPLENBQVU7SUFFakIsbUNBQW1DO0lBQzFCLGNBQWMsR0FBd0IsRUFBRSxDQUFDO0lBQ2xELHNDQUFzQztJQUM3QixVQUFVLEdBQXdCLEVBQUUsQ0FBQztJQUM5QyxzQ0FBc0M7SUFDN0IsV0FBVyxHQUErRCxFQUFFLENBQUM7SUFLdEY7Ozs7Ozs7T0FPRztJQUNILFlBQVksVUFBOEIsRUFBRTtRQUMxQyxPQUFPLENBQUMsT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLElBQUksT0FBTyxDQUFDLEdBQUcsRUFBRSxDQUFDO1FBQ25ELE9BQU8sQ0FBQyxJQUFJLEdBQUcsT0FBTyxDQUFDLElBQUksSUFBSSxhQUFhLENBQUM7UUFDN0MsTUFBTSxDQUFDLE9BQU8sT0FBTyxDQUFDLE9BQU8sS0FBSyxRQUFRLEVBQUUsZ0RBQWdELENBQUMsQ0FBQztRQUM5RixxRkFBcUY7UUFDckYseUdBQXlHO1FBQ3pHLE1BQU0sQ0FBQyxPQUFPLENBQUMsSUFBSSxLQUFLLGFBQWEsSUFBSSxPQUFPLENBQUMsSUFBSSxLQUFLLE9BQU8sRUFBRSw2Q0FBNkMsQ0FBQyxDQUFDO1FBQ2xILEtBQUssRUFBRSxDQUFDO1FBRVIsSUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLE1BQU0sRUFBRSxDQUFDO1FBQzNCOzs7O1dBSUc7UUFDSCxJQUFJLENBQUMsT0FBTyxHQUFHLE9BQXlCLENBQUM7UUFFekM7Ozs7O1dBS0c7UUFDSCxJQUFJLENBQUMsT0FBTyxHQUFHLElBQUksZ0JBQWdCLEVBQUUsQ0FBQztRQUV0Qzs7O1dBR0c7UUFDSCxJQUFJLENBQUMsZ0JBQWdCLEdBQUcsZ0JBQWdCLENBQUM7UUFFekM7Ozs7OztXQU1HO1FBQ0gsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLGdCQUFnQixDQUFDO1FBRXpDOzs7O1dBSUc7UUFDSCxJQUFJLENBQUMsVUFBVSxHQUFHLFVBQVUsQ0FBQztRQUU3Qjs7Ozs7O1dBTUc7UUFDSCxNQUFNLE9BQU8sR0FBRyxJQUFJLENBQUMsZ0JBQWdCLENBQUM7UUFFdEM7Ozs7V0FJRztRQUNILElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDO1FBRXZCLElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBSSxTQUFTLENBQUM7WUFDN0IsT0FBTyxFQUFFLE9BQU8sQ0FBQyxPQUFPO1lBQ3hCLEdBQUcsRUFBRSxJQUFJO1lBQ1QsTUFBTSxFQUFFLElBQUksQ0FBQyxPQUFPO1NBQ3JCLENBQUMsQ0FBQztRQUNILElBQUksQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDLE9BQU8sRUFBRSxHQUFHLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLEdBQUcsQ0FBQyxDQUFDLENBQUM7UUFDM0QsSUFBSSxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUMsZUFBZSxFQUFFLEVBQUUsQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxlQUFlLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQztRQUN6RSxJQUFJLENBQUMsU0FBUyxDQUFDLEVBQUUsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFlBQVksRUFBRSxJQUFJLENBQUMsQ0FBQyxDQUFDO1FBRXZFOzs7OztXQUtHO1FBQ0gsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBQ2hDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsd0NBQXdDLENBQUMsQ0FBQztRQUN6RCxJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksTUFBTSxDQUFDO1lBQ3ZCLE9BQU8sRUFBRSxPQUFPLENBQUMsT0FBTztZQUN4QixHQUFHLEVBQUUsSUFBSTtZQUNULE9BQU8sRUFBRSxPQUFPLENBQUMsT0FBTztZQUN4QixNQUFNLEVBQUUsSUFBSSxDQUFDLE9BQU87WUFDcEIsV0FBVyxFQUFFLE9BQU8sQ0FBQyxXQUFXO1lBQ2hDLEdBQUcsRUFBRSxPQUFPLENBQUMsR0FBRyxJQUFJLEVBQUU7WUFDdEIsWUFBWSxFQUFFLE9BQU87U0FDdEIsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztJQUVEOzs7T0FHRztJQUNILDZEQUE2RDtJQUM3RCxhQUFhO0lBQ2IsR0FBRyxDQUFDLEVBQWtCO1FBQ3BCLE1BQU0sQ0FBQyxFQUFFLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQyxFQUFFLCtCQUErQixDQUFDLENBQUM7UUFDekQsS0FBSyxDQUFDLDBCQUEwQixFQUFFLEVBQUUsQ0FBQyxLQUFLLElBQUksRUFBRSxDQUFDLElBQUksSUFBSSxHQUFHLENBQUMsQ0FBQztRQUM5RCxJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQztRQUN6QixPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsSUFBSSxJQUFJO1FBQ04sT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQztJQUMzQixDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxJQUFJLE9BQU87UUFDVCxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDO0lBQzlCLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsSUFBSSxTQUFTO1FBQ1gsT0FBTyxLQUFLLENBQUMsVUFBVSxDQUFDO0lBQzFCLENBQUM7SUFFRDs7Ozs7T0FLRztJQUNILElBQUksSUFBSTtRQUNOLE9BQU8sSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFDakQsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxJQUFJLE9BQU87UUFDVCxPQUFPLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFDaEQsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxJQUFJLE1BQU07UUFDUixPQUFPLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFDL0MsQ0FBQztJQUVEOzs7Ozs7Ozs7Ozs7T0FZRztJQUNILFdBQVcsQ0FBQyxLQUFVLEVBQUUsSUFBYTtRQUNuQyxJQUFJLENBQUMsU0FBUyxDQUFDLHlGQUF5RixDQUFDLENBQUM7UUFDMUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxtQkFBbUIsQ0FBQyxLQUFLLEVBQUUsSUFBSSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQ3hELENBQUM7SUFFRDs7Ozs7Ozs7OztPQVVHO0lBQ0gsS0FBSyxDQUFDLGNBQWlDO1FBQ3JDLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDOUMsQ0FBQztJQUVEOzs7Ozs7Ozs7Ozs7Ozs7OztPQWlCRztJQUNILGFBQWEsQ0FBQyxJQUFZLEVBQUUsSUFBWTtRQUN0QyxJQUFJLENBQUMsU0FBUyxDQUFDLHlGQUF5RixDQUFDLENBQUM7UUFDMUcsT0FBTyxJQUFJLENBQUMsU0FBUyxDQUFDLG1CQUFtQixDQUFDLElBQUksRUFBRSxJQUFJLENBQUMsQ0FBQztJQUN4RCxDQUFDO0lBRUQ7Ozs7Ozs7Ozs7O09BV0c7SUFDSCxXQUFXLENBQUMsRUFBTztRQUNqQixJQUFJLENBQUMsU0FBUyxDQUFDLHlGQUF5RixDQUFDLENBQUM7UUFDMUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxtQkFBbUIsQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUN6QyxDQUFDO0lBRUQ7Ozs7Ozs7Ozs7T0FVRztJQUNILEtBQUssQ0FBQyxLQUFLO1FBQ1QsSUFBSSxJQUFJLENBQUMsYUFBYTtZQUFFLE9BQU8sSUFBSSxDQUFDLGFBQWEsQ0FBQztRQUNsRCxJQUFJLENBQUMsYUFBYSxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDNUMsT0FBTyxJQUFJLENBQUMsYUFBYSxDQUFDO0lBQzVCLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsSUFBSSxNQUFNO1FBQ1IsSUFBSSxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDakIsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDO1FBQ3RCLENBQUM7UUFDRCxNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUMsT0FBTyxHQUFHLElBQUksTUFBTSxDQUFDLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ3BFLE9BQU8sTUFBTSxDQUFDO0lBQ2hCLENBQUM7SUFFRDs7Ozs7T0FLRztJQUNILEdBQUcsQ0FBQyxJQUFZLEVBQUUsTUFBWTtRQUM1QixPQUFPLElBQUksQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQztJQUN2QyxDQUFDO0lBT0QsSUFBSSxDQUFDLEdBQUcsSUFBUztRQUNmLElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsTUFBTSxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQzFDLE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztJQVNELEdBQUcsQ0FBQyxHQUFHLElBQVM7UUFDZCxJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxJQUFJLENBQUMsQ0FBQztRQUN6QyxPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFHRCxHQUFHLENBQUMsR0FBRyxJQUFTO1FBQ2QsSUFBSSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDekMsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBR0QsS0FBSyxDQUFDLEdBQUcsSUFBUztRQUNoQixJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxJQUFJLENBQUMsQ0FBQztRQUMzQyxPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFHRCxJQUFJLENBQUMsR0FBRyxJQUFTO1FBQ2YsSUFBSSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDMUMsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBR0QsTUFBTSxDQUFDLEdBQUcsSUFBUztRQUNqQixJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxJQUFJLENBQUMsQ0FBQztRQUM1QyxPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFHRCxHQUFHLENBQUMsR0FBRyxJQUFTO1FBQ2QsSUFBSSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDekMsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBSUQsR0FBRyxDQUFDLEdBQUcsSUFBUztRQUNkLElBQUksQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsTUFBTSxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ3pDLE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztJQU1ELFNBQVMsQ0FBQyxHQUFHLElBQVM7UUFDcEIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDL0MsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBRUQsUUFBUSxDQUFDLE1BQWMsRUFBRSxXQUFtQixFQUFFLFNBQWlCLEdBQUc7UUFDaEUsSUFBSSxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsTUFBTSxFQUFFLFdBQVcsRUFBRSxNQUFNLENBQUMsQ0FBQztRQUNsRCxPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFFRCxRQUFRLENBQUMsSUFBMkMsRUFDbEQsT0FBaUIsRUFDakIsVUFBNkMsRUFDN0MsSUFBc0I7UUFDdEIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsSUFBSSxFQUFFLE9BQU8sRUFBRSxVQUFVLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDdEQsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBRUQsSUFBSSxDQUFDLFVBQVUsQ0FBQztRQUNkLE9BQU8sU0FBUyxDQUFDO0lBQ25CLENBQUM7Q0FDRiJ9

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+import utils from './utils/index.js';
+export * from './egg.js';
+export * from './loader/egg_loader.js';
+export * from './base_context_class.js';
+export { utils };

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+import utils from './utils/index.js';
+export * from './egg.js';
+export * from './loader/egg_loader.js';
+export * from './base_context_class.js';
+export { utils };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE1BQU0sa0JBQWtCLENBQUM7QUFFckMsY0FBYyxVQUFVLENBQUM7QUFDekIsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLE9BQU8sRUFBRSxLQUFLLEVBQUUsQ0FBQyJ9

package/dist/esm/lifecycle.d.ts

@@ -0,0 +1,75 @@
+/// <reference types="node" resolution-mode="require"/>
+import { EventEmitter } from 'node:events';
+import type { ReadyFunctionArg } from 'get-ready';
+import { Ready } from 'ready-callback';
+import { EggConsoleLogger } from 'egg-logger';
+import type { Fun } from './utils/index.js';
+import type { EggCore } from './egg.js';
+export interface ILifecycleBoot {
+    fullPath?: string;
+    /**
+     * Ready to call configDidLoad,
+     * Config, plugin files are referred,
+     * this is the last chance to modify the config.
+     */
+    configWillLoad?(): void;
+    /**
+     * Config, plugin files have loaded
+     */
+    configDidLoad?(): void;
+    /**
+     * All files have loaded, start plugin here
+     */
+    didLoad?(): Promise<void>;
+    /**
+     * All plugins have started, can do some thing before app ready
+     */
+    willReady?(): Promise<void>;
+    /**
+     * Worker is ready, can do some things,
+     * don't need to block the app boot
+     */
+    didReady?(err?: Error): Promise<void>;
+    /**
+     * Server is listening
+     */
+    serverDidReady?(): Promise<void>;
+    /**
+     * Do some thing before app close
+     */
+    beforeClose?(): Promise<void>;
+}
+export type BootImplClass<T = object> = (new (...args: any[]) => T) & ILifecycleBoot;
+export interface LifecycleOptions {
+    baseDir: string;
+    app: EggCore;
+    logger: EggConsoleLogger;
+}
+export declare class Lifecycle extends EventEmitter {
+    #private;
+    loadReady: Ready;
+    bootReady: Ready;
+    options: LifecycleOptions;
+    readyTimeout: number;
+    constructor(options: Partial<LifecycleOptions>);
+    ready(arg?: ReadyFunctionArg): Promise<void> | undefined;
+    get app(): EggCore;
+    get logger(): EggConsoleLogger<import("egg-logger").LoggerOptions>;
+    get timing(): import("./utils/timing.js").Timing;
+    legacyReadyCallback(name: string, opt?: object): (...args: any[]) => void;
+    addBootHook(bootHootOrBootClass: BootImplClass | ILifecycleBoot): void;
+    addFunctionAsBootHook<T = EggCore>(hook: (app: T) => void): void;
+    /**
+     * init boots and trigger config did config
+     */
+    init(): void;
+    registerBeforeStart(scope: Fun, name: string): void;
+    registerBeforeClose(fn: Fun): void;
+    close(): Promise<void>;
+    triggerConfigWillLoad(): void;
+    triggerConfigDidLoad(): void;
+    triggerDidLoad(): void;
+    triggerWillReady(): void;
+    triggerDidReady(err?: Error): Promise<void>;
+    triggerServerDidReady(): Promise<void>;
+}