@plolink/sdk 0.0.4

package/dist/chunk-IHAAKFEJ.js

@@ -0,0 +1,219 @@
+// src/common/poller.ts
+var Poller = class {
+  /**
+   * 创建一个 Poller 实例
+   * 
+   * @param options - 轮询器配置选项
+   * 
+   * @example
+   * ```typescript
+   * const poller = new Poller({
+   *   task: async () => {
+   *     const response = await fetch('/api/status');
+   *     return response.json();
+   *   },
+   *   onResult: (data) => console.log(data),
+   *   shouldStop: (data) => data.completed === true
+   * });
+   * ```
+   */
+  constructor(options) {
+    /**
+     * 定时器引用
+     */
+    this.timer = null;
+    /**
+     * 当前重试次数
+     */
+    this.retryCount = 0;
+    /**
+     * 是否正在运行
+     */
+    this.isRunning = false;
+    /**
+     * 是否正在执行任务
+     */
+    this.isExecuting = false;
+    this.options = {
+      task: options.task,
+      onResult: options.onResult,
+      shouldStop: options.shouldStop,
+      initialInterval: options.initialInterval ?? 1e3,
+      maxInterval: options.maxInterval ?? 3e4,
+      backoffFactor: options.backoffFactor ?? 1.5,
+      onError: options.onError ?? (() => {
+      })
+    };
+    this.currentInterval = this.options.initialInterval;
+  }
+  /**
+   * 启动或恢复轮询
+   * 
+   * @description
+   * 如果轮询器已经在运行，此方法不会有任何效果。
+   * 首次调用会立即执行一次任务。
+   * 
+   * @returns Promise，在首次任务执行完成后 resolve
+   * 
+   * @example
+   * ```typescript
+   * await poller.start();
+   * console.log('Polling started');
+   * ```
+   */
+  async start() {
+    if (this.isRunning) {
+      return;
+    }
+    this.isRunning = true;
+    await this.execute();
+  }
+  /**
+   * 停止轮询
+   * 
+   * @description
+   * 停止后可以通过再次调用 start() 恢复轮询。
+   * 如果有正在执行的任务，会等待其完成。
+   * 
+   * @example
+   * ```typescript
+   * poller.stop();
+   * console.log('Polling stopped');
+   * ```
+   */
+  stop() {
+    this.isRunning = false;
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+  }
+  /**
+   * 执行轮询任务
+   * 
+   * @private
+   */
+  async execute() {
+    if (!this.isRunning || this.isExecuting) {
+      return;
+    }
+    this.isExecuting = true;
+    try {
+      const result = await this.options.task();
+      this.options.onResult(result);
+      if (this.options.shouldStop(result)) {
+        this.stop();
+        return;
+      }
+      this.currentInterval = this.options.initialInterval;
+      this.retryCount = 0;
+    } catch (error) {
+      this.retryCount++;
+      this.currentInterval = Math.min(
+        this.options.initialInterval * Math.pow(this.options.backoffFactor, this.retryCount),
+        this.options.maxInterval
+      );
+      this.options.onError(error);
+    } finally {
+      this.isExecuting = false;
+    }
+    if (this.isRunning) {
+      this.timer = setTimeout(() => {
+        void this.execute();
+      }, this.currentInterval);
+    }
+  }
+  /**
+   * 获取当前状态快照
+   * 
+   * @description
+   * 用于保存轮询器的当前状态，以便后续恢复。
+   * 这在组件卸载/重新挂载场景中非常有用。
+   * 
+   * @returns 状态快照对象
+   * 
+   * @example
+   * ```typescript
+   * const snapshot = poller.getSnapshot();
+   * localStorage.setItem('poller-state', JSON.stringify(snapshot));
+   * 
+   * // 恢复时
+   * const snapshot = JSON.parse(localStorage.getItem('poller-state'));
+   * poller.restoreFromSnapshot(snapshot);
+   * ```
+   */
+  getSnapshot() {
+    return {
+      retryCount: this.retryCount,
+      currentInterval: this.currentInterval,
+      isRunning: this.isRunning
+    };
+  }
+  /**
+   * 从状态快照恢复
+   * 
+   * @description
+   * 从之前保存的快照中恢复轮询器状态。
+   * 注意：此方法不会自动启动轮询，需要手动调用 start()。
+   * 
+   * @param snapshot - 状态快照对象
+   * 
+   * @example
+   * ```typescript
+   * const snapshot = {
+   *   retryCount: 3,
+   *   currentInterval: 3375,
+   *   isRunning: false
+   * };
+   * poller.restoreFromSnapshot(snapshot);
+   * 
+   * // 如果需要继续轮询
+   * if (snapshot.isRunning) {
+   *   poller.start();
+   * }
+   * ```
+   */
+  restoreFromSnapshot(snapshot) {
+    this.retryCount = snapshot.retryCount;
+    this.currentInterval = snapshot.currentInterval;
+  }
+  /**
+   * 重置轮询器状态
+   * 
+   * @description
+   * 将轮询器重置到初始状态（重试次数归零，间隔重置）。
+   * 不会停止正在运行的轮询。
+   * 
+   * @example
+   * ```typescript
+   * poller.reset();
+   * ```
+   */
+  reset() {
+    this.retryCount = 0;
+    this.currentInterval = this.options.initialInterval;
+  }
+  /**
+   * 获取当前状态信息
+   * 
+   * @returns 包含当前状态的对象
+   * 
+   * @example
+   * ```typescript
+   * const status = poller.getStatus();
+   * console.log(`Running: ${status.isRunning}, Retry: ${status.retryCount}`);
+   * ```
+   */
+  getStatus() {
+    return {
+      isRunning: this.isRunning,
+      isExecuting: this.isExecuting,
+      retryCount: this.retryCount,
+      currentInterval: this.currentInterval
+    };
+  }
+};
+
+export { Poller };
+//# sourceMappingURL=chunk-IHAAKFEJ.js.map
+//# sourceMappingURL=chunk-IHAAKFEJ.js.map

