jax-hono 1.0.1 → 1.0.2

package/README.md

@@ -13,5 +13,5 @@ helpers/    框架辅助函数
 utils/      纯工具函数
 errors/     统一错误类型
 types/      框架公共类型
-generated/  自动生成的注册表
+generated/  调用项目中自动生成的注册表，包内同名目录会链接到这里
 ```

package/bin/jax.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const cliPath = path.join(__dirname, "jax.ts");
+
+function getBunCommand() {
+  const candidates = [];
+
+  if (process.env.BUN_INSTALL) {
+    candidates.push(
+      path.join(
+        process.env.BUN_INSTALL,
+        "bin",
+        process.platform === "win32" ? "bun.exe" : "bun",
+      ),
+    );
+  }
+
+  if (process.platform === "win32") {
+    const nodeDir = path.dirname(process.execPath);
+    candidates.push(
+      path.join(nodeDir, "bun.exe"),
+      path.join(nodeDir, "node_modules", "bun", "bin", "bun.exe"),
+    );
+  }
+
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  return "bun";
+}
+
+const child = spawn(getBunCommand(), [cliPath, ...process.argv.slice(2)], {
+  stdio: "inherit",
+  windowsHide: true,
+});
+
+child.on("error", (error) => {
+  if (error.code === "ENOENT") {
+    console.error(
+      "未找到 Bun。请从 https://bun.sh 安装 Bun，或确认 bun 已加入 PATH。",
+    );
+    process.exit(1);
+  }
+
+  console.error(error.message);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+
+  process.exit(code ?? 0);
+});

package/bin/jax.ts

@@ -4,18 +4,40 @@ import { cac } from "cac";
 import { $ } from "bun";
 import path from "node:path";
 import { existsSync } from "node:fs";
-import { mkdir } from "node:fs/promises";
+import { lstat, mkdir, rm } from "node:fs/promises";
 
 const cli = cac("jax");
 
+async function removeExistingTarget(
+  targetDir: string,
+  allowRegularDirectory: boolean,
+) {
+  if (!existsSync(targetDir)) {
+    return;
+  }
+
+  const stats = await lstat(targetDir);
+  if (stats.isSymbolicLink() || allowRegularDirectory) {
+    await rm(targetDir, { recursive: true, force: true });
+    return;
+  }
+
+  console.error(
+    `目标已存在且不是符号链接：${targetDir}\n请手动删除后再执行 jax link。`,
+  );
+  process.exit(1);
+}
+
 cli
-  .command(
-    "link",
-    "Create a symlink to the jax-hono installation directory",
-  )
+  .command("link", "创建指向 jax-hono 安装目录的链接")
   .action(async () => {
     const cwd = process.cwd();
     const sourceDir = path.resolve(import.meta.dir, "..");
+    if (path.resolve(cwd) === sourceDir) {
+      console.error("不能在 jax-hono 安装目录内执行 jax link。");
+      process.exit(1);
+    }
+
     const shouldUseNodeModules =
       existsSync(path.join(cwd, "package.json")) ||
       existsSync(path.join(cwd, "node_modules"));
@@ -29,54 +51,90 @@ cli
       await mkdir(targetRoot, { recursive: true });
     }
 
+    await removeExistingTarget(targetDir, shouldUseNodeModules);
+
     if (process.platform === "win32") {
       const result =
-        await $`cmd /c mklink /D ${targetDir} ${sourceDir}`.nothrow();
+        await $`cmd /c mklink /J ${targetDir} ${sourceDir}`.nothrow().quiet();
       if (result.exitCode !== 0) {
         console.error(
-          "Failed to create symlink. Make sure you run as Administrator.",
+          `创建目录联接失败：${result.stderr.toString()}`,
         );
         process.exit(1);
       }
-      console.log(`Symlink created: ${targetDir} <<===>> ${sourceDir}`);
+      console.log(`目录联接已创建：${targetDir} <<===>> ${sourceDir}`);
     } else {
       const relativeSource = path.relative(path.dirname(targetDir), sourceDir);
-      const result = await $`ln -sf ${relativeSource} ${targetDir}`.nothrow();
+      const result = await $`ln -sf ${relativeSource} ${targetDir}`.nothrow().quiet();
       if (result.exitCode !== 0) {
-        console.error(`Failed to create symlink: ${result.stderr.toString()}`);
+        console.error(`创建符号链接失败：${result.stderr.toString()}`);
         process.exit(1);
       }
-      console.log(`Symlink created: ${targetDir} -> ${relativeSource}`);
+      console.log(`符号链接已创建：${targetDir} -> ${relativeSource}`);
     }
   });
 
 cli
-  .command("open", "Open jax-hono installation directory in file manager")
+  .command("open", "在文件管理器中打开 jax-hono 安装目录")
   .action(async () => {
     const sourceDir = path.resolve(import.meta.dir, "..");
 
-    let command: string[];
-    if (process.platform === "darwin") {
-      command = ["open", sourceDir];
-    } else if (process.platform === "win32") {
-      command = ["explorer", sourceDir];
-    } else {
-      command = ["xdg-open", sourceDir];
+    if (process.platform === "win32") {
+      const escapedSourceDir = sourceDir.replace(/'/g, "''");
+      const proc = Bun.spawn([
+        "powershell",
+        "-NoProfile",
+        "-Command",
+        `Start-Process -FilePath explorer.exe -ArgumentList '${escapedSourceDir}'`,
+      ], {
+        stdout: "pipe",
+        stderr: "pipe",
+        windowsHide: true,
+      });
+      const exitCode = await proc.exited;
+      const stderr = await new Response(proc.stderr).text();
+
+      if (exitCode !== 0) {
+        console.error(`打开目录失败：${stderr || "未知错误"}`);
+        process.exit(1);
+      }
+
+      console.log(`已打开：${sourceDir}`);
+      return;
     }
 
+    const command =
+      process.platform === "darwin" ? ["open", sourceDir] : ["xdg-open", sourceDir];
     const [cmd, ...args] = command;
-    const result = await $`${cmd} ${args}`.nothrow();
+    const result = await $`${cmd} ${args}`.nothrow().quiet();
     if (result.exitCode !== 0) {
-      console.error(`Failed to open directory: ${result.stderr.toString()}`);
+      console.error(`打开目录失败：${result.stderr.toString() || "未知错误"}`);
       process.exit(1);
     }
-    console.log(`Opened: ${sourceDir}`);
+    console.log(`已打开：${sourceDir}`);
   });
 
-cli.help();
+cli.help((sections) =>
+  sections.map((section) => {
+    const titleMap: Record<string, string> = {
+      Usage: "用法",
+      Commands: "命令",
+      "For more info, run any command with the `--help` flag":
+        "查看更多信息，请在任意命令后添加 `--help`",
+      Options: "选项",
+      Examples: "示例",
+    };
+
+    return {
+      ...section,
+      title: section.title ? (titleMap[section.title] ?? section.title) : section.title,
+      body: section.body.replace("Display this message", "显示帮助信息"),
+    };
+  }),
+);
 const parsed = cli.parse();
 
-// Show help when no command is matched (e.g. bare `jax` or unknown command)
+// 未匹配到命令时显示帮助，例如直接执行 `jax` 或输入未知命令。
 if (!cli.matchedCommand && !parsed.options.help) {
   cli.outputHelp();
 }

package/build/generate-config.ts

@@ -1,12 +1,11 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
+import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
 import { cwd } from 'node:process'
 import { join, parse, relative } from 'node:path'
+import { ensureGeneratedDir, generatedDir, projectDir } from './generated-path'
 
-const packageDir = join(import.meta.dir, '..')
 const srcDir = join(cwd(), 'src')
 const configDir = join(srcDir, 'config')
 const typesFile = join(srcDir, 'types/index.ts')
-const generatedDir = join(packageDir, 'generated')
 const outputFile = join(generatedDir, 'config.ts')
 const envStages = new Set([
   'default',
@@ -102,14 +101,14 @@ ${projectConfigType}
 export default configModules
 `
 
