befly 3.2.1 → 3.3.1

package/types/index.ts

@@ -1,438 +0,0 @@
-/**
- * Befly 核心类型定义
- * 统一导出所有类型，简化导入路径
- *
- * @example
- * ```typescript
- * import type { ApiRoute, BeflyContext, Plugin } from 'befly/types';
- * ```
- */
-
-// 基础类型
-export * from './common.js';
-export * from './context.js';
-
-// 核心功能类型
-export * from './api.js';
-export * from './befly.js';
-export * from './plugin.js';
-export * from './addon.js';
-
-// 功能模块类型
-export * from './database.js';
-export * from './crypto.js';
-export * from './jwt.js';
-export * from './validator.js';
-export * from './redis.js';
-export * from './logger.js';
-
-/**
- * API 请求上下文
- */
-export interface RequestContext {
-    /** 原始请求对象 */
-    req: Request;
-    /** 解析后的 URL */
-    url: URL;
-    /** 路径名 */
-    pathname: string;
-    /** 查询参数 */
-    query: URLSearchParams;
-    /** 请求体数据 */
-    body: any;
-    /** 请求头 */
-    headers: Headers;
-    /** 路由参数 */
-    params?: Record<string, string>;
-    /** JWT 载荷（认证后） */
-    jwt?: JwtPayload;
-}
-
-/**
- * API 响应格式
- */
-export interface ApiResponse<T = any> {
-    /** 状态码：0=成功，1=失败 */
-    code: 0 | 1;
-    /** 提示信息 */
-    msg: string;
-    /** 响应数据 */
-    data: T;
-}
-
-/**
- * API 处理函数
- */
-export type ApiHandler = (befly: BeflyContext, ctx: RequestContext, req: Request) => Promise<ApiResponse>;
-
-/**
- * API 路由定义
- */
-export interface ApiRoute {
-    /** HTTP 方法 */
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS';
-    /** 接口名称 */
-    name: string;
-    /** 认证要求: false=公开，true=需登录 */
-    auth: boolean;
-    /** 字段规则定义 */
-    fields: Record<string, string>;
-    /** 必填字段列表 */
-    required: string[];
-    /** 处理函数 */
-    handler: ApiHandler;
-}
-
-/**
- * JWT 载荷
- */
-export interface JwtPayload {
-    /** 用户 ID */
-    userId?: string;
-    /** 用户名 */
-    username?: string;
-    /** 角色 */
-    role?: string;
-    /** 权限列表 */
-    permissions?: string[];
-    /** 签发时间 */
-    iat?: number;
-    /** 过期时间 */
-    exp?: number;
-    /** 主题 */
-    sub?: string;
-    /** 签发者 */
-    iss?: string;
-    /** 受众 */
-    aud?: string;
-    /** JWT ID */
-    jti?: string;
-    /** 生效时间 */
-    nbf?: number;
-    /** 其他自定义字段 */
-    [key: string]: any;
-}
-
-/**
- * JWT 签名选项
- */
-export interface JwtSignOptions {
-    /** 密钥 */
-    secret?: string;
-    /** 算法 */
-    algorithm?: string;
-    /** 过期时间 */
-    expiresIn?: string;
-    /** 签发者 */
-    issuer?: string;
-    /** 受众 */
-    audience?: string;
-    /** 主题 */
-    subject?: string;
-    /** 生效时间 */
-    notBefore?: string | number;
-    /** JWT ID */
-    jwtId?: string;
-}
-
-/**
- * Befly 上下文接口
- */
-export interface BeflyContext {
-    /** 数据库管理器 */
-    db: DbHelper;
-    /** Redis 助手 */
-    redis: typeof RedisHelper;
-}
-
-/**
- * 插件定义
- */
-export interface Plugin {
-    /** 插件名称 */
-    name?: string;
-    /** 依赖的插件列表 */
-    after?: string[];
-    /** 初始化函数 */
-    onInit?: (befly: BeflyContext) => Promise<any>;
-}
-
-/**
- * 服务器配置
- */
-export interface ServerConfig {
-    /** 服务名称 */
-    name: string;
-    /** 端口号 */
-    port: number;
-    /** 主机 */
-    host?: string;
-    /** 静态文件目录 */
-    static?: string;
-    /** 自定义插件 */
-    plugins?: Plugin[];
-}
-
-/**
- * SQL 查询操作符
- */
-export interface WhereOperator {
-    /** 大于 */
-    $gt?: number;
-    /** 大于等于 */
-    $gte?: number;
-    /** 小于 */
-    $lt?: number;
-    /** 小于等于 */
-    $lte?: number;
-    /** 不等于 */
-    $ne?: any;
-    /** 不等于（$ne 的别名） */
-    $not?: any;
-    /** 在...之中 */
-    $in?: any[];
-    /** 不在...之中 */
-    $nin?: any[];
-    /** 不在...之中（$nin 的别名） */
-    $notIn?: any[];
-    /** LIKE 模糊匹配 */
-    $like?: string;
-    /** NOT LIKE 模糊匹配 */
-    $notLike?: string;
-    /** BETWEEN...AND 范围查询 */
-    $between?: [any, any];
-    /** NOT BETWEEN...AND 范围查询 */
-    $notBetween?: [any, any];
-    /** IS NULL 空值检查 */
-    $null?: boolean;
-    /** IS NOT NULL 非空检查 */
-    $notNull?: boolean;
-}
-
-/**
- * WHERE 条件
- * 支持两种格式：
- * 1. 嵌套格式：{ age: { $gt: 18 } }
- * 2. 一级属性格式：{ 'age$gt': 18 }（推荐）
- */
-export type WhereConditions = {
-    /** 普通字段条件（支持一级属性格式：'field$operator'） */
-    [field: string]:
-        | string
-        | number
-        | boolean
-        | null
-        | any[] // 支持 $in、$nin 的数组值
-        | WhereOperator // 支持嵌套格式
-        | WhereConditions[]; // 支持 $or、$and 的数组值
-
-    /** OR 逻辑操作符 */
-    $or?: WhereConditions[];
-
-    /** AND 逻辑操作符 */
-    $and?: WhereConditions[];
-};
-
-/**
- * SQL 查询选项
- */
-export interface QueryOptions {
-    /** 表名 */
-    table: string;
-    /** 查询字段，默认 ['*'] */
-    fields?: string[];
-    /** WHERE 条件 */
-    where?: WhereConditions;
-    /** 排序（格式：["字段#ASC", "字段#DESC"]） */
-    orderBy?: string[];
-    /** 页码（从 1 开始） */
-    page?: number;
-    /** 每页数量 */
-    limit?: number;
-}
-
-/**
- * 插入选项
- */
-export interface InsertOptions {
-    /** 表名 */
-    table: string;
-    /** 插入数据（ID、时间戳、state 会自动生成） */
-    data: Record<string, any>;
-}
-
-/**
- * 更新选项
- */
-export interface UpdateOptions {
-    /** 表名 */
-    table: string;
-    /** 更新数据（updated_at 会自动更新） */
-    data: Record<string, any>;
-    /** WHERE 条件 */
-    where: WhereConditions;
-}
-
-/**
- * 删除选项
- */
-export interface DeleteOptions {
-    /** 表名 */
-    table: string;
-    /** WHERE 条件 */
-    where: WhereConditions;
-}
-
-/**
- * 列表查询结果
- */
-export interface ListResult<T = any> {
-    /** 数据列表 */
-    list: T[];
-    /** 总条数 */
-    total: number;
-    /** 当前页码 */
-    page: number;
-    /** 每页数量 */
-    limit: number;
-    /** 总页数 */
-    pages: number;
-}
-
-/**
- * 事务回调函数
- */
-export type TransactionCallback<T = any> = (trans: DbHelper) => Promise<T>;
-
-/**
- * SQL 查询对象
- */
-export interface SqlQuery {
-    /** SQL 语句 */
-    sql: string;
-    /** 参数列表 */
-    params: any[];
-}
-
-/**
- * 数据库管理器接口
- */
-export interface DbHelper {
-    /** 查询记录数 */
-    getCount(options: Omit<QueryOptions, 'fields' | 'page' | 'limit' | 'orderBy'>): Promise<number>;
-    /** 查询单条数据 */
-    getOne<T = any>(options: QueryOptions): Promise<T | null>;
-    /** 查询列表（带分页） */
-    getList<T = any>(options: QueryOptions): Promise<ListResult<T>>;
-    /** 查询所有数据 */
-    getAll<T = any>(options: Omit<QueryOptions, 'page' | 'limit'>): Promise<T[]>;
-    /** 插入数据 */
-    insData(options: InsertOptions): Promise<number>;
-    /** 更新数据 */
-    updData(options: UpdateOptions): Promise<number>;
-    /** 删除数据 */
-    delData(options: DeleteOptions): Promise<number>;
-    /** 执行事务 */
-    trans<T = any>(callback: TransactionCallback<T>): Promise<T>;
-    /** 执行原始 SQL */
-    query(sql: string, params?: any[]): Promise<any>;
-}
-
-/**
- * Redis 助手接口
- */
-export interface RedisHelper {
-    /** 设置对象到 Redis */
-    setObject<T = any>(key: string, obj: T, ttl?: number | null): Promise<string | null>;
-    /** 从 Redis 获取对象 */
-    getObject<T = any>(key: string): Promise<T | null>;
-    /** 从 Redis 删除对象 */
-    delObject(key: string): Promise<void>;
-    /** 生成基于时间的唯一 ID */
-    genTimeID(): Promise<number>;
-    /** 设置字符串值 */
-    setString(key: string, value: string, ttl?: number | null): Promise<string | null>;
-    /** 获取字符串值 */
-    getString(key: string): Promise<string | null>;
-    /** 检查键是否存在 */
-    exists(key: string): Promise<number>;
-    /** 设置过期时间 */
-    expire(key: string, seconds: number): Promise<number>;
-    /** 获取剩余过期时间 */
-    ttl(key: string): Promise<number>;
-    /** 测试 Redis 连接 */
-    ping(): Promise<string>;
-}
-
-/**
- * 日志记录器接口
- */
-export interface Logger {
-    /** 记录信息日志 */
-    info(message: string | object): void;
-    /** 记录警告日志 */
-    warn(message: string | object): void;
-    /** 记录错误日志 */
-    error(message: string | object): void;
-    /** 记录调试日志 */
-    debug(message: string | object): void;
-}
-
-/**
- * 验证结果
- */
-export interface ValidationResult {
-    /** 是否有效 */
-    valid: boolean;
-    /** 处理后的值 */
-    value: any;
-    /** 错误列表 */
-    errors: string[];
-}
-
-/**
- * 数据库类型
- */
-export type DbType = 'mysql' | 'postgresql' | 'sqlite';
-
-/**
- * 列信息
- */
-export interface ColumnInfo {
-    /** 列名 */
-    name: string;
-    /** 数据类型 */
-    type: string;
-    /** 是否可空 */
-    nullable: boolean;
-    /** 默认值 */
-    default: any;
-    /** 注释 */
-    comment: string;
-}
-
-/**
- * 索引信息
- */
-export interface IndexInfo {
-    /** 索引名 */
-    name: string;
-    /** 列名 */
-    column: string;
-    /** 是否唯一 */
-    unique: boolean;
-}
-
-/**
- * 同步统计
- */
-export interface SyncStats {
-    /** 创建的表数 */
-    created: number;
-    /** 修改的表数 */
-    modified: number;
-    /** 创建的索引数 */
-    indexesCreated: number;
-    /** 删除的索引数 */
-    indexesDropped: number;
-}