package/dist/chunk-IHAAKFEJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/poller.ts"],"names":[],"mappings":"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","file":"chunk-IHAAKFEJ.js","sourcesContent":["import type { PollerOptions, PollerSnapshot } from '../types';\n\n/**\n * 指数退避轮询器\n * \n * @description\n * 实现了智能轮询机制，具有以下特性：\n * - **指数退避**：失败时按配置的退避因子增加轮询间隔\n * - **自动停止**：通过 shouldStop 判断终态自动停止\n * - **状态快照**：支持导出和恢复轮询状态\n * - **挂载恢复**：适用于组件卸载后重新挂载的场景\n * \n * @template T - 轮询任务返回值的类型\n * \n * @example\n * ```typescript\n * // 创建轮询器\n * const poller = new Poller({\n *   task: () => fetch('/api/order/123').then(r => r.json()),\n *   onResult: (data) => {\n *     console.log('Order status:', data.status);\n *   },\n *   shouldStop: (data) => data.status === 'success' || data.status === 'failed',\n *   initialInterval: 1000,\n *   maxInterval: 30000,\n *   backoffFactor: 1.5,\n *   onError: (error) => {\n *     console.error('Polling error:', error);\n *   }\n * });\n * \n * // 启动轮询\n * poller.start();\n * \n * // 停止轮询\n * poller.stop();\n * \n * // 导出状态快照（用于恢复）\n * const snapshot = poller.getSnapshot();\n * \n * // 从快照恢复\n * poller.restoreFromSnapshot(snapshot);\n * ```\n */\nexport class Poller<T> {\n  /**\n   * 轮询配置选项\n   */\n  private readonly options: Required<PollerOptions<T>>;\n\n  /**\n   * 定时器引用\n   */\n  private timer: ReturnType<typeof setTimeout> | null = null;\n\n  /**\n   * 当前轮询间隔（毫秒）\n   */\n  private currentInterval: number;\n\n  /**\n   * 当前重试次数\n   */\n  private retryCount: number = 0;\n\n  /**\n   * 是否正在运行\n   */\n  private isRunning: boolean = false;\n\n  /**\n   * 是否正在执行任务\n   */\n  private isExecuting: boolean = false;\n\n  /**\n   * 创建一个 Poller 实例\n   * \n   * @param options - 轮询器配置选项\n   * \n   * @example\n   * ```typescript\n   * const poller = new Poller({\n   *   task: async () => {\n   *     const response = await fetch('/api/status');\n   *     return response.json();\n   *   },\n   *   onResult: (data) => console.log(data),\n   *   shouldStop: (data) => data.completed === true\n   * });\n   * ```\n   */\n  constructor(options: PollerOptions<T>) {\n    // 填充默认配置\n    this.options = {\n      task: options.task,\n      onResult: options.onResult,\n      shouldStop: options.shouldStop,\n      initialInterval: options.initialInterval ?? 1000,\n      maxInterval: options.maxInterval ?? 30000,\n      backoffFactor: options.backoffFactor ?? 1.5,\n      onError: options.onError ?? (() => {}),\n    };\n\n    this.currentInterval = this.options.initialInterval;\n  }\n\n  /**\n   * 启动或恢复轮询\n   * \n   * @description\n   * 如果轮询器已经在运行，此方法不会有任何效果。\n   * 首次调用会立即执行一次任务。\n   * \n   * @returns Promise，在首次任务执行完成后 resolve\n   * \n   * @example\n   * ```typescript\n   * await poller.start();\n   * console.log('Polling started');\n   * ```\n   */\n  public async start(): Promise<void> {\n    if (this.isRunning) {\n      return;\n    }\n\n    this.isRunning = true;\n    await this.execute();\n  }\n\n  /**\n   * 停止轮询\n   * \n   * @description\n   * 停止后可以通过再次调用 start() 恢复轮询。\n   * 如果有正在执行的任务，会等待其完成。\n   * \n   * @example\n   * ```typescript\n   * poller.stop();\n   * console.log('Polling stopped');\n   * ```\n   */\n  public stop(): void {\n    this.isRunning = false;\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n  }\n\n  /**\n   * 执行轮询任务\n   * \n   * @private\n   */\n  private async execute(): Promise<void> {\n    if (!this.isRunning || this.isExecuting) {\n      return;\n    }\n\n    this.isExecuting = true;\n\n    try {\n      // 执行任务\n      const result = await this.options.task();\n\n      // 调用结果回调\n      this.options.onResult(result);\n\n      // 检查是否应该停止\n      if (this.options.shouldStop(result)) {\n        this.stop();\n        return;\n      }\n\n      // 任务成功，重置退避参数\n      this.currentInterval = this.options.initialInterval;\n      this.retryCount = 0;\n    } catch (error) {\n      // 任务失败，应用指数退避\n      this.retryCount++;\n      this.currentInterval = Math.min(\n        this.options.initialInterval * Math.pow(this.options.backoffFactor, this.retryCount),\n        this.options.maxInterval\n      );\n\n      // 调用错误回调\n      this.options.onError(error);\n    } finally {\n      this.isExecuting = false;\n    }\n\n    // 如果仍在运行，安排下一次执行\n    if (this.isRunning) {\n      this.timer = setTimeout(() => {\n        void this.execute();\n      }, this.currentInterval);\n    }\n  }\n\n  /**\n   * 获取当前状态快照\n   * \n   * @description\n   * 用于保存轮询器的当前状态，以便后续恢复。\n   * 这在组件卸载/重新挂载场景中非常有用。\n   * \n   * @returns 状态快照对象\n   * \n   * @example\n   * ```typescript\n   * const snapshot = poller.getSnapshot();\n   * localStorage.setItem('poller-state', JSON.stringify(snapshot));\n   * \n   * // 恢复时\n   * const snapshot = JSON.parse(localStorage.getItem('poller-state'));\n   * poller.restoreFromSnapshot(snapshot);\n   * ```\n   */\n  public getSnapshot(): PollerSnapshot {\n    return {\n      retryCount: this.retryCount,\n      currentInterval: this.currentInterval,\n      isRunning: this.isRunning,\n    };\n  }\n\n  /**\n   * 从状态快照恢复\n   * \n   * @description\n   * 从之前保存的快照中恢复轮询器状态。\n   * 注意：此方法不会自动启动轮询，需要手动调用 start()。\n   * \n   * @param snapshot - 状态快照对象\n   * \n   * @example\n   * ```typescript\n   * const snapshot = {\n   *   retryCount: 3,\n   *   currentInterval: 3375,\n   *   isRunning: false\n   * };\n   * poller.restoreFromSnapshot(snapshot);\n   * \n   * // 如果需要继续轮询\n   * if (snapshot.isRunning) {\n   *   poller.start();\n   * }\n   * ```\n   */\n  public restoreFromSnapshot(snapshot: PollerSnapshot): void {\n    this.retryCount = snapshot.retryCount;\n    this.currentInterval = snapshot.currentInterval;\n    // 注意：不自动恢复 isRunning 状态，由调用方决定是否启动\n  }\n\n  /**\n   * 重置轮询器状态\n   * \n   * @description\n   * 将轮询器重置到初始状态（重试次数归零，间隔重置）。\n   * 不会停止正在运行的轮询。\n   * \n   * @example\n   * ```typescript\n   * poller.reset();\n   * ```\n   */\n  public reset(): void {\n    this.retryCount = 0;\n    this.currentInterval = this.options.initialInterval;\n  }\n\n  /**\n   * 获取当前状态信息\n   * \n   * @returns 包含当前状态的对象\n   * \n   * @example\n   * ```typescript\n   * const status = poller.getStatus();\n   * console.log(`Running: ${status.isRunning}, Retry: ${status.retryCount}`);\n   * ```\n   */\n  public getStatus(): {\n    isRunning: boolean;\n    isExecuting: boolean;\n    retryCount: number;\n    currentInterval: number;\n  } {\n    return {\n      isRunning: this.isRunning,\n      isExecuting: this.isExecuting,\n      retryCount: this.retryCount,\n      currentInterval: this.currentInterval,\n    };\n  }\n}\n\n"]}

package/dist/chunk-JR4HYYQI.cjs

@@ -0,0 +1,221 @@
+'use strict';
+
+// src/common/poller.ts
+var Poller = class {
+  /**
+   * 创建一个 Poller 实例
+   * 
+   * @param options - 轮询器配置选项
+   * 
+   * @example
+   * ```typescript
+   * const poller = new Poller({
+   *   task: async () => {
+   *     const response = await fetch('/api/status');
+   *     return response.json();
+   *   },
+   *   onResult: (data) => console.log(data),
+   *   shouldStop: (data) => data.completed === true
+   * });
+   * ```
+   */
+  constructor(options) {
+    /**
+     * 定时器引用
+     */
+    this.timer = null;
+    /**
+     * 当前重试次数
+     */
+    this.retryCount = 0;
+    /**
+     * 是否正在运行
+     */
+    this.isRunning = false;
+    /**
+     * 是否正在执行任务
+     */
+    this.isExecuting = false;
+    this.options = {
+      task: options.task,
+      onResult: options.onResult,
+      shouldStop: options.shouldStop,
+      initialInterval: options.initialInterval ?? 1e3,
+      maxInterval: options.maxInterval ?? 3e4,
+      backoffFactor: options.backoffFactor ?? 1.5,
+      onError: options.onError ?? (() => {
+      })
+    };
+    this.currentInterval = this.options.initialInterval;
+  }
+  /**
+   * 启动或恢复轮询
+   * 
+   * @description
+   * 如果轮询器已经在运行，此方法不会有任何效果。
+   * 首次调用会立即执行一次任务。
+   * 
+   * @returns Promise，在首次任务执行完成后 resolve
+   * 
+   * @example
+   * ```typescript
+   * await poller.start();
+   * console.log('Polling started');
+   * ```
+   */
+  async start() {
+    if (this.isRunning) {
+      return;
+    }
+    this.isRunning = true;
+    await this.execute();
+  }
+  /**
+   * 停止轮询
+   * 
+   * @description
+   * 停止后可以通过再次调用 start() 恢复轮询。
+   * 如果有正在执行的任务，会等待其完成。
+   * 
+   * @example
+   * ```typescript
+   * poller.stop();
+   * console.log('Polling stopped');
+   * ```
+   */
+  stop() {
+    this.isRunning = false;
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+  }
+  /**
+   * 执行轮询任务
+   * 
+   * @private
+   */
+  async execute() {
+    if (!this.isRunning || this.isExecuting) {
+      return;
+    }
+    this.isExecuting = true;
+    try {
+      const result = await this.options.task();
+      this.options.onResult(result);
+      if (this.options.shouldStop(result)) {
+        this.stop();
+        return;
+      }
+      this.currentInterval = this.options.initialInterval;
+      this.retryCount = 0;
+    } catch (error) {
+      this.retryCount++;
+      this.currentInterval = Math.min(
+        this.options.initialInterval * Math.pow(this.options.backoffFactor, this.retryCount),
+        this.options.maxInterval
+      );
+      this.options.onError(error);
+    } finally {
+      this.isExecuting = false;
+    }
+    if (this.isRunning) {
+      this.timer = setTimeout(() => {
+        void this.execute();
+      }, this.currentInterval);
+    }
+  }
+  /**
+   * 获取当前状态快照
+   * 
+   * @description
+   * 用于保存轮询器的当前状态，以便后续恢复。
+   * 这在组件卸载/重新挂载场景中非常有用。
+   * 
+   * @returns 状态快照对象
+   * 
+   * @example
+   * ```typescript
+   * const snapshot = poller.getSnapshot();
+   * localStorage.setItem('poller-state', JSON.stringify(snapshot));
+   * 
+   * // 恢复时
+   * const snapshot = JSON.parse(localStorage.getItem('poller-state'));
+   * poller.restoreFromSnapshot(snapshot);
+   * ```
+   */
+  getSnapshot() {
+    return {
+      retryCount: this.retryCount,
+      currentInterval: this.currentInterval,
+      isRunning: this.isRunning
+    };
+  }
+  /**
+   * 从状态快照恢复
+   * 
+   * @description
+   * 从之前保存的快照中恢复轮询器状态。
+   * 注意：此方法不会自动启动轮询，需要手动调用 start()。
+   * 
+   * @param snapshot - 状态快照对象
+   * 
+   * @example
+   * ```typescript
+   * const snapshot = {
+   *   retryCount: 3,
+   *   currentInterval: 3375,
+   *   isRunning: false
+   * };
+   * poller.restoreFromSnapshot(snapshot);
+   * 
+   * // 如果需要继续轮询
+   * if (snapshot.isRunning) {
+   *   poller.start();
+   * }
+   * ```
+   */
+  restoreFromSnapshot(snapshot) {
+    this.retryCount = snapshot.retryCount;
+    this.currentInterval = snapshot.currentInterval;
+  }
+  /**
+   * 重置轮询器状态
+   * 
+   * @description
+   * 将轮询器重置到初始状态（重试次数归零，间隔重置）。
+   * 不会停止正在运行的轮询。
+   * 
+   * @example
+   * ```typescript
+   * poller.reset();
+   * ```
+   */
+  reset() {
+    this.retryCount = 0;
+    this.currentInterval = this.options.initialInterval;
+  }
+  /**
+   * 获取当前状态信息
+   * 
+   * @returns 包含当前状态的对象
+   * 
+   * @example
+   * ```typescript
+   * const status = poller.getStatus();
+   * console.log(`Running: ${status.isRunning}, Retry: ${status.retryCount}`);
+   * ```
+   */
+  getStatus() {
+    return {
+      isRunning: this.isRunning,
+      isExecuting: this.isExecuting,
+      retryCount: this.retryCount,
+      currentInterval: this.currentInterval
+    };
+  }
+};
+
+exports.Poller = Poller;
+//# sourceMappingURL=chunk-JR4HYYQI.cjs.map
+//# sourceMappingURL=chunk-JR4HYYQI.cjs.map

package/dist/chunk-JR4HYYQI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/poller.ts"],"names":[],"mappings":"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","file":"chunk-JR4HYYQI.cjs","sourcesContent":["import type { PollerOptions, PollerSnapshot } from '../types';\n\n/**\n * 指数退避轮询器\n * \n * @description\n * 实现了智能轮询机制，具有以下特性：\n * - **指数退避**：失败时按配置的退避因子增加轮询间隔\n * - **自动停止**：通过 shouldStop 判断终态自动停止\n * - **状态快照**：支持导出和恢复轮询状态\n * - **挂载恢复**：适用于组件卸载后重新挂载的场景\n * \n * @template T - 轮询任务返回值的类型\n * \n * @example\n * ```typescript\n * // 创建轮询器\n * const poller = new Poller({\n *   task: () => fetch('/api/order/123').then(r => r.json()),\n *   onResult: (data) => {\n *     console.log('Order status:', data.status);\n *   },\n *   shouldStop: (data) => data.status === 'success' || data.status === 'failed',\n *   initialInterval: 1000,\n *   maxInterval: 30000,\n *   backoffFactor: 1.5,\n *   onError: (error) => {\n *     console.error('Polling error:', error);\n *   }\n * });\n * \n * // 启动轮询\n * poller.start();\n * \n * // 停止轮询\n * poller.stop();\n * \n * // 导出状态快照（用于恢复）\n * const snapshot = poller.getSnapshot();\n * \n * // 从快照恢复\n * poller.restoreFromSnapshot(snapshot);\n * ```\n */\nexport class Poller<T> {\n  /**\n   * 轮询配置选项\n   */\n  private readonly options: Required<PollerOptions<T>>;\n\n  /**\n   * 定时器引用\n   */\n  private timer: ReturnType<typeof setTimeout> | null = null;\n\n  /**\n   * 当前轮询间隔（毫秒）\n   */\n  private currentInterval: number;\n\n  /**\n   * 当前重试次数\n   */\n  private retryCount: number = 0;\n\n  /**\n   * 是否正在运行\n   */\n  private isRunning: boolean = false;\n\n  /**\n   * 是否正在执行任务\n   */\n  private isExecuting: boolean = false;\n\n  /**\n   * 创建一个 Poller 实例\n   * \n   * @param options - 轮询器配置选项\n   * \n   * @example\n   * ```typescript\n   * const poller = new Poller({\n   *   task: async () => {\n   *     const response = await fetch('/api/status');\n   *     return response.json();\n   *   },\n   *   onResult: (data) => console.log(data),\n   *   shouldStop: (data) => data.completed === true\n   * });\n   * ```\n   */\n  constructor(options: PollerOptions<T>) {\n    // 填充默认配置\n    this.options = {\n      task: options.task,\n      onResult: options.onResult,\n      shouldStop: options.shouldStop,\n      initialInterval: options.initialInterval ?? 1000,\n      maxInterval: options.maxInterval ?? 30000,\n      backoffFactor: options.backoffFactor ?? 1.5,\n      onError: options.onError ?? (() => {}),\n    };\n\n    this.currentInterval = this.options.initialInterval;\n  }\n\n  /**\n   * 启动或恢复轮询\n   * \n   * @description\n   * 如果轮询器已经在运行，此方法不会有任何效果。\n   * 首次调用会立即执行一次任务。\n   * \n   * @returns Promise，在首次任务执行完成后 resolve\n   * \n   * @example\n   * ```typescript\n   * await poller.start();\n   * console.log('Polling started');\n   * ```\n   */\n  public async start(): Promise<void> {\n    if (this.isRunning) {\n      return;\n    }\n\n    this.isRunning = true;\n    await this.execute();\n  }\n\n  /**\n   * 停止轮询\n   * \n   * @description\n   * 停止后可以通过再次调用 start() 恢复轮询。\n   * 如果有正在执行的任务，会等待其完成。\n   * \n   * @example\n   * ```typescript\n   * poller.stop();\n   * console.log('Polling stopped');\n   * ```\n   */\n  public stop(): void {\n    this.isRunning = false;\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n  }\n\n  /**\n   * 执行轮询任务\n   * \n   * @private\n   */\n  private async execute(): Promise<void> {\n    if (!this.isRunning || this.isExecuting) {\n      return;\n    }\n\n    this.isExecuting = true;\n\n    try {\n      // 执行任务\n      const result = await this.options.task();\n\n      // 调用结果回调\n      this.options.onResult(result);\n\n      // 检查是否应该停止\n      if (this.options.shouldStop(result)) {\n        this.stop();\n        return;\n      }\n\n      // 任务成功，重置退避参数\n      this.currentInterval = this.options.initialInterval;\n      this.retryCount = 0;\n    } catch (error) {\n      // 任务失败，应用指数退避\n      this.retryCount++;\n      this.currentInterval = Math.min(\n        this.options.initialInterval * Math.pow(this.options.backoffFactor, this.retryCount),\n        this.options.maxInterval\n      );\n\n      // 调用错误回调\n      this.options.onError(error);\n    } finally {\n      this.isExecuting = false;\n    }\n\n    // 如果仍在运行，安排下一次执行\n    if (this.isRunning) {\n      this.timer = setTimeout(() => {\n        void this.execute();\n      }, this.currentInterval);\n    }\n  }\n\n  /**\n   * 获取当前状态快照\n   * \n   * @description\n   * 用于保存轮询器的当前状态，以便后续恢复。\n   * 这在组件卸载/重新挂载场景中非常有用。\n   * \n   * @returns 状态快照对象\n   * \n   * @example\n   * ```typescript\n   * const snapshot = poller.getSnapshot();\n   * localStorage.setItem('poller-state', JSON.stringify(snapshot));\n   * \n   * // 恢复时\n   * const snapshot = JSON.parse(localStorage.getItem('poller-state'));\n   * poller.restoreFromSnapshot(snapshot);\n   * ```\n   */\n  public getSnapshot(): PollerSnapshot {\n    return {\n      retryCount: this.retryCount,\n      currentInterval: this.currentInterval,\n      isRunning: this.isRunning,\n    };\n  }\n\n  /**\n   * 从状态快照恢复\n   * \n   * @description\n   * 从之前保存的快照中恢复轮询器状态。\n   * 注意：此方法不会自动启动轮询，需要手动调用 start()。\n   * \n   * @param snapshot - 状态快照对象\n   * \n   * @example\n   * ```typescript\n   * const snapshot = {\n   *   retryCount: 3,\n   *   currentInterval: 3375,\n   *   isRunning: false\n   * };\n   * poller.restoreFromSnapshot(snapshot);\n   * \n   * // 如果需要继续轮询\n   * if (snapshot.isRunning) {\n   *   poller.start();\n   * }\n   * ```\n   */\n  public restoreFromSnapshot(snapshot: PollerSnapshot): void {\n    this.retryCount = snapshot.retryCount;\n    this.currentInterval = snapshot.currentInterval;\n    // 注意：不自动恢复 isRunning 状态，由调用方决定是否启动\n  }\n\n  /**\n   * 重置轮询器状态\n   * \n   * @description\n   * 将轮询器重置到初始状态（重试次数归零，间隔重置）。\n   * 不会停止正在运行的轮询。\n   * \n   * @example\n   * ```typescript\n   * poller.reset();\n   * ```\n   */\n  public reset(): void {\n    this.retryCount = 0;\n    this.currentInterval = this.options.initialInterval;\n  }\n\n  /**\n   * 获取当前状态信息\n   * \n   * @returns 包含当前状态的对象\n   * \n   * @example\n   * ```typescript\n   * const status = poller.getStatus();\n   * console.log(`Running: ${status.isRunning}, Retry: ${status.retryCount}`);\n   * ```\n   */\n  public getStatus(): {\n    isRunning: boolean;\n    isExecuting: boolean;\n    retryCount: number;\n    currentInterval: number;\n  } {\n    return {\n      isRunning: this.isRunning,\n      isExecuting: this.isExecuting,\n      retryCount: this.retryCount,\n      currentInterval: this.currentInterval,\n    };\n  }\n}\n\n"]}

package/dist/chunk-MD4O7FWT.js

@@ -0,0 +1,46 @@
+// src/core/error.ts
+var PlolinkError = class _PlolinkError extends Error {
+  /**
+   * 创建一个 PlolinkError 实例
+   * 
+   * @param message - 错误消息
+   * @param code - 错误代码
+   * @param data - 附加错误数据
+   */
+  constructor(message, code, data) {
+    super(message);
+    this.name = "PlolinkError";
+    this.code = code;
+    this.data = data;
+    Object.setPrototypeOf(this, _PlolinkError.prototype);
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _PlolinkError);
+    }
+  }
+  /**
+   * 将错误转换为 JSON 格式
+   * 
+   * @returns 包含错误信息的对象
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      data: this.data,
+      stack: this.stack
+    };
+  }
+  /**
+   * 将错误转换为字符串
+   * 
+   * @returns 错误的字符串表示
+   */
+  toString() {
+    return `${this.name} [${this.code}]: ${this.message}`;
+  }
+};
+
+export { PlolinkError };
+//# sourceMappingURL=chunk-MD4O7FWT.js.map
+//# sourceMappingURL=chunk-MD4O7FWT.js.map

package/dist/chunk-MD4O7FWT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/error.ts"],"names":[],"mappings":";AAmBO,IAAM,YAAA,GAAN,MAAM,aAAA,SAAqB,KAAA,CAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBtC,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAuB,IAAA,EAAgB;AAClE,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAGZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,aAAA,CAAa,SAAS,CAAA;AAGlD,IAAA,IAAI,MAAM,iBAAA,EAAmB;AAC3B,MAAA,KAAA,CAAM,iBAAA,CAAkB,MAAM,aAAY,CAAA;AAAA,IAC5C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,MAAA,GAAkC;AACvC,IAAA,OAAO;AAAA,MACL,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,OAAO,IAAA,CAAK;AAAA,KACd;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOgB,QAAA,GAAmB;AACjC,IAAA,OAAO,CAAA,EAAG,KAAK,IAAI,CAAA,EAAA,EAAK,KAAK,IAAI,CAAA,GAAA,EAAM,KAAK,OAAO,CAAA,CAAA;AAAA,EACrD;AACF","file":"chunk-MD4O7FWT.js","sourcesContent":["/**\n * Plolink SDK 统一错误类\n * \n * @description\n * 所有 SDK 内部的业务错误和网络错误都会被转换为 PlolinkError。\n * 调用方可以通过捕获此错误来统一处理异常情况。\n * \n * @example\n * ```typescript\n * try {\n *   await client.someMethod();\n * } catch (error) {\n *   if (error instanceof PlolinkError) {\n *     console.error(`Error ${error.code}: ${error.message}`);\n *     console.error('Additional data:', error.data);\n *   }\n * }\n * ```\n */\nexport class PlolinkError extends Error {\n  /**\n   * 错误代码\n   * 可以是 HTTP 状态码（数字）或业务错误码（字符串）\n   */\n  public readonly code: number | string;\n\n  /**\n   * 附加错误数据\n   * 包含后端返回的详细错误信息\n   */\n  public readonly data?: unknown;\n\n  /**\n   * 创建一个 PlolinkError 实例\n   * \n   * @param message - 错误消息\n   * @param code - 错误代码\n   * @param data - 附加错误数据\n   */\n  constructor(message: string, code: number | string, data?: unknown) {\n    super(message);\n    this.name = 'PlolinkError';\n    this.code = code;\n    this.data = data;\n\n    // 确保 instanceof 检查正常工作\n    Object.setPrototypeOf(this, PlolinkError.prototype);\n\n    // 捕获堆栈跟踪（V8 引擎）\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, PlolinkError);\n    }\n  }\n\n  /**\n   * 将错误转换为 JSON 格式\n   * \n   * @returns 包含错误信息的对象\n   */\n  public toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      data: this.data,\n      stack: this.stack,\n    };\n  }\n\n  /**\n   * 将错误转换为字符串\n   * \n   * @returns 错误的字符串表示\n   */\n  public override toString(): string {\n    return `${this.name} [${this.code}]: ${this.message}`;\n  }\n}\n\n"]}