@xiaohao0725/logs-sdk 0.3.3

package/README.md

@@ -0,0 +1,149 @@
+# 日志管理平台 Node.js SDK
+
+[English Documentation](https://github.com/xiaohao0725/logs-sdk-js/blob/main/README_EN.md) | [NPM](https://www.npmjs.com/package/@xiaohao0725/logs-sdk)
+
+`@xiaohao0725/logs-sdk` 是日志管理平台的 Node.js / TypeScript SDK，提供 Express 和 Koa 中间件，一行代码即可自动采集 HTTP 请求的完整日志（请求/响应头体、客户端信息、设备信息、错误堆栈等），异步批量上报，对业务性能零影响。
+
+## 功能特性
+
+- ✅ **一行代码接入**：`app.use(logger.expressMiddleware())` / `app.use(logger.koaMiddleware())`
+- ✅ **完整采集**：60+ 字段——请求头/体、响应头/体、客户端 IP/端口/类型、设备信息、TLS 版本、API 版本
+- ✅ **自动识别**：客户端类型（Web / 小程序 / App / 服务端 / 其他）、请求来源（Referer / 微服务调用链）
+- ✅ **错误捕获**：HTTP 5xx 自动标记 + 错误堆栈采集
+- ✅ **UUID v7**：32 位十六进制无连字符，天然按时间排序
+- ✅ **敏感脱敏**：Authorization / Cookie 自动脱敏，不记录明文
+- ✅ **异步非阻塞**：环形缓冲区 + 后台定时刷新，不阻塞业务请求
+- ✅ **离线缓存**：网络故障时自动缓存到本地文件，恢复后自动重传
+- ✅ **优雅关闭**：`close()` 确保缓冲日志全部上报
+- ✅ **TypeScript**：完整类型定义，IDE 智能提示
+
+## 安装
+
+```bash
+npm install @xiaohao0725/logs-sdk
+```
+
+要求 Node.js 18+。
+
+## 快速开始
+
+### Express
+
+```typescript
+import express from 'express';
+import { LogSDK } from '@xiaohao0725/logs-sdk';
+
+const app = express();
+
+// ① 创建客户端
+const logger = new LogSDK({
+  endpoint: 'https://api.logs.codexs.cn/api/v1/ingest/logs',
+  apiKey: 'clog_pk_xxx',
+  apiSecret: 'clog_sk_xxx',
+  projectSlug: 'my-project',
+  environment: 'production',
+});
+
+// ② 重传离线缓存的日志
+await logger.flushOffline();
+
+// ③ 注册 Express 中间件——一行代码接入
+app.use(logger.expressMiddleware());
+
+app.get('/api/hello', (req, res) => {
+  res.json({ message: 'hello' });
+});
+
+app.listen(3000);
+```
+
+### Koa
+
+```typescript
+import Koa from 'koa';
+import { LogSDK } from '@xiaohao0725/logs-sdk';
+
+const app = new Koa();
+const logger = new LogSDK({...});
+
+// Koa 中间件
+app.use(logger.koaMiddleware());
+```
+
+## 配置参数
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `endpoint` | `string` | **必填** | 日志上报地址 |
+| `apiKey` | `string` | **必填** | SDK 认证密钥（公钥） |
+| `apiSecret` | `string` | **必填** | SDK 认证密钥（私钥） |
+| `projectSlug` | `string` | **必填** | 项目短标识 |
+| `environment` | `string` | `"production"` | 运行环境：production / staging / development |
+| `serviceName` | `string` | `""` | 微服务名称 |
+| `bufferSize` | `number` | `1000` | 本地环形缓冲区容量，满 80% 自动 flush |
+| `flushInterval` | `number` | `5` | 定时刷新间隔（秒） |
+| `maxRetries` | `number` | `3` | 最大重试次数，指数退避 |
+| `maxBodySize` | `number` | `4096` | 请求/响应体最大采集大小（字节） |
+| `maxStackSize` | `number` | `8192` | 错误堆栈最大采集大小（字节） |
+
+## 采集字段一览
+
+与 Go SDK 完全对齐，详见 [LogEntry 类型定义](./src/types.ts)。
+
+| 分类 | 字段 |
+|------|------|
+| 请求 | `method`, `scheme`, `full_url`, `host_header`, `path`, `query_string`, `origin`, `request_headers`, `request_body`, `request_body_size`, `content_type` |
+| 响应 | `status_code`, `response_headers`, `response_body`, `response_body_size` |
+| 客户端 | `client_ip`, `client_ip_chain`, `client_type`, `client_port` |
+| 设备 | `user_agent`, `device_type`, `browser`, `browser_version`, `os_name`, `os_version` |
+| TLS/协议 | `tls_version`, `tls_cipher`, `proto`, `api_version`, `referer` |
+| 追踪 | `trace_id`, `span_id`, `parent_span_id`, `user_id`, `session_id`, `request_id` |
+| 错误 | `is_error`, `error_type`, `error_message`, `error_stack` |
+
+## 架构设计
+
+```
+HTTP 请求进入
+  │
+  ├─ ① expressMiddleware() / koaMiddleware()
+  │     ├─ 生成 UUID v7（32 位无连字符）
+  │     ├─ 读取请求体（缓存以支持后续中间件读取）
+  │     └─ 记录开始时间（hrtime）
+  │
+  ├─ ② 业务 Handler
+  │
+  ├─ ③ 劫持 res.end 捕获响应体
+  │     └─ 构建 LogEntry（60+ 字段）
+  │
+  ├─ ④ 写入环形缓冲区（非阻塞）
+  │
+  └─ ⑤ 后台定时刷新（每 5s 或缓冲 80% 满）
+        └─ 批量 POST 到 Ingestion API → 重试 → 失败则离线缓存
+```
+
+## 离线缓存
+
+网络故障时，SDK 自动将日志保存到系统临时目录：
+
+```
+$TMPDIR/logs-sdk-offline/
+├── offline-2026-06-21T12-00-00.json
+├── offline-2026-06-21T12-00-05.json
+└── ...
+```
+
+- 最大缓存 50MB，超过自动清理旧文件
+- 超过 24 小时的缓存自动删除
+- 调用 `flushOffline()` 或 `close()` 时自动重传
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| v0.3.0 | 2026-06-21 | 新增 TLS/协议/API版本/Referer/耗时分解/request_id 等 8 字段 |
+| v0.2.0 | 2026-06-21 | 新增离线缓存（断网本地存储，恢复自动重传） |
+| v0.1.0 | 2026-06-21 | 初始版本：Express/Koa 中间件、异步缓冲、重试 |
+
+## License
+
+UNLICENSED — 内部使用

package/dist/buffer.d.ts

@@ -0,0 +1,19 @@
+import type { LogEntry } from './types';
+export type FlushCallback = (entries: LogEntry[]) => void;
+export declare class RingBuffer {
+    private buf;
+    private capacity;
+    private head;
+    private tail;
+    private count;
+    private flushFn;
+    constructor(capacity: number, flushFn: FlushCallback);
+    /** 追加一条日志到缓冲区 */
+    push(entry: LogEntry): void;
+    /** 取出所有待上报日志并清空缓冲 */
+    flush(): LogEntry[];
+    get length(): number;
+    /** 内部排空方法 */
+    private drain;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;AAE1D,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAgB;gBAEnB,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa;IAMpD,iBAAiB;IACjB,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAY3B,qBAAqB;IACrB,KAAK,IAAI,QAAQ,EAAE;IAInB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,aAAa;IACb,OAAO,CAAC,KAAK;CAad"}

package/dist/buffer.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RingBuffer = void 0;
+class RingBuffer {
+    buf;
+    capacity;
+    head = 0;
+    tail = 0;
+    count = 0;
+    flushFn;
+    constructor(capacity, flushFn) {
+        this.capacity = Math.max(capacity, 100);
+        this.buf = new Array(this.capacity).fill(null);
+        this.flushFn = flushFn;
+    }
+    /** 追加一条日志到缓冲区 */
+    push(entry) {
+        this.buf[this.head] = entry;
+        this.head = (this.head + 1) % this.capacity;
+        this.count++;
+        // 缓冲使用率达 80% 自动触发 flush
+        if (this.count >= Math.floor(this.capacity * 0.8)) {
+            const entries = this.drain();
+            this.flushFn(entries);
+        }
+    }
+    /** 取出所有待上报日志并清空缓冲 */
+    flush() {
+        return this.drain();
+    }
+    get length() {
+        return this.count;
+    }
+    /** 内部排空方法 */
+    drain() {
+        const entries = [];
+        while (this.count > 0) {
+            const entry = this.buf[this.tail];
+            if (entry) {
+                entries.push(entry);
+            }
+            this.buf[this.tail] = null; // 帮助 GC
+            this.tail = (this.tail + 1) % this.capacity;
+            this.count--;
+        }
+        return entries;
+    }
+}
+exports.RingBuffer = RingBuffer;
+//# sourceMappingURL=buffer.js.map

package/dist/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":";;;AAKA,MAAa,UAAU;IACb,GAAG,CAAsB;IACzB,QAAQ,CAAS;IACjB,IAAI,GAAG,CAAC,CAAC;IACT,IAAI,GAAG,CAAC,CAAC;IACT,KAAK,GAAG,CAAC,CAAC;IACV,OAAO,CAAgB;IAE/B,YAAY,QAAgB,EAAE,OAAsB;QAClD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,iBAAiB;IACjB,IAAI,CAAC,KAAe;QAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,wBAAwB;QACxB,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,aAAa;IACL,KAAK;QACX,MAAM,OAAO,GAAe,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,QAAQ;YACpC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAlDD,gCAkDC"}

package/dist/client.d.ts

@@ -0,0 +1,31 @@
+import type { LogEntry, LogSDKConfig, ResolvedConfig } from './types';
+export declare class LogSDK {
+    private config;
+    private buffer;
+    private flushTimer;
+    private closed;
+    private offlineCache;
+    private hostname;
+    private pid;
+    constructor(config: LogSDKConfig);
+    /** 异步发送一条日志到缓冲区（非阻塞） */
+    send(entry: LogEntry): void;
+    /** 优雅关闭，等待缓冲日志全部上报 */
+    close(): Promise<void>;
+    /** 获取 Express 中间件（动态导入，避免不安装 express 时出错） */
+    expressMiddleware(): any;
+    /** 获取 Koa 中间件 */
+    koaMiddleware(): any;
+    /** 异步发送一批日志（包装重试） */
+    private flushEntries;
+    /** 重传离线缓存的日志 */
+    flushOffline(): Promise<void>;
+    /** HTTP POST 批量发送日志 */
+    private sendBatch;
+    /** 以下方法公开给 middleware 使用 */
+    get configResolved(): ResolvedConfig;
+    get host(): string;
+}
+/** 生成 UUID v7（32 位十六进制无连字符） */
+export declare function newLogUUID(): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAItE,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,GAAG,CAAS;gBAER,MAAM,EAAE,YAAY;IAsBhC,wBAAwB;IACxB,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAe3B,sBAAsB;IAChB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B,6CAA6C;IAC7C,iBAAiB;IAMjB,iBAAiB;IACjB,aAAa;IAQb,qBAAqB;YACP,YAAY;IAW1B,gBAAgB;IACV,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,uBAAuB;YACT,SAAS;IA6BvB,4BAA4B;IAC5B,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAmBD,+BAA+B;AAC/B,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/client.js

@@ -0,0 +1,196 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogSDK = void 0;
+exports.newLogUUID = newLogUUID;
+// 核心客户端 — 管理配置、缓冲、定时刷新和 HTTP 上报
+const os = __importStar(require("os"));
+const uuid_1 = require("uuid");
+const buffer_1 = require("./buffer");
+const offline_1 = require("./offline");
+const retry_1 = require("./retry");
+const VERSION = '0.1.0';
+class LogSDK {
+    config;
+    buffer;
+    flushTimer = null;
+    closed = false;
+    offlineCache;
+    hostname;
+    pid;
+    constructor(config) {
+        this.config = resolveConfig(config);
+        this.offlineCache = new offline_1.OfflineCache();
+        this.hostname = os.hostname();
+        this.pid = String(process.pid);
+        // 创建环形缓冲区
+        this.buffer = new buffer_1.RingBuffer(this.config.bufferSize, (entries) => {
+            this.flushEntries(entries).catch(() => {
+                // 失败在 flushEntries 内部已打日志
+            });
+        });
+        // 启动定时 flush
+        this.flushTimer = setInterval(() => {
+            const entries = this.buffer.flush();
+            if (entries.length > 0) {
+                this.flushEntries(entries);
+            }
+        }, this.config.flushInterval * 1000);
+    }
+    /** 异步发送一条日志到缓冲区（非阻塞） */
+    send(entry) {
+        if (this.closed) {
+            console.warn('[logs-sdk] Client 已关闭，日志将被丢弃');
+            return;
+        }
+        // 补充来源信息
+        entry.host = this.hostname;
+        entry.process_id = this.pid;
+        entry.environment = this.config.environment;
+        entry.project_slug = this.config.projectSlug;
+        entry.service_name = this.config.serviceName || '';
+        this.buffer.push(entry);
+    }
+    /** 优雅关闭，等待缓冲日志全部上报 */
+    async close() {
+        this.closed = true;
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        // 最终刷新
+        const remaining = this.buffer.flush();
+        if (remaining.length > 0) {
+            try {
+                await this.sendBatch(remaining);
+            }
+            catch (err) {
+                console.error(`[logs-sdk] 关闭时上报失败:`, err, '— 保存到离线缓存');
+                this.offlineCache.save(remaining);
+            }
+        }
+        // 尝试重传离线缓存
+        await this.flushOffline();
+    }
+    /** 获取 Express 中间件（动态导入，避免不安装 express 时出错） */
+    expressMiddleware() {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { createExpressMiddleware } = require('./middleware/express');
+        return createExpressMiddleware(this);
+    }
+    /** 获取 Koa 中间件 */
+    koaMiddleware() {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { createKoaMiddleware } = require('./middleware/koa');
+        return createKoaMiddleware(this);
+    }
+    // ──────────────── 内部方法 ────────────────
+    /** 异步发送一批日志（包装重试） */
+    async flushEntries(entries) {
+        try {
+            await (0, retry_1.retryWithBackoff)(() => this.sendBatch(entries), {
+                maxRetries: this.config.maxRetries,
+            });
+        }
+        catch (err) {
+            console.error(`[logs-sdk] 上报失败 (数量=${entries.length}):`, err, '— 保存到离线缓存');
+            this.offlineCache.save(entries);
+        }
+    }
+    /** 重传离线缓存的日志 */
+    async flushOffline() {
+        if (this.offlineCache.pendingCount() === 0)
+            return;
+        console.log(`[logs-sdk] 检测到 ${this.offlineCache.pendingCount()} 个离线缓存文件，开始重传...`);
+        await this.offlineCache.flushAll((entries) => this.sendBatch(entries));
+        console.log('[logs-sdk] 离线缓存重传完成');
+    }
+    /** HTTP POST 批量发送日志 */
+    async sendBatch(entries) {
+        const body = JSON.stringify({ logs: entries });
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 15000);
+        try {
+            const resp = await fetch(this.config.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-API-Key': this.config.apiKey,
+                    'X-API-Secret': this.config.apiSecret,
+                    'X-SDK-Version': VERSION,
+                    'X-SDK-Type': 'node',
+                    'User-Agent': `logs-sdk-js/${VERSION}`,
+                },
+                body,
+                signal: controller.signal,
+            });
+            if (resp.status !== 200 && resp.status !== 201) {
+                throw new Error(`服务端返回异常状态码: ${resp.status}`);
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    /** 以下方法公开给 middleware 使用 */
+    get configResolved() {
+        return this.config;
+    }
+    get host() {
+        return this.hostname;
+    }
+}
+exports.LogSDK = LogSDK;
+/** 合并默认配置 */
+function resolveConfig(cfg) {
+    return {
+        endpoint: cfg.endpoint,
+        apiKey: cfg.apiKey,
+        apiSecret: cfg.apiSecret,
+        projectSlug: cfg.projectSlug,
+        environment: cfg.environment || 'production',
+        serviceName: cfg.serviceName || '',
+        bufferSize: cfg.bufferSize || 1000,
+        flushInterval: cfg.flushInterval || 5,
+        maxRetries: cfg.maxRetries || 3,
+        maxBodySize: cfg.maxBodySize || 4096,
+        maxStackSize: cfg.maxStackSize || 8192,
+    };
+}
+/** 生成 UUID v7（32 位十六进制无连字符） */
+function newLogUUID() {
+    return (0, uuid_1.v7)().replaceAll('-', '');
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { LogSDK, newLogUUID } from './client';
+export { RingBuffer } from './buffer';
+export { OfflineCache } from './offline';
+export { retryWithBackoff } from './retry';
+export type { LogSDKConfig, LogEntry, ClientType, ErrorType, ResolvedConfig, } 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":"AAkBA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+"use strict";
+// 日志管理平台 Node.js SDK 入口
+// 提供 Express/Koa 中间件，一行代码接入日志采集
+//
+// 使用方法：
+//
+//   import { LogSDK } from '@xiaohao0725/logs-sdk';
+//
+//   const logger = new LogSDK({
+//     endpoint: 'https://api.logs.codexs.cn/api/v1/ingest/logs',
+//     apiKey: 'clog_pk_xxx',
+//     apiSecret: 'clog_sk_xxx',
+//     projectSlug: 'my-project',
+//     environment: 'production',
+//   });
+//
+//   app.use(logger.expressMiddleware());  // Express
+//   app.use(logger.koaMiddleware());      // Koa
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retryWithBackoff = exports.OfflineCache = exports.RingBuffer = exports.newLogUUID = exports.LogSDK = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "LogSDK", { enumerable: true, get: function () { return client_1.LogSDK; } });
+Object.defineProperty(exports, "newLogUUID", { enumerable: true, get: function () { return client_1.newLogUUID; } });
+var buffer_1 = require("./buffer");
+Object.defineProperty(exports, "RingBuffer", { enumerable: true, get: function () { return buffer_1.RingBuffer; } });
+var offline_1 = require("./offline");
+Object.defineProperty(exports, "OfflineCache", { enumerable: true, get: function () { return offline_1.OfflineCache; } });
+var retry_1 = require("./retry");
+Object.defineProperty(exports, "retryWithBackoff", { enumerable: true, get: function () { return retry_1.retryWithBackoff; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,wBAAwB;AACxB,gCAAgC;AAChC,EAAE;AACF,QAAQ;AACR,EAAE;AACF,oDAAoD;AACpD,EAAE;AACF,gCAAgC;AAChC,iEAAiE;AACjE,6BAA6B;AAC7B,gCAAgC;AAChC,iCAAiC;AACjC,iCAAiC;AACjC,QAAQ;AACR,EAAE;AACF,qDAAqD;AACrD,iDAAiD;;;AAEjD,mCAA8C;AAArC,gGAAA,MAAM,OAAA;AAAE,oGAAA,UAAU,OAAA;AAC3B,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AACnB,qCAAyC;AAAhC,uGAAA,YAAY,OAAA;AACrB,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA"}

package/dist/middleware/express.d.ts

@@ -0,0 +1,8 @@
+import type { Request, Response, NextFunction } from 'express';
+import type { LogSDK } from '../client';
+/**
+ * 创建 Express 日志采集中间件。
+ * 自动采集：请求头/体、响应头/体、客户端信息、错误堆栈、耗时统计。
+ */
+export declare function createExpressMiddleware(sdk: LogSDK): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=express.d.ts.map

package/dist/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIxC;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,IAGzC,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UA6CxD"}

package/dist/middleware/express.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExpressMiddleware = createExpressMiddleware;
+const client_1 = require("../client");
+/**
+ * 创建 Express 日志采集中间件。
+ * 自动采集：请求头/体、响应头/体、客户端信息、错误堆栈、耗时统计。
+ */
+function createExpressMiddleware(sdk) {
+    const config = sdk.configResolved;
+    return (req, res, next) => {
+        const entryUUID = (0, client_1.newLogUUID)();
+        const startTime = Date.now();
+        const startHrTime = process.hrtime.bigint();
+        // 读取请求体
+        const reqBody = captureRequestBody(req, config.maxBodySize);
+        // 包装 res.end 以捕获响应体
+        const origEnd = res.end;
+        const origWrite = res.write;
+        const chunks = [];
+        res.write = ((chunk, encoding, callback) => {
+            if (chunk) {
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            }
+            return origWrite.call(res, chunk, encoding, callback);
+        });
+        res.end = ((chunk, encoding, callback) => {
+            if (chunk) {
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            }
+            const respBody = Buffer.concat(chunks).toString('utf-8');
+            const durationMs = Number(process.hrtime.bigint() - startHrTime) / 1_000_000;
+            const entry = buildExpressEntry(req, res, entryUUID, startTime, durationMs, reqBody, respBody, config, sdk.host);
+            if (res.statusCode >= 500) {
+                entry.is_error = true;
+                entry.tls_version = req.connection?.getTlsinfo?.()?.protocol || "";
+                entry.tls_cipher = req.connection?.getTlsinfo?.()?.cipher?.name || "";
+                entry.proto = String(req.httpVersion);
+                entry.api_version = extractAPIVersion(req.path);
+                entry.referer = req.get("referer") || "";
+                entry.request_id = entryUUID.slice(0, 8);
+                entry.error_type = 'http_error';
+            }
+            sdk.send(entry);
+            return origEnd.call(res, chunk, encoding, callback);
+        });
+        next();
+    };
+}
+/** 从 Express Request 构建 LogEntry */
+function buildExpressEntry(req, res, uuid, startTime, durationMs, reqBody, respBody, config, host) {
+    const scheme = req.protocol || (req.secure ? 'https' : 'http');
+    const fullURL = `${scheme}://${req.hostname || req.get('host')}${req.originalUrl}`;
+    return {
+        uuid,
+        timestamp: new Date(startTime).toISOString(),
+        duration_ms: Math.round(durationMs),
+        method: req.method,
+        scheme,
+        full_url: fullURL,
+        host_header: req.get('host') || '',
+        path: req.path,
+        query_string: Object.keys(req.query).length > 0 ? JSON.stringify(req.query) : '',
+        origin: detectOrigin(req),
+        request_headers: sanitizeHeaders(req.headers),
+        request_body: truncate(reqBody, config.maxBodySize),
+        request_body_size: Buffer.byteLength(reqBody),
+        content_type: req.get('content-type') || '',
+        status_code: res.statusCode,
+        response_headers: sanitizeHeaders(res.getHeaders()),
+        response_body: truncate(respBody, config.maxBodySize),
+        response_body_size: Buffer.byteLength(respBody),
+        client_ip: realClientIP(req),
+        client_ip_chain: req.get('x-forwarded-for') || '',
+        client_type: detectClientType(req),
+        client_port: 0,
+        user_agent: req.get('user-agent') || '',
+        is_error: false,
+        error_message: '',
+        error_type: '',
+        error_stack: '',
+        trace_id: req.get('x-trace-id') || uuid,
+        span_id: uuid,
+        parent_span_id: req.get('x-parent-span-id') || '',
+        user_id: req.get('x-user-id') || '',
+        session_id: req.get('x-session-id') || '',
+        project_slug: config.projectSlug,
+        environment: config.environment,
+        service_name: config.serviceName || '',
+        host,
+        process_id: String(process.pid),
+        tags: {},
+    };
+}
+function realClientIP(req) {
+    const xff = req.get('x-forwarded-for');
+    if (xff)
+        return xff.split(',')[0].trim();
+    const xri = req.get('x-real-ip');
+    if (xri)
+        return xri;
+    return req.ip || req.socket.remoteAddress || '';
+}
+function detectClientType(req) {
+    const ct = req.get('x-client-type');
+    if (ct)
+        return ct;
+    const ua = (req.get('user-agent') || '').toLowerCase();
+    if (ua.includes('micromessenger') || ua.includes('miniprogram'))
+        return 'miniprogram';
+    if (req.get('x-caller-service'))
+        return 'server';
+    const referer = req.get('referer');
+    const origin = req.get('origin');
+    if ((referer || origin) && (ua.includes('mozilla') || ua.includes('chrome') || ua.includes('safari') || ua.includes('firefox'))) {
+        return 'web';
+    }
+    return 'other';
+}
+function detectOrigin(req) {
+    switch (detectClientType(req)) {
+        case 'web': return (req.get('referer') || req.get('origin') || '');
+        case 'miniprogram': return `miniprogram:${req.get('x-miniprogram-appid') || ''}${req.get('x-miniprogram-path') || ''}`;
+        case 'app': return `app:${req.get('x-app-name') || ''}/${req.get('x-app-version') || ''}/${req.get('x-app-scene') || ''}`;
+        case 'server': return `server:${req.get('x-caller-service') || ''}/${req.get('x-caller-version') || ''}`;
+        default: return 'unknown';
+    }
+}
+function sanitizeHeaders(headers) {
+    const safe = {};
+    for (const [k, v] of Object.entries(headers)) {
+        if (v === undefined || v === null)
+            continue;
+        const val = Array.isArray(v) ? v.join(', ') : String(v);
+        if (['authorization', 'cookie', 'set-cookie'].includes(k.toLowerCase())) {
+            safe[k] = val.length > 20 ? val.slice(0, 15) + '...' : '***';
+            continue;
+        }
+        safe[k] = val;
+    }
+    return JSON.stringify(safe);
+}
+function captureRequestBody(req, maxSize) {
+    try {
+        if (req.body) {
+            if (typeof req.body === 'string')
+                return truncate(req.body, maxSize);
+            return truncate(JSON.stringify(req.body), maxSize);
+        }
+    }
+    catch { /* 忽略无法读取的请求体 */ }
+    return '';
+}
+function truncate(s, maxLen) {
+    if (s.length <= maxLen)
+        return s;
+    return s.slice(0, maxLen) + '...[truncated]';
+}
+function extractAPIVersion(path) { const m = path.match(/\/api\/(v\d+)\//); return m ? m[1] : ""; }
+//# sourceMappingURL=express.js.map

package/dist/middleware/express.js.map

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

package/dist/middleware/koa.d.ts

@@ -0,0 +1,7 @@
+import type { Context, Next } from 'koa';
+import type { LogSDK } from '../client';
+/**
+ * 创建 Koa 日志采集中间件。
+ */
+export declare function createKoaMiddleware(sdk: LogSDK): (ctx: Context, next: Next) => Promise<void>;
+//# sourceMappingURL=koa.d.ts.map

package/dist/middleware/koa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"koa.d.ts","sourceRoot":"","sources":["../../src/middleware/koa.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIxC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,IAG/B,KAAK,OAAO,EAAE,MAAM,IAAI,mBAwCvC"}

package/dist/middleware/koa.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKoaMiddleware = createKoaMiddleware;
+const client_1 = require("../client");
+/**
+ * 创建 Koa 日志采集中间件。
+ */
+function createKoaMiddleware(sdk) {
+    const config = sdk.configResolved;
+    return async (ctx, next) => {
+        const entryUUID = (0, client_1.newLogUUID)();
+        const startTime = Date.now();
+        const startHrTime = process.hrtime.bigint();
+        const reqBody = captureKoaRequestBody(ctx, config.maxBodySize);
+        // 捕获响应体
+        const chunks = [];
+        const origWrite = ctx.res.write;
+        const origEnd = ctx.res.end;
+        ctx.res.write = ((chunk, encoding, callback) => {
+            if (chunk)
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            return origWrite.call(ctx.res, chunk, encoding, callback);
+        });
+        ctx.res.end = ((chunk, encoding, callback) => {
+            if (chunk)
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            const respBody = Buffer.concat(chunks).toString('utf-8');
+            const durationMs = Number(process.hrtime.bigint() - startHrTime) / 1_000_000;
+            const entry = buildKoaEntry(ctx, entryUUID, startTime, durationMs, reqBody, respBody, config, sdk.host);
+            entry.tls_version = ctx.req.connection?.getTlsinfo?.()?.protocol || "";
+            entry.tls_cipher = ctx.req.connection?.getTlsinfo?.()?.cipher?.name || "";
+            entry.proto = String(ctx.req.httpVersion);
+            entry.api_version = extractKoaVersion(ctx.path);
+            entry.referer = ctx.get("referer") || "";
+            entry.request_id = entryUUID.slice(0, 8);
+            if (ctx.status >= 500) {
+                entry.is_error = true;
+                entry.error_type = 'http_error';
+            }
+            sdk.send(entry);
+            return origEnd.call(ctx.res, chunk, encoding, callback);
+        });
+        await next();
+    };
+}
+function buildKoaEntry(ctx, uuid, startTime, durationMs, reqBody, respBody, config, host) {
+    const scheme = ctx.protocol || (ctx.secure ? 'https' : 'http');
+    const fullURL = `${scheme}://${ctx.host}${ctx.url}`;
+    return {
+        uuid,
+        timestamp: new Date(startTime).toISOString(),
+        duration_ms: Math.round(durationMs),
+        method: ctx.method,
+        scheme,
+        full_url: fullURL,
+        host_header: ctx.host || '',
+        path: ctx.path,
+        query_string: ctx.querystring || '',
+        origin: detectKoaOrigin(ctx),
+        request_headers: sanitizeKoaHeaders(ctx.headers),
+        request_body: truncate(reqBody, config.maxBodySize),
+        request_body_size: Buffer.byteLength(reqBody),
+        content_type: ctx.get('content-type') || '',
+        status_code: ctx.status,
+        response_headers: sanitizeKoaHeaders(ctx.response.headers),
+        response_body: truncate(respBody, config.maxBodySize),
+        response_body_size: Buffer.byteLength(respBody),
+        client_ip: ctx.ip || ctx.request.ip || '',
+        client_ip_chain: ctx.get('x-forwarded-for') || '',
+        client_type: detectKoaClientType(ctx),
+        client_port: 0,
+        user_agent: ctx.get('user-agent') || '',
+        is_error: false,
+        error_message: '',
+        error_type: '',
+        error_stack: '',
+        trace_id: ctx.get('x-trace-id') || uuid,
+        span_id: uuid,
+        parent_span_id: ctx.get('x-parent-span-id') || '',
+        user_id: ctx.get('x-user-id') || '',
+        session_id: ctx.get('x-session-id') || '',
+        project_slug: config.projectSlug,
+        environment: config.environment,
+        service_name: config.serviceName || '',
+        host,
+        process_id: String(process.pid),
+    };
+}
+function detectKoaClientType(ctx) {
+    const ct = ctx.get('x-client-type');
+    if (ct)
+        return ct;
+    const ua = (ctx.get('user-agent') || '').toLowerCase();
+    if (ua.includes('micromessenger') || ua.includes('miniprogram'))
+        return 'miniprogram';
+    if (ctx.get('x-caller-service'))
+        return 'server';
+    const referer = ctx.get('referer');
+    const origin = ctx.get('origin');
+    if ((referer || origin) && (ua.includes('mozilla') || ua.includes('chrome') || ua.includes('safari') || ua.includes('firefox'))) {
+        return 'web';
+    }
+    return 'other';
+}
+function detectKoaOrigin(ctx) {
+    switch (detectKoaClientType(ctx)) {
+        case 'web': return (ctx.get('referer') || ctx.get('origin') || '');
+        case 'miniprogram': return `miniprogram:${ctx.get('x-miniprogram-appid') || ''}${ctx.get('x-miniprogram-path') || ''}`;
+        case 'app': return `app:${ctx.get('x-app-name') || ''}/${ctx.get('x-app-version') || ''}/${ctx.get('x-app-scene') || ''}`;
+        case 'server': return `server:${ctx.get('x-caller-service') || ''}/${ctx.get('x-caller-version') || ''}`;
+        default: return 'unknown';
+    }
+}
+function sanitizeKoaHeaders(headers) {
+    const safe = {};
+    for (const [k, v] of Object.entries(headers)) {
+        if (v === undefined || v === null)
+            continue;
+        const val = Array.isArray(v) ? v.join(', ') : String(v);
+        if (['authorization', 'cookie', 'set-cookie'].includes(k.toLowerCase())) {
+            safe[k] = val.length > 20 ? val.slice(0, 15) + '...' : '***';
+            continue;
+        }
+        safe[k] = val;
+    }
+    return JSON.stringify(safe);
+}
+function captureKoaRequestBody(ctx, maxSize) {
+    try {
+        const body = ctx.request.body;
+        if (body) {
+            if (typeof body === 'string')
+                return truncate(body, maxSize);
+            return truncate(JSON.stringify(body), maxSize);
+        }
+    }
+    catch { /* ignore */ }
+    return '';
+}
+function truncate(s, maxLen) {
+    if (s.length <= maxLen)
+        return s;
+    return s.slice(0, maxLen) + '...[truncated]';
+}
+function extractKoaVersion(path) { const m = path.match(/\/api\/(v\d+)\//); return m ? m[1] : ""; }
+//# sourceMappingURL=koa.js.map

package/dist/middleware/koa.js.map

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

package/dist/offline.d.ts

@@ -0,0 +1,18 @@
+import type { LogEntry } from './types';
+export declare class OfflineCache {
+    private dir;
+    private maxSize;
+    private maxAge;
+    private enabled;
+    constructor(dir?: string);
+    /** 保存一批日志到离线缓存 */
+    save(entries: LogEntry[]): void;
+    /** 读取所有离线缓存，通过回调发送，成功则删除 */
+    flushAll(sendFn: (entries: LogEntry[]) => Promise<void>): Promise<void>;
+    /** 返回待重传的文件数 */
+    pendingCount(): number;
+    enable(): void;
+    disable(): void;
+    private cleanup;
+}
+//# sourceMappingURL=offline.d.ts.map

package/dist/offline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.d.ts","sourceRoot":"","sources":["../src/offline.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAU;gBAEb,GAAG,CAAC,EAAE,MAAM;IAUxB,kBAAkB;IAClB,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI;IAY/B,4BAA4B;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B7E,gBAAgB;IAChB,YAAY,IAAI,MAAM;IAMtB,MAAM;IACN,OAAO;IAEP,OAAO,CAAC,OAAO;CAsBhB"}

package/dist/offline.js

@@ -0,0 +1,144 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfflineCache = void 0;
+// 离线缓存 — 网络故障时缓存到本地文件，恢复后自动重传
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+class OfflineCache {
+    dir;
+    maxSize;
+    maxAge;
+    enabled;
+    constructor(dir) {
+        this.dir = dir || path.join(os.tmpdir(), 'logs-sdk-offline');
+        this.maxSize = 50 * 1024 * 1024; // 50MB
+        this.maxAge = 24 * 60 * 60 * 1000; // 24h
+        this.enabled = true;
+        if (!fs.existsSync(this.dir)) {
+            fs.mkdirSync(this.dir, { recursive: true });
+        }
+    }
+    /** 保存一批日志到离线缓存 */
+    save(entries) {
+        if (!this.enabled || entries.length === 0)
+            return;
+        this.cleanup();
+        const filename = path.join(this.dir, `offline-${new Date().toISOString().replace(/[:.]/g, '-')}.json`);
+        try {
+            fs.writeFileSync(filename, JSON.stringify(entries), 'utf-8');
+            console.log(`[logs-sdk] 离线缓存已保存: ${filename} (${entries.length} 条)`);
+        }
+        catch (err) {
+            console.error('[logs-sdk] 离线缓存保存失败:', err);
+        }
+    }
+    /** 读取所有离线缓存，通过回调发送，成功则删除 */
+    async flushAll(sendFn) {
+        let files = [];
+        try {
+            files = fs.readdirSync(this.dir)
+                .filter(f => f.startsWith('offline-') && f.endsWith('.json'))
+                .map(f => path.join(this.dir, f));
+        }
+        catch {
+            return;
+        }
+        if (files.length === 0)
+            return;
+        for (const file of files) {
+            try {
+                const stat = fs.statSync(file);
+                if (Date.now() - stat.mtimeMs > this.maxAge) {
+                    fs.unlinkSync(file);
+                    console.log(`[logs-sdk] 过期离线缓存已删除: ${file}`);
+                    continue;
+                }
+                const data = fs.readFileSync(file, 'utf-8');
+                const entries = JSON.parse(data);
+                await sendFn(entries);
+                fs.unlinkSync(file);
+                console.log(`[logs-sdk] 离线缓存已重传: ${file} (${entries.length} 条)`);
+            }
+            catch (err) {
+                console.error(`[logs-sdk] 离线缓存重传失败: ${file}`, err);
+                return; // 保留文件，下次重试
+            }
+        }
+    }
+    /** 返回待重传的文件数 */
+    pendingCount() {
+        try {
+            return fs.readdirSync(this.dir).filter(f => f.startsWith('offline-')).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+    enable() { this.enabled = true; }
+    disable() { this.enabled = false; }
+    cleanup() {
+        let files = [];
+        try {
+            files = fs.readdirSync(this.dir).map(f => path.join(this.dir, f));
+        }
+        catch {
+            return;
+        }
+        let totalSize = 0;
+        const stats = [];
+        for (const f of files) {
+            try {
+                const st = fs.statSync(f);
+                totalSize += st.size;
+                stats.push({ file: f, mtime: st.mtimeMs, size: st.size });
+            }
+            catch { /* skip */ }
+        }
+        stats.sort((a, b) => a.mtime - b.mtime);
+        for (const s of stats) {
+            if (totalSize <= this.maxSize)
+                break;
+            try {
+                fs.unlinkSync(s.file);
+                totalSize -= s.size;
+            }
+            catch { /* skip */ }
+        }
+    }
+}
+exports.OfflineCache = OfflineCache;
+//# sourceMappingURL=offline.js.map

package/dist/offline.js.map

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

package/dist/retry.d.ts

@@ -0,0 +1,11 @@
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelay: number;
+    maxDelay: number;
+}
+/**
+ * 使用指数退避策略重试执行异步函数。
+ * 重试间隔: baseDelay * 2^attempt，最大不超过 maxDelay。
+ */
+export declare function retryWithBackoff<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAQD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CAqBZ"}

package/dist/retry.js

@@ -0,0 +1,34 @@
+"use strict";
+// 指数退避重试策略
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retryWithBackoff = retryWithBackoff;
+const defaultRetryConfig = {
+    maxRetries: 3,
+    baseDelay: 500, // 500ms
+    maxDelay: 10000, // 10s
+};
+/**
+ * 使用指数退避策略重试执行异步函数。
+ * 重试间隔: baseDelay * 2^attempt，最大不超过 maxDelay。
+ */
+async function retryWithBackoff(fn, config = {}) {
+    const cfg = { ...defaultRetryConfig, ...config };
+    let lastError;
+    for (let attempt = 0; attempt <= cfg.maxRetries; attempt++) {
+        if (attempt > 0) {
+            const delay = Math.min(cfg.baseDelay * Math.pow(2, attempt - 1), cfg.maxDelay);
+            await sleep(delay);
+        }
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+        }
+    }
+    throw lastError;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":";AAAA,WAAW;;AAkBX,4CAwBC;AAlCD,MAAM,kBAAkB,GAAgB;IACtC,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,GAAG,EAAI,QAAQ;IAC1B,QAAQ,EAAE,KAAK,EAAG,MAAM;CACzB,CAAC;AAEF;;;GAGG;AACI,KAAK,UAAU,gBAAgB,CACpC,EAAoB,EACpB,SAA+B,EAAE;IAEjC,MAAM,GAAG,GAAG,EAAE,GAAG,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC3D,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EACxC,GAAG,CAAC,QAAQ,CACb,CAAC;YACF,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+/** SDK 客户端配置 */
+export interface LogSDKConfig {
+    /** 日志上报地址，如 "https://api.logs.codexs.cn/api/v1/ingest/logs" */
+    endpoint: string;
+    /** SDK 认证密钥（公钥） */
+    apiKey: string;
+    /** SDK 认证密钥（私钥），用于请求签名 */
+    apiSecret: string;
+    /** 项目短标识 */
+    projectSlug: string;
+    /** 当前运行环境：production/staging/development，默认 "production" */
+    environment?: 'production' | 'staging' | 'development';
+    /** 微服务名称 */
+    serviceName?: string;
+    /** 本地缓冲容量，默认 1000，满 80% 自动 flush */
+    bufferSize?: number;
+    /** 定时刷新间隔（秒），默认 5 */
+    flushInterval?: number;
+    /** 最大重试次数，默认 3 */
+    maxRetries?: number;
+    /** 请求/响应体最大采集大小（字节），默认 4096 */
+    maxBodySize?: number;
+    /** 错误堆栈最大采集大小（字节），默认 8192 */
+    maxStackSize?: number;
+}
+/** 客户端类型 */
+export type ClientType = 'web' | 'miniprogram' | 'app' | 'server' | 'other';
+/** 错误类型 */
+export type ErrorType = 'panic' | 'business_error' | 'http_error' | 'timeout';
+/** 日志条目 — 与 Go SDK / ClickHouse 表完全对齐 */
+export interface LogEntry {
+    uuid: string;
+    timestamp: string;
+    duration_ms: number;
+    method: string;
+    scheme: string;
+    full_url: string;
+    host_header: string;
+    path: string;
+    query_string: string;
+    origin: string;
+    request_headers: string;
+    request_body: string;
+    request_body_size: number;
+    content_type: string;
+    status_code: number;
+    response_headers: string;
+    response_body: string;
+    response_body_size: number;
+    client_ip: string;
+    client_ip_chain: string;
+    client_type: ClientType;
+    client_port: number;
+    user_agent: string;
+    is_error: boolean;
+    error_message: string;
+    error_type: ErrorType | '';
+    error_stack: string;
+    panic_location?: string;
+    trace_id: string;
+    span_id: string;
+    parent_span_id: string;
+    user_id: string;
+    session_id: string;
+    project_slug: string;
+    environment: string;
+    service_name: string;
+    host: string;
+    process_id: string;
+    tls_version?: string;
+    tls_cipher?: string;
+    proto?: string;
+    api_version?: string;
+    referer?: string;
+    upstream_status?: number;
+    latency_breakdown?: string;
+    request_id?: string;
+    tags?: Record<string, unknown>;
+}
+/** 内部配置（已合并默认值） */
+export interface ResolvedConfig extends Required<LogSDKConfig> {
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// SDK 核心类型定义 — 与 Go SDK 完全对齐
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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,6BAA6B"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@xiaohao0725/logs-sdk",
+  "version": "0.3.3",
+  "description": "日志管理平台 Node.js SDK，提供 Express/Koa 中间件，自动采集 HTTP 请求日志并上报",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "logs",
+    "sdk",
+    "middleware",
+    "express",
+    "koa",
+    "logging"
+  ],
+  "license": "UNLICENSED",
+  "dependencies": {
+    "uuid": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.1",
+    "@types/koa": "^2.15.0",
+    "@types/node": "^24.12.3",
+    "@types/uuid": "^10.0.0",
+    "typescript": "~5.8.0"
+  },
+  "peerDependencies": {
+    "express": "^4.0.0 || ^5.0.0",
+    "koa": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "koa": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}