@eggjs/core 7.0.2-beta.7 → 7.0.2-beta.9

package/dist/egg.d.ts

@@ -20,6 +20,14 @@ interface EggCoreOptions {
   env?: string;
   /** Skip lifecycle hooks, only trigger loadMetadata for manifest generation */
   metadataOnly?: boolean;
+  /**
+  * When true, lifecycle stops after the `configWillLoad` phase.
+  * `configDidLoad`, `didLoad`, `willReady`, `didReady`, and `serverDidReady`
+  * are skipped. Used for V8 startup snapshot construction — SDKs typically
+  * execute during `configDidLoad`, opening connections and starting timers
+  * which are not serializable. Analogous to `metadataOnly` mode.
+  */
+  snapshot?: boolean;
 }
 type EggCoreInitOptions = Partial<EggCoreOptions>;
 declare class Request$1 extends KoaRequest {

package/dist/egg.js

@@ -107,7 +107,8 @@ var EggCore = class EggCore extends KoaApplication {
 		this.lifecycle = new Lifecycle({
 			baseDir: options.baseDir,
 			app: this,
-			logger: this.console
+			logger: this.console,
+			snapshot: options.snapshot
 		});
 		this.lifecycle.on("error", (err) => this.emit("error", err));
 		this.lifecycle.on("ready_timeout", (id) => this.emit("ready_timeout", id));

package/dist/lifecycle.d.ts

@@ -52,6 +52,15 @@ interface LifecycleOptions {
   baseDir: string;
   app: EggCore;
   logger: EggConsoleLogger;
+  /**
+  * When true, the lifecycle stops after configWillLoad phase completes.
+  * configDidLoad, didLoad, willReady, didReady, and serverDidReady hooks
+  * are NOT called. Used for V8 startup snapshot construction — SDKs
+  * typically execute during configDidLoad, opening connections and starting
+  * timers which are not serializable. The handling is analogous to
+  * metadataOnly mode: both short-circuit the lifecycle chain early.
+  */
+  snapshot?: boolean;
 }
 type FunWithFullPath = Fun & {
   fullPath?: string;

package/dist/lifecycle.js

@@ -43,7 +43,7 @@ var Lifecycle = class extends EventEmitter {
 			this.logger.warn("[egg/core/lifecycle:ready_timeout] %s seconds later %s was still unable to finish.", this.readyTimeout / 1e3, id);
 		});
 		this.ready((err) => {
-			if (!this.#metadataOnly) this.triggerDidReady(err);
+			if (!this.#metadataOnly && !this.options.snapshot) this.triggerDidReady(err);
 			debug("app ready");
 			this.timing.end(`${this.options.app.type} Start`);
 		});
@@ -147,6 +147,11 @@ var Lifecycle = class extends EventEmitter {
 			boot.configWillLoad();
 		}
 		debug("trigger configWillLoad end");
+		if (this.options.snapshot) {
+			debug("snapshot mode: stopping after configWillLoad, skipping configDidLoad and later phases");
+			this.ready(true);
+			return;
+		}
 		this.triggerConfigDidLoad();
 	}
 	triggerConfigDidLoad() {

package/dist/loader/manifest.d.ts

@@ -54,6 +54,20 @@ declare class ManifestStore {
   generateManifest(options: ManifestGenerateOptions): StartupManifest;
   static write(baseDir: string, manifest: StartupManifest): Promise<void>;
   static clean(baseDir: string): void;
+  /**
+  * Enable Node.js module compile cache for the current process.
+  * Sets NODE_COMPILE_CACHE and NODE_COMPILE_CACHE_PORTABLE env vars
+  * so forked child processes also inherit compile cache.
+  */
+  static enableCompileCache(baseDir: string): void;
+  /**
+  * Flush accumulated compile cache entries to disk.
+  */
+  static flushCompileCache(): void;
+  /**
+  * Remove the compile cache directory.
+  */
+  static cleanCompileCache(baseDir: string): void;
 }
 interface ManifestGenerateOptions {
   serverEnv: string;

package/dist/loader/manifest.js

@@ -1,3 +1,4 @@
+import BuiltinModule from "node:module";
 import fs from "node:fs";
 import fsp from "node:fs/promises";
 import path from "node:path";
@@ -182,6 +183,46 @@ var ManifestStore = class ManifestStore {
 		} catch (err) {
 			if (err.code !== "ENOENT") throw err;
 		}
+		ManifestStore.cleanCompileCache(baseDir);
+	}
+	/**
+	* Enable Node.js module compile cache for the current process.
+	* Sets NODE_COMPILE_CACHE and NODE_COMPILE_CACHE_PORTABLE env vars
+	* so forked child processes also inherit compile cache.
+	*/
+	static enableCompileCache(baseDir) {
+		if (process.env.NODE_COMPILE_CACHE || process.env.NODE_DISABLE_COMPILE_CACHE) return;
+		const cacheDir = path.join(baseDir, ".egg", "compile-cache");
+		process.env.NODE_COMPILE_CACHE = cacheDir;
+		process.env.NODE_COMPILE_CACHE_PORTABLE = "1";
+		try {
+			const result = BuiltinModule.enableCompileCache?.(cacheDir);
+			debug("compile cache enabled: %o", result);
+		} catch (err) {
+			debug("compile cache enable failed: %o", err);
+		}
+	}
+	/**
+	* Flush accumulated compile cache entries to disk.
+	*/
+	static flushCompileCache() {
+		try {
+			BuiltinModule.flushCompileCache?.();
+			debug("compile cache flushed");
+		} catch (err) {
+			debug("compile cache flush failed: %o", err);
+		}
+	}
+	/**
+	* Remove the compile cache directory.
+	*/
+	static cleanCompileCache(baseDir) {
+		const compileCacheDir = path.join(baseDir, ".egg", "compile-cache");
+		fs.rmSync(compileCacheDir, {
+			recursive: true,
+			force: true
+		});
+		debug("compile cache removed: %s", compileCacheDir);
 	}
 	#toRelative(absPath) {
 		return (path.isAbsolute(absPath) ? path.relative(this.baseDir, absPath) : absPath).replaceAll(path.sep, "/");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/core",
-  "version": "7.0.2-beta.7",
+  "version": "7.0.2-beta.9",
   "description": "A core plugin framework based on @eggjs/koa",
   "keywords": [
     "egg",
@@ -41,11 +41,11 @@
     "ready-callback": "^4.0.0",
     "tsconfig-paths": "^4.2.0",
     "utility": "^2.5.0",
-    "@eggjs/extend2": "5.0.2-beta.7",
-    "@eggjs/koa": "3.1.2-beta.7",
-    "@eggjs/path-matching": "3.0.2-beta.7",
-    "@eggjs/router": "4.0.2-beta.7",
-    "@eggjs/utils": "5.0.2-beta.7"
+    "@eggjs/extend2": "5.0.2-beta.9",
+    "@eggjs/path-matching": "3.0.2-beta.9",
+    "@eggjs/router": "4.0.2-beta.9",
+    "@eggjs/koa": "3.1.2-beta.9",
+    "@eggjs/utils": "5.0.2-beta.9"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
@@ -57,9 +57,9 @@
     "mm": "^4.0.2",
     "typescript": "^5.9.3",
     "urllib": "^4.8.2",
-    "@eggjs/mock": "7.0.2-beta.7",
-    "@eggjs/tsconfig": "3.1.2-beta.7",
-    "@eggjs/supertest": "9.0.2-beta.7"
+    "@eggjs/mock": "7.0.2-beta.9",
+    "@eggjs/tsconfig": "3.1.2-beta.9",
+    "@eggjs/supertest": "9.0.2-beta.9"
   },
   "engines": {
     "node": ">=22.18.0"