@eggjs/core 7.0.0-beta.20 → 7.0.0-beta.22

package/dist/lifecycle.d.ts

@@ -0,0 +1,78 @@
+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.ts';
+import type { EggCore } from './egg.ts';
+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 = ILifecycleBoot> = new (...args: any[]) => T;
+export interface LifecycleOptions {
+    baseDir: string;
+    app: EggCore;
+    logger: EggConsoleLogger;
+}
+export type FunWithFullPath = Fun & {
+    fullPath?: string;
+};
+export declare class Lifecycle extends EventEmitter {
+    #private;
+    loadReady: Ready;
+    bootReady: Ready;
+    options: LifecycleOptions;
+    readyTimeout: number;
+    constructor(options: Partial<LifecycleOptions>);
+    ready(): Promise<void>;
+    ready(flagOrFunction: ReadyFunctionArg): void;
+    get app(): EggCore;
+    get logger(): EggConsoleLogger<import("egg-logger").LoggerOptions>;
+    get timing(): import("./index.ts").Timing;
+    legacyReadyCallback(name: string, opt?: object): (...args: unknown[]) => void;
+    addBootHook(bootHootOrBootClass: BootImplClass | ILifecycleBoot): void;
+    addFunctionAsBootHook<T = EggCore>(hook: (app: T) => void, fullPath?: string): void;
+    /**
+     * init boots and trigger config did config
+     */
+    init(): void;
+    registerBeforeStart(scope: Fun, name: string): void;
+    registerBeforeClose(fn: FunWithFullPath, fullPath?: string): void;
+    close(): Promise<void>;
+    triggerConfigWillLoad(): void;
+    triggerConfigDidLoad(): void;
+    triggerDidLoad(): void;
+    triggerWillReady(): void;
+    triggerDidReady(err?: Error): Promise<void>;
+    triggerServerDidReady(): Promise<void>;
+}

package/dist/lifecycle.js

