egg 4.1.0-beta.34 → 4.1.0-beta.36

package/dist/app/extend/context.js

@@ -1,259 +1,244 @@
-import { assign } from 'utility';
-import { now, diff } from 'performance-ms';
-import { utils, Context as EggCoreContext, Router } from '@eggjs/core';
-const HELPER = Symbol('ctx helper');
-const LOCALS = Symbol('ctx locals');
-const LOCALS_LIST = Symbol('ctx localsList');
-const COOKIES = Symbol('ctx cookies');
-const CONTEXT_HTTPCLIENT = Symbol('ctx httpclient');
-const CONTEXT_ROUTER = Symbol('ctx router');
-export default class Context extends EggCoreContext {
-    /**
-     * Request start time
-     * @member {Number} Context#starttime
-     */
-    starttime;
-    /**
-     * Request start timer using `performance.now()`
-     * @member {Number} Context#performanceStarttime
-     */
-    performanceStarttime;
-    /**
-     * Get the current visitor's cookies.
-     */
-    get cookies() {
-        let cookies = this[COOKIES];
-        if (!cookies) {
-            this[COOKIES] = cookies = new this.app.ContextCookies(this, this.app.keys, this.app.config.cookies);
-        }
-        return cookies;
-    }
-    /**
-     * Get a wrapper httpclient instance contain ctx in the hold request process
-     *
-     * @return {HttpClient} the wrapper httpclient instance
-     */
-    get httpclient() {
-        if (!this[CONTEXT_HTTPCLIENT]) {
-            this[CONTEXT_HTTPCLIENT] = new this.app.ContextHttpClient(this);
-        }
-        return this[CONTEXT_HTTPCLIENT];
-    }
-    /**
-     * Alias to {@link Context#httpclient}
-     */
-    get httpClient() {
-        return this.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}
-     */
-    async curl(url, options) {
-        return await 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]) {
-            return this[CONTEXT_ROUTER];
-        }
-        return this.app.router;
-    }
-    /**
-     * Set router to Context, only use on EggRouter
-     * @param {Router} 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
-     */
-    getLogger(name) {
-        return this.app.getLogger(name);
-    }
-    /**
-     * Logger for Application
-     *
-     * @member {Logger} 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
-     *
-     * @member {Logger} 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] = assign({}, this.app.locals);
-        }
-        if (Array.isArray(this[LOCALS_LIST]) && this[LOCALS_LIST].length > 0) {
-            assign(this[LOCALS], this[LOCALS_LIST]);
-            this[LOCALS_LIST] = null;
-        }
-        return this[LOCALS];
-    }
-    set locals(val) {
-        const localsList = this[LOCALS_LIST] ?? [];
-        localsList.push(val);
-        this[LOCALS_LIST] = localsList;
-    }
-    /**
-     * 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, taskName) {
-        // try to use custom function name first
-        if (!taskName) {
-            taskName = Reflect.get(scope, '_name') || scope.name || utils.getCalleeFromStack(true);
-        }
-        // use setImmediate to ensure all sync logic will run async
-        setImmediate(() => {
-            this._runInBackground(scope, taskName);
-        });
-    }
-    // let plugins or frameworks to reuse _runInBackground in some cases.
-    // e.g.: https://github.com/eggjs/egg-mock/pull/78
-    async _runInBackground(scope, taskName) {
-        const startTime = now();
-        try {
-            await scope(this);
-            this.coreLogger.info('[egg:background] task:%s success (%dms)', taskName, diff(startTime));
-        }
-        catch (err) {
-            // background task process log
-            this.coreLogger.info('[egg:background] task:%s fail (%dms)', taskName, diff(startTime));
-            // emit error when promise catch, and set err.runInBackground flag
-            err.runInBackground = true;
-            this.app.emit('error', err, this);
-        }
-    }
-    /**
-     * @member {Boolean} Context#acceptJSON
-     * @see Request#acceptJSON
-     * @since 1.0.0
-     */
-    get acceptJSON() {
-        return this.request.acceptJSON;
-    }
-    get query() {
-        return this.request.query;
-    }
-    /**
-     * @member {Array} Context#queries
-     * @see Request#queries
-     * @since 1.0.0
-     */
-    get queries() {
-        return this.request.queries;
-    }
-    /**
-     * @member {string} Context#ip
-     * @see Request#ip
-     * @since 1.0.0
-     */
-    get ip() {
-        return this.request.ip;
-    }
-    set ip(val) {
-        this.request.ip = val;
-    }
-    /**
-     * @member {Number} Context#realStatus
-     * @see Response#realStatus
-     * @since 1.0.0
-     */
-    get realStatus() {
-        return this.response.realStatus;
-    }
-    set realStatus(val) {
-        this.response.realStatus = val;
-    }
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udGV4dC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcHAvZXh0ZW5kL2NvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUNqQyxPQUFPLEVBQUUsR0FBRyxFQUFFLElBQUksRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQzNDLE9BQU8sRUFBRSxLQUFLLEVBQUUsT0FBTyxJQUFJLGNBQWMsRUFBRSxNQUFNLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFXdkUsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLFlBQVksQ0FBQyxDQUFDO0FBQ3BDLE1BQU0sTUFBTSxHQUFHLE1BQU0sQ0FBQyxZQUFZLENBQUMsQ0FBQztBQUNwQyxNQUFNLFdBQVcsR0FBRyxNQUFNLENBQUMsZ0JBQWdCLENBQUMsQ0FBQztBQUM3QyxNQUFNLE9BQU8sR0FBRyxNQUFNLENBQUMsYUFBYSxDQUFDLENBQUM7QUFDdEMsTUFBTSxrQkFBa0IsR0FBRyxNQUFNLENBQUMsZ0JBQWdCLENBQUMsQ0FBQztBQUNwRCxNQUFNLGNBQWMsR0FBRyxNQUFNLENBQUMsWUFBWSxDQUFDLENBQUM7QUFPNUMsTUFBTSxDQUFDLE9BQU8sT0FBTyxPQUFRLFNBQVEsY0FBYztJQU9qRDs7O09BR0c7SUFDSCxTQUFTLENBQVM7SUFDbEI7OztPQUdHO0lBQ0gsb0JBQW9CLENBQVM7SUFFN0I7O09BRUc7SUFDSCxJQUFJLE9BQU87UUFDVCxJQUFJLE9BQU8sR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDNUIsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQ2IsSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLE9BQU8sR0FBRyxJQUFJLElBQUksQ0FBQyxHQUFHLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksRUFBRSxJQUFJLENBQUMsR0FBRyxD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
+import { Context as Context$1, Router, utils } from "@eggjs/core";
+import { assign } from "utility";
+import { diff, now } from "performance-ms";
+
+//#region src/app/extend/context.ts
+const HELPER = Symbol("ctx helper");
+const LOCALS = Symbol("ctx locals");
+const LOCALS_LIST = Symbol("ctx localsList");
+const COOKIES = Symbol("ctx cookies");
+const CONTEXT_HTTPCLIENT = Symbol("ctx httpclient");
+const CONTEXT_ROUTER = Symbol("ctx router");
+var Context = class extends Context$1 {
+	/**
+	* Request start time
+	* @member {Number} Context#starttime
+	*/
+	starttime;
+	/**
+	* Request start timer using `performance.now()`
+	* @member {Number} Context#performanceStarttime
+	*/
+	performanceStarttime;
+	/**
+	* Get the current visitor's cookies.
+	*/
+	get cookies() {
+		let cookies = this[COOKIES];
+		if (!cookies) this[COOKIES] = cookies = new this.app.ContextCookies(this, this.app.keys, this.app.config.cookies);
+		return cookies;
+	}
+	/**
+	* Get a wrapper httpclient instance contain ctx in the hold request process
+	*
+	* @return {HttpClient} the wrapper httpclient instance
+	*/
+	get httpclient() {
+		if (!this[CONTEXT_HTTPCLIENT]) this[CONTEXT_HTTPCLIENT] = new this.app.ContextHttpClient(this);
+		return this[CONTEXT_HTTPCLIENT];
+	}
+	/**
+	* Alias to {@link Context#httpclient}
+	*/
+	get httpClient() {
+		return this.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}
+	*/
+	async curl(url, options) {
+		return await 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]) return this[CONTEXT_ROUTER];
+		return this.app.router;
+	}
+	/**
+	* Set router to Context, only use on EggRouter
+	* @param {Router} 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
+	*/
+	getLogger(name) {
+		return this.app.getLogger(name);
+	}
+	/**
+	* Logger for Application
+	*
+	* @member {Logger} 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
+	*
+	* @member {Logger} 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] = assign({}, this.app.locals);
+		if (Array.isArray(this[LOCALS_LIST]) && this[LOCALS_LIST].length > 0) {
+			assign(this[LOCALS], this[LOCALS_LIST]);
+			this[LOCALS_LIST] = null;
+		}
+		return this[LOCALS];
+	}
+	set locals(val) {
+		const localsList = this[LOCALS_LIST] ?? [];
+		localsList.push(val);
+		this[LOCALS_LIST] = localsList;
+	}
+	/**
+	* 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, taskName) {
+		if (!taskName) taskName = Reflect.get(scope, "_name") || scope.name || utils.getCalleeFromStack(true);
+		setImmediate(() => {
+			this._runInBackground(scope, taskName);
+		});
+	}
+	async _runInBackground(scope, taskName) {
+		const startTime = now();
+		try {
+			await scope(this);
+			this.coreLogger.info("[egg:background] task:%s success (%dms)", taskName, diff(startTime));
+		} catch (err) {
+			this.coreLogger.info("[egg:background] task:%s fail (%dms)", taskName, diff(startTime));
+			err.runInBackground = true;
+			this.app.emit("error", err, this);
+		}
+	}
+	/**
+	* @member {Boolean} Context#acceptJSON
+	* @see Request#acceptJSON
+	* @since 1.0.0
+	*/
+	get acceptJSON() {
+		return this.request.acceptJSON;
+	}
+	get query() {
+		return this.request.query;
+	}
+	/**
+	* @member {Array} Context#queries
+	* @see Request#queries
+	* @since 1.0.0
+	*/
+	get queries() {
+		return this.request.queries;
+	}
+	/**
+	* @member {string} Context#ip
+	* @see Request#ip
+	* @since 1.0.0
+	*/
+	get ip() {
+		return this.request.ip;
+	}
+	set ip(val) {
+		this.request.ip = val;
+	}
+	/**
+	* @member {Number} Context#realStatus
+	* @see Response#realStatus
+	* @since 1.0.0
+	*/
+	get realStatus() {
+		return this.response.realStatus;
+	}
+	set realStatus(val) {
+		this.response.realStatus = val;
+	}
+};
+
+//#endregion
+export { Context as default };

