befly 3.10.18 → 3.11.1

package/dist/types/sync.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 数据同步相关类型定义
+ */
+import type { BeflyContext } from "./befly";
+import type { KeyValue } from "./common";
+/**
+ * 同步结果
+ */
+export interface SyncResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 同步的数量 */
+    count: number;
+    /** 错误信息 */
+    error?: string;
+    /** 额外数据 */
+    data?: KeyValue;
+}
+/**
+ * 同步选项
+ */
+export interface SyncOptions {
+    /** 是否强制同步（覆盖已有数据） */
+    force?: boolean;
+    /** 是否跳过已存在的数据 */
+    skipExisting?: boolean;
+    /** 同步批次大小 */
+    batchSize?: number;
+    /** 其他选项 */
+    [key: string]: any;
+}
+/**
+ * 同步器接口
+ */
+export interface Syncer {
+    /** 同步菜单 */
+    syncMenus(): Promise<SyncResult>;
+    /** 同步 API */
+    syncApis(): Promise<SyncResult>;
+    /** 同步字段定义 */
+    syncFields(): Promise<SyncResult>;
+    /** 同步所有 */
+    syncAll(): Promise<SyncResult>;
+}
+/**
+ * Syncer 构造函数
+ */
+export interface SyncerConstructor {
+    new (befly: BeflyContext, options?: SyncOptions): Syncer;
+}
+export interface MenuConfig {
+    path?: string;
+    name?: string;
+    sort?: number;
+    parentPath?: string;
+    children?: MenuConfig[];
+    [key: string]: any;
+}
+export interface SyncApiItem {
+    type?: "api" | string;
+    name: string;
+    routePath: string;
+    addonName: string;
+    [key: string]: any;
+}
+export interface ColumnInfo {
+    type: string;
+    columnType: string;
+    length: number | null;
+    max: number | null;
+    nullable: boolean;
+    defaultValue: any;
+    comment: string | null;
+}
+export type IndexInfo = Record<string, string[]>;
+export interface FieldChange {
+    type: string;
+    current: any;
+    expected: any;
+}
+export interface TablePlan {
+    changed: boolean;
+    addClauses: string[];
+    modifyClauses: string[];
+    defaultClauses: string[];
+    indexActions: Array<{
+        action: "create" | "drop";
+        indexName: string;
+        fieldName: string;
+    }>;
+    commentActions?: string[];
+}

package/dist/types/sync.js

@@ -0,0 +1,4 @@
+/**
+ * 数据同步相关类型定义
+ */
+export {};

package/dist/types/table.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 表结构相关类型定义
+ */
+/**
+ * 字段信息
+ */
+export interface FieldInfo {
+    name: string;
+    type: string;
+    isPrimary: boolean;
+    isNotNull: boolean;
+    defaultValue?: any;
+    isAutoIncrement?: boolean;
+    isUnique?: boolean;
+    comment?: string;
+}
+/**
+ * 创建表选项
+ */
+export interface CreateTableOptions {
+    table: string;
+    fields: Record<string, string>;
+    indexes?: string[];
+    unique?: string[];
+}
+/**
+ * SQL 帮助器选项
+ */
+export interface SqlHelperOptions {
+    /** 数据库类型 */
+    type: "mysql" | "postgres" | "sqlite";
+    /** 表名前缀 */
+    prefix?: string;
+}

package/dist/types/table.js

@@ -0,0 +1,4 @@
+/**
+ * 表结构相关类型定义
+ */
+export {};

