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

package/dist/lib/core/utils.js

@@ -1,3 +1,70 @@
-import { convertObject, safeParseURL } from "../../utils-B1Rjsoi9.js";
-
-export { convertObject, safeParseURL };
+import util from 'node:util';
+import { isSymbol, isRegExp, isPrimitive, isClass, isFunction, isGeneratorFunction, isAsyncFunction } from 'is-type-of';
+export function convertObject(obj, ignore = []) {
+    if (!Array.isArray(ignore)) {
+        ignore = [ignore];
+    }
+    for (const key of Object.keys(obj)) {
+        obj[key] = convertValue(key, obj[key], ignore);
+    }
+    return obj;
+}
+function convertValue(key, value, ignore) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    let hit = false;
+    for (const matchKey of ignore) {
+        if (typeof matchKey === 'string' && matchKey === key) {
+            hit = true;
+            break;
+        }
+        else if (isRegExp(matchKey) && matchKey.test(key)) {
+            hit = true;
+            break;
+        }
+    }
+    if (!hit) {
+        if (isSymbol(value) || isRegExp(value) || value instanceof URL) {
+            return value.toString();
+        }
+        if (isPrimitive(value) || Array.isArray(value)) {
+            return value;
+        }
+    }
+    // only convert recursively when it's a plain object,
+    // o = {}
+    if (Object.getPrototypeOf(value) === Object.prototype) {
+        return convertObject(value, ignore);
+    }
+    // support class
+    const name = value.name || 'anonymous';
+    if (isClass(value)) {
+        return `<Class ${name}>`;
+    }
+    // support generator function
+    if (isFunction(value)) {
+        if (isGeneratorFunction(value))
+            return `<GeneratorFunction ${name}>`;
+        if (isAsyncFunction(value))
+            return `<AsyncFunction ${name}>`;
+        return `<Function ${name}>`;
+    }
+    const typeName = value.constructor.name;
+    if (typeName) {
+        if (Buffer.isBuffer(value) || typeof value === 'string') {
+            return `<${typeName} len: ${value.length}>`;
+        }
+        return `<${typeName}>`;
+    }
+    return util.format(value);
+}
+export function safeParseURL(url) {
+    try {
+        return new URL(url);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL2NvcmUvdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBQzdCLE9BQU8sRUFBRSxRQUFRLEVBQUUsUUFBUSxFQUFFLFdBQVcsRUFBRSxPQUFPLEVBQUUsVUFBVSxFQUFFLG1CQUFtQixFQUFFLGVBQWUsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUV4SCxNQUFNLFVBQVUsYUFBYSxDQUFDLEdBQVEsRUFBRSxTQUFnRCxFQUFFO0lBQ3hGLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7UUFDM0IsTUFBTSxHQUFHLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDcEIsQ0FBQztJQUNELEtBQUssTUFBTSxHQUFHLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQ25DLEdBQUcsQ0FBQyxHQUFHLENBQUMsR0FBRyxZQUFZLENBQUMsR0FBRyxFQUFFLEdBQUcsQ0FBQyxHQUFHLENBQUMsRUFBRSxNQUFNLENBQUMsQ0FBQztJQUNqRCxDQUFDO0lBQ0QsT0FBTyxHQUFHLENBQUM7QUFDYixDQUFDO0FBRUQsU0FBUyxZQUFZLENBQUMsR0FBVyxFQUFFLEtBQVUsRUFBRSxNQUEyQjtJQUN4RSxJQUFJLEtBQUssS0FBSyxJQUFJLElBQUksS0FBSyxLQUFLLFNBQVMsRUFBRSxDQUFDO1FBQzFDLE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQztJQUVELElBQUksR0FBRyxHQUFHLEtBQUssQ0FBQztJQUNoQixLQUFLLE1BQU0sUUFBUSxJQUFJLE1BQU0sRUFBRSxDQUFDO1FBQzlCLElBQUksT0FBTyxRQUFRLEtBQUssUUFBUSxJQUFJLFFBQVEsS0FBSyxHQUFHLEVBQUUsQ0FBQztZQUNyRCxHQUFHLEdBQUcsSUFBSSxDQUFDO1lBQ1gsTUFBTTtRQUNSLENBQUM7YUFBTSxJQUFJLFFBQVEsQ0FBQyxRQUFRLENBQUMsSUFBSSxRQUFRLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7WUFDcEQsR0FBRyxHQUFHLElBQUksQ0FBQztZQUNYLE1BQU07UUFDUixDQUFDO0lBQ0gsQ0FBQztJQUNELElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUNULElBQUksUUFBUSxDQUFDLEtBQUssQ0FBQyxJQUFJLFFBQVEsQ0FBQyxLQUFLLENBQUMsSUFBSSxLQUFLLFlBQVksR0FBRyxFQUFFLENBQUM7WUFDL0QsT0FBTyxLQUFLLENBQUMsUUFBUSxFQUFFLENBQUM7UUFDMUIsQ0FBQztRQUNELElBQUksV0FBVyxDQUFDLEtBQUssQ0FBQyxJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUMvQyxPQUFPLEtBQUssQ0FBQztRQUNmLENBQUM7SUFDSCxDQUFDO0lBRUQscURBQXFEO0lBQ3JELFNBQVM7SUFDVCxJQUFJLE1BQU0sQ0FBQyxjQUFjLENBQUMsS0FBSyxDQUFDLEtBQUssTUFBTSxDQUFDLFNBQVMsRUFBRSxDQUFDO1FBQ3RELE9BQU8sYUFBYSxDQUFDLEtBQUssRUFBRSxNQUFNLENBQUMsQ0FBQztJQUN0QyxDQUFDO0lBRUQsZ0JBQWdCO0lBQ2hCLE1BQU0sSUFBSSxHQUFHLEtBQUssQ0FBQyxJQUFJLElBQUksV0FBVyxDQUFDO0lBQ3ZDLElBQUksT0FBTyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDbkIsT0FBTyxVQUFVLElBQUksR0FBRyxDQUFDO0lBQzNCLENBQUM7SUFFRCw2QkFBNkI7SUFDN0IsSUFBSSxVQUFVLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUN0QixJQUFJLG1CQUFtQixDQUFDLEtBQUssQ0FBQztZQUFFLE9BQU8sc0JBQXNCLElBQUksR0FBRyxDQUFDO1FBQ3JFLElBQUksZUFBZSxDQUFDLEtBQUssQ0FBQztZQUFFLE9BQU8sa0JBQWtCLElBQUksR0FBRyxDQUFDO1FBQzdELE9BQU8sYUFBYSxJQUFJLEdBQUcsQ0FBQztJQUM5QixDQUFDO0lBRUQsTUFBTSxRQUFRLEdBQUcsS0FBSyxDQUFDLFdBQVcsQ0FBQyxJQUFJLENBQUM7SUFDeEMsSUFBSSxRQUFRLEVBQUUsQ0FBQztRQUNiLElBQUksTUFBTSxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUN4RCxPQUFPLElBQUksUUFBUSxTQUFTLEtBQUssQ0FBQyxNQUFNLEdBQUcsQ0FBQztRQUM5QyxDQUFDO1FBQ0QsT0FBTyxJQUFJLFFBQVEsR0FBRyxDQUFDO0lBQ3pCLENBQUM7SUFFRCxPQUFPLElBQUksQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUM7QUFDNUIsQ0FBQztBQUVELE1BQU0sVUFBVSxZQUFZLENBQUMsR0FBVztJQUN0QyxJQUFJLENBQUM7UUFDSCxPQUFPLElBQUksR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQ3RCLENBQUM7SUFBQyxNQUFNLENBQUM7UUFDUCxPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7QUFDSCxDQUFDIn0=

package/dist/lib/egg.d.ts

@@ -1,12 +1,285 @@
-import "../EggApplicationLoader-PnIvd5oV.js";
-import "../AppWorkerLoader-CT875rYM.js";
-import "../AgentWorkerLoader-DG_hAClt.js";
-import "../index-CUPkUUOR.js";
-import { Context, EggApplicationCore, EggApplicationCoreOptions, EggContext, ILifecycleBoot, MiddlewareFunc, Next, Request, Router } from "../base_hook_class-R8A8gm1s.js";
-import { Response } from "../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, EggApplicationCore, EggApplicationCoreOptions, EggContext, ILifecycleBoot as IBoot, ILifecycleBoot, MiddlewareFunc, Next, Request, Response, Router };
+import { type IncomingMessage, type ServerResponse } from 'node:http';
+import type { AsyncLocalStorage } from 'node:async_hooks';
+import { EggCore, Router } from '@eggjs/core';
+import type { EggCoreOptions, Next, MiddlewareFunc as EggCoreMiddlewareFunc, ILifecycleBoot } from '@eggjs/core';
+import { EggContextLogger as ContextLogger, EggLoggers, EggLogger } from 'egg-logger';
+import { Cookies as ContextCookies } from '@eggjs/cookies';
+import type { Agent } from './agent.ts';
+import type { Application } from './application.ts';
+import Context from '../app/extend/context.ts';
+import Request from '../app/extend/request.ts';
+import Response from '../app/extend/response.ts';
+import type { EggAppConfig } from './types.ts';
+import { type IMessenger } from './core/messenger/index.ts';
+import { ContextHttpClient } from './core/context_httpclient.ts';
+import { HttpClient, type HttpClientRequestOptions, type HttpClientRequestURL, type HttpClientResponse, type HttpClientOptions } from './core/httpclient.ts';
+import { BaseContextClass } from './core/base_context_class.ts';
+import { BaseHookClass } from './core/base_hook_class.ts';
+import type { EggApplicationLoader } from './loader/index.ts';
+declare const EGG_PATH: unique symbol;
+export interface EggApplicationCoreOptions extends Omit<EggCoreOptions, 'baseDir'> {
+    mode?: 'cluster' | 'single' | 'all-in-one-process';
+    clusterPort?: number;
+    baseDir?: string;
+}
+export { Request, Response };
+export type { ILifecycleBoot, ILifecycleBoot as IBoot, Next, };
+export type EggContext = Context;
+export type MiddlewareFunc<T extends Context = Context> = EggCoreMiddlewareFunc<T>;
+export { Context, Router };
+/**
+ * Based on koa's Application
+ * @see https://github.com/eggjs/egg-core
+ * @see https://github.com/eggjs/koa/blob/master/src/application.ts
+ * @augments EggCore
+ */
+export declare class EggApplicationCore extends EggCore {
+    #private;
+    ctxStorage: AsyncLocalStorage<Context>;
+    /**
+     * Get the current request context from AsyncLocalStorage.
+     * This provides access to the context object for the current request lifecycle.
+     * @returns {Context | undefined} The current request context, or undefined if not in a request scope.
+     */
+    get currentContext(): Context | undefined;
+    ContextCookies: typeof ContextCookies;
+    ContextLogger: typeof ContextLogger;
+    ContextHttpClient: typeof ContextHttpClient;
+    HttpClient: typeof HttpClient;
+    HttpClientNext: typeof HttpClient;
+    /**
+     * Retrieve base context class
+     * @member {BaseContextClass} BaseContextClass
+     * @since 1.0.0
+     */
+    BaseContextClass: typeof BaseContextClass;
+    /**
+     * Retrieve base controller
+     * @member {Controller} Controller
+     * @since 1.0.0
+     */
+    Controller: typeof BaseContextClass;
+    /**
+     * Retrieve base service
+     * @member {Service} Service
+     * @since 1.0.0
+     */
+    Service: typeof BaseContextClass;
+    /**
+     * Retrieve base subscription
+     * @member {Subscription} Subscription
+     * @since 2.12.0
+     */
+    Subscription: typeof BaseContextClass;
+    /**
+     * Retrieve base context class
+     * @member {BaseHookClass} BaseHookClass
+     */
+    BaseHookClass: typeof BaseHookClass;
+    /**
+     * Retrieve base boot
+     * @member {Boot}
+     * @alias BaseHookClass
+     */
+    Boot: typeof BaseHookClass;
+    options: Required<EggApplicationCoreOptions>;
+    readonly messenger: IMessenger;
+    agent?: Agent;
+    application?: Application;
+    loader: EggApplicationLoader;
+    /**
+     * @class
+     * @param {Object} options
+     *  - {Object} [type] - type of instance, Agent and Application both extend koa, type can determine what it is.
+     *  - {String} [baseDir] - app root dir, default is `process.cwd()`
+     *  - {Object} [plugins] - custom plugin config, use it in unittest
+     *  - {String} [mode] - process mode, can be cluster / single, default is `cluster`
+     */
+    constructor(options?: EggApplicationCoreOptions);
+    /**
+     * @deprecated please use `options` property instead
+     */
+    get _options(): Required<EggApplicationCoreOptions>;
+    protected loadConfig(): Promise<void>;
+    protected load(): Promise<void>;
+    /**
+     * Usage: new ApiClient({ cluster: app.cluster })
+     */
+    get cluster(): (clientClass: unknown, options?: object) => any;
+    /**
+     * Wrap the Client with Leader/Follower Pattern
+     *
+     * @description almost the same as Agent.cluster API, the only different is that this method create Follower.
+     *
+     * @see https://github.com/node-modules/cluster-client
+     * @param {Function} clientClass - client class function
+     * @param {Object} [options]
+     *   - {Boolean} [autoGenerate] - whether generate delegate rule automatically, default is true
+     *   - {Function} [formatKey] - a method to transform the subscription info into a string，default is JSON.stringify
+     *   - {Object} [transcode|JSON.stringify/parse]
+     *     - {Function} encode - custom serialize method
+     *     - {Function} decode - custom deserialize method
+     *   - {Boolean} [isBroadcast] - whether broadcast subscription result to all followers or just one, default is true
+     *   - {Number} [responseTimeout] - response timeout, default is 3 seconds
+     *   - {Number} [maxWaitTime|30000] - leader startup max time, default is 30 seconds
+     * @return {ClientWrapper} wrapper
+     */
+    clusterWrapper(clientClass: unknown, options?: object): any;
+    /**
+     * print the information when console.log(app)
+     * @return {Object} inspected app.
+     * @since 1.0.0
+     * @example
+     * ```js
+     * console.log(app);
+     * =>
+     * {
+     *   name: 'mock-app',
+     *   env: 'test',
+     *   subdomainOffset: 2,
+     *   config: '<egg config>',
+     *   controller: '<egg controller>',
+     *   service: '<egg service>',
+     *   middlewares: '<egg middlewares>',
+     *   urllib: '<egg urllib>',
+     *   loggers: '<egg loggers>'
+     * }
+     * ```
+     */
+    inspect(): any;
+    toJSON(): any;
+    /**
+     * http request helper base on {@link httpclient}, it will auto save httpclient log.
+     * Keep the same api with `httpclient.request(url, args)`.
+     *
+     * See https://github.com/node-modules/urllib#api-doc for more details.
+     *
+     * @param {String} url request url address.
+     * @param {Object} options
+     * - method {String} - Request method, defaults to GET. Could be GET, POST, DELETE or PUT. Alias 'type'.
+     * - data {Object} - Data to be sent. Will be stringify automatically.
+     * - dataType {String} - String - Type of response data. Could be `text` or `json`.
+     *   If it's `text`, the callback data would be a String.
+     *   If it's `json`, the data of callback would be a parsed JSON Object.
+     *   Default callback data would be a Buffer.
+     * - headers {Object} - Request headers.
+     * - timeout {Number} - Request timeout in milliseconds. Defaults to exports.TIMEOUT.
+     *   Include remote server connecting timeout and response timeout.
+     *   When timeout happen, will return ConnectionTimeout or ResponseTimeout.
+     * - auth {String} - `username:password` used in HTTP Basic Authorization.
+     * - followRedirect {Boolean} - follow HTTP 3xx responses as redirects. defaults to false.
+     * - gzip {Boolean} - let you get the res object when request connected, default false. alias customResponse
+     * - nestedQuerystring {Boolean} - urllib default use querystring to stringify form data which don't
+     *   support nested object, will use qs instead of querystring to support nested object by set this option to true.
+     * - more options see https://github.com/node-modules/urllib
+     * @return {Object}
+     * - status {Number} - HTTP response status
+     * - headers {Object} - HTTP response headers
+     * - res {Object} - HTTP response meta
+     * - data {Object} - HTTP response body
+     *
+     * @example
+     * ```js
+     * const result = await app.curl('http://example.com/foo.json', {
+     *   method: 'GET',
+     *   dataType: 'json',
+     * });
+     * console.log(result.status, result.headers, result.data);
+     * ```
+     */
+    curl<T = any>(url: HttpClientRequestURL, options?: HttpClientRequestOptions): Promise<HttpClientResponse<T>>;
+    /**
+     * Create a new HttpClient instance with custom options
+     * @param {Object} [options] HttpClient init options
+     */
+    createHttpClient(options?: HttpClientOptions): HttpClient;
+    /**
+     * HttpClient instance
+     * @see https://github.com/node-modules/urllib
+     * @member {HttpClient}
+     */
+    get httpClient(): HttpClient;
+    /**
+     * @deprecated please use httpClient instead
+     * @alias httpClient
+     * @member {HttpClient}
+     */
+    get httpclient(): HttpClient;
+    /**
+     * All loggers contain logger, coreLogger and customLogger
+     * @member {Object}
+     * @since 1.0.0
+     */
+    get loggers(): EggLoggers;
+    /**
+     * Get logger by name, it's equal to app.loggers['name'],
+     * but you can extend it with your own logical.
+     * @param {String} name - logger name
+     * @return {Logger} logger
+     */
+    getLogger(name: string): EggLogger;
+    /**
+     * application logger, log file is `$HOME/logs/{appname}/{appname}-web`
+     * @member {Logger}
+     * @since 1.0.0
+     */
+    get logger(): EggLogger;
+    /**
+     * core logger for framework and plugins, log file is `$HOME/logs/{appname}/egg-web`
+     * @member {Logger}
+     * @since 1.0.0
+     */
+    get coreLogger(): EggLogger;
+    _unhandledRejectionHandler(err: any): void;
+    /**
+     * dump out the config and meta object
+     * @private
+     */
+    dumpConfigToObject(): {
+        config: Record<string, any>;
+        meta: Record<string, any>;
+    };
+    /**
+     * save app.config to `run/${type}_config.json`
+     * @private
+     */
+    dumpConfig(): void;
+    dumpTiming(): void;
+    get [EGG_PATH](): string;
+    get config(): EggAppConfig;
+    /**
+     * app.env delegate app.config.env
+     * @deprecated
+     */
+    get env(): string;
+    set env(_: string);
+    /**
+     * app.proxy delegate app.config.proxy
+     * @deprecated
+     */
+    get proxy(): boolean;
+    set proxy(_: boolean);
+    /**
+     * Create an anonymous context, the context isn't request level, so the request is mocked.
+     * then you can use context level API like `ctx.service`
+     * @member {String} EggApplication#createAnonymousContext
+     * @param {Request} [req] - if you want to mock request like querystring, you can pass an object to this function.
+     * @return {Context} context
+     */
+    createAnonymousContext(req?: any): EggContext;
+    /**
+     * Run async function in the anonymous context scope
+     * @see Context#runInAnonymousContextScope
+     * @param {Function} scope - the first args is an anonymous ctx, scope should be async function
+     * @param {Request} [req] - if you want to mock request like querystring, you can pass an object to this function.
+     */
+    runInAnonymousContextScope(scope: (ctx: Context) => Promise<void>, req?: unknown): Promise<void>;
+    /**
+     * Create egg context
+     * @function EggApplication#createContext
+     * @param  {Req} req - node native Request object
+     * @param  {Res} res - node native Response object
+     * @return {Context} context object
+     */
+    createContext(req: IncomingMessage, res: ServerResponse): Context;
+}