befly 3.14.2 → 3.15.0

package/dist/utils/scanCoreBuiltins.js

@@ -13,9 +13,12 @@ import corePluginRedis from "../plugins/redis";
 import corePluginTool from "../plugins/tool";
 import { isPlainObject } from "./util";
 function toCoreBuiltinScanFileResult(type, item) {
-    const name = item.name;
+    const record = (isPlainObject(item) ? item : {});
+    const name = typeof record["name"] === "string" ? String(record["name"]) : "";
     const customKeys = isPlainObject(item) ? Object.keys(item) : [];
-    return {
+    const depsRaw = record["deps"];
+    const deps = Array.isArray(depsRaw) ? depsRaw.filter((x) => typeof x === "string") : [];
+    const out = {
         source: "core",
         type: type,
         sourceName: "核心",
@@ -27,11 +30,12 @@ function toCoreBuiltinScanFileResult(type, item) {
         fileBaseName: name,
         fileDir: "(builtin)",
         name: name,
-        enable: item ? item.enable : undefined,
-        deps: Array.isArray(item && item.deps) ? item.deps : [],
-        handler: item ? item.handler : null,
+        enable: record["enable"],
+        deps: deps,
+        handler: record["handler"] ?? null,
         customKeys: customKeys
     };
+    return out;
 }
 export function scanCoreBuiltinPlugins() {
     const plugins = [];

package/dist/utils/scanFiles.d.ts

@@ -18,10 +18,10 @@ export interface ScanFileResultBase {
 }
 export type ScanFileResult = (ScanFileResultBase & {
     type: "table";
-    content: any;
+    content: Record<string, unknown>;
 }) | (ScanFileResultBase & {
     type: Exclude<ScanFileType, "table">;
-} & Record<string, any>);
+} & Record<string, unknown>);
 /**
  * 扫描指定目录下的文件
  * @param dir 目录路径

package/dist/utils/scanFiles.js

@@ -97,7 +97,7 @@ export async function scanFiles(dir, source, type, pattern) {
                 customKeys: isPlainObject(content) ? Object.keys(content) : []
             };
             if (type === "table") {
-                base["content"] = content;
+                base["content"] = isPlainObject(content) ? content : {};
                 results.push(base);
                 continue;
             }

package/dist/utils/sortModules.js

@@ -18,7 +18,14 @@ export function sortModules(items, options = {}) {
             }
             return camelCase(item.fileName);
         });
-    const getDeps = options.getDeps || ((item) => item.deps);
+    const getDeps = options.getDeps ||
+        ((item) => {
+            const deps = item.deps;
+            if (!Array.isArray(deps)) {
+                return [];
+            }
+            return deps.filter((x) => typeof x === "string");
+        });
     const result = [];
     const visited = new Set();
     const visiting = new Set();

package/dist/utils/sqlParams.d.ts

@@ -0,0 +1,10 @@
+import type { SqlValue } from "../types/common";
+export declare function isSqlValue(value: unknown): value is SqlValue;
+/**
+ * 将外部输入参数（unknown[]）转换为 DbHelper/sqlInfo 可接受的 SqlValue[]。
+ *
+ * 规则：
+ * - bigint -> string
+ * - 其他不可序列化值 -> String(value)
+ */
+export declare function toSqlParams(params: unknown[] | undefined): SqlValue[];

package/dist/utils/sqlParams.js

@@ -0,0 +1,78 @@
+function isJsonPrimitive(value) {
+    if (value === null)
+        return true;
+    return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function isJsonObject(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    if (value instanceof Date)
+        return false;
+    if (Array.isArray(value))
+        return false;
+    return true;
+}
+function isJsonValue(value) {
+    if (isJsonPrimitive(value))
+        return true;
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            if (!isJsonValue(item))
+                return false;
+        }
+        return true;
+    }
+    if (isJsonObject(value)) {
+        for (const v of Object.values(value)) {
+            if (v === undefined)
+                continue;
+            if (!isJsonValue(v))
+                return false;
+        }
+        return true;
+    }
+    return false;
+}
+export function isSqlValue(value) {
+    if (value instanceof Date)
+        return true;
+    return isJsonValue(value);
+}
+/**
+ * 将外部输入参数（unknown[]）转换为 DbHelper/sqlInfo 可接受的 SqlValue[]。
+ *
+ * 规则：
+ * - bigint -> string
+ * - 其他不可序列化值 -> String(value)
+ */
+export function toSqlParams(params) {
+    if (!Array.isArray(params)) {
+        return [];
+    }
+    const out = [];
+    for (const value of params) {
+        if (value === null) {
+            out.push(null);
+            continue;
+        }
+        if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            out.push(value);
+            continue;
+        }
+        if (typeof value === "bigint") {
+            out.push(String(value));
+            continue;
+        }
+        if (value instanceof Date) {
+            out.push(value);
+            continue;
+        }
+        if (isJsonValue(value)) {
+            // JsonObject / JsonValue[] 都属于 SqlValue 允许的范围
+            out.push(value);
+            continue;
+        }
+        out.push(String(value));
+    }
+    return out;
+}

