webfunny-event-node-sdk-public 1.0.0

package/README.md

@@ -0,0 +1,302 @@
+# Webfunny Event Node SDK
+
+Webfunny事件上报Node.js SDK，对齐Java SDK API设计。
+
+## 安装
+
+```bash
+npm install webfunny-event-node-sdk
+```
+
+## 快速开始
+
+### 1. 创建客户端
+
+```typescript
+import { WebfunnyEventClient, WebfunnyEvent } from 'webfunny-event-node-sdk';
+
+// 方式1: 使用Builder模式（推荐）
+const client = WebfunnyEventClient.builder()
+  .serverUrl('https://your-server.com')
+  .projectId('your-project-id')
+  .eventSecret('your-secret')  // 可选，开启签名
+  .debug(true)                 // 可选，开启调试日志
+  .build();
+
+// 方式2: 直接使用配置对象
+const client = new WebfunnyEventClient({
+  serverUrl: 'https://your-server.com',
+  projectId: 'your-project-id',
+  debug: true
+});
+```
+
+### 2. 上报事件
+
+```typescript
+// 简单上报 - 只传点位ID
+client.track('12');
+
+// 带参数上报
+client.track('13', {
+  productId: 'P001',
+  amount: 99.99,
+  currency: 'CNY'
+});
+
+// 使用事件对象上报
+const event = new WebfunnyEvent('your-project-id', '12')
+  .setWeUserId('user123')
+  .setWeIp('192.168.1.1')
+  .addParam('platform', 'web')
+  .addParam('version', '1.0.0');
+
+client.track(event);
+```
+
+### 3. 立即上报
+
+```typescript
+// 同步立即上报（阻塞等待结果）
+const response = client.trackImmediately(event);
+console.log(response.code);  // 200表示成功
+```
+
+### 4. 批量上报
+
+```typescript
+const events = [
+  new WebfunnyEvent('project-id', 'event_1'),
+  new WebfunnyEvent('project-id', 'event_2'),
+  new WebfunnyEvent('project-id', 'event_3')
+];
+
+const response = client.trackBatch(events);
+```
+
+### 5. 关闭客户端
+
+```typescript
+// 应用关闭时调用，会刷新队列中剩余的事件
+client.shutdown();
+```
+
+## 配置项
+
+| 配置项 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| serverUrl | string | 是 | - | 服务端点地址 |
+| projectId | string | 是 | - | 项目ID |
+| eventSecret | string | 否 | - | 事件密钥，用于签名 |
+| signatureEnabled | boolean | 否 | false | 是否开启签名验证 |
+| batchSize | number | 否 | 10 | 批量上报大小 |
+| flushIntervalMs | number | 否 | 5000 | 自动刷新间隔(ms) |
+| maxQueueSize | number | 否 | 1000 | 最大队列大小 |
+| maxRetries | number | 否 | 3 | 最大重试次数 |
+| retryIntervalMs | number | 否 | 1000 | 重试间隔(ms) |
+| connectTimeoutMs | number | 否 | 5000 | 连接超时(ms) |
+| socketTimeoutMs | number | 否 | 10000 | 读取超时(ms) |
+| debug | boolean | 否 | false | 调试模式 |
+
+## WebfunnyEvent 事件对象
+
+### 系统字段（we开头）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| projectId | string | 项目ID（必填） |
+| pointId | string | 点位ID（必填） |
+| weUserId | string | 用户ID |
+| weCustomerKey | string | 客户Key |
+| weIp | string | IP地址 |
+| weCountry | string | 国家 |
+| weProvince | string | 省份 |
+| weCity | string | 城市 |
+| weHappenTime | number | 发生时间戳 |
+| weHappenDate | string | 发生日期 |
+| weHappenHour | string | 发生小时 |
+| weHappenMinute | string | 发生分钟 |
+| wePath | string | 页面路径 |
+| weFirstStepDay | string | 首次访问日期 |
+| weRelationPointId | string | 关联点位ID |
+| weRelationField | string | 关联字段 |
+
+### 自定义参数
+
+```typescript
+const event = new WebfunnyEvent('project-id', 'custom_event')
+  .addParam('productName', 'iPhone 15')      // 添加单个参数
+  .addParams({                               // 批量添加参数
+    category: 'electronics',
+    price: 6999,
+    count: 2
+  });
+```
+
+**注意**：自定义参数名不能以`we`开头，会被自动过滤。
+
+## 生命周期钩子
+
+```typescript
+client.setHooks({
+  beforeInit: () => {
+    console.log('SDK初始化前');
+  },
+  afterInit: () => {
+    console.log('SDK初始化后');
+  },
+  beforeReport: (event) => {
+    console.log('上报前:', event);
+    // 返回false可拦截上报
+    return true;
+  },
+  afterReport: (response) => {
+    console.log('上报后:', response);
+  },
+  onError: (error) => {
+    console.error('上报错误:', error);
+  }
+});
+```
+
+## 手动刷新队列
+
+```typescript
+// 同步刷新
+client.flush();
+
+// 异步刷新
+client.flushAsync();
+
+// 获取队列大小
+const size = client.getQueueSize();
+```
+
+## 异常处理
+
+```typescript
+import { WebfunnyEventException } from 'webfunny-event-node-sdk';
+
+try {
+  client.track(event);
+} catch (e) {
+  if (e instanceof WebfunnyEventException) {
+    console.error('错误码:', e.getCode());
+    console.error('错误信息:', e.message);
+  }
+}
+```
+
+## 签名验证
+
+开启签名验证可防止数据篡改：
+
+```typescript
+const client = WebfunnyEventClient.builder()
+  .serverUrl('https://your-server.com')
+  .projectId('your-project-id')
+  .eventSecret('your-secret-key')  // 设置密钥自动开启签名
+  .build();
+```
+
+## 完整示例
+
+```typescript
+import { WebfunnyEventClient, WebfunnyEvent, WebfunnyEventException } from 'webfunny-event-node-sdk';
+
+async function main() {
+  // 创建客户端
+  const client = WebfunnyEventClient.builder()
+    .serverUrl('https://event.webfunny.com')
+    .projectId('proj_123456')
+    .eventSecret('sk_abcdef')
+    .debug(true)
+    .batchSize(5)
+    .flushIntervalMs(3000)
+    .build();
+
+  // 设置钩子
+  client.setHooks({
+    beforeReport: (event) => {
+      console.log('准备上报:', event.pointId);
+      return true;
+    },
+    afterReport: (response) => {
+      console.log('上报完成:', response.code);
+    }
+  });
+
+  // 上报各种事件
+  client.track('app_start');
+  
+  client.track('page_view', {
+    page: '/home',
+    duration: 30
+  });
+
+  const clickEvent = new WebfunnyEvent('proj_123456', 'button_click')
+    .setWeUserId('user_001')
+    .addParam('buttonId', 'submit')
+    .addParam('page', '/checkout');
+  
+  client.track(clickEvent);
+
+  // 模拟应用关闭
+  setTimeout(() => {
+    client.shutdown();
+  }, 10000);
+}
+
+main().catch(console.error);
+```
+
+## API 参考
+
+### WebfunnyEventClient
+
+| 方法 | 说明 |
+|------|------|
+| `track(event)` | 上报事件到队列 |
+| `track(pointId, params)` | 快速上报带参数 |
+| `trackImmediately(event)` | 立即同步上报 |
+| `trackBatch(events)` | 批量上报 |
+| `flush()` | 刷新队列 |
+| `flushAsync()` | 异步刷新队列 |
+| `shutdown()` | 关闭客户端 |
+| `getQueueSize()` | 获取队列大小 |
+| `setHooks(hooks)` | 设置生命周期钩子 |
+| `builder()` | 获取Builder实例 |
+
+### WebfunnyEvent
+
+| 方法 | 说明 |
+|------|------|
+| `setProjectId(id)` | 设置项目ID |
+| `setPointId(id)` | 设置点位ID |
+| `setWeUserId(id)` | 设置用户ID |
+| `setWeIp(ip)` | 设置IP地址 |
+| `setWeCountry(country)` | 设置国家 |
+| `setWeProvince(province)` | 设置省份 |
+| `setWeCity(city)` | 设置城市 |
+| `setWeHappenTime(time)` | 设置发生时间 |
+| `setWePath(path)` | 设置页面路径 |
+| `addParam(key, value)` | 添加自定义参数 |
+| `addParams(params)` | 批量添加参数 |
+| `toObject()` | 转换为普通对象 |
+
+## 与Java SDK对比
+
+| 功能 | Java SDK | Node.js SDK |
+|------|----------|-------------|
+| 创建客户端 | `WebfunnyEventClient.builder()` | `WebfunnyEventClient.builder()` |
+| 上报事件 | `track(event)` | `track(event)` |
+| 立即上报 | `trackImmediately(event)` | `trackImmediately(event)` |
+| 批量上报 | `trackBatch(events)` | `trackBatch(events)` |
+| 关闭客户端 | `shutdown()` | `shutdown()` |
+| 事件对象 | `WebfunnyEvent` | `WebfunnyEvent` |
+| 异常类 | `WebfunnyEventException` | `WebfunnyEventException` |
+| 签名工具 | `SignatureUtil` | `SignatureUtil` |
+
+## License
+
+MIT

