@plolink/sdk 0.0.8 → 0.0.9

package/dist/chunk-V6NFRYO2.cjs

@@ -0,0 +1,145 @@
+'use strict';
+
+var crypto = require('crypto');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var crypto__default = /*#__PURE__*/_interopDefault(crypto);
+
+// src/common/signature.ts
+var InfoSyncSignature = class _InfoSyncSignature {
+  /**
+   * 生成 HMAC-SHA256 签名
+   * 
+   * 签名算法:
+   * - message = `${timestamp}.${payload}`
+   * - signature = HMAC-SHA256(secretKey, message)
+   * 
+   * @param secretKey - 密钥（从创建 Webhook 配置时获得）
+   * @param timestamp - 时间戳（毫秒）
+   * @param payload - 负载字符串（通常是 JSON.stringify 后的请求体）
+   * @returns 签名（hex 格式）
+   * 
+   * @example
+   * ```typescript
+   * const timestamp = Date.now();
+   * const payload = JSON.stringify({ foo: 'bar' });
+   * const signature = InfoSyncSignature.generateSignature(
+   *   'your-secret-key',
+   *   timestamp,
+   *   payload
+   * );
+   * ```
+   */
+  static generateSignature(secretKey, timestamp, payload) {
+    const message = `${timestamp}.${payload}`;
+    const signature = crypto__default.default.createHmac("sha256", secretKey).update(message).digest("hex");
+    return signature;
+  }
+  /**
+   * 验证 HMAC-SHA256 签名
+   * 
+   * @param secretKey - 密钥
+   * @param timestamp - 时间戳（毫秒）
+   * @param payload - 负载字符串
+   * @param signature - 待验证的签名
+   * @returns 签名是否有效
+   * 
+   * @example
+   * ```typescript
+   * const isValid = InfoSyncSignature.verifySignature(
+   *   secretKey,
+   *   timestamp,
+   *   payload,
+   *   signature
+   * );
+   * 
+   * if (!isValid) {
+   *   throw new Error('Invalid signature');
+   * }
+   * ```
+   */
+  static verifySignature(secretKey, timestamp, payload, signature) {
+    try {
+      const expected = _InfoSyncSignature.generateSignature(
+        secretKey,
+        timestamp,
+        payload
+      );
+      return crypto__default.default.timingSafeEqual(
+        Buffer.from(expected, "hex"),
+        Buffer.from(signature, "hex")
+      );
+    } catch (error) {
+      return false;
+    }
+  }
+  /**
+   * 验证时间戳是否在有效期内
+   * 
+   * 用于防止重放攻击，确保请求是最近发送的
+   * 
+   * @param timestamp - 时间戳（毫秒）
+   * @param maxAge - 最大有效期（毫秒），默认 5 分钟
+   * @returns 时间戳是否有效
+   * 
+   * @example
+   * ```typescript
+   * const timestamp = parseInt(req.headers['x-sync-timestamp']);
+   * 
+   * // 验证时间戳是否在 5 分钟内
+   * if (!InfoSyncSignature.verifyTimestamp(timestamp, 5 * 60 * 1000)) {
+   *   return res.status(401).json({ error: 'Timestamp expired' });
+   * }
+   * ```
+   */
+  static verifyTimestamp(timestamp, maxAge = 5 * 60 * 1e3) {
+    const now = Date.now();
+    return Math.abs(now - timestamp) <= maxAge;
+  }
+  /**
+   * 完整的 Webhook 请求验证
+   * 
+   * 同时验证签名和时间戳，是推荐的验证方式
+   * 
+   * @param secretKey - 密钥
+   * @param timestamp - 时间戳（毫秒）
+   * @param payload - 负载字符串
+   * @param signature - 待验证的签名
+   * @param maxAge - 最大有效期（毫秒），默认 5 分钟
+   * @returns 验证结果
+   * 
+   * @example
+   * ```typescript
+   * const result = InfoSyncSignature.verifyWebhookRequest(
+   *   secretKey,
+   *   timestamp,
+   *   payload,
+   *   signature
+   * );
+   * 
+   * if (!result.valid) {
+   *   return res.status(401).json({ error: result.error });
+   * }
+   * ```
+   */
+  static verifyWebhookRequest(secretKey, timestamp, payload, signature, maxAge = 5 * 60 * 1e3) {
+    if (!_InfoSyncSignature.verifyTimestamp(timestamp, maxAge)) {
+      return {
+        valid: false,
+        error: "Timestamp expired or invalid"
+      };
+    }
+    if (!_InfoSyncSignature.verifySignature(secretKey, timestamp, payload, signature)) {
+      return {
+        valid: false,
+        error: "Invalid signature"
+      };
+    }
+    return { valid: true };
+  }
+};
+
+exports.InfoSyncSignature = InfoSyncSignature;
+//# sourceMappingURL=chunk-V6NFRYO2.cjs.map
+//# sourceMappingURL=chunk-V6NFRYO2.cjs.map

