@lark-apaas/client-toolkit 1.2.2-alpha.0 → 1.2.2-test.0

package/lib/apis/tools/services.d.ts

@@ -0,0 +1 @@
+export * from '../../integrations/services';

package/lib/apis/tools/services.js

@@ -0,0 +1 @@
+export * from "../../integrations/services/index.js";

package/lib/integrations/services/DepartmentService.d.ts

@@ -0,0 +1,14 @@
+import type { Department, SearchDepartmentsParams, SearchDepartmentsResponse } from './types';
+export type DepartmentServiceConfig = {
+    getAppId?: () => string | null | undefined;
+    searchDepartmentUrl?: (appId: string) => string;
+};
+export declare class DepartmentService {
+    private config;
+    constructor(config?: DepartmentServiceConfig);
+    searchDepartments(params: SearchDepartmentsParams): Promise<SearchDepartmentsResponse>;
+    createFetcher(): (search: string) => Promise<{
+        items: Department[];
+    }>;
+    private getDepartmentDisplayName;
+}

package/lib/integrations/services/DepartmentService.js

@@ -0,0 +1,48 @@
+import { getAppId } from "../../utils/getAppId.js";
+const DEFAULT_CONFIG = {
+    getAppId: ()=>getAppId(window.location.pathname),
+    searchDepartmentUrl: (appId)=>`/af/app/${appId}/runtime/api/v1/account/search_department`
+};
+class DepartmentService {
+    config;
+    constructor(config = {}){
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config
+        };
+    }
+    async searchDepartments(params) {
+        const appId = this.config.getAppId();
+        if (!appId) throw new Error('Failed to get appId');
+        const response = await fetch(this.config.searchDepartmentUrl(appId), {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(params),
+            credentials: 'include'
+        });
+        if (!response.ok) throw new Error('Failed to search departments');
+        return response.json();
+    }
+    createFetcher() {
+        return async (search)=>{
+            const response = await this.searchDepartments({
+                query: search,
+                pageSize: 100
+            });
+            const departmentList = response?.data?.departmentList || [];
+            return {
+                items: departmentList.map((department)=>({
+                        id: department.departmentID,
+                        name: this.getDepartmentDisplayName(department.name),
+                        raw: department
+                    }))
+            };
+        };
+    }
+    getDepartmentDisplayName(name) {
+        return name?.zh_cn || name?.en_us || '';
+    }
+}
+export { DepartmentService };

package/lib/integrations/services/UserService.d.ts

@@ -0,0 +1,22 @@
+import type { AccountType, SearchUsersParams, SearchUsersResponse, User } from './types';
+export type UserServiceConfig = {
+    getAppId?: () => string | null | undefined;
+    searchUserUrl?: (appId: string) => string;
+    listUsersUrl?: (appId: string) => string;
+};
+export declare class UserService {
+    private config;
+    private cache;
+    constructor(config?: UserServiceConfig);
+    searchUsers(params: SearchUsersParams): Promise<SearchUsersResponse>;
+    fetchUsersByIds(userIds: string[], accountType?: AccountType): Promise<User[]>;
+    createFetcher(accountType?: AccountType): (search: string) => Promise<{
+        items: User[];
+    }>;
+    clearCache(): void;
+    private getCachedUsers;
+    private createUnknownUser;
+    private userInfoToUser;
+    private getUserDisplayName;
+    private getUserId;
+}

package/lib/integrations/services/UserService.js

