@plolink/sdk 0.0.4

package/dist/index.cjs

@@ -0,0 +1,350 @@
+'use strict';
+
+var chunkNS3DJP2O_cjs = require('./chunk-NS3DJP2O.cjs');
+var chunkJR4HYYQI_cjs = require('./chunk-JR4HYYQI.cjs');
+var chunkY3UJVC2L_cjs = require('./chunk-Y3UJVC2L.cjs');
+var axios = require('axios');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var axios__default = /*#__PURE__*/_interopDefault(axios);
+
+// src/core/logger.ts
+var InternalLogger = class _InternalLogger {
+  /**
+   * 创建一个 InternalLogger 实例
+   * 
+   * @param userLogger - 用户自定义的日志钩子函数
+   */
+  constructor(userLogger) {
+    this.userLogger = userLogger;
+    this.isDebugEnabled = typeof process !== "undefined" && process.env?.PLOLINK_SDK_DEBUG === "true";
+  }
+  /**
+   * 记录信息级别日志
+   * 
+   * @param message - 日志消息
+   * @param context - 附加上下文数据
+   */
+  info(message, context) {
+    this.log("info", message, context);
+  }
+  /**
+   * 记录警告级别日志
+   * 
+   * @param message - 日志消息
+   * @param context - 附加上下文数据
+   */
+  warn(message, context) {
+    this.log("warn", message, context);
+  }
+  /**
+   * 记录错误级别日志
+   * 
+   * @param message - 日志消息
+   * @param context - 附加上下文数据
+   */
+  error(message, context) {
+    this.log("error", message, context);
+  }
+  /**
+   * 记录调试级别日志
+   * 只有在 debug 模式下才会输出
+   * 
+   * @param message - 日志消息
+   * @param context - 附加上下文数据
+   */
+  debug(message, context) {
+    if (this.isDebugEnabled) {
+      this.log("debug", message, context);
+    }
+  }
+  /**
+   * 内部日志记录方法
+   * 
+   * @param level - 日志级别
+   * @param message - 日志消息
+   * @param context - 附加上下文数据
+   */
+  log(level, message, context) {
+    const formattedMessage = `[Plolink SDK] ${message}`;
+    if (this.userLogger) {
+      this.userLogger(level, formattedMessage, context);
+      return;
+    }
+    const logData = context ? [formattedMessage, context] : [formattedMessage];
+    switch (level) {
+      case "info":
+      case "debug":
+        console.log(...logData);
+        break;
+      case "warn":
+        console.warn(...logData);
+        break;
+      case "error":
+        console.error(...logData);
+        break;
+    }
+  }
+  /**
+   * 创建一个带有固定上下文的子 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) {
+    const parentLogger = this.userLogger;
+    const wrappedLogger = (level, message, data) => {
+      const mergedData = { ...context, ...data || {} };
+      if (parentLogger) {
+        parentLogger(level, message, mergedData);
+      } else {
+        const formattedMessage = `[Plolink SDK] ${message}`;
+        const logData = [formattedMessage, mergedData];
+        switch (level) {
+          case "info":
+          case "debug":
+            console.log(...logData);
+            break;
+          case "warn":
+            console.warn(...logData);
+            break;
+          case "error":
+            console.error(...logData);
+            break;
+        }
+      }
+    };
+    return new _InternalLogger(wrappedLogger);
+  }
+};
+function createAxiosInstance(config, logger) {
+  const instance = axios__default.default.create({
+    baseURL: config.baseUrl,
+    timeout: config.timeout,
+    headers: {
+      "Content-Type": "application/json"
+    }
+  });
+  instance.interceptors.request.use(
+    (requestConfig) => {
+      const method = requestConfig.method?.toUpperCase() || "GET";
+      const url = requestConfig.url || "";
+      logger.debug(`Request: ${method} ${url}`, {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        params: requestConfig.params,
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        data: requestConfig.data
+      });
+      if (config.token) {
+        requestConfig.headers = requestConfig.headers || {};
+        requestConfig.headers["Authorization"] = `Bearer ${config.token}`;
+      }
+      return requestConfig;
+    },
+    (error) => {
+      logger.error("Request interceptor error", { error: error.message });
+      return Promise.reject(error);
+    }
+  );
+  instance.interceptors.response.use(
+    (response) => {
+      const { code, data, message } = response.data;
+      logger.debug(`Response: ${response.config.method?.toUpperCase()} ${response.config.url}`, {
+        code,
+        message
+      });
+      if (code !== 200 && code !== 0) {
+        const error = new chunkY3UJVC2L_cjs.PlolinkError(
+          message || "Unknown business error",
+          code,
+          data
+        );
+        logger.error("Business error", {
+          code,
+          message,
+          data
+        });
+        throw error;
+      }
+      return data;
+    },
+    (error) => {
+      const status = error.response?.status || "NETWORK_ERROR";
+      const message = error.response?.data?.message || error.message || "Network request failed";
+      const data = error.response?.data?.data;
+      logger.error("Response error", {
+        status,
+        message,
+        url: error.config?.url,
+        method: error.config?.method
+      });
+      throw new chunkY3UJVC2L_cjs.PlolinkError(message, status, data);
+    }
+  );
+  return instance;
+}
+
+// src/core/client.ts
+var PlolinkClient = class {
+  /**
+   * 创建一个 PlolinkClient 实例
+   * 
+   * @param config - SDK 配置对象
+   * @throws {PlolinkError} 当配置验证失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const client = new PlolinkClient({
+   *   token: 'sk-your-api-key'
+   * });
+   * ```
+   */
+  constructor(config) {
+    this.validateConfig(config);
+    this.config = {
+      baseUrl: config.baseUrl || "https://hiring.djangotech.com/",
+      token: config.token,
+      timeout: config.timeout || 1e4,
+      logger: config.logger || (() => {
+      })
+    };
+    this.logger = new InternalLogger(this.config.logger);
+    this.logger.info("Initializing Plolink SDK Client", {
+      baseUrl: this.config.baseUrl,
+      timeout: this.config.timeout,
+      hasToken: !!this.config.token
+    });
+    this.axiosInstance = createAxiosInstance(
+      this.config,
+      this.logger
+    );
+  }
+  /**
+   * 验证 SDK 配置
+   * 
+   * @param config - SDK 配置对象
+   * @throws {PlolinkError} 当配置不合法时抛出
+   * @private
+   */
+  validateConfig(config) {
+    if (!config.token) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError(
+        "Config validation failed: token is required",
+        "CONFIG_ERROR"
+      );
+    }
+    const isApiKey = config.token.startsWith("sk-");
+    const isSessionId = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(config.token);
+    if (!isApiKey && !isSessionId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError(
+        "Config validation failed: token must be either an ApiKey (sk-xxx) or a SessionId (UUID format)",
+        "CONFIG_ERROR"
+      );
+    }
+    if (config.baseUrl) {
+      try {
+        new URL(config.baseUrl);
+      } catch {
+        throw new chunkY3UJVC2L_cjs.PlolinkError(
+          `Config validation failed: baseUrl is not a valid URL: ${config.baseUrl}`,
+          "CONFIG_ERROR"
+        );
+      }
+    }
+    if (config.timeout !== void 0 && (config.timeout <= 0 || !Number.isFinite(config.timeout))) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError(
+        `Config validation failed: timeout must be a positive number, got ${config.timeout}`,
+        "CONFIG_ERROR"
+      );
+    }
+  }
+  /**
+   * 获取当前 SDK 版本
+   * 
+   * @returns SDK 版本号
+   */
+  getVersion() {
+    return "1.0.0";
+  }
+  /**
+   * 检查客户端健康状态
+   * 
+   * @returns 健康状态信息
+   * 
+   * @example
+   * ```typescript
+   * const health = client.healthCheck();
+   * console.log(health);
+   * // { status: 'ok', baseUrl: '...', version: '...' }
+   * ```
+   */
+  healthCheck() {
+    return {
+      status: "ok",
+      baseUrl: this.config.baseUrl,
+      version: this.getVersion(),
+      hasToken: !!this.config.token
+    };
+  }
+};
+
+// src/index.ts
+var VERSION = "1.0.0";
+var DEFAULT_CONFIG = {
+  baseUrl: "https://hiring.djangotech.com/",
+  timeout: 1e4,
+  initialInterval: 1e3,
+  maxInterval: 3e4,
+  backoffFactor: 1.5
+};
+
+Object.defineProperty(exports, "EventEmitter", {
+  enumerable: true,
+  get: function () { return chunkNS3DJP2O_cjs.EventEmitter; }
+});
+Object.defineProperty(exports, "TypedEventEmitter", {
+  enumerable: true,
+  get: function () { return chunkNS3DJP2O_cjs.TypedEventEmitter; }
+});
+Object.defineProperty(exports, "environmentInfo", {
+  enumerable: true,
+  get: function () { return chunkNS3DJP2O_cjs.environmentInfo; }
+});
+Object.defineProperty(exports, "getEnvironment", {
+  enumerable: true,
+  get: function () { return chunkNS3DJP2O_cjs.getEnvironment; }
+});
+Object.defineProperty(exports, "isBrowser", {
+  enumerable: true,
+  get: function () { return chunkNS3DJP2O_cjs.isBrowser; }
+});
+Object.defineProperty(exports, "isNode", {
+  enumerable: true,
+  get: function () { return chunkNS3DJP2O_cjs.isNode; }
+});
+Object.defineProperty(exports, "isWebWorker", {
+  enumerable: true,
+  get: function () { return chunkNS3DJP2O_cjs.isWebWorker; }
+});
+Object.defineProperty(exports, "Poller", {
+  enumerable: true,
+  get: function () { return chunkJR4HYYQI_cjs.Poller; }
+});
+Object.defineProperty(exports, "PlolinkError", {
+  enumerable: true,
+  get: function () { return chunkY3UJVC2L_cjs.PlolinkError; }
+});
+exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
+exports.InternalLogger = InternalLogger;
+exports.PlolinkClient = PlolinkClient;
+exports.VERSION = VERSION;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/logger.ts","../src/core/request.ts","../src/core/client.ts","../src/index.ts"],"names":["axios","PlolinkError"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { LogLevel, LoggerFunction } from '../types';\n\n/**\n * SDK 内部日志器\n * \n * @description\n * 提供统一的日志接口，支持用户自定义日志钩子。\n * 默认使用 console 输出，用户可以通过配置自定义 logger 函数来集成 Sentry 等监控系统。\n * \n * @example\n * ```typescript\n * const logger = new InternalLogger((level, message, data) => {\n *   // 自定义日志处理，例如发送到 Sentry\n *   console.log(`[${level}] ${message}`, data);\n * });\n * \n * logger.info('Operation started', { userId: '123' });\n * logger.error('Operation failed', { error: 'Network timeout' });\n * ```\n */\nexport class InternalLogger {\n  /**\n   * 用户自定义的日志钩子函数\n   */\n  private readonly userLogger?: LoggerFunction;\n\n  /**\n   * 是否启用日志输出\n   * 可以通过环境变量 PLOLINK_SDK_DEBUG 控制\n   */\n  private readonly isDebugEnabled: boolean;\n\n  /**\n   * 创建一个 InternalLogger 实例\n   * \n   * @param userLogger - 用户自定义的日志钩子函数\n   */\n  constructor(userLogger?: LoggerFunction) {\n    this.userLogger = userLogger;\n    this.isDebugEnabled =\n      typeof process !== 'undefined' &&\n      process.env?.PLOLINK_SDK_DEBUG === 'true';\n  }\n\n  /**\n   * 记录信息级别日志\n   * \n   * @param message - 日志消息\n   * @param context - 附加上下文数据\n   */\n  public info(message: string, context?: unknown): void {\n    this.log('info', message, context);\n  }\n\n  /**\n   * 记录警告级别日志\n   * \n   * @param message - 日志消息\n   * @param context - 附加上下文数据\n   */\n  public warn(message: string, context?: unknown): void {\n    this.log('warn', message, context);\n  }\n\n  /**\n   * 记录错误级别日志\n   * \n   * @param message - 日志消息\n   * @param context - 附加上下文数据\n   */\n  public error(message: string, context?: unknown): void {\n    this.log('error', message, context);\n  }\n\n  /**\n   * 记录调试级别日志\n   * 只有在 debug 模式下才会输出\n   * \n   * @param message - 日志消息\n   * @param context - 附加上下文数据\n   */\n  public debug(message: string, context?: unknown): void {\n    if (this.isDebugEnabled) {\n      this.log('debug', message, context);\n    }\n  }\n\n  /**\n   * 内部日志记录方法\n   * \n   * @param level - 日志级别\n   * @param message - 日志消息\n   * @param context - 附加上下文数据\n   */\n  private log(level: LogLevel, message: string, context?: unknown): void {\n    const formattedMessage = `[Plolink SDK] ${message}`;\n\n    // 优先使用用户自定义的 logger\n    if (this.userLogger) {\n      this.userLogger(level, formattedMessage, context);\n      return;\n    }\n\n    // 降级到 console 输出\n    const logData = context ? [formattedMessage, context] : [formattedMessage];\n\n    switch (level) {\n      case 'info':\n      case 'debug':\n        // eslint-disable-next-line no-console\n        console.log(...logData);\n        break;\n      case 'warn':\n        console.warn(...logData);\n        break;\n      case 'error':\n        console.error(...logData);\n        break;\n    }\n  }\n\n  /**\n   * 创建一个带有固定上下文的子 logger\n   * \n   * @param context - 固定的上下文数据\n   * @returns 新的 logger 实例\n   * \n   * @example\n   * ```typescript\n   * const logger = new InternalLogger();\n   * const moduleLogger = logger.withContext({ module: 'billing' });\n   * moduleLogger.info('Payment processed'); // 日志会自动带上 module: 'billing'\n   * ```\n   */\n  public withContext(context: Record<string, unknown>): InternalLogger {\n    const parentLogger = this.userLogger;\n    const wrappedLogger: LoggerFunction = (level, message, data) => {\n      const mergedData = { ...context, ...((data as Record<string, unknown>) || {}) };\n      if (parentLogger) {\n        parentLogger(level, message, mergedData);\n      } else {\n        // 使用默认的 console 输出\n        const formattedMessage = `[Plolink SDK] ${message}`;\n        const logData = [formattedMessage, mergedData];\n        switch (level) {\n          case 'info':\n          case 'debug':\n            // eslint-disable-next-line no-console\n            console.log(...logData);\n            break;\n          case 'warn':\n            console.warn(...logData);\n            break;\n          case 'error':\n            console.error(...logData);\n            break;\n        }\n      }\n    };\n\n    return new InternalLogger(wrappedLogger);\n  }\n}\n\n","import axios, { type AxiosInstance, type AxiosRequestConfig, AxiosError } from 'axios';\nimport { PlolinkError } from './error';\nimport { InternalLogger } from './logger';\nimport type { SDKConfig } from '../types';\n\n/**\n * 标准 API 响应格式\n */\ninterface APIResponse<T = unknown> {\n  code: number;\n  message: string;\n  data: T;\n}\n\n/**\n * 创建配置好的 Axios 实例\n * \n * @description\n * 创建一个单例的 Axios 实例，配置了请求和响应拦截器。\n * - 请求拦截器：注入 Bearer Token 认证\n * - 响应拦截器：统一处理 code/message/data 格式，只返回 data 部分\n * - 错误处理：将所有错误转换为 PlolinkError\n * \n * @param config - SDK 配置对象\n * @param logger - 日志记录器\n * @returns 配置好的 Axios 实例\n * \n * @internal\n */\nexport function createAxiosInstance(\n  config: Required<SDKConfig>,\n  logger: InternalLogger\n): AxiosInstance {\n  // 创建 Axios 实例\n  const instance = axios.create({\n    baseURL: config.baseUrl,\n    timeout: config.timeout,\n    headers: {\n      'Content-Type': 'application/json',\n    },\n  });\n\n  // 请求拦截器：注入认证信息\n  instance.interceptors.request.use(\n    (requestConfig) => {\n      const method = requestConfig.method?.toUpperCase() || 'GET';\n      const url = requestConfig.url || '';\n\n      logger.debug(`Request: ${method} ${url}`, {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n        params: requestConfig.params,\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n        data: requestConfig.data,\n      });\n\n      // 统一使用 Bearer Token 认证\n      if (config.token) {\n        requestConfig.headers = requestConfig.headers || {};\n        requestConfig.headers['Authorization'] = `Bearer ${config.token}`;\n      }\n\n      return requestConfig;\n    },\n    (error: AxiosError) => {\n      logger.error('Request interceptor error', { error: error.message });\n      return Promise.reject(error);\n    }\n  );\n\n  // 响应拦截器：统一格式化与状态检测\n  instance.interceptors.response.use(\n    (response) => {\n      const { code, data, message } = response.data as APIResponse;\n\n      logger.debug(`Response: ${response.config.method?.toUpperCase()} ${response.config.url}`, {\n        code,\n        message,\n      });\n\n      // 检查业务状态码（根据后端约定，200 或 0 表示成功）\n      if (code !== 200 && code !== 0) {\n        const error = new PlolinkError(\n          message || 'Unknown business error',\n          code,\n          data\n        );\n        logger.error('Business error', {\n          code,\n          message,\n          data,\n        });\n        throw error;\n      }\n\n      // 直接返回 data 部分\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion\n      return data as unknown as typeof response;\n    },\n    (error: AxiosError) => {\n      // 处理网络错误和 HTTP 错误\n      const status = error.response?.status || 'NETWORK_ERROR';\n      const message =\n        (error.response?.data as APIResponse)?.message ||\n        error.message ||\n        'Network request failed';\n      const data = (error.response?.data as APIResponse)?.data;\n\n      logger.error('Response error', {\n        status,\n        message,\n        url: error.config?.url,\n        method: error.config?.method,\n      });\n\n      throw new PlolinkError(message, status, data);\n    }\n  );\n\n  return instance;\n}\n\n/**\n * 为 Axios 实例添加类型安全的请求方法\n * \n * @description\n * 这些方法封装了 Axios 的原始方法，提供更好的类型推断。\n */\nexport interface TypedAxiosInstance extends AxiosInstance {\n  get<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;\n  post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;\n  put<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;\n  patch<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<T>;\n  delete<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;\n}\n\n","import type { SDKConfig } from '../types';\nimport { InternalLogger } from './logger';\nimport { createAxiosInstance, type TypedAxiosInstance } from './request';\nimport { PlolinkError } from './error';\n\n/**\n * Plolink SDK 客户端主类\n * \n * @description\n * PlolinkClient 是 SDK 的核心类，负责：\n * - 管理 SDK 配置（认证 Token、API 地址等）\n * - 初始化 Axios 实例并配置拦截器\n * - 提供统一的日志接口\n * - 作为所有业务模块的基础依赖\n * \n * @example\n * ```typescript\n * // 使用 ApiKey\n * const client = new PlolinkClient({\n *   token: 'sk-123456789',\n *   logger: (level, msg, data) => {\n *     console.log(`[${level}] ${msg}`, data);\n *   }\n * });\n * \n * // 使用 SessionId (登录后获取)\n * const client = new PlolinkClient({\n *   token: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',\n *   baseUrl: 'https://api.plolink.com'\n * });\n * ```\n */\nexport class PlolinkClient {\n  /**\n   * SDK 配置对象（已填充默认值）\n   */\n  public readonly config: Required<SDKConfig>;\n\n  /**\n   * Axios 实例，用于发起 HTTP 请求\n   */\n  public readonly axiosInstance: TypedAxiosInstance;\n\n  /**\n   * 内部日志记录器\n   */\n  public readonly logger: InternalLogger;\n\n  /**\n   * 创建一个 PlolinkClient 实例\n   * \n   * @param config - SDK 配置对象\n   * @throws {PlolinkError} 当配置验证失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const client = new PlolinkClient({\n   *   token: 'sk-your-api-key'\n   * });\n   * ```\n   */\n  constructor(config: SDKConfig) {\n    // 验证配置\n    this.validateConfig(config);\n\n    // 填充默认配置\n    this.config = {\n      baseUrl: config.baseUrl || 'https://hiring.djangotech.com/',\n      token: config.token,\n      timeout: config.timeout || 10000,\n      logger: config.logger || (() => {}),\n    };\n\n    // 初始化日志记录器\n    this.logger = new InternalLogger(this.config.logger);\n\n    this.logger.info('Initializing Plolink SDK Client', {\n      baseUrl: this.config.baseUrl,\n      timeout: this.config.timeout,\n      hasToken: !!this.config.token,\n    });\n\n    // 创建 Axios 实例\n    this.axiosInstance = createAxiosInstance(\n      this.config,\n      this.logger\n    ) as TypedAxiosInstance;\n  }\n\n  /**\n   * 验证 SDK 配置\n   * \n   * @param config - SDK 配置对象\n   * @throws {PlolinkError} 当配置不合法时抛出\n   * @private\n   */\n  private validateConfig(config: SDKConfig): void {\n    // 验证必填字段 token\n    if (!config.token) {\n      throw new PlolinkError(\n        'Config validation failed: token is required',\n        'CONFIG_ERROR'\n      );\n    }\n\n    // 验证 token 格式（ApiKey 或 SessionId）\n    const isApiKey = config.token.startsWith('sk-');\n    const isSessionId = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(config.token);\n    \n    if (!isApiKey && !isSessionId) {\n      throw new PlolinkError(\n        'Config validation failed: token must be either an ApiKey (sk-xxx) or a SessionId (UUID format)',\n        'CONFIG_ERROR'\n      );\n    }\n\n    // 验证 baseUrl 格式\n    if (config.baseUrl) {\n      try {\n        new URL(config.baseUrl);\n      } catch {\n        throw new PlolinkError(\n          `Config validation failed: baseUrl is not a valid URL: ${config.baseUrl}`,\n          'CONFIG_ERROR'\n        );\n      }\n    }\n\n    // 验证 timeout\n    if (config.timeout !== undefined && (config.timeout <= 0 || !Number.isFinite(config.timeout))) {\n      throw new PlolinkError(\n        `Config validation failed: timeout must be a positive number, got ${config.timeout}`,\n        'CONFIG_ERROR'\n      );\n    }\n  }\n\n  /**\n   * 获取当前 SDK 版本\n   * \n   * @returns SDK 版本号\n   */\n  public getVersion(): string {\n    return '1.0.0';\n  }\n\n  /**\n   * 检查客户端健康状态\n   * \n   * @returns 健康状态信息\n   * \n   * @example\n   * ```typescript\n   * const health = client.healthCheck();\n   * console.log(health);\n   * // { status: 'ok', baseUrl: '...', version: '...' }\n   * ```\n   */\n  public healthCheck(): {\n    status: 'ok';\n    baseUrl: string;\n    version: string;\n    hasToken: boolean;\n  } {\n    return {\n      status: 'ok',\n      baseUrl: this.config.baseUrl,\n      version: this.getVersion(),\n      hasToken: !!this.config.token,\n    };\n  }\n}\n\n","/**\n * Plolink SDK 主入口\n * \n * @description\n * Plolink 开放平台官方 SDK，提供完整的 API 调用能力。\n * \n * @packageDocumentation\n * \n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * \n * // 创建客户端实例\n * const client = new PlolinkClient({\n *   token: 'sk-your-api-key',\n *   logger: (level, message, data) => {\n *     console.log(`[${level}] ${message}`, data);\n *   }\n * });\n * \n * // 检查健康状态\n * const health = client.healthCheck();\n * console.log(health);\n * ```\n */\n\n// 导出核心类\nexport { PlolinkClient } from './core/client';\nexport { PlolinkError } from './core/error';\nexport { InternalLogger } from './core/logger';\n\n// 导出公共工具（供高级用户使用）\nexport { Poller } from './common/poller';\nexport { EventEmitter, TypedEventEmitter } from './common/hooks';\nexport {\n  isNode,\n  isBrowser,\n  isWebWorker,\n  getEnvironment,\n  environmentInfo,\n} from './common/adapter';\n\n// 导出类型定义\nexport type {\n  SDKConfig,\n  LogLevel,\n  LoggerFunction,\n  PollerOptions,\n  PollerSnapshot,\n  // shared (跨模块通用类型)\n  RoleType,\n  ScopeType,\n  AssignRoleParams,\n} from './types';\n\n// 导出版本信息\nexport const VERSION = '1.0.0';\n\n/**\n * SDK 默认配置\n */\nexport const DEFAULT_CONFIG = {\n  baseUrl: 'https://hiring.djangotech.com/',\n  timeout: 10000,\n  initialInterval: 1000,\n  maxInterval: 30000,\n  backoffFactor: 1.5,\n} as const;\n\n"]}

