@plolink/sdk 0.0.4

package/dist/modules/rbac/index.js

@@ -0,0 +1,195 @@
+import { PlolinkError } from '../../chunk-MD4O7FWT.js';
+
+// src/modules/rbac/index.ts
+var Rbac = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 获取所有权限点定义 + 系统角色定义
+   * GET /api/v1/permissions
+   */
+  async getPermissionDefinitions() {
+    return this.client.axiosInstance.get("/api/v1/permissions");
+  }
+  /**
+   * 列出团队角色（系统角色 + 自定义角色）
+   * GET /api/v1/teams/:teamId/roles
+   */
+  async listTeamRoles(teamId) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/teams/${teamId}/roles`);
+  }
+  /**
+   * 创建自定义角色
+   * POST /api/v1/teams/:teamId/roles
+   */
+  async createCustomRole(teamId, params) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    if (!params.name || params.name.trim().length === 0) {
+      throw new PlolinkError("name is required and cannot be empty", "INVALID_PARAMS");
+    }
+    if (!params.code || params.code.trim().length === 0) {
+      throw new PlolinkError("code is required and cannot be empty", "INVALID_PARAMS");
+    }
+    if (!Array.isArray(params.permissions)) {
+      throw new PlolinkError("permissions must be an array", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.post(`/api/v1/teams/${teamId}/roles`, params);
+  }
+  /**
+   * 更新自定义角色
+   * PUT /api/v1/teams/:teamId/roles/:roleId
+   */
+  async updateCustomRole(teamId, roleId, params) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    if (!roleId || roleId.trim().length === 0) {
+      throw new PlolinkError("roleId is required", "INVALID_PARAMS");
+    }
+    if (params.name !== void 0 && params.name.trim().length === 0) {
+      throw new PlolinkError("name cannot be empty", "INVALID_PARAMS");
+    }
+    if (params.code !== void 0 && params.code.trim().length === 0) {
+      throw new PlolinkError("code cannot be empty", "INVALID_PARAMS");
+    }
+    if (params.permissions !== void 0 && !Array.isArray(params.permissions)) {
+      throw new PlolinkError("permissions must be an array", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.put(`/api/v1/teams/${teamId}/roles/${roleId}`, params);
+  }
+  /**
+   * 删除自定义角色
+   * DELETE /api/v1/teams/:teamId/roles/:roleId?force=true
+   */
+  async deleteCustomRole(teamId, roleId, options) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    if (!roleId || roleId.trim().length === 0) {
+      throw new PlolinkError("roleId is required", "INVALID_PARAMS");
+    }
+    const params = options?.force ? { force: "true" } : void 0;
+    return this.client.axiosInstance.delete(`/api/v1/teams/${teamId}/roles/${roleId}`, { params });
+  }
+  /**
+   * 获取角色详情（系统角色或自定义角色）
+   * GET /api/v1/teams/:teamId/roles/:roleId
+   */
+  async getRoleDetail(teamId, roleId) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    if (!roleId || roleId.trim().length === 0) {
+      throw new PlolinkError("roleId is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/teams/${teamId}/roles/${roleId}`);
+  }
+  /**
+   * 获取成员的所有角色（带角色信息与权限）
+   * GET /api/v1/teams/:teamId/members/:memberId/roles
+   */
+  async listMemberRoles(teamId, memberId) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    if (!memberId || memberId.trim().length === 0) {
+      throw new PlolinkError("memberId is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.get(`/api/v1/teams/${teamId}/members/${memberId}/roles`);
+  }
+  /**
+   * 为成员分配角色（系统/自定义）及数据范围
+   * POST /api/v1/teams/:teamId/members/:memberId/roles
+   */
+  async assignMemberRole(teamId, memberId, params) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    if (!memberId || memberId.trim().length === 0) {
+      throw new PlolinkError("memberId is required", "INVALID_PARAMS");
+    }
+    if (params.roleType === "SYSTEM" && (!params.roleCode || params.roleCode.trim().length === 0)) {
+      throw new PlolinkError("roleCode is required when roleType is SYSTEM", "INVALID_PARAMS");
+    }
+    if (params.roleType === "CUSTOM" && (!params.roleId || params.roleId.trim().length === 0)) {
+      throw new PlolinkError("roleId is required when roleType is CUSTOM", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.post(
+      `/api/v1/teams/${teamId}/members/${memberId}/roles`,
+      params
+    );
+  }
+  /**
+   * 更新成员角色的数据范围
+   * PUT /api/v1/teams/:teamId/members/:memberId/roles/:memberRoleId
+   */
+  async updateMemberRoleScope(teamId, memberId, memberRoleId, params) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    if (!memberId || memberId.trim().length === 0) {
+      throw new PlolinkError("memberId is required", "INVALID_PARAMS");
+    }
+    if (!memberRoleId || memberRoleId.trim().length === 0) {
+      throw new PlolinkError("memberRoleId is required", "INVALID_PARAMS");
+    }
+    if (!params.scopeType || params.scopeType.trim().length === 0) {
+      throw new PlolinkError("scopeType is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.put(
+      `/api/v1/teams/${teamId}/members/${memberId}/roles/${memberRoleId}`,
+      params
+    );
+  }
+  /**
+   * 移除成员角色
+   * DELETE /api/v1/teams/:teamId/members/:memberId/roles/:memberRoleId
+   */
+  async removeMemberRole(teamId, memberId, memberRoleId) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    if (!memberId || memberId.trim().length === 0) {
+      throw new PlolinkError("memberId is required", "INVALID_PARAMS");
+    }
+    if (!memberRoleId || memberRoleId.trim().length === 0) {
+      throw new PlolinkError("memberRoleId is required", "INVALID_PARAMS");
+    }
+    return this.client.axiosInstance.delete(
+      `/api/v1/teams/${teamId}/members/${memberId}/roles/${memberRoleId}`
+    );
+  }
+  /**
+   * 快捷授权人才模块（公司访问范围）
+   * POST /api/v1/teams/:teamId/members/:memberId/roles/talent
+   */
+  async quickGrantTalentAccess(teamId, memberId, params) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    if (!memberId || memberId.trim().length === 0) {
+      throw new PlolinkError("memberId is required", "INVALID_PARAMS");
+    }
+    const roleCode = params?.roleCode;
+    if (roleCode && roleCode !== "SUB_UNIT_VIEWER" && roleCode !== "SUB_UNIT_MANAGER") {
+      throw new PlolinkError(
+        "roleCode must be SUB_UNIT_VIEWER or SUB_UNIT_MANAGER",
+        "INVALID_PARAMS"
+      );
+    }
+    return this.client.axiosInstance.post(
+      `/api/v1/teams/${teamId}/members/${memberId}/roles/talent`,
+      params ?? {}
+    );
+  }
+};
+
+export { Rbac };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/modules/rbac/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/rbac/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * RBAC 模块 (Rbac)\n *\n * @description\n * 提供权限点、角色、成员角色分配等能力封装，覆盖后端 `docs/api/rbac.md` 中的核心接口：\n * - 获取权限点定义 + 系统角色定义\n * - 团队角色管理（系统角色列表 + 自定义角色 CRUD）\n * - 成员角色管理（查询/分配/更新数据范围/移除）\n * - 人才模块快捷授权（SUB_UNIT_VIEWER / SUB_UNIT_MANAGER）\n *\n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { Team } from '@plolink/sdk/team';\n * import { Rbac } from '@plolink/sdk/rbac';\n * import { VirtualAccount } from '@plolink/sdk/virtual-account';\n *\n * const client = new PlolinkClient({ token: 'session-or-apikey' });\n * const virtualAccount = new VirtualAccount(client);\n * const team = new Team(client);\n * const rbac = new Rbac(client);\n *\n * const created = await virtualAccount.createVirtualAccount({\n *   mode: 'EXISTING_TEAM',\n *   teamId: 'team-123',\n *   virtualAccountName: 'Bot'\n * });\n *\n * const members = await team.listTeamMembers(created.virtualAccount.virtualAccountTeamId);\n * const memberId = team.getMemberIdByUserId(members, created.virtualAccount.id);\n *\n * await rbac.assignMemberRole(created.virtualAccount.virtualAccountTeamId, memberId, {\n *   roleType: 'SYSTEM',\n *   roleCode: 'SUB_UNIT_VIEWER',\n *   scopeType: 'TEAM'\n * });\n * ```\n *\n * @module rbac\n */\n\nimport { PlolinkClient } from '../../core/client';\nimport { PlolinkError } from '../../core/error';\nimport type {\n  PermissionDefinitionsResponse,\n  TeamRolesResponse,\n  CreateCustomRoleParams,\n  UpdateCustomRoleParams,\n  CustomRoleInfo,\n  DeleteRoleResult,\n  MemberRoleListItem,\n  MemberRoleRecord,\n  UpdateMemberRoleScopeParams,\n  QuickGrantTalentAccessParams,\n  TeamRoleDetail,\n} from '../../types/rbac';\nimport type { AssignRoleParams } from '../../types/shared';\n\nexport type {\n  PermissionDefinitionsResponse,\n  TeamRolesResponse,\n  CreateCustomRoleParams,\n  UpdateCustomRoleParams,\n  CustomRoleInfo,\n  DeleteRoleResult,\n  MemberRoleListItem,\n  MemberRoleRecord,\n  UpdateMemberRoleScopeParams,\n  QuickGrantTalentAccessParams,\n  TeamRoleDetail,\n} from '../../types/rbac';\n\nexport type { AssignRoleParams, RoleType, ScopeType } from '../../types/shared';\n\nexport class Rbac {\n  private client: PlolinkClient;\n\n  constructor(client: PlolinkClient) {\n    this.client = client;\n  }\n\n  /**\n   * 获取所有权限点定义 + 系统角色定义\n   * GET /api/v1/permissions\n   */\n  public async getPermissionDefinitions(): Promise<PermissionDefinitionsResponse> {\n    return this.client.axiosInstance.get('/api/v1/permissions');\n  }\n\n  /**\n   * 列出团队角色（系统角色 + 自定义角色）\n   * GET /api/v1/teams/:teamId/roles\n   */\n  public async listTeamRoles(teamId: string): Promise<TeamRolesResponse> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n    return this.client.axiosInstance.get(`/api/v1/teams/${teamId}/roles`);\n  }\n\n  /**\n   * 创建自定义角色\n   * POST /api/v1/teams/:teamId/roles\n   */\n  public async createCustomRole(teamId: string, params: CreateCustomRoleParams): Promise<CustomRoleInfo> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\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    if (!params.code || params.code.trim().length === 0) {\n      throw new PlolinkError('code is required and cannot be empty', 'INVALID_PARAMS');\n    }\n    if (!Array.isArray(params.permissions)) {\n      throw new PlolinkError('permissions must be an array', 'INVALID_PARAMS');\n    }\n    return this.client.axiosInstance.post(`/api/v1/teams/${teamId}/roles`, params);\n  }\n\n  /**\n   * 更新自定义角色\n   * PUT /api/v1/teams/:teamId/roles/:roleId\n   */\n  public async updateCustomRole(\n    teamId: string,\n    roleId: string,\n    params: UpdateCustomRoleParams\n  ): Promise<CustomRoleInfo> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n    if (!roleId || roleId.trim().length === 0) {\n      throw new PlolinkError('roleId is required', 'INVALID_PARAMS');\n    }\n\n    // 允许部分更新，但如果传了 name 就要校验\n    if (params.name !== undefined && params.name.trim().length === 0) {\n      throw new PlolinkError('name cannot be empty', 'INVALID_PARAMS');\n    }\n    if (params.code !== undefined && params.code.trim().length === 0) {\n      throw new PlolinkError('code cannot be empty', 'INVALID_PARAMS');\n    }\n    if (params.permissions !== undefined && !Array.isArray(params.permissions)) {\n      throw new PlolinkError('permissions must be an array', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.put(`/api/v1/teams/${teamId}/roles/${roleId}`, params);\n  }\n\n  /**\n   * 删除自定义角色\n   * DELETE /api/v1/teams/:teamId/roles/:roleId?force=true\n   */\n  public async deleteCustomRole(\n    teamId: string,\n    roleId: string,\n    options?: { force?: boolean }\n  ): Promise<DeleteRoleResult> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n    if (!roleId || roleId.trim().length === 0) {\n      throw new PlolinkError('roleId is required', 'INVALID_PARAMS');\n    }\n    const params = options?.force ? { force: 'true' } : undefined;\n    return this.client.axiosInstance.delete(`/api/v1/teams/${teamId}/roles/${roleId}`, { params });\n  }\n\n  /**\n   * 获取角色详情（系统角色或自定义角色）\n   * GET /api/v1/teams/:teamId/roles/:roleId\n   */\n  public async getRoleDetail(teamId: string, roleId: string): Promise<TeamRoleDetail> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n    if (!roleId || roleId.trim().length === 0) {\n      throw new PlolinkError('roleId is required', 'INVALID_PARAMS');\n    }\n    return this.client.axiosInstance.get(`/api/v1/teams/${teamId}/roles/${roleId}`);\n  }\n\n  /**\n   * 获取成员的所有角色（带角色信息与权限）\n   * GET /api/v1/teams/:teamId/members/:memberId/roles\n   */\n  public async listMemberRoles(teamId: string, memberId: string): Promise<MemberRoleListItem[]> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n    if (!memberId || memberId.trim().length === 0) {\n      throw new PlolinkError('memberId is required', 'INVALID_PARAMS');\n    }\n    return this.client.axiosInstance.get(`/api/v1/teams/${teamId}/members/${memberId}/roles`);\n  }\n\n  /**\n   * 为成员分配角色（系统/自定义）及数据范围\n   * POST /api/v1/teams/:teamId/members/:memberId/roles\n   */\n  public async assignMemberRole(\n    teamId: string,\n    memberId: string,\n    params: AssignRoleParams\n  ): Promise<MemberRoleRecord> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n    if (!memberId || memberId.trim().length === 0) {\n      throw new PlolinkError('memberId is required', 'INVALID_PARAMS');\n    }\n\n    // 最小校验（服务端也会校验；这里提前快速失败）\n    if (params.roleType === 'SYSTEM' && (!params.roleCode || params.roleCode.trim().length === 0)) {\n      throw new PlolinkError('roleCode is required when roleType is SYSTEM', 'INVALID_PARAMS');\n    }\n    if (params.roleType === 'CUSTOM' && (!params.roleId || params.roleId.trim().length === 0)) {\n      throw new PlolinkError('roleId is required when roleType is CUSTOM', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.post(\n      `/api/v1/teams/${teamId}/members/${memberId}/roles`,\n      params\n    );\n  }\n\n  /**\n   * 更新成员角色的数据范围\n   * PUT /api/v1/teams/:teamId/members/:memberId/roles/:memberRoleId\n   */\n  public async updateMemberRoleScope(\n    teamId: string,\n    memberId: string,\n    memberRoleId: string,\n    params: UpdateMemberRoleScopeParams\n  ): Promise<MemberRoleRecord> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n    if (!memberId || memberId.trim().length === 0) {\n      throw new PlolinkError('memberId is required', 'INVALID_PARAMS');\n    }\n    if (!memberRoleId || memberRoleId.trim().length === 0) {\n      throw new PlolinkError('memberRoleId is required', 'INVALID_PARAMS');\n    }\n    if (!params.scopeType || params.scopeType.trim().length === 0) {\n      throw new PlolinkError('scopeType is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.put(\n      `/api/v1/teams/${teamId}/members/${memberId}/roles/${memberRoleId}`,\n      params\n    );\n  }\n\n  /**\n   * 移除成员角色\n   * DELETE /api/v1/teams/:teamId/members/:memberId/roles/:memberRoleId\n   */\n  public async removeMemberRole(\n    teamId: string,\n    memberId: string,\n    memberRoleId: string\n  ): Promise<DeleteRoleResult> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n    if (!memberId || memberId.trim().length === 0) {\n      throw new PlolinkError('memberId is required', 'INVALID_PARAMS');\n    }\n    if (!memberRoleId || memberRoleId.trim().length === 0) {\n      throw new PlolinkError('memberRoleId is required', 'INVALID_PARAMS');\n    }\n\n    return this.client.axiosInstance.delete(\n      `/api/v1/teams/${teamId}/members/${memberId}/roles/${memberRoleId}`\n    );\n  }\n\n  /**\n   * 快捷授权人才模块（公司访问范围）\n   * POST /api/v1/teams/:teamId/members/:memberId/roles/talent\n   */\n  public async quickGrantTalentAccess(\n    teamId: string,\n    memberId: string,\n    params?: QuickGrantTalentAccessParams\n  ): Promise<MemberRoleRecord> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n    if (!memberId || memberId.trim().length === 0) {\n      throw new PlolinkError('memberId is required', 'INVALID_PARAMS');\n    }\n\n    // 轻量校验 roleCode\n    const roleCode = params?.roleCode;\n    if (roleCode && roleCode !== 'SUB_UNIT_VIEWER' && roleCode !== 'SUB_UNIT_MANAGER') {\n      throw new PlolinkError(\n        'roleCode must be SUB_UNIT_VIEWER or SUB_UNIT_MANAGER',\n        'INVALID_PARAMS'\n      );\n    }\n\n    return this.client.axiosInstance.post(\n      `/api/v1/teams/${teamId}/members/${memberId}/roles/talent`,\n      params ?? {}\n    );\n  }\n}\n\n\n"]}

package/dist/modules/team/index.cjs

@@ -0,0 +1,54 @@
+'use strict';
+
+var chunkY3UJVC2L_cjs = require('../../chunk-Y3UJVC2L.cjs');
+
+// src/modules/team/index.ts
+var Team = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 列出团队成员
+   *
+   * @param teamId - 团队 ID
+   * @returns 团队成员列表
+   */
+  async listTeamMembers(teamId) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    const res = await this.client.axiosInstance.get(
+      `/api/v1/teams/${teamId}/members`
+    );
+    return res.members;
+  }
+  /**
+   * 从团队成员列表中，通过 userId 获取 memberId
+   *
+   * @description
+   * RBAC 的“成员角色”相关 API 使用的是 teamMemberId（memberId），而不是 userId。
+   * 虚拟账号创建 API 返回的是虚拟账号 userId（即 virtualAccount.id），因此需要这一步映射。
+   *
+   * @param members - listTeamMembers 返回的成员列表
+   * @param userId - 用户 ID（虚拟账号也是 userId）
+   * @returns memberId
+   */
+  getMemberIdByUserId(members, userId) {
+    if (!userId || userId.trim().length === 0) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError("userId is required", "INVALID_PARAMS");
+    }
+    const member = members.find((m) => m.userId === userId);
+    if (!member) {
+      throw new chunkY3UJVC2L_cjs.PlolinkError(
+        "Team member not found for the given userId",
+        "NOT_FOUND",
+        { userId }
+      );
+    }
+    return member.id;
+  }
+};
+
+exports.Team = Team;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/modules/team/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/team/index.ts"],"names":["PlolinkError"],"mappings":";;;;;AA8BO,IAAM,OAAN,MAAW;AAAA,EAGhB,YAAY,MAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAa,gBAAgB,MAAA,EAA2C;AACtE,IAAA,IAAI,CAAC,MAAA,IAAU,MAAA,CAAO,IAAA,EAAK,CAAE,WAAW,CAAA,EAAG;AACzC,MAAA,MAAM,IAAIA,8BAAA,CAAa,oBAAA,EAAsB,gBAAgB,CAAA;AAAA,IAC/D;AAEA,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,aAAA,CAAc,GAAA;AAAA,MAC1C,iBAAiB,MAAM,CAAA,QAAA;AAAA,KACzB;AAEA,IAAA,OAAO,GAAA,CAAI,OAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaO,mBAAA,CAAoB,SAA2B,MAAA,EAAwB;AAC5E,IAAA,IAAI,CAAC,MAAA,IAAU,MAAA,CAAO,IAAA,EAAK,CAAE,WAAW,CAAA,EAAG;AACzC,MAAA,MAAM,IAAIA,8BAAA,CAAa,oBAAA,EAAsB,gBAAgB,CAAA;AAAA,IAC/D;AAEA,IAAA,MAAM,SAAS,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,WAAW,MAAM,CAAA;AACtD,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAIA,8BAAA;AAAA,QACR,4CAAA;AAAA,QACA,WAAA;AAAA,QACA,EAAE,MAAA;AAAO,OACX;AAAA,IACF;AAEA,IAAA,OAAO,MAAA,CAAO,EAAA;AAAA,EAChB;AACF","file":"index.cjs","sourcesContent":["/**\n * 团队模块 (Team)\n *\n * @description\n * 团队相关能力封装（目前聚焦“成员查询”，用于配合 RBAC/虚拟账号完成角色管理闭环）：\n * - 列出团队成员\n * - 根据 userId 解析 memberId（虚拟账号/普通用户通用）\n *\n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { Team } from '@plolink/sdk/team';\n *\n * const client = new PlolinkClient({ token: 'sk-xxx' });\n * const team = new Team(client);\n *\n * const members = await team.listTeamMembers('team-123');\n * const memberId = team.getMemberIdByUserId(members, 'user-abc');\n * ```\n *\n * @module team\n */\n\nimport { PlolinkClient } from '../../core/client';\nimport { PlolinkError } from '../../core/error';\nimport type { TeamMemberInfo } from '../../types/team';\n\nexport type { TeamMemberInfo, TeamMemberRoleInfo } from '../../types/team';\nexport type { RoleType, ScopeType } from '../../types/shared';\n\nexport class Team {\n  private client: PlolinkClient;\n\n  constructor(client: PlolinkClient) {\n    this.client = client;\n  }\n\n  /**\n   * 列出团队成员\n   *\n   * @param teamId - 团队 ID\n   * @returns 团队成员列表\n   */\n  public async listTeamMembers(teamId: string): Promise<TeamMemberInfo[]> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n\n    const res = await this.client.axiosInstance.get<{ members: TeamMemberInfo[] }>(\n      `/api/v1/teams/${teamId}/members`\n    );\n\n    return res.members;\n  }\n\n  /**\n   * 从团队成员列表中，通过 userId 获取 memberId\n   *\n   * @description\n   * RBAC 的“成员角色”相关 API 使用的是 teamMemberId（memberId），而不是 userId。\n   * 虚拟账号创建 API 返回的是虚拟账号 userId（即 virtualAccount.id），因此需要这一步映射。\n   *\n   * @param members - listTeamMembers 返回的成员列表\n   * @param userId - 用户 ID（虚拟账号也是 userId）\n   * @returns memberId\n   */\n  public getMemberIdByUserId(members: TeamMemberInfo[], userId: string): string {\n    if (!userId || userId.trim().length === 0) {\n      throw new PlolinkError('userId is required', 'INVALID_PARAMS');\n    }\n\n    const member = members.find((m) => m.userId === userId);\n    if (!member) {\n      throw new PlolinkError(\n        'Team member not found for the given userId',\n        'NOT_FOUND',\n        { userId }\n      );\n    }\n\n    return member.id;\n  }\n}\n\n\n"]}

