egg 4.1.0-beta.20 → 4.1.0-beta.22

package/dist/agent.d.ts

@@ -1,18 +1,4 @@
-import "./EggApplicationLoader-PnIvd5oV.js";
-import "./AppWorkerLoader-CT875rYM.js";
-import "./AgentWorkerLoader-DG_hAClt.js";
-import "./index-CUPkUUOR.js";
-import { BaseHookClass } from "./base_hook_class-R8A8gm1s.js";
-import "./response-DlNYDj00.js";
-import "./types.plugin-C3D5I7VD.js";
-import "./IMessenger-C9g6ypSI.js";
-import "./CookieLimitExceedError-CAW0HYJw.js";
-import "./MessageUnhandledRejectionError-Lq5fWw24.js";
-import "./index-CkgLZdB4.js";
-
-//#region src/agent.d.ts
-declare class EggAgentHook extends BaseHookClass {
-  configDidLoad(): void;
+import { BaseHookClass } from './lib/core/base_hook_class.ts';
+export default class EggAgentHook extends BaseHookClass {
+    configDidLoad(): void;
 }
-//#endregion
-export { EggAgentHook as default };

package/dist/agent.js

@@ -1,11 +1,7 @@
-import { BaseHookClass } from "./base_hook_class-D0Gu2p8r.js";
-
-//#region src/agent.ts
-var EggAgentHook = class extends BaseHookClass {
-	configDidLoad() {
-		this.agent._wrapMessenger();
-	}
-};
-
-//#endregion
-export { EggAgentHook as default };
+import { BaseHookClass } from "./lib/core/base_hook_class.js";
+export default class EggAgentHook extends BaseHookClass {
+    configDidLoad() {
+        this.agent._wrapMessenger();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvYWdlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBRTlELE1BQU0sQ0FBQyxPQUFPLE9BQU8sWUFBYSxTQUFRLGFBQWE7SUFDckQsYUFBYTtRQUNYLElBQUksQ0FBQyxLQUFLLENBQUMsY0FBYyxFQUFFLENBQUM7SUFDOUIsQ0FBQztDQUNGIn0=

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

@@ -1,12 +1,180 @@
-import "../../EggApplicationLoader-PnIvd5oV.js";
-import "../../AppWorkerLoader-CT875rYM.js";
-import "../../AgentWorkerLoader-DG_hAClt.js";
-import "../../index-CUPkUUOR.js";
-import { Context } from "../../base_hook_class-R8A8gm1s.js";
-import "../../response-DlNYDj00.js";
-import "../../types.plugin-C3D5I7VD.js";
-import "../../IMessenger-C9g6ypSI.js";
-import "../../CookieLimitExceedError-CAW0HYJw.js";
-import "../../MessageUnhandledRejectionError-Lq5fWw24.js";
-import "../../index-CkgLZdB4.js";
-export { Context as default };
+import { Context as EggCoreContext, Router } from '@eggjs/core';
+import type { Cookies as ContextCookies } from '@eggjs/cookies';
+import type { EggLogger } from 'egg-logger';
+import type { Application } from '../../lib/application.ts';
+import type { HttpClientRequestURL, HttpClientRequestOptions, HttpClient } from '../../lib/core/httpclient.ts';
+import type { BaseContextClass } from '../../lib//core/base_context_class.ts';
+import type Request from './request.ts';
+import type Response from './response.ts';
+import type Helper from './helper.ts';
+interface Cookies extends ContextCookies {
+    request: any;
+    response: any;
+}
+export default class Context extends EggCoreContext {
+    app: Application;
+    request: Request;
+    response: Response;
+    service: BaseContextClass;
+    proxy: any;
+    /**
+     * Request start time
+     * @member {Number} Context#starttime
+     */
+    starttime: number;
+    /**
+     * Request start timer using `performance.now()`
+     * @member {Number} Context#performanceStarttime
+     */
+    performanceStarttime: number;
+    /**
+     * Get the current visitor's cookies.
+     */
+    get cookies(): Cookies;
+    /**
+     * Get a wrapper httpclient instance contain ctx in the hold request process
+     *
+     * @return {HttpClient} the wrapper httpclient instance
+     */
+    get httpclient(): HttpClient;
+    /**
+     * Alias to {@link Context#httpclient}
+     */
+    get httpClient(): 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: HttpClientRequestURL, options?: HttpClientRequestOptions): ReturnType<HttpClient['request']>;
+    /**
+     * Alias to {@link Application#router}
+     *
+     * @member {Router} Context#router
+     * @since 1.0.0
+     * @example
+     * ```js
+     * this.router.pathFor('post', { id: 12 });
+     * ```
+     */
+    get router(): Router;
+    /**
+     * Set router to Context, only use on EggRouter
+     * @param {Router} val router instance
+     */
+    set router(val: Router);
+    /**
+     * Get helper instance from {@link Application#Helper}
+     *
+     * @member {Helper} Context#helper
+     * @since 1.0.0
+     */
+    get helper(): 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: string): EggLogger;
+    /**
+     * 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(): EggLogger;
+    /**
+     * Logger for frameworks and plugins
+     *
+     * @member {Logger} Context#coreLogger
+     * @since 1.0.0
+     */
+    get coreLogger(): EggLogger;
+    /**
+     * 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(): Record<string, any>;
+    set locals(val: Record<string, any>);
+    /**
+     * alias to {@link Context#locals}, compatible with koa that use this variable
+     * @member {Object} state
+     * @see Context#locals
+     */
+    get state(): Record<string, any>;
+    set state(val: Record<string, any>);
+    /**
+     * 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: (ctx: Context) => Promise<void>, taskName?: string): void;
+    _runInBackground(scope: (ctx: Context) => Promise<void>, taskName: string): Promise<void>;
+    /**
+     * @member {Boolean} Context#acceptJSON
+     * @see Request#acceptJSON
+     * @since 1.0.0
+     */
+    get acceptJSON(): boolean;
+    get query(): Record<string, string>;
+    /**
+     * @member {Array} Context#queries
+     * @see Request#queries
+     * @since 1.0.0
+     */
+    get queries(): Record<string, string[]>;
+    /**
+     * @member {string} Context#ip
+     * @see Request#ip
+     * @since 1.0.0
+     */
+    get ip(): string;
+    set ip(val: string);
+    /**
+     * @member {Number} Context#realStatus
+     * @see Response#realStatus
+     * @since 1.0.0
+     */
+    get realStatus(): number;
+    set realStatus(val: number);
+}
+export {};

package/dist/app/extend/context.js

@@ -1,3 +1,259 @@
-import { Context } from "../../context-D1Wg7CXs.js";
-
-export { Context as default };
+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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

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

@@ -1,12 +1,37 @@
-import "../../EggApplicationLoader-PnIvd5oV.js";
-import "../../AppWorkerLoader-CT875rYM.js";
-import "../../AgentWorkerLoader-DG_hAClt.js";
-import "../../index-CUPkUUOR.js";
-import { Helper } from "../../base_hook_class-R8A8gm1s.js";
-import "../../response-DlNYDj00.js";
-import "../../types.plugin-C3D5I7VD.js";
-import "../../IMessenger-C9g6ypSI.js";
-import "../../CookieLimitExceedError-CAW0HYJw.js";
-import "../../MessageUnhandledRejectionError-Lq5fWw24.js";
-import "../../index-CkgLZdB4.js";
-export { Helper as default };
+import { BaseContextClass } from '../../lib/core/base_context_class.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;
+}