package/dist/app/extend/helper.d.ts

@@ -1,37 +1,42 @@
-import { BaseContextClass } from '../../lib/core/base_context_class.ts';
+import { BaseContextClass } from "../../lib/core/base_context_class.js";
+
+//#region src/app/extend/helper.d.ts
+
 /**
- * The Helper class which can be used as utility function.
- * We support developers to extend Helper through ${baseDir}/app/extend/helper.js ,
- * then you can use all method on `ctx.helper` that is a instance of Helper.
- */
-export default class Helper extends BaseContextClass {
-    /**
-     * Generate URL path(without host) for route. Takes the route name and a map of named params.
-     * @function Helper#pathFor
-     * @param {String} name - Router Name
-     * @param {Object} params - Other params
-     *
-     * @example
-     * ```js
-     * app.get('home', '/index.htm', 'home.index');
-     * ctx.helper.pathFor('home', { by: 'recent', limit: 20 })
-     * => /index.htm?by=recent&limit=20
-     * ```
-     * @return {String} url path(without host)
-     */
-    pathFor(name: string, params: Record<string, any>): string;
-    /**
-     * Generate full URL(with host) for route. Takes the route name and a map of named params.
-     * @function Helper#urlFor
-     * @param {String} name - Router name
-     * @param {Object} params - Other params
-     * @example
-     * ```js
-     * app.get('home', '/index.htm', 'home.index');
-     * ctx.helper.urlFor('home', { by: 'recent', limit: 20 })
-     * => http://127.0.0.1:7001/index.htm?by=recent&limit=20
-     * ```
-     * @return {String} full url(with host)
-     */
-    urlFor(name: string, params: Record<string, any>): string;
+* The Helper class which can be used as utility function.
+* We support developers to extend Helper through ${baseDir}/app/extend/helper.js ,
+* then you can use all method on `ctx.helper` that is a instance of Helper.
+*/
+declare class Helper extends BaseContextClass {
+  /**
+  * Generate URL path(without host) for route. Takes the route name and a map of named params.
+  * @function Helper#pathFor
+  * @param {String} name - Router Name
+  * @param {Object} params - Other params
+  *
+  * @example
+  * ```js
+  * app.get('home', '/index.htm', 'home.index');
+  * ctx.helper.pathFor('home', { by: 'recent', limit: 20 })
+  * => /index.htm?by=recent&limit=20
+  * ```
+  * @return {String} url path(without host)
+  */
+  pathFor(name: string, params: Record<string, any>): string;
+  /**
+  * Generate full URL(with host) for route. Takes the route name and a map of named params.
+  * @function Helper#urlFor
+  * @param {String} name - Router name
+  * @param {Object} params - Other params
+  * @example
+  * ```js
+  * app.get('home', '/index.htm', 'home.index');
+  * ctx.helper.urlFor('home', { by: 'recent', limit: 20 })
+  * => http://127.0.0.1:7001/index.htm?by=recent&limit=20
+  * ```
+  * @return {String} full url(with host)
+  */
+  urlFor(name: string, params: Record<string, any>): string;
 }
+//#endregion
+export { Helper as default };