-  mkdirSync(generatedDir, { recursive: true })
+  ensureGeneratedDir()
 
   if (existsSync(outputFile) && readFileSync(outputFile, 'utf8') === content) {
     return
   }
 
   writeFileSync(outputFile, content)
-  console.log(`Generated ${relative(srcDir, outputFile)} with ${files.length} config file(s).`)
+  console.log(`Generated ${relative(projectDir, outputFile)} with ${files.length} config file(s).`)
 }
 
 if (import.meta.main) {

package/build/generate-registry.ts

@@ -1,10 +1,9 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
+import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
 import { cwd } from 'node:process'
 import { basename, join, parse, relative } from 'node:path'
+import { ensureGeneratedDir, generatedDir, projectDir } from './generated-path'
 
-const packageDir = join(import.meta.dir, '..')
 const srcDir = join(cwd(), 'src')
-const generatedDir = join(packageDir, 'generated')
 const moduleExtensions = new Set(['.ts', '.js', '.mjs', '.cjs'])
 const generatedHeader = `// This file is generated by jax-hono/build/generate-registry.ts.
 // Do not edit it directly.
@@ -66,14 +65,14 @@ function walkFiles(dir: string): string[] {
 function writeGeneratedFile(fileName: string, content: string) {
   const outputFile = join(generatedDir, fileName)
 
-  mkdirSync(generatedDir, { recursive: true })
+  ensureGeneratedDir()
 
   if (existsSync(outputFile) && readFileSync(outputFile, 'utf8') === content) {
     return
   }
 
   writeFileSync(outputFile, content)
-  console.log(`Generated ${relative(srcDir, outputFile)}.`)
+  console.log(`Generated ${relative(projectDir, outputFile)}.`)
 }
 
 function toImportPath(filePath: string) {

package/build/generated-path.ts

@@ -0,0 +1,57 @@
+import {
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  realpathSync,
+  rmSync,
+  symlinkSync,
+} from 'node:fs'
+import { cwd } from 'node:process'
+import { join, resolve } from 'node:path'
+
+export const packageDir = join(import.meta.dir, '..')
+export const projectDir = cwd()
+
+export function getGeneratedDir() {
+  const configuredDir = Bun.env.JAX_HONO_GENERATED_DIR
+
+  return configuredDir
+    ? resolve(projectDir, configuredDir)
+    : join(projectDir, 'generated')
+}
+
+export const generatedDir = getGeneratedDir()
+
+export function ensureGeneratedDir() {
+  mkdirSync(generatedDir, { recursive: true })
+  ensurePackageGeneratedLink()
+}
+
+function ensurePackageGeneratedLink() {
+  const packageGeneratedDir = join(packageDir, 'generated')
+
+  if (resolve(packageGeneratedDir) === resolve(generatedDir)) {
+    if (existsSync(packageGeneratedDir) && lstatSync(packageGeneratedDir).isSymbolicLink()) {
+      rmSync(packageGeneratedDir, { recursive: true, force: true })
+      mkdirSync(generatedDir, { recursive: true })
+    }
+
+    return
+  }
+
+  if (existsSync(packageGeneratedDir)) {
+    const stats = lstatSync(packageGeneratedDir)
+
+    if (stats.isSymbolicLink()) {
+      const currentTarget = realpathSync(packageGeneratedDir)
+
+      if (resolve(currentTarget) === resolve(generatedDir)) {
+        return
+      }
+    }
+
+    rmSync(packageGeneratedDir, { recursive: true, force: true })
+  }
+
+  symlinkSync(generatedDir, packageGeneratedDir, 'junction')
+}

package/docs/jax.md

@@ -80,7 +80,7 @@ export default definePlugin({
 });
 ```
 
-未启用的插件不会写入 `src/jax/generated/plugins.generated.ts`，因此 `bun build` 不会解析它的运行时依赖。
+未启用的插件不会写入调用项目的 `generated/plugins.generated.ts`，因此 `bun build` 不会解析它的运行时依赖。
 
 ### `build`
 
@@ -88,12 +88,12 @@ export default definePlugin({
 
 当前 `bun run setup` 会生成：
 
-- `src/jax/generated/config.ts`
-- `src/jax/generated/controllers.generated.ts`
-- `src/jax/generated/middlewares.generated.ts`
-- `src/jax/generated/models.generated.ts`
-- `src/jax/generated/plugins.generated.ts`
-- `src/jax/generated/services.generated.ts`
+- `generated/config.ts`
+- `generated/controllers.generated.ts`
+- `generated/middlewares.generated.ts`
+- `generated/models.generated.ts`
+- `generated/plugins.generated.ts`
+- `generated/services.generated.ts`
 
 业务代码不要手动编辑 `generated` 目录。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jax-hono",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Lightweight framework layer on top of Hono, built for Bun",
   "type": "module",
   "main": "./index.ts",
@@ -60,7 +60,7 @@
     }
   },
   "bin": {
-    "jax": "./bin/jax.ts"
+    "jax": "./bin/jax.js"
   },
   "files": [
     "index.ts",
@@ -94,6 +94,7 @@
     "mongoose": "*"
   },
   "devDependencies": {
+    "@types/bun": "^1.3.14",
     "dayjs": "^1.11.21",
     "deepmerge": "^4.3.1",
     "dotenv": "^17.4.2",

package/plugins/mongoose/model.ts

@@ -6,7 +6,7 @@ import mongoose, {
   type Model,
   type SchemaOptions,
 } from "mongoose";
-import config from "@/config";
+import config from "../../config";
 import { rankSetter } from "./schema";
 import dayjs from "dayjs";