package/dist/index.d.cts

@@ -0,0 +1,98 @@
+export { I as InternalLogger, P as PlolinkClient } from './client-CAjIQKPm.cjs';
+export { P as Poller } from './poller-BlIRbwL4.cjs';
+export { EventEmitter, TypedEventEmitter, environmentInfo, getEnvironment, isBrowser, isNode, isWebWorker } from './common/index.cjs';
+export { L as LogLevel, b as LoggerFunction, P as PollerOptions, a as PollerSnapshot, S as SDKConfig } from './core-77EbLgbp.cjs';
+export { A as AssignRoleParams, R as RoleType, S as ScopeType } from './shared-6ZepUSPW.cjs';
+import 'axios';
+
+/**
+ * Plolink SDK 统一错误类
+ *
+ * @description
+ * 所有 SDK 内部的业务错误和网络错误都会被转换为 PlolinkError。
+ * 调用方可以通过捕获此错误来统一处理异常情况。
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.someMethod();
+ * } catch (error) {
+ *   if (error instanceof PlolinkError) {
+ *     console.error(`Error ${error.code}: ${error.message}`);
+ *     console.error('Additional data:', error.data);
+ *   }
+ * }
+ * ```
+ */
+declare class PlolinkError extends Error {
+    /**
+     * 错误代码
+     * 可以是 HTTP 状态码（数字）或业务错误码（字符串）
+     */
+    readonly code: number | string;
+    /**
+     * 附加错误数据
+     * 包含后端返回的详细错误信息
+     */
+    readonly data?: unknown;
+    /**
+     * 创建一个 PlolinkError 实例
+     *
+     * @param message - 错误消息
+     * @param code - 错误代码
+     * @param data - 附加错误数据
+     */
+    constructor(message: string, code: number | string, data?: unknown);
+    /**
+     * 将错误转换为 JSON 格式
+     *
+     * @returns 包含错误信息的对象
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * 将错误转换为字符串
+     *
+     * @returns 错误的字符串表示
+     */
+    toString(): string;
+}
+
+/**
+ * Plolink SDK 主入口
+ *
+ * @description
+ * Plolink 开放平台官方 SDK，提供完整的 API 调用能力。
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ *
+ * // 创建客户端实例
+ * const client = new PlolinkClient({
+ *   token: 'sk-your-api-key',
+ *   logger: (level, message, data) => {
+ *     console.log(`[${level}] ${message}`, data);
+ *   }
+ * });
+ *
+ * // 检查健康状态
+ * const health = client.healthCheck();
+ * console.log(health);
+ * ```
+ */
+
+declare const VERSION = "1.0.0";
+/**
+ * SDK 默认配置
+ */
+declare const DEFAULT_CONFIG: {
+    readonly baseUrl: "https://hiring.djangotech.com/";
+    readonly timeout: 10000;
+    readonly initialInterval: 1000;
+    readonly maxInterval: 30000;
+    readonly backoffFactor: 1.5;
+};
+
+export { DEFAULT_CONFIG, PlolinkError, VERSION };

