@plolink/sdk 0.0.5 → 0.0.6

package/dist/index.js

@@ -1,7 +1,7 @@
-export { EventEmitter, TypedEventEmitter, environmentInfo, getEnvironment, isBrowser, isNode, isWebWorker } from './chunk-4H4RACSE.js';
-export { Poller } from './chunk-IHAAKFEJ.js';
 import { PlolinkError } from './chunk-MD4O7FWT.js';
 export { PlolinkError } from './chunk-MD4O7FWT.js';
+export { EventEmitter, InfoSyncSignature, TypedEventEmitter, environmentInfo, getEnvironment, isBrowser, isNode, isWebWorker } from './chunk-LHNCGCWW.js';
+export { Poller } from './chunk-IHAAKFEJ.js';
 import axios from 'axios';
 
 // src/core/logger.ts
@@ -187,6 +187,370 @@ function createAxiosInstance(config, logger) {
   return instance;
 }
 
+// src/modules/psychology-test/index.ts
+var PsychologyTest = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 发起心理评测
+   * 
+   * @description
+   * 根据题组代码列表发起心理评测会话，系统会自动生成打乱后的题目列表并返回。
+   * 
+   * @param params - 发起评测参数
+   * @returns 评测会话信息，包含会话ID和题目列表
+   * @throws {PlolinkError} 当参数验证失败或发起失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.psychologyTest.initiate({
+   *   groupCodes: ['family_parenting', 'disc'],
+   *   businessModule: 'talent_assessment',
+   *   businessCode: 'job_match',
+   *   businessId: 'clxxxx123456',
+   *   needAnalysis: true,
+   *   analysisPrompt: '请结合家庭养育方式和DISC行为模式，分析候选人的性格特点。'
+   * });
+   * 
+   * console.log(`评测会话ID: ${result.sessionId}`);
+   * console.log(`共 ${result.totalCount} 道题目`);
+   * console.log('题组摘要:', result.groupSummary);
+   * 
+   * // 展示题目
+   * result.questions.forEach((q, index) => {
+   *   console.log(`题目 ${index + 1}: ${q.content}`);
+   * });
+   * ```
+   */
+  async initiate(params) {
+    this.client.logger.info("Initiating psychology test", {
+      groupCodes: params.groupCodes,
+      businessModule: params.businessModule,
+      businessCode: params.businessCode,
+      needAnalysis: params.needAnalysis
+    });
+    if (!params.groupCodes || params.groupCodes.length === 0) {
+      throw new PlolinkError(
+        "groupCodes is required and cannot be empty",
+        "VALIDATION_ERROR"
+      );
+    }
+    if (!params.businessModule || !params.businessCode || !params.businessId) {
+      throw new PlolinkError(
+        "businessModule, businessCode, and businessId are required",
+        "VALIDATION_ERROR"
+      );
+    }
+    if (params.needAnalysis && !params.analysisPrompt) {
+      throw new PlolinkError(
+        "analysisPrompt is required when needAnalysis is true",
+        "VALIDATION_ERROR"
+      );
+    }
+    try {
+      const response = await this.client.axiosInstance.post(
+        "/api/v1/psychology/test-sessions/initiate",
+        params
+      );
+      this.client.logger.info("Psychology test initiated successfully", {
+        sessionId: response.sessionId,
+        totalCount: response.totalCount
+      });
+      return response;
+    } catch (error) {
+      this.client.logger.error("Failed to initiate psychology test", { error });
+      throw error;
+    }
+  }
+  /**
+   * 提交心理评测
+   * 
+   * @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);
+   * ```
+   */
+  async submit(params) {
+    this.client.logger.info("Submitting psychology test", {
+      sessionId: params.sessionId,
+      answersCount: params.answers.length
+    });
+    if (!params.sessionId) {
+      throw new PlolinkError(
+        "sessionId is required",
+        "VALIDATION_ERROR"
+      );
+    }
+    if (!params.answers || params.answers.length === 0) {
+      throw new PlolinkError(
+        "answers is required and cannot be empty",
+        "VALIDATION_ERROR"
+      );
+    }
+    try {
+      const response = await this.client.axiosInstance.post(
+        "/api/v1/psychology/test-sessions/submit",
+        params
+      );
+      this.client.logger.info("Psychology test submitted successfully", {
+        sessionId: response.sessionId
+      });
+      return response;
+    } catch (error) {
+      this.client.logger.error("Failed to submit psychology test", { error });
+      throw error;
+    }
+  }
+  /**
+   * 获取心理评测详情
+   * 
+   * @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);
+   * }
+   * ```
+   */
+  async getDetail(sessionId) {
+    this.client.logger.info("Getting psychology test detail", { sessionId });
+    if (!sessionId) {
+      throw new PlolinkError(
+        "sessionId is required",
+        "VALIDATION_ERROR"
+      );
+    }
+    try {
+      const response = await this.client.axiosInstance.get(
+        `/api/v1/psychology/test-sessions/${sessionId}`
+      );
+      this.client.logger.info("Psychology test detail retrieved successfully", {
+        sessionId,
+        status: response.status,
+        analysisStatus: response.analysisStatus
+      });
+      return response;
+    } catch (error) {
+      this.client.logger.error("Failed to get psychology test detail", { error });
+      throw error;
+    }
+  }
+  /**
+   * 获取心理评测答题记录
+   * 
+   * @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}`);
+   * });
+   * ```
+   */
+  async getAnswers(sessionId) {
+    this.client.logger.info("Getting psychology test answers", { sessionId });
+    if (!sessionId) {
+      throw new PlolinkError(
+        "sessionId is required",
+        "VALIDATION_ERROR"
+      );
+    }
+    try {
+      const response = await this.client.axiosInstance.get(
+        `/api/v1/psychology/test-sessions/${sessionId}/answers`
+      );
+      this.client.logger.info("Psychology test answers retrieved successfully", {
+        sessionId,
+        count: response.length
+      });
+      return response;
+    } catch (error) {
+      this.client.logger.error("Failed to get psychology test answers", { error });
+      throw error;
+    }
+  }
+  /**
+   * 列表查询心理评测会话
+   * 
+   * @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'
+   * });
+   * ```
+   */
+  async listTestSessions(params = {}) {
+    this.client.logger.info("Listing psychology test sessions", { params });
+    try {
+      const queryParams = new URLSearchParams();
+      if (params.page !== void 0) queryParams.append("page", String(params.page));
+      if (params.size !== void 0) queryParams.append("size", String(params.size));
+      if (params.businessModule) queryParams.append("businessModule", params.businessModule);
+      if (params.businessCode) queryParams.append("businessCode", params.businessCode);
+      if (params.status) queryParams.append("status", params.status);
+      if (params.analysisStatus) queryParams.append("analysisStatus", params.analysisStatus);
+      if (params.startDate) queryParams.append("startDate", params.startDate);
+      if (params.endDate) queryParams.append("endDate", params.endDate);
+      if (params.teamId) queryParams.append("teamId", params.teamId);
+      const url = `/api/admin/psychology/test-sessions${queryParams.toString() ? `?${queryParams.toString()}` : ""}`;
+      const response = await this.client.axiosInstance.get(url);
+      this.client.logger.info("Psychology test sessions listed successfully", {
+        total: response.total,
+        count: response.list.length
+      });
+      return response;
+    } catch (error) {
+      this.client.logger.error("Failed to list psychology test sessions", { error });
+      throw error;
+    }
+  }
+  /**
+   * 删除心理评测会话
+   * 
+   * @description
+   * 软删除心理评测会话记录。删除后数据不会真正从数据库移除，
+   * 但在正常查询中不会显示。此接口通常用于管理后台。
+   * 
+   * @param sessionId - 评测会话ID
+   * @returns void
+   * @throws {PlolinkError} 当会话不存在或删除失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 删除评测会话
+   * await client.psychologyTest.deleteTestSession('clxxxx789012');
+   * console.log('评测会话已删除');
+   * ```
+   */
+  async deleteTestSession(sessionId) {
+    this.client.logger.info("Deleting psychology test session", { sessionId });
+    if (!sessionId) {
+      throw new PlolinkError(
+        "sessionId is required",
+        "VALIDATION_ERROR"
+      );
+    }
+    try {
+      await this.client.axiosInstance.delete(
+        `/api/admin/psychology/test-sessions/${sessionId}`
+      );
+      this.client.logger.info("Psychology test session deleted successfully", {
+        sessionId
+      });
+    } catch (error) {
+      this.client.logger.error("Failed to delete psychology test session", { error });
+      throw error;
+    }
+  }
+  /**
+   * 获取题库组列表
+   * 
+   * @description
+   * 获取所有启用状态的题库组列表，返回基本信息用于选择。
+   * 此接口不需要管理员权限，普通用户即可调用。
+   * 
+   * @returns 题库组列表
+   * @throws {PlolinkError} 当查询失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const groups = await client.psychologyTest.listBankGroups();
+   * groups.forEach(g => {
+   *   console.log(`${g.name} (${g.code}): ${g.testObjective}`);
+   * });
+   * ```
+   */
+  async listBankGroups() {
+    this.client.logger.info("Listing psychology bank groups");
+    try {
+      const response = await this.client.axiosInstance.get(
+        "/api/v1/psychology/bank-groups"
+      );
+      this.client.logger.info("Psychology bank groups listed successfully", {
+        count: response.length
+      });
+      return response;
+    } catch (error) {
+      this.client.logger.error("Failed to list psychology bank groups", { error });
+      throw error;
+    }
+  }
+};
+
 // src/core/client.ts
 var PlolinkClient = class {
   /**
@@ -221,6 +585,7 @@ var PlolinkClient = class {
       this.config,
       this.logger
     );
+    this.psychologyTest = new PsychologyTest(this);
   }
   /**
    * 验证 SDK 配置
@@ -291,6 +656,269 @@ var PlolinkClient = class {
   }
 };
 
+// src/modules/info-sync/index.ts
+var InfoSync = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // ==================== Webhook 配置管理 ====================
+  /**
+   * 创建 Webhook 配置
+   * 
+   * @description
+   * 为当前团队创建一个新的 Webhook 配置。
+   * 返回的 secretKey 仅在创建时返回一次，请立即保存。
+   * 
+   * 每个团队最多可以创建 10 个 Webhook 配置。
+   * 
+   * ⚠️ 重要: secretKey 仅在创建时返回，后续无法再次获取，请妥善保存
+   * 
+   * @param params - 创建参数
+   * @returns 创建结果，包含配置 ID 和密钥
+   * @throws {PlolinkError} 当参数无效、配置数量超限或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * const result = await infoSync.createWebhookConfig({
+   *   name: 'Production Webhook',
+   *   url: 'https://example.com/webhook/plolink',
+   *   modules: ['report-writer', 'video-psych-analysis']
+   * });
+   * 
+   * console.log(`配置 ID: ${result.id}`);
+   * console.log(`SecretKey: ${result.secretKey}`);
+   * // 请立即保存 secretKey，后续无法再次获取
+   * ```
+   */
+  async createWebhookConfig(params) {
+    if (!params.name || params.name.trim().length === 0) {
+      throw new PlolinkError("name is required and cannot be empty", "INVALID_PARAMS");
+    }
+    if (!params.url || params.url.trim().length === 0) {
+      throw new PlolinkError("url is required and cannot be empty", "INVALID_PARAMS");
+    }
+    if (!params.url.startsWith("http://") && !params.url.startsWith("https://")) {
+      throw new PlolinkError("url must start with http:// or https://", "INVALID_PARAMS");
+    }
+    if (!Array.isArray(params.modules)) {
+      throw new PlolinkError("modules must be an array", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.post("/api/v1/info-sync/webhook-configs", params);
+  }
+  /**
+   * 获取 Webhook 配置列表
+   * 
+   * @description
+   * 获取当前团队的所有 Webhook 配置。
+   * 注意：列表中不包含 secretKey。
+   * 
+   * @returns Webhook 配置列表
+   * @throws {PlolinkError} 当权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * const configs = await infoSync.listWebhookConfigs();
+   * configs.forEach(config => {
+   *   console.log(`${config.name}: ${config.url}`);
+   *   console.log(`订阅模块: ${config.modules.join(', ')}`);
+   *   console.log(`状态: ${config.enabled ? '启用' : '禁用'}`);
+   * });
+   * ```
+   */
+  async listWebhookConfigs() {
+    return this.client.axiosInstance.get("/api/v1/info-sync/webhook-configs");
+  }
+  /**
+   * 获取 Webhook 配置详情
+   * 
+   * @description
+   * 获取指定 Webhook 配置的详细信息。
+   * 注意：不包含 secretKey。
+   * 
+   * @param id - 配置 ID
+   * @returns Webhook 配置详情
+   * @throws {PlolinkError} 当配置不存在或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * const config = await infoSync.getWebhookConfig('config-123');
+   * console.log(`名称: ${config.name}`);
+   * console.log(`URL: ${config.url}`);
+   * console.log(`订阅模块: ${config.modules.join(', ')}`);
+   * ```
+   */
+  async getWebhookConfig(id) {
+    if (!id) {
+      throw new PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/info-sync/webhook-configs/${id}`);
+  }
+  /**
+   * 更新 Webhook 配置
+   * 
+   * @description
+   * 更新指定 Webhook 配置的信息。
+   * 注意：不能更新 secretKey，如需更换密钥请删除后重新创建。
+   * 
+   * @param id - 配置 ID
+   * @param params - 更新参数
+   * @throws {PlolinkError} 当参数无效、配置不存在或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 禁用配置
+   * await infoSync.updateWebhookConfig('config-123', {
+   *   enabled: false
+   * });
+   * 
+   * // 更新订阅模块
+   * await infoSync.updateWebhookConfig('config-123', {
+   *   modules: ['report-writer']
+   * });
+   * 
+   * // 更新 URL
+   * await infoSync.updateWebhookConfig('config-123', {
+   *   url: 'https://new-url.example.com/webhook'
+   * });
+   * ```
+   */
+  async updateWebhookConfig(id, params) {
+    if (!id) {
+      throw new PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    if (params.url && (!params.url.startsWith("http://") && !params.url.startsWith("https://"))) {
+      throw new PlolinkError("url must start with http:// or https://", "INVALID_PARAMS");
+    }
+    if (params.modules !== void 0 && !Array.isArray(params.modules)) {
+      throw new PlolinkError("modules must be an array", "INVALID_PARAMS");
+    }
+    await this.client.axiosInstance.put(`/api/v1/info-sync/webhook-configs/${id}`, params);
+  }
+  /**
+   * 删除 Webhook 配置
+   * 
+   * @description
+   * 永久删除指定的 Webhook 配置（软删除）。
+   * 删除后该配置将不再接收 Webhook 通知。
+   * 
+   * ⚠️ 警告: 此操作不可逆，请确认后再执行
+   * 
+   * @param id - 配置 ID
+   * @throws {PlolinkError} 当配置不存在或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * await infoSync.deleteWebhookConfig('config-123');
+   * console.log('Webhook 配置已删除');
+   * ```
+   */
+  async deleteWebhookConfig(id) {
+    if (!id) {
+      throw new PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    await this.client.axiosInstance.delete(`/api/v1/info-sync/webhook-configs/${id}`);
+  }
+  // ==================== 同步记录查询 ====================
+  /**
+   * 查询同步记录列表
+   * 
+   * @description
+   * 查询当前团队的同步记录，支持多种过滤条件和分页。
+   * 
+   * @param params - 查询参数
+   * @returns 分页的同步记录列表
+   * @throws {PlolinkError} 当参数无效或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 查询所有记录
+   * const result = await infoSync.listSyncRecords();
+   * console.log(`共 ${result.total} 条记录`);
+   * 
+   * // 查询失败的 Webhook 同步记录
+   * const failed = await infoSync.listSyncRecords({
+   *   type: 'WEBHOOK',
+   *   status: 'FAILED'
+   * });
+   * console.log(`${failed.total} 条 Webhook 同步失败`);
+   * 
+   * // 查询报告写作模块的记录
+   * const reports = await infoSync.listSyncRecords({
+   *   businessModule: 'report-writer',
+   *   page: 1,
+   *   pageSize: 20
+   * });
+   * ```
+   */
+  async listSyncRecords(params) {
+    return this.client.axiosInstance.get("/api/v1/info-sync/sync-records", {
+      params: params || {}
+    });
+  }
+  /**
+   * 获取同步记录详情
+   * 
+   * @description
+   * 获取指定同步记录的详细信息，包括完整的历史记录。
+   * 
+   * @param id - 记录 ID
+   * @returns 同步记录详情
+   * @throws {PlolinkError} 当记录不存在或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * const record = await infoSync.getSyncRecord('record-123');
+   * console.log(`业务模块: ${record.businessModule}`);
+   * console.log(`业务代码: ${record.businessCode}`);
+   * console.log(`状态: ${record.status}`);
+   * console.log(`历史记录:`);
+   * record.history.forEach(item => {
+   *   console.log(`  ${new Date(item.time).toLocaleString()}: ${item.status} - ${item.message || ''}`);
+   * });
+   * ```
+   */
+  async getSyncRecord(id) {
+    if (!id) {
+      throw new PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/info-sync/sync-records/${id}`);
+  }
+  /**
+   * 手动重试同步任务
+   * 
+   * @description
+   * 手动重试失败的同步任务。
+   * 只能重试状态为 FAILED 的记录。
+   * 
+   * 重试后记录状态将变为 PENDING，并重新提交到队列处理。
+   * 
+   * @param id - 记录 ID
+   * @throws {PlolinkError} 当记录不存在、状态不是 FAILED 或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 查询失败记录
+   * const failed = await infoSync.listSyncRecords({ status: 'FAILED' });
+   * 
+   * // 重试所有失败记录
+   * for (const record of failed.list) {
+   *   try {
+   *     await infoSync.retrySyncRecord(record.id);
+   *     console.log(`已重试: ${record.id}`);
+   *   } catch (error) {
+   *     console.error(`重试失败: ${record.id}`, error);
+   *   }
+   * }
+   * ```
+   */
+  async retrySyncRecord(id) {
+    if (!id) {
+      throw new PlolinkError("id is required", "INVALID_PARAMS");
+    }
+    await this.client.axiosInstance.post(`/api/v1/info-sync/sync-records/${id}/retry`);
+  }
+};
+
 // src/index.ts
 var VERSION = "1.0.0";
 var DEFAULT_CONFIG = {
@@ -301,6 +929,6 @@ var DEFAULT_CONFIG = {
   backoffFactor: 1.5
 };
 
-export { DEFAULT_CONFIG, InternalLogger, PlolinkClient, VERSION };
+export { DEFAULT_CONFIG, InfoSync, InternalLogger, PlolinkClient, PsychologyTest, VERSION };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map