package/dist/utils/sqlResult.d.ts

@@ -0,0 +1,5 @@
+export type SqlRunResult = {
+    changes?: number | bigint;
+    lastInsertRowid?: number | bigint;
+};
+export declare function toNumberFromSql(value: unknown): number;

package/dist/utils/sqlResult.js

@@ -0,0 +1,7 @@
+export function toNumberFromSql(value) {
+    if (typeof value === "number")
+        return value;
+    if (typeof value === "bigint")
+        return Number(value);
+    return 0;
+}

package/dist/utils/util.d.ts

@@ -3,11 +3,11 @@
  * - 按项目规范：避免零散小文件噪音；实现集中在本文件，而不是做 re-export 聚合。
  * - 仅在 packages/core 内部使用；core 对外不承诺这些路径导出。
  */
-export declare function isPlainObject(value: unknown): value is Record<string, any>;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
 export type ValueTypeTag = "undefined" | "null" | "string" | "number" | "boolean" | "bigint" | "symbol" | "function" | "array" | "object";
 export declare function getTypeTag(value: unknown): ValueTypeTag;
 export declare function escapeRegExp(input: string): string;
-export declare function normalizePositiveInt(value: any, fallback: number, min: number, max: number): number;
+export declare function normalizePositiveInt(value: unknown, fallback: number, min: number, max: number): number;
 /**
  * 激进空值判断（项目约定）：
  * - null/undefined => empty
@@ -20,7 +20,7 @@ export declare function normalizePositiveInt(value: any, fallback: number, min:
  * - 其他类型 => false
  */
 export declare function isEmpty(value: unknown): boolean;
-export declare function forOwn(obj: unknown, iteratee: (value: any, key: string) => void): void;
+export declare function forOwn(obj: unknown, iteratee: (value: unknown, key: string) => void): void;
 /**
  * 把字符串转为小驼峰。
  * - 主要用于文件名/目录名（例如 my_plugin / my-plugin / my plugin）。
@@ -65,17 +65,18 @@ export declare const keysToSnake: <T = any>(obj: Record<string, any>) => T;
  */
 export declare const arrayKeysToCamel: <T = any>(arr: Record<string, any>[]) => T[];
 export declare function getByPath(obj: unknown, path: string): unknown;
-export declare function setByPath(target: Record<string, any>, path: string, value: unknown): void;
+export declare function setByPath(target: Record<string, unknown>, path: string, value: unknown): void;
 /**
  * 返回一个移除指定 key 的浅拷贝。
  * - 仅处理 plain object；其他类型返回空对象，避免日志场景抛错。
  */
-export declare function omit<T extends Record<string, any>>(obj: unknown, keys: string[]): Partial<T>;
+export declare function omit<T extends Record<string, unknown>>(obj: unknown, keys: string[]): Partial<T>;
 /**
  * 挑选指定字段
  */
-export declare const pickFields: <T extends Record<string, any>>(obj: T, keys: string[]) => Partial<T>;
+export declare const pickFields: (obj: unknown, keys: readonly string[]) => Record<string, unknown>;
 export declare function keyBy<T>(items: T[], getKey: (item: T) => string): Record<string, T>;
+export declare function keyBy(items: unknown, getKey: unknown): Record<string, unknown>;
 /**
  * 生成短 ID
  * 由时间戳（base36）+ 随机字符组成，约 13 位

package/dist/utils/util.js

@@ -90,8 +90,9 @@ export function forOwn(obj, iteratee) {
     if (!isPlainObject(obj)) {
         return;
     }
-    for (const key of Object.keys(obj)) {
-        iteratee(obj[key], key);
+    const record = obj;
+    for (const key of Object.keys(record)) {
+        iteratee(record[key], key);
     }
 }
 function toWordParts(input) {
@@ -216,7 +217,8 @@ export function getByPath(obj, path) {
         if (typeof cur !== "object") {
             return undefined;
         }
-        cur = cur[part];
+        const record = cur;
+        cur = record[part];
     }
     return cur;
 }
@@ -271,10 +273,11 @@ export const pickFields = (obj, keys) => {
     if (!obj || (!isPlainObject(obj) && !Array.isArray(obj))) {
         return {};
     }
+    const record = obj;
     const result = {};
     for (const key of keys) {
-        if (key in obj) {
-            result[key] = obj[key];
+        if (key in record) {
+            result[key] = record[key];
         }
     }
     return result;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "befly",
-    "version": "3.14.2",
-    "gitHead": "e30f1dd7cb51e6560832110c37708ef0a6853749",
+    "version": "3.15.0",
+    "gitHead": "3a9dc64d2eb69e646f4fd6eebd5d8dbe6516cb69",
     "private": false,
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "keywords": [