befly 3.16.10 → 3.16.11

package/dist/types/redis.d.ts

@@ -1,80 +0,0 @@
-/**
- * Redis 助手类型定义
- */
-/**
- * Redis Key 类型
- */
-export type RedisKey = string;
-/**
- * Redis Value 类型
- */
-export type RedisValue = string | number | boolean | object | null;
-/**
- * Redis 配置选项
- */
-export interface RedisOptions {
-    host: string;
-    port: number;
-    password?: string;
-    db?: number;
-    prefix?: string;
-}
-/**
- * Redis 助手接口
- */
-export interface RedisHelper {
-    setObject<T = any>(key: string, obj: T, ttl?: number | null): Promise<string | null>;
-    getObject<T = any>(key: string): Promise<T | null>;
-    delObject(key: string): Promise<void>;
-    genTimeID(): Promise<number>;
-    setString(key: string, value: string, ttl?: number | null): 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>;
-    ttlBatch(keys: string[]): Promise<number[]>;
-    sadd(key: string, members: string[]): Promise<number>;
-    sismember(key: string, member: string): Promise<boolean>;
-    scard(key: string): Promise<number>;
-    smembers(key: string): Promise<string[]>;
-    saddBatch(items: Array<{
-        key: string;
-        members: string[];
-    }>): Promise<number>;
-    sismemberBatch(items: Array<{
-        key: string;
-        member: string;
-    }>): Promise<boolean[]>;
-    del(key: string): Promise<number>;
-    delBatch(keys: string[]): Promise<number>;
-    setBatch<T = any>(items: Array<{
-        key: string;
-        value: T;
-        ttl?: number | null;
-    }>): Promise<number>;
-    getBatch<T = any>(keys: string[]): Promise<Array<T | null>>;
-    existsBatch(keys: string[]): Promise<boolean[]>;
-    expireBatch(items: Array<{
-        key: string;
-        seconds: number;
-    }>): Promise<number>;
-    ping(): Promise<string>;
-    /**
-     * 尝试获取分布式锁（SET key value NX PX ttlMs）
-     * @returns true=获取成功；false=未获取到（被占用）
-     */
-    tryAcquireLock(key: string, token: string, ttlMs: number): Promise<boolean>;
-    /**
-     * 释放分布式锁（仅当 value==token 时删除）
-     * @returns true=释放成功；false=未释放（锁不存在/不归属/实现不支持）
-     */
-    releaseLock(key: string, token: string): Promise<boolean>;
-}
-/**
- * RedisHelper 构造函数类型
- */
-export interface RedisHelperConstructor {
-    new (prefix?: string): RedisHelper;
-}

package/dist/types/redis.js

@@ -1,4 +0,0 @@
-/**
- * Redis 助手类型定义
- */
-export {};

package/dist/types/roleApisCache.d.ts

@@ -1,21 +0,0 @@
-/**
- * 角色接口权限缓存（Redis）元信息类型
- *
- * 说明：
- * - active/ready 用于全局版本切换与就绪门槛
- * - role meta 用于单角色增量刷新后的可观测性
- */
-export type RoleApisCacheMeta = {
-    hash: string;
-    at: number;
-    roles: number;
-    members: number;
-    /** 可选：用于和 DB 侧的更新时间做一致性对比 */
-    updatedAt?: number;
-};
-export type RoleApisRoleMeta = {
-    roleCode: string;
-    at: number;
-    members: number;
-    hash: string;
-};

package/dist/types/roleApisCache.js

@@ -1,8 +0,0 @@
-/**
- * 角色接口权限缓存（Redis）元信息类型
- *
- * 说明：
- * - active/ready 用于全局版本切换与就绪门槛
- * - role meta 用于单角色增量刷新后的可观测性
- */
-export {};

package/dist/types/sync.d.ts

@@ -1,93 +0,0 @@
-/**
- * 数据同步相关类型定义
- */
-import type { BeflyContext } from "./befly";
-import type { JsonValue, 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]: JsonValue | undefined;
-}
-/**
- * 同步器接口
- */
-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]: JsonValue | undefined;
-}
-export interface SyncApiItem {
-    type?: "api" | string;
-    name: string;
-    /** 是否需要登录：运行时支持 boolean/string[]；同步写库为字符串（否/是/角色列表） */
-    auth?: boolean | string[] | string;
-    path: string;
-    parentPath: string;
-    addonName: string;
-    [key: string]: JsonValue | undefined;
-}
-export interface ColumnInfo {
-    type: string;
-    columnType: string;
-    length: number | null;
-    max: number | null;
-    nullable: boolean;
-    defaultValue: JsonValue;
-    comment: string | null;
-}
-export type IndexInfo = Record<string, string[]>;
-export interface FieldChange {
-    type: string;
-    current: JsonValue;
-    expected: JsonValue;
-}
-export interface TablePlan {
-    changed: boolean;
-    alterClauses: string[];
-    indexActions: Array<{
-        action: "create" | "drop";
-        indexName: string;
-        fieldName: string;
-    }>;
-    commentActions?: string[];
-}

