jax-hono 1.0.0 → 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

@@ -3,66 +3,138 @@
 import { cac } from "cac";
 import { $ } from "bun";
 import path from "node:path";
+import { existsSync } from "node:fs";
+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 (./jax -> jax-hono installation directory)",
-  )
+  .command("link", "创建指向 jax-hono 安装目录的链接")
   .action(async () => {
+    const cwd = process.cwd();
     const sourceDir = path.resolve(import.meta.dir, "..");
-    const targetDir = path.resolve(process.cwd(), "jax");
+    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"));
+    const targetRoot = shouldUseNodeModules
+      ? path.join(cwd, "node_modules")
+      : cwd;
+    const targetName = shouldUseNodeModules ? "jax-hono" : "jax";
+    const targetDir = path.resolve(targetRoot, targetName);
+
+    if (shouldUseNodeModules) {
+      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,10 +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 srcDir = join(import.meta.dir, '../..')
+const srcDir = join(cwd(), 'src')
 const configDir = join(srcDir, 'config')
 const typesFile = join(srcDir, 'types/index.ts')
-const generatedDir = join(srcDir, 'jax/generated')
 const outputFile = join(generatedDir, 'config.ts')
 const envStages = new Set([
   'default',
@@ -35,9 +36,9 @@ function getStage(fileName: string) {
 
 function getImportPath(fileName: string) {
   const { dir, name } = parse(fileName)
-  const path = join('../../config', dir, name).replaceAll('\\', '/')
+  const path = join(configDir, dir, name).replaceAll('\\', '/')
 
-  return path.startsWith('.') ? path : `./${path}`
+  return path
 }
 
 function getConfigFiles() {
@@ -83,7 +84,7 @@ export function generateConfig() {
     return `  { name: '${fileName}', stage: '${getStage(fileName)}', config: ${toImportName(fileName, index)} },`
   })
   const hasProjectTypes = hasProjectConfigType()
-  const typeImports = hasProjectTypes ? [`import type { ProjectConfig } from '../../types'`] : []
+  const typeImports = hasProjectTypes ? [`import type { ProjectConfig } from '${join(srcDir, 'types').replaceAll('\\', '/')}'`] : []
   const projectConfigType = hasProjectTypes
     ? 'export type { ProjectConfig }'
     : defaultConfigIndex === -1
@@ -100,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,11 @@
-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 srcDir = join(import.meta.dir, '../..')
-const generatedDir = join(srcDir, 'jax/generated')
+const srcDir = join(cwd(), 'src')
 const moduleExtensions = new Set(['.ts', '.js', '.mjs', '.cjs'])
-const generatedHeader = `// This file is generated by src/jax/build/generate-registry.ts.
+const generatedHeader = `// This file is generated by jax-hono/build/generate-registry.ts.
 // Do not edit it directly.
 `
 
@@ -64,22 +65,22 @@ 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) {
-  const path = relative(srcDir, filePath)
+  const path = filePath
     .replace(parse(filePath).ext, '')
     .replaceAll('\\', '/')
 
-  return `@/${path}`
+  return path
 }
 
 function toIdentifier(parts: string[]) {
@@ -277,7 +278,7 @@ function generateControllersRegistry() {
   }
 
   const helperImport = imports.length > 0
-    ? `import { createController } from '@/jax/core/controller'\n`
+    ? `import { createController } from 'jax-hono/core/controller'\n`
     : ''
   const content = `${generatedHeader}
 ${helperImport}${imports.join('\n')}
@@ -531,15 +532,11 @@ function normalizePluginPackage(packageName: string, configFile: string) {
     return packageName
   }
 
-  const normalized = relative(srcDir, join(configFile, '..', packageName))
+  const normalized = join(configFile, '..', packageName)
     .replaceAll('\\', '/')
     .replace(/\/index$/, '')
 
-  if (normalized.startsWith('jax/')) {
-    return normalized
-  }
-
-  return `@/${normalized}`
+  return normalized
 }
 
 function mergePluginConfig(configs: { filePath: string; config: PluginConfig }[]) {
@@ -578,7 +575,6 @@ function serializePluginOptions(options: unknown) {
 
 function generatePluginContextRegistry() {
   const enabledPlugins = mergePluginConfig([
-    { filePath: join(srcDir, 'jax/plugins/config.ts'), config: readPluginConfig(join(srcDir, 'jax/plugins/config.ts')) },
     { filePath: join(srcDir, 'config/plugin.ts'), config: readPluginConfig(join(srcDir, 'config/plugin.ts')) },
   ])
   const imports = enabledPlugins.map(([name, item]) => {

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.0",
+  "version": "1.0.2",
   "description": "Lightweight framework layer on top of Hono, built for Bun",
   "type": "module",
   "main": "./index.ts",
@@ -10,10 +10,57 @@
       "import": "./index.ts",
       "types": "./index.ts"
     },
-    "./*": "./*"
+    "./setup": {
+      "import": "./setup.ts",
+      "types": "./setup.ts"
+    },
+    "./config": {
+      "import": "./config.ts",
+      "types": "./config.ts"
+    },
+    "./core/*": {
+      "import": "./core/*.ts",
+      "types": "./core/*.ts"
+    },
+    "./helpers": {
+      "import": "./helpers/index.ts",
+      "types": "./helpers/index.ts"
+    },
+    "./helpers/*": {
+      "import": "./helpers/*.ts",
+      "types": "./helpers/*.ts"
+    },
+    "./middleware/*": {
+      "import": "./middleware/*.ts",
+      "types": "./middleware/*.ts"
+    },
+    "./plugins/*": {
+      "import": "./plugins/*/index.ts",
+      "types": "./plugins/*/index.ts"
+    },
+    "./plugins/*/*": {
+      "import": "./plugins/*/*.ts",
+      "types": "./plugins/*/*.ts"
+    },
+    "./utils": {
+      "import": "./utils/index.ts",
+      "types": "./utils/index.ts"
+    },
+    "./utils/*": {
+      "import": "./utils/*.ts",
+      "types": "./utils/*.ts"
+    },
+    "./types": {
+      "import": "./types/index.ts",
+      "types": "./types/index.ts"
+    },
+    "./types/*": {
+      "import": "./types/*.ts",
+      "types": "./types/*.ts"
+    }
   },
   "bin": {
-    "jax": "./bin/jax.ts"
+    "jax": "./bin/jax.js"
   },
   "files": [
     "index.ts",
@@ -40,12 +87,21 @@
   },
   "peerDependencies": {
     "dayjs": "*",
-    "deepmerge": "*",
-    "dotenv": "*",
+    "deepmerge": "^4.3.1",
+    "dotenv": "^17.4.2",
     "jsonwebtoken": "*",
-    "minimist": "*",
+    "minimist": "^1.2.8",
     "mongoose": "*"
   },
+  "devDependencies": {
+    "@types/bun": "^1.3.14",
+    "dayjs": "^1.11.21",
+    "deepmerge": "^4.3.1",
+    "dotenv": "^17.4.2",
+    "jsonwebtoken": "^9.0.3",
+    "minimist": "^1.2.8",
+    "mongoose": "^8.24.1"
+  },
   "peerDependenciesMeta": {
     "dayjs": {
       "optional": true
@@ -61,4 +117,4 @@
     "bun": ">=1.0.0"
   },
   "license": "MIT"
-}
+}

package/plugins/mongoose/model.ts

@@ -1,14 +1,14 @@
-import { basename, parse } from 'node:path';
+import { basename, parse } from "node:path";
 import mongoose, {
   Schema,
   model as mongooseModel,
   type InferSchemaType,
   type Model,
-  type SchemaOptions
-} from 'mongoose';
-import config from '@/jax/config';
-import { rankSetter } from './schema';
-import dayjs from 'dayjs';
+  type SchemaOptions,
+} from "mongoose";
+import config from "../../config";
+import { rankSetter } from "./schema";
+import dayjs from "dayjs";
 
 export { rankSetter };
 
@@ -21,7 +21,7 @@ type PageOptions = {
 export type ModelStatics = {
   findPage(
     filter?: Record<string, unknown>,
-    options?: PageOptions
+    options?: PageOptions,
   ): Promise<{
     total: number;
     list: unknown[];
@@ -48,14 +48,15 @@ export function createLooseModel(filePathOrName: string, collection?: string) {
   installModelStatics(schema);
 
   return (
-    mongoose.models[name] ?? mongooseModel(name, schema, collection ?? getCollectionName(name))
+    mongoose.models[name] ??
+    mongooseModel(name, schema, collection ?? getCollectionName(name))
   );
 }
 
 export function createSchemaModel<TSchema extends Schema>(
   filePathOrName: string,
   schema: TSchema,
-  collection?: string
+  collection?: string,
 ): Model<InferSchemaType<TSchema>> & ModelStatics {
   const name = getModelName(filePathOrName);
 
@@ -67,7 +68,7 @@ export function createSchemaModel<TSchema extends Schema>(
     mongooseModel<InferSchemaType<TSchema>>(
       name,
       schema as any,
-      collection ?? getCollectionName(name)
+      collection ?? getCollectionName(name),
     )) as Model<InferSchemaType<TSchema>> & ModelStatics;
 }
 
@@ -75,15 +76,16 @@ export const createModel = createSchemaModel;
 
 export function getModelName(filePathOrName: string) {
   const baseName =
-    filePathOrName.includes('/') || filePathOrName.includes('\\')
-      ? parse(basename(filePathOrName)).name.replace(/\.model$/, '')
+    filePathOrName.includes("/") || filePathOrName.includes("\\")
+      ? parse(basename(filePathOrName)).name.replace(/\.model$/, "")
       : filePathOrName;
 
   return toPascalCase(baseName);
 }
 
 export function getCollectionName(modelName: string) {
-  const prefix = (config as any).mongoose?.prefix ?? (config as any).mongo?.prefix ?? '';
+  const prefix =
+    (config as any).mongoose?.prefix ?? (config as any).mongo?.prefix ?? "";
   const name = toSnakeCase(modelName);
 
   return prefix ? `${prefix}_${name}` : name;
@@ -102,23 +104,23 @@ export function schemaOptions(): SchemaOptions {
         // }
 
         if (ret.createdAt) {
-          ret.createdAt = dayjs(ret.createdAt).format('YYYY-MM-DD HH:mm:ss');
+          ret.createdAt = dayjs(ret.createdAt).format("YYYY-MM-DD HH:mm:ss");
         }
 
         if (ret.updatedAt) {
-          ret.updatedAt = dayjs(ret.updatedAt).format('YYYY-MM-DD HH:mm:ss');
+          ret.updatedAt = dayjs(ret.updatedAt).format("YYYY-MM-DD HH:mm:ss");
         }
 
         delete ret.__v;
         delete ret._id;
 
         return ret;
-      }
+      },
     },
     toObject: {
       virtuals: true,
-      getters: true
-    }
+      getters: true,
+    },
   };
 }
 
@@ -126,37 +128,40 @@ export function applyDefaultSchemaOptions(schema: Schema) {
   const defaults = schemaOptions();
 
   if (schema.options.timestamps === undefined) {
-    schema.set('timestamps', defaults.timestamps);
+    schema.set("timestamps", defaults.timestamps);
   }
 
-  if (schema.options.versionKey === undefined || schema.options.versionKey === '__v') {
-    schema.set('versionKey', defaults.versionKey);
+  if (
+    schema.options.versionKey === undefined ||
+    schema.options.versionKey === "__v"
+  ) {
+    schema.set("versionKey", defaults.versionKey);
   }
 
   const toJSON = {
     ...defaults.toJSON,
-    ...(schema.options.toJSON ?? {})
+    ...(schema.options.toJSON ?? {}),
   } as any;
 
-  schema.set('toJSON', toJSON);
-  schema.set('toObject', {
+  schema.set("toJSON", toJSON);
+  schema.set("toObject", {
     ...defaults.toObject,
-    ...(schema.options.toObject ?? {})
+    ...(schema.options.toObject ?? {}),
   } as any);
 }
 
 export function installRankHooks(schema: Schema) {
-  schema.pre(['updateOne', 'findOneAndUpdate', 'updateMany'], function () {
+  schema.pre(["updateOne", "findOneAndUpdate", "updateMany"], function () {
     normalizeRank(this.getUpdate());
   });
 
-  schema.pre('save', function () {
+  schema.pre("save", function () {
     normalizeRank(this);
   });
 }
 
 export function installAutoNo(schema: Schema, field: string, start = 0) {
-  schema.pre('save', async function () {
+  schema.pre("save", async function () {
     if (!this.isNew || this.get(field)) {
       return;
     }
@@ -169,29 +174,32 @@ export function installAutoNo(schema: Schema, field: string, start = 0) {
 }
 
 export function installModelStatics(schema: Schema) {
-  schema.static('findPage', async function findPage(filter = {}, options: PageOptions = {}) {
-    const page = Number(options.page || 1);
-    const pageSize = Number(options.pageSize || 20);
-    const sort = (options.sort ?? { _id: -1 }) as any;
-    const total = await this.countDocuments(filter);
-    let query = this.find(filter).sort(sort);
-
-    if (pageSize !== -1) {
-      query = query.skip((page - 1) * pageSize).limit(pageSize);
-    }
+  schema.static(
+    "findPage",
+    async function findPage(filter = {}, options: PageOptions = {}) {
+      const page = Number(options.page || 1);
+      const pageSize = Number(options.pageSize || 20);
+      const sort = (options.sort ?? { _id: -1 }) as any;
+      const total = await this.countDocuments(filter);
+      let query = this.find(filter).sort(sort);
+
+      if (pageSize !== -1) {
+        query = query.skip((page - 1) * pageSize).limit(pageSize);
+      }
 
-    const list = await query;
+      const list = await query;
 
-    return {
-      total,
-      list,
-      maxPage: pageSize === -1 ? 1 : Math.ceil(total / pageSize),
-      page,
-      pageSize
-    };
-  });
+      return {
+        total,
+        list,
+        maxPage: pageSize === -1 ? 1 : Math.ceil(total / pageSize),
+        page,
+        pageSize,
+      };
+    },
+  );
 
-  schema.static('tree', async function tree(options: any = {}) {
+  schema.static("tree", async function tree(options: any = {}) {
     const docs = await this.find(options.filter ?? {})
       .sort(options.sort ?? {})
       .lean({ virtuals: true });
@@ -204,7 +212,7 @@ export function installModelStatics(schema: Schema) {
     }
 
     for (const item of byId.values()) {
-      const parentId = item.parentId ? String(item.parentId) : '';
+      const parentId = item.parentId ? String(item.parentId) : "";
       const parent = parentId ? byId.get(parentId) : undefined;
 
       if (parent) {
@@ -217,24 +225,27 @@ export function installModelStatics(schema: Schema) {
     return tree;
   });
 
-  schema.static('flatTree', async function flatTree(this: any, options: any = {}) {
-    const tree = await this.tree(options);
-    const list: any[] = [];
+  schema.static(
+    "flatTree",
+    async function flatTree(this: any, options: any = {}) {
+      const tree = await this.tree(options);
+      const list: any[] = [];
 
-    walkTree(tree, 1, list);
+      walkTree(tree, 1, list);
 
-    return list;
-  });
+      return list;
+    },
+  );
 }
 
 export function installCommonFields(schema: Schema) {
   const fields: Record<string, unknown> = {};
 
-  if (!schema.path('isDelete')) {
+  if (!schema.path("isDelete")) {
     fields.isDelete = { type: Boolean, default: false };
   }
 
-  if (!schema.path('isOpen')) {
+  if (!schema.path("isOpen")) {
     fields.isOpen = { type: Boolean, default: false };
   }
 
@@ -245,14 +256,14 @@ export function installCommonFields(schema: Schema) {
 
 export function toSnakeCase(value: string) {
   return value
-    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
-    .replace(/[-\s]+/g, '_')
+    .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+    .replace(/[-\s]+/g, "_")
     .toLowerCase();
 }
 
 function toPascalCase(value: string) {
   const camel = value.replace(/[-_\s]+([a-zA-Z0-9])/g, (_match, char: string) =>
-    char.toUpperCase()
+    char.toUpperCase(),
   );
 
   return camel.charAt(0).toUpperCase() + camel.slice(1);