@lark-apaas/client-toolkit 1.2.2 → 1.2.3

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,10 @@
+import type { 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>;
+}

package/lib/integrations/services/DepartmentService.js

@@ -0,0 +1,29 @@
+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();
+    }
+}
+export { DepartmentService };

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

@@ -0,0 +1,14 @@
+import type { AccountType, UserProfileData } from './types';
+/**
+ * 获取 CDN 资源 URL
+ */
+export declare function getAssetsUrl(path: string): string;
+export type UserProfileServiceConfig = {
+    getAppId?: () => string | null | undefined;
+    userProfileUrl?: (appId: string) => string;
+};
+export declare class UserProfileService {
+    private config;
+    constructor(config?: UserProfileServiceConfig);
+    getUserProfile(userId: string, accountType?: AccountType, signal?: AbortSignal): Promise<UserProfileData>;
+}

package/lib/integrations/services/UserProfileService.js

@@ -0,0 +1,36 @@
+import { getAppId } from "../../utils/getAppId.js";
+const CDN_HOST = 'https://lf3-static.bytednsdoc.com';
+function getAssetsUrl(path) {
+    return `${CDN_HOST}${path}`;
+}
+const DEFAULT_CONFIG = {
+    getAppId: ()=>getAppId(window.location.pathname),
+    userProfileUrl: (appId)=>`/af/app/${appId}/runtime/api/v1/account/user_profile`
+};
+class UserProfileService {
+    config;
+    constructor(config = {}){
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config
+        };
+    }
+    async getUserProfile(userId, accountType = 'apaas', signal) {
+        const appId = this.config.getAppId();
+        if (!appId) throw new Error('Failed to get appId');
+        const params = new URLSearchParams();
+        if ('lark' === accountType) params.append('larkUserID', userId);
+        else params.append('userID', userId);
+        const response = await fetch(`${this.config.userProfileUrl(appId)}?${params.toString()}`, {
+            signal,
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            credentials: 'include'
+        });
+        if (!response.ok) throw new Error(`Failed to fetch user profile: ${response.status}`);
+        const data = await response.json();
+        return data.data;
+    }
+}
+export { UserProfileService, getAssetsUrl };

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

@@ -0,0 +1,12 @@
+import type { BatchGetUsersResponse, SearchUsersParams, SearchUsersResponse } from './types';
+export type UserServiceConfig = {
+    getAppId?: () => string | null | undefined;
+    searchUserUrl?: (appId: string) => string;
+    listUsersUrl?: (appId: string) => string;
+};
+export declare class UserService {
+    private config;
+    constructor(config?: UserServiceConfig);
+    searchUsers(params: SearchUsersParams): Promise<SearchUsersResponse>;
+    listUsersByIds(userIds: string[]): Promise<BatchGetUsersResponse>;
+}

package/lib/integrations/services/UserService.js

@@ -0,0 +1,46 @@
+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;
+    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 listUsersByIds(userIds) {
+        const appId = this.config.getAppId();
+        if (!appId) throw new Error('Failed to get appId');
+        const response = await fetch(this.config.listUsersUrl(appId), {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                userIDList: userIds.map((id)=>Number(id))
+            }),
+            credentials: 'include'
+        });
+        if (!response.ok) throw new Error('Failed to fetch users by ids');
+        return response.json();
+    }
+}
+export { UserService };

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

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

package/lib/integrations/services/index.js

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

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

@@ -0,0 +1,91 @@
+export type I18nText = {
+    zh_cn: string;
+    en_us?: string;
+    ja_jp?: 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 UserProfileAccountStatus = 0 | 1 | 2 | 3 | 4;
+export type SimpleUserProfileInfo = {
+    name?: string;
+    avatar?: string;
+    email?: string;
+    userStatus: UserProfileAccountStatus;
+    userType: '_employee' | '_externalUser';
+};
+export type LarkCardParam = {
+    needRedirect?: boolean;
+    redirectURL?: string;
+    larkAppID: string;
+    jsAPITicket: string;
+    larkOpenID: string;
+    targetLarkOpenID: string;
+};
+export type SimpleUserProfileData = {
+    useLarkCard: false;
+    userProfileInfo: SimpleUserProfileInfo;
+};
+export type OfficialUserProfileData = {
+    useLarkCard: true;
+    larkCardParam: LarkCardParam;
+};
+export type UserProfileData = SimpleUserProfileData | OfficialUserProfileData;
+export type UserProfileResponse = {
+    data: UserProfileData;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/client-toolkit",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "types": "./lib/index.d.ts",
   "main": "./lib/index.js",
   "files": [