egg 4.1.2-beta.1 → 4.1.2-beta.10

package/dist/index.d.ts

@@ -14,11 +14,37 @@ import { BaseContextClass } from "./lib/core/base_context_class.js";
 import Helper from "./app/extend/helper.js";
 import { SingleModeAgent, SingleModeApplication, StartEggOptions, startEgg } from "./lib/start.js";
 import { EggConfigFactory, EggPluginFactory, EggPluginMeta, EggPluginOptions, PartialEggConfig, defineConfig, defineConfigFactory, definePluginFactory } from "./lib/define.js";
+import { buildSnapshot, restoreSnapshot } from "./lib/snapshot.js";
 import { CookieLimitExceedError } from "./lib/error/CookieLimitExceedError.js";
 import { MessageUnhandledRejectionError } from "./lib/error/MessageUnhandledRejectionError.js";
+import { CreateTransparentProxyOptions, createTransparentProxy } from "./lib/core/utils.js";
 import { BaseHookClass } from "./lib/core/base_hook_class.js";
 import { Singleton, SingletonCreateMethod, SingletonOptions } from "@eggjs/core";
 import { EggLogger, EggLogger as Logger, LoggerLevel } from "egg-logger";
 import { AccessLevel, Acl, BackgroundTaskHelper, ContextEventBus, ContextProto, Cookies, EggObjectFactory, EggObjectLifecycle, EggProtoImplClass, EggQualifier, EggType, Event, EventBus, EventContext, Events, HTTPBody, HTTPContext, HTTPController, HTTPCookies, HTTPHeaders, HTTPMethod, HTTPMethodEnum, HTTPParam, HTTPParamType, HTTPQueries, HTTPQuery, HTTPRequest, Host, ImplDecorator, IncomingHttpHeaders, Inject, InjectOptional, LifecycleDestroy, LifecycleInit, LifecyclePostConstruct, LifecyclePostInject, LifecyclePreDestroy, LifecyclePreInject, LifecyclePreLoad, MetadataUtil, Middleware, MultiInstanceProto, MultiInstancePrototypeGetObjectsContext, ObjectInfo, ObjectInitType, ObjectInitTypeLike, QualifierImplDecoratorUtil, QualifierUtil, SingletonProto } from "@eggjs/tegg";
 export * from "@eggjs/cluster";
-export { AccessLevel, Acl, Agent, AgentWorkerLoader, AppWorkerLoader, Application, BackgroundTaskHelper, BaseContextClass, BaseHookClass as Boot, ClientErrorResponse, type EggAppConfig as Config, Context, type ContextEventBus, ContextHttpClient, ContextProto, BaseContextClass as Controller, BaseContextClass as Service, BaseContextClass as Subscription, CookieLimitExceedError, Cookies, CustomLoaderConfig, EggAppConfig, EggAppInfo, EggApplicationCore, EggApplicationCoreOptions, EggConfigFactory, EggContext, HttpClient as EggContextHttpClient, HttpClient as EggHttpClient, HttpClient, EggEnvType, type EggLogger, EggLoggerConfig, type EggObjectFactory, type EggObjectLifecycle, EggPlugin, EggPluginFactory, EggPluginItem, EggPluginMeta, EggPluginOptions, type EggProtoImplClass, EggQualifier, EggType, Event, type EventBus, EventContext, type Events, HTTPBody, HTTPContext, HTTPController, HTTPCookies, HTTPHeaders, HTTPMethod, HTTPMethodEnum, HTTPParam, HTTPParamType, HTTPQueries, HTTPQuery, HTTPRequest, Helper, type Helper as IHelper, Host, HttpClientConfig, HttpClientOptions, HttpClientRequestOptions, HttpClientRequestURL, HttpClientResponse, ILifecycleBoot as IBoot, ILifecycleBoot, IController, IEggPluginItem, IService, type ImplDecorator, type IncomingHttpHeaders, Inject, InjectOptional, LifecycleDestroy, LifecycleInit, LifecyclePostConstruct, LifecyclePostInject, LifecyclePreDestroy, LifecyclePreInject, LifecyclePreLoad, type Logger, type LoggerLevel, MessageUnhandledRejectionError, MetadataUtil, Middleware, MiddlewareFunc, MultiInstanceProto, type MultiInstancePrototypeGetObjectsContext, Next, type ObjectInfo, ObjectInitType, type ObjectInitTypeLike, PartialDeep, PartialEggConfig, PowerPartial, QualifierImplDecoratorUtil, QualifierUtil, Request, RequestObjectBody, Response, Router, type SingleModeAgent, type SingleModeApplication, Singleton, type SingletonCreateMethod, type SingletonOptions, SingletonProto, StartEggOptions, defineConfig, defineConfigFactory, definePluginFactory, startEgg as start, startEgg };
+
+//#region src/index.d.ts
+declare const Config: typeof EggAppConfig;
+/**
+* Egg Application Config, can be injected into Proto, e.g. SingletonProto/ContextProto/HttpController.
+*
+* Usage:
+* ```ts
+* import { Inject, Config } from 'egg';
+*
+* @SingletonProto()
+* class FooService {
+*   @Inject()
+*   config: Config;
+*
+*   async bar() {
+*     console.log(this.config.env);
+*   }
+* }
+* ```
+* @since 4.1.0
+*/
+type Config = EggAppConfig;
+//#endregion
+export { AccessLevel, Acl, Agent, AgentWorkerLoader, AppWorkerLoader, Application, BackgroundTaskHelper, BaseContextClass, BaseHookClass as Boot, ClientErrorResponse, Config, Context, type ContextEventBus, ContextHttpClient, ContextProto, BaseContextClass as Controller, BaseContextClass as Service, BaseContextClass as Subscription, CookieLimitExceedError, Cookies, type CreateTransparentProxyOptions, CustomLoaderConfig, EggAppConfig, EggAppInfo, EggApplicationCore, EggApplicationCoreOptions, EggConfigFactory, EggContext, HttpClient as EggContextHttpClient, HttpClient as EggHttpClient, HttpClient, EggEnvType, type EggLogger, EggLoggerConfig, type EggObjectFactory, type EggObjectLifecycle, EggPlugin, EggPluginFactory, EggPluginItem, EggPluginMeta, EggPluginOptions, type EggProtoImplClass, EggQualifier, EggType, Event, type EventBus, EventContext, type Events, HTTPBody, HTTPContext, HTTPController, HTTPCookies, HTTPHeaders, HTTPMethod, HTTPMethodEnum, HTTPParam, HTTPParamType, HTTPQueries, HTTPQuery, HTTPRequest, Helper, type Helper as IHelper, Host, HttpClientConfig, HttpClientOptions, HttpClientRequestOptions, HttpClientRequestURL, HttpClientResponse, ILifecycleBoot as IBoot, ILifecycleBoot, IController, IEggPluginItem, IService, type ImplDecorator, type IncomingHttpHeaders, Inject, InjectOptional, LifecycleDestroy, LifecycleInit, LifecyclePostConstruct, LifecyclePostInject, LifecyclePreDestroy, LifecyclePreInject, LifecyclePreLoad, Logger, type LoggerLevel, MessageUnhandledRejectionError, MetadataUtil, Middleware, MiddlewareFunc, MultiInstanceProto, type MultiInstancePrototypeGetObjectsContext, Next, type ObjectInfo, ObjectInitType, type ObjectInitTypeLike, PartialDeep, PartialEggConfig, PowerPartial, QualifierImplDecoratorUtil, QualifierUtil, Request, RequestObjectBody, Response, Router, type SingleModeAgent, type SingleModeApplication, Singleton, type SingletonCreateMethod, type SingletonOptions, SingletonProto, StartEggOptions, buildSnapshot, createTransparentProxy, defineConfig, defineConfigFactory, definePluginFactory, restoreSnapshot, startEgg as start, startEgg };

