fix: should export type Events (#5654)

```ts
declare module 'egg' {
  interface Events {
    [PACKAGE_ADDED]: (fullname: string) => Promise<void>;
  }
}
```

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Expanded public API with new module entry points for direct imports:
./ajv, ./aop, ./dal, ./helper, ./lib/define, ./orm, ./transaction, and
./config/plugin
  * Added Events type to main exports for easier typing

* **Bug Fixes / Improvements**
* Improved startup sequencing and port detection to reliably select
cluster/dev ports and log detected ports
* Dev command now always auto-detects an available port when none is
specified and simplifies port handling
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: fengmk2

examples/helloworld-tegg/package.json

@@ -47,6 +47,7 @@
     "./app/port/schedule/CronDemo": "./app/port/schedule/CronDemo.ts",
     "./app/port/schedule/Demo": "./app/port/schedule/Demo.ts",
     "./config/config.default": "./config/config.default.ts",
+    "./config/plugin": "./config/plugin.ts",
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -61,6 +62,7 @@
       "./app/port/schedule/CronDemo": "./dist/app/port/schedule/CronDemo.js",
       "./app/port/schedule/Demo": "./dist/app/port/schedule/Demo.js",
       "./config/config.default": "./dist/config/config.default.js",
+      "./config/plugin": "./dist/config/plugin.js",
       "./package.json": "./package.json"
     }
   }

packages/cluster/src/master.ts