package/types/validator.ts

@@ -1,43 +0,0 @@
-/**
- * 验证器相关类型定义
- */
-
-/**
- * 字段验证错误信息
- */
-export type ValidationError = string | null;
-
-/**
- * 字段类型
- */
-export type FieldType = 'string' | 'number' | 'text' | 'array';
-
-/**
- * 验证结果
- */
-export interface ValidationResult {
-    /** 验证状态码：0=成功，1=失败 */
-    code: 0 | 1;
-    /** 字段验证结果 */
-    fields: Record<string, any>;
-}
-
-/**
- * 字段规则
- */
-export interface FieldRule {
-    /** 字段名 */
-    name: string;
-    /** 字段类型 */
-    type: FieldType;
-    /** 最小值/长度 */
-    min: number | null;
-    /** 最大值/长度 */
-    max: number | null;
-    /** 默认值 */
-    default: any;
-    /** 是否索引 */
-    index: 0 | 1;
-    /** 正则约束 */
-    regex: string | null;
-}

package/utils/colors.ts

@@ -1,221 +0,0 @@
-/**
- * 终端颜色工具 - TypeScript 版本
- * 提供 ANSI 颜色和样式支持，自动检测终端颜色能力
- */
-
-/**
- * 格式化函数类型
- */
-type Formatter = (input: string | number) => string;
-
-/**
- * 颜色工具接口
- */
-interface ColorsInterface {
-    /** 是否支持颜色 */
-    isColorSupported: boolean;
-
-    // 样式
-    /** 重置所有样式 */
-    reset: Formatter;
-    /** 加粗 */
-    bold: Formatter;
-    /** 变暗 */
-    dim: Formatter;
-    /** 斜体 */
-    italic: Formatter;
-    /** 下划线 */
-    underline: Formatter;
-    /** 反色 */
-    inverse: Formatter;
-    /** 隐藏 */
-    hidden: Formatter;
-    /** 删除线 */
-    strikethrough: Formatter;
-
-    // 前景色（标准）
-    black: Formatter;
-    red: Formatter;
-    green: Formatter;
-    yellow: Formatter;
-    blue: Formatter;
-    magenta: Formatter;
-    cyan: Formatter;
-    white: Formatter;
-    gray: Formatter;
-
-    // 前景色（高亮）
-    blackBright: Formatter;
-    redBright: Formatter;
-    greenBright: Formatter;
-    yellowBright: Formatter;
-    blueBright: Formatter;
-    magentaBright: Formatter;
-    cyanBright: Formatter;
-    whiteBright: Formatter;
-
-    // 背景色（标准）
-    bgBlack: Formatter;
-    bgRed: Formatter;
-    bgGreen: Formatter;
-    bgYellow: Formatter;
-    bgBlue: Formatter;
-    bgMagenta: Formatter;
-    bgCyan: Formatter;
-    bgWhite: Formatter;
-
-    // 背景色（高亮）
-    bgBlackBright: Formatter;
-    bgRedBright: Formatter;
-    bgGreenBright: Formatter;
-    bgYellowBright: Formatter;
-    bgBlueBright: Formatter;
-    bgMagentaBright: Formatter;
-    bgCyanBright: Formatter;
-    bgWhiteBright: Formatter;
-
-    // 语义化颜色（带图标）
-    info: Formatter;
-    success: Formatter;
-    warn: Formatter;
-    error: Formatter;
-}
-
-/**
- * 检测是否支持颜色
- */
-const detectColorSupport = (): boolean => {
-    const env = process.env || {};
-    const argv = process.argv || [];
-
-    // 明确禁用颜色
-    if (env.NO_COLOR || argv.includes('--no-color')) {
-        return false;
-    }
-
-    // 明确启用颜色
-    if (env.FORCE_COLOR || argv.includes('--color')) {
-        return true;
-    }
-
-    // 根据平台和终端环境判断
-    return process.platform === 'win32' || (process.stdout?.isTTY && env.TERM !== 'dumb') || !!env.CI;
-};
-
-const isColorSupported = detectColorSupport();
-
-/**
- * 创建格式化函数
- * @param open - 开始 ANSI 码
- * @param close - 结束 ANSI 码
- * @param replace - 替换的 ANSI 码（用于嵌套）
- * @returns 格式化函数
- */
-const formatter =
-    (open: string, close: string, replace: string = open): Formatter =>
-    (input: string | number): string => {
-        const string = String(input);
-        const index = string.indexOf(close, open.length);
-        // 如果字符串中包含结束码，需要处理嵌套情况
-        return ~index ? open + replaceClose(string, close, replace, index) + close : open + string + close;
-    };
-
-/**
- * 替换字符串中的结束码（处理嵌套颜色）
- * @param string - 原始字符串
- * @param close - 结束码
- * @param replace - 替换码
- * @param index - 起始索引
- * @returns 处理后的字符串
- */
-const replaceClose = (string: string, close: string, replace: string, index: number): string => {
-    let result = '';
-    let cursor = 0;
-    do {
-        result += string.substring(cursor, index) + replace;
-        cursor = index + close.length;
-        index = string.indexOf(close, cursor);
-    } while (~index);
-    return result + string.substring(cursor);
-};
-
-/**
- * 创建颜色工具实例
- * @param enabled - 是否启用颜色
- * @returns 颜色工具对象
- */
-const createColors = (enabled: boolean = isColorSupported): ColorsInterface => {
-    // 如果禁用颜色，返回直接转字符串的函数
-    const f = enabled ? formatter : (): Formatter => (input: string | number) => String(input);
-
-    return {
-        isColorSupported: enabled,
-
-        // 样式 - https://en.wikipedia.org/wiki/ANSI_escape_code#SGR
-        reset: f('\x1b[0m', '\x1b[0m'),
-        bold: f('\x1b[1m', '\x1b[22m', '\x1b[22m\x1b[1m'),
-        dim: f('\x1b[2m', '\x1b[22m', '\x1b[22m\x1b[2m'),
-        italic: f('\x1b[3m', '\x1b[23m'),
-        underline: f('\x1b[4m', '\x1b[24m'),
-        inverse: f('\x1b[7m', '\x1b[27m'),
-        hidden: f('\x1b[8m', '\x1b[28m'),
-        strikethrough: f('\x1b[9m', '\x1b[29m'),
-
-        // 前景色（标准） - 30-37
-        black: f('\x1b[30m', '\x1b[39m'),
-        red: f('\x1b[31m', '\x1b[39m'),
-        green: f('\x1b[32m', '\x1b[39m'),
-        yellow: f('\x1b[33m', '\x1b[39m'),
-        blue: f('\x1b[34m', '\x1b[39m'),
-        magenta: f('\x1b[35m', '\x1b[39m'),
-        cyan: f('\x1b[36m', '\x1b[39m'),
-        white: f('\x1b[37m', '\x1b[39m'),
-        gray: f('\x1b[90m', '\x1b[39m'), // 实际上是 blackBright
-
-        // 前景色（高亮） - 90-97
-        blackBright: f('\x1b[90m', '\x1b[39m'),
-        redBright: f('\x1b[91m', '\x1b[39m'),
-        greenBright: f('\x1b[92m', '\x1b[39m'),
-        yellowBright: f('\x1b[93m', '\x1b[39m'),
-        blueBright: f('\x1b[94m', '\x1b[39m'),
-        magentaBright: f('\x1b[95m', '\x1b[39m'),
-        cyanBright: f('\x1b[96m', '\x1b[39m'),
-        whiteBright: f('\x1b[97m', '\x1b[39m'),
-
-        // 背景色（标准） - 40-47
-        bgBlack: f('\x1b[40m', '\x1b[49m'),
-        bgRed: f('\x1b[41m', '\x1b[49m'),
-        bgGreen: f('\x1b[42m', '\x1b[49m'),
-        bgYellow: f('\x1b[43m', '\x1b[49m'),
-        bgBlue: f('\x1b[44m', '\x1b[49m'),
-        bgMagenta: f('\x1b[45m', '\x1b[49m'),
-        bgCyan: f('\x1b[46m', '\x1b[49m'),
-        bgWhite: f('\x1b[47m', '\x1b[49m'),
-
-        // 背景色（高亮） - 100-107
-        bgBlackBright: f('\x1b[100m', '\x1b[49m'),
-        bgRedBright: f('\x1b[101m', '\x1b[49m'),
-        bgGreenBright: f('\x1b[102m', '\x1b[49m'),
-        bgYellowBright: f('\x1b[103m', '\x1b[49m'),
-        bgBlueBright: f('\x1b[104m', '\x1b[49m'),
-        bgMagentaBright: f('\x1b[105m', '\x1b[49m'),
-        bgCyanBright: f('\x1b[106m', '\x1b[49m'),
-        bgWhiteBright: f('\x1b[107m', '\x1b[49m'),
-
-        // 语义化颜色（函数形式，带图标前缀）
-        info: (input: string | number) => f('\x1b[34m', '\x1b[39m')(`ℹ ${input}`),
-        success: (input: string | number) => f('\x1b[32m', '\x1b[39m')(`✓ ${input}`),
-        warn: (input: string | number) => f('\x1b[33m', '\x1b[39m')(`⚠ ${input}`),
-        error: (input: string | number) => f('\x1b[31m', '\x1b[39m')(`✖ ${input}`)
-    };
-};
-
-/**
- * 默认颜色工具实例
- */
-export const Colors = createColors();
-
-/**
- * 导出类型
- */
-export type { ColorsInterface, Formatter };