package/dist/types/sync.js

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

package/dist/types/table.d.ts

@@ -1,34 +0,0 @@
-/**
- * 表结构相关类型定义
- */
-/**
- * 字段信息
- */
-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";
-    /** 表名前缀 */
-    prefix?: string;
-}

package/dist/types/table.js

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

package/dist/types/validate.d.ts

@@ -1,113 +0,0 @@
-/**
- * 数据验证相关类型定义
- */
-import type { JsonValue } from "./common";
-/**
- * 数据库字段类型
- */
-export type DbFieldType = "tinyint" | "smallint" | "mediumint" | "int" | "bigint" | "decimal" | "float" | "double" | "char" | "varchar" | "enum" | "tinytext" | "text" | "mediumtext" | "longtext" | "datetime" | "timestamp" | "json";
-/**
- * 输入参数类型
- */
-export type InputType = "number" | "integer" | "string" | "char" | "array" | "array_number" | "array_integer" | "json" | "json_number" | "json_integer";
-/**
- * 字段定义（表字段 JSON 结构）
- */
-export interface FieldDefinition {
-    /** 字段标签（中文名） */
-    name: string;
-    /** 字段类型 */
-    type: DbFieldType | string;
-    /** 输入类型（校验用） */
-    input?: InputType | string;
-    /**
-     * 最小值/最小长度。
-     * - 缺省默认：null（表示不限制）
-     */
-    min?: number | null;
-    /**
-     * 最大值/最大长度。
-     * - 缺省默认：null（表示不限制）
-     */
-    max?: number | null;
-    /**
-     * 默认值。
-     * - 缺省默认：null（表示字段未提供默认值）
-     */
-    default?: JsonValue | null;
-    /**
-     * 字段描述。
-     * - 缺省默认：""（空字符串）
-     */
-    detail?: string;
-    /**
-     * decimal 精度（总位数）。
-     * - 缺省默认：null
-     */
-    precision?: number | null;
-    /**
-     * decimal 小数位数。
-     * - 缺省默认：null
-     */
-    scale?: number | null;
-    /**
-     * 是否创建索引。
-     * - 缺省默认：false
-     */
-    index?: boolean;
-    /**
-     * 是否唯一约束。
-     * - 缺省默认：false
-     */
-    unique?: boolean;
-    /**
-     * 是否可为 NULL。
-     * - 缺省默认：false
-     */
-    nullable?: boolean;
-    /**
-     * number 类型是否无符号（仅 MySQL 语义生效）。
-     * - 缺省默认：false
-     */
-    unsigned?: boolean;
-}
-/**
- * 表定义（字段名 -> 字段定义）
- */
-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: JsonValue | null;
-    error: string | null;
-}
-/**
- * Validator 静态类类型（对外）。
- *
- * 说明：runtime 实现是 `export class Validator`，以静态方法形式提供：
- * - `Validator.validate(data, rules, required)`
- * - `Validator.single(value, fieldDef)`
- */
-export interface ValidatorStatic {
-    /**
-     * 推荐签名：正常业务使用。
-     */
-    validate(data: Record<string, JsonValue>, rules: TableDefinition, required?: string[]): ValidateResult;
-    /**
-     * 宽签名：用于边界输入（例如测试传入非法参数）——实现内部会做运行时校验。
-     */
-    validate(data: unknown, rules: unknown, required?: string[]): ValidateResult;
-    single(value: unknown, fieldDef: FieldDefinition): SingleResult;
-}

package/dist/types/validate.js

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

package/dist/utils/calcPerfTime.d.ts

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

package/dist/utils/calcPerfTime.js

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

package/dist/utils/cors.d.ts

@@ -1,8 +0,0 @@
-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/dist/utils/cors.js

