befly 3.10.18 → 3.11.1

package/types/logger.d.ts

@@ -1,65 +0,0 @@
-/**
- * 日志相关类型定义
- */
-
-/**
- * 日志级别
- */
-export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
-
-/**
- * 日志配置
- */
-export interface LoggerConfig {
-    /** 是否开启调试模式 (0: 关闭, 1: 开启) @default 0 */
-    debug?: number;
-    /**
-     * 需要在日志中脱敏/排除的字段（仅支持数组）
-     * - 支持模糊匹配："token" 可命中 "accessToken" / "user_token" 等
-     * - 支持后缀匹配："*Secret" 可命中 "mySecret" / "appSecret" 等
-     * - 支持前缀匹配："auth*" 可命中 "authorization" 等
-     * - 支持包含匹配："*token*" 可命中包含 token 的任意 key
-     */
-    excludeFields?: string[];
-    /** 日志目录 @default './logs' */
-    dir?: string;
-    /** 是否输出到控制台 (0: 关闭, 1: 开启) @default 1 */
-    console?: number;
-    /** 单个日志文件最大大小 (MB) @default 10 */
-    maxSize?: number;
-
-    /**
-     * 字符串最大长度（超过会被截断）
-     * - 影响所有结构化字段中的 string（包括 db.debug 打印的 sqlPreview）
-     * - 生产环境建议保持较小值；需要更完整 SQL 时可在开发环境调大
-     * @default 100
-     */
-    maxStringLen?: number;
-
-    /**
-     * 数组最多保留的元素数量（超出部分丢弃）
-     * - 仅影响结构化日志清洗（数组裁剪）
-     * @default 100
-     */
-    maxArrayItems?: number;
-
-    /**
-     * 结构化日志清洗：最大清洗深度（非递归遍历的 depth 上限）
-     * - 值越大，日志更“完整”，但 CPU/内存开销更高
-     * - 建议：生产环境保持较小值（默认 3），开发环境可调大（例如 5）
-     * @default 3
-     */
-    sanitizeDepth?: number;
-
-    /**
-     * 结构化日志清洗：最大遍历节点数（防止超大对象/数组导致性能抖动）
-     * @default 500
-     */
-    sanitizeNodes?: number;
-
-    /**
-     * 结构化日志清洗：对象最多保留的 key 数（超出部分丢弃）
-     * @default 100
-     */
-    sanitizeObjectKeys?: number;
-}

package/types/plugin.d.ts

@@ -1,19 +0,0 @@
-/**
- * Befly 插件系统类型定义
- */
-
-import type { BeflyContext } from "./befly.ts";
-
-/**
- * 插件配置类型
- */
-export interface Plugin {
-    /** 插件名称（运行时动态添加，由文件名生成） */
-    name?: string;
-
-    /** 依赖的插件列表（在这些插件之后执行） */
-    deps: string[];
-
-    /** 插件初始化函数 */
-    handler: (context: BeflyContext) => any | Promise<any>;
-}

package/types/redis.d.ts

@@ -1,83 +0,0 @@
-/**
- * Redis 相关类型定义
- */
-
-import { RedisClient as BunRedisClient } from "bun";
-
-/**
- * Redis 客户端类型
- */
-export type RedisClient = BunRedisClient;
-
-/**
- * Redis 键前缀
- */
-export type RedisKeyPrefix = string;
-
-/**
- * Redis TTL（秒）
- */
-export type RedisTTL = number | null;
-
-/**
- * Redis 助手接口
- */
-export interface RedisHelper {
-    // ==================== 基础操作 ====================
-    /** 设置对象到 Redis */
-    setObject<T = any>(key: string, obj: T, ttl?: RedisTTL): Promise<string | null>;
-    /** 从 Redis 获取对象 */
-    getObject<T = any>(key: string): Promise<T | null>;
-    /** 从 Redis 删除对象 */
-    delObject(key: string): Promise<void>;
-    /** 设置字符串值 */
-    setString(key: string, value: string, ttl?: RedisTTL): Promise<string | null>;
-    /** 获取字符串值 */
-    getString(key: string): Promise<string | null>;
-    /** 检查键是否存在 */
-    exists(key: string): Promise<boolean>;
-    /** 原子自增 */
-    incr(key: string): Promise<number>;
-    /** 原子自增并在首次自增时设置过期时间 */
-    incrWithExpire(key: string, seconds: number): Promise<number>;
-    /** 设置过期时间 */
-    expire(key: string, seconds: number): Promise<number>;
-    /** 获取剩余过期时间 */
-    ttl(key: string): Promise<number>;
-    /** 删除键 */
-    del(key: string): Promise<number>;
-    /** 测试 Redis 连接 */
-    ping(): Promise<string>;
-
-    // ==================== ID 生成 ====================
-    /** 生成基于时间的唯一 ID (16位纯数字: 13位毫秒时间戳 + 3位后缀100-999) */
-    genTimeID(): Promise<number>;
-
-    // ==================== Set 操作 ====================
-    /** 向 Set 中添加一个或多个成员 */
-    sadd(key: string, members: string[]): Promise<number>;
-    /** 判断成员是否在 Set 中 */
-    sismember(key: string, member: string): Promise<number>;
-    /** 获取 Set 的成员数量 */
-    scard(key: string): Promise<number>;
-    /** 获取 Set 的所有成员 */
-    smembers(key: string): Promise<string[]>;
-
-    // ==================== 批量操作 ====================
-    /** 批量设置对象 */
-    setBatch<T = any>(items: Array<{ key: string; value: T; ttl?: number | null }>): Promise<number>;
-    /** 批量获取对象 */
-    getBatch<T = any>(keys: string[]): Promise<Array<T | null>>;
-    /** 批量删除键 */
-    delBatch(keys: string[]): Promise<number>;
-    /** 批量检查键是否存在 */
-    existsBatch(keys: string[]): Promise<boolean[]>;
-    /** 批量设置过期时间 */
-    expireBatch(items: Array<{ key: string; seconds: number }>): Promise<number>;
-    /** 批量获取剩余过期时间 */
-    ttlBatch(keys: string[]): Promise<number[]>;
-    /** 批量向多个 Set 添加成员 */
-    saddBatch(items: Array<{ key: string; members: string[] }>): Promise<number>;
-    /** 批量检查成员是否在 Set 中 */
-    sismemberBatch(items: Array<{ key: string; member: string }>): Promise<boolean[]>;
-}