package/dist/index.js

@@ -8,18 +8,25 @@ import { ContextHttpClient } from "./lib/core/context_httpclient.js";
 import { HttpClient } from "./lib/core/httpclient.js";
 import { CookieLimitExceedError } from "./lib/error/CookieLimitExceedError.js";
 import { MessageUnhandledRejectionError } from "./lib/error/MessageUnhandledRejectionError.js";
+import { createTransparentProxy } from "./lib/core/utils.js";
 import { EggApplicationCore, Router } from "./lib/egg.js";
 import { AppWorkerLoader } from "./lib/loader/AppWorkerLoader.js";
 import { AgentWorkerLoader } from "./lib/loader/AgentWorkerLoader.js";
 import "./lib/loader/index.js";
 import { Agent } from "./lib/agent.js";
 import { Application } from "./lib/application.js";
-import "./lib/types.js";
+import { EggAppConfig } from "./lib/types.js";
 import { startEgg } from "./lib/start.js";
 import { defineConfig, defineConfigFactory, definePluginFactory } from "./lib/define.js";
+import { buildSnapshot, restoreSnapshot } from "./lib/snapshot.js";
 import { Singleton } from "@eggjs/core";
+import { EggLogger as Logger } from "egg-logger";
 import { AccessLevel, Acl, BackgroundTaskHelper, ContextProto, Cookies, EggQualifier, EggType, Event, EventContext, HTTPBody, HTTPContext, HTTPController, HTTPCookies, HTTPHeaders, HTTPMethod, HTTPMethodEnum, HTTPParam, HTTPParamType, HTTPQueries, HTTPQuery, HTTPRequest, Host, Inject, InjectOptional, LifecycleDestroy, LifecycleInit, LifecyclePostConstruct, LifecyclePostInject, LifecyclePreDestroy, LifecyclePreInject, LifecyclePreLoad, MetadataUtil, Middleware, MultiInstanceProto, ObjectInitType, QualifierImplDecoratorUtil, QualifierUtil, SingletonProto } from "@eggjs/tegg";
 
 export * from "@eggjs/cluster"
 
-export { AccessLevel, Acl, Agent, AgentWorkerLoader, AppWorkerLoader, Application, BackgroundTaskHelper, BaseContextClass, BaseHookClass as Boot, Context, ContextHttpClient, ContextProto, BaseContextClass as Controller, BaseContextClass as Service, BaseContextClass as Subscription, CookieLimitExceedError, Cookies, EggApplicationCore, EggQualifier, EggType, Event, EventContext, HTTPBody, HTTPContext, HTTPController, HTTPCookies, HTTPHeaders, HTTPMethod, HTTPMethodEnum, HTTPParam, HTTPParamType, HTTPQueries, HTTPQuery, HTTPRequest, Helper, Host, HttpClient, Inject, InjectOptional, LifecycleDestroy, LifecycleInit, LifecyclePostConstruct, LifecyclePostInject, LifecyclePreDestroy, LifecyclePreInject, LifecyclePreLoad, MessageUnhandledRejectionError, MetadataUtil, Middleware, MultiInstanceProto, ObjectInitType, QualifierImplDecoratorUtil, QualifierUtil, Request, Response, Router, Singleton, SingletonProto, defineConfig, defineConfigFactory, definePluginFactory, startEgg as start, startEgg };
+//#region src/index.ts
+const Config = EggAppConfig;
+
+//#endregion
+export { AccessLevel, Acl, Agent, AgentWorkerLoader, AppWorkerLoader, Application, BackgroundTaskHelper, BaseContextClass, BaseHookClass as Boot, Config, Context, ContextHttpClient, ContextProto, BaseContextClass as Controller, BaseContextClass as Service, BaseContextClass as Subscription, CookieLimitExceedError, Cookies, EggAppConfig, EggApplicationCore, EggQualifier, EggType, Event, EventContext, HTTPBody, HTTPContext, HTTPController, HTTPCookies, HTTPHeaders, HTTPMethod, HTTPMethodEnum, HTTPParam, HTTPParamType, HTTPQueries, HTTPQuery, HTTPRequest, Helper, Host, HttpClient, Inject, InjectOptional, LifecycleDestroy, LifecycleInit, LifecyclePostConstruct, LifecyclePostInject, LifecyclePreDestroy, LifecyclePreInject, LifecyclePreLoad, Logger, MessageUnhandledRejectionError, MetadataUtil, Middleware, MultiInstanceProto, ObjectInitType, QualifierImplDecoratorUtil, QualifierUtil, Request, Response, Router, Singleton, SingletonProto, buildSnapshot, createTransparentProxy, defineConfig, defineConfigFactory, definePluginFactory, restoreSnapshot, startEgg as start, startEgg };