@@ -1,17 +0,0 @@
-/**
- * 设置 CORS 响应头
- * @param req - 请求对象
- * @param config - CORS 配置（可选）
- * @returns CORS 响应头对象
- */
-export function setCorsOptions(req, config = {}) {
-    const origin = config.origin || "*";
-    return {
-        "Access-Control-Allow-Origin": origin === "*" ? req.headers.get("origin") || "*" : origin,
-        "Access-Control-Allow-Methods": config.methods || "GET, POST, PUT, DELETE, OPTIONS",
-        "Access-Control-Allow-Headers": config.allowedHeaders || "Content-Type, Authorization, authorization, token",
-        "Access-Control-Expose-Headers": config.exposedHeaders || "Content-Range, X-Content-Range, Authorization, authorization, token",
-        "Access-Control-Max-Age": String(config.maxAge || 86400),
-        "Access-Control-Allow-Credentials": config.credentials || "true"
-    };
-}

package/dist/utils/dbFieldRules.d.ts

@@ -1,31 +0,0 @@
-/**
- * 数据库字段规则（供 checkTable / normalizeFieldDefinition / validator / syncTable 复用）
- *
- * 目标：
- * - 避免同一套规则在多个模块重复实现导致漂移
- * - 保持简单直观，不引入过度抽象
- */
-export declare function normalizeDbType(dbType: string): string;
-export declare function isStringDbType(dbType: string): boolean;
-export declare function isTextDbType(dbType: string): boolean;
-export declare function isIntDbType(dbType: string): boolean;
-export declare function isDecimalDbType(dbType: string): boolean;
-export declare function isFloatDbType(dbType: string): boolean;
-export declare function isJsonDbType(dbType: string): boolean;
-export declare function isEnumDbType(dbType: string): boolean;
-export declare function isNumericDbType(dbType: string): boolean;
-/**
- * 根据数据库类型推导默认 input 类型。
- */
-export declare function inferInputByDbType(dbType: string): string;
-/**
- * 归一化 type 与 input，input 为空时使用推导值。
- */
-export declare function normalizeTypeAndInput(type: string, input: string): {
-    type: string;
-    input: string;
-};
-/**
- * 解析枚举规则（a|b|c）为去重后的值列表（保持顺序）。
- */
-export declare function parseEnumRuleValues(enumInput: string): string[];

package/dist/utils/dbFieldRules.js

@@ -1,94 +0,0 @@
-/**
- * 数据库字段规则（供 checkTable / normalizeFieldDefinition / validator / syncTable 复用）
- *
- * 目标：
- * - 避免同一套规则在多个模块重复实现导致漂移
- * - 保持简单直观，不引入过度抽象
- */
-const STRING_DB_TYPES = new Set(["char", "varchar", "enum", "tinytext", "text", "mediumtext", "longtext"]);
-const TEXT_DB_TYPES = new Set(["tinytext", "text", "mediumtext", "longtext"]);
-const INT_DB_TYPES = new Set(["tinyint", "smallint", "mediumint", "int", "bigint"]);
-const DECIMAL_DB_TYPES = new Set(["decimal"]);
-const FLOAT_DB_TYPES = new Set(["float", "double"]);
-const JSON_DB_TYPES = new Set(["json"]);
-const ENUM_DB_TYPES = new Set(["enum"]);
-export function normalizeDbType(dbType) {
-    return String(dbType || "")
-        .trim()
-        .toLowerCase();
-}
-export function isStringDbType(dbType) {
-    return STRING_DB_TYPES.has(normalizeDbType(dbType));
-}
-export function isTextDbType(dbType) {
-    return TEXT_DB_TYPES.has(normalizeDbType(dbType));
-}
-export function isIntDbType(dbType) {
-    return INT_DB_TYPES.has(normalizeDbType(dbType));
-}
-export function isDecimalDbType(dbType) {
-    return DECIMAL_DB_TYPES.has(normalizeDbType(dbType));
-}
-export function isFloatDbType(dbType) {
-    return FLOAT_DB_TYPES.has(normalizeDbType(dbType));
-}
-export function isJsonDbType(dbType) {
-    return JSON_DB_TYPES.has(normalizeDbType(dbType));
-}
-export function isEnumDbType(dbType) {
-    return ENUM_DB_TYPES.has(normalizeDbType(dbType));
-}
-export function isNumericDbType(dbType) {
-    const normalized = normalizeDbType(dbType);
-    return INT_DB_TYPES.has(normalized) || DECIMAL_DB_TYPES.has(normalized) || FLOAT_DB_TYPES.has(normalized);
-}
-/**
- * 根据数据库类型推导默认 input 类型。
- */
-export function inferInputByDbType(dbType) {
-    const normalized = normalizeDbType(dbType);
-    if (INT_DB_TYPES.has(normalized)) {
-        return "integer";
-    }
-    if (DECIMAL_DB_TYPES.has(normalized) || FLOAT_DB_TYPES.has(normalized)) {
-        return "number";
-    }
-    if (STRING_DB_TYPES.has(normalized) || normalized === "datetime" || normalized === "timestamp") {
-        return "string";
-    }
-    if (normalized === "json") {
-        return "json";
-    }
-    return "string";
-}
-/**
- * 归一化 type 与 input，input 为空时使用推导值。
- */
-export function normalizeTypeAndInput(type, input) {
-    const rawType = String(type || "").trim();
-    const rawInput = String(input || "").trim();
-    return {
-        type: rawType,
-        input: rawInput || inferInputByDbType(rawType)
-    };
-}
-/**
- * 解析枚举规则（a|b|c）为去重后的值列表（保持顺序）。
- */
-export function parseEnumRuleValues(enumInput) {
-    const raw = String(enumInput || "").trim();
-    if (raw === "") {
-        return [];
-    }
-    const parts = raw
-        .split("|")
-        .map((x) => x.trim())
-        .filter((x) => x !== "");
-    const out = [];
-    for (const p of parts) {
-        if (!out.includes(p)) {
-            out.push(p);
-        }
-    }
-    return out;
-}