package/dist/constants/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Webfunny Event SDK 常量定义
+ * 对齐Java SDK的常量类设计
+ */
+/**
+ * SDK默认配置常量 - 对齐Java版
+ */
+export declare class DefaultConfig {
+    /** 默认批量大小 */
+    static readonly DEFAULT_BATCH_SIZE: number;
+    /** 默认刷新间隔(ms) */
+    static readonly DEFAULT_FLUSH_INTERVAL_MS: number;
+    /** 默认最大队列大小 */
+    static readonly DEFAULT_MAX_QUEUE_SIZE: number;
+    /** 默认最大重试次数 */
+    static readonly DEFAULT_MAX_RETRIES: number;
+    /** 默认重试间隔(ms) */
+    static readonly DEFAULT_RETRY_INTERVAL_MS: number;
+    /** 默认连接超时(ms) */
+    static readonly DEFAULT_CONNECT_TIMEOUT_MS: number;
+    /** 默认读取超时(ms) */
+    static readonly DEFAULT_SOCKET_TIMEOUT_MS: number;
+    /** SDK版本 */
+    static readonly SDK_VERSION: string;
+}
+/**
+ * HTTP常量
+ */
+export declare class HttpConstants {
+    /** 默认Content-Type */
+    static readonly CONTENT_TYPE: string;
+    /** 成功状态码 */
+    static readonly SUCCESS_CODE: number;
+    /** 上报接口路径 */
+    static readonly UPLOAD_PATH: string;
+}
+/**
+ * 错误码常量
+ */
+export declare class ErrorCode {
+    /** 成功 */
+    static readonly SUCCESS: number;
+    /** HTTP成功 */
+    static readonly HTTP_SUCCESS: number;
+    /** 参数错误 */
+    static readonly PARAM_ERROR: number;
+    /** 网络错误 */
+    static readonly NETWORK_ERROR: number;
+    /** 服务器错误 */
+    static readonly SERVER_ERROR: number;
+    /** 队列已满 */
+    static readonly QUEUE_FULL: number;
+    /** SDK未初始化 */
+    static readonly SDK_NOT_INIT: number;
+    /** 上报失败 */
+    static readonly REPORT_FAILED: number;
+}
+/**
+ * 错误消息常量
+ */
+export declare class ErrorMessage {
+    static readonly SDK_NOT_INITIALIZED: string;
+    static readonly PROJECT_ID_REQUIRED: string;
+    static readonly SERVER_URL_REQUIRED: string;
+    static readonly QUEUE_IS_FULL: string;
+    static readonly POINT_ID_REQUIRED: string;
+    static readonly CLIENT_SHUTDOWN: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,aAAa;IACxB,aAAa;IACb,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAM;IAChD,iBAAiB;IACjB,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAQ;IACzD,eAAe;IACf,MAAM,CAAC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAQ;IACtD,eAAe;IACf,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAK;IAChD,iBAAiB;IACjB,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAQ;IACzD,iBAAiB;IACjB,MAAM,CAAC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAQ;IAC1D,iBAAiB;IACjB,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAS;IAC1D,YAAY;IACZ,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAW;CAC/C;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,qBAAqB;IACrB,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAsB;IAC1D,YAAY;IACZ,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAO;IAC3C,aAAa;IACb,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAe;CACnD;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,SAAS;IACT,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAK;IACpC,aAAa;IACb,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAO;IAC3C,WAAW;IACX,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAQ;IAC3C,WAAW;IACX,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAQ;IAC7C,YAAY;IACZ,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAQ;IAC5C,WAAW;IACX,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAQ;IAC1C,cAAc;IACd,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAQ;IAC5C,WAAW;IACX,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAQ;CAC9C;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAA0B;IACrE,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAoB;IAC/D,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAoB;IAC/D,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAkB;IACvD,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAkB;IAC3D,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAsB;CAC9D"}

package/dist/constants/index.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Webfunny Event SDK 常量定义
+ * 对齐Java SDK的常量类设计
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorMessage = exports.ErrorCode = exports.HttpConstants = exports.DefaultConfig = void 0;
+/**
+ * SDK默认配置常量 - 对齐Java版
+ */
+class DefaultConfig {
+}
+exports.DefaultConfig = DefaultConfig;
+/** 默认批量大小 */
+DefaultConfig.DEFAULT_BATCH_SIZE = 10;
+/** 默认刷新间隔(ms) */
+DefaultConfig.DEFAULT_FLUSH_INTERVAL_MS = 5000;
+/** 默认最大队列大小 */
+DefaultConfig.DEFAULT_MAX_QUEUE_SIZE = 1000;
+/** 默认最大重试次数 */
+DefaultConfig.DEFAULT_MAX_RETRIES = 3;
+/** 默认重试间隔(ms) */
+DefaultConfig.DEFAULT_RETRY_INTERVAL_MS = 1000;
+/** 默认连接超时(ms) */
+DefaultConfig.DEFAULT_CONNECT_TIMEOUT_MS = 5000;
+/** 默认读取超时(ms) */
+DefaultConfig.DEFAULT_SOCKET_TIMEOUT_MS = 10000;
+/** SDK版本 */
+DefaultConfig.SDK_VERSION = '1.0.0';
+/**
+ * HTTP常量
+ */
+class HttpConstants {
+}
+exports.HttpConstants = HttpConstants;
+/** 默认Content-Type */
+HttpConstants.CONTENT_TYPE = 'application/json';
+/** 成功状态码 */
+HttpConstants.SUCCESS_CODE = 200;
+/** 上报接口路径 */
+HttpConstants.UPLOAD_PATH = '/upEvents';
+/**
+ * 错误码常量
+ */
+class ErrorCode {
+}
+exports.ErrorCode = ErrorCode;
+/** 成功 */
+ErrorCode.SUCCESS = 0;
+/** HTTP成功 */
+ErrorCode.HTTP_SUCCESS = 200;
+/** 参数错误 */
+ErrorCode.PARAM_ERROR = 1001;
+/** 网络错误 */
+ErrorCode.NETWORK_ERROR = 1002;
+/** 服务器错误 */
+ErrorCode.SERVER_ERROR = 1003;
+/** 队列已满 */
+ErrorCode.QUEUE_FULL = 1004;
+/** SDK未初始化 */
+ErrorCode.SDK_NOT_INIT = 1005;
+/** 上报失败 */
+ErrorCode.REPORT_FAILED = 1006;
+/**
+ * 错误消息常量
+ */
+class ErrorMessage {
+}
+exports.ErrorMessage = ErrorMessage;
+ErrorMessage.SDK_NOT_INITIALIZED = 'SDK未初始化，请先调用init()方法';
+ErrorMessage.PROJECT_ID_REQUIRED = 'projectId是必填参数';
+ErrorMessage.SERVER_URL_REQUIRED = 'serverUrl是必填参数';
+ErrorMessage.QUEUE_IS_FULL = '事件队列已满，事件被丢弃';
+ErrorMessage.POINT_ID_REQUIRED = 'pointId是必填参数';
+ErrorMessage.CLIENT_SHUTDOWN = 'Client已关闭，无法上报事件';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uc3RhbnRzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7O0dBR0c7OztBQUVIOztHQUVHO0FBQ0gsTUFBYSxhQUFhOztBQUExQixzQ0FpQkM7QUFoQkMsYUFBYTtBQUNHLGdDQUFrQixHQUFXLEVBQUUsQ0FBQztBQUNoRCxpQkFBaUI7QUFDRCx1Q0FBeUIsR0FBVyxJQUFJLENBQUM7QUFDekQsZUFBZTtBQUNDLG9DQUFzQixHQUFXLElBQUksQ0FBQztBQUN0RCxlQUFlO0FBQ0MsaUNBQW1CLEdBQVcsQ0FBQyxDQUFDO0FBQ2hELGlCQUFpQjtBQUNELHVDQUF5QixHQUFXLElBQUksQ0FBQztBQUN6RCxpQkFBaUI7QUFDRCx3Q0FBMEIsR0FBVyxJQUFJLENBQUM7QUFDMUQsaUJBQWlCO0FBQ0QsdUNBQXlCLEdBQVcsS0FBSyxDQUFDO0FBQzFELFlBQVk7QUFDSSx5QkFBVyxHQUFXLE9BQU8sQ0FBQztBQUdoRDs7R0FFRztBQUNILE1BQWEsYUFBYTs7QUFBMUIsc0NBT0M7QUFOQyxxQkFBcUI7QUFDTCwwQkFBWSxHQUFXLGtCQUFrQixDQUFDO0FBQzFELFlBQVk7QUFDSSwwQkFBWSxHQUFXLEdBQUcsQ0FBQztBQUMzQyxhQUFhO0FBQ0cseUJBQVcsR0FBVyxXQUFXLENBQUM7QUFHcEQ7O0dBRUc7QUFDSCxNQUFhLFNBQVM7O0FBQXRCLDhCQWlCQztBQWhCQyxTQUFTO0FBQ08saUJBQU8sR0FBVyxDQUFDLENBQUM7QUFDcEMsYUFBYTtBQUNHLHNCQUFZLEdBQVcsR0FBRyxDQUFDO0FBQzNDLFdBQVc7QUFDSyxxQkFBVyxHQUFXLElBQUksQ0FBQztBQUMzQyxXQUFXO0FBQ0ssdUJBQWEsR0FBVyxJQUFJLENBQUM7QUFDN0MsWUFBWTtBQUNJLHNCQUFZLEdBQVcsSUFBSSxDQUFDO0FBQzVDLFdBQVc7QUFDSyxvQkFBVSxHQUFXLElBQUksQ0FBQztBQUMxQyxjQUFjO0FBQ0Usc0JBQVksR0FBVyxJQUFJLENBQUM7QUFDNUMsV0FBVztBQUNLLHVCQUFhLEdBQVcsSUFBSSxDQUFDO0FBRy9DOztHQUVHO0FBQ0gsTUFBYSxZQUFZOztBQUF6QixvQ0FPQztBQU5pQixnQ0FBbUIsR0FBVyxzQkFBc0IsQ0FBQztBQUNyRCxnQ0FBbUIsR0FBVyxnQkFBZ0IsQ0FBQztBQUMvQyxnQ0FBbUIsR0FBVyxnQkFBZ0IsQ0FBQztBQUMvQywwQkFBYSxHQUFXLGNBQWMsQ0FBQztBQUN2Qyw4QkFBaUIsR0FBVyxjQUFjLENBQUM7QUFDM0MsNEJBQWUsR0FBVyxrQkFBa0IsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogV2ViZnVubnkgRXZlbnQgU0RLIOW4uOmHj+WumuS5iVxuICog5a+56b2QSmF2YSBTREvnmoTluLjph4/nsbvorr7orqFcbiAqL1xuXG4vKipcbiAqIFNES+m7mOiupOmFjee9ruW4uOmHjyAtIOWvuem9kEphdmHniYhcbiAqL1xuZXhwb3J0IGNsYXNzIERlZmF1bHRDb25maWcge1xuICAvKiog6buY6K6k5om56YeP5aSn5bCPICovXG4gIHN0YXRpYyByZWFkb25seSBERUZBVUxUX0JBVENIX1NJWkU6IG51bWJlciA9IDEwO1xuICAvKiog6buY6K6k5Yi35paw6Ze06ZqUKG1zKSAqL1xuICBzdGF0aWMgcmVhZG9ubHkgREVGQVVMVF9GTFVTSF9JTlRFUlZBTF9NUzogbnVtYmVyID0gNTAwMDtcbiAgLyoqIOm7mOiupOacgOWkp+mYn+WIl+Wkp+WwjyAqL1xuICBzdGF0aWMgcmVhZG9ubHkgREVGQVVMVF9NQVhfUVVFVUVfU0laRTogbnVtYmVyID0gMTAwMDtcbiAgLyoqIOm7mOiupOacgOWkp+mHjeivleasoeaVsCAqL1xuICBzdGF0aWMgcmVhZG9ubHkgREVGQVVMVF9NQVhfUkVUUklFUzogbnVtYmVyID0gMztcbiAgLyoqIOm7mOiupOmHjeivlemXtOmalChtcykgKi9cbiAgc3RhdGljIHJlYWRvbmx5IERFRkFVTFRfUkVUUllfSU5URVJWQUxfTVM6IG51bWJlciA9IDEwMDA7XG4gIC8qKiDpu5jorqTov57mjqXotoXml7YobXMpICovXG4gIHN0YXRpYyByZWFkb25seSBERUZBVUxUX0NPTk5FQ1RfVElNRU9VVF9NUzogbnVtYmVyID0gNTAwMDtcbiAgLyoqIOm7mOiupOivu+WPlui2heaXtihtcykgKi9cbiAgc3RhdGljIHJlYWRvbmx5IERFRkFVTFRfU09DS0VUX1RJTUVPVVRfTVM6IG51bWJlciA9IDEwMDAwO1xuICAvKiogU0RL54mI5pysICovXG4gIHN0YXRpYyByZWFkb25seSBTREtfVkVSU0lPTjogc3RyaW5nID0gJzEuMC4wJztcbn1cblxuLyoqXG4gKiBIVFRQ5bi46YePXG4gKi9cbmV4cG9ydCBjbGFzcyBIdHRwQ29uc3RhbnRzIHtcbiAgLyoqIOm7mOiupENvbnRlbnQtVHlwZSAqL1xuICBzdGF0aWMgcmVhZG9ubHkgQ09OVEVOVF9UWVBFOiBzdHJpbmcgPSAnYXBwbGljYXRpb24vanNvbic7XG4gIC8qKiDmiJDlip/nirbmgIHnoIEgKi9cbiAgc3RhdGljIHJlYWRvbmx5IFNVQ0NFU1NfQ09ERTogbnVtYmVyID0gMjAwO1xuICAvKiog5LiK5oql5o6l5Y+j6Lev5b6EICovXG4gIHN0YXRpYyByZWFkb25seSBVUExPQURfUEFUSDogc3RyaW5nID0gJy91cEV2ZW50cyc7XG59XG5cbi8qKlxuICog6ZSZ6K+v56CB5bi46YePXG4gKi9cbmV4cG9ydCBjbGFzcyBFcnJvckNvZGUge1xuICAvKiog5oiQ5YqfICovXG4gIHN0YXRpYyByZWFkb25seSBTVUNDRVNTOiBudW1iZXIgPSAwO1xuICAvKiogSFRUUOaIkOWKnyAqL1xuICBzdGF0aWMgcmVhZG9ubHkgSFRUUF9TVUNDRVNTOiBudW1iZXIgPSAyMDA7XG4gIC8qKiDlj4LmlbDplJnor68gKi9cbiAgc3RhdGljIHJlYWRvbmx5IFBBUkFNX0VSUk9SOiBudW1iZXIgPSAxMDAxO1xuICAvKiog572R57uc6ZSZ6K+vICovXG4gIHN0YXRpYyByZWFkb25seSBORVRXT1JLX0VSUk9SOiBudW1iZXIgPSAxMDAyO1xuICAvKiog5pyN5Yqh5Zmo6ZSZ6K+vICovXG4gIHN0YXRpYyByZWFkb25seSBTRVJWRVJfRVJST1I6IG51bWJlciA9IDEwMDM7XG4gIC8qKiDpmJ/liJflt7Lmu6EgKi9cbiAgc3RhdGljIHJlYWRvbmx5IFFVRVVFX0ZVTEw6IG51bWJlciA9IDEwMDQ7XG4gIC8qKiBTREvmnKrliJ3lp4vljJYgKi9cbiAgc3RhdGljIHJlYWRvbmx5IFNES19OT1RfSU5JVDogbnVtYmVyID0gMTAwNTtcbiAgLyoqIOS4iuaKpeWksei0pSAqL1xuICBzdGF0aWMgcmVhZG9ubHkgUkVQT1JUX0ZBSUxFRDogbnVtYmVyID0gMTAwNjtcbn1cblxuLyoqXG4gKiDplJnor6/mtojmga/luLjph49cbiAqL1xuZXhwb3J0IGNsYXNzIEVycm9yTWVzc2FnZSB7XG4gIHN0YXRpYyByZWFkb25seSBTREtfTk9UX0lOSVRJQUxJWkVEOiBzdHJpbmcgPSAnU0RL5pyq5Yid5aeL5YyW77yM6K+35YWI6LCD55SoaW5pdCgp5pa55rOVJztcbiAgc3RhdGljIHJlYWRvbmx5IFBST0pFQ1RfSURfUkVRVUlSRUQ6IHN0cmluZyA9ICdwcm9qZWN0SWTmmK/lv4Xloavlj4LmlbAnO1xuICBzdGF0aWMgcmVhZG9ubHkgU0VSVkVSX1VSTF9SRVFVSVJFRDogc3RyaW5nID0gJ3NlcnZlclVybOaYr+W/heWhq+WPguaVsCc7XG4gIHN0YXRpYyByZWFkb25seSBRVUVVRV9JU19GVUxMOiBzdHJpbmcgPSAn5LqL5Lu26Zif5YiX5bey5ruh77yM5LqL5Lu26KKr5Lii5byDJztcbiAgc3RhdGljIHJlYWRvbmx5IFBPSU5UX0lEX1JFUVVJUkVEOiBzdHJpbmcgPSAncG9pbnRJZOaYr+W/heWhq+WPguaVsCc7XG4gIHN0YXRpYyByZWFkb25seSBDTElFTlRfU0hVVERPV046IHN0cmluZyA9ICdDbGllbnTlt7LlhbPpl63vvIzml6Dms5XkuIrmiqXkuovku7YnO1xufVxuIl19

package/dist/core/EventBuilder.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 事件构建器
+ * 类似Java SDK的Builder模式
+ */
+import { EventData, EventType, EventLevel, SDKConfig } from '../types';
+/**
+ * 事件构建器类
+ * 使用Builder模式构建事件对象
+ */
+export declare class EventBuilder {
+    private event;
+    private config;
+    /**
+     * 构造函数
+     */
+    constructor(config: SDKConfig);
+    /**
+     * 初始化默认值
+     */
+    private initDefaultValues;
+    /**
+     * 设置事件名称
+     */
+    setEventName(eventName: string): EventBuilder;
+    /**
+     * 设置事件类型
+     */
+    setEventType(eventType: EventType): EventBuilder;
+    /**
+     * 设置事件级别
+     */
+    setLevel(level: EventLevel): EventBuilder;
+    /**
+     * 设置用户ID
+     */
+    setUserId(userId: string): EventBuilder;
+    /**
+     * 设置会话ID
+     */
+    setSessionId(sessionId: string): EventBuilder;
+    /**
+     * 设置页面URL
+     */
+    setPageUrl(pageUrl: string): EventBuilder;
+    /**
+     * 设置页面标题
+     */
+    setPageTitle(pageTitle: string): EventBuilder;
+    /**
+     * 添加属性
+     */
+    addProperty(key: string, value: any): EventBuilder;
+    /**
+     * 添加多个属性
+     */
+    addProperties(properties: Record<string, any>): EventBuilder;
+    /**
+     * 设置扩展数据
+     */
+    setExtra(extra: Record<string, any>): EventBuilder;
+    /**
+     * 添加扩展字段
+     */
+    addExtra(key: string, value: any): EventBuilder;
+    /**
+     * 设置时间戳
+     */
+    setTimestamp(timestamp: number): EventBuilder;
+    /**
+     * 构建事件对象
+     */
+    build(): EventData;
+    /**
+     * 重置构建器
+     */
+    reset(): EventBuilder;
+    /**
+     * 创建点击事件
+     */
+    static createClickEvent(config: SDKConfig, elementName: string): EventBuilder;
+    /**
+     * 创建页面浏览事件
+     */
+    static createPageViewEvent(config: SDKConfig, pageUrl: string, pageTitle?: string): EventBuilder;
+    /**
+     * 创建错误事件
+     */
+    static createErrorEvent(config: SDKConfig, errorMessage: string, errorStack?: string): EventBuilder;
+    /**
+     * 验证属性键
+     */
+    private validatePropertyKey;
+    /**
+     * 验证属性值
+     */
+    private validatePropertyValue;
+}
+//# sourceMappingURL=EventBuilder.d.ts.map

package/dist/core/EventBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBuilder.d.ts","sourceRoot":"","sources":["../../src/core/EventBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAIvE;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,MAAM,CAAY;IAE1B;;OAEG;gBACS,MAAM,EAAE,SAAS;IAK7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAQpD;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY;IAKvD;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY;IAKhD;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAK9C;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAKpD;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAKhD;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAKpD;;OAEG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,YAAY;IAkBzD;;OAEG;IACI,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,YAAY;IAWnE;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,YAAY;IAKzD;;OAEG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,YAAY;IAQtD;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAKpD;;OAEG;IACI,KAAK,IAAI,SAAS;IAQzB;;OAEG;IACI,KAAK,IAAI,YAAY;IAK5B;;OAEG;WACW,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY;IAOpF;;OAEG;WACW,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY;IAavG;;OAEG;WACW,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY;IAc1G;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAU9B"}