autosnippet 3.2.9 → 3.2.11

package/dist/lib/http/utils/sse-sessions.js

@@ -0,0 +1,111 @@
+/**
+ * SSE Session Manager — 基于 EventSource 的流式会话管理
+ *
+ * 架构:
+ *   POST /chat/stream → 创建 session + 后台执行 AgentRuntime → 返回 { sessionId }
+ *   GET  /chat/events/:sessionId → EventSource 端点, 回放缓冲事件 + 实时推送
+ *
+ * 为什么不用 fetch + ReadableStream:
+ *   Chrome/Safari 的 fetch() streaming 会缓冲初始响应体（~1-4KB），导致小体积
+ *   SSE 事件滞留在缓冲区中不被交付给 ReadableStream reader。
+ *   原生 EventSource API 是浏览器专门为 SSE 优化的消费者，不受此限制。
+ *
+ * @module lib/http/utils/sse-sessions
+ */
+import { EventEmitter } from 'node:events';
+/** @type {Map<string, StreamSession>} */
+const _sessions = new Map();
+/** Session 自动清理 TTL (5 分钟) */
+const SESSION_TTL = 5 * 60 * 1000;
+/** 完成后保留时间 (60 秒, 供客户端重连回放) */
+const COMPLETED_KEEP = 60 * 1000;
+/**
+ * 创建一个 stream session
+ *
+ * @param {'chat'|'refine'} scene 场景标识
+ * @returns {StreamSession}
+ */
+export function createStreamSession(scene) {
+    const sessionId = `ss_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+    const emitter = new EventEmitter();
+    emitter.setMaxListeners(20);
+    const session = {
+        sessionId,
+        scene,
+        /** @type {Array<object>} 事件缓冲区（供 EventSource 连接后回放） */
+        buffer: [],
+        /** 会话是否已结束 */
+        completed: false,
+        createdAt: Date.now(),
+        /**
+         * 缓冲 + 广播一个事件
+         * @param {object} event 必须包含 type 字段
+         */
+        send(event) {
+            const payload = { ...event, ts: event.ts || Date.now() };
+            session.buffer.push(payload);
+            emitter.emit('event', payload);
+        },
+        /**
+         * 标记会话完成，发送 stream:done
+         * @param {object} [donePayload={}]
+         */
+        end(donePayload = {}) {
+            if (session.completed) {
+                return;
+            }
+            const payload = { type: 'stream:done', ts: Date.now(), ...donePayload };
+            session.buffer.push(payload);
+            emitter.emit('event', payload);
+            session.completed = true;
+            // 完成后保留一段时间供客户端重连
+            const keepTimer = setTimeout(() => _sessions.delete(sessionId), COMPLETED_KEEP);
+            if (keepTimer.unref) {
+                keepTimer.unref();
+            }
+        },
+        /**
+         * 标记会话错误，发送 stream:error
+         * @param {string} message
+         * @param {string} [code]
+         */
+        error(message, code) {
+            if (session.completed) {
+                return;
+            }
+            const payload = { type: 'stream:error', ts: Date.now(), message, code };
+            session.buffer.push(payload);
+            emitter.emit('event', payload);
+            session.completed = true;
+            const keepTimer = setTimeout(() => _sessions.delete(sessionId), COMPLETED_KEEP);
+            if (keepTimer.unref) {
+                keepTimer.unref();
+            }
+        },
+        /**
+         * 订阅实时事件
+         * @param {(event: object) => void} handler
+         * @returns {() => void} unsubscribe 函数
+         */
+        on(handler) {
+            emitter.on('event', handler);
+            return () => emitter.removeListener('event', handler);
+        },
+    };
+    _sessions.set(sessionId, session);
+    // 硬性 TTL: 无论是否完成，5 分钟后强制清理
+    const ttlTimer = setTimeout(() => _sessions.delete(sessionId), SESSION_TTL);
+    if (ttlTimer.unref) {
+        ttlTimer.unref();
+    }
+    return session;
+}
+/**
+ * 获取已有的 session
+ * @param {string} sessionId
+ * @returns {StreamSession|undefined}
+ */
+export function getStreamSession(sessionId) {
+    return _sessions.get(sessionId);
+}
+//# sourceMappingURL=sse-sessions.js.map

package/dist/lib/http/utils/sse-sessions.js.map

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

package/dist/lib/http/utils/sse.d.ts

@@ -0,0 +1,50 @@
+/**
+ * SSE (Server-Sent Events) 会话工具模块
+ *
+ * 提供统一的 SSE 连接管理：headers 设置、心跳保活、安全写入、生命周期事件。
+ * 所有 SSE 端点共用此模块，确保协议一致性。
+ *
+ * @module lib/http/utils/sse
+ */
+import type { Request, Response } from 'express';
+/**
+ * 创建 SSE 会话 — 统一设置 headers、心跳、安全写入
+ *
+ * @param {import('express').Request} req
+ * @param {import('express').Response} res
+ * @param {'chat'|'refine'} scene 场景标识
+ * @returns {{ send, end, error, isDisconnected, sessionId }}
+ */
+export declare function createSSESession(req: Request, res: Response, scene: string): {
+    /**
+     * 发送一个 SSE 事件
+     * @param {object} event 必须包含 type 字段
+     */
+    send(event: Record<string, unknown>): void;
+    /**
+     * 正常结束流 — 发送 stream:done 并关闭连接
+     * @param {object} [donePayload={}] - done 事件携带的额外数据
+     */
+    end(donePayload?: Record<string, unknown>): void;
+    /**
+     * 发送错误并结束流
+     * @param {string} message
+     * @param {string} [code]
+     */
+    error(message: string, code: string): void;
+    /** 是否已断开 */
+    readonly isDisconnected: boolean;
+    /** 会话 ID */
+    sessionId: string;
+    /** 获取性能指标 */
+    readonly metrics: {
+        endTime: number;
+        duration: number;
+        ttft: number | null;
+        startTime: number;
+        eventCount: number;
+        totalBytes: number;
+        firstTextDeltaTime: number;
+    };
+};
+//# sourceMappingURL=sse.d.ts.map

package/dist/lib/http/utils/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../../lib/http/utils/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM;IAwDvE;;;OAGG;gBACS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAanC;;;OAGG;sBACc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUxC;;;;OAIG;mBACY,MAAM,QAAQ,MAAM;IAUnC,YAAY;;IAKZ,YAAY;;IAGZ,aAAa;;;;;;;;;;EAUhB"}

package/dist/lib/http/utils/sse.js

@@ -0,0 +1,125 @@
+/**
+ * SSE (Server-Sent Events) 会话工具模块
+ *
+ * 提供统一的 SSE 连接管理：headers 设置、心跳保活、安全写入、生命周期事件。
+ * 所有 SSE 端点共用此模块，确保协议一致性。
+ *
+ * @module lib/http/utils/sse
+ */
+/**
+ * 创建 SSE 会话 — 统一设置 headers、心跳、安全写入
+ *
+ * @param {import('express').Request} req
+ * @param {import('express').Response} res
+ * @param {'chat'|'refine'} scene 场景标识
+ * @returns {{ send, end, error, isDisconnected, sessionId }}
+ */
+export function createSSESession(req, res, scene) {
+    // ─── SSE Headers ───
+    res.setHeader('Content-Type', 'text/event-stream');
+    res.setHeader('Cache-Control', 'no-cache');
+    res.setHeader('Connection', 'keep-alive');
+    res.setHeader('X-Accel-Buffering', 'no');
+    res.flushHeaders();
+    // ─── 禁用 Nagle 算法，确保 SSE 小包即时发送 ───
+    if (res.socket) {
+        res.socket.setNoDelay(true);
+        res.socket.setTimeout(0);
+    }
+    let disconnected = false;
+    // 注意：必须监听 res.on('close') 而非 req.on('close')。
+    // 在 Node.js 20 中，IncomingMessage (req) 的 'close' 事件在请求体被消费后即触发，
+    // 而 ServerResponse (res) 的 'close' 事件仅在底层 socket 关闭时触发（即客户端真正断开连接）。
+    res.on('close', () => {
+        disconnected = true;
+    });
+    const sessionId = Math.random().toString(36).slice(2, 10);
+    /** 安全写入一段 SSE 数据 */
+    function _write(data) {
+        if (disconnected || res.writableEnded) {
+            return false;
+        }
+        try {
+            return res.write(data);
+        }
+        catch {
+            disconnected = true;
+            return false;
+        }
+    }
+    // ─── 心跳 (每 15 秒发送 SSE 注释保活) ───
+    const heartbeat = setInterval(() => {
+        _write(`: ping ${Date.now()}\n\n`);
+    }, 15_000);
+    // ─── 发送 stream:start ───
+    const startPayload = JSON.stringify({ type: 'stream:start', ts: Date.now(), sessionId, scene });
+    _write(`data: ${startPayload}\n\n`);
+    // ─── 性能跟踪 ───
+    const metrics = {
+        startTime: Date.now(),
+        eventCount: 0,
+        totalBytes: 0,
+        firstTextDeltaTime: 0,
+    };
+    return {
+        /**
+         * 发送一个 SSE 事件
+         * @param {object} event 必须包含 type 字段
+         */
+        send(event) {
+            if (disconnected || res.writableEnded) {
+                return;
+            }
+            const payload = JSON.stringify({ ...event, ts: event.ts || Date.now() });
+            _write(`data: ${payload}\n\n`);
+            metrics.eventCount++;
+            metrics.totalBytes += payload.length;
+            if (event.type === 'text:delta' && !metrics.firstTextDeltaTime) {
+                metrics.firstTextDeltaTime = Date.now();
+            }
+        },
+        /**
+         * 正常结束流 — 发送 stream:done 并关闭连接
+         * @param {object} [donePayload={}] - done 事件携带的额外数据
+         */
+        end(donePayload = {}) {
+            clearInterval(heartbeat);
+            if (disconnected || res.writableEnded) {
+                return;
+            }
+            const payload = JSON.stringify({ type: 'stream:done', ts: Date.now(), ...donePayload });
+            _write(`data: ${payload}\n\n`);
+            res.end();
+        },
+        /**
+         * 发送错误并结束流
+         * @param {string} message
+         * @param {string} [code]
+         */
+        error(message, code) {
+            clearInterval(heartbeat);
+            if (disconnected || res.writableEnded) {
+                return;
+            }
+            const payload = JSON.stringify({ type: 'stream:error', ts: Date.now(), message, code });
+            _write(`data: ${payload}\n\n`);
+            res.end();
+        },
+        /** 是否已断开 */
+        get isDisconnected() {
+            return disconnected;
+        },
+        /** 会话 ID */
+        sessionId,
+        /** 获取性能指标 */
+        get metrics() {
+            return {
+                ...metrics,
+                endTime: Date.now(),
+                duration: Date.now() - metrics.startTime,
+                ttft: metrics.firstTextDeltaTime ? metrics.firstTextDeltaTime - metrics.startTime : null,
+            };
+        },
+    };
+}
+//# sourceMappingURL=sse.js.map

package/dist/lib/http/utils/sse.js.map

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

package/dist/lib/infrastructure/audit/AuditLogger.d.ts

@@ -0,0 +1,123 @@
+import type { AuditStore } from './AuditStore.js';
+/**
+ * AuditLogger - 审计日志记录器
+ */
+export declare class AuditLogger {
+    auditStore: AuditStore;
+    logger: import('winston').Logger;
+    constructor(auditStore: AuditStore);
+    /**
+     * 记录审计日志
+     * 兼容两种传入格式:
+     *   Gateway 风格: { actor, action, resource, result, data, duration }
+     *   Service 风格: { actor, action, resourceType, resourceId, details, timestamp }
+     */
+    log(entry: {
+        requestId?: string;
+        actor: string;
+        action: string;
+        resource?: string;
+        resourceType?: string;
+        resourceId?: string;
+        data?: Record<string, unknown>;
+        details?: unknown;
+        context?: Record<string, unknown>;
+        result?: string;
+        error?: string;
+        duration?: number;
+    }): Promise<void>;
+    /**
+     * 生成 ID
+     */
+    generateId(): string;
+    /**
+     * 格式化资源
+     */
+    formatResource(resource: unknown): string;
+    /**
+     * 查询审计日志
+     */
+    query(filters: {
+        actor?: string;
+        action?: string;
+        result?: string;
+        startDate?: number;
+        endDate?: number;
+        limit?: number;
+    }): Promise<unknown[]>;
+    /**
+     * 获取特定请求的日志
+     */
+    getByRequestId(requestId: string): Promise<{
+        id: string;
+        timestamp: number;
+        actor: string;
+        actorContext: string | null;
+        action: string;
+        resource: string | null;
+        operationData: string | null;
+        result: string;
+        errorMessage: string | null;
+        duration: number | null;
+    } | undefined>;
+    /**
+     * 获取特定角色的日志
+     */
+    getByActor(actor: string, limit?: number): Promise<{
+        id: string;
+        timestamp: number;
+        actor: string;
+        actorContext: string | null;
+        action: string;
+        resource: string | null;
+        operationData: string | null;
+        result: string;
+        errorMessage: string | null;
+        duration: number | null;
+    }[]>;
+    /**
+     * 获取特定操作的日志
+     */
+    getByAction(action: string, limit?: number): Promise<{
+        id: string;
+        timestamp: number;
+        actor: string;
+        actorContext: string | null;
+        action: string;
+        resource: string | null;
+        operationData: string | null;
+        result: string;
+        errorMessage: string | null;
+        duration: number | null;
+    }[]>;
+    /**
+     * 获取失败的操作日志
+     */
+    getFailures(limit?: number): Promise<{
+        id: string;
+        timestamp: number;
+        actor: string;
+        actorContext: string | null;
+        action: string;
+        resource: string | null;
+        operationData: string | null;
+        result: string;
+        errorMessage: string | null;
+        duration: number | null;
+    }[]>;
+    /**
+     * 统计审计数据
+     */
+    getStats(timeRange: string): Promise<{
+        timeRange: string;
+        total: number;
+        success: number;
+        failure: number;
+        successRate: string;
+        avgDuration: string;
+        byActor: unknown[];
+        byAction: unknown[];
+    }>;
+}
+export default AuditLogger;
+//# sourceMappingURL=AuditLogger.d.ts.map

package/dist/lib/infrastructure/audit/AuditLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuditLogger.d.ts","sourceRoot":"","sources":["../../../../lib/infrastructure/audit/AuditLogger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,qBAAa,WAAW;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,OAAO,SAAS,EAAE,MAAM,CAAC;gBACrB,UAAU,EAAE,UAAU;IAKlC;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAwCD;;OAEG;IACH,UAAU;IAIV;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO;IAYhC;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;IAID;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;IAItC;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAM;;;;;;;;;;;;IAI3C;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAM;;;;;;;;;;;;IAI7C;;OAEG;IACG,WAAW,CAAC,KAAK,SAAM;;;;;;;;;;;;IAI7B;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;CAGjC;AAED,eAAe,WAAW,CAAC"}

package/dist/lib/infrastructure/audit/AuditLogger.js

@@ -0,0 +1,110 @@
+import Logger from '../../infrastructure/logging/Logger.js';
+/**
+ * AuditLogger - 审计日志记录器
+ */
+export class AuditLogger {
+    auditStore;
+    logger;
+    constructor(auditStore) {
+        this.auditStore = auditStore;
+        this.logger = Logger.getInstance();
+    }
+    /**
+     * 记录审计日志
+     * 兼容两种传入格式:
+     *   Gateway 风格: { actor, action, resource, result, data, duration }
+     *   Service 风格: { actor, action, resourceType, resourceId, details, timestamp }
+     */
+    async log(entry) {
+        // 兼容 Service 层传入 resourceType + resourceId（而非 resource）
+        const resource = entry.resource ||
+            (entry.resourceType && entry.resourceId
+                ? `${entry.resourceType}:${entry.resourceId}`
+                : undefined);
+        // 兼容 Service 层传入 details（而非 data）
+        const data = entry.data || (entry.details ? { details: entry.details } : {});
+        const auditEntry = {
+            id: entry.requestId || this.generateId(),
+            timestamp: Date.now(),
+            actor: entry.actor,
+            actor_context: JSON.stringify(entry.context || {}),
+            action: entry.action,
+            resource: this.formatResource(resource),
+            operation_data: JSON.stringify(data),
+            result: entry.result || 'success',
+            error_message: entry.error || null,
+            duration: entry.duration || null,
+        };
+        try {
+            await this.auditStore.save(auditEntry);
+            this.logger.debug('Audit log recorded', {
+                requestId: entry.requestId,
+                actor: entry.actor,
+                action: entry.action,
+            });
+        }
+        catch (error) {
+            // 审计失败不应阻断业务，仅记录错误
+            this.logger.error('Failed to save audit log', {
+                error: error.message,
+                entry: auditEntry,
+            });
+        }
+    }
+    /**
+     * 生成 ID
+     */
+    generateId() {
+        return `audit_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * 格式化资源
+     */
+    formatResource(resource) {
+        if (typeof resource === 'string') {
+            return resource;
+        }
+        if (typeof resource === 'object' && resource !== null) {
+            return JSON.stringify(resource);
+        }
+        return String(resource);
+    }
+    /**
+     * 查询审计日志
+     */
+    async query(filters) {
+        return await this.auditStore.query(filters);
+    }
+    /**
+     * 获取特定请求的日志
+     */
+    async getByRequestId(requestId) {
+        return await this.auditStore.findByRequestId(requestId);
+    }
+    /**
+     * 获取特定角色的日志
+     */
+    async getByActor(actor, limit = 100) {
+        return await this.auditStore.findByActor(actor, limit);
+    }
+    /**
+     * 获取特定操作的日志
+     */
+    async getByAction(action, limit = 100) {
+        return await this.auditStore.findByAction(action, limit);
+    }
+    /**
+     * 获取失败的操作日志
+     */
+    async getFailures(limit = 100) {
+        return await this.auditStore.findByResult('failure', limit);
+    }
+    /**
+     * 统计审计数据
+     */
+    async getStats(timeRange) {
+        return await this.auditStore.getStats(timeRange);
+    }
+}
+export default AuditLogger;
+//# sourceMappingURL=AuditLogger.js.map

