@plolink/sdk 0.0.8 → 0.0.10

package/dist/{client-DXKAtLg1.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';
 
 /**
  * 心理评测模块类型定义
@@ -303,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;
+    };
+}
 /**
  * 题库组简要信息
  */
@@ -336,8 +365,6 @@ interface ListPsychologyTestSessionsParams {
     startDate?: string;
     /** 结束日期（ISO字符串） */
     endDate?: string;
-    /** 团队ID */
-    teamId?: string;
 }
 /**
  * 列表查询心理评测会话响应
@@ -353,107 +380,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>;
-}
-
 /**
  * 心理评测模块
  *
@@ -683,7 +609,7 @@ declare class PsychologyTest {
      *
      * @description
      * 查询心理评测会话列表，支持分页和多条件筛选。
-     * 此接口通常用于管理后台或业务系统查询评测记录。
+     * 团队成员可访问该团队的评测数据（teamId 由后端从认证信息中自动获取）。
      *
      * @param params - 查询参数
      * @returns 会话列表和分页信息
@@ -718,7 +644,7 @@ declare class PsychologyTest {
      *
      * @description
      * 软删除心理评测会话记录。删除后数据不会真正从数据库移除，
-     * 但在正常查询中不会显示。此接口通常用于管理后台。
+     * 但在正常查询中不会显示。团队成员可删除该团队的评测数据。
      *
      * @param sessionId - 评测会话ID
      * @returns void
@@ -753,96 +679,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 };

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

@@ -1,5 +1,6 @@
-import { b as LoggerFunction, S as SDKConfig } from './core-77EbLgbp.cjs';
-import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import { P as PlolinkClient } from '../../client-CwNikk7i.js';
+import '../../core-77EbLgbp.js';
+import 'axios';
 
 /**
  * 心理评测模块类型定义
@@ -303,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;
+    };
+}
 /**
  * 题库组简要信息
  */
@@ -336,8 +365,6 @@ interface ListPsychologyTestSessionsParams {
     startDate?: string;
     /** 结束日期（ISO字符串） */
     endDate?: string;
-    /** 团队ID */
-    teamId?: string;
 }
 /**
  * 列表查询心理评测会话响应
@@ -353,107 +380,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>;
-}
-
 /**
  * 心理评测模块
  *
@@ -683,7 +609,7 @@ declare class PsychologyTest {
      *
      * @description
      * 查询心理评测会话列表，支持分页和多条件筛选。
-     * 此接口通常用于管理后台或业务系统查询评测记录。
+     * 团队成员可访问该团队的评测数据（teamId 由后端从认证信息中自动获取）。
      *
      * @param params - 查询参数
      * @returns 会话列表和分页信息
@@ -718,7 +644,7 @@ declare class PsychologyTest {
      *
      * @description
      * 软删除心理评测会话记录。删除后数据不会真正从数据库移除，
-     * 但在正常查询中不会显示。此接口通常用于管理后台。
+     * 但在正常查询中不会显示。团队成员可删除该团队的评测数据。
      *
      * @param sessionId - 评测会话ID
      * @returns void
@@ -753,96 +679,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 };