package/dist/lib/agent.d.ts

@@ -15,6 +15,12 @@ declare class Agent extends EggApplicationCore {
   * @param {Object} options - see {@link EggApplicationCore}
   */
   constructor(options?: Omit<EggApplicationCoreOptions, "type">);
+  /**
+  * Start the keepalive timer that prevents the agent process from exiting
+  * when it has no pending I/O. Called from configDidLoad so that the timer
+  * is not created during snapshot build (configDidLoad is skipped in snapshot mode).
+  */
+  protected startKeepAlive(): void;
   protected customEggLoader(): typeof AgentWorkerLoader;
   _wrapMessenger(): void;
   close(): Promise<void>;

package/dist/lib/agent.js

@@ -18,6 +18,15 @@ var Agent = class extends EggApplicationCore {
 			...options,
 			type: "agent"
 		});
+		this.lifecycle.addBootHook({ configDidLoad: () => this.startKeepAlive() });
+	}
+	/**
+	* Start the keepalive timer that prevents the agent process from exiting
+	* when it has no pending I/O. Called from configDidLoad so that the timer
+	* is not created during snapshot build (configDidLoad is skipped in snapshot mode).
+	*/
+	startKeepAlive() {
+		if (this.#agentAliveHandler) return;
 		this.#agentAliveHandler = setInterval(() => {
 			this.coreLogger.info("[]");
 		}, 1440 * 60 * 1e3);
@@ -46,7 +55,10 @@ var Agent = class extends EggApplicationCore {
 		}
 	}
 	async close() {
-		clearInterval(this.#agentAliveHandler);
+		if (this.#agentAliveHandler) {
+			clearInterval(this.#agentAliveHandler);
+			this.#agentAliveHandler = void 0;
+		}
 		await super.close();
 	}
 };

package/dist/lib/core/httpclient.js

@@ -17,6 +17,10 @@ var HttpClient = class extends HttpClient$1 {
 		};
 		super(initOptions);
 		this.#app = app;
+		if (config.interceptors?.length) {
+			const originalDispatcher = this.getDispatcher();
+			this.setDispatcher(originalDispatcher.compose(...config.interceptors));
+		}
 	}
 	async request(url, options) {
 		options = options ?? {};

package/dist/lib/core/utils.d.ts

@@ -1,5 +1,30 @@
 //#region src/lib/core/utils.d.ts
 declare function convertObject(obj: any, ignore?: string | RegExp | (string | RegExp)[]): any;
 declare function safeParseURL(url: string): URL | null;
+interface CreateTransparentProxyOptions<T> {
+  /**
+  * Factory function to lazily create the real object.
+  * Called at most once, on first property access.
+  */
+  createReal: () => T;
+  /**
+  * Whether to bind functions from the real object to the real instance.
+  * Defaults to true.
+  */
+  bindFunctions?: boolean;
+}
+/**
+* Create a Proxy that behaves like the real object, but remains transparent to
+* monkeypatch libraries (e.g. defineProperty-based overrides like egg-mock's `mm()`).
+*
+* - Lazily creates the real object on first access.
+* - Allows overriding properties on the proxy target (overlay) — e.g. via `Object.defineProperty`.
+* - Delegates everything else to the real object.
+*
+* This is used to defer HttpClient construction so plugins can modify
+* `config.httpclient.lookup` after the first access to `app.httpClient` but
+* before any actual HTTP request is made.
+*/
+declare function createTransparentProxy<T extends object>(options: CreateTransparentProxyOptions<T>): T;
 //#endregion
-export { convertObject, safeParseURL };
+export { CreateTransparentProxyOptions, convertObject, createTransparentProxy, safeParseURL };

package/dist/lib/core/utils.js

@@ -43,6 +43,76 @@ function safeParseURL(url) {
 		return null;
 	}
 }