package/dist/app/extend/helper.js

@@ -1,5 +1,43 @@
-import "../../base_context_logger-CZU59PGA.js";
-import "../../base_context_class-Xc1OZql9.js";
-import { Helper } from "../../helper-B3PKMPXq.js";
-
-export { Helper as default };
+import url from 'node:url';
+import { BaseContextClass } from "../../lib/core/base_context_class.js";
+/**
+ * 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, params) {
+        return this.app.router.url(name, params);
+    }
+    /**
+     * 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, params) {
+        return this.ctx.protocol + '://' + this.ctx.host + url.resolve('/', this.pathFor(name, params));
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2FwcC9leHRlbmQvaGVscGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sR0FBRyxNQUFNLFVBQVUsQ0FBQztBQUUzQixPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxzQ0FBc0MsQ0FBQztBQUV4RTs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLE9BQU8sT0FBTyxNQUFPLFNBQVEsZ0JBQWdCO0lBQ2xEOzs7Ozs7Ozs7Ozs7O09BYUc7SUFDSCxPQUFPLENBQUMsSUFBWSxFQUFFLE1BQTJCO1FBQy9DLE9BQU8sSUFBSSxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQztJQUMzQyxDQUFDO0lBRUQ7Ozs7Ozs7Ozs7OztPQVlHO0lBQ0gsTUFBTSxDQUFDLElBQVksRUFBRSxNQUEyQjtRQUM5QyxPQUFPLElBQUksQ0FBQyxHQUFHLENBQUMsUUFBUSxHQUFHLEtBQUssR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksR0FBRyxHQUFHLENBQUMsT0FBTyxDQUFDLEdBQUcsRUFBRSxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDO0lBQ2xHLENBQUM7Q0FDRiJ9