@plolink/sdk 0.0.4

package/dist/modules/virtual-account/index.cjs

@@ -0,0 +1,293 @@
+'use strict';
+
+var chunkY3UJVC2L_cjs = require('../../chunk-Y3UJVC2L.cjs');
+
+// src/modules/virtual-account/index.ts
+var VirtualAccount = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 创建虚拟账号
+   * 
+   * @description
+   * 支持两种模式:
+   * - EXISTING_TEAM: 绑定到已有团队（需要是团队管理员）
+   * - NEW_TEAM: 创建新团队（当前用户成为团队管理员）
+   * 
+   * 支持预置多个角色，每个角色可以有不同的数据范围配置
+   * 
+   * @param params - 创建参数
+   * @returns 创建结果，包含虚拟账号信息和初始 API Key（明文）
+   * @throws {PlolinkError} 当参数无效、权限不足或创建失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 绑定已有团队模式
+   * const result = await virtualAccount.createVirtualAccount({
+   *   mode: 'EXISTING_TEAM',
+   *   teamId: 'team-123',
+   *   virtualAccountName: 'API Service',
+   *   apiKeyName: 'production',
+   *   presetRoles: [
+   *     {
+   *       roleType: 'SYSTEM',
+   *       roleCode: 'TEAM_MEMBER',
+   *       scopeType: 'TEAM'
+   *     },
+   *     {
+   *       roleType: 'CUSTOM',
+   *       roleId: 'role-456',
+   *       scopeType: 'CUSTOM',
+   *       scopeValue: { talent: { companyIds: ['company-1', 'company-2'] } }
+   *     }
+   *   ]
+   * });
+   * 
+   * // 创建新团队模式
+   * const result = await virtualAccount.createVirtualAccount({
+   *   mode: 'NEW_TEAM',
+   *   teamName: 'My API Team',
+   *   virtualAccountName: 'Bot Account'
+   * });
+   * 
+   * console.log(`虚拟账号 ID: ${result.virtualAccount.id}`);
+   * console.log(`API Key: ${result.apiKey.apiKey}`);
+   * ```
+   */
+  async createVirtualAccount(params) {
+    if (params.mode === "EXISTING_TEAM" && !params.teamId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError(
+        "teamId is required when mode is EXISTING_TEAM",
+        "INVALID_PARAMS"
+      );
+    }
+    return this.client.axiosInstance.post("/api/v1/virtual-accounts", params);
+  }
+  /**
+   * 列出虚拟账号
+   * 
+   * @description
+   * 列出当前团队下的所有虚拟账号，支持关键词搜索。
+   * 结果按创建时间倒序排列。
+   * 
+   * @param keyword - 可选的搜索关键词（按名称模糊匹配）
+   * @returns 虚拟账号列表
+   * @throws {PlolinkError} 当请求失败或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * // 获取所有虚拟账号
+   * const accounts = await virtualAccount.listVirtualAccounts();
+   * accounts.forEach(acc => {
+   *   console.log(`${acc.name} (ID: ${acc.id})`);
+   * });
+   * 
+   * // 搜索特定名称的虚拟账号
+   * const filtered = await virtualAccount.listVirtualAccounts('API');
+   * console.log(`找到 ${filtered.length} 个包含 "API" 的虚拟账号`);
+   * ```
+   */
+  async listVirtualAccounts(keyword) {
+    const params = keyword ? { keyword } : void 0;
+    return this.client.axiosInstance.get("/api/v1/virtual-accounts", { params });
+  }
+  /**
+   * 获取虚拟账号详情
+   * 
+   * @param virtualAccountId - 虚拟账号 ID
+   * @returns 虚拟账号详细信息
+   * @throws {PlolinkError} 当虚拟账号不存在、不属于当前团队或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * const detail = await virtualAccount.getVirtualAccountDetail('va-123');
+   * console.log(`名称: ${detail.name}`);
+   * console.log(`创建者: ${detail.virtualAccountCreatorId}`);
+   * console.log(`所属团队: ${detail.virtualAccountTeamId}`);
+   * console.log(`创建时间: ${new Date(detail.createdAt * 1000).toLocaleString()}`);
+   * ```
+   */
+  async getVirtualAccountDetail(virtualAccountId) {
+    if (!virtualAccountId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("virtualAccountId is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/virtual-accounts/${virtualAccountId}`);
+  }
+  /**
+   * 列出虚拟账号的 API Keys（明文）
+   * 
+   * @description
+   * 获取指定虚拟账号的所有 API Key，包含明文密钥。
+   * 此操作会被记录审计日志。
+   * 
+   * ⚠️ 安全提示: API Key 为敏感信息，请谨慎处理和存储
+   * 
+   * @param virtualAccountId - 虚拟账号 ID
+   * @returns API Key 列表（包含明文）
+   * @throws {PlolinkError} 当虚拟账号不存在、不属于当前团队或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * const keys = await virtualAccount.listVirtualAccountApiKeys('va-123');
+   * keys.forEach(key => {
+   *   console.log(`名称: ${key.name}`);
+   *   console.log(`密钥: ${key.apiKey}`);
+   *   console.log(`最后使用: ${key.lastUsage ? new Date(key.lastUsage * 1000).toLocaleString() : '从未使用'}`);
+   * });
+   * ```
+   */
+  async listVirtualAccountApiKeys(virtualAccountId) {
+    if (!virtualAccountId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("virtualAccountId is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(
+      `/api/v1/virtual-accounts/${virtualAccountId}/api-keys`
+    );
+  }
+  /**
+   * 为虚拟账号创建新的 API Key
+   * 
+   * @description
+   * 为指定虚拟账号创建新的 API Key。
+   * 返回的密钥为明文，建议立即保存到安全位置。
+   * 
+   * ⚠️ 安全提示: 
+   * - API Key 创建后可随时查看明文，但请妥善保管
+   * - 建议为不同用途创建不同的 API Key，便于管理和吊销
+   * 
+   * @param virtualAccountId - 虚拟账号 ID
+   * @param params - 创建参数
+   * @returns 创建的 API Key 信息（包含明文密钥）
+   * @throws {PlolinkError} 当参数无效、权限不足或创建失败时抛出
+   * 
+   * @example
+   * ```typescript
+   * const newKey = await virtualAccount.createVirtualAccountApiKey('va-123', {
+   *   name: 'Production API Key'
+   * });
+   * 
+   * console.log(`API Key ID: ${newKey.id}`);
+   * console.log(`API Key: ${newKey.apiKey}`);
+   * // 请妥善保存此密钥
+   * ```
+   */
+  async createVirtualAccountApiKey(virtualAccountId, params) {
+    if (!virtualAccountId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("virtualAccountId is required", "INVALID_PARAMS");
+    }
+    if (!params.name || params.name.trim().length === 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("name is required and cannot be empty", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.post(
+      `/api/v1/virtual-accounts/${virtualAccountId}/api-keys`,
+      params
+    );
+  }
+  /**
+   * 编辑虚拟账号 API Key（仅改名）
+   * 
+   * @description
+   * 修改 API Key 的名称，不影响密钥本身。
+   * 用于更好地识别和管理 API Key。
+   * 
+   * @param virtualAccountId - 虚拟账号 ID
+   * @param params - 更新参数
+   * @throws {PlolinkError} 当参数无效、API Key 不存在或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * await virtualAccount.updateVirtualAccountApiKey('va-123', {
+   *   apiKeyId: 'key-456',
+   *   name: 'Production API Key (v2)'
+   * });
+   * console.log('API Key 名称已更新');
+   * ```
+   */
+  async updateVirtualAccountApiKey(virtualAccountId, params) {
+    if (!virtualAccountId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("virtualAccountId is required", "INVALID_PARAMS");
+    }
+    if (!params.apiKeyId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("apiKeyId is required", "INVALID_PARAMS");
+    }
+    if (!params.name || params.name.trim().length === 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("name is required and cannot be empty", "INVALID_PARAMS");
+    }
+    await this.client.axiosInstance.post(
+      `/api/v1/virtual-accounts/${virtualAccountId}/api-keys/edit`,
+      params
+    );
+  }
+  /**
+   * 删除虚拟账号 API Key
+   * 
+   * @description
+   * 永久删除指定的 API Key，此操作不可恢复。
+   * 删除后使用该密钥的请求将立即失效。
+   * 
+   * ⚠️ 警告: 此操作不可逆，请确认后再执行
+   * 
+   * @param virtualAccountId - 虚拟账号 ID
+   * @param apiKeyId - API Key ID
+   * @throws {PlolinkError} 当参数无效、API Key 不存在或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * await virtualAccount.deleteVirtualAccountApiKey('va-123', 'key-456');
+   * console.log('API Key 已删除');
+   * ```
+   */
+  async deleteVirtualAccountApiKey(virtualAccountId, apiKeyId) {
+    if (!virtualAccountId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("virtualAccountId is required", "INVALID_PARAMS");
+    }
+    if (!apiKeyId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("apiKeyId is required", "INVALID_PARAMS");
+    }
+    await this.client.axiosInstance.post(
+      `/api/v1/virtual-accounts/${virtualAccountId}/api-keys/delete`,
+      { apiKeyId }
+    );
+  }
+  /**
+   * 删除虚拟账号
+   * 
+   * @description
+   * 永久删除指定的虚拟账号，包括其所有关联的 API Keys、团队成员关系和角色分配。
+   * 此操作不可恢复。
+   * 
+   * 删除后将会清理：
+   * - 虚拟账号用户（User）
+   * - 所有 API Keys（UserApiKey）
+   * - 团队成员关系（TeamMember）
+   * - 成员角色（MemberRole）
+   * 
+   * 注意：虚拟账号所属的团队不会被删除。
+   * 
+   * ⚠️ 警告: 
+   * - 此操作不可逆，请确认后再执行
+   * - 删除后该虚拟账号的所有 API Keys 将立即失效
+   * 
+   * @param virtualAccountId - 虚拟账号 ID
+   * @throws {PlolinkError} 当参数无效、虚拟账号不存在或权限不足时抛出
+   * 
+   * @example
+   * ```typescript
+   * await virtualAccount.deleteVirtualAccount('va-123');
+   * console.log('虚拟账号已删除');
+   * ```
+   */
+  async deleteVirtualAccount(virtualAccountId) {
+    if (!virtualAccountId) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("virtualAccountId is required", "INVALID_PARAMS");
+    }
+    await this.client.axiosInstance.post(
+      `/api/v1/virtual-accounts/${virtualAccountId}/delete`
+    );
+  }
+};
+
+exports.VirtualAccount = VirtualAccount;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/modules/virtual-account/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/virtual-account/index.ts"],"names":["PlolinkError"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * 虚拟账号管理模块\n * \n * @description\n * 提供完整的虚拟账号管理功能，包括:\n * - 虚拟账号创建（支持绑定已有团队或创建新团队）\n * - 虚拟账号列表查询（支持关键词搜索）\n * - 虚拟账号详情查询\n * - API Key 管理（列表/创建/编辑/删除）\n * - 支持多角色预置\n * \n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { VirtualAccount } from '@plolink/sdk/virtual-account';\n * \n * const client = new PlolinkClient({\n *   token: 'your-session-id-or-api-key'\n * });\n * \n * const virtualAccount = new VirtualAccount(client);\n * \n * // 创建虚拟账号（绑定已有团队）\n * const result = await virtualAccount.createVirtualAccount({\n *   mode: 'EXISTING_TEAM',\n *   teamId: 'team-123',\n *   virtualAccountName: 'API Service Account',\n *   presetRoles: [{\n *     roleType: 'SYSTEM',\n *     roleCode: 'TEAM_MEMBER',\n *     scopeType: 'TEAM'\n *   }]\n * });\n * console.log(`虚拟账号创建成功: ${result.virtualAccount.name}`);\n * console.log(`API Key: ${result.apiKey.apiKey}`);\n * \n * // 列出虚拟账号\n * const accounts = await virtualAccount.listVirtualAccounts();\n * console.log(`共 ${accounts.length} 个虚拟账号`);\n * ```\n * \n * @module virtual-account\n */\n\nimport { PlolinkClient } from '../../core/client';\nimport { PlolinkError } from '../../core/error';\nimport type {\n  CreateVirtualAccountParams,\n  CreateVirtualAccountResponse,\n  VirtualAccountListItem,\n  VirtualAccountInfo,\n  VirtualAccountApiKeyItem,\n  CreateVirtualAccountApiKeyParams,\n  UpdateVirtualAccountApiKeyParams,\n} from '../../types/virtual-account';\n\nexport type {\n  CreateVirtualAccountParams,\n  CreateVirtualAccountResponse,\n  VirtualAccountListItem,\n  VirtualAccountInfo,\n  VirtualAccountApiKeyItem,\n  CreateVirtualAccountApiKeyParams,\n  UpdateVirtualAccountApiKeyParams,\n} from '../../types/virtual-account';\n\nexport type { AssignRoleParams } from '../../types/shared';\n\n/**\n * 虚拟账号管理模块\n */\nexport class VirtualAccount {\n  private client: PlolinkClient;\n\n  constructor(client: PlolinkClient) {\n    this.client = client;\n  }\n\n  /**\n   * 创建虚拟账号\n   * \n   * @description\n   * 支持两种模式:\n   * - EXISTING_TEAM: 绑定到已有团队（需要是团队管理员）\n   * - NEW_TEAM: 创建新团队（当前用户成为团队管理员）\n   * \n   * 支持预置多个角色，每个角色可以有不同的数据范围配置\n   * \n   * @param params - 创建参数\n   * @returns 创建结果，包含虚拟账号信息和初始 API Key（明文）\n   * @throws {PlolinkError} 当参数无效、权限不足或创建失败时抛出\n   * \n   * @example\n   * ```typescript\n   * // 绑定已有团队模式\n   * const result = await virtualAccount.createVirtualAccount({\n   *   mode: 'EXISTING_TEAM',\n   *   teamId: 'team-123',\n   *   virtualAccountName: 'API Service',\n   *   apiKeyName: 'production',\n   *   presetRoles: [\n   *     {\n   *       roleType: 'SYSTEM',\n   *       roleCode: 'TEAM_MEMBER',\n   *       scopeType: 'TEAM'\n   *     },\n   *     {\n   *       roleType: 'CUSTOM',\n   *       roleId: 'role-456',\n   *       scopeType: 'CUSTOM',\n   *       scopeValue: { talent: { companyIds: ['company-1', 'company-2'] } }\n   *     }\n   *   ]\n   * });\n   * \n   * // 创建新团队模式\n   * const result = await virtualAccount.createVirtualAccount({\n   *   mode: 'NEW_TEAM',\n   *   teamName: 'My API Team',\n   *   virtualAccountName: 'Bot Account'\n   * });\n   * \n   * console.log(`虚拟账号 ID: ${result.virtualAccount.id}`);\n   * console.log(`API Key: ${result.apiKey.apiKey}`);\n   * ```\n   */\n  public async createVirtualAccount(\n    params: CreateVirtualAccountParams\n  ): Promise<CreateVirtualAccountResponse> {\n    // 参数验证\n    if (params.mode === 'EXISTING_TEAM' && !params.teamId) {\n      throw new PlolinkError(\n        'teamId is required when mode is EXISTING_TEAM',\n        'INVALID_PARAMS'\n      );\n    }\n\n    return this.client.axiosInstance.post('/api/v1/virtual-accounts', params);\n  }\n\n  /**\n   * 列出虚拟账号\n   * \n   * @description\n   * 列出当前团队下的所有虚拟账号，支持关键词搜索。\n   * 结果按创建时间倒序排列。\n   * \n   * @param keyword - 可选的搜索关键词（按名称模糊匹配）\n   * @returns 虚拟账号列表\n   * @throws {PlolinkError} 当请求失败或权限不足时抛出\n   * \n   * @example\n   * ```typescript\n   * // 获取所有虚拟账号\n   * const accounts = await virtualAccount.listVirtualAccounts();\n   * accounts.forEach(acc => {\n   *   console.log(`${acc.name} (ID: ${acc.id})`);\n   * });\n   * \n   * // 搜索特定名称的虚拟账号\n   * const filtered = await virtualAccount.listVirtualAccounts('API');\n   * console.log(`找到 ${filtered.length} 个包含 \"API\" 的虚拟账号`);\n   * ```\n   */\n  public async listVirtualAccounts(keyword?: string): Promise<VirtualAccountListItem[]> {\n    const params = keyword ? { keyword } : undefined;\n    return this.client.axiosInstance.get('/api/v1/virtual-accounts', { params });\n  }\n\n  /**\n   * 获取虚拟账号详情\n   * \n   * @param virtualAccountId - 虚拟账号 ID\n   * @returns 虚拟账号详细信息\n   * @throws {PlolinkError} 当虚拟账号不存在、不属于当前团队或权限不足时抛出\n   * \n   * @example\n   * ```typescript\n   * const detail = await virtualAccount.getVirtualAccountDetail('va-123');\n   * console.log(`名称: ${detail.name}`);\n   * console.log(`创建者: ${detail.virtualAccountCreatorId}`);\n   * console.log(`所属团队: ${detail.virtualAccountTeamId}`);\n   * console.log(`创建时间: ${new Date(detail.createdAt * 1000).toLocaleString()}`);\n   * ```\n   */\n  public async getVirtualAccountDetail(virtualAccountId: string): Promise<VirtualAccountInfo> {\n    if (!virtualAccountId) {\n      throw new PlolinkError('virtualAccountId is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.get(`/api/v1/virtual-accounts/${virtualAccountId}`);\n  }\n\n  /**\n   * 列出虚拟账号的 API Keys（明文）\n   * \n   * @description\n   * 获取指定虚拟账号的所有 API Key，包含明文密钥。\n   * 此操作会被记录审计日志。\n   * \n   * ⚠️ 安全提示: API Key 为敏感信息，请谨慎处理和存储\n   * \n   * @param virtualAccountId - 虚拟账号 ID\n   * @returns API Key 列表（包含明文）\n   * @throws {PlolinkError} 当虚拟账号不存在、不属于当前团队或权限不足时抛出\n   * \n   * @example\n   * ```typescript\n   * const keys = await virtualAccount.listVirtualAccountApiKeys('va-123');\n   * keys.forEach(key => {\n   *   console.log(`名称: ${key.name}`);\n   *   console.log(`密钥: ${key.apiKey}`);\n   *   console.log(`最后使用: ${key.lastUsage ? new Date(key.lastUsage * 1000).toLocaleString() : '从未使用'}`);\n   * });\n   * ```\n   */\n  public async listVirtualAccountApiKeys(\n    virtualAccountId: string\n  ): Promise<VirtualAccountApiKeyItem[]> {\n    if (!virtualAccountId) {\n      throw new PlolinkError('virtualAccountId is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.get(\n      `/api/v1/virtual-accounts/${virtualAccountId}/api-keys`\n    );\n  }\n\n  /**\n   * 为虚拟账号创建新的 API Key\n   * \n   * @description\n   * 为指定虚拟账号创建新的 API Key。\n   * 返回的密钥为明文，建议立即保存到安全位置。\n   * \n   * ⚠️ 安全提示: \n   * - API Key 创建后可随时查看明文，但请妥善保管\n   * - 建议为不同用途创建不同的 API Key，便于管理和吊销\n   * \n   * @param virtualAccountId - 虚拟账号 ID\n   * @param params - 创建参数\n   * @returns 创建的 API Key 信息（包含明文密钥）\n   * @throws {PlolinkError} 当参数无效、权限不足或创建失败时抛出\n   * \n   * @example\n   * ```typescript\n   * const newKey = await virtualAccount.createVirtualAccountApiKey('va-123', {\n   *   name: 'Production API Key'\n   * });\n   * \n   * console.log(`API Key ID: ${newKey.id}`);\n   * console.log(`API Key: ${newKey.apiKey}`);\n   * // 请妥善保存此密钥\n   * ```\n   */\n  public async createVirtualAccountApiKey(\n    virtualAccountId: string,\n    params: CreateVirtualAccountApiKeyParams\n  ): Promise<{ id: string; apiKey: string }> {\n    if (!virtualAccountId) {\n      throw new PlolinkError('virtualAccountId is required', 'INVALID_PARAMS');\n    }\n\n    if (!params.name || params.name.trim().length === 0) {\n      throw new PlolinkError('name is required and cannot be empty', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.post(\n      `/api/v1/virtual-accounts/${virtualAccountId}/api-keys`,\n      params\n    );\n  }\n\n  /**\n   * 编辑虚拟账号 API Key（仅改名）\n   * \n   * @description\n   * 修改 API Key 的名称，不影响密钥本身。\n   * 用于更好地识别和管理 API Key。\n   * \n   * @param virtualAccountId - 虚拟账号 ID\n   * @param params - 更新参数\n   * @throws {PlolinkError} 当参数无效、API Key 不存在或权限不足时抛出\n   * \n   * @example\n   * ```typescript\n   * await virtualAccount.updateVirtualAccountApiKey('va-123', {\n   *   apiKeyId: 'key-456',\n   *   name: 'Production API Key (v2)'\n   * });\n   * console.log('API Key 名称已更新');\n   * ```\n   */\n  public async updateVirtualAccountApiKey(\n    virtualAccountId: string,\n    params: UpdateVirtualAccountApiKeyParams\n  ): Promise<void> {\n    if (!virtualAccountId) {\n      throw new PlolinkError('virtualAccountId is required', 'INVALID_PARAMS');\n    }\n\n    if (!params.apiKeyId) {\n      throw new PlolinkError('apiKeyId is required', 'INVALID_PARAMS');\n    }\n\n    if (!params.name || params.name.trim().length === 0) {\n      throw new PlolinkError('name is required and cannot be empty', 'INVALID_PARAMS');\n    }\n\n    await this.client.axiosInstance.post(\n      `/api/v1/virtual-accounts/${virtualAccountId}/api-keys/edit`,\n      params\n    );\n  }\n\n  /**\n   * 删除虚拟账号 API Key\n   * \n   * @description\n   * 永久删除指定的 API Key，此操作不可恢复。\n   * 删除后使用该密钥的请求将立即失效。\n   * \n   * ⚠️ 警告: 此操作不可逆，请确认后再执行\n   * \n   * @param virtualAccountId - 虚拟账号 ID\n   * @param apiKeyId - API Key ID\n   * @throws {PlolinkError} 当参数无效、API Key 不存在或权限不足时抛出\n   * \n   * @example\n   * ```typescript\n   * await virtualAccount.deleteVirtualAccountApiKey('va-123', 'key-456');\n   * console.log('API Key 已删除');\n   * ```\n   */\n  public async deleteVirtualAccountApiKey(\n    virtualAccountId: string,\n    apiKeyId: string\n  ): Promise<void> {\n    if (!virtualAccountId) {\n      throw new PlolinkError('virtualAccountId is required', 'INVALID_PARAMS');\n    }\n\n    if (!apiKeyId) {\n      throw new PlolinkError('apiKeyId is required', 'INVALID_PARAMS');\n    }\n\n    await this.client.axiosInstance.post(\n      `/api/v1/virtual-accounts/${virtualAccountId}/api-keys/delete`,\n      { apiKeyId }\n    );\n  }\n\n  /**\n   * 删除虚拟账号\n   * \n   * @description\n   * 永久删除指定的虚拟账号，包括其所有关联的 API Keys、团队成员关系和角色分配。\n   * 此操作不可恢复。\n   * \n   * 删除后将会清理：\n   * - 虚拟账号用户（User）\n   * - 所有 API Keys（UserApiKey）\n   * - 团队成员关系（TeamMember）\n   * - 成员角色（MemberRole）\n   * \n   * 注意：虚拟账号所属的团队不会被删除。\n   * \n   * ⚠️ 警告: \n   * - 此操作不可逆，请确认后再执行\n   * - 删除后该虚拟账号的所有 API Keys 将立即失效\n   * \n   * @param virtualAccountId - 虚拟账号 ID\n   * @throws {PlolinkError} 当参数无效、虚拟账号不存在或权限不足时抛出\n   * \n   * @example\n   * ```typescript\n   * await virtualAccount.deleteVirtualAccount('va-123');\n   * console.log('虚拟账号已删除');\n   * ```\n   */\n  public async deleteVirtualAccount(virtualAccountId: string): Promise<void> {\n    if (!virtualAccountId) {\n      throw new PlolinkError('virtualAccountId is required', 'INVALID_PARAMS');\n    }\n\n    await this.client.axiosInstance.post(\n      `/api/v1/virtual-accounts/${virtualAccountId}/delete`\n    );\n  }\n}\n\n"]}

package/dist/modules/virtual-account/index.d.cts

@@ -0,0 +1,366 @@
+import { P as PlolinkClient } from '../../client-CAjIQKPm.cjs';
+import { A as AssignRoleParams } from '../../shared-6ZepUSPW.cjs';
+import '../../core-77EbLgbp.cjs';
+import 'axios';
+
+/**
+ * VirtualAccount 模块类型
+ */
+
+/**
+ * 创建虚拟账号参数（绑定已有团队模式）
+ */
+interface CreateVirtualAccountWithExistingTeam {
+    mode: 'EXISTING_TEAM';
+    /** 团队ID */
+    teamId: string;
+    /** 虚拟账号名称（可选，不填自动生成） */
+    virtualAccountName?: string;
+    /** API Key 名称（可选，默认 'default'） */
+    apiKeyName?: string;
+    /** 预置角色列表（支持多个） */
+    presetRoles?: AssignRoleParams[];
+}
+/**
+ * 创建虚拟账号参数（创建新团队模式）
+ */
+interface CreateVirtualAccountWithNewTeam {
+    mode: 'NEW_TEAM';
+    /** 新团队名称（可选，不填自动生成） */
+    teamName?: string;
+    /** 虚拟账号名称（可选，不填自动生成） */
+    virtualAccountName?: string;
+    /** API Key 名称（可选，默认 'default'） */
+    apiKeyName?: string;
+    /** 预置角色列表（支持多个） */
+    presetRoles?: AssignRoleParams[];
+}
+/**
+ * 创建虚拟账号参数（联合类型）
+ */
+type CreateVirtualAccountParams = CreateVirtualAccountWithExistingTeam | CreateVirtualAccountWithNewTeam;
+/**
+ * 虚拟账号信息
+ */
+interface VirtualAccountInfo {
+    id: string;
+    name: string;
+    isVirtualAccount: true;
+    virtualAccountCreatorId: string;
+    virtualAccountTeamId: string;
+    createdAt: number;
+}
+/**
+ * 创建虚拟账号响应
+ */
+interface CreateVirtualAccountResponse {
+    virtualAccount: VirtualAccountInfo;
+    apiKey: {
+        id: string;
+        name: string;
+        apiKey: string;
+    };
+}
+/**
+ * 虚拟账号列表项
+ */
+interface VirtualAccountListItem {
+    id: string;
+    name: string;
+    virtualAccountCreatorId: string;
+    virtualAccountTeamId: string;
+    createdAt: number;
+}
+/**
+ * 虚拟账号 API Key 列表项
+ */
+interface VirtualAccountApiKeyItem {
+    id: string;
+    name: string;
+    apiKey: string;
+    createdAt: number;
+    lastUsage: number;
+}
+/**
+ * 创建虚拟账号 API Key 参数
+ */
+interface CreateVirtualAccountApiKeyParams {
+    name: string;
+}
+/**
+ * 更新虚拟账号 API Key 参数
+ */
+interface UpdateVirtualAccountApiKeyParams {
+    apiKeyId: string;
+    name: string;
+}
+
+/**
+ * 虚拟账号管理模块
+ *
+ * @description
+ * 提供完整的虚拟账号管理功能，包括:
+ * - 虚拟账号创建（支持绑定已有团队或创建新团队）
+ * - 虚拟账号列表查询（支持关键词搜索）
+ * - 虚拟账号详情查询
+ * - API Key 管理（列表/创建/编辑/删除）
+ * - 支持多角色预置
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ * import { VirtualAccount } from '@plolink/sdk/virtual-account';
+ *
+ * const client = new PlolinkClient({
+ *   token: 'your-session-id-or-api-key'
+ * });
+ *
+ * const virtualAccount = new VirtualAccount(client);
+ *
+ * // 创建虚拟账号（绑定已有团队）
+ * const result = await virtualAccount.createVirtualAccount({
+ *   mode: 'EXISTING_TEAM',
+ *   teamId: 'team-123',
+ *   virtualAccountName: 'API Service Account',
+ *   presetRoles: [{
+ *     roleType: 'SYSTEM',
+ *     roleCode: 'TEAM_MEMBER',
+ *     scopeType: 'TEAM'
+ *   }]
+ * });
+ * console.log(`虚拟账号创建成功: ${result.virtualAccount.name}`);
+ * console.log(`API Key: ${result.apiKey.apiKey}`);
+ *
+ * // 列出虚拟账号
+ * const accounts = await virtualAccount.listVirtualAccounts();
+ * console.log(`共 ${accounts.length} 个虚拟账号`);
+ * ```
+ *
+ * @module virtual-account
+ */
+
+/**
+ * 虚拟账号管理模块
+ */
+declare class VirtualAccount {
+    private client;
+    constructor(client: PlolinkClient);
+    /**
+     * 创建虚拟账号
+     *
+     * @description
+     * 支持两种模式:
+     * - EXISTING_TEAM: 绑定到已有团队（需要是团队管理员）
+     * - NEW_TEAM: 创建新团队（当前用户成为团队管理员）
+     *
+     * 支持预置多个角色，每个角色可以有不同的数据范围配置
+     *
+     * @param params - 创建参数
+     * @returns 创建结果，包含虚拟账号信息和初始 API Key（明文）
+     * @throws {PlolinkError} 当参数无效、权限不足或创建失败时抛出
+     *
+     * @example
+     * ```typescript
+     * // 绑定已有团队模式
+     * const result = await virtualAccount.createVirtualAccount({
+     *   mode: 'EXISTING_TEAM',
+     *   teamId: 'team-123',
+     *   virtualAccountName: 'API Service',
+     *   apiKeyName: 'production',
+     *   presetRoles: [
+     *     {
+     *       roleType: 'SYSTEM',
+     *       roleCode: 'TEAM_MEMBER',
+     *       scopeType: 'TEAM'
+     *     },
+     *     {
+     *       roleType: 'CUSTOM',
+     *       roleId: 'role-456',
+     *       scopeType: 'CUSTOM',
+     *       scopeValue: { talent: { companyIds: ['company-1', 'company-2'] } }
+     *     }
+     *   ]
+     * });
+     *
+     * // 创建新团队模式
+     * const result = await virtualAccount.createVirtualAccount({
+     *   mode: 'NEW_TEAM',
+     *   teamName: 'My API Team',
+     *   virtualAccountName: 'Bot Account'
+     * });
+     *
+     * console.log(`虚拟账号 ID: ${result.virtualAccount.id}`);
+     * console.log(`API Key: ${result.apiKey.apiKey}`);
+     * ```
+     */
+    createVirtualAccount(params: CreateVirtualAccountParams): Promise<CreateVirtualAccountResponse>;
+    /**
+     * 列出虚拟账号
+     *
+     * @description
+     * 列出当前团队下的所有虚拟账号，支持关键词搜索。
+     * 结果按创建时间倒序排列。
+     *
+     * @param keyword - 可选的搜索关键词（按名称模糊匹配）
+     * @returns 虚拟账号列表
+     * @throws {PlolinkError} 当请求失败或权限不足时抛出
+     *
+     * @example
+     * ```typescript
+     * // 获取所有虚拟账号
+     * const accounts = await virtualAccount.listVirtualAccounts();
+     * accounts.forEach(acc => {
+     *   console.log(`${acc.name} (ID: ${acc.id})`);
+     * });
+     *
+     * // 搜索特定名称的虚拟账号
+     * const filtered = await virtualAccount.listVirtualAccounts('API');
+     * console.log(`找到 ${filtered.length} 个包含 "API" 的虚拟账号`);
+     * ```
+     */
+    listVirtualAccounts(keyword?: string): Promise<VirtualAccountListItem[]>;
+    /**
+     * 获取虚拟账号详情
+     *
+     * @param virtualAccountId - 虚拟账号 ID
+     * @returns 虚拟账号详细信息
+     * @throws {PlolinkError} 当虚拟账号不存在、不属于当前团队或权限不足时抛出
+     *
+     * @example
+     * ```typescript
+     * const detail = await virtualAccount.getVirtualAccountDetail('va-123');
+     * console.log(`名称: ${detail.name}`);
+     * console.log(`创建者: ${detail.virtualAccountCreatorId}`);
+     * console.log(`所属团队: ${detail.virtualAccountTeamId}`);
+     * console.log(`创建时间: ${new Date(detail.createdAt * 1000).toLocaleString()}`);
+     * ```
+     */
+    getVirtualAccountDetail(virtualAccountId: string): Promise<VirtualAccountInfo>;
+    /**
+     * 列出虚拟账号的 API Keys（明文）
+     *
+     * @description
+     * 获取指定虚拟账号的所有 API Key，包含明文密钥。
+     * 此操作会被记录审计日志。
+     *
+     * ⚠️ 安全提示: API Key 为敏感信息，请谨慎处理和存储
+     *
+     * @param virtualAccountId - 虚拟账号 ID
+     * @returns API Key 列表（包含明文）
+     * @throws {PlolinkError} 当虚拟账号不存在、不属于当前团队或权限不足时抛出
+     *
+     * @example
+     * ```typescript
+     * const keys = await virtualAccount.listVirtualAccountApiKeys('va-123');
+     * keys.forEach(key => {
+     *   console.log(`名称: ${key.name}`);
+     *   console.log(`密钥: ${key.apiKey}`);
+     *   console.log(`最后使用: ${key.lastUsage ? new Date(key.lastUsage * 1000).toLocaleString() : '从未使用'}`);
+     * });
+     * ```
+     */
+    listVirtualAccountApiKeys(virtualAccountId: string): Promise<VirtualAccountApiKeyItem[]>;
+    /**
+     * 为虚拟账号创建新的 API Key
+     *
+     * @description
+     * 为指定虚拟账号创建新的 API Key。
+     * 返回的密钥为明文，建议立即保存到安全位置。
+     *
+     * ⚠️ 安全提示:
+     * - API Key 创建后可随时查看明文，但请妥善保管
+     * - 建议为不同用途创建不同的 API Key，便于管理和吊销
+     *
+     * @param virtualAccountId - 虚拟账号 ID
+     * @param params - 创建参数
+     * @returns 创建的 API Key 信息（包含明文密钥）
+     * @throws {PlolinkError} 当参数无效、权限不足或创建失败时抛出
+     *
+     * @example
+     * ```typescript
+     * const newKey = await virtualAccount.createVirtualAccountApiKey('va-123', {
+     *   name: 'Production API Key'
+     * });
+     *
+     * console.log(`API Key ID: ${newKey.id}`);
+     * console.log(`API Key: ${newKey.apiKey}`);
+     * // 请妥善保存此密钥
+     * ```
+     */
+    createVirtualAccountApiKey(virtualAccountId: string, params: CreateVirtualAccountApiKeyParams): Promise<{
+        id: string;
+        apiKey: string;
+    }>;
+    /**
+     * 编辑虚拟账号 API Key（仅改名）
+     *
+     * @description
+     * 修改 API Key 的名称，不影响密钥本身。
+     * 用于更好地识别和管理 API Key。
+     *
+     * @param virtualAccountId - 虚拟账号 ID
+     * @param params - 更新参数
+     * @throws {PlolinkError} 当参数无效、API Key 不存在或权限不足时抛出
+     *
+     * @example
+     * ```typescript
+     * await virtualAccount.updateVirtualAccountApiKey('va-123', {
+     *   apiKeyId: 'key-456',
+     *   name: 'Production API Key (v2)'
+     * });
+     * console.log('API Key 名称已更新');
+     * ```
+     */
+    updateVirtualAccountApiKey(virtualAccountId: string, params: UpdateVirtualAccountApiKeyParams): Promise<void>;
+    /**
+     * 删除虚拟账号 API Key
+     *
+     * @description
+     * 永久删除指定的 API Key，此操作不可恢复。
+     * 删除后使用该密钥的请求将立即失效。
+     *
+     * ⚠️ 警告: 此操作不可逆，请确认后再执行
+     *
+     * @param virtualAccountId - 虚拟账号 ID
+     * @param apiKeyId - API Key ID
+     * @throws {PlolinkError} 当参数无效、API Key 不存在或权限不足时抛出
+     *
+     * @example
+     * ```typescript
+     * await virtualAccount.deleteVirtualAccountApiKey('va-123', 'key-456');
+     * console.log('API Key 已删除');
+     * ```
+     */
+    deleteVirtualAccountApiKey(virtualAccountId: string, apiKeyId: string): Promise<void>;
+    /**
+     * 删除虚拟账号
+     *
+     * @description
+     * 永久删除指定的虚拟账号，包括其所有关联的 API Keys、团队成员关系和角色分配。
+     * 此操作不可恢复。
+     *
+     * 删除后将会清理：
+     * - 虚拟账号用户（User）
+     * - 所有 API Keys（UserApiKey）
+     * - 团队成员关系（TeamMember）
+     * - 成员角色（MemberRole）
+     *
+     * 注意：虚拟账号所属的团队不会被删除。
+     *
+     * ⚠️ 警告:
+     * - 此操作不可逆，请确认后再执行
+     * - 删除后该虚拟账号的所有 API Keys 将立即失效
+     *
+     * @param virtualAccountId - 虚拟账号 ID
+     * @throws {PlolinkError} 当参数无效、虚拟账号不存在或权限不足时抛出
+     *
+     * @example
+     * ```typescript
+     * await virtualAccount.deleteVirtualAccount('va-123');
+     * console.log('虚拟账号已删除');
+     * ```
+     */
+    deleteVirtualAccount(virtualAccountId: string): Promise<void>;
+}
+
+export { AssignRoleParams, type CreateVirtualAccountApiKeyParams, type CreateVirtualAccountParams, type CreateVirtualAccountResponse, type UpdateVirtualAccountApiKeyParams, VirtualAccount, type VirtualAccountApiKeyItem, type VirtualAccountInfo, type VirtualAccountListItem };