package/dist/types/validate.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 数据验证相关类型定义
+ */
+/**
+ * 字段类型
+ */
+export type FieldType = "string" | "number" | "text" | "array_string" | "array_text" | "array_number_string" | "array_number_text";
+/**
+ * 字段定义（表字段 JSON 结构）
+ */
+export interface FieldDefinition {
+    /** 字段标签（中文名） */
+    name: string;
+    /** 字段类型 */
+    type: FieldType | string;
+    /** 最小值/最小长度（null 表示不限制） */
+    min: number | null;
+    /** 最大值/最大长度（null 表示不限制） */
+    max: number | null;
+    /** 默认值（可为 null） */
+    default: any;
+    /** 字段描述 */
+    detail?: string;
+    /** 是否创建索引 */
+    index?: boolean;
+    /** 是否唯一约束 */
+    unique?: boolean;
+    /** 是否可为 NULL */
+    nullable?: boolean;
+    /** number 类型是否无符号（仅 MySQL 语义生效） */
+    unsigned?: boolean;
+    /** 正则（或 @alias）；null 表示无约束 */
+    regexp: string | null;
+}
+/**
+ * 表定义（字段名 -> 字段定义）
+ */
+export type TableDefinition = Record<string, FieldDefinition>;
+/**
+ * validate(data, rules) 的返回结构
+ */
+export interface ValidateResult {
+    code: 0 | 1;
+    failed: boolean;
+    firstError: string | null;
+    errors: string[];
+    errorFields: string[];
+    fieldErrors: Record<string, string>;
+}
+/**
+ * single(value, fieldDef) 的返回结构
+ */
+export interface SingleResult {
+    value: any;
+    error: string | null;
+}
+/**
+ * Validator 静态类类型（对外）。
+ *
+ * 说明：runtime 实现是 `export class Validator`，以静态方法形式提供：
+ * - `Validator.validate(data, rules, required)`
+ * - `Validator.single(value, fieldDef)`
+ */
+export interface ValidatorStatic {
+    validate(data: Record<string, any>, rules: TableDefinition, required?: string[]): ValidateResult;
+    single(value: any, fieldDef: FieldDefinition): SingleResult;
+}

package/dist/types/validate.js

@@ -0,0 +1,4 @@
+/**
+ * 数据验证相关类型定义
+ */
+export {};

package/dist/utils/calcPerfTime.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 计算性能时间差
+ */
+export declare const calcPerfTime: (startTime: number, endTime?: number) => string;

package/{utils/calcPerfTime.ts → dist/utils/calcPerfTime.js}

@@ -1,12 +1,12 @@
 /**
  * 计算性能时间差
  */