package/dist/chunk-V6NFRYO2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/signature.ts"],"names":["crypto"],"mappings":";;;;;;;;;AA0BO,IAAM,iBAAA,GAAN,MAAM,kBAAA,CAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwB7B,OAAc,iBAAA,CACZ,SAAA,EACA,SAAA,EACA,OAAA,EACQ;AACR,IAAA,MAAM,OAAA,GAAU,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA;AACvC,IAAA,MAAM,SAAA,GAAYA,uBAAA,CACf,UAAA,CAAW,QAAA,EAAU,SAAS,EAC9B,MAAA,CAAO,OAAO,CAAA,CACd,MAAA,CAAO,KAAK,CAAA;AACf,IAAA,OAAO,SAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,OAAc,eAAA,CACZ,SAAA,EACA,SAAA,EACA,SACA,SAAA,EACS;AACT,IAAA,IAAI;AACF,MAAA,MAAM,WAAW,kBAAA,CAAkB,iBAAA;AAAA,QACjC,SAAA;AAAA,QACA,SAAA;AAAA,QACA;AAAA,OACF;AAGA,MAAA,OAAOA,uBAAA,CAAO,eAAA;AAAA,QACZ,MAAA,CAAO,IAAA,CAAK,QAAA,EAAU,KAAK,CAAA;AAAA,QAC3B,MAAA,CAAO,IAAA,CAAK,SAAA,EAAW,KAAK;AAAA,OAC9B;AAAA,IACF,SAAS,KAAA,EAAO;AAEd,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,OAAc,eAAA,CACZ,SAAA,EACA,MAAA,GAAiB,CAAA,GAAI,KAAK,GAAA,EACjB;AACT,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,GAAA,GAAM,SAAS,CAAA,IAAK,MAAA;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA4BA,OAAc,qBACZ,SAAA,EACA,SAAA,EACA,SACA,SAAA,EACA,MAAA,GAAiB,CAAA,GAAI,EAAA,GAAK,GAAA,EACU;AAEpC,IAAA,IAAI,CAAC,kBAAA,CAAkB,eAAA,CAAgB,SAAA,EAAW,MAAM,CAAA,EAAG;AACzD,MAAA,OAAO;AAAA,QACL,KAAA,EAAO,KAAA;AAAA,QACP,KAAA,EAAO;AAAA,OACT;AAAA,IACF;AAGA,IAAA,IAAI,CAAC,kBAAA,CAAkB,eAAA,CAAgB,WAAW,SAAA,EAAW,OAAA,EAAS,SAAS,CAAA,EAAG;AAChF,MAAA,OAAO;AAAA,QACL,KAAA,EAAO,KAAA;AAAA,QACP,KAAA,EAAO;AAAA,OACT;AAAA,IACF;AAEA,IAAA,OAAO,EAAE,OAAO,IAAA,EAAK;AAAA,EACvB;AACF","file":"chunk-V6NFRYO2.cjs","sourcesContent":["import crypto from 'crypto';\n\n/**\n * 信息同步签名工具\n * \n * 用于生成和验证 Webhook 请求的 HMAC-SHA256 签名\n * \n * @example\n * ```typescript\n * // 验证 Webhook 签名\n * const timestamp = parseInt(req.headers['x-sync-timestamp']);\n * const signature = req.headers['x-sync-signature'];\n * const payload = JSON.stringify(req.body);\n * \n * const isValid = InfoSyncSignature.verifySignature(\n *   secretKey,\n *   timestamp,\n *   payload,\n *   signature\n * );\n * \n * if (!isValid) {\n *   return res.status(401).json({ error: 'Invalid signature' });\n * }\n * ```\n */\nexport class InfoSyncSignature {\n  /**\n   * 生成 HMAC-SHA256 签名\n   * \n   * 签名算法:\n   * - message = `${timestamp}.${payload}`\n   * - signature = HMAC-SHA256(secretKey, message)\n   * \n   * @param secretKey - 密钥（从创建 Webhook 配置时获得）\n   * @param timestamp - 时间戳（毫秒）\n   * @param payload - 负载字符串（通常是 JSON.stringify 后的请求体）\n   * @returns 签名（hex 格式）\n   * \n   * @example\n   * ```typescript\n   * const timestamp = Date.now();\n   * const payload = JSON.stringify({ foo: 'bar' });\n   * const signature = InfoSyncSignature.generateSignature(\n   *   'your-secret-key',\n   *   timestamp,\n   *   payload\n   * );\n   * ```\n   */\n  public static generateSignature(\n    secretKey: string,\n    timestamp: number,\n    payload: string\n  ): string {\n    const message = `${timestamp}.${payload}`;\n    const signature = crypto\n      .createHmac('sha256', secretKey)\n      .update(message)\n      .digest('hex');\n    return signature;\n  }\n\n  /**\n   * 验证 HMAC-SHA256 签名\n   * \n   * @param secretKey - 密钥\n   * @param timestamp - 时间戳（毫秒）\n   * @param payload - 负载字符串\n   * @param signature - 待验证的签名\n   * @returns 签名是否有效\n   * \n   * @example\n   * ```typescript\n   * const isValid = InfoSyncSignature.verifySignature(\n   *   secretKey,\n   *   timestamp,\n   *   payload,\n   *   signature\n   * );\n   * \n   * if (!isValid) {\n   *   throw new Error('Invalid signature');\n   * }\n   * ```\n   */\n  public static verifySignature(\n    secretKey: string,\n    timestamp: number,\n    payload: string,\n    signature: string\n  ): boolean {\n    try {\n      const expected = InfoSyncSignature.generateSignature(\n        secretKey,\n        timestamp,\n        payload\n      );\n      \n      // 使用时间安全的比较方法，防止时序攻击\n      return crypto.timingSafeEqual(\n        Buffer.from(expected, 'hex'),\n        Buffer.from(signature, 'hex')\n      );\n    } catch (error) {\n      // timingSafeEqual 在长度不匹配时会抛出异常\n      return false;\n    }\n  }\n\n  /**\n   * 验证时间戳是否在有效期内\n   * \n   * 用于防止重放攻击，确保请求是最近发送的\n   * \n   * @param timestamp - 时间戳（毫秒）\n   * @param maxAge - 最大有效期（毫秒），默认 5 分钟\n   * @returns 时间戳是否有效\n   * \n   * @example\n   * ```typescript\n   * const timestamp = parseInt(req.headers['x-sync-timestamp']);\n   * \n   * // 验证时间戳是否在 5 分钟内\n   * if (!InfoSyncSignature.verifyTimestamp(timestamp, 5 * 60 * 1000)) {\n   *   return res.status(401).json({ error: 'Timestamp expired' });\n   * }\n   * ```\n   */\n  public static verifyTimestamp(\n    timestamp: number,\n    maxAge: number = 5 * 60 * 1000\n  ): boolean {\n    const now = Date.now();\n    return Math.abs(now - timestamp) <= maxAge;\n  }\n\n  /**\n   * 完整的 Webhook 请求验证\n   * \n   * 同时验证签名和时间戳，是推荐的验证方式\n   * \n   * @param secretKey - 密钥\n   * @param timestamp - 时间戳（毫秒）\n   * @param payload - 负载字符串\n   * @param signature - 待验证的签名\n   * @param maxAge - 最大有效期（毫秒），默认 5 分钟\n   * @returns 验证结果\n   * \n   * @example\n   * ```typescript\n   * const result = InfoSyncSignature.verifyWebhookRequest(\n   *   secretKey,\n   *   timestamp,\n   *   payload,\n   *   signature\n   * );\n   * \n   * if (!result.valid) {\n   *   return res.status(401).json({ error: result.error });\n   * }\n   * ```\n   */\n  public static verifyWebhookRequest(\n    secretKey: string,\n    timestamp: number,\n    payload: string,\n    signature: string,\n    maxAge: number = 5 * 60 * 1000\n  ): { valid: boolean; error?: string } {\n    // 1. 验证时间戳\n    if (!InfoSyncSignature.verifyTimestamp(timestamp, maxAge)) {\n      return {\n        valid: false,\n        error: 'Timestamp expired or invalid'\n      };\n    }\n\n    // 2. 验证签名\n    if (!InfoSyncSignature.verifySignature(secretKey, timestamp, payload, signature)) {\n      return {\n        valid: false,\n        error: 'Invalid signature'\n      };\n    }\n\n    return { valid: true };\n  }\n}\n"]}

package/dist/client-CAjIQKPm.d.cts

@@ -0,0 +1,193 @@
+import { b as LoggerFunction, S as SDKConfig } from './core-77EbLgbp.cjs';
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+
+/**
+ * SDK 内部日志器
+ *
+ * @description
+ * 提供统一的日志接口，支持用户自定义日志钩子。
+ * 默认使用 console 输出，用户可以通过配置自定义 logger 函数来集成 Sentry 等监控系统。
+ *
+ * @example
+ * ```typescript
+ * const logger = new InternalLogger((level, message, data) => {
+ *   // 自定义日志处理，例如发送到 Sentry
+ *   console.log(`[${level}] ${message}`, data);
+ * });
+ *
+ * logger.info('Operation started', { userId: '123' });
+ * logger.error('Operation failed', { error: 'Network timeout' });
+ * ```
+ */
+declare class InternalLogger {
+    /**
+     * 用户自定义的日志钩子函数
+     */
+    private readonly userLogger?;
+    /**
+     * 是否启用日志输出
+     * 可以通过环境变量 PLOLINK_SDK_DEBUG 控制
+     */
+    private readonly isDebugEnabled;
+    /**
+     * 创建一个 InternalLogger 实例
+     *
+     * @param userLogger - 用户自定义的日志钩子函数
+     */
+    constructor(userLogger?: LoggerFunction);
+    /**
+     * 记录信息级别日志
+     *
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    info(message: string, context?: unknown): void;
+    /**
+     * 记录警告级别日志
+     *
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    warn(message: string, context?: unknown): void;
+    /**
+     * 记录错误级别日志
+     *
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    error(message: string, context?: unknown): void;
+    /**
+     * 记录调试级别日志
+     * 只有在 debug 模式下才会输出
+     *
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    debug(message: string, context?: unknown): void;
+    /**
+     * 内部日志记录方法
+     *
+     * @param level - 日志级别
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    private log;
+    /**
+     * 创建一个带有固定上下文的子 logger
+     *
+     * @param context - 固定的上下文数据
+     * @returns 新的 logger 实例
+     *
+     * @example
+     * ```typescript
+     * const logger = new InternalLogger();
+     * const moduleLogger = logger.withContext({ module: 'billing' });
+     * moduleLogger.info('Payment processed'); // 日志会自动带上 module: 'billing'
+     * ```
+     */
+    withContext(context: Record<string, unknown>): InternalLogger;
+}
+
+/**
+ * 为 Axios 实例添加类型安全的请求方法
+ *
+ * @description
+ * 这些方法封装了 Axios 的原始方法，提供更好的类型推断。
+ */
+interface TypedAxiosInstance extends AxiosInstance {
+    get<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    put<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    patch<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    delete<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+}
+
+/**
+ * Plolink SDK 客户端主类
+ *
+ * @description
+ * PlolinkClient 是 SDK 的核心类，负责：
+ * - 管理 SDK 配置（认证 Token、API 地址等）
+ * - 初始化 Axios 实例并配置拦截器
+ * - 提供统一的日志接口
+ * - 作为所有业务模块的基础依赖
+ *
+ * @example
+ * ```typescript
+ * // 使用 ApiKey
+ * const client = new PlolinkClient({
+ *   token: 'sk-123456789',
+ *   logger: (level, msg, data) => {
+ *     console.log(`[${level}] ${msg}`, data);
+ *   }
+ * });
+ *
+ * // 使用 SessionId (登录后获取)
+ * const client = new PlolinkClient({
+ *   token: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ *   baseUrl: 'https://api.plolink.com'
+ * });
+ * ```
+ */
+declare class PlolinkClient {
+    /**
+     * SDK 配置对象（已填充默认值）
+     */
+    readonly config: Required<SDKConfig>;
+    /**
+     * Axios 实例，用于发起 HTTP 请求
+     */
+    readonly axiosInstance: TypedAxiosInstance;
+    /**
+     * 内部日志记录器
+     */
+    readonly logger: InternalLogger;
+    /**
+     * 创建一个 PlolinkClient 实例
+     *
+     * @param config - SDK 配置对象
+     * @throws {PlolinkError} 当配置验证失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const client = new PlolinkClient({
+     *   token: 'sk-your-api-key'
+     * });
+     * ```
+     */
+    constructor(config: SDKConfig);
+    /**
+     * 验证 SDK 配置
+     *
+     * @param config - SDK 配置对象
+     * @throws {PlolinkError} 当配置不合法时抛出
+     * @private
+     */
+    private validateConfig;
+    /**
+     * 获取当前 SDK 版本
+     *
+     * @returns SDK 版本号
+     */
+    getVersion(): string;
+    /**
+     * 检查客户端健康状态
+     *
+     * @returns 健康状态信息
+     *
+     * @example
+     * ```typescript
+     * const health = client.healthCheck();
+     * console.log(health);
+     * // { status: 'ok', baseUrl: '...', version: '...' }
+     * ```
+     */
+    healthCheck(): {
+        status: 'ok';
+        baseUrl: string;
+        version: string;
+        hasToken: boolean;
+    };
+}
+
+export { InternalLogger as I, PlolinkClient as P };

package/dist/client-CwNikk7i.d.ts

@@ -0,0 +1,193 @@
+import { b as LoggerFunction, S as SDKConfig } from './core-77EbLgbp.js';
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+
+/**
+ * SDK 内部日志器
+ *
+ * @description
+ * 提供统一的日志接口，支持用户自定义日志钩子。
+ * 默认使用 console 输出，用户可以通过配置自定义 logger 函数来集成 Sentry 等监控系统。
+ *
+ * @example
+ * ```typescript
+ * const logger = new InternalLogger((level, message, data) => {
+ *   // 自定义日志处理，例如发送到 Sentry
+ *   console.log(`[${level}] ${message}`, data);
+ * });
+ *
+ * logger.info('Operation started', { userId: '123' });
+ * logger.error('Operation failed', { error: 'Network timeout' });
+ * ```
+ */
+declare class InternalLogger {
+    /**
+     * 用户自定义的日志钩子函数
+     */
+    private readonly userLogger?;
+    /**
+     * 是否启用日志输出
+     * 可以通过环境变量 PLOLINK_SDK_DEBUG 控制
+     */
+    private readonly isDebugEnabled;
+    /**
+     * 创建一个 InternalLogger 实例
+     *
+     * @param userLogger - 用户自定义的日志钩子函数
+     */
+    constructor(userLogger?: LoggerFunction);
+    /**
+     * 记录信息级别日志
+     *
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    info(message: string, context?: unknown): void;
+    /**
+     * 记录警告级别日志
+     *
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    warn(message: string, context?: unknown): void;
+    /**
+     * 记录错误级别日志
+     *
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    error(message: string, context?: unknown): void;
+    /**
+     * 记录调试级别日志
+     * 只有在 debug 模式下才会输出
+     *
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    debug(message: string, context?: unknown): void;
+    /**
+     * 内部日志记录方法
+     *
+     * @param level - 日志级别
+     * @param message - 日志消息
+     * @param context - 附加上下文数据
+     */
+    private log;
+    /**
+     * 创建一个带有固定上下文的子 logger
+     *
+     * @param context - 固定的上下文数据
+     * @returns 新的 logger 实例
+     *
+     * @example
+     * ```typescript
+     * const logger = new InternalLogger();
+     * const moduleLogger = logger.withContext({ module: 'billing' });
+     * moduleLogger.info('Payment processed'); // 日志会自动带上 module: 'billing'
+     * ```
+     */
+    withContext(context: Record<string, unknown>): InternalLogger;
+}
+
+/**
+ * 为 Axios 实例添加类型安全的请求方法
+ *
+ * @description
+ * 这些方法封装了 Axios 的原始方法，提供更好的类型推断。
+ */
+interface TypedAxiosInstance extends AxiosInstance {
+    get<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    put<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    patch<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;
+    delete<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+}
+
+/**
+ * Plolink SDK 客户端主类
+ *
+ * @description
+ * PlolinkClient 是 SDK 的核心类，负责：
+ * - 管理 SDK 配置（认证 Token、API 地址等）
+ * - 初始化 Axios 实例并配置拦截器
+ * - 提供统一的日志接口
+ * - 作为所有业务模块的基础依赖
+ *
+ * @example
+ * ```typescript
+ * // 使用 ApiKey
+ * const client = new PlolinkClient({
+ *   token: 'sk-123456789',
+ *   logger: (level, msg, data) => {
+ *     console.log(`[${level}] ${msg}`, data);
+ *   }
+ * });
+ *
+ * // 使用 SessionId (登录后获取)
+ * const client = new PlolinkClient({
+ *   token: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+ *   baseUrl: 'https://api.plolink.com'
+ * });
+ * ```
+ */
+declare class PlolinkClient {
+    /**
+     * SDK 配置对象（已填充默认值）
+     */
+    readonly config: Required<SDKConfig>;
+    /**
+     * Axios 实例，用于发起 HTTP 请求
+     */
+    readonly axiosInstance: TypedAxiosInstance;
+    /**
+     * 内部日志记录器
+     */
+    readonly logger: InternalLogger;
+    /**
+     * 创建一个 PlolinkClient 实例
+     *
+     * @param config - SDK 配置对象
+     * @throws {PlolinkError} 当配置验证失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const client = new PlolinkClient({
+     *   token: 'sk-your-api-key'
+     * });
+     * ```
+     */
+    constructor(config: SDKConfig);
+    /**
+     * 验证 SDK 配置
+     *
+     * @param config - SDK 配置对象
+     * @throws {PlolinkError} 当配置不合法时抛出
+     * @private
+     */
+    private validateConfig;
+    /**
+     * 获取当前 SDK 版本
+     *
+     * @returns SDK 版本号
+     */
+    getVersion(): string;
+    /**
+     * 检查客户端健康状态
+     *
+     * @returns 健康状态信息
+     *
+     * @example
+     * ```typescript
+     * const health = client.healthCheck();
+     * console.log(health);
+     * // { status: 'ok', baseUrl: '...', version: '...' }
+     * ```
+     */
+    healthCheck(): {
+        status: 'ok';
+        baseUrl: string;
+        version: string;
+        hasToken: boolean;
+    };
+}
+
+export { InternalLogger as I, PlolinkClient as P };

package/dist/common/index.cjs

@@ -1,69 +1,70 @@
 'use strict';
 
-var chunkWFBN23AH_cjs = require('../chunk-WFBN23AH.cjs');
+var chunkNS3DJP2O_cjs = require('../chunk-NS3DJP2O.cjs');
 var chunkJR4HYYQI_cjs = require('../chunk-JR4HYYQI.cjs');
+var chunkV6NFRYO2_cjs = require('../chunk-V6NFRYO2.cjs');
 
 
 
 Object.defineProperty(exports, "EventEmitter", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.EventEmitter; }
-});
-Object.defineProperty(exports, "InfoSyncSignature", {
-  enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.InfoSyncSignature; }
+  get: function () { return chunkNS3DJP2O_cjs.EventEmitter; }
 });
 Object.defineProperty(exports, "TypedEventEmitter", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.TypedEventEmitter; }