package/types/sync.d.ts

@@ -1,398 +0,0 @@
-/**
- * CLI 项目类型定义
- * 集中管理所有接口和类型定义
- */
-
-// ==================== 命令选项类型 ====================
-
-/**
- * SyncMenu 命令选项
- */
-export interface SyncMenuOptions {
-}
-
-/**
- * 菜单配置
- */
-export interface MenuConfig {
-    name: string;
-    path: string;
-    icon?: string;
-    sort?: number;
-    children?: MenuConfig[];
-}
-
-/**
- * 菜单配置来源（三值约束）
- */
-export type MenuConfigSource = "core" | "app" | "addon";
-
-/**
- * SyncDev 命令选项
- */
-export interface SyncDevOptions {
-}
-
-/**
- * SyncApi 命令选项
- */
-export interface SyncApiOptions {
-}
-
-/**
- * syncApi 入参条目（来自 scanFiles 扫描结果的最小子集）
- * - addonName 必须为 string（app/core 为 ""，addon 为真实 addonName）
- * - type 可选：历史/测试数据可能缺失；存在且不为 "api" 时在 syncApi 中会被跳过
- */
-export type SyncApiItem = {
-    type?: string;
-    routePath: string;
-    name: string;
-    addonName: string;
-} & Record<string, any>;
-
-/**
- * API 信息
- */
-export interface ApiInfo {
-    name: string;
-    path: string;
-    description: string;
-    addonName: string;
-    addonTitle: string;
-}
-
-// ==================== 统计信息类型 ====================
-
-/**
- * SyncMenu 统计信息
- */
-export interface SyncMenuStats {
-    totalMenus: number;
-    parentMenus: number;
-    childMenus: number;
-    created: number;
-    updated: number;
-    deleted: number;
-}
-
-/**
- * SyncApi 统计信息
- */
-export interface SyncApiStats {
-    totalApis: number;
-    created: number;
-    updated: number;
-    deleted: number;
-}
-
-// ==================== 数据库相关类型 ====================
-
-/**
- * 列信息接口
- */
-export interface ColumnInfo {
-    type: string;
-    columnType: string;
-    length: number | null;
-    max?: number | null;
-    nullable: boolean;
-    defaultValue: any;
-    comment: string | null;
-}
-
-/**
- * 索引信息接口（键为索引名，值为列名数组）
- */
-export interface IndexInfo {
-    [indexName: string]: string[];
-}
-
-/**
- * 字段变更接口
- */
-export interface FieldChange {
-    type: "length" | "datatype" | "comment" | "default" | "nullable";
-    current: any;
-    expected: any;
-}
-
-/**
- * 索引操作接口
- */
-export interface IndexAction {
-    action: "create" | "drop";
-    indexName: string;
-    fieldName: string;
-}
-
-/**
- * 表变更计划接口
- */
-export interface TablePlan {
-    changed: boolean;
-    addClauses: string[];
-    modifyClauses: string[];
-    defaultClauses: string[];
-    indexActions: IndexAction[];
-    commentActions?: string[];
-}
-
-/**
- * 全局统计对象
- */
-export interface GlobalStats {
-    processedTables: number;
-    createdTables: number;
-    modifiedTables: number;
-    addFields: number;
-    nameChanges: number;
-    typeChanges: number;
-    minChanges: number;
-    maxChanges: number;
-    defaultChanges: number;
-    indexCreate: number;
-    indexDrop: number;
-}
-
-/**
- * 解析后的字段规则
- */
-export interface ParsedFieldRule {
-    name: string;
-    type: "string" | "number" | "text" | "array_string" | "array_text";
-    min: number | null;
-    max: number | null;
-    default: any;
-    index: 0 | 1;
-    regex: string | null;
-}
-
-/**
- * 阶段统计信息
- */
-export interface PhaseStats {
-    startTime: number;
-    endTime?: number;
-    duration?: number;
-}
-
-// ==================== 报告相关类型 ====================
-
-/**
- * 完整的同步报告数据结构
- */
-export interface SyncReport {
-    meta: SyncReportMeta;
-    database: DatabaseReport;
-    api: ApiReport;
-    menu: MenuReport;
-    dev: DevReport;
-}
-
-/**
- * 报告元信息
- */
-export interface SyncReportMeta {
-    timestamp: number;
-    timestampStr: string;
-    environment: string;
-    totalTime: number;
-    status: "success" | "error";
-    error?: string;
-}
-
-/**
- * 数据库同步报告
- */
-export interface DatabaseReport {
-    stats: SyncDbStats;
-    details: {
-        tables: TableChangeDetail[];
-    };
-    timing: {
-        validation: number;
-        connection: number;
-        scanning: number;
-        processing: number;
-    };
-}
-
-/**
- * 表变更详情
- */
-export interface TableChangeDetail {
-    name: string;
-    source: "app" | "addon";
-    addonName?: string;
-    action: "create" | "modify" | "none";
-    fields: {
-        added: FieldDetail[];
-        modified: FieldModification[];
-        removed: FieldDetail[];
-    };
-    indexes: {
-        added: IndexDetail[];
-        removed: IndexDetail[];
-    };
-    sql: string[];
-}
-
-/**
- * 字段详情
- */
-export interface FieldDetail {
-    name: string;
-    type: string;
-    length?: number;
-    nullable?: boolean;
-    defaultValue?: any;
-    comment?: string;
-}
-
-/**
- * 字段修改详情
- */
-export interface FieldModification {
-    name: string;
-    before: FieldDetail;
-    after: FieldDetail;
-    changeType: "type" | "length" | "default" | "nullable" | "comment";
-}
-
-/**
- * 索引详情
- */
-export interface IndexDetail {
-    name: string;
-    fields: string[];
-    type?: string;
-}
-
-/**
- * 接口同步报告
- */
-export interface ApiReport {
-    stats: {
-        totalApis: number;
-        appApis: number;
-        addonApis: number;
-        created: number;
-        updated: number;
-        deleted: number;
-    };
-    details: {
-        bySource: {
-            app: ApiDetail[];
-            addons: Record<string, ApiDetail[]>;
-        };
-        byAction: {
-            created: ApiDetail[];
-            updated: ApiDetailWithDiff[];
-            deleted: ApiDetail[];
-        };
-    };
-    timing: {
-        scanning: number;
-        processing: number;
-        caching: number;
-    };
-}
-
-/**
- * 接口详情
- */
-export interface ApiDetail {
-    name: string;
-    path: string;
-    method: string;
-    description: string;
-    addonName: string;
-    addonTitle: string;
-    auth?: boolean;
-}
-
-/**
- * 带差异的接口详情
- */
-export interface ApiDetailWithDiff extends ApiDetail {
-    changes: {
-        field: string;
-        before: any;
-        after: any;
-    }[];
-}
-
-/**
- * 菜单同步报告
- */
-export interface MenuReport {
-    stats: SyncMenuStats;
-    details: {
-        tree: MenuTreeNode[];
-        byAction: {
-            created: MenuDetail[];
-            updated: MenuDetailWithDiff[];
-            deleted: MenuDetail[];
-        };
-    };
-    timing: {
-        scanning: number;
-        processing: number;
-        caching: number;
-    };
-}
-
-/**
- * 菜单树节点
- */
-export interface MenuTreeNode {
-    name: string;
-    path: string;
-    icon?: string;
-    sort?: number;
-    type?: number;
-    action?: "created" | "updated" | "none";
-    children?: MenuTreeNode[];
-}
-
-/**
- * 菜单详情
- */
-export interface MenuDetail {
-    name: string;
-    path: string;
-    icon?: string;
-    sort?: number;
-    type?: number;
-    addonName: string;
-    addonTitle: string;
-}
-
-/**
- * 带差异的菜单详情
- */
-export interface MenuDetailWithDiff extends MenuDetail {
-    changes: {
-        field: string;
-        before: any;
-        after: any;
-    }[];
-}
-
-/**
- * 管理员详情
- */
-export interface AdminDetail {
-    username: string;
-    action: "created" | "updated" | "exists";
-}
-
-/**
- * 角色详情
- */
-export interface RoleDetail {
-    name: string;
-    permissions: number;
-    action: "created" | "updated" | "exists";
-}