+/**
+* Create a Proxy that behaves like the real object, but remains transparent to
+* monkeypatch libraries (e.g. defineProperty-based overrides like egg-mock's `mm()`).
+*
+* - Lazily creates the real object on first access.
+* - Allows overriding properties on the proxy target (overlay) — e.g. via `Object.defineProperty`.
+* - Delegates everything else to the real object.
+*
+* This is used to defer HttpClient construction so plugins can modify
+* `config.httpclient.lookup` after the first access to `app.httpClient` but
+* before any actual HTTP request is made.
+*/
+function createTransparentProxy(options) {
+	const { createReal, bindFunctions = true } = options;
+	if (typeof createReal !== "function") throw new TypeError("createReal must be a function");
+	let real;
+	let cachedError;
+	const boundFnCache = /* @__PURE__ */ new WeakMap();
+	const getReal = () => {
+		if (real) return real;
+		if (cachedError) throw cachedError;
+		try {
+			return real = createReal();
+		} catch (err) {
+			cachedError = err;
+			throw err;
+		}
+	};
+	const hasOwn = (obj, prop) => Reflect.getOwnPropertyDescriptor(obj, prop) !== void 0;
+	return new Proxy({}, {
+		get(target, prop, receiver) {
+			const r = getReal();
+			if (hasOwn(target, prop)) return Reflect.get(target, prop, receiver);
+			const value = Reflect.get(r, prop);
+			if (bindFunctions && typeof value === "function") {
+				let bound = boundFnCache.get(value);
+				if (!bound) {
+					bound = value.bind(r);
+					boundFnCache.set(value, bound);
+				}
+				return bound;
+			}
+			return value;
+		},
+		set(target, prop, value) {
+			const r = getReal();
+			if (hasOwn(target, prop)) return Reflect.set(target, prop, value);
+			return Reflect.set(r, prop, value);
+		},
+		has(target, prop) {
+			return Reflect.has(target, prop) || Reflect.has(getReal(), prop);
+		},
+		ownKeys(target) {
+			return [...new Set([...Reflect.ownKeys(getReal()), ...Reflect.ownKeys(target)])];
+		},
+		getOwnPropertyDescriptor(target, prop) {
+			return Reflect.getOwnPropertyDescriptor(target, prop) ?? Reflect.getOwnPropertyDescriptor(getReal(), prop);
+		},
+		deleteProperty(target, prop) {
+			if (hasOwn(target, prop)) return Reflect.deleteProperty(target, prop);
+			return Reflect.deleteProperty(getReal(), prop);
+		},
+		getPrototypeOf() {
+			return Reflect.getPrototypeOf(getReal());
+		},
+		defineProperty(target, prop, descriptor) {
+			return Reflect.defineProperty(target, prop, descriptor);
+		}
+	});
+}
 
 //#endregion
-export { convertObject, safeParseURL };
+export { convertObject, createTransparentProxy, safeParseURL };

package/dist/lib/egg.d.ts

