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

package/dist/loader/file_loader.d.ts

@@ -0,0 +1,101 @@
+import { type Fun } from '../utils/index.ts';
+export declare const FULLPATH: unique symbol;
+export declare const EXPORTS: unique symbol;
+export declare const CaseStyle: {
+    readonly camel: "camel";
+    readonly lower: "lower";
+    readonly upper: "upper";
+};
+export type CaseStyle = (typeof CaseStyle)[keyof typeof CaseStyle];
+export type CaseStyleFunction = (filepath: string) => string[];
+export type FileLoaderInitializer = (exports: unknown, options: {
+    path: string;
+    pathName: string;
+}) => unknown;
+export type FileLoaderFilter = (exports: unknown) => boolean;
+export interface FileLoaderOptions {
+    /** directories to be loaded */
+    directory: string | string[];
+    /** attach the target object from loaded files */
+    target: Record<string, any>;
+    /** match the files when load, support glob, default to all js files */
+    match?: string | string[];
+    /** ignore the files when load, support glob */
+    ignore?: string | string[];
+    /** custom file exports, receive two parameters, first is the inject object(if not js file, will be content buffer), second is an `options` object that contain `path` */
+    initializer?: FileLoaderInitializer;
+    /** determine whether invoke when exports is function */
+    call?: boolean;
+    /** determine whether override the property when get the same name */
+    override?: boolean;
+    /** an object that be the argument when invoke the function */
+    inject?: Record<string, any>;
+    /** a function that filter the exports which can be loaded */
+    filter?: FileLoaderFilter;
+    /** set property's case when converting a filepath to property list. */
+    caseStyle?: CaseStyle | CaseStyleFunction;
+    lowercaseFirst?: boolean;
+}
+export interface FileLoaderParseItem {
+    fullpath: string;
+    properties: string[];
+    exports: object | Fun;
+}
+/**
+ * Load files from directory to target object.
+ * @since 1.0.0
+ */
+export declare class FileLoader {
+    static get FULLPATH(): symbol;
+    static get EXPORTS(): symbol;
+    readonly options: FileLoaderOptions & Required<Pick<FileLoaderOptions, 'caseStyle'>>;
+    /**
+     * @class
+     * @param {Object} options - options
+     * @param {String|Array} options.directory - directories to be loaded
+     * @param {Object} options.target - attach the target object from loaded files
+     * @param {String} options.match - match the files when load, support glob, default to all js files
+     * @param {String} options.ignore - ignore the files when load, support glob
+     * @param {Function} options.initializer - custom file exports, receive two parameters, first is the inject object(if not js file, will be content buffer), second is an `options` object that contain `path`
+     * @param {Boolean} options.call - determine whether invoke when exports is function
+     * @param {Boolean} options.override - determine whether override the property when get the same name
+     * @param {Object} options.inject - an object that be the argument when invoke the function
+     * @param {Function} options.filter - a function that filter the exports which can be loaded
+     * @param {String|Function} options.caseStyle - set property's case when converting a filepath to property list.
+     */
+    constructor(options: FileLoaderOptions);
+    /**
+     * attach items to target object. Mapping the directory to properties.
+     * `app/controller/group/repository.js` => `target.group.repository`
+     * @returns {Object} target
+     * @since 1.0.0
+     */
+    load(): Promise<object>;
+    /**
+     * Parse files from given directories, then return an items list, each item contains properties and exports.
+     *
+     * For example, parse `app/controller/group/repository.js`
+     *
+     * ```
+     * module.exports = app => {
+     *   return class RepositoryController extends app.Controller {};
+     * }
+     * ```
+     *
+     * It returns a item
+     *
+     * ```
+     * {
+     *   properties: [ 'group', 'repository' ],
+     *   exports: app => { ... },
+     * }
+     * ```
+     *
+     * `Properties` is an array that contains the directory of a filepath.
+     *
+     * `Exports` depends on type, if exports is a function, it will be called. if initializer is specified, it will be called with exports for customizing.
+     * @returns {Array} items
+     * @since 1.0.0
+     */
+    protected parse(): Promise<FileLoaderParseItem[]>;
+}

package/dist/loader/file_loader.js