package/dist/utils/fieldClear.d.ts

@@ -1,11 +0,0 @@
-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/dist/utils/fieldClear.js

@@ -1,57 +0,0 @@
-// fieldClear 工具函数实现
-// 支持 pick/omit/keepValues/excludeValues，处理对象和数组
-function isObject(val) {
-    return val !== null && typeof val === "object" && !Array.isArray(val);
-}
-function isArray(val) {
-    return Array.isArray(val);
-}
-export function fieldClear(data, options = {}) {
-    const { pickKeys, omitKeys, keepValues, excludeValues, keepMap } = options;
-    const filterObj = (obj) => {
-        let result = {};
-        let keys = Object.keys(obj);
-        if (pickKeys && pickKeys.length) {
-            keys = keys.filter((k) => pickKeys.includes(k));
-        }
-        if (omitKeys && omitKeys.length) {
-            keys = keys.filter((k) => !omitKeys.includes(k));
-        }
-        for (const key of keys) {
-            const value = obj[key];
-            // 1. 优先检查 keepMap
-            if (keepMap && key in keepMap) {
-                if (Object.is(keepMap[key], value)) {
-                    result[key] = value;
-                    continue;
-                }
-            }
-            // 2. 检查 keepValues (只保留指定值)
-            if (keepValues && keepValues.length && !keepValues.includes(value)) {
-                continue;
-            }
-            // 3. 检查 excludeValues (排除指定值)
-            if (excludeValues && excludeValues.length && excludeValues.includes(value)) {
-                continue;
-            }
-            result[key] = value;
-        }
-        return result;
-    };
-    if (isArray(data)) {
-        return data
-            .map((item) => (isObject(item) ? filterObj(item) : item))
-            .filter((item) => {
-            if (isObject(item)) {
-                // 只保留有内容的对象
-                return Object.keys(item).length > 0;
-            }
-            // 原始值直接保留
-            return true;
-        });
-    }
-    if (isObject(data)) {
-        return filterObj(data);
-    }
-    return data;
-}

package/dist/utils/formatYmdHms.d.ts

@@ -1 +0,0 @@
-export declare function formatYmdHms(date: Date, format?: "date" | "time" | "dateTime"): string;

package/dist/utils/formatYmdHms.js

@@ -1,20 +0,0 @@
-export function formatYmdHms(date, format = "dateTime") {
-    const y = date.getFullYear();
-    const m = date.getMonth() + 1;
-    const d = date.getDate();
-    const h = date.getHours();
-    const mi = date.getMinutes();
-    const s = date.getSeconds();
-    const mm = m < 10 ? `0${m}` : String(m);
-    const dd = d < 10 ? `0${d}` : String(d);
-    const hh = h < 10 ? `0${h}` : String(h);
-    const mii = mi < 10 ? `0${mi}` : String(mi);
-    const ss = s < 10 ? `0${s}` : String(s);
-    if (format === "date") {
-        return `${y}-${mm}-${dd}`;
-    }
-    if (format === "time") {
-        return `${hh}:${mii}:${ss}`;
-    }
-    return `${y}-${mm}-${dd} ${hh}:${mii}:${ss}`;
-}

package/dist/utils/getClientIp.d.ts

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