@@ -82,6 +82,12 @@ declare class EggApplicationCore extends EggCore {
   */
   Boot: typeof BaseHookClass;
   options: Required<EggApplicationCoreOptions>;
+  /**
+  * Promise that resolves when the `load()` method has finished.
+  * This is useful for callers that need to ensure config and metadata
+  * are fully loaded before proceeding.
+  */
+  readonly loadFinished: Promise<void>;
   readonly messenger: IMessenger;
   agent?: Agent;
   application?: Application;
@@ -194,6 +200,13 @@ declare class EggApplicationCore extends EggCore {
   createHttpClient(options?: HttpClientOptions): HttpClient;
   /**
   * HttpClient instance
+  *
+  * Returns a transparent proxy that defers actual HttpClient construction
+  * until a method/property is first accessed. This allows plugins to modify
+  * `config.httpclient.lookup` or other options during lifecycle hooks
+  * (e.g. `configWillLoad`, `didLoad`) even after `app.httpClient` is
+  * first referenced.
+  *
   * @see https://github.com/node-modules/urllib
   * @member {HttpClient}
   */
@@ -231,6 +244,19 @@ declare class EggApplicationCore extends EggCore {
   get coreLogger(): EggLogger;
   _unhandledRejectionHandler(err: any): void;
   /**
+  * Clean up non-serializable resources before V8 heap serialization.
+  * Closes messenger (IPC listeners), loggers (file descriptors),
+  * and removes the process-level unhandledRejection listener.
+  */
+  protected snapshotWillSerialize(): void;
+  /**
+  * Restore non-serializable resources after V8 heap deserialization.
+  * Recreates messenger, re-registers the egg-ready listener,
+  * and re-attaches the process-level unhandledRejection listener.
+  * Loggers are lazily re-created via the `loggers` getter.
+  */
+  protected snapshotDidDeserialize(): void;
+  /**
   * dump out the config and meta object
   * @private
   */
@@ -244,6 +270,11 @@ declare class EggApplicationCore extends EggCore {
   */
   dumpConfig(): void;
   dumpTiming(): void;
+  /**
+  * Generate and save startup manifest for faster subsequent startups.
+  * Only generates when no valid manifest was loaded (avoids overwriting during manifest-accelerated starts).
+  */
+  dumpManifest(): void;
   protected customEggPaths(): string[];
   get config(): EggAppConfig$1;
   /**

package/dist/lib/egg.js

@@ -7,9 +7,9 @@ import { ContextHttpClient } from "./core/context_httpclient.js";
 import { HttpClient } from "./core/httpclient.js";
 import { createLoggers } from "./core/logger.js";
 import { create } from "./core/messenger/index.js";
-import { convertObject } from "./core/utils.js";
+import { convertObject, createTransparentProxy } from "./core/utils.js";
 import assert from "node:assert";
-import { EggCore, Router, utils } from "@eggjs/core";
+import { EggCore, ManifestStore, Router, utils } from "@eggjs/core";
 import path from "node:path";
 import fs from "node:fs";
 import http from "node:http";
@@ -79,7 +79,16 @@ var EggApplicationCore = class extends EggCore {
 	Boot = BaseHookClass;
 	#httpClient;
 	#loggers;
+	#startTimeoutTimer;
 	#clusterClients = [];
+	#loadFinishedResolve;
+	#loadFinishedReject;
+	/**
+	* Promise that resolves when the `load()` method has finished.
+	* This is useful for callers that need to ensure config and metadata
+	* are fully loaded before proceeding.
+	*/
+	loadFinished;
 	messenger;
 	agent;
 	application;
@@ -99,6 +108,10 @@ var EggApplicationCore = class extends EggCore {
 			...options
 		};
 		super(options);
+		this.loadFinished = new Promise((resolve, reject) => {
+			this.#loadFinishedResolve = resolve;
+			this.#loadFinishedReject = reject;
+		});
 		/**
 		* messenger instance
 		* @member {Messenger}
@@ -108,8 +121,18 @@ var EggApplicationCore = class extends EggCore {
 		this.messenger.once("egg-ready", () => {
 			this.lifecycle.triggerServerDidReady();
 		});
+		this.lifecycle.addBootHook({
+			snapshotWillSerialize: () => this.snapshotWillSerialize(),
+			snapshotDidDeserialize: () => this.snapshotDidDeserialize()
+		});
 		this.lifecycle.registerBeforeStart(async () => {
-			await this.load();
+			try {
+				await this.load();
+				this.#loadFinishedResolve();
+			} catch (err) {
+				this.#loadFinishedReject(err);
+				throw err;
+			}
 		}, "load files");
 	}
 	/**
@@ -123,27 +146,38 @@ var EggApplicationCore = class extends EggCore {
 	}
 	async load() {
 		await this.loadConfig();
-		this.ready(() => process.nextTick(() => {
-			const dumpStartTime = Date.now();
-			this.dumpConfig();
-			this.dumpTiming();
-			this.coreLogger.info("[egg] dump config after ready, %sms", Date.now() - dumpStartTime);
-		}));
-		this.#setupTimeoutTimer();
+		if (!this.options.snapshot) {
+			this.ready(() => process.nextTick(() => {
+				const dumpStartTime = Date.now();
+				this.dumpConfig();
+				this.dumpTiming();
+				this.dumpManifest();
+				ManifestStore.flushCompileCache();
+				this.coreLogger.info("[egg] dump config after ready, %sms", Date.now() - dumpStartTime);
+			}));
+			this.#setupTimeoutTimer();
+		}
 		this.console.info("[egg] App root: %s", this.baseDir);
 		this.console.info("[egg] All *.log files save on %j", this.config.logger.dir);
 		assert(this.config.logger.dir, "logger.dir is required");
 		this.console.info("[egg] Loaded enabled plugin %j", this.loader.orderPlugins);
 		this._unhandledRejectionHandler = this._unhandledRejectionHandler.bind(this);
 		process.on("unhandledRejection", this._unhandledRejectionHandler);
-		this.lifecycle.registerBeforeClose(async () => {
+		if (!this.lifecycle.registerBeforeClose(async () => {
 			for (const clusterClient of this.#clusterClients) await close(clusterClient);
 			this.#clusterClients = [];
-			if (this.type === "application" && this.options.mode === "single") await this.agent.close();
+			if (this.type === "application" && this.options.mode === "single") await this.agent?.close();
+			ManifestStore.flushCompileCache();
 			for (const logger of this.loggers.values()) logger.close();
 			this.messenger.close();
 			process.removeListener("unhandledRejection", this._unhandledRejectionHandler);
-		});
+		})) {
+			this.#clearStartTimeoutTimer();
+			process.removeListener("unhandledRejection", this._unhandledRejectionHandler);
+			this.messenger.close();
+			if (this.#loggers) for (const logger of this.#loggers.values()) logger.close();
+			return;
+		}
 		await this.loader.load();
 	}
 	/**
@@ -282,11 +316,18 @@ var EggApplicationCore = class extends EggCore {
 	}
 	/**
 	* HttpClient instance
+	*
+	* Returns a transparent proxy that defers actual HttpClient construction
+	* until a method/property is first accessed. This allows plugins to modify
+	* `config.httpclient.lookup` or other options during lifecycle hooks
+	* (e.g. `configWillLoad`, `didLoad`) even after `app.httpClient` is
+	* first referenced.
+	*
 	* @see https://github.com/node-modules/urllib
 	* @member {HttpClient}
 	*/
 	get httpClient() {
-		if (!this.#httpClient) this.#httpClient = this.createHttpClient();
+		if (!this.#httpClient) this.#httpClient = createTransparentProxy({ createReal: () => this.createHttpClient() });
 		return this.#httpClient;
 	}
 	/**
@@ -346,6 +387,32 @@ var EggApplicationCore = class extends EggCore {
 		this.coreLogger.error(err);
 	}
 	/**
+	* Clean up non-serializable resources before V8 heap serialization.
+	* Closes messenger (IPC listeners), loggers (file descriptors),
+	* and removes the process-level unhandledRejection listener.
+	*/
+	snapshotWillSerialize() {
+		this.messenger.close();
+		if (this.#loggers) {
+			for (const logger of this.#loggers.values()) logger.close();
+			this.#loggers = void 0;
+		}
+		process.removeListener("unhandledRejection", this._unhandledRejectionHandler);
+	}
+	/**
+	* Restore non-serializable resources after V8 heap deserialization.
+	* Recreates messenger, re-registers the egg-ready listener,
+	* and re-attaches the process-level unhandledRejection listener.
+	* Loggers are lazily re-created via the `loggers` getter.
+	*/
+	snapshotDidDeserialize() {
+		this.messenger = create(this);
+		this.messenger.once("egg-ready", () => {
+			this.lifecycle.triggerServerDidReady();
+		});
+		process.on("unhandledRejection", this._unhandledRejectionHandler);
+	}
+	/**
 	* dump out the config and meta object
 	* @private
 	*/
@@ -397,11 +464,39 @@ var EggApplicationCore = class extends EggCore {
 			this.coreLogger.warn(`[egg] dumpTiming error: ${err.message}`);
 		}
 	}
+	/**
+	* Generate and save startup manifest for faster subsequent startups.
+	* Only generates when no valid manifest was loaded (avoids overwriting during manifest-accelerated starts).
+	*/
+	dumpManifest() {
+		try {
+			if (this.loader.serverEnv === "local" && process.env.EGG_MANIFEST !== "true") return;
+			if (this.loader.manifest.data.generatedAt) return;
+			const manifest = this.loader.generateManifest();
+			ManifestStore.enableCompileCache(this.baseDir);
+			ManifestStore.write(this.baseDir, manifest).catch((err) => {
+				this.coreLogger.warn("[egg] dumpManifest write error: %s", err.message);
+			});
+		} catch (err) {
+			this.coreLogger.warn("[egg] dumpManifest error: %s", err.message);
+		}
+	}
 	customEggPaths() {
+		const bundleStore = ManifestStore.getBundleStore();
+		if (bundleStore && path.resolve(bundleStore.baseDir) === path.resolve(this.baseDir)) {
+			const bundledFrameworkDir = path.join(bundleStore.baseDir, "node_modules", "egg", "dist");
+			if (fs.existsSync(bundledFrameworkDir)) return [bundledFrameworkDir, ...super.customEggPaths()];
+		}
 		return [path.dirname(import.meta.dirname), ...super.customEggPaths()];
 	}
+	#clearStartTimeoutTimer() {
+		if (this.#startTimeoutTimer) {
+			clearTimeout(this.#startTimeoutTimer);
+			this.#startTimeoutTimer = void 0;
+		}
+	}
 	#setupTimeoutTimer() {
-		const startTimeoutTimer = setTimeout(() => {
+		this.#startTimeoutTimer = setTimeout(() => {
 			this.coreLogger.error(this.timing.toString());
 			this.coreLogger.error(`${this.type} still doesn't ready after ${this.config.workerStartTimeout} ms.`);
 			const items = this.timing.toJSON();
@@ -414,7 +509,7 @@ var EggApplicationCore = class extends EggCore {
 			this.dumpConfig();
 			this.dumpTiming();
 		}, this.config.workerStartTimeout);
-		this.ready(() => clearTimeout(startTimeoutTimer));
+		this.ready(() => this.#clearStartTimeoutTimer());
 	}
 	get config() {
 		return super.config;

package/dist/lib/loader/AppWorkerLoader.js

@@ -29,7 +29,7 @@ var AppWorkerLoader = class extends EggApplicationLoader {
 		await this.loadService();
 		await this.loadMiddleware();
 		await this.loadController();
-		await this.loadRouter();
+		if (!this.options.metadataOnly) await this.loadRouter();
 	}
 };
 

package/dist/lib/snapshot.d.ts

@@ -0,0 +1,46 @@
+import { Application } from "./application.js";
+import { StartEggOptions } from "./start.js";
+
+//#region src/lib/snapshot.d.ts
+
+/**
+* Build a V8 startup snapshot of an egg application.
+*
+* Call this from the snapshot entry script passed to
+* `node --snapshot-blob=snapshot.blob --build-snapshot snapshot_entry.js`.
+*
+* It loads all metadata (plugins, configs, extensions, services, controllers,
+* router, tegg modules), triggers snapshotWillSerialize hooks to clean up
+* non-serializable resources (file handles, timers, process listeners),
+* then registers a V8 deserialize callback to stash the app for later restore.
+*
+* Example snapshot entry script:
+* ```ts
+* import { buildSnapshot } from 'egg';
+* await buildSnapshot({ baseDir: __dirname });
+* ```
+*
+* Example restoring from snapshot:
+* ```ts
+* import { restoreSnapshot } from 'egg';
+* const app = await restoreSnapshot();
+* // app is fully restored with resources recreated, ready for server creation
+* ```
+*/
+declare function buildSnapshot(options?: Pick<StartEggOptions, "framework" | "baseDir" | "env" | "plugins">): Promise<void>;
+/**
+* Restore an egg application from a V8 startup snapshot.
+*
+* Triggers the snapshotDidDeserialize lifecycle hooks to recreate
+* non-serializable resources (messenger, loggers, process listeners)
+* and resumes the lifecycle from configDidLoad through didReady.
+*
+* Returns the fully restored Application instance with all metadata
+* pre-loaded (plugins, configs, extensions, services, controllers, router).
+*/
+declare function restoreSnapshot(): Promise<Application>;
+declare global {
+  var __egg_snapshot_app: unknown;
+}
+//#endregion
+export { buildSnapshot, restoreSnapshot };

package/dist/lib/snapshot.js

@@ -0,0 +1,59 @@
+import { startEgg } from "./start.js";
+import v8 from "node:v8";
+
+//#region src/lib/snapshot.ts
+/**
+* Build a V8 startup snapshot of an egg application.
+*
+* Call this from the snapshot entry script passed to
+* `node --snapshot-blob=snapshot.blob --build-snapshot snapshot_entry.js`.
+*
+* It loads all metadata (plugins, configs, extensions, services, controllers,
+* router, tegg modules), triggers snapshotWillSerialize hooks to clean up
+* non-serializable resources (file handles, timers, process listeners),
+* then registers a V8 deserialize callback to stash the app for later restore.
+*
+* Example snapshot entry script:
+* ```ts
+* import { buildSnapshot } from 'egg';
+* await buildSnapshot({ baseDir: __dirname });
+* ```
+*
+* Example restoring from snapshot:
+* ```ts
+* import { restoreSnapshot } from 'egg';
+* const app = await restoreSnapshot();
+* // app is fully restored with resources recreated, ready for server creation
+* ```
+*/
+async function buildSnapshot(options = {}) {
+	const app = await startEgg({
+		...options,
+		snapshot: true
+	});
+	if (app.agent) await app.agent.triggerSnapshotWillSerialize();
+	await app.triggerSnapshotWillSerialize();
+	v8.startupSnapshot.setDeserializeMainFunction((snapshotData) => {
+		globalThis.__egg_snapshot_app = snapshotData.app;
+	}, { app });
+}
+/**
+* Restore an egg application from a V8 startup snapshot.
+*
+* Triggers the snapshotDidDeserialize lifecycle hooks to recreate
+* non-serializable resources (messenger, loggers, process listeners)
+* and resumes the lifecycle from configDidLoad through didReady.
+*
+* Returns the fully restored Application instance with all metadata
+* pre-loaded (plugins, configs, extensions, services, controllers, router).
+*/
+async function restoreSnapshot() {
+	const app = globalThis.__egg_snapshot_app;
+	if (!app) throw new Error("No egg application found in snapshot. Ensure the process was started from a snapshot built with buildSnapshot().");
+	if (app.agent) await app.agent.triggerSnapshotDidDeserialize();
+	await app.triggerSnapshotDidDeserialize();
+	return app;
+}
+
+//#endregion
+export { buildSnapshot, restoreSnapshot };

package/dist/lib/start.d.ts

@@ -1,6 +1,7 @@
 import { EggPlugin } from "./types.js";
 import { Agent } from "./agent.js";
 import { Application } from "./application.js";
+import { LoaderFS } from "@eggjs/core";
 
 //#region src/lib/start.d.ts
 interface StartEggOptions {
@@ -13,6 +14,16 @@ interface StartEggOptions {
   mode?: "single";
   env?: string;
   plugins?: EggPlugin;
+  /** Skip lifecycle hooks, only trigger loadMetadata for manifest generation */
+  metadataOnly?: boolean;
+  /** Loader-facing filesystem abstraction */
+  loaderFS?: LoaderFS;
+  /**
+  * When true, load application metadata for V8 startup snapshot construction.
+  * The lifecycle stops after configWillLoad (no servers, timers, or connections)
+  * and skips `egg-ready` broadcast. `ready()` resolves when loading completes.
+  */
+  snapshot?: boolean;
 }
 interface SingleModeApplication extends Application {
   agent: SingleModeAgent;
@@ -21,7 +32,11 @@ interface SingleModeAgent extends Agent {
   app: SingleModeApplication;
 }
 /**
-* Start egg with single process
+* Start egg with single process.
+*
+* When `options.snapshot` is true, loads application metadata for V8 startup
+* snapshot construction. The lifecycle stops after `configWillLoad` (no servers,
+* timers, or connections) and skips `egg-ready` broadcast.
 */
 declare function startEgg(options?: StartEggOptions): Promise<SingleModeApplication>;
 //#endregion

package/dist/lib/start.js

@@ -1,17 +1,13 @@
 import { Agent } from "./agent.js";
 import { Application } from "./application.js";
 import "./types.js";
+import { ManifestStore } from "@eggjs/core";
 import path from "node:path";
 import { importModule } from "@eggjs/utils";
 import { readJSON } from "utility";
 
 //#region src/lib/start.ts
-/**
-* Start egg with single process
-*/
-async function startEgg(options = {}) {
-	options.baseDir = options.baseDir ?? process.cwd();
-	options.mode = "single";
+async function resolveFrameworkClasses(options) {
 	if (!options.framework) try {
 		options.framework = (await readJSON(path.join(options.baseDir, "package.json"))).egg.framework;
 	} catch {}
@@ -22,13 +18,35 @@ async function startEgg(options = {}) {
 		AgentClass = framework.Agent;
 		ApplicationClass = framework.Application;
 	}
-	const agent = new AgentClass({ ...options });
-	await agent.ready();
+	return {
+		AgentClass,
+		ApplicationClass
+	};
+}
+/**
+* Start egg with single process.
+*
+* When `options.snapshot` is true, loads application metadata for V8 startup
+* snapshot construction. The lifecycle stops after `configWillLoad` (no servers,
+* timers, or connections) and skips `egg-ready` broadcast.
+*/
+async function startEgg(options = {}) {
+	options.baseDir = options.baseDir ?? process.cwd();
+	options.mode = "single";
+	if (!options.snapshot) ManifestStore.enableCompileCache(options.baseDir);
+	const { AgentClass, ApplicationClass } = await resolveFrameworkClasses(options);
+	let agent;
+	if (!options.metadataOnly) {
+		agent = new AgentClass({ ...options });
+		await agent.ready();
+	}
 	const application = new ApplicationClass({ ...options });
-	application.agent = agent;
-	agent.application = application;
+	if (agent) {
+		application.agent = agent;
+		agent.application = application;
+	}
 	await application.ready();
-	application.messenger.broadcast("egg-ready");
+	if (!options.metadataOnly && !options.snapshot) application.messenger.broadcast("egg-ready");
 	return application;
 }
 

package/dist/lib/types.d.ts

@@ -7,7 +7,7 @@ import "./egg.js";
 import { Application } from "./application.js";
 import { EggAppConfig as EggAppConfig$1, EggAppInfo, FileLoaderOptions } from "@eggjs/core";
 import { EggLoggerOptions, EggLoggersOptions } from "egg-logger";
-import { RequestOptions } from "urllib";
+import { Dispatcher, RequestOptions } from "urllib";
 import { LookupFunction, Socket } from "node:net";
 import { PartialDeep } from "type-fest";
 
@@ -61,6 +61,24 @@ interface HttpClientConfig {
   */
   allowH2?: boolean;
   lookup?: LookupFunction;
+  /**
+  * Interceptors for request composition, applied via `Dispatcher.compose()`.
+  * Each interceptor receives a `dispatch` function and returns a new `dispatch` function.
+  *
+  * @example
+  * ```ts
+  * // config.default.ts
+  * config.httpclient = {
+  *   interceptors: [
+  *     (dispatch) => (opts, handler) => {
+  *       opts.headers = { ...opts.headers, 'x-trace-id': generateTraceId() };
+  *       return dispatch(opts, handler);
+  *     },
+  *   ],
+  * };
+  * ```
+  */
+  interceptors?: Dispatcher.DispatcherComposeInterceptor[];
 }
 /**
 * Powerful Partial, Support adding ? modifier to a mapped property in deep level
@@ -73,6 +91,7 @@ interface HttpClientConfig {
 * @deprecated use `PartialDeep` instead
 */
 type PowerPartial<T> = PartialDeep<T>;
+declare const EggAppConfig: ObjectConstructor;
 interface EggAppConfig extends EggAppConfig$1 {
   workerStartTimeout: number;
   baseDir: string;

package/dist/lib/types.js

@@ -1,3 +1,7 @@
 import "./types.plugin.js";
 
-export {  };
+//#region src/lib/types.ts
+const EggAppConfig = Object;
+
+//#endregion
+export { EggAppConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "egg",
-  "version": "4.1.2-beta.1",
+  "version": "4.1.2-beta.10",
   "description": "A web application framework for Node.js",
   "keywords": [
     "app",
@@ -70,6 +70,7 @@
     "./lib/loader/AgentWorkerLoader": "./dist/lib/loader/AgentWorkerLoader.js",
     "./lib/loader/AppWorkerLoader": "./dist/lib/loader/AppWorkerLoader.js",
     "./lib/loader/EggApplicationLoader": "./dist/lib/loader/EggApplicationLoader.js",
+    "./lib/snapshot": "./dist/lib/snapshot.js",
     "./lib/start": "./dist/lib/start.js",
     "./lib/types": "./dist/lib/types.js",
     "./lib/types.plugin": "./dist/lib/types.plugin.js",
@@ -98,34 +99,34 @@
     "type-fest": "^5.0.1",
     "urllib": "^4.8.2",
     "utility": "^2.5.0",
-    "@eggjs/ajv-plugin": "4.0.2-beta.1",
-    "@eggjs/cluster": "4.0.2-beta.1",
-    "@eggjs/aop-plugin": "4.0.2-beta.1",
-    "@eggjs/core": "7.0.2-beta.1",
-    "@eggjs/controller-plugin": "4.0.2-beta.1",
-    "@eggjs/cookies": "4.0.2-beta.1",
-    "@eggjs/development": "5.0.2-beta.1",
-    "@eggjs/dal-plugin": "4.0.2-beta.1",
-    "@eggjs/eventbus-plugin": "4.0.2-beta.1",
-    "@eggjs/errors": "3.0.2-beta.1",
-    "@eggjs/i18n": "4.0.2-beta.1",
-    "@eggjs/multipart": "5.0.2-beta.1",
-    "@eggjs/jsonp": "4.0.2-beta.1",
-    "@eggjs/extend2": "5.0.2-beta.1",
-    "@eggjs/logrotator": "5.0.2-beta.1",
-    "@eggjs/onerror": "4.0.2-beta.1",
-    "@eggjs/security": "5.0.2-beta.1",
-    "@eggjs/schedule-plugin": "4.0.2-beta.1",
-    "@eggjs/static": "4.0.2-beta.1",
-    "@eggjs/session": "5.0.2-beta.1",
-    "@eggjs/tegg-config": "4.0.2-beta.1",
-    "@eggjs/schedule": "6.0.2-beta.1",
-    "@eggjs/tegg-plugin": "4.0.2-beta.1",
-    "@eggjs/orm-plugin": "4.0.2-beta.1",
-    "@eggjs/tegg": "4.0.2-beta.1",
-    "@eggjs/view": "4.0.2-beta.1",
-    "@eggjs/utils": "5.0.2-beta.1",
-    "@eggjs/watcher": "5.0.2-beta.1"
+    "@eggjs/ajv-plugin": "4.0.2-beta.10",
+    "@eggjs/cluster": "4.0.2-beta.10",
+    "@eggjs/controller-plugin": "4.0.2-beta.10",
+    "@eggjs/cookies": "4.0.2-beta.10",
+    "@eggjs/dal-plugin": "4.0.2-beta.10",
+    "@eggjs/development": "5.0.2-beta.10",
+    "@eggjs/core": "7.0.2-beta.10",
+    "@eggjs/aop-plugin": "4.0.2-beta.10",
+    "@eggjs/errors": "3.0.2-beta.10",
+    "@eggjs/eventbus-plugin": "4.0.2-beta.10",
+    "@eggjs/extend2": "5.0.2-beta.10",
+    "@eggjs/i18n": "4.0.2-beta.10",
+    "@eggjs/logrotator": "5.0.2-beta.10",
+    "@eggjs/multipart": "5.0.2-beta.10",
+    "@eggjs/jsonp": "4.0.2-beta.10",
+    "@eggjs/orm-plugin": "4.0.2-beta.10",
+    "@eggjs/schedule": "6.0.2-beta.10",
+    "@eggjs/schedule-plugin": "4.0.2-beta.10",
+    "@eggjs/onerror": "4.0.2-beta.10",
+    "@eggjs/session": "5.0.2-beta.10",
+    "@eggjs/static": "4.0.2-beta.10",
+    "@eggjs/security": "5.0.2-beta.10",
+    "@eggjs/tegg": "4.0.2-beta.10",
+    "@eggjs/tegg-plugin": "4.0.2-beta.10",
+    "@eggjs/utils": "5.0.2-beta.10",
+    "@eggjs/view": "4.0.2-beta.10",
+    "@eggjs/watcher": "5.0.2-beta.10",
+    "@eggjs/tegg-config": "4.0.2-beta.10"
   },
   "devDependencies": {
     "@types/koa-bodyparser": "^4.3.12",
@@ -141,10 +142,10 @@
     "sdk-base": "^5.0.1",
     "spy": "^1.0.0",
     "typescript": "^5.9.3",
-    "@eggjs/koa": "3.1.2-beta.1",
-    "@eggjs/mock": "7.0.2-beta.1",
-    "@eggjs/tracer": "4.0.2-beta.1",
-    "@eggjs/supertest": "9.0.2-beta.1"
+    "@eggjs/koa": "3.1.2-beta.10",
+    "@eggjs/mock": "7.0.2-beta.10",
+    "@eggjs/supertest": "9.0.2-beta.10",
+    "@eggjs/tracer": "4.0.2-beta.10"
   },
   "engines": {
     "node": ">=22.18.0"