@plolink/sdk 0.0.4

package/README.md

@@ -0,0 +1,259 @@
+# @plolink/sdk
+
+Plolink 开放平台官方 SDK，提供完整的 API 调用能力。
+
+## 特性
+
+- 🔐 **统一认证**：使用 Bearer Token 认证，支持 ApiKey 和 SessionId
+- 🔄 **智能轮询**：内置指数退避轮询机制，自动处理异步任务
+- 📦 **分包导入**：支持按需导入，减少打包体积
+- 🌍 **跨环境**：同时支持 Node.js 和浏览器环境
+- 📝 **类型安全**：完整的 TypeScript 类型定义
+- 🔌 **可扩展**：支持自定义日志钩子，轻松集成 Sentry 等监控系统
+- 📚 **文档齐全**：代码即文档，完整的 TSDoc 注释
+
+## 安装
+
+```bash
+npm install @plolink/sdk
+# 或
+pnpm add @plolink/sdk
+# 或
+yarn add @plolink/sdk
+```
+
+## 快速开始
+
+### 使用 ApiKey
+
+```typescript
+import { PlolinkClient } from '@plolink/sdk';
+
+const client = new PlolinkClient({
+  token: 'pl_your-api-key',
+  logger: (level, message, data) => {
+    console.log(`[${level}] ${message}`, data);
+  }
+});
+
+// 检查健康状态
+const health = client.healthCheck();
+console.log(health);
+```
+
+### 使用 SessionId（登录后获取）
+
+```typescript
+import { PlolinkClient } from '@plolink/sdk';
+
+// 先登录获取 sessionId
+const loginResponse = await fetch('https://api.plolink.com/api/v1/auth/login/password', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ email: 'user@example.com', password: 'password' })
+});
+const { sessionId } = await loginResponse.json();
+
+// 使用 sessionId 创建客户端
+const client = new PlolinkClient({
+  token: sessionId,
+  baseUrl: 'https://api.plolink.com'
+});
+```
+
+## 业务模块
+
+SDK 提供多个业务模块，支持按需导入：
+
+### 充值消费模块 (Billing)
+
+```typescript
+import { Billing } from '@plolink/sdk/billing';
+
+const billing = new Billing(client);
+const balance = await billing.getBalance();
+```
+
+### 虚拟账号模块 (VirtualAccount)
+
+```typescript
+import { VirtualAccount } from '@plolink/sdk/virtual-account';
+
+const virtualAccount = new VirtualAccount(client);
+
+// 创建虚拟账号
+const result = await virtualAccount.createVirtualAccount({
+  mode: 'EXISTING_TEAM',
+  teamId: 'team-123',
+  virtualAccountName: 'API Service',
+  presetRoles: [{
+    roleType: 'SYSTEM',
+    roleCode: 'TEAM_MEMBER',
+    scopeType: 'TEAM'
+  }]
+});
+
+// 管理 API Keys
+const keys = await virtualAccount.listVirtualAccountApiKeys(result.virtualAccount.id);
+```
+
+详细文档请参考 docs/modules/
+
+## 高级功能
+
+### 自定义日志
+
+```typescript
+import { PlolinkClient } from '@plolink/sdk';
+import * as Sentry from '@sentry/node';
+
+const client = new PlolinkClient({
+  token: 'pl_your-api-key',
+  logger: (level, message, data) => {
+    if (level === 'error') {
+      Sentry.captureMessage(message, {
+        level: 'error',
+        extra: data
+      });
+    }
+  }
+});
+```
+
+### 使用轮询器
+
+```typescript
+import { Poller } from '@plolink/sdk';
+
+const poller = new Poller({
+  task: () => fetch('/api/order/123').then(r => r.json()),
+  onResult: (data) => {
+    console.log('Order status:', data.status);
+  },
+  shouldStop: (data) => data.status === 'success',
+  initialInterval: 1000,
+  maxInterval: 30000,
+  backoffFactor: 1.5
+});
+
+// 启动轮询
+poller.start();
+
+// 停止轮询
+poller.stop();
+```
+
+### 使用事件发射器
+
+```typescript
+import { EventEmitter } from '@plolink/sdk';
+
+const emitter = new EventEmitter();
+
+// 订阅事件
+const unsubscribe = emitter.on('status-change', (data) => {
+  console.log('Status changed:', data);
+});
+
+// 触发事件
+emitter.emit('status-change', { status: 'completed' });
+
+// 取消订阅
+unsubscribe();
+```
+
+## 配置选项
+
+```typescript
+interface SDKConfig {
+  /**
+   * API 基础 URL
+   * @default 'https://hiring.djangotech.com/'
+   */
+  baseUrl?: string;
+
+  /**
+   * 认证 Token (ApiKey 或 SessionId)
+   * - ApiKey: pl_ 开头的字符串
+   * - SessionId: 登录后返回的 UUID 格式字符串
+   */
+  token: string;
+
+  /**
+   * 自定义日志钩子函数
+   */
+  logger?: (level: string, message: string, data?: any) => void;
+
+  /**
+   * 请求超时时间（毫秒）
+   * @default 10000
+   */
+  timeout?: number;
+}
+```
+
+## 错误处理
+
+所有错误都会被转换为 `PlolinkError`：
+
+```typescript
+import { PlolinkClient, PlolinkError } from '@plolink/sdk';
+
+try {
+  const result = await client.someMethod();
+} catch (error) {
+  if (error instanceof PlolinkError) {
+    console.error(`Error ${error.code}: ${error.message}`);
+    console.error('Additional data:', error.data);
+  }
+}
+```
+
+## 环境检测
+
+```typescript
+import { isNode, isBrowser, getEnvironment } from '@plolink/sdk';
+
+if (isNode) {
+  console.log('Running in Node.js');
+}
+
+if (isBrowser) {
+  console.log('Running in browser');
+}
+
+console.log('Environment:', getEnvironment());
+```
+
+## 开发
+
+### 构建
+
+```bash
+pnpm install
+pnpm build
+```
+
+### 测试
+
+```bash
+pnpm test
+pnpm test:watch
+```
+
+### 生成文档
+
+```bash
+pnpm docs
+```
+
+### 类型检查
+
+```bash
+pnpm typecheck
+```
+
+## 技术支持
+
+- 📧 Email: admin@wj2015.com
+