+  get: function () { return chunkNS3DJP2O_cjs.TypedEventEmitter; }
 });
 Object.defineProperty(exports, "assertEnvironment", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.assertEnvironment; }
+  get: function () { return chunkNS3DJP2O_cjs.assertEnvironment; }
 });
 Object.defineProperty(exports, "environmentInfo", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.environmentInfo; }
+  get: function () { return chunkNS3DJP2O_cjs.environmentInfo; }
 });
 Object.defineProperty(exports, "features", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.features; }
+  get: function () { return chunkNS3DJP2O_cjs.features; }
 });
 Object.defineProperty(exports, "getEnvironment", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.getEnvironment; }
+  get: function () { return chunkNS3DJP2O_cjs.getEnvironment; }
 });
 Object.defineProperty(exports, "getFileName", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.getFileName; }
+  get: function () { return chunkNS3DJP2O_cjs.getFileName; }
 });
 Object.defineProperty(exports, "getFileSize", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.getFileSize; }
+  get: function () { return chunkNS3DJP2O_cjs.getFileSize; }
 });
 Object.defineProperty(exports, "isBrowser", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.isBrowser; }
+  get: function () { return chunkNS3DJP2O_cjs.isBrowser; }
 });
 Object.defineProperty(exports, "isNode", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.isNode; }
+  get: function () { return chunkNS3DJP2O_cjs.isNode; }
 });
 Object.defineProperty(exports, "isValidFileInput", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.isValidFileInput; }
+  get: function () { return chunkNS3DJP2O_cjs.isValidFileInput; }
 });
 Object.defineProperty(exports, "isWebWorker", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.isWebWorker; }
+  get: function () { return chunkNS3DJP2O_cjs.isWebWorker; }
 });
 Object.defineProperty(exports, "safeDynamicImport", {
   enumerable: true,
-  get: function () { return chunkWFBN23AH_cjs.safeDynamicImport; }
+  get: function () { return chunkNS3DJP2O_cjs.safeDynamicImport; }
 });
 Object.defineProperty(exports, "Poller", {
   enumerable: true,
   get: function () { return chunkJR4HYYQI_cjs.Poller; }
 });
+Object.defineProperty(exports, "InfoSyncSignature", {
+  enumerable: true,
+  get: function () { return chunkV6NFRYO2_cjs.InfoSyncSignature; }
+});
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map