package/dist/modules/team/index.d.cts

@@ -0,0 +1,91 @@
+import { P as PlolinkClient } from '../../client-CAjIQKPm.cjs';
+import { R as RoleType, S as ScopeType } from '../../shared-6ZepUSPW.cjs';
+import '../../core-77EbLgbp.cjs';
+import 'axios';
+
+/**
+ * Team 模块类型
+ */
+
+/**
+ * 团队成员-角色信息（用于团队成员列表）
+ */
+interface TeamMemberRoleInfo {
+    memberRoleId: string;
+    roleType: RoleType;
+    roleCode?: string | null;
+    roleName?: string | null;
+    scopeType: ScopeType;
+    scopeValue: Record<string, unknown> | null;
+}
+/**
+ * 团队成员信息（GET /api/v1/teams/:teamId/members 的 members 元素）
+ */
+interface TeamMemberInfo {
+    id: string;
+    userId: string;
+    userName: string;
+    userEmail: string;
+    userImage: string;
+    companyName: string;
+    contactName: string;
+    contactPhone: string;
+    parentTeamId: string;
+    isCreator: boolean;
+    isSubAccount: boolean;
+    isTeamAdmin: boolean;
+    status: string;
+    statusLabel: string;
+    invitedAt?: string;
+    joinedAt: string | null;
+    roles: TeamMemberRoleInfo[];
+}
+
+/**
+ * 团队模块 (Team)
+ *
+ * @description
+ * 团队相关能力封装（目前聚焦“成员查询”，用于配合 RBAC/虚拟账号完成角色管理闭环）：
+ * - 列出团队成员
+ * - 根据 userId 解析 memberId（虚拟账号/普通用户通用）
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ * import { Team } from '@plolink/sdk/team';
+ *
+ * const client = new PlolinkClient({ token: 'sk-xxx' });
+ * const team = new Team(client);
+ *
+ * const members = await team.listTeamMembers('team-123');
+ * const memberId = team.getMemberIdByUserId(members, 'user-abc');
+ * ```
+ *
+ * @module team
+ */
+
+declare class Team {
+    private client;
+    constructor(client: PlolinkClient);
+    /**
+     * 列出团队成员
+     *
+     * @param teamId - 团队 ID
+     * @returns 团队成员列表
+     */
+    listTeamMembers(teamId: string): Promise<TeamMemberInfo[]>;
+    /**
+     * 从团队成员列表中，通过 userId 获取 memberId
+     *
+     * @description
+     * RBAC 的“成员角色”相关 API 使用的是 teamMemberId（memberId），而不是 userId。
+     * 虚拟账号创建 API 返回的是虚拟账号 userId（即 virtualAccount.id），因此需要这一步映射。
+     *
+     * @param members - listTeamMembers 返回的成员列表
+     * @param userId - 用户 ID（虚拟账号也是 userId）
+     * @returns memberId
+     */
+    getMemberIdByUserId(members: TeamMemberInfo[], userId: string): string;
+}
+
+export { RoleType, ScopeType, Team, type TeamMemberInfo, type TeamMemberRoleInfo };

