@jiangtaste/baiwei-sdk 1.0.0

package/dist/utils/logger.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maskSensitive = maskSensitive;
+exports.createLogger = createLogger;
+const DEFAULT_SENSITIVE_KEYS = [
+    "token",
+    "password",
+    "pwd",
+    "authorization",
+    "cookie",
+    "secret",
+    "apikey",
+    "api_key",
+];
+/**
+ * 对日志中的敏感字段做浅/深层脱敏。
+ * 兼容普通对象和 JSON 字符串两种输入。
+ */
+function maskSensitive(value, keys = DEFAULT_SENSITIVE_KEYS) {
+    if (value === null || value === undefined)
+        return value;
+    // 1) value 是 JSON string：解析 -> 脱敏 -> 再 stringify 回 string
+    if (typeof value === "string") {
+        const s = value.trim();
+        try {
+            const parsed = JSON.parse(s);
+            const masked = maskSensitive(parsed, keys);
+            return JSON.stringify(masked);
+        }
+        catch {
+            // 解析失败就当普通字符串，不处理
+            return value;
+        }
+    }
+    // 2) 基础类型不处理
+    const t = typeof value;
+    if (t === "number" || t === "boolean" || t === "bigint")
+        return value;
+    // 3) 对象/数组：走 replacer 脱敏（注意 replacer 的 v 也是 unknown）
+    try {
+        const json = JSON.stringify(value, (k, v) => {
+            const key = String(k ?? "").toLowerCase();
+            if (keys.some((x) => key.includes(x)))
+                return "***";
+            return v; // ✅ replacer 必须返回 any-ish（JSON.stringify 的签名如此）
+        });
+        return JSON.parse(json);
+    }
+    catch {
+        return value;
+    }
+}
+/**
+ * 统一拿到一个可用的 logger：
+ * - 默认使用 console
+ * - 返回的 logger 保证 debug/info/warn/error 都是函数
+ * - 默认：debug 不脱敏，info/warn/error 脱敏
+ * - 当不传入 logger 时：会在日志前自动加时间戳与可选前缀
+ */
+function createLogger(input, opts = {}) {
+    const base = input ?? console;
+    const maskKeys = opts.maskKeys ?? DEFAULT_SENSITIVE_KEYS;
+    const maskDebug = opts.maskDebug ?? false;
+    // 当用户不传 logger 时，默认开启时间戳；传了 logger 则默认不强加格式（除非显式打开）
+    const shouldDecorate = input === undefined;
+    const withTimestamp = opts.withTimestamp ?? shouldDecorate;
+    const prefix = opts.prefix?.trim();
+    const formatTime = opts.formatTime ?? ((d) => d.toISOString());
+    const buildHeader = () => {
+        const parts = [];
+        if (withTimestamp)
+            parts.push(formatTime(new Date()));
+        if (prefix)
+            parts.push(prefix);
+        if (parts.length === 0)
+            return "";
+        return `[${parts.join("][")}]`;
+    };
+    const decorateArgs = (args) => {
+        const header = buildHeader();
+        if (!header)
+            return args;
+        // 如果第一个参数是字符串，拼接更自然；否则把 header 作为第一个参数插入
+        if (typeof args[0] === "string") {
+            const [first, ...rest] = args;
+            return [`${header} ${first}`, ...rest];
+        }
+        return [header, ...args];
+    };
+    // 单个日志方法抛错时不影响业务主流程。
+    const safeFn = (fn) => (...args) => {
+        try {
+            (fn ?? console.log)(...args);
+        }
+        catch {
+            // ignore
+        }
+    };
+    const mapArgs = (args, shouldMask) => {
+        const decorated = shouldDecorate ? decorateArgs(args) : args;
+        if (!shouldMask)
+            return decorated;
+        return decorated.map((a) => maskSensitive(a, maskKeys));
+    };
+    const debug = safeFn(base.debug ?? console.debug);
+    const info = safeFn(base.info ?? console.info);
+    const warn = safeFn(base.warn ?? console.warn);
+    const error = safeFn(base.error ?? console.error);
+    return {
+        debug: (...args) => debug(...mapArgs(args, maskDebug)),
+        info: (...args) => info(...mapArgs(args, true)),
+        warn: (...args) => warn(...mapArgs(args, true)),
+        error: (...args) => error(...mapArgs(args, true)),
+    };
+}

package/dist/utils/time.d.ts

@@ -0,0 +1,2 @@
+/** 把时间格式化为 `YYYY-MM-DD HH:mm:ss`，便于日志或调试输出。 */
+export declare function formatTime(date?: Date): string;

package/dist/utils/time.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTime = formatTime;
+/** 把时间格式化为 `YYYY-MM-DD HH:mm:ss`，便于日志或调试输出。 */
+function formatTime(date = new Date()) {
+    const pad = (n) => n.toString().padStart(2, "0");
+    const y = date.getFullYear();
+    const m = pad(date.getMonth() + 1);
+    const d = pad(date.getDate());
+    const hh = pad(date.getHours());
+    const mm = pad(date.getMinutes());
+    const ss = pad(date.getSeconds());
+    return `${y}-${m}-${d} ${hh}:${mm}:${ss}`;
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@jiangtaste/baiwei-sdk",
+  "version": "1.0.0",
+  "description": "面向百微智能网关的 SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "dev": "ts-node -P examples/tsconfig.json examples/debug.ts",
+    "debug": "ts-node -P examples/tsconfig.json examples/debug.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "baiwei",
+    "iot",
+    "gateway",
+    "tcp",
+    "smart-home",
+    "zigbee"
+  ],
+  "author": "jiangtaste",
+  "license": "MIT",
+  "type": "commonjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}