package/dist/chunk-4H4RACSE.js

@@ -0,0 +1,335 @@
+// src/common/hooks.ts
+var EventEmitter = class {
+  constructor() {
+    /**
+     * 事件处理器映射表
+     */
+    this.handlers = /* @__PURE__ */ new Map();
+    /**
+     * 一次性事件处理器集合
+     */
+    this.onceHandlers = /* @__PURE__ */ new Map();
+  }
+  /**
+   * 订阅事件
+   * 
+   * @param event - 事件名称
+   * @param handler - 事件处理函数
+   * @returns 取消订阅的函数
+   * 
+   * @example
+   * ```typescript
+   * const unsubscribe = emitter.on('data', (payload) => {
+   *   console.log('Received:', payload);
+   * });
+   * 
+   * // 不再需要时取消订阅
+   * unsubscribe();
+   * ```
+   */
+  on(event, handler) {
+    if (!this.handlers.has(event)) {
+      this.handlers.set(event, /* @__PURE__ */ new Set());
+    }
+    const handlers = this.handlers.get(event);
+    handlers.add(handler);
+    return () => {
+      handlers.delete(handler);
+      if (handlers.size === 0) {
+        this.handlers.delete(event);
+      }
+    };
+  }
+  /**
+   * 订阅一次性事件
+   * 
+   * @description
+   * 事件处理函数只会执行一次，执行后自动取消订阅。
+   * 
+   * @param event - 事件名称
+   * @param handler - 事件处理函数
+   * @returns 取消订阅的函数
+   * 
+   * @example
+   * ```typescript
+   * emitter.once('complete', (result) => {
+   *   console.log('Task completed:', result);
+   * });
+   * ```
+   */
+  once(event, handler) {
+    if (!this.onceHandlers.has(event)) {
+      this.onceHandlers.set(event, /* @__PURE__ */ new Set());
+    }
+    const handlers = this.onceHandlers.get(event);
+    handlers.add(handler);
+    return () => {
+      handlers.delete(handler);
+      if (handlers.size === 0) {
+        this.onceHandlers.delete(event);
+      }
+    };
+  }
+  /**
+   * 触发事件
+   * 
+   * @param event - 事件名称
+   * @param data - 传递给处理函数的数据
+   * 
+   * @example
+   * ```typescript
+   * emitter.emit('status-change', { 
+   *   from: 'pending', 
+   *   to: 'completed' 
+   * });
+   * ```
+   */
+  emit(event, data) {
+    const handlers = this.handlers.get(event);
+    if (handlers) {
+      handlers.forEach((handler) => {
+        try {
+          handler(data);
+        } catch (error) {
+          console.error(`Error in event handler for "${event}":`, error);
+        }
+      });
+    }
+    const onceHandlers = this.onceHandlers.get(event);
+    if (onceHandlers) {
+      const handlersToExecute = Array.from(onceHandlers);
+      this.onceHandlers.delete(event);
+      handlersToExecute.forEach((handler) => {
+        try {
+          handler(data);
+        } catch (error) {
+          console.error(`Error in once event handler for "${event}":`, error);
+        }
+      });
+    }
+  }
+  /**
+   * 取消订阅指定事件的处理器
+   * 
+   * @param event - 事件名称
+   * @param handler - 可选，要取消的事件处理函数。如果不提供，则取消所有处理器
+   * 
+   * @example
+   * ```typescript
+   * // 取消所有处理器
+   * emitter.off('status-change');
+   * 
+   * // 取消特定处理器
+   * const handler = (data) => console.log(data);
+   * emitter.on('data', handler);
+   * emitter.off('data', handler);
+   * ```
+   */
+  off(event, handler) {
+    if (!handler) {
+      this.handlers.delete(event);
+      this.onceHandlers.delete(event);
+      return;
+    }
+    const handlers = this.handlers.get(event);
+    if (handlers) {
+      handlers.delete(handler);
+      if (handlers.size === 0) {
+        this.handlers.delete(event);
+      }
+    }
+    const onceHandlers = this.onceHandlers.get(event);
+    if (onceHandlers) {
+      onceHandlers.delete(handler);
+      if (onceHandlers.size === 0) {
+        this.onceHandlers.delete(event);
+      }
+    }
+  }
+  /**
+   * 清除所有事件处理器
+   * 
+   * @example
+   * ```typescript
+   * emitter.clear();
+   * ```
+   */
+  clear() {
+    this.handlers.clear();
+    this.onceHandlers.clear();
+  }
+  /**
+   * 获取指定事件的处理器数量
+   * 
+   * @param event - 事件名称
+   * @returns 处理器数量
+   * 
+   * @example
+   * ```typescript
+   * const count = emitter.listenerCount('status-change');
+   * console.log(`${count} listeners registered`);
+   * ```
+   */
+  listenerCount(event) {
+    const regularCount = this.handlers.get(event)?.size || 0;
+    const onceCount = this.onceHandlers.get(event)?.size || 0;
+    return regularCount + onceCount;
+  }
+  /**
+   * 获取所有已注册的事件名称
+   * 
+   * @returns 事件名称数组
+   * 
+   * @example
+   * ```typescript
+   * const events = emitter.eventNames();
+   * console.log('Registered events:', events);
+   * ```
+   */
+  eventNames() {
+    const regularEvents = Array.from(this.handlers.keys());
+    const onceEvents = Array.from(this.onceHandlers.keys());
+    return Array.from(/* @__PURE__ */ new Set([...regularEvents, ...onceEvents]));
+  }
+};
+var TypedEventEmitter = class {
+  constructor() {
+    this.emitter = new EventEmitter();
+  }
+  /**
+   * 订阅事件（类型安全）
+   */
+  on(event, handler) {
+    return this.emitter.on(event, handler);
+  }
+  /**
+   * 订阅一次性事件（类型安全）
+   */
+  once(event, handler) {
+    return this.emitter.once(event, handler);
+  }
+  /**
+   * 触发事件（类型安全）
+   */
+  emit(event, data) {
+    this.emitter.emit(event, data);
+  }
+  /**
+   * 取消订阅（类型安全）
+   */
+  off(event, handler) {
+    if (handler) {
+      this.emitter.off(event, handler);
+    } else {
+      this.emitter.off(event);
+    }
+  }
+  /**
+   * 清除所有事件处理器
+   */
+  clear() {
+    this.emitter.clear();
+  }
+  /**
+   * 获取指定事件的处理器数量
+   */
+  listenerCount(event) {
+    return this.emitter.listenerCount(event);
+  }
+  /**
+   * 获取所有已注册的事件名称
+   */
+  eventNames() {
+    return this.emitter.eventNames();
+  }
+};
+
+// src/common/adapter.ts
+var isNode = typeof process !== "undefined" && process.versions !== null && process.versions.node !== null;
+var isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+var isWebWorker = typeof self === "object" && // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access
+typeof self.importScripts === "function";
+function getEnvironment() {
+  if (isNode) return "node";
+  if (isWebWorker) return "worker";
+  if (isBrowser) return "browser";
+  return "unknown";
+}
+function isValidFileInput(input) {
+  if (isNode) {
+    return Buffer.isBuffer(input);
+  }
+  if (isBrowser) {
+    return input instanceof Blob || input instanceof File;
+  }
+  return false;
+}
+function getFileSize(input) {
+  if (isNode && Buffer.isBuffer(input)) {
+    return input.length;
+  }
+  if ((isBrowser || isWebWorker) && (input instanceof Blob || input instanceof File)) {
+    return input.size;
+  }
+  throw new Error("Unsupported file input type");
+}
+function getFileName(input) {
+  if (input instanceof File) {
+    return input.name;
+  }
+  return void 0;
+}
+var features = {
+  /**
+   * 是否支持 FormData
+   */
+  hasFormData: typeof FormData !== "undefined",
+  /**
+   * 是否支持 Blob
+   */
+  hasBlob: typeof Blob !== "undefined",
+  /**
+   * 是否支持 File
+   */
+  hasFile: typeof File !== "undefined",
+  /**
+   * 是否支持 FileReader
+   */
+  hasFileReader: typeof FileReader !== "undefined",
+  /**
+   * 是否支持 fetch API
+   */
+  hasFetch: typeof fetch !== "undefined",
+  /**
+   * 是否支持 Stream API
+   */
+  hasStream: typeof ReadableStream !== "undefined"
+};
+var environmentInfo = {
+  type: getEnvironment(),
+  isNode,
+  isBrowser,
+  isWebWorker,
+  features
+};
+function assertEnvironment(expectedEnv, message) {
+  const currentEnv = getEnvironment();
+  if (currentEnv !== expectedEnv) {
+    throw new Error(
+      message || `This feature requires ${expectedEnv} environment, but running in ${currentEnv}`
+    );
+  }
+}
+async function safeDynamicImport(moduleName) {
+  assertEnvironment("node", `Cannot import module "${moduleName}" in non-Node.js environment`);
+  try {
+    return await import(moduleName);
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to import module "${moduleName}": ${errorMessage}`);
+  }
+}
+
+export { EventEmitter, TypedEventEmitter, assertEnvironment, environmentInfo, features, getEnvironment, getFileName, getFileSize, isBrowser, isNode, isValidFileInput, isWebWorker, safeDynamicImport };
+//# sourceMappingURL=chunk-4H4RACSE.js.map
+//# sourceMappingURL=chunk-4H4RACSE.js.map

package/dist/chunk-4H4RACSE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/hooks.ts","../src/common/adapter.ts"],"names":[],"mappings":"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","file":"chunk-4H4RACSE.js","sourcesContent":["/**\n * 事件处理函数类型\n */\ntype EventHandler<T = unknown> = (data: T) => void;\n\n/**\n * 事件处理器映射类型\n */\ntype EventHandlerMap = Map<string, Set<EventHandler>>;\n\n/**\n * 事件发射器基础类\n * \n * @description\n * 提供简单的事件订阅/发布机制，用于业务模块的状态变化通知。\n * 支持类型安全的事件处理，适用于状态变化、进度更新等场景。\n * \n * @example\n * ```typescript\n * // 创建事件发射器\n * const emitter = new EventEmitter();\n * \n * // 订阅事件\n * const unsubscribe = emitter.on('status-change', (data) => {\n *   console.log('Status changed:', data);\n * });\n * \n * // 触发事件\n * emitter.emit('status-change', { status: 'completed' });\n * \n * // 取消订阅\n * unsubscribe();\n * \n * // 一次性事件\n * emitter.once('complete', (data) => {\n *   console.log('Completed:', data);\n * });\n * ```\n */\nexport class EventEmitter {\n  /**\n   * 事件处理器映射表\n   */\n  private handlers: EventHandlerMap = new Map();\n\n  /**\n   * 一次性事件处理器集合\n   */\n  private onceHandlers: EventHandlerMap = new Map();\n\n  /**\n   * 订阅事件\n   * \n   * @param event - 事件名称\n   * @param handler - 事件处理函数\n   * @returns 取消订阅的函数\n   * \n   * @example\n   * ```typescript\n   * const unsubscribe = emitter.on('data', (payload) => {\n   *   console.log('Received:', payload);\n   * });\n   * \n   * // 不再需要时取消订阅\n   * unsubscribe();\n   * ```\n   */\n  public on<T = unknown>(event: string, handler: EventHandler<T>): () => void {\n    if (!this.handlers.has(event)) {\n      this.handlers.set(event, new Set());\n    }\n\n    const handlers = this.handlers.get(event)!;\n    handlers.add(handler as EventHandler);\n\n    // 返回取消订阅函数\n    return () => {\n      handlers.delete(handler as EventHandler);\n      if (handlers.size === 0) {\n        this.handlers.delete(event);\n      }\n    };\n  }\n\n  /**\n   * 订阅一次性事件\n   * \n   * @description\n   * 事件处理函数只会执行一次，执行后自动取消订阅。\n   * \n   * @param event - 事件名称\n   * @param handler - 事件处理函数\n   * @returns 取消订阅的函数\n   * \n   * @example\n   * ```typescript\n   * emitter.once('complete', (result) => {\n   *   console.log('Task completed:', result);\n   * });\n   * ```\n   */\n  public once<T = unknown>(event: string, handler: EventHandler<T>): () => void {\n    if (!this.onceHandlers.has(event)) {\n      this.onceHandlers.set(event, new Set());\n    }\n\n    const handlers = this.onceHandlers.get(event)!;\n    handlers.add(handler as EventHandler);\n\n    // 返回取消订阅函数\n    return () => {\n      handlers.delete(handler as EventHandler);\n      if (handlers.size === 0) {\n        this.onceHandlers.delete(event);\n      }\n    };\n  }\n\n  /**\n   * 触发事件\n   * \n   * @param event - 事件名称\n   * @param data - 传递给处理函数的数据\n   * \n   * @example\n   * ```typescript\n   * emitter.emit('status-change', { \n   *   from: 'pending', \n   *   to: 'completed' \n   * });\n   * ```\n   */\n  public emit<T = unknown>(event: string, data: T): void {\n    // 执行常规事件处理器\n    const handlers = this.handlers.get(event);\n    if (handlers) {\n      handlers.forEach((handler) => {\n        try {\n          handler(data);\n        } catch (error) {\n          console.error(`Error in event handler for \"${event}\":`, error);\n        }\n      });\n    }\n\n    // 执行一次性事件处理器\n    const onceHandlers = this.onceHandlers.get(event);\n    if (onceHandlers) {\n      const handlersToExecute = Array.from(onceHandlers);\n      // 清空一次性处理器\n      this.onceHandlers.delete(event);\n\n      handlersToExecute.forEach((handler) => {\n        try {\n          handler(data);\n        } catch (error) {\n          console.error(`Error in once event handler for \"${event}\":`, error);\n        }\n      });\n    }\n  }\n\n  /**\n   * 取消订阅指定事件的处理器\n   * \n   * @param event - 事件名称\n   * @param handler - 可选，要取消的事件处理函数。如果不提供，则取消所有处理器\n   * \n   * @example\n   * ```typescript\n   * // 取消所有处理器\n   * emitter.off('status-change');\n   * \n   * // 取消特定处理器\n   * const handler = (data) => console.log(data);\n   * emitter.on('data', handler);\n   * emitter.off('data', handler);\n   * ```\n   */\n  public off<T = unknown>(event: string, handler?: EventHandler<T>): void {\n    if (!handler) {\n      // 取消所有处理器\n      this.handlers.delete(event);\n      this.onceHandlers.delete(event);\n      return;\n    }\n\n    // 取消特定处理器\n    const handlers = this.handlers.get(event);\n    if (handlers) {\n      handlers.delete(handler as EventHandler);\n      if (handlers.size === 0) {\n        this.handlers.delete(event);\n      }\n    }\n\n    const onceHandlers = this.onceHandlers.get(event);\n    if (onceHandlers) {\n      onceHandlers.delete(handler as EventHandler);\n      if (onceHandlers.size === 0) {\n        this.onceHandlers.delete(event);\n      }\n    }\n  }\n\n  /**\n   * 清除所有事件处理器\n   * \n   * @example\n   * ```typescript\n   * emitter.clear();\n   * ```\n   */\n  public clear(): void {\n    this.handlers.clear();\n    this.onceHandlers.clear();\n  }\n\n  /**\n   * 获取指定事件的处理器数量\n   * \n   * @param event - 事件名称\n   * @returns 处理器数量\n   * \n   * @example\n   * ```typescript\n   * const count = emitter.listenerCount('status-change');\n   * console.log(`${count} listeners registered`);\n   * ```\n   */\n  public listenerCount(event: string): number {\n    const regularCount = this.handlers.get(event)?.size || 0;\n    const onceCount = this.onceHandlers.get(event)?.size || 0;\n    return regularCount + onceCount;\n  }\n\n  /**\n   * 获取所有已注册的事件名称\n   * \n   * @returns 事件名称数组\n   * \n   * @example\n   * ```typescript\n   * const events = emitter.eventNames();\n   * console.log('Registered events:', events);\n   * ```\n   */\n  public eventNames(): string[] {\n    const regularEvents = Array.from(this.handlers.keys());\n    const onceEvents = Array.from(this.onceHandlers.keys());\n    return Array.from(new Set([...regularEvents, ...onceEvents]));\n  }\n}\n\n/**\n * 类型安全的事件发射器\n * \n * @description\n * 提供类型约束的事件发射器，确保事件名称和数据类型的正确性。\n * \n * @template TEvents - 事件映射类型\n * \n * @example\n * ```typescript\n * // 定义事件类型\n * interface TaskEvents {\n *   'status-change': { status: string };\n *   'progress': { percent: number };\n *   'error': { message: string };\n * }\n * \n * // 创建类型安全的发射器\n * const emitter = new TypedEventEmitter<TaskEvents>();\n * \n * // TypeScript 会检查事件名称和数据类型\n * emitter.on('status-change', (data) => {\n *   console.log(data.status); // TypeScript 知道 data 有 status 属性\n * });\n * \n * emitter.emit('status-change', { status: 'completed' }); // OK\n * emitter.emit('status-change', { wrong: 'data' }); // TypeScript 报错\n * ```\n */\nexport class TypedEventEmitter<TEvents extends Record<string, unknown>> {\n  private emitter = new EventEmitter();\n\n  /**\n   * 订阅事件（类型安全）\n   */\n  public on<K extends keyof TEvents>(\n    event: K,\n    handler: EventHandler<TEvents[K]>\n  ): () => void {\n    return this.emitter.on(event as string, handler);\n  }\n\n  /**\n   * 订阅一次性事件（类型安全）\n   */\n  public once<K extends keyof TEvents>(\n    event: K,\n    handler: EventHandler<TEvents[K]>\n  ): () => void {\n    return this.emitter.once(event as string, handler);\n  }\n\n  /**\n   * 触发事件（类型安全）\n   */\n  public emit<K extends keyof TEvents>(event: K, data: TEvents[K]): void {\n    this.emitter.emit(event as string, data);\n  }\n\n  /**\n   * 取消订阅（类型安全）\n   */\n  public off<K extends keyof TEvents>(event: K, handler?: EventHandler<TEvents[K]>): void {\n    if (handler) {\n      this.emitter.off(event as string, handler);\n    } else {\n      this.emitter.off(event as string);\n    }\n  }\n\n  /**\n   * 清除所有事件处理器\n   */\n  public clear(): void {\n    this.emitter.clear();\n  }\n\n  /**\n   * 获取指定事件的处理器数量\n   */\n  public listenerCount<K extends keyof TEvents>(event: K): number {\n    return this.emitter.listenerCount(event as string);\n  }\n\n  /**\n   * 获取所有已注册的事件名称\n   */\n  public eventNames(): Array<keyof TEvents> {\n    return this.emitter.eventNames() as Array<keyof TEvents>;\n  }\n}\n\n","/**\n * 环境适配工具\n * \n * @description\n * 提供跨环境（Node.js / 浏览器）的工具函数和类型检测。\n * 用于处理文件上传、网络请求等在不同环境下有差异的功能。\n */\n\n/**\n * 检测当前是否运行在 Node.js 环境\n * \n * @returns 如果在 Node.js 环境返回 true，否则返回 false\n * \n * @example\n * ```typescript\n * if (isNode) {\n *   // 使用 Node.js 特有的 API\n *   const fs = require('fs');\n * }\n * ```\n */\nexport const isNode: boolean =\n  typeof process !== 'undefined' &&\n  process.versions !== null &&\n  process.versions.node !== null;\n\n/**\n * 检测当前是否运行在浏览器环境\n * \n * @returns 如果在浏览器环境返回 true，否则返回 false\n * \n * @example\n * ```typescript\n * if (isBrowser) {\n *   // 使用浏览器 API\n *   const file = new File(['content'], 'file.txt');\n * }\n * ```\n */\nexport const isBrowser: boolean =\n  typeof window !== 'undefined' && typeof window.document !== 'undefined';\n\n/**\n * 检测当前是否支持 Web Worker\n * \n * @returns 如果支持 Web Worker 返回 true，否则返回 false\n */\nexport const isWebWorker: boolean =\n  typeof self === 'object' &&\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access\n  typeof (self as any).importScripts === 'function';\n\n/**\n * 获取运行环境类型\n * \n * @returns 环境类型字符串\n * \n * @example\n * ```typescript\n * const env = getEnvironment();\n * console.log(`Running in ${env}`); // \"node\" 或 \"browser\" 或 \"worker\"\n * ```\n */\nexport function getEnvironment(): 'node' | 'browser' | 'worker' | 'unknown' {\n  if (isNode) return 'node';\n  if (isWebWorker) return 'worker';\n  if (isBrowser) return 'browser';\n  return 'unknown';\n}\n\n/**\n * 文件类型联合类型\n * 在 Node.js 中是 Buffer，在浏览器中是 Blob 或 File\n */\nexport type FileInput = Buffer | Blob | File;\n\n/**\n * 检测是否为有效的文件输入\n * \n * @param input - 待检测的输入\n * @returns 如果是有效的文件输入返回 true\n * \n * @example\n * ```typescript\n * const file = new File(['content'], 'test.txt');\n * if (isValidFileInput(file)) {\n *   // 处理文件\n * }\n * ```\n */\nexport function isValidFileInput(input: unknown): input is FileInput {\n  if (isNode) {\n    // Node.js 环境：检查是否为 Buffer\n    return Buffer.isBuffer(input);\n  }\n\n  if (isBrowser) {\n    // 浏览器环境：检查是否为 Blob 或 File\n    return input instanceof Blob || input instanceof File;\n  }\n\n  return false;\n}\n\n/**\n * 获取文件输入的大小（字节）\n * \n * @param input - 文件输入\n * @returns 文件大小（字节）\n * @throws {Error} 如果输入类型不支持\n * \n * @example\n * ```typescript\n * const file = new File(['content'], 'test.txt');\n * const size = getFileSize(file);\n * console.log(`File size: ${size} bytes`);\n * ```\n */\nexport function getFileSize(input: FileInput): number {\n  if (isNode && Buffer.isBuffer(input)) {\n    return input.length;\n  }\n\n  if ((isBrowser || isWebWorker) && (input instanceof Blob || input instanceof File)) {\n    return input.size;\n  }\n\n  throw new Error('Unsupported file input type');\n}\n\n/**\n * 获取文件名（仅适用于 File 对象）\n * \n * @param input - 文件输入\n * @returns 文件名，如果无法获取则返回 undefined\n * \n * @example\n * ```typescript\n * const file = new File(['content'], 'test.txt');\n * const name = getFileName(file);\n * console.log(name); // \"test.txt\"\n * ```\n */\nexport function getFileName(input: FileInput): string | undefined {\n  if (input instanceof File) {\n    return input.name;\n  }\n  return undefined;\n}\n\n/**\n * 环境特定功能检测\n */\nexport const features = {\n  /**\n   * 是否支持 FormData\n   */\n  hasFormData: typeof FormData !== 'undefined',\n\n  /**\n   * 是否支持 Blob\n   */\n  hasBlob: typeof Blob !== 'undefined',\n\n  /**\n   * 是否支持 File\n   */\n  hasFile: typeof File !== 'undefined',\n\n  /**\n   * 是否支持 FileReader\n   */\n  hasFileReader: typeof FileReader !== 'undefined',\n\n  /**\n   * 是否支持 fetch API\n   */\n  hasFetch: typeof fetch !== 'undefined',\n\n  /**\n   * 是否支持 Stream API\n   */\n  hasStream: typeof ReadableStream !== 'undefined',\n} as const;\n\n/**\n * 环境信息对象\n * \n * @example\n * ```typescript\n * console.log(environmentInfo);\n * // {\n * //   type: 'browser',\n * //   isNode: false,\n * //   isBrowser: true,\n * //   features: { ... }\n * // }\n * ```\n */\nexport const environmentInfo = {\n  type: getEnvironment(),\n  isNode,\n  isBrowser,\n  isWebWorker,\n  features,\n} as const;\n\n/**\n * 断言当前环境\n * \n * @param expectedEnv - 期望的环境类型\n * @param message - 自定义错误消息\n * @throws {Error} 如果当前环境不符合预期\n * \n * @example\n * ```typescript\n * // 确保在 Node.js 环境中运行\n * assertEnvironment('node', 'This feature requires Node.js');\n * ```\n */\nexport function assertEnvironment(\n  expectedEnv: 'node' | 'browser' | 'worker',\n  message?: string\n): void {\n  const currentEnv = getEnvironment();\n  if (currentEnv !== expectedEnv) {\n    throw new Error(\n      message ||\n        `This feature requires ${expectedEnv} environment, but running in ${currentEnv}`\n    );\n  }\n}\n\n/**\n * 安全地动态导入模块（仅 Node.js）\n * \n * @description\n * 在 Node.js 环境中动态导入模块，避免在浏览器环境中引起错误。\n * \n * @param moduleName - 模块名称\n * @returns Promise，resolve 为模块对象\n * @throws {Error} 如果不在 Node.js 环境或模块加载失败\n * \n * @example\n * ```typescript\n * if (isNode) {\n *   const fs = await safeDynamicImport('fs');\n *   const content = fs.readFileSync('file.txt', 'utf-8');\n * }\n * ```\n */\nexport async function safeDynamicImport<T = unknown>(moduleName: string): Promise<T> {\n  assertEnvironment('node', `Cannot import module \"${moduleName}\" in non-Node.js environment`);\n  \n  try {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return await import(moduleName);\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    throw new Error(`Failed to import module \"${moduleName}\": ${errorMessage}`);\n  }\n}\n\n"]}