package/dist/index.d.ts

@@ -0,0 +1,98 @@
+export { I as InternalLogger, P as PlolinkClient } from './client-CwNikk7i.js';
+export { P as Poller } from './poller-DWKZjuSw.js';
+export { EventEmitter, TypedEventEmitter, environmentInfo, getEnvironment, isBrowser, isNode, isWebWorker } from './common/index.js';
+export { L as LogLevel, b as LoggerFunction, P as PollerOptions, a as PollerSnapshot, S as SDKConfig } from './core-77EbLgbp.js';
+export { A as AssignRoleParams, R as RoleType, S as ScopeType } from './shared-6ZepUSPW.js';
+import 'axios';
+
+/**
+ * Plolink SDK 统一错误类
+ *
+ * @description
+ * 所有 SDK 内部的业务错误和网络错误都会被转换为 PlolinkError。
+ * 调用方可以通过捕获此错误来统一处理异常情况。
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.someMethod();
+ * } catch (error) {
+ *   if (error instanceof PlolinkError) {
+ *     console.error(`Error ${error.code}: ${error.message}`);
+ *     console.error('Additional data:', error.data);
+ *   }
+ * }
+ * ```
+ */
+declare class PlolinkError extends Error {
+    /**
+     * 错误代码
+     * 可以是 HTTP 状态码（数字）或业务错误码（字符串）
+     */
+    readonly code: number | string;
+    /**
+     * 附加错误数据
+     * 包含后端返回的详细错误信息
+     */
+    readonly data?: unknown;
+    /**
+     * 创建一个 PlolinkError 实例
+     *
+     * @param message - 错误消息
+     * @param code - 错误代码
+     * @param data - 附加错误数据
+     */
+    constructor(message: string, code: number | string, data?: unknown);
+    /**
+     * 将错误转换为 JSON 格式
+     *
+     * @returns 包含错误信息的对象
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * 将错误转换为字符串
+     *
+     * @returns 错误的字符串表示
+     */
+    toString(): string;
+}
+
+/**
+ * Plolink SDK 主入口
+ *
+ * @description
+ * Plolink 开放平台官方 SDK，提供完整的 API 调用能力。
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ *
+ * // 创建客户端实例
+ * const client = new PlolinkClient({
+ *   token: 'sk-your-api-key',
+ *   logger: (level, message, data) => {
+ *     console.log(`[${level}] ${message}`, data);
+ *   }
+ * });
+ *
+ * // 检查健康状态
+ * const health = client.healthCheck();
+ * console.log(health);
+ * ```
+ */
+
+declare const VERSION = "1.0.0";
+/**
+ * SDK 默认配置
+ */
+declare const DEFAULT_CONFIG: {
+    readonly baseUrl: "https://hiring.djangotech.com/";
+    readonly timeout: 10000;
+    readonly initialInterval: 1000;
+    readonly maxInterval: 30000;
+    readonly backoffFactor: 1.5;
+};
+
+export { DEFAULT_CONFIG, PlolinkError, VERSION };