package/dist/modules/team/index.d.ts

@@ -0,0 +1,91 @@
+import { P as PlolinkClient } from '../../client-CwNikk7i.js';
+import { R as RoleType, S as ScopeType } from '../../shared-6ZepUSPW.js';
+import '../../core-77EbLgbp.js';
+import 'axios';
+
+/**
+ * Team 模块类型
+ */
+
+/**
+ * 团队成员-角色信息（用于团队成员列表）
+ */
+interface TeamMemberRoleInfo {
+    memberRoleId: string;
+    roleType: RoleType;
+    roleCode?: string | null;
+    roleName?: string | null;
+    scopeType: ScopeType;
+    scopeValue: Record<string, unknown> | null;
+}
+/**
+ * 团队成员信息（GET /api/v1/teams/:teamId/members 的 members 元素）
+ */
+interface TeamMemberInfo {
+    id: string;
+    userId: string;
+    userName: string;
+    userEmail: string;
+    userImage: string;
+    companyName: string;
+    contactName: string;
+    contactPhone: string;
+    parentTeamId: string;
+    isCreator: boolean;
+    isSubAccount: boolean;
+    isTeamAdmin: boolean;
+    status: string;
+    statusLabel: string;
+    invitedAt?: string;
+    joinedAt: string | null;
+    roles: TeamMemberRoleInfo[];
+}
+
+/**
+ * 团队模块 (Team)
+ *
+ * @description
+ * 团队相关能力封装（目前聚焦“成员查询”，用于配合 RBAC/虚拟账号完成角色管理闭环）：
+ * - 列出团队成员
+ * - 根据 userId 解析 memberId（虚拟账号/普通用户通用）
+ *
+ * @example
+ * ```typescript
+ * import { PlolinkClient } from '@plolink/sdk';
+ * import { Team } from '@plolink/sdk/team';
+ *
+ * const client = new PlolinkClient({ token: 'sk-xxx' });
+ * const team = new Team(client);
+ *
+ * const members = await team.listTeamMembers('team-123');
+ * const memberId = team.getMemberIdByUserId(members, 'user-abc');
+ * ```
+ *
+ * @module team
+ */
+
+declare class Team {
+    private client;
+    constructor(client: PlolinkClient);
+    /**
+     * 列出团队成员
+     *
+     * @param teamId - 团队 ID
+     * @returns 团队成员列表
+     */
+    listTeamMembers(teamId: string): Promise<TeamMemberInfo[]>;
+    /**
+     * 从团队成员列表中，通过 userId 获取 memberId
+     *
+     * @description
+     * RBAC 的“成员角色”相关 API 使用的是 teamMemberId（memberId），而不是 userId。
+     * 虚拟账号创建 API 返回的是虚拟账号 userId（即 virtualAccount.id），因此需要这一步映射。
+     *
+     * @param members - listTeamMembers 返回的成员列表
+     * @param userId - 用户 ID（虚拟账号也是 userId）
+     * @returns memberId
+     */
+    getMemberIdByUserId(members: TeamMemberInfo[], userId: string): string;
+}
+
+export { RoleType, ScopeType, Team, type TeamMemberInfo, type TeamMemberRoleInfo };

