@eggjs/bin 8.0.2-beta.5 → 8.0.2-beta.7

package/dist/baseCommand.d.ts

@@ -46,6 +46,7 @@ declare abstract class BaseCommand<T extends typeof Command> extends Command {
   protected formatRequires(): Promise<string[]>;
   protected formatImportModule(modulePath: string): string;
   protected addNodeOptions(options: string): void;
+  protected buildRequiresExecArgv(): Promise<string[]>;
   protected forkNode(modulePath: string, forkArgs: string[], options?: ForkNodeOptions): Promise<void>;
 }
 //#endregion

package/dist/baseCommand.js

@@ -235,6 +235,16 @@ var BaseCommand = class extends Command {
 			if (!this.env.NODE_OPTIONS.includes(options)) this.env.NODE_OPTIONS = `${this.env.NODE_OPTIONS} ${options}`;
 		} else this.env.NODE_OPTIONS = options;
 	}
+	async buildRequiresExecArgv() {
+		const requires = await this.formatRequires();
+		const execArgv = [];
+		for (const r of requires) {
+			const module = this.formatImportModule(r);
+			const splitIndex = module.indexOf(" ");
+			if (splitIndex !== -1) execArgv.push(module.slice(0, splitIndex), module.slice(splitIndex + 2, -1));
+		}
+		return execArgv;
+	}
 	async forkNode(modulePath, forkArgs, options = {}) {
 		const env = {
 			...this.env,

package/dist/commands/cov.d.ts

@@ -1,20 +1,20 @@
 import Test from "./test.js";
 import { InlineConfig } from "vitest/node";
-import * as _oclif_core_interfaces6 from "@oclif/core/interfaces";
+import * as _oclif_core_interfaces0 from "@oclif/core/interfaces";
 
 //#region src/commands/cov.d.ts
 declare class Cov<T extends typeof Cov> extends Test<T> {
   static description: string;
   static examples: string[];
   static flags: {
-    exclude: _oclif_core_interfaces6.OptionFlag<string[] | undefined, _oclif_core_interfaces6.CustomOptions>;
-    bail: _oclif_core_interfaces6.BooleanFlag<boolean>;
-    timeout: _oclif_core_interfaces6.OptionFlag<number, _oclif_core_interfaces6.CustomOptions>;
-    'no-timeout': _oclif_core_interfaces6.BooleanFlag<boolean>;
-    grep: _oclif_core_interfaces6.OptionFlag<string | undefined, _oclif_core_interfaces6.CustomOptions>;
-    changed: _oclif_core_interfaces6.BooleanFlag<boolean>;
-    watch: _oclif_core_interfaces6.BooleanFlag<boolean>;
-    pool: _oclif_core_interfaces6.OptionFlag<string, _oclif_core_interfaces6.CustomOptions>;
+    exclude: _oclif_core_interfaces0.OptionFlag<string[] | undefined, _oclif_core_interfaces0.CustomOptions>;
+    bail: _oclif_core_interfaces0.BooleanFlag<boolean>;
+    timeout: _oclif_core_interfaces0.OptionFlag<number, _oclif_core_interfaces0.CustomOptions>;
+    'no-timeout': _oclif_core_interfaces0.BooleanFlag<boolean>;
+    grep: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    changed: _oclif_core_interfaces0.BooleanFlag<boolean>;
+    watch: _oclif_core_interfaces0.BooleanFlag<boolean>;
+    pool: _oclif_core_interfaces0.OptionFlag<string, _oclif_core_interfaces0.CustomOptions>;
   };
   protected get defaultCoverageExcludes(): string[];
   /**

package/dist/commands/dev.d.ts

@@ -1,15 +1,15 @@
 import { BaseCommand } from "../baseCommand.js";
-import * as _oclif_core_interfaces0 from "@oclif/core/interfaces";
+import * as _oclif_core_interfaces11 from "@oclif/core/interfaces";
 
 //#region src/commands/dev.d.ts
 declare class Dev<T extends typeof Dev> extends BaseCommand<T> {
   static description: string;
   static examples: string[];
   static flags: {
-    port: _oclif_core_interfaces0.OptionFlag<number | undefined, _oclif_core_interfaces0.CustomOptions>;
-    workers: _oclif_core_interfaces0.OptionFlag<number, _oclif_core_interfaces0.CustomOptions>;
-    framework: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
-    sticky: _oclif_core_interfaces0.BooleanFlag<boolean>;
+    port: _oclif_core_interfaces11.OptionFlag<number | undefined, _oclif_core_interfaces11.CustomOptions>;
+    workers: _oclif_core_interfaces11.OptionFlag<number, _oclif_core_interfaces11.CustomOptions>;
+    framework: _oclif_core_interfaces11.OptionFlag<string | undefined, _oclif_core_interfaces11.CustomOptions>;
+    sticky: _oclif_core_interfaces11.BooleanFlag<boolean>;
   };
   run(): Promise<void>;
   protected formatEggStartOptions(): Promise<{

package/dist/commands/dev.js

@@ -31,13 +31,7 @@ var Dev = class extends BaseCommand {
 		const serverBin = getSourceFilename(`../scripts/start-cluster.${this.isESM ? "mjs" : "cjs"}`);
 		const eggStartOptions = await this.formatEggStartOptions();
 		const args = [JSON.stringify(eggStartOptions)];
-		const requires = await this.formatRequires();
-		const execArgv = [];
-		for (const r of requires) {
-			const module = this.formatImportModule(r);
-			const splitIndex = module.indexOf(" ");
-			if (splitIndex !== -1) execArgv.push(module.slice(0, splitIndex), module.slice(splitIndex + 2, -1));
-		}
+		const execArgv = await this.buildRequiresExecArgv();
 		await this.forkNode(serverBin, args, { execArgv });
 	}
 	async formatEggStartOptions() {

package/dist/commands/manifest.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from "../baseCommand.js";
+import * as _oclif_core_interfaces18 from "@oclif/core/interfaces";
+
+//#region src/commands/manifest.d.ts
+declare class Manifest<T extends typeof Manifest> extends BaseCommand<T> {
+  static description: string;
+  static examples: string[];
+  static args: {
+    action: _oclif_core_interfaces18.Arg<string, Record<string, unknown>>;
+  };
+  static flags: {
+    framework: _oclif_core_interfaces18.OptionFlag<string | undefined, _oclif_core_interfaces18.CustomOptions>;
+    env: _oclif_core_interfaces18.OptionFlag<string, _oclif_core_interfaces18.CustomOptions>;
+    scope: _oclif_core_interfaces18.OptionFlag<string, _oclif_core_interfaces18.CustomOptions>;
+  };
+  run(): Promise<void>;
+  private runGenerate;
+  private runValidate;
+  private runClean;
+}
+//#endregion
+export { Manifest as default };

package/dist/commands/manifest.js

@@ -0,0 +1,108 @@
+import { getSourceFilename } from "../utils.js";
+import { BaseCommand } from "../baseCommand.js";
+import { debuglog } from "node:util";
+import { getFrameworkPath } from "@eggjs/utils";
+import { Args, Flags } from "@oclif/core";
+
+//#region src/commands/manifest.ts
+const debug = debuglog("egg/bin/commands/manifest");
+var Manifest = class extends BaseCommand {
+	static description = "Manage the startup manifest for faster cold starts";
+	static examples = [
+		"<%= config.bin %> <%= command.id %> generate",
+		"<%= config.bin %> <%= command.id %> generate --env=prod",
+		"<%= config.bin %> <%= command.id %> validate --env=prod",
+		"<%= config.bin %> <%= command.id %> clean"
+	];
+	static args = { action: Args.string({
+		required: true,
+		description: "Action to perform",
+		options: [
+			"generate",
+			"validate",
+			"clean"
+		]
+	}) };
+	static flags = {
+		framework: Flags.string({ description: "specify framework that can be absolute path or npm package" }),
+		env: Flags.string({
+			description: "server environment for manifest generation/validation",
+			default: "prod"
+		}),
+		scope: Flags.string({
+			description: "server scope for manifest validation",
+			default: ""
+		})
+	};
+	async run() {
+		const { action } = this.args;
+		switch (action) {
+			case "generate":
+				await this.runGenerate();
+				break;
+			case "validate":
+				await this.runValidate();
+				break;
+			case "clean":
+				await this.runClean();
+				break;
+		}
+	}
+	async runGenerate() {
+		const { flags } = this;
+		const framework = getFrameworkPath({
+			framework: flags.framework,
+			baseDir: flags.base
+		});
+		debug("generate manifest: baseDir=%s, framework=%s, env=%s, scope=%s", flags.base, framework, flags.env, flags.scope);
+		const options = {
+			baseDir: flags.base,
+			framework,
+			env: flags.env,
+			scope: flags.scope
+		};
+		const serverBin = getSourceFilename("../scripts/manifest-generate.mjs");
+		const args = [JSON.stringify(options)];
+		const execArgv = await this.buildRequiresExecArgv();
+		await this.forkNode(serverBin, args, { execArgv });
+	}
+	async runValidate() {
+		const { flags } = this;
+		debug("validate manifest: baseDir=%s, env=%s, scope=%s", flags.base, flags.env, flags.scope);
+		const savedEggManifest = process.env.EGG_MANIFEST;
+		process.env.EGG_MANIFEST = "true";
+		try {
+			const { ManifestStore } = await import("@eggjs/core");
+			const store = ManifestStore.load(flags.base, flags.env, flags.scope);
+			if (!store) {
+				console.error("[manifest] Manifest is invalid or does not exist");
+				return this.exit(1);
+			}
+			const { data } = store;
+			const resolveCacheCount = Object.keys(data.resolveCache ?? {}).length;
+			const fileDiscoveryCount = Object.keys(data.fileDiscovery ?? {}).length;
+			const extensionCount = Object.keys(data.extensions ?? {}).length;
+			console.log("[manifest] Manifest is valid");
+			console.log("[manifest]   version: %d", data.version);
+			console.log("[manifest]   generatedAt: %s", data.generatedAt);
+			console.log("[manifest]   serverEnv: %s", data.invalidation.serverEnv);
+			console.log("[manifest]   serverScope: %s", data.invalidation.serverScope);
+			console.log("[manifest]   resolveCache entries: %d", resolveCacheCount);
+			console.log("[manifest]   fileDiscovery entries: %d", fileDiscoveryCount);
+			console.log("[manifest]   extension entries: %d", extensionCount);
+		} finally {
+			if (savedEggManifest === void 0) delete process.env.EGG_MANIFEST;
+			else process.env.EGG_MANIFEST = savedEggManifest;
+		}
+	}
+	async runClean() {
+		const { flags } = this;
+		debug("clean manifest: baseDir=%s", flags.base);
+		const { ManifestStore } = await import("@eggjs/core");
+		ManifestStore.clean(flags.base);
+		console.log("[manifest] Manifest cleaned");
+	}
+};
+
+//#endregion
+export { Manifest as default };

package/dist/commands/test.d.ts

@@ -1,22 +1,22 @@
 import { BaseCommand } from "../baseCommand.js";
 import { InlineConfig } from "vitest/node";
-import * as _oclif_core_interfaces18 from "@oclif/core/interfaces";
+import * as _oclif_core_interfaces25 from "@oclif/core/interfaces";
 
 //#region src/commands/test.d.ts
 declare class Test<T extends typeof Test> extends BaseCommand<T> {
   static args: {
-    file: _oclif_core_interfaces18.Arg<string | undefined, Record<string, unknown>>;
+    file: _oclif_core_interfaces25.Arg<string | undefined, Record<string, unknown>>;
   };
   static description: string;
   static examples: string[];
   static flags: {
-    bail: _oclif_core_interfaces18.BooleanFlag<boolean>;
-    timeout: _oclif_core_interfaces18.OptionFlag<number, _oclif_core_interfaces18.CustomOptions>;
-    'no-timeout': _oclif_core_interfaces18.BooleanFlag<boolean>;
-    grep: _oclif_core_interfaces18.OptionFlag<string | undefined, _oclif_core_interfaces18.CustomOptions>;
-    changed: _oclif_core_interfaces18.BooleanFlag<boolean>;
-    watch: _oclif_core_interfaces18.BooleanFlag<boolean>;
-    pool: _oclif_core_interfaces18.OptionFlag<string, _oclif_core_interfaces18.CustomOptions>;
+    bail: _oclif_core_interfaces25.BooleanFlag<boolean>;
+    timeout: _oclif_core_interfaces25.OptionFlag<number, _oclif_core_interfaces25.CustomOptions>;
+    'no-timeout': _oclif_core_interfaces25.BooleanFlag<boolean>;
+    grep: _oclif_core_interfaces25.OptionFlag<string | undefined, _oclif_core_interfaces25.CustomOptions>;
+    changed: _oclif_core_interfaces25.BooleanFlag<boolean>;
+    watch: _oclif_core_interfaces25.BooleanFlag<boolean>;
+    pool: _oclif_core_interfaces25.OptionFlag<string, _oclif_core_interfaces25.CustomOptions>;
   };
   run(): Promise<void>;
   protected buildVitestConfig(files: string[]): Promise<InlineConfig>;

package/dist/index.d.ts

@@ -3,5 +3,6 @@ import { BaseCommand, ForkError, ForkNodeOptions } from "./baseCommand.js";
 import Test from "./commands/test.js";
 import Cov from "./commands/cov.js";
 import Dev from "./commands/dev.js";
+import Manifest from "./commands/manifest.js";
 export * from "@oclif/core";
-export { BaseCommand, Cov, Dev, ForkError, ForkNodeOptions, PackageEgg, Test };
+export { BaseCommand, Cov, Dev, ForkError, ForkNodeOptions, Manifest, PackageEgg, Test };

package/dist/index.js

@@ -2,7 +2,8 @@ import { BaseCommand, ForkError } from "./baseCommand.js";
 import Test from "./commands/test.js";
 import Cov from "./commands/cov.js";
 import Dev from "./commands/dev.js";
+import Manifest from "./commands/manifest.js";
 
 export * from "@oclif/core"
 
-export { BaseCommand, Cov, Dev, ForkError, Test };
+export { BaseCommand, Cov, Dev, ForkError, Manifest, Test };

package/dist/scripts/manifest-generate.mjs

@@ -0,0 +1,59 @@
+import { debuglog } from 'node:util';
+
+import { importModule } from '@eggjs/utils';
+
+const debug = debuglog('egg/bin/scripts/manifest-generate');
+
+async function main() {
+  debug('argv: %o', process.argv);
+  const options = JSON.parse(process.argv[2]);
+  debug('manifest generate options: %o', options);
+
+  // Set server env/scope before importing framework
+  if (options.env) {
+    process.env.EGG_SERVER_ENV = options.env;
+  }
+  if (options.scope) {
+    process.env.EGG_SERVER_SCOPE = options.scope;
+  }
+
+  // Clean any existing manifest before generation to ensure the collector
+  // captures all lookups (not just cache misses from a stale manifest).
+  const { ManifestStore } = await importModule('@eggjs/core', {
+    paths: [options.framework],
+  });
+  ManifestStore.clean(options.baseDir);
+
+  const framework = await importModule(options.framework);
+  const app = await framework.start({
+    baseDir: options.baseDir,
+    framework: options.framework,
+    env: options.env,
+    metadataOnly: true,
+  });
+
+  // Generate manifest from collected metadata
+  const manifest = app.loader.generateManifest();
+
+  // Write manifest to .egg/manifest.json
+  await ManifestStore.write(options.baseDir, manifest);
+
+  // Log stats
+  const resolveCacheCount = Object.keys(manifest.resolveCache).length;
+  const fileDiscoveryCount = Object.keys(manifest.fileDiscovery).length;
+  const extensionCount = Object.keys(manifest.extensions).length;
+  console.log('[manifest] Generated manifest v%d at %s', manifest.version, manifest.generatedAt);
+  console.log('[manifest]   resolveCache entries: %d', resolveCacheCount);
+  console.log('[manifest]   fileDiscovery entries: %d', fileDiscoveryCount);
+  console.log('[manifest]   extension entries: %d', extensionCount);
+  console.log('[manifest] Written to %s/.egg/manifest.json', options.baseDir);
+
+  // Clean up and exit
+  await app.close();
+  process.exit(0);
+}
+
+main().catch((err) => {
+  console.error('[manifest] Generation failed:', err);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/bin",
-  "version": "8.0.2-beta.5",
+  "version": "8.0.2-beta.7",
   "description": "egg developer tool",
   "homepage": "https://github.com/eggjs/egg/tree/next/tools/egg-bin",
   "bugs": {
@@ -30,6 +30,7 @@
     "./baseCommand": "./dist/baseCommand.js",
     "./commands/cov": "./dist/commands/cov.js",
     "./commands/dev": "./dist/commands/dev.js",
+    "./commands/manifest": "./dist/commands/manifest.js",
     "./commands/test": "./dist/commands/test.js",
     "./types": "./dist/types.js",
     "./utils": "./dist/utils.js",
@@ -49,8 +50,9 @@
     "tsconfig-paths": "^4.2.0",
     "utility": "^2.5.0",
     "vitest": "^4.0.15",
-    "@eggjs/tegg-vitest": "4.0.2-beta.5",
-    "@eggjs/utils": "5.0.2-beta.5"
+    "@eggjs/tegg-vitest": "4.0.2-beta.7",
+    "@eggjs/utils": "5.0.2-beta.7",
+    "@eggjs/core": "7.0.2-beta.7"
   },
   "devDependencies": {
     "@swc-node/register": "^1.11.1",
@@ -66,13 +68,13 @@
     "runscript": "^2.0.1",
     "sdk-base": "^5.0.1",
     "typescript": "^5.9.3",
-    "@eggjs/mock": "7.0.2-beta.5",
-    "@eggjs/tsconfig": "3.1.2-beta.5",
-    "@eggjs/supertest": "9.0.2-beta.5",
-    "egg": "4.1.2-beta.5"
+    "@eggjs/mock": "7.0.2-beta.7",
+    "@eggjs/supertest": "9.0.2-beta.7",
+    "egg": "4.1.2-beta.7",
+    "@eggjs/tsconfig": "3.1.2-beta.7"
   },
   "peerDependencies": {
-    "@eggjs/mock": "7.0.2-beta.5"
+    "@eggjs/mock": "7.0.2-beta.7"
   },
   "peerDependenciesMeta": {
     "@eggjs/mock": {

package/scripts/manifest-generate.mjs

@@ -0,0 +1,59 @@
+import { debuglog } from 'node:util';
+
+import { importModule } from '@eggjs/utils';
+
+const debug = debuglog('egg/bin/scripts/manifest-generate');
+
+async function main() {
+  debug('argv: %o', process.argv);
+  const options = JSON.parse(process.argv[2]);
+  debug('manifest generate options: %o', options);
+
+  // Set server env/scope before importing framework
+  if (options.env) {
+    process.env.EGG_SERVER_ENV = options.env;
+  }
+  if (options.scope) {
+    process.env.EGG_SERVER_SCOPE = options.scope;
+  }
+
+  // Clean any existing manifest before generation to ensure the collector
+  // captures all lookups (not just cache misses from a stale manifest).
+  const { ManifestStore } = await importModule('@eggjs/core', {
+    paths: [options.framework],
+  });
+  ManifestStore.clean(options.baseDir);
+
+  const framework = await importModule(options.framework);
+  const app = await framework.start({
+    baseDir: options.baseDir,
+    framework: options.framework,
+    env: options.env,
+    metadataOnly: true,
+  });
+
+  // Generate manifest from collected metadata
+  const manifest = app.loader.generateManifest();
+
+  // Write manifest to .egg/manifest.json
+  await ManifestStore.write(options.baseDir, manifest);
+
+  // Log stats
+  const resolveCacheCount = Object.keys(manifest.resolveCache).length;
+  const fileDiscoveryCount = Object.keys(manifest.fileDiscovery).length;
+  const extensionCount = Object.keys(manifest.extensions).length;
+  console.log('[manifest] Generated manifest v%d at %s', manifest.version, manifest.generatedAt);
+  console.log('[manifest]   resolveCache entries: %d', resolveCacheCount);
+  console.log('[manifest]   fileDiscovery entries: %d', fileDiscoveryCount);
+  console.log('[manifest]   extension entries: %d', extensionCount);
+  console.log('[manifest] Written to %s/.egg/manifest.json', options.baseDir);
+
+  // Clean up and exit
+  await app.close();
+  process.exit(0);
+}
+
+main().catch((err) => {
+  console.error('[manifest] Generation failed:', err);
+  process.exit(1);
+});