package/dist/lib/infrastructure/audit/AuditLogger.js.map

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

package/dist/lib/infrastructure/audit/AuditStore.d.ts

@@ -0,0 +1,125 @@
+export declare class AuditStore {
+    #private;
+    db: import('better-sqlite3').Database;
+    constructor(db: {
+        getDb: () => import('better-sqlite3').Database;
+    });
+    /**
+     * 保存审计日志
+     * ★ Drizzle 类型安全 INSERT
+     */
+    save(entry: {
+        id: string;
+        timestamp: number;
+        actor: string;
+        actor_context: string;
+        action: string;
+        resource: string;
+        operation_data: string;
+        result: string;
+        error_message: string | null;
+        duration: number | null;
+    }): Promise<void>;
+    /**
+     * 查询审计日志
+     */
+    query(filters?: {
+        actor?: string;
+        action?: string;
+        result?: string;
+        startDate?: number;
+        endDate?: number;
+        limit?: number;
+    }): unknown[];
+    /**
+     * 根据请求 ID 查询
+     * ★ Drizzle 类型安全 SELECT
+     */
+    findByRequestId(requestId: string): {
+        id: string;
+        timestamp: number;
+        actor: string;
+        actorContext: string | null;
+        action: string;
+        resource: string | null;
+        operationData: string | null;
+        result: string;
+        errorMessage: string | null;
+        duration: number | null;
+    } | undefined;
+    /**
+     * 根据角色查询
+     * ★ Drizzle 类型安全 SELECT
+     */
+    findByActor(actor: string, limit?: number): {
+        id: string;
+        timestamp: number;
+        actor: string;
+        actorContext: string | null;
+        action: string;
+        resource: string | null;
+        operationData: string | null;
+        result: string;
+        errorMessage: string | null;
+        duration: number | null;
+    }[];
+    /**
+     * 根据操作查询
+     * ★ Drizzle 类型安全 SELECT
+     */
+    findByAction(action: string, limit?: number): {
+        id: string;
+        timestamp: number;
+        actor: string;
+        actorContext: string | null;
+        action: string;
+        resource: string | null;
+        operationData: string | null;
+        result: string;
+        errorMessage: string | null;
+        duration: number | null;
+    }[];
+    /**
+     * 根据结果查询
+     * ★ Drizzle 类型安全 SELECT
+     */
+    findByResult(result: string, limit?: number): {
+        id: string;
+        timestamp: number;
+        actor: string;
+        actorContext: string | null;
+        action: string;
+        resource: string | null;
+        operationData: string | null;
+        result: string;
+        errorMessage: string | null;
+        duration: number | null;
+    }[];
+    /**
+     * 获取统计数据
+     */
+    getStats(timeRange?: string): {
+        timeRange: string;
+        total: number;
+        success: number;
+        failure: number;
+        successRate: string;
+        avgDuration: string;
+        byActor: unknown[];
+        byAction: unknown[];
+    };
+    /**
+     * 清理过期审计日志
+     * ★ Drizzle 类型安全 DELETE
+     * @param {object} [opts]
+     * @param {number} [opts.maxAgeDays=90] 保留天数，超过此天数的记录将被删除
+     * @returns {{ deleted: number }}
+     */
+    cleanup({ maxAgeDays }?: {
+        maxAgeDays?: number | undefined;
+    }): {
+        deleted: number;
+    };
+}
+export default AuditStore;
+//# sourceMappingURL=AuditStore.d.ts.map

package/dist/lib/infrastructure/audit/AuditStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuditStore.d.ts","sourceRoot":"","sources":["../../../../lib/infrastructure/audit/AuditStore.ts"],"names":[],"mappings":"AAOA,qBAAa,UAAU;;IACrB,EAAE,EAAE,OAAO,gBAAgB,EAAE,QAAQ,CAAC;gBAE1B,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,OAAO,gBAAgB,EAAE,QAAQ,CAAA;KAAE;IAKlE;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB;IAkBD;;OAEG;IACH,KAAK,CACH,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX;IAyCR;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;IAIjC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAM;;;;;;;;;;;;IAUtC;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAM;;;;;;;;;;;;IAUxC;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAM;;;;;;;;;;;;IAUxC;;OAEG;IACH,QAAQ,CAAC,SAAS,SAAQ;;;;;;;;;;IAmE1B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,UAAe,EAAE;;KAAK;;;CAYjC;AAED,eAAe,UAAU,CAAC"}