@eggjs/core 6.0.0-beta.0

package/dist/esm/utils/timing.js

@@ -0,0 +1,93 @@
+import { EOL } from 'node:os';
+import { debuglog } from 'node:util';
+import assert from 'node:assert';
+const debug = debuglog('@eggjs/core:utils:timing');
+export class Timing {
+    #enable;
+    #startTime;
+    #map;
+    #list;
+    constructor() {
+        this.#enable = true;
+        this.#startTime = null;
+        this.#map = new Map();
+        this.#list = [];
+        this.init();
+    }
+    init() {
+        // process start time
+        this.start('Process Start', Date.now() - Math.floor(process.uptime() * 1000));
+        this.end('Process Start');
+        if ('scriptStartTime' in process && typeof process.scriptStartTime === 'number') {
+            // js script start execute time
+            this.start('Script Start', process.scriptStartTime);
+            this.end('Script Start');
+        }
+    }
+    start(name, start) {
+        if (!name || !this.#enable)
+            return;
+        if (this.#map.has(name)) {
+            this.end(name);
+        }
+        start = start || Date.now();
+        if (this.#startTime === null) {
+            this.#startTime = start;
+        }
+        const item = {
+            name,
+            start,
+            pid: process.pid,
+            index: this.#list.length,
+        };
+        this.#map.set(name, item);
+        this.#list.push(item);
+        debug('start %j', item);
+        return item;
+    }
+    end(name) {
+        if (!name || !this.#enable)
+            return;
+        assert(this.#map.has(name), `should run timing.start('${name}') first`);
+        const item = this.#map.get(name);
+        item.end = Date.now();
+        item.duration = item.end - item.start;
+        debug('end %j', item);
+        return item;
+    }
+    enable() {
+        this.#enable = true;
+    }
+    disable() {
+        this.#enable = false;
+    }
+    clear() {
+        this.#map.clear();
+        this.#list = [];
+    }
+    toJSON() {
+        return this.#list;
+    }
+    itemToString(timelineEnd, item, times) {
+        const isEnd = typeof item.duration === 'number';
+        const duration = isEnd ? item.duration : timelineEnd - item.start;
+        const offset = item.start - this.#startTime;
+        const status = `${duration}ms${isEnd ? '' : ' NOT_END'}`;
+        const timespan = Math.floor(Number((offset * times).toFixed(6)));
+        let timeline = Math.floor(Number((duration * times).toFixed(6)));
+        timeline = timeline > 0 ? timeline : 1; // make sure there is at least one unit
+        const message = `#${item.index} ${item.name}`;
+        return ' '.repeat(timespan) + '▇'.repeat(timeline) + ` [${status}] - ${message}`;
+    }
+    toString(prefix = 'egg start timeline:', width = 50) {
+        const timelineEnd = Date.now();
+        const timelineDuration = timelineEnd - this.#startTime;
+        let times = 1;
+        if (timelineDuration > width) {
+            times = width / timelineDuration;
+        }
+        // follow https://github.com/node-modules/time-profile/blob/master/lib/profiler.js#L88
+        return prefix + EOL + this.#list.map(item => this.itemToString(timelineEnd, item, times)).join(EOL);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGltaW5nLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3V0aWxzL3RpbWluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsR0FBRyxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQzlCLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFDckMsT0FBTyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBRWpDLE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQywwQkFBMEIsQ0FBQyxDQUFDO0FBV25ELE1BQU0sT0FBTyxNQUFNO0lBQ2pCLE9BQU8sQ0FBVTtJQUNqQixVQUFVLENBQWdCO0lBQzFCLElBQUksQ0FBMEI7SUFDOUIsS0FBSyxDQUFlO0lBQ3BCO1FBQ0UsSUFBSSxDQUFDLE9BQU8sR0FBRyxJQUFJLENBQUM7UUFDcEIsSUFBSSxDQUFDLFVBQVUsR0FBRyxJQUFJLENBQUM7UUFDdkIsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLEdBQUcsRUFBRSxDQUFDO1FBQ3RCLElBQUksQ0FBQyxLQUFLLEdBQUcsRUFBRSxDQUFDO1FBQ2hCLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUNkLENBQUM7SUFFRCxJQUFJO1FBQ0YscUJBQXFCO1FBQ3JCLElBQUksQ0FBQyxLQUFLLENBQUMsZUFBZSxFQUFFLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQyxDQUFDO1FBQzlFLElBQUksQ0FBQyxHQUFHLENBQUMsZUFBZSxDQUFDLENBQUM7UUFFMUIsSUFBSSxpQkFBaUIsSUFBSSxPQUFPLElBQUksT0FBTyxPQUFPLENBQUMsZUFBZSxLQUFLLFFBQVEsRUFBRSxDQUFDO1lBQ2hGLCtCQUErQjtZQUMvQixJQUFJLENBQUMsS0FBSyxDQUFDLGNBQWMsRUFBRSxPQUFPLENBQUMsZUFBZSxDQUFDLENBQUM7WUFD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

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@eggjs/core",
+  "version": "6.0.0-beta.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">= 18.19.0"
+  },
+  "tnpm": {
+    "mode": "npm"
+  },
+  "description": "A core plugin framework based on koa",
+  "scripts": {
+    "lint": "eslint src test --ext ts",
+    "test": "npm run lint -- --fix && npm run test-local",
+    "test-local": "egg-bin test",
+    "ci": "npm run lint && egg-bin cov && npm run prepublishOnly",
+    "contributor": "git-contributor",
+    "prepublishOnly": "tshy && tshy-after"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eggjs/egg-core.git"
+  },
+  "keywords": [
+    "egg",
+    "loader"
+  ],
+  "author": "gxcsoccer <gxcsoccer@126.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/eggjs/egg/issues"
+  },
+  "homepage": "https://github.com/eggjs/egg-core#readme",
+  "dependencies": {
+    "@eggjs/koa": "^2.18.2",
+    "@eggjs/router": "^3.0.5",
+    "egg-logger": "^3.5.0",
+    "egg-path-matching": "^2.0.0",
+    "extend2": "^4.0.0",
+    "get-ready": "^3.1.0",
+    "globby": "^11.0.2",
+    "is-type-of": "^2.1.0",
+    "node-homedir": "^2.0.0",
+    "performance-ms": "^1.1.0",
+    "ready-callback": "^4.0.0",
+    "tsconfig-paths": "^4.1.1",
+    "utility": "^2.1.0"
+  },
+  "devDependencies": {
+    "@eggjs/tsconfig": "1",
+    "@types/js-yaml": "^4.0.9",
+    "@types/mocha": "10",
+    "@types/node": "20",
+    "@types/supertest": "^6.0.2",
+    "await-event": "2",
+    "coffee": "5",
+    "egg-bin": "6",
+    "egg-utils": "2",
+    "eslint": "8",
+    "eslint-config-egg": "13",
+    "gals": "^1.0.2",
+    "git-contributor": "2",
+    "js-yaml": "^3.13.1",
+    "mm": "3",
+    "spy": "^1.0.0",
+    "supertest": "^4.0.2",
+    "ts-node": "10",
+    "tshy": "^1.15.1",
+    "tshy-after": "^1.0.0",
+    "typescript": "^5.4.5",
+    "urllib": "3"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "tshy": {
+    "exports": {
+      "./package.json": "./package.json",
+      ".": "./src/index.ts"
+    }
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": {
+        "source": "./src/index.ts",
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "source": "./src/index.ts",
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    }
+  },
+  "main": "./dist/commonjs/index.js",
+  "types": "./dist/commonjs/index.d.ts"
+}

package/src/base_context_class.ts

@@ -0,0 +1,39 @@
+import type { EggCore, EggCoreContext } from './egg.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 {
+  ctx: EggCoreContext;
+  app: EggCore;
+  config: Record<string, any>;
+  service: BaseContextClass;
+
+  /**
+   * @since 1.0.0
+   */
+  constructor(ctx: EggCoreContext) {
+    /**
+     * @member {Context} BaseContextClass#ctx
+     * @since 1.0.0
+     */
+    this.ctx = ctx;
+    /**
+     * @member {Application} BaseContextClass#app
+     * @since 1.0.0
+     */
+    this.app = ctx.app;
+    /**
+     * @member {Config} BaseContextClass#config
+     * @since 1.0.0
+     */
+    this.config = ctx.app.config;
+    /**
+     * @member {Service} BaseContextClass#service
+     * @since 1.0.0
+     */
+    this.service = ctx.service;
+  }
+}

package/src/egg.ts

@@ -0,0 +1,430 @@
+/* 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 type { ContextDelegation, Next } from '@eggjs/koa';
+import { EggConsoleLogger } from 'egg-logger';
+import { RegisterOptions, ResourcesController, EggRouter as Router } from '@eggjs/router';
+import type { ReadyFunctionArg } from 'get-ready';
+import { BaseContextClass } from './base_context_class.js';
+import { Timing } from './utils/timing.js';
+import type { Fun } from './utils/index.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 interface EggCoreOptions {
+  baseDir: string;
+  type: 'application' | 'agent';
+  plugins?: any;
+  serverScope?: string;
+  env?: string;
+}
+
+export type EggCoreInitOptions = Partial<EggCoreOptions>;
+
+type Middleware = (ctx: EggCoreContext, next: Next) => Promise<void> | void;
+export type MiddlewareFunc = Middleware & {
+  _name?: string;
+};
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore
+export interface EggCoreContext extends ContextDelegation {
+  app: EggCore;
+}
+
+export class EggCore extends KoaApplication {
+  options: EggCoreOptions;
+  timing: Timing;
+  console: EggConsoleLogger;
+  BaseContextClass: typeof BaseContextClass;
+  Controller: typeof BaseContextClass;
+  Service: typeof BaseContextClass;
+  Helper?: typeof BaseContextClass;
+  lifecycle: Lifecycle;
+  loader: EggLoader;
+  #closePromise?: Promise<void>;
+  #router?: Router;
+
+  /** auto inject on loadService() */
+  readonly serviceClasses: Record<string, any> = {};
+  /** auto inject on loadController() */
+  readonly controller: Record<string, any> = {};
+  /** auto inject on loadMiddleware() */
+  readonly middlewares: Record<string, (opt: any, app: EggCore) => MiddlewareFunc> = {};
+  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+  // @ts-ignore
+  declare middleware: MiddlewareFunc[];
+
+  /**
+   * @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: EggCoreInitOptions = {}) {
+    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 as EggCoreOptions;
+
+    /**
+     * 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: MiddlewareFunc) {
+    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: Fun, name?: string) {
+    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?: ReadyFunctionArg) {
+    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: string, opts: object) {
+    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: Fun) {
+    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(): Promise<void> {
+    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: string, params?: any): string {
+    return this.router.url(name, params);
+  }
+
+  // delegate all router method to application
+  // 'head', 'options', 'get', 'put', 'patch', 'post', 'delete'
+  // 'all', 'resources', 'register', 'redirect'
+  head(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  head(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  head(...args: any): EggCore {
+    this.router.head.apply(this.router, args);
+    return this;
+  }
+  // options(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  // options(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  // options(...args: any): EggCore {
+  //   this.router.options.apply(this.router, args);
+  //   return this;
+  // }
+  get(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  get(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  get(...args: any): EggCore {
+    this.router.get.apply(this.router, args);
+    return this;
+  }
+  put(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  put(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  put(...args: any): EggCore {
+    this.router.put.apply(this.router, args);
+    return this;
+  }
+  patch(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  patch(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  patch(...args: any): EggCore {
+    this.router.patch.apply(this.router, args);
+    return this;
+  }
+  post(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  post(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  post(...args: any): EggCore {
+    this.router.post.apply(this.router, args);
+    return this;
+  }
+  delete(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  delete(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  delete(...args: any): EggCore {
+    this.router.delete.apply(this.router, args);
+    return this;
+  }
+  del(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  del(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  del(...args: any): EggCore {
+    this.router.del.apply(this.router, args);
+    return this;
+  }
+
+  all(path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  all(name: string, path: string | RegExp | (string | RegExp)[], ...middlewares: (MiddlewareFunc | string)[]): EggCore;
+  all(...args: any): EggCore {
+    this.router.all.apply(this.router, args);
+    return this;
+  }
+
+  resources(prefix: string, controller: string | ResourcesController): EggCore;
+  resources(prefix: string, middleware: MiddlewareFunc, controller: string | ResourcesController): EggCore;
+  resources(name: string, prefix: string, controller: string | ResourcesController): EggCore;
+  resources(name: string, prefix: string, middleware: MiddlewareFunc, controller: string | ResourcesController): EggCore;
+  resources(...args: any): EggCore {
+    this.router.resources.apply(this.router, args);
+    return this;
+  }
+
+  redirect(source: string, destination: string, status: number = 301) {
+    this.router.redirect(source, destination, status);
+    return this;
+  }
+
+  register(path: string | RegExp | (string | RegExp)[],
+    methods: string[],
+    middleware: MiddlewareFunc | MiddlewareFunc[],
+    opts?: RegisterOptions) {
+    this.router.register(path, methods, middleware, opts);
+    return this;
+  }
+
+  get [EGG_LOADER]() {
+    return EggLoader;
+  }
+}

package/src/index.ts

@@ -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 };