@eggjs/bin 7.0.0-beta.0

package/dist/esm/middleware/handle_error.js

@@ -0,0 +1,47 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { debuglog } from 'node:util';
+import { Inject, LifecycleHook, LifecycleHookUnit, Program, ArtusCliError, } from '@artus-cli/artus-cli';
+const debug = debuglog('@eggjs/bin/middleware/handle_error');
+let default_1 = class {
+    program;
+    async configDidLoad() {
+        this.program.use(async (_, next) => {
+            debug('enter next');
+            try {
+                await next();
+                debug('after next');
+            }
+            catch (err) {
+                debug('next error: %o', err);
+                // let artus cli to handle it
+                if (err instanceof ArtusCliError)
+                    throw err;
+                console.error(err);
+                process.exit(typeof err.code === 'number' ? err.code : 1);
+            }
+        });
+    }
+};
+__decorate([
+    Inject(),
+    __metadata("design:type", Program)
+], default_1.prototype, "program", void 0);
+__decorate([
+    LifecycleHook(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], default_1.prototype, "configDidLoad", null);
+default_1 = __decorate([
+    LifecycleHookUnit()
+], default_1);
+export default default_1;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGFuZGxlX2Vycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL21pZGRsZXdhcmUvaGFuZGxlX2Vycm9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFDckMsT0FBTyxFQUNMLE1BQU0sRUFBd0IsYUFBYSxFQUFFLGlCQUFpQixFQUFFLE9BQU8sRUFDdkUsYUFBYSxHQUNkLE1BQU0sc0JBQXNCLENBQUM7QUFFOUIsTUFBTSxLQUFLLEdBQUcsUUFBUSxDQUFDLG9DQUFvQyxDQUFDLENBQUM7QUFHOUMsZ0JBQUE7SUFFSSxPQUFPLENBQVU7SUFHNUIsQUFBTixLQUFLLENBQUMsYUFBYTtRQUNqQixJQUFJLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsQ0FBQyxFQUFFLElBQUksRUFBRSxFQUFFO1lBQ2pDLEtBQUssQ0FBQyxZQUFZLENBQUMsQ0FBQztZQUNwQixJQUFJLENBQUM7Z0JBQ0gsTUFBTSxJQUFJLEVBQUUsQ0FBQztnQkFDYixLQUFLLENBQUMsWUFBWSxDQUFDLENBQUM7WUFDdEIsQ0FBQztZQUFDLE9BQU8sR0FBUSxFQUFFLENBQUM7Z0JBQ2xCLEtBQUssQ0FBQyxnQkFBZ0IsRUFBRSxHQUFHLENBQUMsQ0FBQztnQkFDN0IsNkJBQTZCO2dCQUM3QixJQUFJLEdBQUcsWUFBWSxhQUFhO29CQUFFLE1BQU0sR0FBRyxDQUFDO2dCQUM1QyxPQUFPLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO2dCQUNuQixPQUFPLENBQUMsSUFBSSxDQUFDLE9BQU8sR0FBRyxDQUFDLElBQUksS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQzVELENBQUM7UUFDSCxDQUFDLENBQUMsQ0FBQztJQUNMLENBQUM7Q0FDRixDQUFBO0FBbEJrQjtJQURoQixNQUFNLEVBQUU7OEJBQ2lCLE9BQU87MENBQUM7QUFHNUI7SUFETCxhQUFhLEVBQUU7Ozs7OENBZWY7QUFuQlk7SUFEZCxpQkFBaUIsRUFBRTthQXFCbkIifQ==

package/dist/esm/middleware/inspect.d.ts

@@ -0,0 +1,5 @@
+import { ApplicationLifecycle } from '@artus-cli/artus-cli';
+export default class implements ApplicationLifecycle {
+    private readonly program;
+    configDidLoad(): Promise<void>;
+}

package/dist/esm/middleware/inspect.js

@@ -0,0 +1,69 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { debuglog } from 'node:util';
+import { Inject, LifecycleHook, LifecycleHookUnit, Program, } from '@artus-cli/artus-cli';
+import { addNodeOptionsToEnv } from '../utils.js';
+const debug = debuglog('@eggjs/bin/middleware/inspect');
+let default_1 = class {
+    program;
+    async configDidLoad() {
+        // add global options
+        // https://nodejs.org/dist/latest-v18.x/docs/api/cli.html#--inspect-brkhostport
+        this.program.option({
+            'inspect-brk': {
+                description: 'Activate inspector and break at start of user script',
+                type: 'boolean',
+            },
+            inspect: {
+                description: 'Activate inspector',
+                type: 'boolean',
+            },
+        });
+        this.program.use(async (ctx, next) => {
+            debug('before next');
+            let hasInspectOption = false;
+            if (ctx.args.inspect === true) {
+                addNodeOptionsToEnv('--inspect', ctx.env);
+                hasInspectOption = true;
+            }
+            if (ctx.args['inspect-brk'] === true) {
+                addNodeOptionsToEnv('--inspect-brk', ctx.env);
+                hasInspectOption = true;
+            }
+            if (hasInspectOption) {
+                ctx.args.timeout = false;
+                debug('set timeout = false when inspect enable, set env.NODE_OPTIONS=%o', ctx.env.NODE_OPTIONS);
+            }
+            else if (process.env.JB_DEBUG_FILE) {
+                // others like WebStorm 2019 will pass NODE_OPTIONS, and egg-bin itself will be debug, so could detect `process.env.JB_DEBUG_FILE`.
+                ctx.args.timeout = false;
+                debug('set timeout = false when process.env.JB_DEBUG_FILE=%o', process.env.JB_DEBUG_FILE);
+            }
+            debug('enter next');
+            await next();
+            debug('after next');
+        });
+    }
+};
+__decorate([
+    Inject(),
+    __metadata("design:type", Program)
+], default_1.prototype, "program", void 0);
+__decorate([
+    LifecycleHook(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], default_1.prototype, "configDidLoad", null);
+default_1 = __decorate([
+    LifecycleHookUnit()
+], default_1);
+export default default_1;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5zcGVjdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9taWRkbGV3YXJlL2luc3BlY3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7O0FBQUEsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUNyQyxPQUFPLEVBQ0wsTUFBTSxFQUF3QixhQUFhLEVBQUUsaUJBQWlCLEVBQzlELE9BQU8sR0FDUixNQUFNLHNCQUFzQixDQUFDO0FBQzlCLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUVsRCxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUMsK0JBQStCLENBQUMsQ0FBQztBQUd6QyxnQkFBQTtJQUVJLE9BQU8sQ0FBVTtJQUc1QixBQUFOLEtBQUssQ0FBQyxhQUFhO1FBQ2pCLHFCQUFxQjtRQUNyQiwrRUFBK0U7UUFDL0UsSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUM7WUFDbEIsYUFBYSxFQUFFO2dCQUNiLFdBQVcsRUFBRSxzREFBc0Q7Z0JBQ25FLElBQUksRUFBRSxTQUFTO2FBQ2hCO1lBQ0QsT0FBTyxFQUFFO2dCQUNQLFdBQVcsRUFBRSxvQkFBb0I7Z0JBQ2pDLElBQUksRUFBRSxTQUFTO2FBQ2hCO1NBQ0YsQ0FBQyxDQUFDO1FBRUgsSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsS0FBSyxFQUFFLEdBQW1CLEVBQUUsSUFBSSxFQUFFLEVBQUU7WUFDbkQsS0FBSyxDQUFDLGFBQWEsQ0FBQyxDQUFDO1lBQ3JCLElBQUksZ0JBQWdCLEdBQUcsS0FBSyxDQUFDO1lBQzdCLElBQUksR0FBRyxDQUFDLElBQUksQ0FBQyxPQUFPLEtBQUssSUFBSSxFQUFFLENBQUM7Z0JBQzlCLG1CQUFtQixDQUFDLFdBQVcsRUFBRSxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUM7Z0JBQzFDLGdCQUFnQixHQUFHLElBQUksQ0FBQztZQUMxQixDQUFDO1lBQ0QsSUFBSSxHQUFHLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxLQUFLLElBQUksRUFBRSxDQUFDO2dCQUNyQyxtQkFBbUIsQ0FBQyxlQUFlLEVBQUUsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO2dCQUM5QyxnQkFBZ0IsR0FBRyxJQUFJLENBQUM7WUFDMUIsQ0FBQztZQUNELElBQUksZ0JBQWdCLEVBQUUsQ0FBQztnQkFDckIsR0FBRyxDQUFDLElBQUksQ0FBQyxPQUFPLEdBQUcsS0FBSyxDQUFDO2dCQUN6QixLQUFLLENBQUMsa0VBQWtFLEVBQUUsR0FBRyxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsQ0FBQztZQUNsRyxDQUFDO2lCQUFNLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxhQUFhLEVBQUUsQ0FBQztnQkFDckMsbUlBQW1JO2dCQUNuSSxHQUFHLENBQUMsSUFBSSxDQUFDLE9BQU8sR0FBRyxLQUFLLENBQUM7Z0JBQ3pCLEtBQUssQ0FBQyx1REFBdUQsRUFBRSxPQUFPLENBQUMsR0FBRyxDQUFDLGFBQWEsQ0FBQyxDQUFDO1lBQzVGLENBQUM7WUFDRCxLQUFLLENBQUMsWUFBWSxDQUFDLENBQUM7WUFDcEIsTUFBTSxJQUFJLEVBQUUsQ0FBQztZQUNiLEtBQUssQ0FBQyxZQUFZLENBQUMsQ0FBQztRQUN0QixDQUFDLENBQUMsQ0FBQztJQUNMLENBQUM7Q0FDRixDQUFBO0FBekNrQjtJQURoQixNQUFNLEVBQUU7OEJBQ2lCLE9BQU87MENBQUM7QUFHNUI7SUFETCxhQUFhLEVBQUU7Ozs7OENBc0NmO0FBMUNZO0lBRGQsaUJBQWlCLEVBQUU7YUE0Q25CIn0=

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function addNodeOptionsToEnv(options: string, env: Record<string, any>): void;
+export declare function readPackageJSON(baseDir: string): Promise<any>;
+export declare function hasTsConfig(baseDir: string): Promise<boolean>;
+export declare function getSourceDirname(): string;
+export declare function getSourceFilename(filename: string): string;

package/dist/esm/utils.js

@@ -0,0 +1,46 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export function addNodeOptionsToEnv(options, env) {
+    if (env.NODE_OPTIONS) {
+        if (!env.NODE_OPTIONS.includes(options)) {
+            env.NODE_OPTIONS = `${env.NODE_OPTIONS} ${options}`;
+        }
+    }
+    else {
+        env.NODE_OPTIONS = options;
+    }
+}
+export async function readPackageJSON(baseDir) {
+    const pkgFile = path.join(baseDir, 'package.json');
+    try {
+        const pkgJSON = await fs.readFile(pkgFile, 'utf8');
+        return JSON.parse(pkgJSON);
+    }
+    catch {
+        return {};
+    }
+}
+export async function hasTsConfig(baseDir) {
+    const pkgFile = path.join(baseDir, 'tsconfig.json');
+    try {
+        await fs.access(pkgFile);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function getSourceDirname() {
+    if (typeof __dirname === 'string') {
+        return __dirname;
+    }
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    const __filename = fileURLToPath(import.meta.url);
+    return path.dirname(__filename);
+}
+export function getSourceFilename(filename) {
+    return path.join(getSourceDirname(), filename);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDbEMsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBQzdCLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxVQUFVLENBQUM7QUFFekMsTUFBTSxVQUFVLG1CQUFtQixDQUFDLE9BQWUsRUFBRSxHQUF3QjtJQUMzRSxJQUFJLEdBQUcsQ0FBQyxZQUFZLEVBQUUsQ0FBQztRQUNyQixJQUFJLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUN4QyxHQUFHLENBQUMsWUFBWSxHQUFHLEdBQUcsR0FBRyxDQUFDLFlBQVksSUFBSSxPQUFPLEVBQUUsQ0FBQztRQUN0RCxDQUFDO0lBQ0gsQ0FBQztTQUFNLENBQUM7UUFDTixHQUFHLENBQUMsWUFBWSxHQUFHLE9BQU8sQ0FBQztJQUM3QixDQUFDO0FBQ0gsQ0FBQztBQUVELE1BQU0sQ0FBQyxLQUFLLFVBQVUsZUFBZSxDQUFDLE9BQWU7SUFDbkQsTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLEVBQUUsY0FBYyxDQUFDLENBQUM7SUFDbkQsSUFBSSxDQUFDO1FBQ0gsTUFBTSxPQUFPLEdBQUcsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQztRQUNuRCxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDN0IsQ0FBQztJQUFDLE1BQU0sQ0FBQztRQUNQLE9BQU8sRUFBRSxDQUFDO0lBQ1osQ0FBQztBQUNILENBQUM7QUFFRCxNQUFNLENBQUMsS0FBSyxVQUFVLFdBQVcsQ0FBQyxPQUFlO0lBQy9DLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLGVBQWUsQ0FBQyxDQUFDO0lBQ3BELElBQUksQ0FBQztRQUNILE1BQU0sRUFBRSxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUN6QixPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFBQyxNQUFNLENBQUM7UUFDUCxPQUFPLEtBQUssQ0FBQztJQUNmLENBQUM7QUFDSCxDQUFDO0FBRUQsTUFBTSxVQUFVLGdCQUFnQjtJQUM5QixJQUFJLE9BQU8sU0FBUyxLQUFLLFFBQVEsRUFBRSxDQUFDO1FBQ2xDLE9BQU8sU0FBUyxDQUFDO0lBQ25CLENBQUM7SUFDRCw2REFBNkQ7SUFDN0QsYUFBYTtJQUNiLE1BQU0sVUFBVSxHQUFHLGFBQWEsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQ2xELE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUMsQ0FBQztBQUNsQyxDQUFDO0FBRUQsTUFBTSxVQUFVLGlCQUFpQixDQUFDLFFBQWdCO0lBQ2hELE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxnQkFBZ0IsRUFBRSxFQUFFLFFBQVEsQ0FBQyxDQUFDO0FBQ2pELENBQUMifQ==

package/dist/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "@eggjs/bin",
+  "version": "7.0.0-beta.0"
+}

package/dist/scripts/postinstall.mjs

@@ -0,0 +1,59 @@
+import { debuglog } from 'node:util';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runScript } from 'runscript';
+import { readJSON, exists } from 'utility';
+import { importResolve } from '@eggjs/utils';
+
+const debug = debuglog('@eggjs/bin/scripts/postinstall');
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+async function main() {
+  // node postintall.js </path/to/egg-ts-helper/dist/bin> <framework-package-name>
+  const etsBinFile = process.argv[2] || importResolve('egg-ts-helper/dist/bin', {
+    paths: [ __dirname ],
+  });
+  const frameworkPackageName = process.argv[3] || 'egg';
+
+  // try to use INIT_CWD env https://docs.npmjs.com/cli/v9/commands/npm-run-script
+  // npm_rootpath is npminstall
+  const npmRunRoot = process.env.INIT_CWD || process.env.npm_rootpath;
+
+  debug('process.argv: %o', process.argv);
+  debug('process.env.INIT_CWD: %o', process.env.INIT_CWD);
+  debug('process.env.npm_rootpath: %o', process.env.npm_rootpath);
+  debug('etsBinFile: %o', etsBinFile);
+  debug('frameworkPackageName: %o', frameworkPackageName);
+  debug('npmRunRoot: %o', npmRunRoot);
+
+  if (npmRunRoot) {
+    const pkgFile = path.join(npmRunRoot, 'package.json');
+    const pkgFileExists = await exists(pkgFile);
+    debug('pkgFile: %o exists: %o', pkgFile, pkgFileExists);
+    if (pkgFileExists) {
+      const pkg = await readJSON(pkgFile);
+      // should set pkg.egg.declarations = true or pkg.egg.typescript = true
+      if (!pkg.egg?.typescript && !pkg.egg?.declarations) return;
+      // ignore eggModule and framework
+      // framework package.json:
+      // "egg": {
+      //   "isFramework": true,
+      //   "typescript": true
+      // }
+      if (pkg.eggModule) return;
+      if (pkg.egg.isFramework) return;
+      // ignore when the current app don't has a framework dependencies
+      if (!pkg.dependencies || !pkg.dependencies[frameworkPackageName]) return;
+      // set ETS_CWD
+      process.env.ETS_CWD = npmRunRoot;
+      // https://github.com/eggjs/egg-ts-helper/pull/104
+      process.env.ETS_SCRIPT_FRAMEWORK = frameworkPackageName;
+      console.log('[@eggjs/bin/postinstall] run %s on %s', etsBinFile, npmRunRoot);
+      runScript(`node ${etsBinFile}`);
+    }
+  }
+}
+
+main();

package/dist/scripts/start-cluster.mjs

@@ -0,0 +1,14 @@
+import { debuglog } from 'node:util';
+import { importModule } from '@eggjs/utils';
+
+const debug = debuglog('@eggjs/bin/scripts/start-cluster');
+
+async function main() {
+  debug('argv: %o', process.argv);
+  const options = JSON.parse(process.argv[2]);
+  debug('start cluster options: %o', options);
+  const { startCluster } = await importModule(options.framework);
+  await startCluster(options);
+}
+
+main();

package/package.json

@@ -0,0 +1,123 @@
+{
+  "name": "@eggjs/bin",
+  "version": "7.0.0-beta.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "egg developer tool",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:eggjs/bin.git"
+  },
+  "bug": {
+    "url": "https://github.com/eggjs/egg/issues"
+  },
+  "homepage": "https://github.com/eggjs/bin",
+  "author": "fengmk2 <fengmk2@gmail.com> (https://github.com/fengmk2)",
+  "scripts2": {
+    "postinstall": "node scripts/postinstall.js",
+    "lint": "eslint . --cache --ext ts",
+    "test": "npm run lint -- --fix && npm run test-local",
+    "test-local": "npm run tsc && node dist/bin/cli.js test",
+    "test-local-with-ts-node-transpile-only": "node -r ts-node/register/transpile-only src/bin/cli.ts test",
+    "test-local-with-swc": "node -r @swc-node/register src/bin/cli.ts test",
+    "test-local-with-esbuild": "node -r esbuild-register src/bin/cli.ts test",
+    "test-tsc": "npm run clean && npm run tsc && node dist/bin/cli.js && node dist/bin/cli.js test --base test/fixtures/example-ts && node dist/bin/cli.js dev --base test/fixtures/example-ts",
+    "cov": "c8 -r lcov -r text-summary -x 'test/**' npm run test-local -- --timeout 120000",
+    "ci": "npm run lint && npm run test-local && npm run test-tsc",
+    "prepublishOnly": "npm run clean && npm run tsc",
+    "tsc": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">= 18.19.0"
+  },
+  "dependencies": {
+    "@artus-cli/artus-cli": "^1.0.1",
+    "@artus-cli/plugin-autocomplete": "^0.1.1",
+    "@artus-cli/plugin-version": "^1.0.2",
+    "@eggjs/utils": "^4.1.2",
+    "c8": "^10.0.0",
+    "detect-port": "^2.0.0",
+    "egg-ts-helper": "^2.1.0",
+    "globby": "^11.1.0",
+    "jest-changed-files": "^29.4.2",
+    "mocha": "^10.2.0",
+    "mochawesome-with-mocha": "^7.1.3",
+    "runscript": "^2.0.0",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.1.2",
+    "utility": "^2.4.0"
+  },
+  "peerDependencies": {
+    "@eggjs/mock": "beta"
+  },
+  "peerDependenciesMeta": {
+    "@eggjs/mock": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.17.1",
+    "@eggjs/mock": "beta",
+    "@eggjs/tsconfig": "1",
+    "@swc-node/register": "^1.6.1",
+    "@swc/core": "^1.3.35",
+    "@types/mocha": "10",
+    "@types/node": "22",
+    "cpy": "^8.1.2",
+    "cpy-cli": "^5.0.0",
+    "egg": "beta",
+    "egg-bin": "6",
+    "esbuild": "^0.17.7",
+    "esbuild-register": "^3.4.2",
+    "eslint": "8",
+    "eslint-config-egg": "14",
+    "rimraf": "6",
+    "tshy": "3",
+    "tshy-after": "1",
+    "typescript": "5"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.mjs",
+    "lint": "eslint --cache src test --ext .ts",
+    "pretest": "npm run clean && npm run lint -- --fix",
+    "test": "egg-bin test",
+    "preci": "npm run clean &&  npm run lint",
+    "ci": "egg-bin cov && npm run prepublishOnly",
+    "clean": "rimraf dist",
+    "copyScripts": "rimraf dist/scripts && cpy scripts dist",
+    "prepublishOnly": "tshy && tshy-after && attw --pack && rimraf dist/commonjs && npm run copyScripts"
+  },
+  "type": "module",
+  "tshy": {
+    "exports": {
+      ".": "./src/index.ts",
+      "./package.json": "./package.json"
+    }
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "scripts"
+  ],
+  "bin": {
+    "egg-bin": "./dist/esm/bin/cli.js"
+  },
+  "types": "./dist/commonjs/index.d.ts",
+  "main": "./dist/commonjs/index.js",
+  "module": "./dist/esm/index.js"
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,59 @@
+import { debuglog } from 'node:util';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runScript } from 'runscript';
+import { readJSON, exists } from 'utility';
+import { importResolve } from '@eggjs/utils';
+
+const debug = debuglog('@eggjs/bin/scripts/postinstall');
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+async function main() {
+  // node postintall.js </path/to/egg-ts-helper/dist/bin> <framework-package-name>
+  const etsBinFile = process.argv[2] || importResolve('egg-ts-helper/dist/bin', {
+    paths: [ __dirname ],
+  });
+  const frameworkPackageName = process.argv[3] || 'egg';
+
+  // try to use INIT_CWD env https://docs.npmjs.com/cli/v9/commands/npm-run-script
+  // npm_rootpath is npminstall
+  const npmRunRoot = process.env.INIT_CWD || process.env.npm_rootpath;
+
+  debug('process.argv: %o', process.argv);
+  debug('process.env.INIT_CWD: %o', process.env.INIT_CWD);
+  debug('process.env.npm_rootpath: %o', process.env.npm_rootpath);
+  debug('etsBinFile: %o', etsBinFile);
+  debug('frameworkPackageName: %o', frameworkPackageName);
+  debug('npmRunRoot: %o', npmRunRoot);
+
+  if (npmRunRoot) {
+    const pkgFile = path.join(npmRunRoot, 'package.json');
+    const pkgFileExists = await exists(pkgFile);
+    debug('pkgFile: %o exists: %o', pkgFile, pkgFileExists);
+    if (pkgFileExists) {
+      const pkg = await readJSON(pkgFile);
+      // should set pkg.egg.declarations = true or pkg.egg.typescript = true
+      if (!pkg.egg?.typescript && !pkg.egg?.declarations) return;
+      // ignore eggModule and framework
+      // framework package.json:
+      // "egg": {
+      //   "isFramework": true,
+      //   "typescript": true
+      // }
+      if (pkg.eggModule) return;
+      if (pkg.egg.isFramework) return;
+      // ignore when the current app don't has a framework dependencies
+      if (!pkg.dependencies || !pkg.dependencies[frameworkPackageName]) return;
+      // set ETS_CWD
+      process.env.ETS_CWD = npmRunRoot;
+      // https://github.com/eggjs/egg-ts-helper/pull/104
+      process.env.ETS_SCRIPT_FRAMEWORK = frameworkPackageName;
+      console.log('[@eggjs/bin/postinstall] run %s on %s', etsBinFile, npmRunRoot);
+      runScript(`node ${etsBinFile}`);
+    }
+  }
+}
+
+main();

package/scripts/start-cluster.mjs

@@ -0,0 +1,14 @@
+import { debuglog } from 'node:util';
+import { importModule } from '@eggjs/utils';
+
+const debug = debuglog('@eggjs/bin/scripts/start-cluster');
+
+async function main() {
+  debug('argv: %o', process.argv);
+  const options = JSON.parse(process.argv[2]);
+  debug('start cluster options: %o', options);
+  const { startCluster } = await importModule(options.framework);
+  await startCluster(options);
+}
+
+main();

package/src/bin/cli.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { start } from '@artus-cli/artus-cli';
+
+function getCurrentFilename() {
+  if (typeof __filename === 'string') {
+    return __filename;
+  }
+  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+  // @ts-ignore
+  return fileURLToPath(import.meta.url);
+}
+
+function main() {
+  const currentFilename = getCurrentFilename();
+  // src/bin/cli.ts => src/
+  let baseDir = path.dirname(path.dirname(currentFilename));
+  const isBuildJavascriptFile = getCurrentFilename().endsWith('.js');
+  const exclude = [ 'scripts', 'bin', 'test', 'coverage' ];
+  if (isBuildJavascriptFile) {
+    // dist/esm/bin/cli.js => dist/
+    baseDir = path.dirname(baseDir);
+    exclude.push('*.ts');
+  } else {
+    exclude.push('dist');
+  }
+
+  start({ exclude, baseDir });
+}
+
+main();

package/src/cmd/base.ts

@@ -0,0 +1,133 @@
+import { debuglog } from 'node:util';
+import { fork, ForkOptions, ChildProcess } from 'node:child_process';
+import {
+  DefineCommand,
+  Option, Command,
+  CommandContext,
+  Inject,
+  Utils,
+} from '@artus-cli/artus-cli';
+
+const debug = debuglog('@eggjs/bin/base');
+
+// only hook once and only when ever start any child.
+const children = new Set<ChildProcess>();
+let hadHook = false;
+function graceful(proc: ChildProcess) {
+  // save child ref
+  children.add(proc);
+
+  // only hook once
+  /* c8 ignore else */
+  if (!hadHook) {
+    hadHook = true;
+    let signal: NodeJS.Signals;
+    [ 'SIGINT', 'SIGQUIT', 'SIGTERM' ].forEach(event => {
+      process.once(event, () => {
+        signal = event as NodeJS.Signals;
+        process.exit(0);
+      });
+    });
+
+    process.once('exit', (code: number) => {
+      for (const child of children) {
+        debug('process exit code: %o, kill child %o with %o', code, child.pid, signal);
+        child.kill(signal);
+      }
+    });
+  }
+}
+
+class ForkError extends Error {
+  code: number | null;
+  constructor(message: string, code: number | null) {
+    super(message);
+    this.code = code;
+  }
+}
+
+@DefineCommand()
+export abstract class BaseCommand extends Command {
+  @Option({
+    description: 'whether show full command script only, default is false',
+    alias: 'd',
+    type: 'boolean',
+    default: false,
+  })
+  dryRun: boolean;
+
+  @Option({
+    description: 'require the given module',
+    alias: 'r',
+    array: true,
+    default: [],
+  })
+  require: string[];
+
+  @Inject()
+  ctx: CommandContext;
+
+  @Inject()
+  utils: Utils;
+
+  // FIXME: should has a better way to init global args default value
+  protected get base() {
+    return this.ctx.args.base;
+  }
+
+  async run() {
+    await this.utils.redirect([ '--help' ]);
+  }
+
+  protected async formatRequires() {
+    const requires = this.require ?? [];
+    const eggRequire = this.ctx.args.pkgEgg.require;
+    if (Array.isArray(eggRequire)) {
+      for (const r of eggRequire) {
+        requires.push(r);
+      }
+    } else if (typeof eggRequire === 'string' && eggRequire) {
+      requires.push(eggRequire);
+    }
+    return requires;
+  }
+
+  protected async forkNode(modulePath: string, args: string[], options: ForkOptions = {}) {
+    if (this.dryRun) {
+      console.log('dry run: $ %o', `${process.execPath} ${modulePath} ${args.join(' ')}`);
+      return;
+    }
+    const forkExecArgv = [
+      ...this.ctx.args.execArgv || [],
+      ...options.execArgv || [],
+    ];
+
+    options = {
+      stdio: 'inherit',
+      env: this.ctx.env,
+      cwd: this.base,
+      ...options,
+      execArgv: forkExecArgv,
+    };
+    const proc = fork(modulePath, args, options);
+    debug('Run fork pid: %o\n\n$ %s%s %s %s\n\n',
+      proc.pid,
+      options.env?.NODE_OPTIONS ? `NODE_OPTIONS='${options.env.NODE_OPTIONS}' ` : '',
+      process.execPath,
+      modulePath, args.map(a => `'${a}'`).join(' '));
+    graceful(proc);
+
+    return new Promise<void>((resolve, reject) => {
+      proc.once('exit', code => {
+        debug('fork pid: %o exit code %o', proc.pid, code);
+        children.delete(proc);
+        if (code !== 0) {
+          const err = new ForkError(modulePath + ' ' + args.join(' ') + ' exit with code ' + code, code);
+          reject(err);
+        } else {
+          resolve();
+        }
+      });
+    });
+  }
+}