@@ -77,13 +77,6 @@ export class Master extends ReadyEventEmitter {
     const frameworkPath = this.options.framework;
     const frameworkPkg = readJSONSync(path.join(frameworkPath, 'package.json'));
 
-    // set app & agent worker impl
-    if (this.options.startMode === 'worker_threads') {
-      this.startByWorkerThreads();
-    } else {
-      this.startByProcess();
-    }
-
     this.log(`[master] =================== ${frameworkPkg.name} start 🥚🥚🥚🥚 =====================`);
     this.logger.info(`[master] node version ${process.version}`);
     /* istanbul ignore next */
@@ -193,16 +186,22 @@ export class Master extends ReadyEventEmitter {
       fs.writeFileSync(this.options.pidFile, process.pid.toString(), 'utf-8');
     }
 
-    this.detectPorts().then(() => {
-      this.forkAgentWorker();
-    });
-
     // exit when agent or worker exception
     this.workerManager.on('exception', (count: { agent: number; worker: number }) => {
       const err = new ClusterWorkerExceptionError(count.agent, count.worker);
       this.logger.error(err);
       process.exit(1);
     });
+
+    await this.detectPorts();
+    // set app & agent worker impl
+    if (this.options.startMode === 'worker_threads') {
+      this.startByWorkerThreads();
+    } else {
+      this.startByProcess();
+    }
+
+    this.forkAgentWorker();
   }
 
   startByProcess(): void {
@@ -240,6 +239,7 @@ export class Master extends ReadyEventEmitter {
     try {
       const clusterPort = await detectPort();
       this.options.clusterPort = clusterPort;
+      this.log('[master] detected cluster port: %s', clusterPort);
       // If sticky mode, detect worker port
       if (this.options.sticky) {
         const stickyWorkerPort = await detectPort();

packages/cluster/src/utils/mode/impl/process/agent.ts

@@ -56,7 +56,7 @@ export class AgentProcessUtils extends BaseAgentUtils {
       forkOptions.execArgv = process.execArgv.concat([`--inspect-port=${debugPort}`]);
     }
 
-    debug('forkOptions: %j', forkOptions);
+    debug('forkOptions: %j, args: %s', forkOptions, args);
     const agentProcess = (this.#agentProcess = fork(this.getAgentWorkerFile(), args, forkOptions));
     const agentWorker = (this.instance = new AgentProcessWorker(agentProcess));
     agentWorker.status = 'starting';

packages/egg/package.json

@@ -10,6 +10,8 @@
     "exports": {
       ".": "./dist/index.js",
       "./agent": "./dist/agent.js",
+      "./ajv": "./dist/ajv.js",
+      "./aop": "./dist/aop.js",
       "./app/extend/context": "./dist/app/extend/context.js",
       "./app/extend/helper": "./dist/app/extend/helper.js",
       "./app/extend/request": "./dist/app/extend/request.js",
@@ -23,6 +25,8 @@
       "./config/config.local": "./dist/config/config.local.js",
       "./config/config.unittest": "./dist/config/config.unittest.js",
       "./config/plugin": "./dist/config/plugin.js",
+      "./dal": "./dist/dal.js",
+      "./helper": "./dist/helper.js",
       "./lib/agent": "./dist/lib/agent.js",
       "./lib/application": "./dist/lib/application.js",
       "./lib/core/base_context_class": "./dist/lib/core/base_context_class.js",
@@ -37,6 +41,7 @@
       "./lib/core/messenger/ipc": "./dist/lib/core/messenger/ipc.js",
       "./lib/core/messenger/local": "./dist/lib/core/messenger/local.js",
       "./lib/core/utils": "./dist/lib/core/utils.js",
+      "./lib/define": "./dist/lib/define.js",
       "./lib/egg": "./dist/lib/egg.js",
       "./lib/error": "./dist/lib/error/index.js",
       "./lib/error/CookieLimitExceedError": "./dist/lib/error/CookieLimitExceedError.js",
@@ -48,7 +53,9 @@
       "./lib/start": "./dist/lib/start.js",
       "./lib/types": "./dist/lib/types.js",
       "./lib/types.plugin": "./dist/lib/types.plugin.js",
+      "./orm": "./dist/orm.js",
       "./schedule": "./dist/schedule.js",
+      "./transaction": "./dist/transaction.js",
       "./urllib": "./dist/urllib.js",
       "./package.json": "./package.json"
     }
@@ -60,6 +67,8 @@
   "exports": {
     ".": "./src/index.ts",
     "./agent": "./src/agent.ts",
+    "./ajv": "./src/ajv.ts",
+    "./aop": "./src/aop.ts",
     "./app/extend/context": "./src/app/extend/context.ts",
     "./app/extend/helper": "./src/app/extend/helper.ts",
     "./app/extend/request": "./src/app/extend/request.ts",
@@ -73,6 +82,8 @@
     "./config/config.local": "./src/config/config.local.ts",
     "./config/config.unittest": "./src/config/config.unittest.ts",
     "./config/plugin": "./src/config/plugin.ts",
+    "./dal": "./src/dal.ts",
+    "./helper": "./src/helper.ts",
     "./lib/agent": "./src/lib/agent.ts",
     "./lib/application": "./src/lib/application.ts",
     "./lib/core/base_context_class": "./src/lib/core/base_context_class.ts",
@@ -87,6 +98,7 @@
     "./lib/core/messenger/ipc": "./src/lib/core/messenger/ipc.ts",
     "./lib/core/messenger/local": "./src/lib/core/messenger/local.ts",
     "./lib/core/utils": "./src/lib/core/utils.ts",
+    "./lib/define": "./src/lib/define.ts",
     "./lib/egg": "./src/lib/egg.ts",
     "./lib/error": "./src/lib/error/index.ts",
     "./lib/error/CookieLimitExceedError": "./src/lib/error/CookieLimitExceedError.ts",
@@ -98,7 +110,9 @@
     "./lib/start": "./src/lib/start.ts",
     "./lib/types": "./src/lib/types.ts",
     "./lib/types.plugin": "./src/lib/types.plugin.ts",
+    "./orm": "./src/orm.ts",
     "./schedule": "./src/schedule.ts",
+    "./transaction": "./src/transaction.ts",
     "./urllib": "./src/urllib.ts",
     "./package.json": "./package.json"
   },

packages/egg/src/index.ts

@@ -184,5 +184,6 @@ export {
   BackgroundTaskHelper,
   type ContextEventBus,
   type EventBus,
+  type Events,
   MetadataUtil,
 } from '@eggjs/tegg';

tools/egg-bin/src/commands/dev.ts

@@ -1,7 +1,7 @@
 import { debuglog } from 'node:util';
 
 import { Flags } from '@oclif/core';
-import { getConfig, getFrameworkPath } from '@eggjs/utils';
+import { getFrameworkPath } from '@eggjs/utils';
 import { detect } from 'detect-port';
 
 import { getSourceFilename } from '../utils.ts';
@@ -34,8 +34,8 @@ export default class Dev<T extends typeof Dev> extends BaseCommand<T> {
   };
 
   public async run(): Promise<void> {
-    debug('NODE_ENV: %o', this.env);
     this.env.NODE_ENV = this.env.NODE_ENV ?? 'development';
+    debug('NODE_ENV: %o', this.env.NODE_ENV);
     this.env.EGG_MASTER_CLOSE_TIMEOUT = '1000';
     const ext = this.isESM ? 'mjs' : 'cjs';
     const serverBin = getSourceFilename(`../scripts/start-cluster.${ext}`);
@@ -73,30 +73,13 @@ export default class Dev<T extends typeof Dev> extends BaseCommand<T> {
     });
 
     if (!flags.port) {
-      let configuredPort: number | undefined;
-      try {
-        const configuration = await getConfig({
-          framework: flags.framework,
-          baseDir: flags.base,
-          env: 'local',
-        });
-        configuredPort = configuration?.cluster?.listen?.port;
-      } catch (err) {
-        /** skip when failing to read the configuration */
-        debug('getConfig error: %s, framework: %o, baseDir: %o, env: local', err, flags.framework, flags.base);
-      }
-      if (configuredPort) {
-        flags.port = configuredPort;
-        debug(`use port ${flags.port} from configuration file`);
-      } else {
-        const defaultPort = parseInt(process.env.EGG_BIN_DEFAULT_PORT ?? '7001');
-        debug('detect available port');
-        flags.port = await detect(defaultPort);
-        if (flags.port !== defaultPort) {
-          console.warn('[@eggjs/bin] server port %o is unavailable, now using port %o', defaultPort, flags.port);
-        }
-        debug(`use available port ${flags.port}`);
+      const defaultPort = parseInt(process.env.EGG_BIN_DEFAULT_PORT ?? '7001');
+      debug('detect available port');
+      flags.port = await detect(defaultPort);
+      if (flags.port !== defaultPort) {
+        console.warn('[@eggjs/bin] server port %o is unavailable, now using port %o', defaultPort, flags.port);
       }
+      debug(`use available port ${flags.port}`);
     }
 
     return {