@plolink/sdk 0.0.5 → 0.0.8

package/dist/client-l6cekf09.d.cts

@@ -0,0 +1,848 @@
+import { b as LoggerFunction, S as SDKConfig } from './core-77EbLgbp.cjs';
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+
+/**
+ * 心理评测模块类型定义
+ */
+/**
+ * 评测状态枚举
+ */
+declare enum PsychologyTestStatus {
+    /** 进行中 */
+    IN_PROGRESS = "IN_PROGRESS",
+    /** 已完成 */
+    COMPLETED = "COMPLETED"
+}
+/**
+ * 分析状态枚举
+ */
+declare enum PsychologyAnalysisStatus {
+    /** 无需分析 */
+    NOT_NEEDED = "NOT_NEEDED",
+    /** 待分析 */
+    PENDING = "PENDING",
+    /** 分析中 */
+    ANALYZING = "ANALYZING",
+    /** 已完成 */
+    COMPLETED = "COMPLETED",
+    /** 失败 */
+    FAILED = "FAILED"
+}
+/**
+ * 题目类型
+ */
+type QuestionType = 'single_choice' | 'multiple_choice' | 'text' | 'scale' | 'matrix';
+/**
+ * 题目依赖条件
+ */
+interface QuestionDependency {
+    /** 依赖的题目代码 */
+    questionCode: string;
+    /** 依赖的答案值 */
+    expectedAnswer: string | string[];
+}
+/**
+ * 题目选项
+ */
+interface QuestionOption {
+    /** 选项标签 */
+    label: string;
+    /** 选项值 */
+    value: string;
+}
+/**
+ * 题目元数据
+ */
+interface QuestionMetadata {
+    /** 题目选项（单选/多选题） */
+    options?: QuestionOption[];
+    /** 量表范围（量表题） */
+    scale?: {
+        min: number;
+        max: number;
+        minLabel?: string;
+        maxLabel?: string;
+    };
+    /** 其他自定义元数据 */
+    [key: string]: unknown;
+}
+/**
+ * 题目信息
+ */
+interface QuestionInfo {
+    /** 题组代码 */
+    groupCode: string;
+    /** 题组名称 */
+    groupName: string;
+    /** 子题库ID */
+    bankId: string;
+    /** 子题库名称 */
+    bankName: string;
+    /** 题目ID */
+    questionId: string;
+    /** 题目UUID */
+    questionUuid: string;
+    /** 题目代码（可为null） */
+    questionCode: string | null;
+    /** 题目类型 */
+    questionType: QuestionType;
+    /** 题目内容 */
+    content: string;
+    /** 题目元数据 */
+    metadata: QuestionMetadata;
+    /** 依赖条件（可为null） */
+    dependsOn: QuestionDependency | null;
+    /** 排序顺序 */
+    sortOrder: number;
+}
+/**
+ * 题组摘要信息
+ */
+interface GroupSummary {
+    /** 题组名称 */
+    groupName: string;
+    /** 子题库ID */
+    bankId: string;
+    /** 子题库名称 */
+    bankName: string;
+    /** 题目数量 */
+    questionCount: number;
+}
+/**
+ * 创建心理评测会话参数
+ */
+interface CreatePsychologyTestSessionParams {
+    /** 题组代码列表 */
+    groupCodes: string[];
+    /** 业务模块 */
+    businessModule: string;
+    /** 业务码 */
+    businessCode: string;
+    /** 业务ID */
+    businessId: string;
+    /** 是否需要AI分析 */
+    needAnalysis: boolean;
+    /** 分析提示词（needAnalysis为true时必填） */
+    analysisPrompt?: string;
+}
+/**
+ * 创建心理评测会话响应
+ */
+interface CreatePsychologyTestSessionResponse {
+    /** 评测会话ID */
+    sessionId: string;
+}
+/**
+ * 获取会话题目响应
+ */
+interface GetSessionQuestionsResponse {
+    /** 题目列表 */
+    questions: QuestionInfo[];
+    /** 总题数 */
+    totalCount: number;
+    /** 题组摘要（按题组代码分组） */
+    groupSummary: Record<string, GroupSummary>;
+}
+/**
+ * 发起心理评测参数
+ * @deprecated 请使用 CreatePsychologyTestSessionParams
+ */
+interface InitiatePsychologyTestParams {
+    /** 题组代码列表 */
+    groupCodes: string[];
+    /** 业务模块 */
+    businessModule: string;
+    /** 业务码 */
+    businessCode: string;
+    /** 业务ID */
+    businessId: string;
+    /** 是否需要AI分析 */
+    needAnalysis: boolean;
+    /** 分析提示词（needAnalysis为true时必填） */
+    analysisPrompt?: string;
+}
+/**
+ * 发起心理评测响应
+ * @deprecated 请使用 CreatePsychologyTestSessionResponse + GetSessionQuestionsResponse
+ */
+interface InitiatePsychologyTestResponse {
+    /** 评测会话ID */
+    sessionId: string;
+    /** 题目列表 */
+    questions: QuestionInfo[];
+    /** 总题数 */
+    totalCount: number;
+    /** 题组摘要（按题组代码分组） */
+    groupSummary: Record<string, GroupSummary>;
+}
+/**
+ * 答题记录
+ */
+interface AnswerRecord {
+    /** 题组代码 */
+    groupCode: string;
+    /** 子题库ID */
+    bankId: string;
+    /** 题目ID */
+    questionId: string;
+    /** 题目代码（可为null） */
+    questionCode: string | null;
+    /** 答案（JSON字符串） */
+    answer: string;
+    /** 单题用时（毫秒） */
+    timeSpent?: number;
+}
+/**
+ * 提交心理评测参数
+ */
+interface SubmitPsychologyTestParams {
+    /** 评测会话ID */
+    sessionId: string;
+    /** 答题记录列表 */
+    answers: AnswerRecord[];
+    /** 总用时（毫秒） */
+    duration?: number;
+}
+/**
+ * 计算结果（单个题库）
+ */
+interface TestCalculationResult {
+    /** 测试结果数据（具体结构取决于题库类型） */
+    testResult: Record<string, unknown>;
+    /** Markdown格式的得分描述 */
+    markdown: string;
+}
+/**
+ * 提交心理评测响应
+ */
+interface SubmitPsychologyTestResponse {
+    /** 评测会话ID */
+    sessionId: string;
+    /** 计算结果（按题组代码分组） */
+    calculationResults: Record<string, TestCalculationResult>;
+    /** 完整的得分描述Markdown */
+    scoreDescription: string;
+}
+/**
+ * 答题记录详情
+ */
+interface PsychologyTestAnswerDetail {
+    /** 答题记录ID */
+    id: string;
+    /** 评测会话ID */
+    sessionId: string;
+    /** 题组代码 */
+    groupCode: string;
+    /** 子题库ID */
+    bankId: string;
+    /** 题目ID */
+    questionId: string;
+    /** 题目代码 */
+    questionCode: string | null;
+    /** 答案 */
+    answer: string;
+    /** 单题用时（毫秒） */
+    timeSpent: number;
+    /** 版本号 */
+    version: number;
+    /** 创建时间 */
+    createdAt: string;
+    /** 更新时间 */
+    updatedAt: string;
+    /** 删除时间（软删除） */
+    deletedAt: string | null;
+}
+/**
+ * 心理评测详情
+ */
+interface PsychologyTestDetail {
+    /** 评测会话ID */
+    id: string;
+    /** 业务模块 */
+    businessModule: string;
+    /** 业务码 */
+    businessCode: string;
+    /** 业务ID */
+    businessId: string;
+    /** 题组代码列表（JSON字符串） */
+    groupCodes: string;
+    /** 评测状态 */
+    status: PsychologyTestStatus;
+    /** 总题数 */
+    totalQuestions: number;
+    /** 答题用时（毫秒） */
+    duration: number;
+    /** 计算结果（JSON字符串） */
+    calculationResults: string;
+    /** 解析后的计算结果 */
+    calculationResultsParsed: Record<string, TestCalculationResult>;
+    /** 得分描述Markdown */
+    scoreDescription: string;
+    /** 是否需要AI分析 */
+    needAnalysis: boolean;
+    /** 分析提示词 */
+    analysisPrompt: string | null;
+    /** 分析状态 */
+    analysisStatus: PsychologyAnalysisStatus;
+    /** AI分析结果Markdown */
+    analysisResult: string | null;
+    /** 分析错误信息 */
+    analysisError: string | null;
+    /** 分析完成时间 */
+    analysisCompletedAt: string | null;
+    /** 创建者ID */
+    creatorId: string;
+    /** 团队ID */
+    teamId: string;
+    /** 版本号 */
+    version: number;
+    /** 创建时间 */
+    createdAt: string;
+    /** 更新时间 */
+    updatedAt: string;
+    /** 删除时间（软删除） */
+    deletedAt: string | null;
+}
+/**
+ * 题库组简要信息
+ */
+interface PsychologyBankGroupSummary {
+    /** 题库组ID */
+    id: string;
+    /** 题库组名称 */
+    name: string;
+    /** 题库组代码 */
+    code: string;
+    /** 测试目标 */
+    testObjective: string;
+}
+/**
+ * 列表查询心理评测会话参数
+ */
+interface ListPsychologyTestSessionsParams {
+    /** 页码（从1开始） */
+    page?: number;
+    /** 每页数量 */
+    size?: number;
+    /** 业务模块 */
+    businessModule?: string;
+    /** 业务码 */
+    businessCode?: string;
+    /** 评测状态 */
+    status?: string;
+    /** 分析状态 */
+    analysisStatus?: string;
+    /** 开始日期（ISO字符串） */
+    startDate?: string;
+    /** 结束日期（ISO字符串） */
+    endDate?: string;
+    /** 团队ID */
+    teamId?: string;
+}
+/**
+ * 列表查询心理评测会话响应
+ */
+interface ListPsychologyTestSessionsResponse {
+    /** 会话列表 */
+    list: PsychologyTestDetail[];
+    /** 总数 */
+    total: number;
+    /** 当前页码 */
+    page: number;
+    /** 每页数量 */
+    size: number;
+}
+
+/**
+ * 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>;
+}
+
+/**
+ * 心理评测模块
+ *
+ * @description
+ * 提供心理评测相关功能，包括：
+ * - 发起心理评测会话
+ * - 提交心理评测答题
+ * - 获取评测详情和结果
+ * - 获取答题记录
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ *
+ * const client = new PlolinkClient({
+ *   token: 'sk-your-api-key'
+ * });
+ *
+ * // 发起心理评测
+ * const initResult = await client.psychologyTest.initiate({
+ *   groupCodes: ['family_parenting', 'disc'],
+ *   businessModule: 'talent_assessment',
+ *   businessCode: 'job_match',
+ *   businessId: 'clxxxx123456',
+ *   needAnalysis: true,
+ *   analysisPrompt: '请结合家庭养育方式和DISC行为模式，分析候选人的性格特点。'
+ * });
+ * console.log(`评测会话已创建: ${initResult.sessionId}`);
+ * console.log(`共 ${initResult.totalCount} 道题目`);
+ *
+ * // 用户答题...
+ * const answers = initResult.questions.map(q => ({
+ *   groupCode: q.groupCode,
+ *   bankId: q.bankId,
+ *   questionId: q.questionId,
+ *   questionCode: q.questionCode,
+ *   answer: getUserAnswer(q),  // 获取用户答案
+ *   timeSpent: getTimeSpent(q) // 获取答题时间
+ * }));
+ *
+ * // 提交心理评测
+ * const submitResult = await client.psychologyTest.submit({
+ *   sessionId: initResult.sessionId,
+ *   answers,
+ *   duration: 480000
+ * });
+ * console.log('得分描述:', submitResult.scoreDescription);
+ *
+ * // 查询评测详情
+ * const detail = await client.psychologyTest.getDetail(initResult.sessionId);
+ * if (detail.analysisStatus === 'COMPLETED') {
+ *   console.log('AI分析结果:', detail.analysisResult);
+ * }
+ * ```
+ *
+ * @module psychology-test
+ */
+
+/**
+ * 心理评测模块
+ */
+declare class PsychologyTest {
+    private client;
+    constructor(client: PlolinkClient);
+    /**
+     * 创建心理评测会话
+     *
+     * @description
+     * 创建心理评测会话记录（不返回题目）。
+     * 创建后需要调用 getSessionQuestions() 获取题目列表。
+     *
+     * @param params - 创建会话参数
+     * @returns 会话信息，包含会话ID
+     * @throws {PlolinkError} 当参数验证失败或创建失败时抛出
+     *
+     * @example
+     * ```typescript
+     * // 1. 创建会话
+     * const { sessionId } = await client.psychologyTest.createTestSession({
+     *   groupCodes: ['family_parenting', 'disc'],
+     *   businessModule: 'talent_assessment',
+     *   businessCode: 'job_match',
+     *   businessId: 'clxxxx123456',
+     *   needAnalysis: true,
+     *   analysisPrompt: '请结合家庭养育方式和DISC行为模式，分析候选人的性格特点。'
+     * });
+     *
+     * console.log(`评测会话已创建: ${sessionId}`);
+     *
+     * // 2. 获取题目
+     * const questions = await client.psychologyTest.getSessionQuestions(sessionId);
+     * ```
+     */
+    createTestSession(params: CreatePsychologyTestSessionParams): Promise<CreatePsychologyTestSessionResponse>;
+    /**
+     * 获取会话题目
+     *
+     * @description
+     * 获取心理评测会话的题目列表（动态生成，每次调用都会重新打乱题目顺序）。
+     *
+     * @param sessionId - 评测会话ID
+     * @returns 题目列表和题组摘要
+     * @throws {PlolinkError} 当会话不存在或获取失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const questions = await client.psychologyTest.getSessionQuestions('clxxxx789012');
+     *
+     * console.log(`共 ${questions.totalCount} 道题目`);
+     * console.log('题组摘要:', questions.groupSummary);
+     *
+     * // 展示题目
+     * questions.questions.forEach((q, index) => {
+     *   console.log(`题目 ${index + 1}: ${q.content}`);
+     * });
+     * ```
+     */
+    getSessionQuestions(sessionId: string): Promise<GetSessionQuestionsResponse>;
+    /**
+     * 发起心理评测（已废弃）
+     *
+     * @deprecated 此方法已废弃，将在 v2.0 中移除。请使用 createTestSession() + getSessionQuestions() 替代。
+     *
+     * @description
+     * 根据题组代码列表发起心理评测会话，系统会自动生成打乱后的题目列表并返回。
+     *
+     * **迁移建议**：
+     * ```typescript
+     * // 旧方式（已废弃）
+     * const result = await client.psychologyTest.initiate(params);
+     *
+     * // 新方式（推荐）
+     * const { sessionId } = await client.psychologyTest.createTestSession(params);
+     * const result = await client.psychologyTest.getSessionQuestions(sessionId);
+     * ```
+     *
+     * @param params - 发起评测参数
+     * @returns 评测会话信息，包含会话ID和题目列表
+     * @throws {PlolinkError} 当参数验证失败或发起失败时抛出
+     */
+    initiate(params: InitiatePsychologyTestParams): Promise<InitiatePsychologyTestResponse>;
+    /**
+     * 提交心理评测
+     *
+     * @description
+     * 提交心理评测答题数据，系统会自动计算得分并生成 Markdown 描述。
+     * 如需 AI 分析则会加入异步队列，分析完成后会通过 Webhook 通知。
+     *
+     * @param params - 提交评测参数
+     * @returns 提交结果，包含计算结果和得分描述
+     * @throws {PlolinkError} 当参数验证失败或提交失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const result = await client.psychologyTest.submit({
+     *   sessionId: 'clxxxx789012',
+     *   answers: [
+     *     {
+     *       groupCode: 'family_parenting',
+     *       bankId: 'bank_123',
+     *       questionId: 'q_001',
+     *       questionCode: 'FP001A',
+     *       answer: '1',
+     *       timeSpent: 3500
+     *     },
+     *     // ... 更多答题记录
+     *   ],
+     *   duration: 480000
+     * });
+     *
+     * console.log('得分描述:', result.scoreDescription);
+     * console.log('计算结果:', result.calculationResults);
+     * ```
+     */
+    submit(params: SubmitPsychologyTestParams): Promise<SubmitPsychologyTestResponse>;
+    /**
+     * 获取心理评测详情
+     *
+     * @description
+     * 获取心理评测会话的完整信息，包括基本信息、计算结果、得分描述、AI分析结果等。
+     *
+     * @param sessionId - 评测会话ID
+     * @returns 评测会话详情
+     * @throws {PlolinkError} 当会话不存在或查询失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const detail = await client.psychologyTest.getDetail('clxxxx789012');
+     *
+     * console.log('评测状态:', detail.status);
+     * console.log('得分描述:', detail.scoreDescription);
+     *
+     * // 检查分析状态
+     * if (detail.analysisStatus === 'COMPLETED') {
+     *   console.log('AI分析结果:', detail.analysisResult);
+     * } else if (detail.analysisStatus === 'ANALYZING') {
+     *   console.log('AI分析进行中，请稍后查询');
+     * } else if (detail.analysisStatus === 'FAILED') {
+     *   console.error('分析失败:', detail.analysisError);
+     * }
+     * ```
+     */
+    getDetail(sessionId: string): Promise<PsychologyTestDetail>;
+    /**
+     * 获取心理评测答题记录
+     *
+     * @description
+     * 获取心理评测会话的所有答题记录。
+     *
+     * @param sessionId - 评测会话ID
+     * @returns 答题记录列表
+     * @throws {PlolinkError} 当会话不存在或查询失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const answers = await client.psychologyTest.getAnswers('clxxxx789012');
+     *
+     * console.log(`共 ${answers.length} 条答题记录`);
+     * answers.forEach(answer => {
+     *   console.log(`题目 ${answer.questionCode}: ${answer.answer}`);
+     * });
+     * ```
+     */
+    getAnswers(sessionId: string): Promise<PsychologyTestAnswerDetail[]>;
+    /**
+     * 列表查询心理评测会话
+     *
+     * @description
+     * 查询心理评测会话列表，支持分页和多条件筛选。
+     * 此接口通常用于管理后台或业务系统查询评测记录。
+     *
+     * @param params - 查询参数
+     * @returns 会话列表和分页信息
+     * @throws {PlolinkError} 当查询失败时抛出
+     *
+     * @example
+     * ```typescript
+     * // 查询所有评测会话
+     * const result = await client.psychologyTest.listTestSessions({
+     *   page: 1,
+     *   size: 20
+     * });
+     *
+     * console.log(`共 ${result.total} 条记录`);
+     * result.list.forEach(session => {
+     *   console.log(`会话ID: ${session.id}, 状态: ${session.status}`);
+     * });
+     *
+     * // 按条件筛选
+     * const filtered = await client.psychologyTest.listTestSessions({
+     *   page: 1,
+     *   size: 20,
+     *   businessModule: 'talent_assessment',
+     *   status: 'COMPLETED',
+     *   analysisStatus: 'COMPLETED'
+     * });
+     * ```
+     */
+    listTestSessions(params?: ListPsychologyTestSessionsParams): Promise<ListPsychologyTestSessionsResponse>;
+    /**
+     * 删除心理评测会话
+     *
+     * @description
+     * 软删除心理评测会话记录。删除后数据不会真正从数据库移除，
+     * 但在正常查询中不会显示。此接口通常用于管理后台。
+     *
+     * @param sessionId - 评测会话ID
+     * @returns void
+     * @throws {PlolinkError} 当会话不存在或删除失败时抛出
+     *
+     * @example
+     * ```typescript
+     * // 删除评测会话
+     * await client.psychologyTest.deleteTestSession('clxxxx789012');
+     * console.log('评测会话已删除');
+     * ```
+     */
+    deleteTestSession(sessionId: string): Promise<void>;
+    /**
+     * 获取题库组列表
+     *
+     * @description
+     * 获取所有启用状态的题库组列表，返回基本信息用于选择。
+     * 此接口不需要管理员权限，普通用户即可调用。
+     *
+     * @returns 题库组列表
+     * @throws {PlolinkError} 当查询失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const groups = await client.psychologyTest.listBankGroups();
+     * groups.forEach(g => {
+     *   console.log(`${g.name} (${g.code}): ${g.testObjective}`);
+     * });
+     * ```
+     */
+    listBankGroups(): Promise<PsychologyBankGroupSummary[]>;
+}
+
+/**
+ * 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;
+    /**
+     * 心理评测模块
+     */
+    readonly psychologyTest: PsychologyTest;
+    /**
+     * 创建一个 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, PsychologyTest as a };