@plolink/sdk 0.0.6 → 0.0.8

package/dist/{client-D2HlV7GT.d.ts → client-DXKAtLg1.d.ts}

@@ -108,8 +108,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 +163,7 @@ interface InitiatePsychologyTestParams {
 }
 /**
  * 发起心理评测响应
+ * @deprecated 请使用 CreatePsychologyTestSessionResponse + GetSessionQuestionsResponse
  */
 interface InitiatePsychologyTestResponse {
     /** 评测会话ID */
@@ -482,18 +519,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 +541,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>;
     /**
      * 提交心理评测

package/dist/{client-BuUQTr8R.d.cts → client-l6cekf09.d.cts}

@@ -108,8 +108,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 +163,7 @@ interface InitiatePsychologyTestParams {
 }
 /**
  * 发起心理评测响应
+ * @deprecated 请使用 CreatePsychologyTestSessionResponse + GetSessionQuestionsResponse
  */
 interface InitiatePsychologyTestResponse {
     /** 评测会话ID */
@@ -482,18 +519,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 +541,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>;
     /**
      * 提交心理评测

package/dist/index.cjs

@@ -198,18 +198,20 @@ var PsychologyTest = class {
     this.client = client;
   }
   /**
-   * 发起心理评测
+   * 创建心理评测会话
    * 
    * @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',
@@ -218,18 +220,118 @@ var PsychologyTest = class {
    *   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);
+   * ```
+   */
+  async createTestSession(params) {
+    this.client.logger.info("Creating psychology test session", {
+      groupCodes: params.groupCodes,
+      businessModule: params.businessModule,
+      businessCode: params.businessCode,
+      needAnalysis: params.needAnalysis
+    });
+    if (!params.groupCodes || params.groupCodes.length === 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError(
+        "groupCodes is required and cannot be empty",
+        "VALIDATION_ERROR"
+      );
+    }
+    if (!params.businessModule || !params.businessCode || !params.businessId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError(
+        "businessModule, businessCode, and businessId are required",
+        "VALIDATION_ERROR"
+      );
+    }
+    if (params.needAnalysis && !params.analysisPrompt) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError(
+        "analysisPrompt is required when needAnalysis is true",
+        "VALIDATION_ERROR"
+      );
+    }
+    try {
+      const response = await this.client.axiosInstance.post(
+        "/api/v1/psychology/test-sessions",
+        params
+      );
+      this.client.logger.info("Psychology test session created successfully", {
+        sessionId: response.sessionId
+      });
+      return response;
+    } catch (error) {
+      this.client.logger.error("Failed to create psychology test session", { error });
+      throw error;
+    }
+  }
+  /**
+   * 获取会话题目
+   * 
+   * @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}`);
    * });
    * ```
    */
+  async getSessionQuestions(sessionId) {
+    this.client.logger.info("Getting session questions", { sessionId });
+    if (!sessionId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("sessionId is required", "VALIDATION_ERROR");
+    }
+    try {
+      const response = await this.client.axiosInstance.get(
+        `/api/v1/psychology/test-sessions/${sessionId}/questions`
+      );
+      this.client.logger.info("Session questions retrieved successfully", {
+        sessionId,
+        totalCount: response.totalCount
+      });
+      return response;
+    } catch (error) {
+      this.client.logger.error("Failed to get session questions", { error, sessionId });
+      throw error;
+    }
+  }
+  /**
+   * 发起心理评测（已废弃）
+   * 
+   * @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} 当参数验证失败或发起失败时抛出
+   */
   async initiate(params) {
-    this.client.logger.info("Initiating psychology test", {
+    this.client.logger.warn("Using deprecated initiate() method. Please use createTestSession() + getSessionQuestions() instead.");
+    this.client.logger.info("Initiating psychology test (deprecated)", {
       groupCodes: params.groupCodes,
       businessModule: params.businessModule,
       businessCode: params.businessCode,
@@ -254,11 +356,13 @@ var PsychologyTest = class {
       );
     }
     try {
-      const response = await this.client.axiosInstance.post(
-        "/api/v1/psychology/test-sessions/initiate",
-        params
-      );
-      this.client.logger.info("Psychology test initiated successfully", {
+      const { sessionId } = await this.createTestSession(params);
+      const questionsData = await this.getSessionQuestions(sessionId);
+      const response = {
+        sessionId,
+        ...questionsData
+      };
+      this.client.logger.info("Psychology test initiated successfully (deprecated)", {
         sessionId: response.sessionId,
         totalCount: response.totalCount
       });