package/dist/modules/team/index.js

@@ -0,0 +1,52 @@
+import { PlolinkError } from '../../chunk-MD4O7FWT.js';
+
+// src/modules/team/index.ts
+var Team = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * 列出团队成员
+   *
+   * @param teamId - 团队 ID
+   * @returns 团队成员列表
+   */
+  async listTeamMembers(teamId) {
+    if (!teamId || teamId.trim().length === 0) {
+      throw new PlolinkError("teamId is required", "INVALID_PARAMS");
+    }
+    const res = await this.client.axiosInstance.get(
+      `/api/v1/teams/${teamId}/members`
+    );
+    return res.members;
+  }
+  /**
+   * 从团队成员列表中，通过 userId 获取 memberId
+   *
+   * @description
+   * RBAC 的“成员角色”相关 API 使用的是 teamMemberId（memberId），而不是 userId。
+   * 虚拟账号创建 API 返回的是虚拟账号 userId（即 virtualAccount.id），因此需要这一步映射。
+   *
+   * @param members - listTeamMembers 返回的成员列表
+   * @param userId - 用户 ID（虚拟账号也是 userId）
+   * @returns memberId
+   */
+  getMemberIdByUserId(members, userId) {
+    if (!userId || userId.trim().length === 0) {
+      throw new PlolinkError("userId is required", "INVALID_PARAMS");
+    }
+    const member = members.find((m) => m.userId === userId);
+    if (!member) {
+      throw new PlolinkError(
+        "Team member not found for the given userId",
+        "NOT_FOUND",
+        { userId }
+      );
+    }
+    return member.id;
+  }
+};
+
+export { Team };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/modules/team/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/team/index.ts"],"names":[],"mappings":";;;AA8BO,IAAM,OAAN,MAAW;AAAA,EAGhB,YAAY,MAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAa,gBAAgB,MAAA,EAA2C;AACtE,IAAA,IAAI,CAAC,MAAA,IAAU,MAAA,CAAO,IAAA,EAAK,CAAE,WAAW,CAAA,EAAG;AACzC,MAAA,MAAM,IAAI,YAAA,CAAa,oBAAA,EAAsB,gBAAgB,CAAA;AAAA,IAC/D;AAEA,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,aAAA,CAAc,GAAA;AAAA,MAC1C,iBAAiB,MAAM,CAAA,QAAA;AAAA,KACzB;AAEA,IAAA,OAAO,GAAA,CAAI,OAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaO,mBAAA,CAAoB,SAA2B,MAAA,EAAwB;AAC5E,IAAA,IAAI,CAAC,MAAA,IAAU,MAAA,CAAO,IAAA,EAAK,CAAE,WAAW,CAAA,EAAG;AACzC,MAAA,MAAM,IAAI,YAAA,CAAa,oBAAA,EAAsB,gBAAgB,CAAA;AAAA,IAC/D;AAEA,IAAA,MAAM,SAAS,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,WAAW,MAAM,CAAA;AACtD,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,YAAA;AAAA,QACR,4CAAA;AAAA,QACA,WAAA;AAAA,QACA,EAAE,MAAA;AAAO,OACX;AAAA,IACF;AAEA,IAAA,OAAO,MAAA,CAAO,EAAA;AAAA,EAChB;AACF","file":"index.js","sourcesContent":["/**\n * 团队模块 (Team)\n *\n * @description\n * 团队相关能力封装（目前聚焦“成员查询”，用于配合 RBAC/虚拟账号完成角色管理闭环）：\n * - 列出团队成员\n * - 根据 userId 解析 memberId（虚拟账号/普通用户通用）\n *\n * @example\n * ```typescript\n * import { PlolinkClient } from '@plolink/sdk';\n * import { Team } from '@plolink/sdk/team';\n *\n * const client = new PlolinkClient({ token: 'sk-xxx' });\n * const team = new Team(client);\n *\n * const members = await team.listTeamMembers('team-123');\n * const memberId = team.getMemberIdByUserId(members, 'user-abc');\n * ```\n *\n * @module team\n */\n\nimport { PlolinkClient } from '../../core/client';\nimport { PlolinkError } from '../../core/error';\nimport type { TeamMemberInfo } from '../../types/team';\n\nexport type { TeamMemberInfo, TeamMemberRoleInfo } from '../../types/team';\nexport type { RoleType, ScopeType } from '../../types/shared';\n\nexport class Team {\n  private client: PlolinkClient;\n\n  constructor(client: PlolinkClient) {\n    this.client = client;\n  }\n\n  /**\n   * 列出团队成员\n   *\n   * @param teamId - 团队 ID\n   * @returns 团队成员列表\n   */\n  public async listTeamMembers(teamId: string): Promise<TeamMemberInfo[]> {\n    if (!teamId || teamId.trim().length === 0) {\n      throw new PlolinkError('teamId is required', 'INVALID_PARAMS');\n    }\n\n    const res = await this.client.axiosInstance.get<{ members: TeamMemberInfo[] }>(\n      `/api/v1/teams/${teamId}/members`\n    );\n\n    return res.members;\n  }\n\n  /**\n   * 从团队成员列表中，通过 userId 获取 memberId\n   *\n   * @description\n   * RBAC 的“成员角色”相关 API 使用的是 teamMemberId（memberId），而不是 userId。\n   * 虚拟账号创建 API 返回的是虚拟账号 userId（即 virtualAccount.id），因此需要这一步映射。\n   *\n   * @param members - listTeamMembers 返回的成员列表\n   * @param userId - 用户 ID（虚拟账号也是 userId）\n   * @returns memberId\n   */\n  public getMemberIdByUserId(members: TeamMemberInfo[], userId: string): string {\n    if (!userId || userId.trim().length === 0) {\n      throw new PlolinkError('userId is required', 'INVALID_PARAMS');\n    }\n\n    const member = members.find((m) => m.userId === userId);\n    if (!member) {\n      throw new PlolinkError(\n        'Team member not found for the given userId',\n        'NOT_FOUND',\n        { userId }\n      );\n    }\n\n    return member.id;\n  }\n}\n\n\n"]}