@@ -0,0 +1,249 @@
+import assert from 'node:assert';
+import fs from 'node:fs';
+import { debuglog } from 'node:util';
+import path from 'node:path';
+import globby from 'globby';
+import { isClass, isGeneratorFunction, isAsyncFunction, isPrimitive } from 'is-type-of';
+import { isSupportTypeScript } from '@eggjs/utils';
+import utils, {} from "../utils/index.js";
+const debug = debuglog('egg/core/file_loader');
+export const FULLPATH = Symbol('EGG_LOADER_ITEM_FULLPATH');
+export const EXPORTS = Symbol('EGG_LOADER_ITEM_EXPORTS');
+export const CaseStyle = {
+    camel: 'camel',
+    lower: 'lower',
+    upper: 'upper',
+};
+/**
+ * Load files from directory to target object.
+ * @since 1.0.0
+ */
+export class FileLoader {
+    static get FULLPATH() {
+        return FULLPATH;
+    }
+    static get EXPORTS() {
+        return EXPORTS;
+    }
+    options;
+    /**
+     * @class
+     * @param {Object} options - options
+     * @param {String|Array} options.directory - directories to be loaded
+     * @param {Object} options.target - attach the target object from loaded files
+     * @param {String} options.match - match the files when load, support glob, default to all js files
+     * @param {String} options.ignore - ignore the files when load, support glob
+     * @param {Function} options.initializer - custom file exports, receive two parameters, first is the inject object(if not js file, will be content buffer), second is an `options` object that contain `path`
+     * @param {Boolean} options.call - determine whether invoke when exports is function
+     * @param {Boolean} options.override - determine whether override the property when get the same name
+     * @param {Object} options.inject - an object that be the argument when invoke the function
+     * @param {Function} options.filter - a function that filter the exports which can be loaded
+     * @param {String|Function} options.caseStyle - set property's case when converting a filepath to property list.
+     */
+    constructor(options) {
+        assert(options.directory, 'options.directory is required');
+        assert(options.target, 'options.target is required');
+        this.options = {
+            caseStyle: CaseStyle.camel,
+            call: true,
+            override: false,
+            ...options,
+        };
+        // compatible old options _lowercaseFirst_
+        if (this.options.lowercaseFirst === true) {
+            utils.deprecated('lowercaseFirst is deprecated, use caseStyle instead');
+            this.options.caseStyle = CaseStyle.lower;
+        }
+    }
+    /**
+     * attach items to target object. Mapping the directory to properties.
+     * `app/controller/group/repository.js` => `target.group.repository`
+     * @returns {Object} target
+     * @since 1.0.0
+     */
+    async load() {
+        const items = await this.parse();
+        const target = this.options.target;
+        for (const item of items) {
+            debug('[load] loading item: fullpath: %s, properties: %o', item.fullpath, item.properties);
+            // item { properties: [ 'a', 'b', 'c'], exports }
+            // => target.a.b.c = exports
+            item.properties.reduce((target, property, index) => {
+                let obj;
+                const properties = item.properties.slice(0, index + 1).join('.');
+                if (index === item.properties.length - 1) {
+                    if (property in target && !this.options.override) {
+                        throw new Error(`can't overwrite property '${properties}' from ${target[property][FULLPATH]} by ${item.fullpath}`);
+                    }
+                    obj = item.exports;
+                    if (obj && !isPrimitive(obj)) {
+                        Reflect.set(obj, FULLPATH, item.fullpath);
+                        Reflect.set(obj, EXPORTS, true);
+                    }
+                }
+                else {
+                    obj = target[property] || {};
+                }
+                target[property] = obj;
+                if (debug.enabled) {
+                    debug('[load] loaded item properties: %o => keys: %j, index: %d', properties, Object.keys(obj), index);
+                }
+                return obj;
+            }, target);
+        }
+        return target;
+    }
+    /**
+     * Parse files from given directories, then return an items list, each item contains properties and exports.
+     *
+     * For example, parse `app/controller/group/repository.js`
+     *
+     * ```
+     * module.exports = app => {
+     *   return class RepositoryController extends app.Controller {};
+     * }
+     * ```
+     *
+     * It returns a item
+     *
+     * ```
+     * {
+     *   properties: [ 'group', 'repository' ],
+     *   exports: app => { ... },
+     * }
+     * ```
+     *
+     * `Properties` is an array that contains the directory of a filepath.
+     *
+     * `Exports` depends on type, if exports is a function, it will be called. if initializer is specified, it will be called with exports for customizing.
+     * @returns {Array} items
+     * @since 1.0.0
+     */
+    async parse() {
+        let files = this.options.match;
+        if (files) {
+            files = Array.isArray(files) ? files : [files];
+        }
+        else {
+            files = isSupportTypeScript() ? ['**/*.(js|ts)', '!**/*.d.ts'] : ['**/*.js'];
+        }
+        let ignore = this.options.ignore;
+        if (ignore) {
+            ignore = Array.isArray(ignore) ? ignore : [ignore];
+            ignore = ignore.filter(f => !!f).map(f => '!' + f);
+            files = files.concat(ignore);
+        }
+        let directories = this.options.directory;
+        if (!Array.isArray(directories)) {
+            directories = [directories];
+        }
+        const filter = typeof this.options.filter === 'function' ? this.options.filter : null;
+        const items = [];
+        debug('[parse] parsing directories: %j', directories);
+        for (const directory of directories) {
+            const filepaths = globby.sync(files, { cwd: directory });
+            debug('[parse] globby files: %o, cwd: %o => %o', files, directory, filepaths);
+            for (const filepath of filepaths) {
+                const fullpath = path.join(directory, filepath);
+                if (!fs.statSync(fullpath).isFile())
+                    continue;
+                if (filepath.endsWith('.js')) {
+                    const filepathTs = filepath.replace(/\.js$/, '.ts');
+                    if (filepaths.includes(filepathTs)) {
+                        debug('[parse] ignore %s, because %s exists', fullpath, filepathTs);
+                        continue;
+                    }
+                }
+                // get properties
+                // app/service/foo/bar.js => [ 'foo', 'bar' ]
+                const properties = getProperties(filepath, this.options.caseStyle);
+                // app/service/foo/bar.js => service.foo.bar
+                const pathName = directory.split(/[/\\]/).slice(-1) + '.' + properties.join('.');
+                // get exports from the file
+                const exports = await getExports(fullpath, this.options, pathName);
+                // ignore exports when it's null or false returned by filter function
+                if (exports === null || exports === undefined || (filter && filter(exports) === false)) {
+                    continue;
+                }
+                // set properties of class
+                if (isClass(exports)) {
+                    exports.prototype.pathName = pathName;
+                    exports.prototype.fullPath = fullpath;
+                }
+                items.push({ fullpath, properties, exports });
+                debug('[parse] parse %s, properties %j, exports %o', fullpath, properties, exports);
+            }
+        }
+        return items;
+    }
+}
+// convert file path to an array of properties
+// a/b/c.js => ['a', 'b', 'c']
+function getProperties(filepath, caseStyle) {
+    // if caseStyle is function, return the result of function
+    if (typeof caseStyle === 'function') {
+        const result = caseStyle(filepath);
+        assert(Array.isArray(result), `caseStyle expect an array, but got ${JSON.stringify(result)}`);
+        return result;
+    }
+    // use default camelize
+    return defaultCamelize(filepath, caseStyle);
+}
+// Get exports from filepath
+// If exports is null/undefined, it will be ignored
+async function getExports(fullpath, options, pathName) {
+    let exports = await utils.loadFile(fullpath);
+    // process exports as you like
+    if (options.initializer) {
+        exports = options.initializer(exports, { path: fullpath, pathName });
+        debug('[getExports] after initializer => %o', exports);
+    }
+    if (isGeneratorFunction(exports)) {
+        throw new TypeError(`Support for generators was removed, fullpath: ${fullpath}`);
+    }
+    // return exports when it's a class or async function
+    //
+    // module.exports = class Service {};
+    // or
+    // module.exports = async function() {}
+    if (isClass(exports) || isAsyncFunction(exports)) {
+        return exports;
+    }
+    // return exports after call when it's a function
+    //
+    // module.exports = function(app) {
+    //   return {};
+    // }
+    if (options.call && typeof exports === 'function') {
+        exports = exports(options.inject);
+        if (exports !== null && exports !== undefined) {
+            return exports;
+        }
+    }
+    // return exports what is
+    return exports;
+}
+function defaultCamelize(filepath, caseStyle) {
+    const properties = filepath.slice(0, filepath.lastIndexOf('.')).split('/');
+    return properties.map(property => {
+        if (!/^[a-z][a-z0-9_-]*$/i.test(property)) {
+            throw new Error(`${property} is not match 'a-z0-9_-' in ${filepath}`);
+        }
+        // use default camelize, will capitalize the first letter
+        // foo_bar.js > FooBar
+        // fooBar.js  > FooBar
+        // FooBar.js  > FooBar
+        // FooBar.js  > FooBar
+        // FooBar.js  > fooBar (if lowercaseFirst is true)
+        property = property.replaceAll(/[_-][a-z]/gi, s => s.slice(1).toUpperCase());
+        let first = property[0];
+        if (caseStyle === CaseStyle.lower) {
+            first = first.toLowerCase();
+        }
+        else if (caseStyle === CaseStyle.upper) {
+            first = first.toUpperCase();
+        }
+        return first + property.slice(1);
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmlsZV9sb2FkZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9hZGVyL2ZpbGVfbG9hZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sTUFBTSxNQUFNLGFBQWEsQ0FBQztBQUNqQyxPQUFPLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDekIsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUNyQyxPQUFPLElBQUksTUFBTSxXQUFXLENBQUM7QUFFN0IsT0FBTyxNQUFNLE1BQU0sUUFBUSxDQUFDO0FBQzVCLE9BQU8sRUFBRSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsZUFBZSxFQUFFLFdBQVcsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUN4RixPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFFbkQsT0FBTyxLQUFLLEVBQUUsRUFBWSxNQUFNLG1CQUFtQixDQUFDO0FBRXBELE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyxzQkFBc0IsQ0FBQyxDQUFDO0FBRS9DLE1BQU0sQ0FBQyxNQUFNLFFBQVEsR0FBRyxNQUFNLENBQUMsMEJBQTBCLENBQUMsQ0FBQztBQUMzRCxNQUFNLENBQUMsTUFBTSxPQUFPLEdBQUcsTUFBTSxDQUFDLHlCQUF5QixDQUFDLENBQUM7QUFFekQsTUFBTSxDQUFDLE1BQU0sU0FBUyxHQUFHO0lBQ3ZCLEtBQUssRUFBRSxPQUFPO0lBQ2QsS0FBSyxFQUFFLE9BQU87SUFDZCxLQUFLLEVBQUUsT0FBTztDQUNOLENBQUM7QUF1Q1g7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLFVBQVU7SUFDckIsTUFBTSxLQUFLLFFBQVE7UUFDakIsT0FBTyxRQUFRLENBQUM7SUFDbEIsQ0FBQztJQUVELE1BQU0sS0FBSyxPQUFPO1FBQ2hCLE9BQU8sT0FBTyxDQUFDO0lBQ2pCLENBQUM7SUFFUSxPQUFPLENBQXFFO0lBRXJGOzs7Ozs7Ozs7Ozs7O09BYUc7SUFDSCxZQUFZLE9B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

package/dist/singleton.d.ts

@@ -0,0 +1,29 @@
+import type { EggCore } from './egg.ts';
+export type SingletonCreateMethod = (config: Record<string, any>, app: EggCore, clientName: string) => unknown | Promise<unknown>;
+export interface SingletonOptions {
+    name: string;
+    app: EggCore;
+    create: SingletonCreateMethod;
+}
+export declare class Singleton<T = any> {
+    #private;
+    readonly clients: Map<string, T>;
+    readonly app: EggCore;
+    readonly create: SingletonCreateMethod;
+    readonly name: string;
+    readonly options: Record<string, any>;
+    constructor(options: SingletonOptions);
+    init(): void | Promise<void>;
+    initSync(): void;
+    initAsync(): Promise<void>;
+    /**
+     * @deprecated please use `getSingletonInstance(id)` instead
+     */
+    get(id: string): T;
+    /**
+     * Get singleton instance by id
+     */
+    getSingletonInstance(id: string): T;
+    createInstance(config: Record<string, any>, clientName: string): T;
+    createInstanceAsync(config: Record<string, any>, clientName: string): Promise<T>;
+}

package/dist/singleton.js

@@ -0,0 +1,117 @@
+import assert from 'node:assert';
+import { isAsyncFunction } from 'is-type-of';
+export class Singleton {
+    clients = new Map();
+    app;
+    create;
+    name;
+    options;
+    constructor(options) {
+        assert(options.name, '[egg/core/singleton] Singleton#constructor options.name is required');
+        assert(options.app, '[egg/core/singleton] Singleton#constructor options.app is required');
+        assert(options.create, '[egg/core/singleton] Singleton#constructor options.create is required');
+        assert(!(options.name in options.app), `[egg/core/singleton] ${options.name} is already exists in app`);
+        this.app = options.app;
+        this.name = options.name;
+        this.create = options.create;
+        this.options = options.app.config[this.name] ?? {};
+    }
+    init() {
+        return isAsyncFunction(this.create) ? this.initAsync() : this.initSync();
+    }
+    initSync() {
+        const options = this.options;
+        assert(!(options.client && options.clients), `[egg/core/singleton] ${this.name} can not set options.client and options.clients both`);
+        // alias app[name] as client, but still support createInstance method
+        if (options.client) {
+            const client = this.createInstance(options.client, options.name);
+            this.#setClientToApp(client);
+            this.#extendDynamicMethods(client);
+            return;
+        }
+        // multi client, use app[name].getSingletonInstance(id)
+        if (options.clients) {
+            for (const id of Object.keys(options.clients)) {
+                const client = this.createInstance(options.clients[id], id);
+                this.clients.set(id, client);
+            }
+            this.#setClientToApp(this);
+            return;
+        }
+        // no config.clients and config.client
+        this.#setClientToApp(this);
+    }
+    async initAsync() {
+        const options = this.options;
+        assert(!(options.client && options.clients), `[egg/core/singleton] ${this.name} can not set options.client and options.clients both`);
+        // alias app[name] as client, but still support createInstance method
+        if (options.client) {
+            const client = await this.createInstanceAsync(options.client, options.name);
+            this.#setClientToApp(client);
+            this.#extendDynamicMethods(client);
+            return;
+        }
+        // multi client, use app[name].getInstance(id)
+        if (options.clients) {
+            await Promise.all(Object.keys(options.clients).map((id) => {
+                return this.createInstanceAsync(options.clients[id], id).then(client => this.clients.set(id, client));
+            }));
+            this.#setClientToApp(this);
+            return;
+        }
+        // no config.clients and config.client
+        this.#setClientToApp(this);
+    }
+    #setClientToApp(client) {
+        Reflect.set(this.app, this.name, client);
+    }
+    /**
+     * @deprecated please use `getSingletonInstance(id)` instead
+     */
+    get(id) {
+        return this.clients.get(id);
+    }
+    /**
+     * Get singleton instance by id
+     */
+    getSingletonInstance(id) {
+        return this.clients.get(id);
+    }
+    createInstance(config, clientName) {
+        // async creator only support createInstanceAsync
+        assert(!isAsyncFunction(this.create), `[egg/core/singleton] ${this.name} only support asynchronous creation, please use createInstanceAsync`);
+        // options.default will be merge in to options.clients[id]
+        config = {
+            ...this.options.default,
+            ...config,
+        };
+        return this.create(config, this.app, clientName);
+    }
+    async createInstanceAsync(config, clientName) {
+        // options.default will be merge in to options.clients[id]
+        config = {
+            ...this.options.default,
+            ...config,
+        };
+        return (await this.create(config, this.app, clientName));
+    }
+    #extendDynamicMethods(client) {
+        assert(!client.createInstance, '[egg/core/singleton] singleton instance should not have createInstance method');
+        assert(!client.createInstanceAsync, '[egg/core/singleton] singleton instance should not have createInstanceAsync method');
+        try {
+            let extendable = client;
+            // Object.preventExtensions() or Object.freeze()
+            if (!Object.isExtensible(client) || Object.isFrozen(client)) {
+                // eslint-disable-next-line no-proto
+                extendable = client.__proto__ || client;
+            }
+            extendable.createInstance = this.createInstance.bind(this);
+            extendable.createInstanceAsync = this.createInstanceAsync.bind(this);
+        }
+        catch (err) {
+            this.app.coreLogger.warn('[egg/core/singleton] %s dynamic create is disabled because of client is un-extendable', this.name);
+            this.app.coreLogger.warn(err);
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2luZ2xldG9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3NpbmdsZXRvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLE1BQU0sTUFBTSxhQUFhLENBQUM7QUFFakMsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLFlBQVksQ0FBQztBQWdCN0MsTUFBTSxPQUFPLFNBQVM7SUFDWCxPQUFPLEdBQUcsSUFBSSxHQUFHLEVBQWEsQ0FBQztJQUMvQixHQUFHLENBQVU7SUFDYixNQUFNLENBQXdCO0lBQzlCLElBQUksQ0FBUztJQUNiLE9BQU8sQ0FBc0I7SUFFdEMsWUFBWSxPQUF5QjtRQUNuQyxNQUFNLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxxRUFBcUUsQ0FBQyxDQUFDO1FBQzVGLE1BQU0sQ0FBQyxPQUFPLENBQUMsR0FBRyxFQUFFLG9FQUFvRSxDQUFDLENBQUM7UUFDMUYsTUFBTSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsdUVBQXVFLENBQUMsQ0FBQztRQUNoRyxNQUFNLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxJQUFJLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxFQUFFLHdCQUF3QixPQUFPLENBQUMsSUFBSSwyQkFBMkIsQ0FBQyxDQUFDO1FBQ3hHLElBQUksQ0FBQyxHQUFHLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQztRQUN2QixJQUFJLENBQUMsSUFBSSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUM7UUFDekIsSUFBSSxDQUFDLE1BQU0sR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDO1FBQzdCLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUNyRCxDQUFDO0lBRUQsSUFBSTtRQUNGLE9BQU8sZUFBZSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFD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

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+export interface EggAppInfo {
+    /** package.json */
+    pkg: Record<string, any>;
+    /** the application name from package.json */
+    name: string;
+    /** current directory of application */
+    baseDir: string;
+    /** equals to serverEnv */
+    env: string;
+    /** equals to serverScope */
+    scope: string;
+    /** home directory of the OS */
+    HOME: string;
+    /** baseDir when local and unittest, HOME when other environment */
+    root: string;
+}
+export interface EggPluginInfo {
+    /** the plugin name, it can be used in `dep` */
+    name: string;
+    /** the package name of plugin */
+    package?: string;
+    version?: string;
+    /** whether enabled */
+    enable: boolean;
+    implicitEnable?: boolean;
+    /** the directory of the plugin package */
+    path?: string;
+    /** the dependent plugins, you can use the plugin name */
+    dependencies: string[];
+    /** the optional dependent plugins. */
+    optionalDependencies: string[];
+    dependents?: string[];
+    /** specify the serverEnv that only enable the plugin in it */
+    env: string[];
+    /** the file plugin config in. */
+    from: string;
+}
+export interface CustomLoaderConfigItem {
+    /** the directory of the custom loader */
+    directory: string;
+    /** the inject object, it can be app or ctx */
+    inject: string;
+    /** whether load unit files */
+    loadunit?: boolean;
+}
+export interface EggAppConfig extends Record<string, any> {
+    coreMiddleware: string[];
+    middleware: string[];
+    customLoader?: Record<string, CustomLoaderConfigItem>;
+    controller?: {
+        supportParams?: boolean;
+    };
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist/utils/index.d.ts

@@ -0,0 +1,17 @@
+export type Fun = (...args: unknown[]) => unknown;
+declare function getCalleeFromStack(withLine?: boolean, stackIndex?: number): string;
+declare const _default: {
+    deprecated(message: string): void;
+    extensions: any;
+    extensionNames: string[];
+    existsPath(filepath: string): Promise<boolean>;
+    loadFile(filepath: string): Promise<any>;
+    resolvePath(filepath: string, options?: {
+        paths?: string[];
+    }): string;
+    methods: string[];
+    callFn(fn: Fun, args?: unknown[], ctx?: unknown): Promise<unknown>;
+    getCalleeFromStack: typeof getCalleeFromStack;
+    getResolvedFilename(filepath: string, baseDir: string): string;
+};
+export default _default;