-export const calcPerfTime = (startTime: number, endTime: number = Bun.nanoseconds()): string => {
+export const calcPerfTime = (startTime, endTime = Bun.nanoseconds()) => {
     const elapsedMs = (endTime - startTime) / 1_000_000;
-
     if (elapsedMs < 1000) {
         return `${elapsedMs.toFixed(2)} 毫秒`;
-    } else {
+    }
+    else {
         const elapsedSeconds = elapsedMs / 1000;
         return `${elapsedSeconds.toFixed(2)} 秒`;
     }

package/dist/utils/convertBigIntFields.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 转换数据库 BIGINT 字段为数字类型
+ *
+ * 当 bigint: false 时，Bun SQL 会将大于 u32 的 BIGINT 返回为字符串，此方法将其转换为 number。
+ *
+ * 转换规则：
+ * 1. 白名单中的字段会被转换
+ * 2. 所有以 'Id' 或 '_id' 结尾的字段会被自动转换
+ * 3. 所有以 'At' 或 '_at' 结尾的字段会被自动转换（时间戳字段）
+ */
+export declare function convertBigIntFields<T = any>(arr: Record<string, any>[], fields?: string[]): T[];

package/{utils/convertBigIntFields.ts → dist/utils/convertBigIntFields.js}

@@ -8,22 +8,19 @@
  * 2. 所有以 'Id' 或 '_id' 结尾的字段会被自动转换
  * 3. 所有以 'At' 或 '_at' 结尾的字段会被自动转换（时间戳字段）
  */
-export function convertBigIntFields<T = any>(arr: Record<string, any>[], fields: string[] = ["id", "pid", "sort"]): T[] {
+export function convertBigIntFields(arr, fields = ["id", "pid", "sort"]) {
     if (!arr || !Array.isArray(arr)) {
-        return arr as T[];
+        return arr;
     }
-
     return arr.map((item) => {
-        const converted: Record<string, any> = {};
+        const converted = {};
         for (const [key, value] of Object.entries(item)) {
             converted[key] = value;
         }
-
         for (const [key, value] of Object.entries(converted)) {
             if (value === undefined || value === null) {
                 continue;
             }
-
             const shouldConvert = fields.includes(key) || key.endsWith("Id") || key.endsWith("_id") || key.endsWith("At") || key.endsWith("_at");
             if (shouldConvert && typeof value === "string") {
                 const num = Number(value);
@@ -32,7 +29,6 @@ export function convertBigIntFields<T = any>(arr: Record<string, any>[], fields:
                 }
             }
         }
-
-        return converted as T;
-    }) as T[];
+        return converted;
+    });
 }

package/dist/utils/cors.d.ts

@@ -0,0 +1,8 @@
+import type { CorsConfig } from "../types/befly";
+/**
+ * 设置 CORS 响应头
+ * @param req - 请求对象
+ * @param config - CORS 配置（可选）
+ * @returns CORS 响应头对象
+ */
+export declare function setCorsOptions(req: Request, config?: CorsConfig): Record<string, string>;

package/{utils/cors.ts → dist/utils/cors.js}

@@ -1,12 +1,10 @@
-import type { CorsConfig } from "../types/befly.ts";
-
 /**
  * 设置 CORS 响应头
  * @param req - 请求对象
  * @param config - CORS 配置（可选）
  * @returns CORS 响应头对象
  */
-export function setCorsOptions(req: Request, config: CorsConfig = {}): Record<string, string> {
+export function setCorsOptions(req, config = {}) {
     const origin = config.origin || "*";
     return {
         "Access-Control-Allow-Origin": origin === "*" ? req.headers.get("origin") || "*" : origin,

package/dist/utils/disableMenusGlob.d.ts

@@ -0,0 +1,13 @@
+import { Glob } from "bun";
+export type DisableMenuGlobRule = {
+    type: "glob";
+    raw: string;
+    glob: Glob;
+};
+/**
+ * 将 disableMenus 编译为 Bun.Glob 规则（带进程级缓存）。
+ * - 仅使用 Bun.Glob 的语法与 API。
+ * - 此函数也会做基础的 disableMenus 配置校验（数组/string/非空）。
+ */
+export declare function compileDisableMenuGlobRules(disableMenus: unknown): DisableMenuGlobRule[];
+export declare function isMenuPathDisabledByGlobRules(path: string, rules: DisableMenuGlobRule[]): boolean;

package/{utils/disableMenusGlob.ts → dist/utils/disableMenusGlob.js}

@@ -1,64 +1,45 @@
 import { Glob } from "bun";
-
-export type DisableMenuGlobRule = {
-    type: "glob";
-    raw: string;
-    glob: Glob;
-};
-
-const compiledGlobCache = new Map<string, Glob>();
-
-function normalizeDisableMenusRules(disableMenus: unknown): string[] {
+const compiledGlobCache = new Map();
+function normalizeDisableMenusRules(disableMenus) {
     if (typeof disableMenus === "undefined") {
         return [];
     }
-
     if (!Array.isArray(disableMenus)) {
         throw new Error("disableMenus 配置不合法：必须是 string[]");
     }
-
-    const normalized: string[] = [];
-
+    const normalized = [];
     for (const rawRule of disableMenus) {
         if (typeof rawRule !== "string") {
             throw new Error("disableMenus 配置不合法：数组元素必须是 string");
         }
-
         const rule = rawRule.trim();
         if (!rule) {
             throw new Error("disableMenus 配置不合法：不允许空字符串");
         }
-
         normalized.push(rule);
     }
-
     return normalized;
 }
-
-function getOrCreateGlob(pattern: string): Glob {
+function getOrCreateGlob(pattern) {
     const existed = compiledGlobCache.get(pattern);
     if (existed) {
         return existed;
     }
-
     const created = new Glob(pattern);
     compiledGlobCache.set(pattern, created);
     return created;
 }
-
 /**
  * 将 disableMenus 编译为 Bun.Glob 规则（带进程级缓存）。
  * - 仅使用 Bun.Glob 的语法与 API。
  * - 此函数也会做基础的 disableMenus 配置校验（数组/string/非空）。
  */
-export function compileDisableMenuGlobRules(disableMenus: unknown): DisableMenuGlobRule[] {
+export function compileDisableMenuGlobRules(disableMenus) {
     const normalized = normalizeDisableMenusRules(disableMenus);
     if (normalized.length === 0) {
         return [];
     }
-
-    const rules: DisableMenuGlobRule[] = [];
-
+    const rules = [];
     for (const rule of normalized) {
         try {
             const glob = getOrCreateGlob(rule);
@@ -67,15 +48,14 @@ export function compileDisableMenuGlobRules(disableMenus: unknown): DisableMenuG
                 raw: rule,
                 glob: glob
             });
-        } catch (error: any) {
+        }
+        catch (error) {
             throw new Error(`disableMenus 配置不合法：glob 规则 ${rule} 解析失败：${error?.message || String(error)}`);
         }
     }
-
     return rules;
 }
-
-export function isMenuPathDisabledByGlobRules(path: string, rules: DisableMenuGlobRule[]): boolean {
+export function isMenuPathDisabledByGlobRules(path, rules) {
     for (const rule of rules) {
         if (rule.glob.match(path)) {
             return true;

package/dist/utils/fieldClear.d.ts

@@ -0,0 +1,11 @@
+export interface FieldClearOptions {
+    pickKeys?: string[];
+    omitKeys?: string[];
+    keepValues?: any[];
+    excludeValues?: any[];
+    keepMap?: Record<string, any>;
+}
+export type FieldClearResult<T> = T extends Array<infer U> ? Array<FieldClearResult<U>> : T extends object ? {
+    [K in keyof T]?: T[K];
+} : T;
+export declare function fieldClear<T = any>(data: T | T[], options?: FieldClearOptions): FieldClearResult<T>;

package/{utils/fieldClear.ts → dist/utils/fieldClear.js}

@@ -1,29 +1,15 @@
 // fieldClear 工具函数实现
 // 支持 pick/omit/keepValues/excludeValues，处理对象和数组
-
-export interface FieldClearOptions {
-    pickKeys?: string[]; // 只保留这些字段
-    omitKeys?: string[]; // 排除这些字段
-    keepValues?: any[]; // 只保留这些值
-    excludeValues?: any[]; // 排除这些值
-    keepMap?: Record<string, any>; // 强制保留的键值对（优先级最高，忽略 excludeValues）
-}
-
-export type FieldClearResult<T> = T extends Array<infer U> ? Array<FieldClearResult<U>> : T extends object ? { [K in keyof T]?: T[K] } : T;
-
-function isObject(val: unknown): val is Record<string, any> {
+function isObject(val) {
     return val !== null && typeof val === "object" && !Array.isArray(val);
 }
-
-function isArray(val: unknown): val is any[] {
+function isArray(val) {
     return Array.isArray(val);
 }
-
-export function fieldClear<T = any>(data: T | T[], options: FieldClearOptions = {}): FieldClearResult<T> {
+export function fieldClear(data, options = {}) {
     const { pickKeys, omitKeys, keepValues, excludeValues, keepMap } = options;
-
-    const filterObj = (obj: Record<string, any>) => {
-        let result: Record<string, any> = {};
+    const filterObj = (obj) => {
+        let result = {};
         let keys = Object.keys(obj);
         if (pickKeys && pickKeys.length) {
             keys = keys.filter((k) => pickKeys.includes(k));
@@ -33,7 +19,6 @@ export function fieldClear<T = any>(data: T | T[], options: FieldClearOptions =
         }
         for (const key of keys) {
             const value = obj[key];
-
             // 1. 优先检查 keepMap
             if (keepMap && key in keepMap) {
                 if (Object.is(keepMap[key], value)) {
@@ -41,12 +26,10 @@ export function fieldClear<T = any>(data: T | T[], options: FieldClearOptions =
                     continue;
                 }
             }
-
             // 2. 检查 keepValues (只保留指定值)
             if (keepValues && keepValues.length && !keepValues.includes(value)) {
                 continue;
             }
-
             // 3. 检查 excludeValues (排除指定值)
             if (excludeValues && excludeValues.length && excludeValues.includes(value)) {
                 continue;
@@ -55,21 +38,20 @@ export function fieldClear<T = any>(data: T | T[], options: FieldClearOptions =
         }
         return result;
     };
-
     if (isArray(data)) {
-        return (data as any[])
+        return data
             .map((item) => (isObject(item) ? filterObj(item) : item))
             .filter((item) => {
-                if (isObject(item)) {
-                    // 只保留有内容的对象
-                    return Object.keys(item).length > 0;
-                }
-                // 原始值直接保留
-                return true;
-            }) as FieldClearResult<T>;
+            if (isObject(item)) {
+                // 只保留有内容的对象
+                return Object.keys(item).length > 0;
+            }
+            // 原始值直接保留
+            return true;
+        });
     }
     if (isObject(data)) {
-        return filterObj(data as Record<string, any>) as FieldClearResult<T>;
+        return filterObj(data);
     }
-    return data as FieldClearResult<T>;
+    return data;
 }

package/dist/utils/getClientIp.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 获取客户端 IP（优先代理头，其次 Bun server.requestIP 兜底）
+ *
+ * 注意：目前策略是“尽量取到 IP”，未做 trustProxy 防伪造控制。
+ */
+export declare function getClientIp(req: Request, server?: any): string;

package/{utils/getClientIp.ts → dist/utils/getClientIp.js}

@@ -3,7 +3,7 @@
  *
  * 注意：目前策略是“尽量取到 IP”，未做 trustProxy 防伪造控制。
  */
-export function getClientIp(req: Request, server?: any): string {
+export function getClientIp(req, server) {
     // 1) 代理/网关常见头（优先取）
     const xForwardedFor = req.headers.get("x-forwarded-for");
     if (typeof xForwardedFor === "string" && xForwardedFor.trim()) {
@@ -12,27 +12,22 @@ export function getClientIp(req: Request, server?: any): string {
             return first.trim();
         }
     }
-
     const xRealIp = req.headers.get("x-real-ip");
     if (typeof xRealIp === "string" && xRealIp.trim()) {
         return xRealIp.trim();
     }
-
     const cfConnectingIp = req.headers.get("cf-connecting-ip");
     if (typeof cfConnectingIp === "string" && cfConnectingIp.trim()) {
         return cfConnectingIp.trim();
     }
-
     const xClientIp = req.headers.get("x-client-ip");
     if (typeof xClientIp === "string" && xClientIp.trim()) {
         return xClientIp.trim();
     }
-
     const trueClientIp = req.headers.get("true-client-ip");
     if (typeof trueClientIp === "string" && trueClientIp.trim()) {
         return trueClientIp.trim();
     }
-
     // 2) 连接层兜底：Bun server.requestIP(req)
     if (server && typeof server.requestIP === "function") {
         const ipInfo = server.requestIP(req);
@@ -40,6 +35,5 @@ export function getClientIp(req: Request, server?: any): string {
             return ipInfo.address.trim();
         }
     }
-
     return "unknown";
 }

package/dist/utils/importDefault.d.ts

@@ -0,0 +1 @@
+export declare function importDefault<T>(file: string, defaultValue: T): Promise<T>;

package/dist/utils/importDefault.js

@@ -0,0 +1,29 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+/**
+ * 动态导入模块并优先返回其 default 导出。
+ *
+ * - import() 报错：返回 defaultValue
+ * - default 导出为 null/undefined：返回 defaultValue
+ */
+import { Logger } from "../lib/logger";
+export async function importDefault(file, defaultValue) {
+    try {
+        const mod = (await import(__rewriteRelativeImportExtension(file)));
+        const value = mod?.default;
+        if (value === null || value === undefined) {
+            return defaultValue;
+        }
+        return value;
+    }
+    catch (err) {
+        Logger.warn({ err: err, file: file }, "importDefault 导入失败，已回退到默认值");
+        return defaultValue;
+    }
+}

package/dist/utils/isDirentDirectory.d.ts

@@ -0,0 +1,2 @@
+import type { Dirent } from "node:fs";
+export declare const isDirentDirectory: (parentDir: string, entry: Dirent<string>) => boolean;

package/{utils/isDirentDirectory.ts → dist/utils/isDirentDirectory.js}

@@ -1,23 +1,18 @@
-import type { Dirent } from "node:fs";
-
 import { statSync } from "node:fs";
-
 import { join } from "pathe";
-
-export const isDirentDirectory = (parentDir: string, entry: Dirent): boolean => {
+export const isDirentDirectory = (parentDir, entry) => {
     if (entry.isDirectory()) {
         return true;
     }
-
     // 兼容 Windows 下的 junction / workspace link：Dirent.isDirectory() 可能为 false，但它实际指向目录。
     if (!entry.isSymbolicLink()) {
         return false;
     }
-
     try {
         const stats = statSync(join(parentDir, entry.name));
         return stats.isDirectory();
-    } catch {
+    }
+    catch {
         return false;
     }
 };

package/dist/utils/loadMenuConfigs.d.ts

@@ -0,0 +1,29 @@
+import type { MenuConfig } from "../types/sync";
+import type { AddonInfo } from "./scanAddons";
+type ViewDirMeta = {
+    title: string;
+    order?: number;
+};
+/**
+ * 清理目录名中的数字后缀
+ * 如：login_1 → login, index_2 → index
+ */
+export declare function cleanDirName(name: string): string;
+/**
+ * 只取第一个 <script ... setup ...> 块
+ */
+export declare function extractScriptSetupBlock(vueContent: string): string | null;
+/**
+ * 从 <script setup> 中提取 definePage({ meta })
+ *
+ * 简化约束：
+ * - 每个页面只有一个 definePage
+ * - title 是纯字符串字面量
+ * - order 是数字字面量（可选）
+ * - 不考虑变量/表达式/多段 meta 组合
+ */
+export declare function extractDefinePageMetaFromScriptSetup(scriptSetup: string): ViewDirMeta | null;
+export declare function scanViewsDirToMenuConfigs(viewsDir: string, prefix: string, parentPath?: string): Promise<MenuConfig[]>;
+export declare function getParentPath(path: string): string;
+export declare function loadMenuConfigs(addons: AddonInfo[]): Promise<MenuConfig[]>;
+export {};