egg 3.29.0 → 4.0.0-beta.2

package/README.md

@@ -7,9 +7,10 @@ English | [简体中文](./README.zh-CN.md)
 [![NPM version](https://img.shields.io/npm/v/egg.svg?style=flat-square)](https://npmjs.org/package/egg)
 [![NPM quality](http://npm.packagequality.com/shield/egg.svg?style=flat-square)](http://packagequality.com/#?package=egg)
 [![NPM download](https://img.shields.io/npm/dm/egg.svg?style=flat-square)](https://npmjs.org/package/egg)
+[![Node.js Version](https://img.shields.io/node/v/egg.svg?style=flat)](https://nodejs.org/en/download/)
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Feggjs%2Fegg.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Feggjs%2Fegg?ref=badge_shield)
 
-[![Continuous Integration](https://github.com/eggjs/egg/actions/workflows/nodejs-3.x.yml/badge.svg)](https://github.com/eggjs/egg/actions?query=branch%3A3.x)
+[![Continuous Integration](https://github.com/eggjs/egg/actions/workflows/nodejs.yml/badge.svg)](https://github.com/eggjs/egg/actions?query=branch%3Amaster)
 [![Test coverage](https://img.shields.io/codecov/c/github/eggjs/egg.svg?style=flat-square)](https://codecov.io/gh/eggjs/egg)
 [![Known Vulnerabilities](https://snyk.io/test/npm/egg/badge.svg?style=flat-square)](https://snyk.io/test/npm/egg)
 [![Open Collective backers and sponsors](https://img.shields.io/opencollective/all/eggjs?style=flat-square)](https://opencollective.com/eggjs)

package/README.zh-CN.md

@@ -7,6 +7,7 @@
 [![NPM version](https://img.shields.io/npm/v/egg.svg?style=flat-square)](https://npmjs.org/package/egg)
 [![NPM quality](http://npm.packagequality.com/shield/egg.svg?style=flat-square)](http://packagequality.com/#?package=egg)
 [![NPM download](https://img.shields.io/npm/dm/egg.svg?style=flat-square)](https://npmjs.org/package/egg)
+[![Node.js Version](https://img.shields.io/node/v/egg.svg?style=flat)](https://nodejs.org/en/download/)
 
 [![Continuous Integration](https://github.com/eggjs/egg/actions/workflows/nodejs.yml/badge.svg)](https://github.com/eggjs/egg/actions?query=branch%3Amaster)
 [![Test coverage](https://img.shields.io/codecov/c/github/eggjs/egg.svg?style=flat-square)](https://codecov.io/gh/eggjs/egg)
@@ -25,11 +26,12 @@
 ## 快速开始
 
 ```bash
-$ mkdir showcase && cd showcase
-$ npm init egg --type=simple
-$ npm install
-$ npm run dev
-$ open http://localhost:7001
+mkdir showcase && cd showcase
+npm init egg --type=simple
+npm install
+npm run dev
+
+open http://localhost:7001
 ```
 
 ## 文档

package/dist/commonjs/agent.d.ts

@@ -0,0 +1,4 @@
+import { BaseHookClass } from './lib/core/base_hook_class.js';
+export default class EggAgentHook extends BaseHookClass {
+    configDidLoad(): void;
+}

package/dist/commonjs/agent.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_hook_class_js_1 = require("./lib/core/base_hook_class.js");
+class EggAgentHook extends base_hook_class_js_1.BaseHookClass {
+    configDidLoad() {
+        this.agent._wrapMessenger();
+    }
+}
+exports.default = EggAgentHook;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYWdlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSxzRUFBOEQ7QUFFOUQsTUFBcUIsWUFBYSxTQUFRLGtDQUFhO0lBQ3JELGFBQWE7UUFDWCxJQUFJLENBQUMsS0FBSyxDQUFDLGNBQWMsRUFBRSxDQUFDO0lBQzlCLENBQUM7Q0FDRjtBQUpELCtCQUlDIn0=

package/dist/commonjs/app/extend/context.d.ts

@@ -0,0 +1,2 @@
+declare const Context: any;
+export default Context;

package/dist/commonjs/app/extend/context.js

@@ -0,0 +1,263 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_perf_hooks_1 = require("node:perf_hooks");
+const delegates_1 = __importDefault(require("delegates"));
+const utility_1 = require("utility");
+const core_1 = require("@eggjs/core");
+const HELPER = Symbol('Context#helper');
+const LOCALS = Symbol('Context#locals');
+const LOCALS_LIST = Symbol('Context#localsList');
+const COOKIES = Symbol('Context#cookies');
+const CONTEXT_LOGGERS = Symbol('Context#logger');
+const CONTEXT_HTTPCLIENT = Symbol('Context#httpclient');
+const CONTEXT_ROUTER = Symbol('Context#router');
+const Context = {
+    /**
+     * Get the current visitor's cookies.
+     */
+    get cookies() {
+        if (!this[COOKIES]) {
+            this[COOKIES] = new this.app.ContextCookies(this, this.app.keys, this.app.config.cookies);
+        }
+        return this[COOKIES];
+    },
+    /**
+     * Get a wrapper httpclient instance contain ctx in the hold request process
+     *
+     * @return {ContextHttpClient} the wrapper httpclient instance
+     */
+    get httpclient() {
+        if (!this[CONTEXT_HTTPCLIENT]) {
+            this[CONTEXT_HTTPCLIENT] = new this.app.ContextHttpClient(this);
+        }
+        return this[CONTEXT_HTTPCLIENT];
+    },
+    /**
+     * Shortcut for httpclient.curl
+     *
+     * @function Context#curl
+     * @param {String|Object} url - request url address.
+     * @param {Object} [options] - options for request.
+     * @return {Object} see {@link ContextHttpClient#curl}
+     */
+    curl(url, options) {
+        return this.httpclient.curl(url, options);
+    },
+    /**
+     * Alias to {@link Application#router}
+     *
+     * @member {Router} Context#router
+     * @since 1.0.0
+     * @example
+     * ```js
+     * this.router.pathFor('post', { id: 12 });
+     * ```
+     */
+    get router() {
+        if (!this[CONTEXT_ROUTER]) {
+            this[CONTEXT_ROUTER] = this.app.router;
+        }
+        return this[CONTEXT_ROUTER];
+    },
+    /**
+     * Set router to Context, only use on EggRouter
+     * @param {EggRouter} val router instance
+     */
+    set router(val) {
+        this[CONTEXT_ROUTER] = val;
+    },
+    /**
+     * Get helper instance from {@link Application#Helper}
+     *
+     * @member {Helper} Context#helper
+     * @since 1.0.0
+     */
+    get helper() {
+        if (!this[HELPER]) {
+            this[HELPER] = new this.app.Helper(this);
+        }
+        return this[HELPER];
+    },
+    /**
+     * Wrap app.loggers with context information,
+     * if a custom logger is defined by naming aLogger, then you can `ctx.getLogger('aLogger')`
+     *
+     * @param {String} name - logger name
+     * @return {Logger} logger
+     */
+    getLogger(name) {
+        if (this.app.config.logger.enableFastContextLogger) {
+            return this.app.getLogger(name);
+        }
+        let cache = this[CONTEXT_LOGGERS];
+        if (!cache) {
+            cache = this[CONTEXT_LOGGERS] = {};
+        }
+        // read from cache
+        if (cache[name])
+            return cache[name];
+        // get no exist logger
+        const appLogger = this.app.getLogger(name);
+        if (!appLogger)
+            return null;
+        // write to cache
+        cache[name] = new this.app.ContextLogger(this, appLogger);
+        return cache[name];
+    },
+    /**
+     * Logger for Application, wrapping app.coreLogger with context infomation
+     *
+     * @member {ContextLogger} Context#logger
+     * @since 1.0.0
+     * @example
+     * ```js
+     * this.logger.info('some request data: %j', this.request.body);
+     * this.logger.warn('WARNING!!!!');
+     * ```
+     */
+    get logger() {
+        return this.getLogger('logger');
+    },
+    /**
+     * Logger for frameworks and plugins,
+     * wrapping app.coreLogger with context infomation
+     *
+     * @member {ContextLogger} Context#coreLogger
+     * @since 1.0.0
+     */
+    get coreLogger() {
+        return this.getLogger('coreLogger');
+    },
+    /**
+     * locals is an object for view, you can use `app.locals` and `ctx.locals` to set variables,
+     * which will be used as data when view is rendering.
+     * The difference between `app.locals` and `ctx.locals` is the context level, `app.locals` is global level, and `ctx.locals` is request level. when you get `ctx.locals`, it will merge `app.locals`.
+     *
+     * when you set locals, only object is available
+     *
+     * ```js
+     * this.locals = {
+     *   a: 1
+     * };
+     * this.locals = {
+     *   b: 1
+     * };
+     * this.locals.c = 1;
+     * console.log(this.locals);
+     * {
+     *   a: 1,
+     *   b: 1,
+     *   c: 1,
+     * };
+     * ```
+     *
+     * `ctx.locals` has cache, it only merges `app.locals` once in one request.
+     *
+     * @member {Object} Context#locals
+     */
+    get locals() {
+        if (!this[LOCALS]) {
+            this[LOCALS] = (0, utility_1.assign)({}, this.app.locals);
+        }
+        if (this[LOCALS_LIST] && this[LOCALS_LIST].length) {
+            (0, utility_1.assign)(this[LOCALS], this[LOCALS_LIST]);
+            this[LOCALS_LIST] = null;
+        }
+        return this[LOCALS];
+    },
+    set locals(val) {
+        if (!this[LOCALS_LIST]) {
+            this[LOCALS_LIST] = [];
+        }
+        this[LOCALS_LIST].push(val);
+    },
+    /**
+     * alias to {@link Context#locals}, compatible with koa that use this variable
+     * @member {Object} state
+     * @see Context#locals
+     */
+    get state() {
+        return this.locals;
+    },
+    set state(val) {
+        this.locals = val;
+    },
+    /**
+     * Run async function in the background
+     * @param {Function} scope - the first args is ctx
+     * ```js
+     * this.body = 'hi';
+     *
+     * this.runInBackground(async ctx => {
+     *   await ctx.mysql.query(sql);
+     *   await ctx.curl(url);
+     * });
+     * ```
+     */
+    runInBackground(scope) {
+        // try to use custom function name first
+        /* istanbul ignore next */
+        const taskName = Reflect.get(scope, '_name') || scope.name || core_1.utils.getCalleeFromStack(true);
+        this._runInBackground(scope, taskName);
+    },
+    // let plugins or frameworks to reuse _runInBackground in some cases.
+    // e.g.: https://github.com/eggjs/egg-mock/pull/78
+    _runInBackground(scope, taskName) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const ctx = this;
+        const start = node_perf_hooks_1.performance.now();
+        // use setImmediate to ensure all sync logic will run async
+        return new Promise(resolve => setImmediate(resolve))
+            .then(() => scope(ctx))
+            .then(() => {
+            ctx.coreLogger.info('[egg:background] task:%s success (%dms)', taskName, Math.floor((node_perf_hooks_1.performance.now() - start) * 1000) / 1000);
+        })
+            .catch(err => {
+            // background task process log
+            ctx.coreLogger.info('[egg:background] task:%s fail (%dms)', taskName, Math.floor((node_perf_hooks_1.performance.now() - start) * 1000) / 1000);
+            // emit error when promise catch, and set err.runInBackground flag
+            err.runInBackground = true;
+            ctx.app.emit('error', err, ctx);
+        });
+    },
+};
+/**
+ * Context delegation.
+ */
+(0, delegates_1.default)(Context, 'request')
+    /**
+     * @member {Boolean} Context#acceptJSON
+     * @see Request#acceptJSON
+     * @since 1.0.0
+     */
+    .getter('acceptJSON')
+    /**
+     * @member {Array} Context#queries
+     * @see Request#queries
+     * @since 1.0.0
+     */
+    .getter('queries')
+    /**
+     * @member {Boolean} Context#accept
+     * @see Request#accept
+     * @since 1.0.0
+     */
+    .getter('accept')
+    /**
+     * @member {string} Context#ip
+     * @see Request#ip
+     * @since 1.0.0
+     */
+    .access('ip');
+(0, delegates_1.default)(Context, 'response')
+    /**
+     * @member {Number} Context#realStatus
+     * @see Response#realStatus
+     * @since 1.0.0
+     */
+    .access('realStatus');
+exports.default = Context;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udGV4dC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9hcHAvZXh0ZW5kL2NvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQSxxREFBOEM7QUFDOUMsMERBQWlDO0FBQ2pDLHFDQUFpQztBQUNqQyxzQ0FBb0M7QUFFcEMsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLGdCQUFnQixDQUFDLENBQUM7QUFDeEMsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLGdCQUFnQixDQUFDLENBQUM7QUFDeEMsTUFBTSxXQUFXLEdBQUcsTUFBTSxDQUFDLG9CQUFvQixDQUFDLENBQUM7QUFDakQsTUFBTSxPQUFPLEdBQUcsTUFBTSxDQUFDLGlCQUFpQixDQUFDLENBQUM7QUFDMUMsTUFBTSxlQUFlLEdBQUcsTUFBTSxDQUFDLGdCQUFnQixDQUFDLENBQUM7QUFDakQsTUFBTSxrQkFBa0IsR0FBRyxNQUFNLENBQUMsb0JBQW9CLENBQUMsQ0FBQztBQUN4RCxNQUFNLGNBQWMsR0FBRyxNQUFNLENBQUMsZ0JBQWdCLENBQUMsQ0FBQztBQUVoRCxNQUFNLE9BQU8sR0FBRztJQUNkOztPQUVHO0lBQ0gsSUFBSSxPQUFPO1FBQ1QsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO1lBQ25CLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxJQUFJLElBQUksQ0FBQyxHQUFHLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksRUFBRSxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUM1RixDQUFDO1FBQ0QsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDdkIsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxJQUFJLFVBQVU7UUFDWixJQUFJLENBQUMsSUFBSSxDQUFDLGtCQUFrQixDQUFDLEVBQUUsQ0FBQztZQUM5QixJ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

package/dist/commonjs/app/middleware/body_parser.d.ts

@@ -0,0 +1,2 @@
+import bodyparser from 'koa-bodyparser';
+export default bodyparser;

package/dist/commonjs/app/middleware/body_parser.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const koa_bodyparser_1 = __importDefault(require("koa-bodyparser"));
+exports.default = koa_bodyparser_1.default;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm9keV9wYXJzZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvYXBwL21pZGRsZXdhcmUvYm9keV9wYXJzZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQSxvRUFBd0M7QUFFeEMsa0JBQWUsd0JBQVUsQ0FBQyJ9

package/dist/commonjs/app/middleware/meta.d.ts

@@ -0,0 +1,11 @@
+/**
+ * meta middleware, should be the first middleware
+ */
+import type { EggCoreContext } from '@eggjs/core';
+import type { Next } from '../../lib/type.js';
+export interface MetaMiddlewareOptions {
+    enable: boolean;
+    logging: boolean;
+}
+declare const _default: (options: MetaMiddlewareOptions) => (ctx: EggCoreContext, next: Next) => Promise<void>;
+export default _default;

package/dist/commonjs/app/middleware/meta.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * meta middleware, should be the first middleware
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_perf_hooks_1 = require("node:perf_hooks");
+exports.default = (options) => {
+    return async function meta(ctx, next) {
+        if (options.logging) {
+            ctx.coreLogger.info('[meta] request started, host: %s, user-agent: %s', ctx.host, ctx.header['user-agent']);
+        }
+        await next();
+        // total response time header
+        if (ctx.performanceStarttime) {
+            ctx.set('x-readtime', Math.floor((node_perf_hooks_1.performance.now() - ctx.performanceStarttime) * 1000) / 1000);
+        }
+        else {
+            ctx.set('x-readtime', Date.now() - ctx.starttime);
+        }
+    };
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWV0YS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9hcHAvbWlkZGxld2FyZS9tZXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7R0FFRzs7QUFFSCxxREFBOEM7QUFTOUMsa0JBQWUsQ0FBQyxPQUE4QixFQUFFLEVBQUU7SUFDaEQsT0FBTyxLQUFLLFVBQVUsSUFBSSxDQUFDLEdBQW1CLEVBQUUsSUFBVTtRQUN4RCxJQUFJLE9BQU8sQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNwQixHQUFHLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxrREFBa0QsRUFDcEUsR0FBRyxDQUFDLElBQUksRUFBRSxHQUFHLENBQUMsTUFBTSxDQUFDLFlBQVksQ0FBQyxDQUFDLENBQUM7UUFDeEMsQ0FBQztRQUNELE1BQU0sSUFBSSxFQUFFLENBQUM7UUFDYiw2QkFBNkI7UUFDN0IsSUFBSSxHQUFHLENBQUMsb0JBQW9CLEVBQUUsQ0FBQztZQUM3QixHQUFHLENBQUMsR0FBRyxDQUFDLFlBQVksRUFBRSxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsNkJBQVcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxHQUFHLENBQUMsb0JBQW9CLENBQUMsR0FBRyxJQUFJLENBQUMsR0FBRyxJQUFJLENBQUMsQ0FBQztRQUNsRyxDQUFDO2FBQU0sQ0FBQztZQUNOLEdBQUcsQ0FBQyxHQUFHLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxHQUFHLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDcEQsQ0FBQztJQUNILENBQUMsQ0FBQztBQUNKLENBQUMsQ0FBQyJ9

package/dist/commonjs/app/middleware/notfound.d.ts

@@ -0,0 +1,8 @@
+import type { EggCoreContext } from '@eggjs/core';
+import type { Next } from '../../lib/type.js';
+export interface NotFoundMiddlewareOptions {
+    enable: boolean;
+    pageUrl: string;
+}
+declare const _default: (options: NotFoundMiddlewareOptions) => (ctx: EggCoreContext, next: Next) => Promise<void>;
+export default _default;

package/dist/commonjs/app/middleware/notfound.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = (options) => {
+    return async function notfound(ctx, next) {
+        await next();
+        if (ctx.status !== 404 || ctx.body) {
+            return;
+        }
+        // set status first, make sure set body not set status
+        ctx.status = 404;
+        if (ctx.acceptJSON) {
+            ctx.body = {
+                message: 'Not Found',
+            };
+            return;
+        }
+        const notFoundHtml = '<h1>404 Not Found</h1>';
+        // notfound handler is unimplemented
+        if (options.pageUrl && ctx.path === options.pageUrl) {
+            ctx.body = `${notFoundHtml}<p><pre><code>config.notfound.pageUrl(${options.pageUrl})</code></pre> is unimplemented</p>`;
+            return;
+        }
+        if (options.pageUrl) {
+            ctx.realStatus = 404;
+            ctx.redirect(options.pageUrl);
+            return;
+        }
+        ctx.body = notFoundHtml;
+    };
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibm90Zm91bmQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvYXBwL21pZGRsZXdhcmUvbm90Zm91bmQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFRQSxrQkFBZSxDQUFDLE9BQWtDLEVBQUUsRUFBRTtJQUNwRCxPQUFPLEtBQUssVUFBVSxRQUFRLENBQUMsR0FBbUIsRUFBRSxJQUFVO1FBQzVELE1BQU0sSUFBSSxFQUFFLENBQUM7UUFFYixJQUFJLEdBQUcsQ0FBQyxNQUFNLEtBQUssR0FBRyxJQUFJLEdBQUcsQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUNuQyxPQUFPO1FBQ1QsQ0FBQztRQUVELHNEQUFzRDtRQUN0RCxHQUFHLENBQUMsTUFBTSxHQUFHLEdBQUcsQ0FBQztRQUVqQixJQUFJLEdBQUcsQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUNuQixHQUFHLENBQUMsSUFBSSxHQUFHO2dCQUNULE9BQU8sRUFBRSxXQUFXO2FBQ3JCLENBQUM7WUFDRixPQUFPO1FBQ1QsQ0FBQztRQUVELE1BQU0sWUFBWSxHQUFHLHdCQUF3QixDQUFDO1FBRTlDLG9DQUFvQztRQUNwQyxJQUFJLE9BQU8sQ0FBQyxPQUFPLElBQUksR0FBRyxDQUFDLElBQUksS0FBSyxPQUFPLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDcEQsR0FBRyxDQUFDLElBQUksR0FBRyxHQUFHLFlBQVkseUNBQXlDLE9BQU8sQ0FBQyxPQUFPLHFDQUFxQyxDQUFDO1lBQ3hILE9BQU87UUFDVCxDQUFDO1FBRUQsSUFBSSxPQUFPLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDcEIsR0FBRyxDQUFDLFVBQVUsR0FBRyxHQUFHLENBQUM7WUFDckIsR0FBRyxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLENBQUM7WUFDOUIsT0FBTztRQUNULENBQUM7UUFDRCxHQUFHLENBQUMsSUFBSSxHQUFHLFlBQVksQ0FBQztJQUMxQixDQUFDLENBQUM7QUFDSixDQUFDLENBQUMifQ==

package/dist/commonjs/app/middleware/override_method.d.ts

@@ -0,0 +1,2 @@
+import override from 'koa-override';
+export default override;

package/dist/commonjs/app/middleware/override_method.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const koa_override_1 = __importDefault(require("koa-override"));
+exports.default = koa_override_1.default;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3ZlcnJpZGVfbWV0aG9kLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2FwcC9taWRkbGV3YXJlL292ZXJyaWRlX21ldGhvZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUFBLGdFQUFvQztBQUVwQyxrQkFBZSxzQkFBUSxDQUFDIn0=

package/dist/commonjs/app/middleware/site_file.d.ts

@@ -0,0 +1,7 @@
+import type { EggCoreContext } from '@eggjs/core';
+export type SiteFileContentFun = (ctx: EggCoreContext) => Promise<Buffer | string>;
+export interface SiteFileMiddlewareOptions {
+    enable: boolean;
+    cacheControl: string;
+    [key: string]: string | Buffer | boolean | SiteFileContentFun | URL;
+}

package/dist/commonjs/app/middleware/site_file.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = require("node:url");
+const promises_1 = require("node:fs/promises");
+const BUFFER_CACHE = Symbol('siteFile URL buffer cache');
+module.exports = (options) => {
+    return async function siteFile(ctx, next) {
+        if (ctx.method !== 'HEAD' && ctx.method !== 'GET') {
+            return next();
+        }
+        /* istanbul ignore if */
+        if (ctx.path[0] !== '/') {
+            return next();
+        }
+        let content = options[ctx.path];
+        if (!content) {
+            return next();
+        }
+        // '/favicon.ico': 'https://eggjs.org/favicon.ico' or '/favicon.ico': async (ctx) => 'https://eggjs.org/favicon.ico'
+        // content is function
+        if (typeof content === 'function') {
+            content = await content(ctx);
+        }
+        // content is url
+        if (typeof content === 'string') {
+            return ctx.redirect(content);
+        }
+        // URL
+        if (content instanceof URL) {
+            if (content.protocol !== 'file:') {
+                return ctx.redirect(content.href);
+            }
+            // protocol = file:
+            let buffer = Reflect.get(content, BUFFER_CACHE);
+            if (!buffer) {
+                buffer = await (0, promises_1.readFile)((0, node_url_1.fileURLToPath)(content));
+                Reflect.set(content, BUFFER_CACHE, buffer);
+            }
+            ctx.set('cache-control', options.cacheControl);
+            ctx.body = content;
+            ctx.type = node_path_1.default.extname(ctx.path);
+            return;
+        }
+        // '/robots.txt': Buffer <xx..
+        // content is buffer
+        if (Buffer.isBuffer(content)) {
+            ctx.set('cache-control', options.cacheControl);
+            ctx.body = content;
+            ctx.type = node_path_1.default.extname(ctx.path);
+            return;
+        }
+        return next();
+    };
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2l0ZV9maWxlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2FwcC9taWRkbGV3YXJlL3NpdGVfZmlsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUFBLDBEQUE2QjtBQUM3Qix1Q0FBeUM7QUFDekMsK0NBQTRDO0FBWTVDLE1BQU0sWUFBWSxHQUFHLE1BQU0sQ0FBQywyQkFBMkIsQ0FBQyxDQUFDO0FBRXpELE1BQU0sQ0FBQyxPQUFPLEdBQUcsQ0FBQyxPQUFrQyxFQUFFLEVBQUU7SUFDdEQsT0FBTyxLQUFLLFVBQVUsUUFBUSxDQUFDLEdBQW1CLEVBQUUsSUFBVTtRQUM1RCxJQUFJLEdBQUcsQ0FBQyxNQUFNLEtBQUssTUFBTSxJQUFJLEdBQUcsQ0FBQyxNQUFNLEtBQUssS0FBSyxFQUFFLENBQUM7WUFDbEQsT0FBTyxJQUFJLEVBQUUsQ0FBQztRQUNoQixDQUFDO1FBQ0Qsd0JBQXdCO1FBQ3hCLElBQUksR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsS0FBSyxHQUFHLEVBQUUsQ0FBQztZQUN4QixPQUFPLElBQUksRUFBRSxDQUFDO1FBQ2hCLENBQUM7UUFFRCxJQUFJLE9BQU8sR0FBRyxPQUFPLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ2hDLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNiLE9BQU8sSUFBSSxFQUFFLENBQUM7UUFDaEIsQ0FBQztRQUVELG9IQUFvSDtRQUNwSCxzQkFBc0I7UUFDdEIsSUFBSSxPQUFPLE9BQU8sS0FBSyxVQUFVLEVBQUUsQ0FBQztZQUNsQyxPQUFPLEdBQUcsTUFBTSxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDL0IsQ0FBQztRQUNELGlCQUFpQjtRQUNqQixJQUFJLE9BQU8sT0FBTyxLQUFLLFFBQVEsRUFBRSxDQUFDO1lBQ2hDLE9BQU8sR0FBRyxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUMvQixDQUFDO1FBRUQsTUFBTTtRQUNOLElBQUksT0FBTyxZQUFZLEdBQUcsRUFBRSxDQUFDO1lBQzNCLElBQUksT0FBTyxDQUFDLFFBQVEsS0FBSyxPQUFPLEVBQUUsQ0FBQztnQkFDakMsT0FBTyxHQUFHLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUNwQyxDQUFDO1lBQ0QsbUJBQW1CO1lBQ25CLElBQUksTUFBTSxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLFlBQVksQ0FBVyxDQUFDO1lBQzFELElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQztnQkFDWixNQUFNLEdBQUcsTUFBTSxJQUFBLG1CQUFRLEVBQUMsSUFBQSx3QkFBYSxFQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUM7Z0JBQ2hELE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLENBQUMsQ0FBQztZQUM3QyxDQUFDO1lBQ0QsR0FBRyxDQUFDLEdBQUcsQ0FBQyxlQUFlLEVBQUUsT0FBTyxDQUFDLFlBQVksQ0FBQyxDQUFDO1lBQy9DLEdBQUcsQ0FBQyxJQUFJLEdBQUcsT0FBTyxDQUFDO1lBQ25CLEdBQUcsQ0FBQyxJQUFJLEdBQUcsbUJBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQ2xDLE9BQU87UUFDVCxDQUFDO1FBRUQsOEJBQThCO1FBQzlCLG9CQUFvQjtRQUNwQixJQUFJLE1BQU0sQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUM3QixHQUFHLENBQUMsR0FBRyxDQUFDLGVBQWUsRUFBRSxPQUFPLENBQUMsWUFBWSxDQUFDLENBQUM7WUFDL0MsR0FBRyxDQUFDLElBQUksR0FBRyxPQUFPLENBQUM7WUFDbkIsR0FBRyxDQUFDLElBQUksR0FBRyxtQkFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLENBQUM7WUFDbEMsT0FBTztRQUNULENBQUM7UUFFRCxPQUFPLElBQUksRUFBRSxDQUFDO0lBQ2hCLENBQUMsQ0FBQztBQUNKLENBQUMsQ0FBQyJ9

package/dist/commonjs/config/config.default.d.ts

@@ -0,0 +1,9 @@
+import type { EggAppInfo } from '@eggjs/core';
+import type { EggAppConfig } from '../lib/type.js';
+/**
+ * The configuration of egg application, can be access by `app.config`
+ * @class Config
+ * @since 1.0.0
+ */
+declare const _default: (appInfo: EggAppInfo) => Partial<EggAppConfig>;
+export default _default;