@zskj-idaas/sdk 2.3.0 → 2.4.0

package/README.md

@@ -136,9 +136,9 @@ import { EnterpriseProfileError } from '@zskj-idaas/sdk';
 
 try {
   const profile = await client.getEnterpriseProfile();
-  console.log(profile?.employee_number);
-  console.log(profile?.primary_department_path_name);
-  console.log(profile?.primary_department_leaders);
+  // 按需将资料交给页面展示，不写入日志。
+  const leaders = profile?.primary_department_leaders ?? [];
+  const identifiableLeaders = leaders.filter(leader => leader.feishu_union_id && leader.feishu_tenant_key);
 } catch (error) {
   if (error instanceof EnterpriseProfileError && error.retryable) {
     // 提示用户稍后重试，不要把查询失败当成字段为空。
@@ -146,7 +146,11 @@ try {
 }
 ```
 
-`primary_department_path` 按一级部门到叶子部门排序，每项包含 `id` 和 `name`，不包含公司根节点；`primary_department_path_name` 是使用 ` / ` 连接的可展示路径。`primary_department_leaders` 返回主部门的主负责人和副负责人，每项包含 `feishu_open_id`、`name`、`avatar_url` 和 `leader_type`；`leader_type` 取值为 `primary` 或 `deputy`。负责人仍只需 `primary_department` scope，读取本人 `feishu_open_id` 则需 `feishu_identity`。兼容旧服务时，调用方可回退到 `primary_department_name`。
+`primary_department_path` 按一级部门到叶子部门排序，每项包含 `id` 和 `name`，不包含公司根节点；`primary_department_path_name` 是使用 ` / ` 连接的可展示路径。`primary_department_leaders` 返回主部门的主负责人和副负责人，每项包含 `feishu_open_id`、`name`、`avatar_url` 和 `leader_type`，身份数据完整时额外成对返回 `feishu_union_id`、`feishu_tenant_key`；`leader_type` 取值为 `primary` 或 `deputy`。负责人仍只需 `primary_department` scope，读取本人 `feishu_open_id` 则需 `feishu_identity`。兼容旧服务时，调用方可回退到 `primary_department_name`。
+
+### 2.4.0 兼容升级
+
+`EnterpriseDepartmentLeader` 新增可选的 `feishu_union_id`、`feishu_tenant_key`，支持同企业、同应用开发商范围内的跨飞书应用主管匹配；两者必须一起使用。字段仍由 `primary_department` scope 控制；来源缺失或非法时服务端同时省略，旧服务端也可能不返回，调用方应跳过身份匹配。原有 `feishu_open_id` 和 `open_id` 别名保持不变。本人 UserInfo 的同名字段仍需 `feishu_identity`，不会因为有部门资料权限而返回。此次为向后兼容的 minor 版本升级，本地版本更新不代表服务端已部署或 npm 已发布。
 
 ### 2.3.0 兼容升级
 

package/dist/index.d.mts

@@ -49,6 +49,10 @@ interface EnterpriseDepartmentLeader {
     feishu_open_id?: string;
     /** @deprecated Use feishu_open_id. Kept as an equal-valued alias for 2.x compatibility. */
     open_id: string;
+    /** Requires primary_department. Omitted with feishu_tenant_key when identity data is unavailable. */
+    feishu_union_id?: string;
+    /** The leader's Feishu enterprise; returned only together with feishu_union_id. */
+    feishu_tenant_key?: string;
     name: string | null;
     avatar_url: string | null;
     /** primary = 主负责人；deputy = 副负责人。 */

package/dist/index.d.ts

@@ -49,6 +49,10 @@ interface EnterpriseDepartmentLeader {
     feishu_open_id?: string;
     /** @deprecated Use feishu_open_id. Kept as an equal-valued alias for 2.x compatibility. */
     open_id: string;
+    /** Requires primary_department. Omitted with feishu_tenant_key when identity data is unavailable. */
+    feishu_union_id?: string;
+    /** The leader's Feishu enterprise; returned only together with feishu_union_id. */
+    feishu_tenant_key?: string;
     name: string | null;
     avatar_url: string | null;
     /** primary = 主负责人；deputy = 副负责人。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zskj-idaas/sdk",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "IDaaS OIDC Client SDK for browser applications — supports Authorization Code Flow with PKCE, token management, and authenticated fetch.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",