@mindbase/express-common 1.0.0 → 1.0.1

package/utils/Logger.ts

@@ -1,206 +0,0 @@
-import dayjs from "./Dayjs";
-
-export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
-
-const LOG_LEVELS = {
-  debug: 0,
-  info: 1,
-  warn: 2,
-  error: 3,
-  silent: 4,
-} as const;
-
-let currentLogLevel: LogLevel = "info";
-
-const COLORS = {
-  debug: "\x1b[36m",
-  info: "\x1b[32m",
-  warn: "\x1b[33m",
-  error: "\x1b[31m",
-  reset: "\x1b[0m",
-} as const;
-
-/**
- * 计算字符串在终端中的视觉宽度
- * 修复：区分单宽符号 (如 ✓) 和双宽符号 (如 中文、Emoji)
- */
-function getVisualWidth(str: string): number {
-  let width = 0;
-  const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
-  for (const { segment } of segmenter.segment(str)) {
-    const charCode = segment.charCodeAt(0);
-
-    // 1. 基础 ASCII
-    if (charCode <= 255) {
-      width += 1;
-      continue;
-    }
-
-    // 2. CJK 字符集范围 (常用中文、标点、全角符号)
-    const isCJK =
-      (charCode >= 0x4e00 && charCode <= 0x9fff) || // CJK Unified Ideographs
-      (charCode >= 0x3000 && charCode <= 0x303f) || // CJK Symbols and Punctuation
-      (charCode >= 0xff00 && charCode <= 0xffef); // Fullwidth Forms
-
-    // 3. Emoji 或代理对 (通常 segment.length > 1)
-    const isMultiByte = segment.length > 1;
-
-    if (isCJK || isMultiByte) {
-      width += 2;
-    } else {
-      // 4. 其他特殊符号 (如 ✓, ★, ☎) 在大多数终端占 1 格
-      width += 1;
-    }
-  }
-  return width;
-}
-
-/**
- * 截断字符串以适应视觉宽度，从头部截断并保留末尾
- */
-function truncateToWidth(str: string, maxWidth: number): string {
-  const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
-  const segments = Array.from(segmenter.segment(str)).map((s) => s.segment);
-
-  if (getVisualWidth(str) <= maxWidth) return str;
-
-  let currentWidth = 3; // 为 "..." 预留
-  let result = "";
-
-  // 从后往前遍历 segments
-  for (let i = segments.length - 1; i >= 0; i--) {
-    const segment = segments[i];
-    const segmentWidth = getVisualWidth(segment);
-    if (currentWidth + segmentWidth > maxWidth) break;
-    result = segment + result;
-    currentWidth += segmentWidth;
-  }
-  return "..." + result;
-}
-
-function formatMessage(level: LogLevel, message: string): string {
-  const timestamp = dayjs().format("YYYY-MM-DD HH:mm:ss");
-  const terminalWidth = process.stdout.columns || 80;
-  const timeStr = ` ${timestamp}`;
-  const timeWidth = getVisualWidth(timeStr);
-  const maxMessageWidth = terminalWidth - timeWidth - 2;
-
-  let displayMessage = message;
-  const messageWidth = getVisualWidth(displayMessage);
-
-  if (messageWidth > maxMessageWidth) {
-    displayMessage = truncateToWidth(displayMessage, maxMessageWidth);
-  }
-
-  const currentMsgWidth = getVisualWidth(displayMessage);
-  const paddingCount = Math.max(0, terminalWidth - currentMsgWidth - timeWidth);
-  const padding = " ".repeat(paddingCount);
-
-  return `${COLORS[level]}${displayMessage}${padding}${timeStr}${COLORS.reset}`;
-}
-
-const startupTime = Date.now();
-
-// 标签填充函数（目标显示宽度 8，空格分散到字符间）
-function padTag(tag: string, targetWidth = 8): string {
-  const currentWidth = getVisualWidth(tag);
-  const padding = Math.max(0, targetWidth - currentWidth);
-
-  if (padding === 0) return tag;
-
-  // 将空格均匀分散到字符之间
-  const chars = [...tag]; // 按码点分割
-  const gapCount = chars.length + 1; // 间隙数 = 字符数 + 1（前后和中间）
-
-  // 计算每个间隙的空格数
-  const baseSpaces = Math.floor(padding / gapCount);
-  const extraSpaces = padding % gapCount;
-
-  let result = "";
-  for (let i = 0; i < chars.length; i++) {
-    // 每个间隙的空格 = 基础空格 + 额外空格（前 extraSpaces 个间隙多1个）
-    const spaces = baseSpaces + (i < extraSpaces ? 1 : 0);
-    result += " ".repeat(spaces) + chars[i];
-  }
-  // 最后一个间隙
-  result += " ".repeat(baseSpaces + (chars.length < extraSpaces ? 1 : 0));
-
-  return result;
-}
-
-function startupMessage(message: string, tag?: string): string {
-  const diff = Date.now() - startupTime;
-  const timeStr = diff.toString().padStart(6, "0");
-  const tagStr = tag ? `【${padTag(tag)}】` : "";
-  return `${COLORS["warn"]}[${timeStr}] ${tagStr}${message}${COLORS["reset"]}`;
-}
-
-function shouldLog(level: LogLevel): boolean {
-  return LOG_LEVELS[level] >= LOG_LEVELS[currentLogLevel];
-}
-
-function formatArgs(args: any[]): string {
-  return args
-    .map((arg) => {
-      if (arg instanceof Error) {
-        return arg.message;
-      }
-      if (typeof arg === "object") {
-        return JSON.stringify(arg, null, 2);
-      }
-      return String(arg);
-    })
-    .join(" ");
-}
-
-export const logger = {
-  debug(...args: any[]): void {
-    if (shouldLog("debug")) {
-      console.log(formatMessage("debug", formatArgs(args)));
-    }
-  },
-
-  info(...args: any[]): void {
-    if (shouldLog("info")) {
-      console.log(formatMessage("info", formatArgs(args)));
-    }
-  },
-
-  warn(...args: any[]): void {
-    if (shouldLog("warn")) {
-      console.warn(formatMessage("warn", formatArgs(args)));
-    }
-  },
-
-  error(...args: any[]): void {
-    if (shouldLog("error")) {
-      // 先打印带颜色的格式化消息
-      console.error(formatMessage("error", formatArgs(args)));
-      // 如果有 Error 对象，用 console.error 单独打印以显示堆栈
-      const errorArg = args.find((arg) => arg instanceof Error);
-      if (errorArg) {
-        console.error(errorArg);
-      }
-    }
-  },
-
-  startup(tagOrMessage: string, ...args: any[]): void {
-    // 如果有额外参数，第一个是标签，其余是消息
-    // 否则第一个参数是消息，无标签
-    if (args.length > 0) {
-      console.log(startupMessage(formatArgs(args), tagOrMessage));
-    } else {
-      console.log(startupMessage(tagOrMessage));
-    }
-  },
-
-  setLevel(level: LogLevel): void {
-    currentLogLevel = level;
-  },
-
-  getLevel(): LogLevel {
-    return currentLogLevel;
-  },
-};
-
-export default logger;