@@ -0,0 +1,306 @@
+import assert from 'node:assert';
+import { EventEmitter } from 'node:events';
+import { debuglog, format } from 'node:util';
+import { isClass } from 'is-type-of';
+import { Ready as ReadyObject } from 'get-ready';
+import { Ready } from 'ready-callback';
+import { EggConsoleLogger } from 'egg-logger';
+import utils from "./utils/index.js";
+const debug = debuglog('egg/core/lifecycle');
+export class Lifecycle extends EventEmitter {
+    #init;
+    #readyObject;
+    #bootHooks;
+    #boots;
+    #isClosed;
+    #closeFunctionSet;
+    loadReady;
+    bootReady;
+    options;
+    readyTimeout;
+    constructor(options) {
+        super();
+        options.logger = options.logger ?? new EggConsoleLogger();
+        this.options = options;
+        this.#readyObject = new ReadyObject();
+        this.#bootHooks = [];
+        this.#boots = [];
+        this.#closeFunctionSet = new Set();
+        this.#isClosed = false;
+        this.#init = false;
+        this.timing.start(`${this.options.app.type} Start`);
+        // get app timeout from env or use default timeout 10 second
+        const eggReadyTimeoutEnv = Number.parseInt(process.env.EGG_READY_TIMEOUT_ENV || '10000');
+        assert(Number.isInteger(eggReadyTimeoutEnv), `process.env.EGG_READY_TIMEOUT_ENV ${process.env.EGG_READY_TIMEOUT_ENV} should be able to parseInt.`);
+        this.readyTimeout = eggReadyTimeoutEnv;
+        this.#initReady();
+        this.on('ready_stat', data => {
+            this.logger.info('[egg/core/lifecycle:ready_stat] end ready task %s, remain %j', data.id, data.remain);
+        }).on('ready_timeout', id => {
+            this.logger.warn('[egg/core/lifecycle:ready_timeout] %s seconds later %s was still unable to finish.', this.readyTimeout / 1000, id);
+        });
+        this.ready(err => {
+            this.triggerDidReady(err);
+            debug('app ready');
+            this.timing.end(`${this.options.app.type} Start`);
+        });
+    }
+    ready(flagOrFunction) {
+        if (flagOrFunction === undefined) {
+            return this.#readyObject.ready();
+        }
+        return this.#readyObject.ready(flagOrFunction);
+    }
+    get app() {
+        return this.options.app;
+    }
+    get logger() {
+        return this.options.logger;
+    }
+    get timing() {
+        return this.app.timing;
+    }
+    legacyReadyCallback(name, opt) {
+        const timingKeyPrefix = 'readyCallback';
+        const timing = this.timing;
+        const cb = this.loadReady.readyCallback(name, opt);
+        const timingKey = `${timingKeyPrefix} in ` + utils.getResolvedFilename(name, this.app.baseDir);
+        this.timing.start(timingKey);
+        debug('register legacyReadyCallback');
+        return function legacyReadyCallback(...args) {
+            timing.end(timingKey);
+            debug('end legacyReadyCallback');
+            cb(...args);
+        };
+    }
+    addBootHook(bootHootOrBootClass) {
+        assert(this.#init === false, 'do not add hook when lifecycle has been initialized');
+        this.#bootHooks.push(bootHootOrBootClass);
+    }
+    addFunctionAsBootHook(hook, fullPath) {
+        assert(this.#init === false, 'do not add hook when lifecycle has been initialized');
+        // app.js is exported as a function
+        // call this function in configDidLoad
+        class Boot {
+            static fullPath;
+            app;
+            constructor(app) {
+                this.app = app;
+            }
+            configDidLoad() {
+                hook(this.app);
+            }
+        }
+        Boot.fullPath = fullPath;
+        this.#bootHooks.push(Boot);
+    }
+    /**
+     * init boots and trigger config did config
+     */
+    init() {
+        debug('%s init lifecycle', this.app.type);
+        assert(this.#init === false, 'lifecycle have been init');
+        this.#init = true;
+        this.#boots = this.#bootHooks.map(BootHootOrBootClass => {
+            let instance = BootHootOrBootClass;
+            if (isClass(BootHootOrBootClass)) {
+                instance = new BootHootOrBootClass(this.app);
+                if (!instance.fullPath && 'fullPath' in BootHootOrBootClass) {
+                    instance.fullPath = BootHootOrBootClass.fullPath;
+                }
+            }
+            debug('[init] add boot instance: %o', instance.fullPath);
+            return instance;
+        });
+    }
+    registerBeforeStart(scope, name) {
+        debug('%s add registerBeforeStart, name: %o', this.options.app.type, name);
+        this.#registerReadyCallback({
+            scope,
+            ready: this.loadReady,
+            timingKeyPrefix: 'Before Start',
+            scopeFullName: name,
+        });
+    }
+    registerBeforeClose(fn, fullPath) {
+        assert(typeof fn === 'function', 'argument should be function');
+        assert(this.#isClosed === false, 'app has been closed');
+        if (fullPath) {
+            fn.fullPath = fullPath;
+        }
+        this.#closeFunctionSet.add(fn);
+        debug('%s register beforeClose at %o, count: %d', this.app.type, fullPath, this.#closeFunctionSet.size);
+    }
+    async close() {
+        // close in reverse order: first created, last closed
+        const closeFns = Array.from(this.#closeFunctionSet);
+        debug('%s start trigger %d beforeClose functions', this.app.type, closeFns.length);
+        for (const fn of closeFns.reverse()) {
+            debug('%s trigger beforeClose at %o', this.app.type, fn.fullPath);
+            await utils.callFn(fn);
+            this.#closeFunctionSet.delete(fn);
+        }
+        // Be called after other close callbacks
+        this.app.emit('close');
+        this.removeAllListeners();
+        this.app.removeAllListeners();
+        this.#isClosed = true;
+        debug('%s closed', this.app.type);
+    }
+    triggerConfigWillLoad() {
+        debug('trigger configWillLoad start');
+        for (const boot of this.#boots) {
+            if (typeof boot.configWillLoad === 'function') {
+                debug('trigger configWillLoad at %o', boot.fullPath);
+                boot.configWillLoad();
+            }
+        }
+        debug('trigger configWillLoad end');
+        this.triggerConfigDidLoad();
+    }
+    triggerConfigDidLoad() {
+        debug('trigger configDidLoad start');
+        for (const boot of this.#boots) {
+            if (typeof boot.configDidLoad === 'function') {
+                debug('trigger configDidLoad at %o', boot.fullPath);
+                boot.configDidLoad();
+            }
+            // function boot hook register after configDidLoad trigger
+            if (typeof boot.beforeClose === 'function') {
+                const beforeClose = boot.beforeClose.bind(boot);
+                this.registerBeforeClose(beforeClose, boot.fullPath);
+            }
+        }
+        debug('trigger configDidLoad end');
+        this.triggerDidLoad();
+    }
+    triggerDidLoad() {
+        debug('trigger didLoad start');
+        debug('loadReady start');
+        this.loadReady.start();
+        for (const boot of this.#boots) {
+            if (typeof boot.didLoad === 'function') {
+                const didLoad = boot.didLoad.bind(boot);
+                this.#registerReadyCallback({
+                    scope: didLoad,
+                    ready: this.loadReady,
+                    timingKeyPrefix: 'Did Load',
+                    scopeFullName: boot.fullPath + ':didLoad',
+                });
+            }
+        }
+    }
+    triggerWillReady() {
+        debug('trigger willReady start');
+        debug('bootReady start');
+        this.bootReady.start();
+        for (const boot of this.#boots) {
+            if (typeof boot.willReady === 'function') {
+                const willReady = boot.willReady.bind(boot);
+                this.#registerReadyCallback({
+                    scope: willReady,
+                    ready: this.bootReady,
+                    timingKeyPrefix: 'Will Ready',
+                    scopeFullName: boot.fullPath + ':willReady',
+                });
+            }
+        }
+    }
+    triggerDidReady(err) {
+        debug('trigger didReady start');
+        return (async () => {
+            for (const boot of this.#boots) {
+                if (typeof boot.didReady === 'function') {
+                    debug('trigger didReady at %o', boot.fullPath);
+                    try {
+                        await boot.didReady(err);
+                    }
+                    catch (err) {
+                        debug('trigger didReady error at %o, error: %s', boot.fullPath, err);
+                        this.emit('error', err);
+                    }
+                }
+            }
+            debug('trigger didReady end');
+        })();
+    }
+    triggerServerDidReady() {
+        debug('trigger serverDidReady start');
+        return (async () => {
+            for (const boot of this.#boots) {
+                if (typeof boot.serverDidReady !== 'function') {
+                    continue;
+                }
+                debug('trigger serverDidReady at %o', boot.fullPath);
+                try {
+                    await boot.serverDidReady();
+                }
+                catch (err) {
+                    debug('trigger serverDidReady error at %o, error: %s', boot.fullPath, err);
+                    this.emit('error', err);
+                }
+            }
+            debug('trigger serverDidReady end');
+        })();
+    }
+    #initReady() {
+        debug('loadReady init');
+        this.loadReady = new Ready({ timeout: this.readyTimeout, lazyStart: true });
+        this.#delegateReadyEvent(this.loadReady);
+        this.loadReady.ready((err) => {
+            debug('loadReady end, err: %o', err);
+            debug('trigger didLoad end');
+            if (err) {
+                this.ready(err);
+            }
+            else {
+                this.triggerWillReady();
+            }
+        });
+        debug('bootReady init');
+        this.bootReady = new Ready({ timeout: this.readyTimeout, lazyStart: true });
+        this.#delegateReadyEvent(this.bootReady);
+        this.bootReady.ready((err) => {
+            debug('bootReady end, err: %o', err);
+            debug('trigger willReady end');
+            this.ready(err || true);
+        });
+    }
+    #delegateReadyEvent(ready) {
+        ready.once('error', (err) => ready.ready(err));
+        ready.on('ready_timeout', (id) => this.emit('ready_timeout', id));
+        ready.on('ready_stat', (data) => this.emit('ready_stat', data));
+        ready.on('error', (err) => this.emit('error', err));
+    }
+    #registerReadyCallback(args) {
+        const { scope, ready, timingKeyPrefix, scopeFullName } = args;
+        if (typeof scope !== 'function') {
+            throw new TypeError('boot only support function');
+        }
+        // get filename from stack if scopeFullName is undefined
+        const name = scopeFullName || utils.getCalleeFromStack(true, 4);
+        const timingKey = `${timingKeyPrefix} in ` + utils.getResolvedFilename(name, this.app.baseDir);
+        this.timing.start(timingKey);
+        debug('[registerReadyCallback] start name: %o', name);
+        const done = ready.readyCallback(name);
+        // ensure scope executes after load completed
+        process.nextTick(async () => {
+            try {
+                await utils.callFn(scope);
+                debug('[registerReadyCallback] end name: %o', name);
+                done();
+                this.timing.end(timingKey);
+            }
+            catch (e) {
+                let err = e;
+                // avoid non-stringify error: TypeError: Cannot convert object to primitive value
+                if (!(err instanceof Error)) {
+                    err = new Error(format('%s', err));
+                }
+                done(err);
+                this.timing.end(timingKey);
+            }
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGlmZWN5Y2xlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2xpZmVjeWNsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLE1BQU0sTUFBTSxhQUFhLENBQUM7QUFDakMsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUMzQyxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUU3QyxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQ3JDLE9BQU8sRUFBRSxLQUFLLElBQUksV0FBVyxFQUF5QixNQUFNLFdBQVcsQ0FBQztBQUN4RSxPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFDdkMsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRTlDLE9BQU8sS0FBSyxNQUFNLGtCQUFrQixDQUFDO0FBSXJDLE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyxvQkFBb0IsQ0FBQyxDQUFDO0FBc0Q3QyxNQUFNLE9BQU8sU0FBVSxTQUFRLFlBQVk7SUFDekMsS0FBSyxDQUFVO0lBQ2YsWUFBWSxDQUFjO0lBQzFCLFVBQVUsQ0FBcUM7SUFDL0MsTUFBTSxDQUFtQjtJQUN6QixTQUFTLENBQVU7SUFDbkIsaUJBQWlCLENBQXVCO0lBQ3hDLFNBQVMsQ0FBUTtJQUNqQixTQUFTLENBQVE7SUFDakIsT0FBTyxDQUFtQjtJQUMxQixZQUFZLENBQVM7SUFFckIsWUFBWSxPQUFrQztRQUM1QyxLQUFLLEVBQUUsQ0FBQztRQUNSLE9BQU8sQ0FBQyxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sSUFBSSxJQUFJLGdCQUFnQixFQUFFLENBQUM7UUFDMUQsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUEyQixDQUFDO1FBQzNDLElBQUksQ0FBQyxZQUFZLEdBQUcsSUFBSSxXQUFXLEVBQUUsQ0FBQztRQUN0QyxJQUFJLENBQUMsVUFBVSxHQUFH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

package/dist/loader/context_loader.d.ts

@@ -0,0 +1,35 @@
+import { FileLoader, type FileLoaderOptions } from './file_loader.ts';
+import type { Context } from '../egg.ts';
+export interface ClassLoaderOptions {
+    ctx: Context;
+    properties: any;
+}
+export declare class ClassLoader {
+    #private;
+    readonly _cache: Map<any, any>;
+    _ctx: Context;
+    constructor(options: ClassLoaderOptions);
+}
+export interface ContextLoaderOptions extends Omit<FileLoaderOptions, 'target'> {
+    /** required inject */
+    inject: Record<string, any>;
+    /** property name defined to target */
+    property: string | symbol;
+    /** determine the field name of inject object. */
+    fieldClass?: string;
+}
+/**
+ * Same as {@link FileLoader}, but it will attach file to `inject[fieldClass]`.
+ * The exports will be lazy loaded, such as `ctx.group.repository`.
+ * @augments FileLoader
+ * @since 1.0.0
+ */
+export declare class ContextLoader extends FileLoader {
+    #private;
+    /**
+     * @class
+     * @param {Object} options - options same as {@link FileLoader}
+     * @param {String} options.fieldClass - determine the field name of inject object.
+     */
+    constructor(options: ContextLoaderOptions);
+}

package/dist/loader/context_loader.js

@@ -0,0 +1,102 @@
+import assert from 'node:assert';
+import { isClass, isPrimitive } from 'is-type-of';
+import { FileLoader, EXPORTS } from "./file_loader.js";
+const CLASS_LOADER = Symbol('classLoader');
+export class ClassLoader {
+    _cache = new Map();
+    _ctx;
+    constructor(options) {
+        assert(options.ctx, 'options.ctx is required');
+        const properties = options.properties;
+        this._ctx = options.ctx;
+        for (const property in properties) {
+            this.#defineProperty(property, properties[property]);
+        }
+    }
+    #defineProperty(property, values) {
+        Object.defineProperty(this, property, {
+            get() {
+                let instance = this._cache.get(property);
+                if (!instance) {
+                    instance = getInstance(values, this._ctx);
+                    this._cache.set(property, instance);
+                }
+                return instance;
+            },
+        });
+    }
+}
+/**
+ * Same as {@link FileLoader}, but it will attach file to `inject[fieldClass]`.
+ * The exports will be lazy loaded, such as `ctx.group.repository`.
+ * @augments FileLoader
+ * @since 1.0.0
+ */
+export class ContextLoader extends FileLoader {
+    #inject;
+    /**
+     * @class
+     * @param {Object} options - options same as {@link FileLoader}
+     * @param {String} options.fieldClass - determine the field name of inject object.
+     */
+    constructor(options) {
+        assert(options.property, 'options.property is required');
+        assert(options.inject, 'options.inject is required');
+        const target = {};
+        if (options.fieldClass) {
+            options.inject[options.fieldClass] = target;
+        }
+        super({
+            ...options,
+            target,
+        });
+        this.#inject = this.options.inject;
+        const app = this.#inject;
+        const property = options.property;
+        // define ctx.service
+        Object.defineProperty(app.context, property, {
+            get() {
+                // oxlint-disable-next-line unicorn/no-this-assignment, typescript/no-this-alias
+                const ctx = this;
+                // distinguish property cache,
+                // cache's lifecycle is the same with this context instance
+                // e.x. ctx.service1 and ctx.service2 have different cache
+                if (!ctx[CLASS_LOADER]) {
+                    ctx[CLASS_LOADER] = new Map();
+                }
+                const classLoader = ctx[CLASS_LOADER];
+                let instance = classLoader.get(property);
+                if (!instance) {
+                    instance = getInstance(target, ctx);
+                    classLoader.set(property, instance);
+                }
+                return instance;
+            },
+        });
+    }
+}
+function getInstance(values, ctx) {
+    // it's a directory when it has no exports
+    // then use ClassLoader
+    const Class = values[EXPORTS] ? values : null;
+    let instance;
+    if (Class) {
+        if (isClass(Class)) {
+            instance = new Class(ctx);
+        }
+        else {
+            // it's just an object
+            instance = Class;
+        }
+        // Can't set property to primitive, so check again
+        // e.x. module.exports = 1;
+    }
+    else if (isPrimitive(values)) {
+        instance = values;
+    }
+    else {
+        instance = new ClassLoader({ ctx, properties: values });
+    }
+    return instance;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udGV4dF9sb2FkZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9hZGVyL2NvbnRleHRfbG9hZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sTUFBTSxNQUFNLGFBQWEsQ0FBQztBQUVqQyxPQUFPLEVBQUUsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUVsRCxPQUFPLEVBQUUsVUFBVSxFQUFFLE9BQU8sRUFBMEIsTUFBTSxrQkFBa0IsQ0FBQztBQUcvRSxNQUFNLFlBQVksR0FBRyxNQUFNLENBQUMsYUFBYSxDQUFDLENBQUM7QUFPM0MsTUFBTSxPQUFPLFdBQVc7SUFDYixNQUFNLEdBQUcsSUFBSSxHQUFHLEVBQUUsQ0FBQztJQUM1QixJQUFJLENBQVU7SUFFZCxZQUFZLE9BQTJCO1FBQ3JDLE1BQU0sQ0FBQyxPQUFPLENBQUMsR0FBRyxFQUFFLHlCQUF5QixDQUFDLENBQUM7UUFDL0MsTUFBTSxVQUFVLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQztRQUN0QyxJQUFJLENBQUMsSUFBSSxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUM7UUFFeEIsS0FBSyxNQUFNLFFBQVEsSUFBSSxVQUFVLEVBQUUsQ0FBQztZQUNsQyxJQUFJLENBQUMsZUFBZSxDQUFDLFFBQVEsRUFBRSxVQUFVLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQztRQUN2RCxDQUFDO0lBQ0gsQ0FBQztJQUVELGVBQWUsQ0FBQyxRQUFnQixFQUFFLE1BQVc7UUFDM0MsTUFBTSxDQUFDLGNBQWMsQ0FBQyxJQUFJLEVBQUUsUUFBUSxFQUFFO1lBQ3BDLEdBQUc7Z0JBQ0QsSUFBSSxRQUFRLEdBQVEsSUFBSSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLENBQUM7Z0JBQzlDLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztvQkFDZCxRQUFRLEdBQUcsV0FBVyxDQUFDLE1BQU0sRUFBRSxJQUFJLENBQUMsSUFB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