@pangza/log 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,3 @@
-# Temporary Holding Version
+# @pangza/log
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+操作审计日志

package/dist/decorators.d.ts

@@ -0,0 +1,7 @@
+import type { LogRecordOption } from "./types";
+/**
+ * 方法装饰器：为接口声明操作日志。
+ * 推荐从 `@pangza/core/Application` 导入同名装饰器。
+ */
+export declare function LogDecorator(options?: LogRecordOption): MethodDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,eAAe,CAQ3E"}

package/dist/decorators.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogDecorator = LogDecorator;
+const metadata_1 = require("@pangza/core/Application/metadata");
+/**
+ * 方法装饰器：为接口声明操作日志。
+ * 推荐从 `@pangza/core/Application` 导入同名装饰器。
+ */
+function LogDecorator(options = {}) {
+    return (target, propertyKey) => {
+        (0, metadata_1.mergeMethodLog)(target.constructor, String(propertyKey), options);
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":";;AAOA,oCAQC;AAfD,gEAAmE;AAGnE;;;GAGG;AACH,SAAgB,YAAY,CAAC,UAA2B,EAAE;IACxD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,IAAA,yBAAc,EACX,MAAiB,CAAC,WAAW,EAC9B,MAAM,CAAC,WAAW,CAAC,EACnB,OAAO,CACR,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/flag.d.ts

@@ -0,0 +1,2 @@
+export { LOG_MIDDLEWARE_FLAG } from "@pangza/core/moduleFlags";
+//# sourceMappingURL=flag.d.ts.map

package/dist/flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag.d.ts","sourceRoot":"","sources":["../src/flag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/flag.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_MIDDLEWARE_FLAG = void 0;
+var moduleFlags_1 = require("@pangza/core/moduleFlags");
+Object.defineProperty(exports, "LOG_MIDDLEWARE_FLAG", { enumerable: true, get: function () { return moduleFlags_1.LOG_MIDDLEWARE_FLAG; } });
+//# sourceMappingURL=flag.js.map

package/dist/flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag.js","sourceRoot":"","sources":["../src/flag.ts"],"names":[],"mappings":";;;AAAA,wDAA+D;AAAtD,kHAAA,mBAAmB,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { NextFunction, Request, Response } from "express";
+import type { LogModuleOptions } from "./types";
+/**
+ * Log 模块工厂（对齐 Auth）。
+ * 通过 Application.registry(Log()) 注册后，
+ * 路由 option.log / @Log 才会真正落库。
+ */
+export default function Log(options?: LogModuleOptions): (_req: Request, _res: Response, next: NextFunction) => void;
+export { LOG_MIDDLEWARE_FLAG } from "./flag";
+export { configureLog, recordOperationLog, isLogRegistered, getLogOptions, } from "./recorder";
+export { getClientIp, resolveIpAddress, normalizeIp, isInternalIp, } from "./ip";
+export { BusinessType, OperType } from "./types";
+export type { LogModuleOptions, LogRecordOption, BusinessTypeValue, OperTypeValue, OperationLogRecord, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,OAAO,GAAE,gBAAqB,UAG9B,OAAO,QAAQ,QAAQ,QAAQ,YAAY,UAUtE;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,GACb,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperType = exports.BusinessType = exports.isInternalIp = exports.normalizeIp = exports.resolveIpAddress = exports.getClientIp = exports.getLogOptions = exports.isLogRegistered = exports.recordOperationLog = exports.configureLog = exports.LOG_MIDDLEWARE_FLAG = void 0;
+exports.default = Log;
+const recorder_1 = require("./recorder");
+const flag_1 = require("./flag");
+/**
+ * Log 模块工厂（对齐 Auth）。
+ * 通过 Application.registry(Log()) 注册后，
+ * 路由 option.log / @Log 才会真正落库。
+ */
+function Log(options = {}) {
+    (0, recorder_1.configureLog)(options);
+    const middleware = (_req, _res, next) => {
+        next();
+    };
+    Object.defineProperty(middleware, flag_1.LOG_MIDDLEWARE_FLAG, {
+        value: true,
+        enumerable: false,
+    });
+    return middleware;
+}
+var flag_2 = require("./flag");
+Object.defineProperty(exports, "LOG_MIDDLEWARE_FLAG", { enumerable: true, get: function () { return flag_2.LOG_MIDDLEWARE_FLAG; } });
+var recorder_2 = require("./recorder");
+Object.defineProperty(exports, "configureLog", { enumerable: true, get: function () { return recorder_2.configureLog; } });
+Object.defineProperty(exports, "recordOperationLog", { enumerable: true, get: function () { return recorder_2.recordOperationLog; } });
+Object.defineProperty(exports, "isLogRegistered", { enumerable: true, get: function () { return recorder_2.isLogRegistered; } });
+Object.defineProperty(exports, "getLogOptions", { enumerable: true, get: function () { return recorder_2.getLogOptions; } });
+var ip_1 = require("./ip");
+Object.defineProperty(exports, "getClientIp", { enumerable: true, get: function () { return ip_1.getClientIp; } });
+Object.defineProperty(exports, "resolveIpAddress", { enumerable: true, get: function () { return ip_1.resolveIpAddress; } });
+Object.defineProperty(exports, "normalizeIp", { enumerable: true, get: function () { return ip_1.normalizeIp; } });
+Object.defineProperty(exports, "isInternalIp", { enumerable: true, get: function () { return ip_1.isInternalIp; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "BusinessType", { enumerable: true, get: function () { return types_1.BusinessType; } });
+Object.defineProperty(exports, "OperType", { enumerable: true, get: function () { return types_1.OperType; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAUA,sBAaC;AAtBD,yCAA0C;AAC1C,iCAA6C;AAG7C;;;;GAIG;AACH,SAAwB,GAAG,CAAC,UAA4B,EAAE;IACxD,IAAA,uBAAY,EAAC,OAAO,CAAC,CAAC;IAEtB,MAAM,UAAU,GAAG,CAAC,IAAa,EAAE,IAAc,EAAE,IAAkB,EAAE,EAAE;QACvE,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;IAEF,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,0BAAmB,EAAE;QACrD,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,+BAA6C;AAApC,2GAAA,mBAAmB,OAAA;AAC5B,uCAKoB;AAJlB,wGAAA,YAAY,OAAA;AACZ,8GAAA,kBAAkB,OAAA;AAClB,2GAAA,eAAe,OAAA;AACf,yGAAA,aAAa,OAAA;AAEf,2BAKc;AAJZ,iGAAA,WAAW,OAAA;AACX,sGAAA,gBAAgB,OAAA;AAChB,iGAAA,WAAW,OAAA;AACX,kGAAA,YAAY,OAAA;AAEd,iCAAiD;AAAxC,qGAAA,YAAY,OAAA;AAAE,iGAAA,QAAQ,OAAA"}

package/dist/ip.d.ts

@@ -0,0 +1,23 @@
+import type { Request } from "express";
+/** 是否内网 / 本机 */
+export declare function isInternalIp(ip: string): boolean;
+/** 规范化：去掉 IPv6 映射前缀、方括号 */
+export declare function normalizeIp(ip: string): string;
+/**
+ * 从请求解析客户端 IP。
+ * - `server.trustProxy: false`（默认）：只用直连 socket / Express req.ip，忽略转发头，防伪造绕过限流。
+ * - `server.trustProxy: true`：优先读 X-Forwarded-For / X-Real-IP 等（须前面有可信反代）。
+ * @param options.trustProxy 覆盖全局配置（测试用）
+ */
+export declare function getClientIp(req: Request, options?: {
+    trustProxy?: boolean;
+}): string;
+export interface IpRegionResult {
+    country?: string;
+    province?: string;
+    city?: string;
+    isp?: string;
+}
+/** 离线解析 IP 归属地（内网返回「内网IP」） */
+export declare function resolveIpAddress(ip: string): string;
+//# sourceMappingURL=ip.d.ts.map

package/dist/ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.d.ts","sourceRoot":"","sources":["../src/ip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAiBvC,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAahD;AAED,2BAA2B;AAC3B,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAe9C;AA6BD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,MAAM,CAeR;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,8BAA8B;AAC9B,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAqBnD"}

package/dist/ip.js

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInternalIp = isInternalIp;
+exports.normalizeIp = normalizeIp;
+exports.getClientIp = getClientIp;
+exports.resolveIpAddress = resolveIpAddress;
+const ip2region_1 = __importDefault(require("ip2region"));
+const config_1 = require("@pangza/core/config");
+const Logger_1 = require("@pangza/core/Logger");
+const log = (0, Logger_1.getLogger)("OperLog.IP");
+let searcher = null;
+function getSearcher() {
+    if (!searcher) {
+        // 包内自带库；关闭 IPv6 降低内存
+        searcher = new ip2region_1.default({ disableIpv6: true });
+    }
+    return searcher;
+}
+/** 是否内网 / 本机 */
+function isInternalIp(ip) {
+    const v = normalizeIp(ip);
+    if (!v)
+        return true;
+    if (v === "127.0.0.1" || v === "localhost" || v === "0.0.0.0")
+        return true;
+    if (v.startsWith("10."))
+        return true;
+    if (v.startsWith("192.168."))
+        return true;
+    if (v.startsWith("169.254."))
+        return true;
+    const m = v.match(/^172\.(\d+)\./);
+    if (m) {
+        const n = Number(m[1]);
+        if (n >= 16 && n <= 31)
+            return true;
+    }
+    return false;
+}
+/** 规范化：去掉 IPv6 映射前缀、方括号 */
+function normalizeIp(ip) {
+    let v = String(ip || "").trim();
+    if (!v)
+        return "";
+    if (v.startsWith("[") && v.endsWith("]")) {
+        v = v.slice(1, -1);
+    }
+    if (v.startsWith("::ffff:")) {
+        v = v.slice(7);
+    }
+    if (v === "::1")
+        return "127.0.0.1";
+    // 去掉端口（极少见）
+    if (/^\d+\.\d+\.\d+\.\d+:\d+$/.test(v)) {
+        v = v.split(":")[0];
+    }
+    return v;
+}
+function pickFromHeader(raw) {
+    if (typeof raw === "string" && raw.trim()) {
+        // x-forwarded-for: client, proxy1, proxy2 — 取最左侧客户端
+        const first = raw.split(",")[0].trim();
+        return normalizeIp(first);
+    }
+    if (Array.isArray(raw) && raw.length > 0) {
+        return normalizeIp(String(raw[0]));
+    }
+    return "";
+}
+function socketIp(req) {
+    const candidates = [
+        req.ip,
+        req.socket?.remoteAddress,
+        req.connection?.remoteAddress,
+    ];
+    for (const raw of candidates) {
+        if (typeof raw === "string" && raw.trim()) {
+            const ip = normalizeIp(raw);
+            if (ip)
+                return ip;
+        }
+    }
+    return "";
+}
+/**
+ * 从请求解析客户端 IP。
+ * - `server.trustProxy: false`（默认）：只用直连 socket / Express req.ip，忽略转发头，防伪造绕过限流。
+ * - `server.trustProxy: true`：优先读 X-Forwarded-For / X-Real-IP 等（须前面有可信反代）。
+ * @param options.trustProxy 覆盖全局配置（测试用）
+ */
+function getClientIp(req, options) {
+    const useProxy = options?.trustProxy ?? config_1.trustProxy;
+    if (useProxy) {
+        const forwarded = [
+            req.headers["x-forwarded-for"],
+            req.headers["x-real-ip"],
+            req.headers["cf-connecting-ip"],
+            req.headers["x-client-ip"],
+        ];
+        for (const raw of forwarded) {
+            const ip = pickFromHeader(raw);
+            if (ip)
+                return ip;
+        }
+    }
+    return socketIp(req);
+}
+/** 离线解析 IP 归属地（内网返回「内网IP」） */
+function resolveIpAddress(ip) {
+    const v = normalizeIp(ip);
+    if (!v)
+        return "";
+    if (isInternalIp(v))
+        return "内网IP";
+    try {
+        const res = getSearcher().search(v);
+        if (!res)
+            return "未知";
+        const parts = [res.country, res.province, res.city, res.isp]
+            .map((s) => String(s || "").trim())
+            .filter((s) => s && s !== "0");
+        // 去重：省市区可能重复
+        const uniq = [];
+        for (const p of parts) {
+            if (!uniq.includes(p))
+                uniq.push(p);
+        }
+        return uniq.join(" ") || "未知";
+    }
+    catch (e) {
+        log.warn({ err: e, ip: v }, "IP 归属地解析失败");
+        return "未知";
+    }
+}
+//# sourceMappingURL=ip.js.map

package/dist/ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.js","sourceRoot":"","sources":["../src/ip.ts"],"names":[],"mappings":"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"}

package/dist/recorder.d.ts

@@ -0,0 +1,26 @@
+import type { Request } from "express";
+import type { LogModuleOptions, LogRecordOption } from "./types";
+export declare function configureLog(options?: LogModuleOptions): void;
+export declare function isLogRegistered(): boolean;
+export declare function getLogOptions(): Required<Pick<LogModuleOptions, "enabled" | "silent">> & LogModuleOptions;
+export interface RecordLogContext {
+    req: Request;
+    option: LogRecordOption;
+    result?: unknown;
+    error?: unknown;
+    statusCode: number | string;
+    startTime: number;
+    controllerName?: string;
+    /**
+     * 请求结束前同步抓取的客户端 IP（避免 setImmediate 后 socket 已释放导致为空）。
+     * 不传则回退从 req 再解析一次。
+     */
+    clientIp?: string;
+    userAgent?: string;
+}
+/**
+ * 异步写入操作日志（失败不影响业务）。
+ * 持久化由 Log({ writer }) 注入，framework 不依赖 business Service。
+ */
+export declare function recordOperationLog(ctx: RecordLogContext): Promise<void>;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIvC,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEhB,MAAM,SAAS,CAAC;AAsBjB,wBAAgB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAWjE;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAgB,aAAa,8EAE5B;AAkCD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4E7E"}

package/dist/recorder.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureLog = configureLog;
+exports.isLogRegistered = isLogRegistered;
+exports.getLogOptions = getLogOptions;
+exports.recordOperationLog = recordOperationLog;
+const auth_1 = require("@pangza/auth");
+const Logger_1 = require("@pangza/core/Logger");
+const ip_1 = require("./ip");
+const types_1 = require("./types");
+const log = (0, Logger_1.getLogger)("OperLog");
+const DEFAULT_EXCLUDE = [
+    "password",
+    "oldPassword",
+    "newPassword",
+    "confirmPassword",
+    "attachments",
+];
+let moduleOptions = {
+    enabled: true,
+    silent: false,
+    excludeParamNames: [],
+};
+let logRegistered = false;
+function configureLog(options = {}) {
+    moduleOptions = {
+        ...moduleOptions,
+        ...options,
+        enabled: options.enabled ?? moduleOptions.enabled,
+        silent: options.silent ?? moduleOptions.silent,
+        excludeParamNames: options.excludeParamNames ?? moduleOptions.excludeParamNames,
+        writer: options.writer ?? moduleOptions.writer,
+    };
+    logRegistered = true;
+}
+function isLogRegistered() {
+    return logRegistered;
+}
+function getLogOptions() {
+    return moduleOptions;
+}
+function shouldRecord(option) {
+    if (!logRegistered || !moduleOptions.enabled)
+        return false;
+    if (!option || option.ignore)
+        return false;
+    return true;
+}
+function omitSensitive(value, exclude) {
+    if (value == null)
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((item) => omitSensitive(item, exclude));
+    }
+    if (typeof value === "object") {
+        const obj = value;
+        const next = {};
+        for (const [k, v] of Object.entries(obj)) {
+            if (exclude.includes(k))
+                continue;
+            next[k] = omitSensitive(v, exclude);
+        }
+        return next;
+    }
+    return value;
+}
+function safeJson(value, exclude, max = 2000) {
+    try {
+        const text = JSON.stringify(omitSensitive(value, exclude) ?? null);
+        return text.length > max ? text.slice(0, max) : text;
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * 异步写入操作日志（失败不影响业务）。
+ * 持久化由 Log({ writer }) 注入，framework 不依赖 business Service。
+ */
+async function recordOperationLog(ctx) {
+    if (!shouldRecord(ctx.option))
+        return;
+    const writer = moduleOptions.writer;
+    if (!writer) {
+        // 未注入 writer（如删除 business）时静默跳过，便于纯净启动
+        return;
+    }
+    try {
+        const exclude = [
+            ...DEFAULT_EXCLUDE,
+            ...(moduleOptions.excludeParamNames ?? []),
+            ...(ctx.option.excludeParamNames ?? []),
+        ];
+        let username = "";
+        let avatar = "";
+        try {
+            const session = await auth_1.AuthUtil.getSession();
+            if (session) {
+                username = session.username || String(session.loginId ?? "");
+                avatar = session.avatar || "";
+            }
+        }
+        catch {
+            // ignore
+        }
+        const params = ctx.req.method === "GET"
+            ? safeJson(ctx.req.query, exclude)
+            : safeJson(ctx.req.body, exclude);
+        let errorMessage = "";
+        if (ctx.error) {
+            errorMessage =
+                ctx.error instanceof Error
+                    ? ctx.error.message || ctx.error.name
+                    : String(ctx.error);
+            if (errorMessage.length > 2000)
+                errorMessage = errorMessage.slice(0, 2000);
+        }
+        const ip = ctx.clientIp || (0, ip_1.getClientIp)(ctx.req);
+        const address = (0, ip_1.resolveIpAddress)(ip);
+        const userAgent = (ctx.userAgent ??
+            String(ctx.req.headers["user-agent"] || "")).slice(0, 255);
+        const row = {
+            title: ctx.option.title || "",
+            username,
+            avatar,
+            business: String(ctx.option.business ?? types_1.BusinessType.OTHER),
+            oper: String(ctx.option.oper ?? types_1.OperType.PC),
+            params,
+            response: safeJson(ctx.result, exclude),
+            methodName: ctx.req.method,
+            controllerName: ctx.controllerName || "",
+            status: String(ctx.statusCode),
+            timeLong: Math.max(0, Date.now() - ctx.startTime),
+            ip,
+            address,
+            userAgent,
+            url: String(ctx.req.originalUrl || ctx.req.url || "").slice(0, 255),
+            errorMessage,
+            deleteFlag: 0,
+            createTime: new Date(),
+        };
+        await writer(row);
+    }
+    catch (e) {
+        if (!moduleOptions.silent) {
+            log.error({ err: e }, "记录操作日志失败");
+        }
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 业务类型（入库为字符串序数）
+ * CREATE=0 … LOGIN=8 … OTHER=9
+ */
+export declare const BusinessType: {
+    readonly CREATE: 0;
+    readonly UPDATE: 1;
+    readonly DELETE: 2;
+    readonly READ: 3;
+    readonly LIST: 4;
+    readonly UPLOAD: 5;
+    readonly EXPORT: 6;
+    readonly IMPORT: 7;
+    readonly LOGIN: 8;
+    readonly OTHER: 9;
+};
+export type BusinessTypeValue = (typeof BusinessType)[keyof typeof BusinessType];
+/** 操作端 */
+export declare const OperType: {
+    readonly MOBILE: 0;
+    readonly PC: 1;
+    readonly OTHER: 2;
+};
+export type OperTypeValue = (typeof OperType)[keyof typeof OperType];
+/** 路由 / 装饰器上的日志配置 */
+export interface LogRecordOption {
+    /** 操作标题 */
+    title?: string;
+    /** 业务类型序数，默认 OTHER */
+    business?: BusinessTypeValue | number;
+    /** 操作端序数，默认 PC */
+    oper?: OperTypeValue | number;
+    /** 额外排除的参数名（密码等默认已排除） */
+    excludeParamNames?: string[];
+    /** 为 true 时本接口不记日志 */
+    ignore?: boolean;
+}
+/** Log() 工厂全局配置 */
+export interface LogModuleOptions {
+    /** 是否启用（默认 true） */
+    enabled?: boolean;
+    /** 默认排除字段 */
+    excludeParamNames?: string[];
+    /** 异步写入失败是否打印 */
+    silent?: boolean;
+    /**
+     * 业务侧注入的落库实现（framework 不依赖具体 Service）。
+     * 未配置时只组装日志字段，不写库。
+     */
+    writer?: (row: OperationLogRecord) => void | Promise<void>;
+}
+/** 操作日志落库行（由 framework 组装，business 负责持久化） */
+export interface OperationLogRecord {
+    title: string;
+    username: string;
+    avatar: string;
+    business: string;
+    oper: string;
+    params: string;
+    response: string;
+    methodName: string;
+    controllerName: string;
+    status: string;
+    timeLong: number;
+    ip: string;
+    address: string;
+    userAgent: string;
+    url: string;
+    errorMessage: string;
+    deleteFlag: number;
+    createTime: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;CAWf,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAEjF,UAAU;AACV,eAAO,MAAM,QAAQ;;;;CAIX,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAErE,qBAAqB;AACrB,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IACtC,kBAAkB;IAClB,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IAC9B,yBAAyB;IACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,mBAAmB;AACnB,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa;IACb,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperType = exports.BusinessType = void 0;
+/**
+ * 业务类型（入库为字符串序数）
+ * CREATE=0 … LOGIN=8 … OTHER=9
+ */
+exports.BusinessType = {
+    CREATE: 0,
+    UPDATE: 1,
+    DELETE: 2,
+    READ: 3,
+    LIST: 4,
+    UPLOAD: 5,
+    EXPORT: 6,
+    IMPORT: 7,
+    LOGIN: 8,
+    OTHER: 9,
+};
+/** 操作端 */
+exports.OperType = {
+    MOBILE: 0,
+    PC: 1,
+    OTHER: 2,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,YAAY,GAAG;IAC1B,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;CACA,CAAC;AAIX,UAAU;AACG,QAAA,QAAQ,GAAG;IACtB,MAAM,EAAE,CAAC;IACT,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;CACA,CAAC"}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@pangza/log",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "操作审计日志",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "require": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  },
+  "dependencies": {
+    "@pangza/core": "^1.0.1",
+    "ip2region": "^2.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}