package/utils/MiddlewareRegistry.ts

@@ -1,14 +0,0 @@
-import { Express } from "express";
-import { ScanResult } from "../types/Index";
-import logger from "./Logger";
-
-export async function registerMiddleware(app: Express, config: ScanResult): Promise<void> {
-  const { fileName = "anonymous", defaultExport: handler } = config;
-
-  try {
-    app.use(handler);
-    logger.startup("中间件", `注册: ${fileName}`);
-  } catch (error) {
-    logger.error(`注册中间件失败 ${fileName}:`, error);
-  }
-}

package/utils/ProjectInitializer.ts

@@ -1,283 +0,0 @@
-import fs from "fs";
-import path from "path";
-import prompts from "prompts";
-import logger from "./Logger";
-
-export interface ProjectConfig {
-  name: string;
-  description: string;
-  author: string;
-  port: number;
-  dbPath: string;
-  staticPath: string;
-  apiPrefix: string;
-  userAgent: boolean;
-  ip: boolean;
-  cors: boolean;
-}
-
-/**
- * 收集项目初始化配置
- */
-export async function collectConfig(cwd: string): Promise<ProjectConfig> {
-  const folderName = path.basename(cwd);
-
-  const response = await prompts([
-    {
-      type: "text",
-      name: "name",
-      message: "项目名称",
-      initial: folderName,
-      validate: (value: string) => value.length > 0 || "项目名称不能为空",
-    },
-    {
-      type: "text",
-      name: "description",
-      message: "项目描述",
-      initial: "MindBase 驱动的应用项目",
-    },
-    {
-      type: "text",
-      name: "author",
-      message: "作者",
-      initial: "",
-    },
-    {
-      type: "number",
-      name: "port",
-      message: "服务端口",
-      initial: 3000,
-      validate: (value: number) => (value >= 1 && value <= 65535 ? true : "端口号必须在 1-65535 之间"),
-    },
-    {
-      type: "text",
-      name: "dbPath",
-      message: "数据库路径 (建议: ./data/app.db)",
-      initial: "./data/app.db",
-    },
-    {
-      type: "text",
-      name: "staticPath",
-      message: "静态目录路径 (留空则不创建，例如: public)",
-    },
-    {
-      type: "text",
-      name: "apiPrefix",
-      message: "API 前缀 (留空则无前缀，例如: /api)",
-    },
-    {
-      type: "confirm",
-      name: "userAgent",
-      message: "启用 User-Agent 解析中间件?",
-      initial: true,
-    },
-    {
-      type: "confirm",
-      name: "ip",
-      message: "启用 IP 解析中间件?",
-      initial: true,
-    },
-    {
-      type: "confirm",
-      name: "cors",
-      message: "启用 CORS 跨域中间件?",
-      initial: true,
-    },
-  ]);
-
-  if (Object.keys(response).length < 10) {
-    throw new Error("用户取消了初始化流程");
-  }
-
-  return response as ProjectConfig;
-}
-
-/**
- * 初始化 package.json
- */
-export function setupPackageJson(cwd: string, config: ProjectConfig) {
-  const pkgPath = path.join(cwd, "package.json");
-  let pkg: any = {};
-
-  if (fs.existsSync(pkgPath)) {
-    pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-    logger.info("✓ 检测到已存在的 package.json，正在更新配置...");
-  } else {
-    pkg = {
-      name: config.name,
-      version: "1.0.0",
-      description: config.description,
-      author: config.author,
-      main: "dist/index.js",
-      scripts: {},
-      dependencies: {
-        "@mindbase/express-common": "*",
-        express: "^5.2.1",
-        "cross-env": "^7.0.3",
-      },
-      devDependencies: {
-        "@types/express": "^5.0.6",
-        "@types/node": "^20.0.0",
-        "ts-node": "^10.9.0",
-        "ts-node-dev": "^2.0.0",
-        typescript: "^5.1.3",
-        "tsconfig-paths": "^4.2.0",
-        "drizzle-kit": "^0.31.7",
-      },
-    };
-    logger.info("✓ 正在生成 package.json...");
-  }
-
-  // 注入标准脚本
-  pkg.scripts = pkg.scripts || {};
-  pkg.scripts["dev"] = "ts-node-dev --transpile-only --require tsconfig-paths/register ./src/app.ts";
-  pkg.scripts["start"] = "ts-node --transpile-only --require tsconfig-paths/register ./src/app.ts";
-  pkg.scripts["db:migrate"] = "cross-env MIND_BASE_MODE=migrate ts-node --transpile-only --require tsconfig-paths/register ./src/app.ts";
-  pkg.scripts["db:sync"] = "cross-env MIND_BASE_MODE=sync ts-node --transpile-only --require tsconfig-paths/register ./src/app.ts";
-  pkg.scripts["db:generate"] = "npm run db:sync && drizzle-kit generate";
-  pkg.scripts["db:push"] = "drizzle-kit push";
-
-  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
-  logger.info("✓ package.json 已就绪");
-}
-
-/**
- * 初始化应用配置 src/config/index.ts
- */
-export function setupAppConfig(cwd: string, config: ProjectConfig) {
-  const configDir = path.join(cwd, "src/config");
-  const configFilePath = path.join(configDir, "index.ts");
-  const configContent = `import { MindBaseAppOptions } from "@mindbase/express-common";
-
-const config: MindBaseAppOptions = {
-  port: ${config.port},
-  logging: true,
-  autoMigrate: true,
-  database: {
-    path: "${config.dbPath}",
-  },
-  staticPath: ${config.staticPath ? `"${config.staticPath}"` : "undefined"},
-  apiPrefix: ${config.apiPrefix ? `"${config.apiPrefix}"` : "undefined"},
-  userAgent: ${config.userAgent},
-  ip: ${config.ip},
-  cors: ${config.cors},
-};
-
-export default config;
-`;
-  if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true });
-  fs.writeFileSync(configFilePath, configContent);
-  logger.info("✓ src/config/index.ts 已就绪");
-
-  // 同步创建静态目录
-  if (config.staticPath) {
-    const staticDir = path.join(cwd, config.staticPath);
-    if (!fs.existsSync(staticDir)) {
-      fs.mkdirSync(staticDir, { recursive: true });
-      logger.info(`✓ 静态目录已创建: ${config.staticPath}`);
-    }
-  }
-}
-
-/**
- * 初始化 Drizzle 配置 drizzle.config.ts
- */
-export function setupDrizzleConfig(cwd: string, config: ProjectConfig) {
-  const drizzleConfigPath = path.join(cwd, "drizzle.config.ts");
-  const drizzleConfigContent = `import { defineConfig } from "drizzle-kit";
-import fs from "fs";
-
-// 动态读取由 db:sync 脚本生成的 schema 路径清单
-const schemaJson = "./.drizzle-schemas.json";
-const schemas = fs.existsSync(schemaJson) 
-  ? JSON.parse(fs.readFileSync(schemaJson, "utf-8")) 
-  : ["./src/**/*.schema.ts"];
-
-export default defineConfig({
-  schema: schemas,
-  out: "./drizzle",
-  dialect: "sqlite",
-  dbCredentials: {
-    url: "${config.dbPath}",
-  },
-});
-`;
-  fs.writeFileSync(drizzleConfigPath, drizzleConfigContent);
-  logger.info("✓ drizzle.config.ts 已就绪");
-}
-
-/**
- * 初始化 TypeScript 配置 tsconfig.json
- */
-export function setupTsConfig(cwd: string) {
-  const tsconfigPath = path.join(cwd, "tsconfig.json");
-  if (!fs.existsSync(tsconfigPath)) {
-    const tsconfigContent = {
-      compilerOptions: {
-        target: "ESNext",
-        module: "CommonJS",
-        moduleResolution: "node",
-        baseUrl: ".",
-        paths: {
-          "#/*": ["src/*"],
-        },
-        strict: true,
-        esModuleInterop: true,
-        skipLibCheck: true,
-        forceConsistentCasingInFileNames: true,
-        experimentalDecorators: true,
-        emitDecoratorMetadata: true,
-        outDir: "dist",
-      },
-      include: ["src/**/*"],
-      exclude: ["node_modules"],
-    };
-    fs.writeFileSync(tsconfigPath, JSON.stringify(tsconfigContent, null, 2));
-    logger.info("✓ tsconfig.json 已就绪");
-  }
-}
-
-/**
- * 初始化应用入口 src/app.ts
- */
-export function setupAppEntry(cwd: string) {
-  const appPath = path.join(cwd, "src/app.ts");
-  if (!fs.existsSync(appPath)) {
-    const appContent = `import { createApp } from "@mindbase/express-common";
-import config from "./config";
-
-async function bootstrap() {
-  const app = await createApp(config);
-  
-  // 在此处使用插件或中间件
-  // app.use(...);
-
-  await app.startup();
-}
-
-bootstrap();
-`;
-    if (!fs.existsSync(path.join(cwd, "src"))) fs.mkdirSync(path.join(cwd, "src"));
-    fs.writeFileSync(appPath, appContent);
-    logger.info("✓ src/app.ts 已就绪");
-  }
-}
-
-/**
- * 拷贝静态资源
- */
-export function copyAssets(cwd: string) {
-  const ipdbPath = path.join(cwd, "ipipfree.ipdb");
-  const sourceIpdb = path.join(__dirname, "..", "ipipfree.ipdb");
-
-  if (fs.existsSync(sourceIpdb)) {
-    if (!fs.existsSync(ipdbPath)) {
-      fs.copyFileSync(sourceIpdb, ipdbPath);
-      logger.info("✓ ipipfree.ipdb 已就绪");
-    } else {
-      logger.info("- ipipfree.ipdb 已存在，跳过拷贝");
-    }
-  } else {
-    logger.warn(`! 未能找到 ipipfree.ipdb 源文件: ${sourceIpdb}`);
-  }
-}