@plolink/sdk 0.0.6 → 0.0.9

package/dist/{client-D2HlV7GT.d.ts → modules/psychology-test/index.d.cts}

@@ -1,5 +1,6 @@
-import { b as LoggerFunction, S as SDKConfig } from './core-77EbLgbp.js';
-import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import { P as PlolinkClient } from '../../client-CAjIQKPm.cjs';
+import '../../core-77EbLgbp.cjs';
+import 'axios';
 
 /**
  * 心理评测模块类型定义
@@ -108,8 +109,44 @@ interface GroupSummary {
     /** 题目数量 */
     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 {
     /** 题组代码列表 */
@@ -127,6 +164,7 @@ interface InitiatePsychologyTestParams {
 }
 /**
  * 发起心理评测响应
+ * @deprecated 请使用 CreatePsychologyTestSessionResponse + GetSessionQuestionsResponse
  */
 interface InitiatePsychologyTestResponse {
     /** 评测会话ID */
@@ -266,6 +304,34 @@ interface PsychologyTestDetail {
     /** 删除时间（软删除） */
     deletedAt: string | null;
 }
+/**
+ * Webhook 通知数据结构
+ */
+interface PsychologyTestWebhookData {
+    /** 事件类型 */
+    event: 'psychology_test.analysis_completed';
+    /** 时间戳（毫秒） */
+    timestamp: number;
+    /** 事件数据 */
+    data: {
+        /** 评测会话ID */
+        sessionId: string;
+        /** 业务模块 */
+        businessModule: string;
+        /** 业务码 */
+        businessCode: string;
+        /** 业务ID */
+        businessId: string;
+        /** 评测状态 */
+        status: string;
+        /** 分析状态 */
+        analysisStatus: string;
+        /** AI分析结果 */
+        analysisResult?: string;
+        /** 完成时间 */
+        completedAt: string;
+    };
+}
 /**
  * 题库组简要信息
  */
@@ -316,107 +382,6 @@ interface ListPsychologyTestSessionsResponse {
     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>;
-}
-
 /**
  * 心理评测模块
  *
@@ -482,18 +447,20 @@ declare class PsychologyTest {
     private client;
     constructor(client: PlolinkClient);
     /**
-     * 发起心理评测
+     * 创建心理评测会话
      *
      * @description
-     * 根据题组代码列表发起心理评测会话，系统会自动生成打乱后的题目列表并返回。
+     * 创建心理评测会话记录（不返回题目）。
+     * 创建后需要调用 getSessionQuestions() 获取题目列表。
      *
-     * @param params - 发起评测参数
-     * @returns 评测会话信息，包含会话ID和题目列表
-     * @throws {PlolinkError} 当参数验证失败或发起失败时抛出
+     * @param params - 创建会话参数
+     * @returns 会话信息，包含会话ID
+     * @throws {PlolinkError} 当参数验证失败或创建失败时抛出
      *
      * @example
      * ```typescript
-     * const result = await client.psychologyTest.initiate({
+     * // 1. 创建会话
+     * const { sessionId } = await client.psychologyTest.createTestSession({
      *   groupCodes: ['family_parenting', 'disc'],
      *   businessModule: 'talent_assessment',
      *   businessCode: 'job_match',
@@ -502,16 +469,59 @@ declare class PsychologyTest {
      *   analysisPrompt: '请结合家庭养育方式和DISC行为模式，分析候选人的性格特点。'
      * });
      *
-     * console.log(`评测会话ID: ${result.sessionId}`);
-     * console.log(`共 ${result.totalCount} 道题目`);
-     * console.log('题组摘要:', result.groupSummary);
+     * 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);
      *
      * // 展示题目
-     * result.questions.forEach((q, index) => {
+     * 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>;
     /**
      * 提交心理评测
@@ -671,96 +681,4 @@ declare class PsychologyTest {
     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 };
+export { type AnswerRecord, type CreatePsychologyTestSessionParams, type CreatePsychologyTestSessionResponse, type GetSessionQuestionsResponse, type GroupSummary, type InitiatePsychologyTestParams, type InitiatePsychologyTestResponse, type ListPsychologyTestSessionsParams, type ListPsychologyTestSessionsResponse, PsychologyAnalysisStatus, type PsychologyBankGroupSummary, PsychologyTest, type PsychologyTestAnswerDetail, type PsychologyTestDetail, PsychologyTestStatus, type PsychologyTestWebhookData, type QuestionDependency, type QuestionInfo, type QuestionMetadata, type QuestionOption, type QuestionType, type SubmitPsychologyTestParams, type SubmitPsychologyTestResponse, type TestCalculationResult };