@@ -0,0 +1,122 @@
+import { getAppId } from "../../utils/getAppId.js";
+const DEFAULT_CONFIG = {
+    getAppId: ()=>getAppId(window.location.pathname),
+    searchUserUrl: (appId)=>`/af/app/${appId}/runtime/api/v1/account/search_user`,
+    listUsersUrl: (appId)=>`/af/app/${appId}/runtime/api/v1/account/list_users`
+};
+class UserService {
+    config;
+    cache = new Map();
+    constructor(config = {}){
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config
+        };
+    }
+    async searchUsers(params) {
+        const appId = this.config.getAppId();
+        if (!appId) throw new Error('Failed to get appId');
+        const response = await fetch(this.config.searchUserUrl(appId), {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(params),
+            credentials: 'include'
+        });
+        if (!response.ok) throw new Error('Failed to search users');
+        return response.json();
+    }
+    async fetchUsersByIds(userIds, accountType = 'apaas') {
+        if (0 === userIds.length) return [];
+        const uniqueIds = [
+            ...new Set(userIds)
+        ];
+        const { cachedUsers, missingIds } = this.getCachedUsers(uniqueIds);
+        if (0 === missingIds.length) return uniqueIds.map((id)=>cachedUsers.get(id) || this.createUnknownUser(id));
+        const appId = this.config.getAppId();
+        if (!appId) throw new Error('Failed to get appId');
+        try {
+            const response = await fetch(this.config.listUsersUrl(appId), {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    userIDList: missingIds.map((id)=>Number(id))
+                }),
+                credentials: 'include'
+            });
+            if (!response.ok) throw new Error('Failed to fetch users by ids');
+            const data = await response.json();
+            const userInfoMap = data?.data?.userInfoMap || {};
+            for (const id of missingIds){
+                const userInfo = userInfoMap[id];
+                if (userInfo) {
+                    const user = this.userInfoToUser(userInfo, accountType);
+                    this.cache.set(user.id, user);
+                }
+            }
+            return uniqueIds.map((id)=>this.cache.get(id) || this.createUnknownUser(id));
+        } catch (error) {
+            console.error('Failed to fetch users by ids:', error);
+            return uniqueIds.map((id)=>this.cache.get(id) || this.createUnknownUser(id));
+        }
+    }
+    createFetcher(accountType = 'apaas') {
+        return async (search)=>{
+            const response = await this.searchUsers({
+                query: search,
+                pageSize: 100
+            });
+            const userList = response?.data?.userList || [];
+            return {
+                items: userList.map((user)=>({
+                        id: this.getUserId(user, accountType),
+                        name: this.getUserDisplayName(user.name),
+                        avatar: user.avatar,
+                        raw: user
+                    }))
+            };
+        };
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    getCachedUsers(ids) {
+        const cachedUsers = new Map();
+        const missingIds = [];
+        for (const id of ids){
+            const cached = this.cache.get(id);
+            if (cached) cachedUsers.set(id, cached);
+            else missingIds.push(id);
+        }
+        return {
+            cachedUsers,
+            missingIds
+        };
+    }
+    createUnknownUser(id) {
+        return {
+            id,
+            name: '未知用户',
+            avatar: void 0,
+            raw: void 0
+        };
+    }
+    userInfoToUser(userInfo, accountType) {
+        return {
+            id: this.getUserId(userInfo, accountType),
+            name: this.getUserDisplayName(userInfo.name),
+            avatar: userInfo.avatar?.image?.large,
+            raw: userInfo
+        };
+    }
+    getUserDisplayName(name) {
+        return name.zh_cn || name.en_us || '';
+    }
+    getUserId(user, accountType) {
+        return 'lark' === accountType ? user.larkUserID : user.userID;
+    }
+}
+export { UserService };

package/lib/integrations/services/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './UserService';
+export * from './DepartmentService';

package/lib/integrations/services/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./UserService.js";
+export * from "./DepartmentService.js";

package/lib/integrations/services/types.d.ts

@@ -0,0 +1,73 @@
+export type I18nText = {
+    zh_cn?: string;
+    en_us?: string;
+};
+export type DepartmentBasic = {
+    departmentID: string;
+    name: I18nText;
+};
+export type UserInfo = {
+    userID: string;
+    larkUserID: string;
+    name: I18nText;
+    avatar: string;
+    userType: '_employee' | '_externalUser' | '_anonymousUser';
+    department: DepartmentBasic;
+};
+export type DepartmentInfo = {
+    departmentID: string;
+    larkDepartmentID: string;
+    name: I18nText;
+};
+export type AccountType = 'apaas' | 'lark';
+export type SearchAvatar = {
+    avatar: {
+        image: {
+            large: string;
+        };
+    };
+};
+export type SearchUsersParams = {
+    query?: string;
+    offset?: number;
+    pageSize?: number;
+};
+export type SearchUsersResponse = {
+    data: {
+        userList: UserInfo[];
+        total: number;
+    };
+    status_code: string;
+};
+export type BatchGetUsersResponse = {
+    data: {
+        userInfoMap: Record<string, UserInfo & SearchAvatar>;
+        baseResp?: {
+            statusCode?: number;
+            statusMessage?: string;
+        };
+    };
+};
+export type SearchDepartmentsParams = {
+    query?: string;
+    offset?: number;
+    pageSize?: number;
+};
+export type SearchDepartmentsResponse = {
+    data: {
+        departmentList: DepartmentInfo[];
+        total: number;
+    };
+    status_code: string;
+};
+export type User = {
+    id: string;
+    name: string;
+    avatar?: string;
+    raw?: UserInfo;
+};
+export type Department = {
+    id: string;
+    name: string;
+    raw?: DepartmentInfo;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/client-toolkit",
-  "version": "1.2.2-alpha.0",
+  "version": "1.2.2-test.0",
   "types": "./lib/index.d.ts",
   "main": "./lib/index.js",
   "files": [
@@ -81,7 +81,7 @@
     "@ant-design/colors": "^7.2.1",
     "@ant-design/cssinjs": "^1.24.0",
     "@data-loom/js": "^0.4.3",
-    "@lark-apaas/client-capability": "0.1.2-alpha.0",
+    "@lark-apaas/client-capability": "^0.1.2",
     "@lark-apaas/miaoda-inspector": "^1.0.8",
     "@lark-apaas/observable-web": "^1.0.0",
     "@radix-ui/react-avatar": "^1.1.10",