@lark-apaas/client-toolkit 1.2.0-alpha.9 → 1.2.1-0.alpha.0

package/README.md

@@ -6,3 +6,71 @@
 
 * 导出所有对外暴露的 API 和组件，并通过 npm exports 来控制
 * 其他目录作为 internal 实现，不对外暴露
+
+### auth 目录
+
+* 包含与权限相关的 API 和组件
+
+
+### 开发组件 - 使用 CanRole 组件 (推荐)
+
+```tsx
+import { CanRole } from '@lark-apaas/client-toolkit/auth';
+
+function Home() {
+  return (
+    <div>
+      <CanRole roles={['role_admin']}>
+        <div>管理员按钮</div>
+      </CanRole>
+      <CanRole roles={['role_admin', 'role_editor']}>
+        <div>编辑按钮</div>
+      </CanRole>
+    </div>
+  );
+}
+```
+
+### 开发组件 - 使用 AbilityContext 处理复杂场景
+
+```tsx
+import { useContext } from 'react';
+import { AbilityContext, ROLE_SUBJECT } from '@lark-apaas/client-toolkit/auth';
+
+function Home() {
+  const ability = useContext(AbilityContext);
+  return (
+    <div>
+      {ability.can('role_admin', ROLE_SUBJECT) || ability.can('role_editor', ROLE_SUBJECT) ? (
+        <div>可见的仪表盘</div>
+      ) : null}
+    </div>
+  );
+}
+```
+
+### 开发组件 - 进阶示例
+
+### 菜单按权限过滤
+
+```tsx
+import { useContext } from 'react';
+import { AbilityContext, ROLE_SUBJECT } from '@lark-apaas/client-toolkit/auth';
+
+const menus = [
+  { name: 'Dashboard', path: '/dashboard', p: { action: 'role_admin', subject: ROLE_SUBJECT } },
+  { name: 'Users', path: '/users', p: { action: 'role_editor', subject: ROLE_SUBJECT } },
+  { name: 'Settings', path: '/settings', p: { action: 'role_admin', subject: ROLE_SUBJECT } },
+];
+
+function Nav() {
+  const ability = useContext(AbilityContext);
+  return (
+    <nav>
+      {menus.map(m => ability.can(m.p.action, m.p.subject) && (
+        <a key={m.path} href={m.path}>{m.name}</a>
+      ))}
+    </nav>
+  );
+} 
+```

package/lib/apis/components/ActiveLink.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import { type NavLinkProps } from 'react-router-dom';
+export interface ActiveLinkProps extends Omit<NavLinkProps, 'to'> {
+    to: string;
+}
+/**
+ * ActiveLink 组件
+ *
+ * 替换 react-router-dom 的 NavLink，扩展支持 hash 路由跳转和激活态功能
+ *
+ * @example
+ * // 普通路由跳转
+ * <ActiveLink to="/dashboard">Dashboard</ActiveLink>
+ *
+ * // hash 路由跳转
+ * <ActiveLink to="#section1">Section 1</ActiveLink>
+ *
+ * // 使用函数式 className 显示激活态
+ * <ActiveLink
+ *   to="#features"
+ *   className={({isActive}) => isActive ? 'active' : ''}
+ * >
+ *   Features
+ * </ActiveLink>
+ */
+export declare const ActiveLink: React.ForwardRefExoticComponent<ActiveLinkProps & React.RefAttributes<HTMLAnchorElement>>;

package/lib/apis/components/ActiveLink.js

@@ -0,0 +1,66 @@
+import { jsx } from "react/jsx-runtime";
+import { forwardRef, useEffect, useState } from "react";
+import { NavLink } from "react-router-dom";
+const ActiveLink = /*#__PURE__*/ forwardRef(({ to, onClick, className, style, children, ...rest }, ref)=>{
+    const [currentHash, setCurrentHash] = useState(()=>'undefined' != typeof window ? window.location.hash : '');
+    const isHashRoute = 'string' == typeof to && to.startsWith('#');
+    useEffect(()=>{
+        if (!isHashRoute) return;
+        const handleHashChange = ()=>{
+            setCurrentHash(window.location.hash);
+        };
+        window.addEventListener('hashchange', handleHashChange);
+        return ()=>window.removeEventListener('hashchange', handleHashChange);
+    }, [
+        isHashRoute
+    ]);
+    const isActive = isHashRoute && currentHash === to;
+    if (!isHashRoute) return /*#__PURE__*/ jsx(NavLink, {
+        ref: ref,
+        to: to,
+        onClick: onClick,
+        className: className,
+        style: style,
+        ...rest,
+        children: children
+    });
+    const handleHashClick = (e)=>{
+        onClick?.(e);
+        if (e.defaultPrevented) return;
+        e.preventDefault();
+        const targetId = to.slice(1);
+        const targetElement = document.getElementById(targetId);
+        history.pushState(null, '', to);
+        setCurrentHash(to);
+        window.dispatchEvent(new Event('hashchange'));
+        if (targetElement && 'function' == typeof targetElement.scrollIntoView) targetElement.scrollIntoView({
+            behavior: 'smooth'
+        });
+    };
+    const computedClassName = 'function' == typeof className ? className({
+        isActive,
+        isPending: false,
+        isTransitioning: false
+    }) : className;
+    const computedStyle = 'function' == typeof style ? style({
+        isActive,
+        isPending: false,
+        isTransitioning: false
+    }) : style;
+    const computedChildren = 'function' == typeof children ? children({
+        isActive,
+        isPending: false,
+        isTransitioning: false
+    }) : children;
+    return /*#__PURE__*/ jsx("a", {
+        ref: ref,
+        href: to,
+        onClick: handleHashClick,
+        className: computedClassName,
+        style: computedStyle,
+        ...rest,
+        children: computedChildren
+    });
+});
+ActiveLink.displayName = 'ActiveLink';
+export { ActiveLink };

package/lib/apis/components/UniversalLink.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+export interface UniversalLinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
+    /** 链接目标：内部路由、hash 锚点或外部 URL */
+    to: string;
+}
+/**
+ * 统一的链接组件，用于替换原生 <a> 标签
+ * - 内部路由（/dashboard）→ react-router Link
+ * - Hash 锚点（#section）→ <a>
+ * - 外链（https://...）→ <a target="_blank">
+ */
+export declare const UniversalLink: React.ForwardRefExoticComponent<UniversalLinkProps & React.RefAttributes<HTMLAnchorElement>>;

package/lib/apis/components/UniversalLink.js

@@ -0,0 +1,26 @@
+import { jsx } from "react/jsx-runtime";
+import react from "react";
+import { Link } from "react-router-dom";
+function isInternalRoute(to) {
+    return !to.startsWith('#') && !to.startsWith('http://') && !to.startsWith('https://') && !to.startsWith('//');
+}
+function isExternalLink(to) {
+    return to.startsWith('http://') || to.startsWith('https://') || to.startsWith('//');
+}
+const UniversalLink_UniversalLink = /*#__PURE__*/ react.forwardRef(function({ to, ...props }, ref) {
+    if (isInternalRoute(to)) return /*#__PURE__*/ jsx(Link, {
+        to: to,
+        ref: ref,
+        ...props
+    });
+    return /*#__PURE__*/ jsx("a", {
+        href: to,
+        ref: ref,
+        ...props,
+        ...isExternalLink(to) && {
+            target: props.target ?? '_blank',
+            rel: props.rel ?? 'noopener noreferrer'
+        }
+    });
+});
+export { UniversalLink_UniversalLink as UniversalLink };

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/apis/trace.d.ts

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

package/lib/apis/trace.js

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

package/lib/apis/utils/getEnv.d.ts

@@ -0,0 +1 @@
+export { getEnv } from '../../utils/getParentOrigin';

package/lib/apis/utils/getEnv.js

@@ -0,0 +1,2 @@
+import { getEnv } from "../../utils/getParentOrigin.js";
+export { getEnv };

package/lib/auth.d.ts

@@ -0,0 +1 @@
+export { CanRole, AbilityContext, ROLE_SUBJECT } from '@lark-apaas/auth-sdk';

package/lib/auth.js

@@ -0,0 +1,2 @@
+import { AbilityContext, CanRole, ROLE_SUBJECT } from "@lark-apaas/auth-sdk";
+export { AbilityContext, CanRole, ROLE_SUBJECT };

package/lib/components/AppContainer/IframeBridge.d.ts

@@ -1,3 +1,2 @@
 import React from 'react';
-import './utils/listenHot';
 export default function IframeBridge(): React.JSX.Element;

package/lib/components/AppContainer/IframeBridge.js

@@ -1,12 +1,8 @@
 import { jsx } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef } from "react";
 import { useLocation, useNavigate } from "react-router-dom";
-import { connectToParent } from "penpal";
 import { useUpdatingRef } from "../../hooks/useUpdatingRef.js";
 import { submitPostMessage } from "../../utils/postMessage.js";
-import { getPreviewParentOrigin } from "../../utils/getParentOrigin.js";
-import { childApi } from "./utils/childApi.js";
-import "./utils/listenHot.js";
 var IframeBridge_RouteMessageType = /*#__PURE__*/ function(RouteMessageType) {
     RouteMessageType["RouteChange"] = "RouteChange";
     RouteMessageType["RouteBack"] = "RouteBack";
@@ -16,32 +12,18 @@ var IframeBridge_RouteMessageType = /*#__PURE__*/ function(RouteMessageType) {
 function isRouteMessageType(type) {
     return Object.values(IframeBridge_RouteMessageType).includes(type);
 }
-async function connectParent() {
-    submitPostMessage({
-        type: 'PreviewReady',
-        data: {}
-    });
-    const connection = connectToParent({
-        parentOrigin: getPreviewParentOrigin(),
-        methods: {
-            ...childApi
-        }
-    });
-    await connection.promise;
-}
-'production' !== process.env.NODE_ENV && connectParent();
 function IframeBridge() {
     const location = useLocation();
     const navigate = useNavigate();
     const navigateRef = useUpdatingRef(navigate);
     const isActive = useRef(false);
-    const historyBack = useCallback(()=>{
+    const historyBack = useCallback((_payload)=>{
         navigateRef.current(-1);
         isActive.current = true;
     }, [
         navigateRef
     ]);
-    const historyForward = useCallback(()=>{
+    const historyForward = useCallback((_payload)=>{
         navigateRef.current(1);
         isActive.current = true;
     }, [
@@ -69,8 +51,8 @@ function IframeBridge() {
         location
     ]);
     const handleMessage = useCallback((event)=>{
-        const { data } = event;
-        if (isRouteMessageType(data?.type)) operatorMessage[data?.type](data?.data);
+        const data = event.data ?? {};
+        if ('string' == typeof data.type && isRouteMessageType(data.type)) operatorMessage[data.type](data.data);
     }, [
         operatorMessage
     ]);

package/lib/components/AppContainer/index.d.ts

@@ -1,7 +1,10 @@
 import React from 'react';
 import { IBaseThemeProviderProps } from '../theme';
-import '../../index.css';
+import '../../runtime';
+interface IBaseAuthProviderProps {
+    enableAuth?: boolean;
+}
 declare const AppContainer: React.FC<{
     children: React.ReactNode;
-} & IBaseThemeProviderProps>;
+} & IBaseThemeProviderProps & IBaseAuthProviderProps>;
 export default AppContainer;

package/lib/components/AppContainer/index.js

@@ -1,5 +1,5 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useRef, useState } from "react";
+import { useEffect, useState } from "react";
 import { ConfigProvider } from "antd";
 import { MiaodaInspector } from "@lark-apaas/miaoda-inspector";
 import zh_CN from "antd/locale/zh_CN";
@@ -8,20 +8,14 @@ import { defaultUIConfig } from "../theme/ui-config.js";
 import { Toaster } from "./sonner.js";
 import { PageHoc } from "./PageHoc.js";
 import { findValueByPixel, generateTailwindRadiusToken, themeColorTokenMap, themeMetaOptions } from "../theme/index.js";
-import { registerDayjsPlugins } from "./dayjsPlugins.js";
-import "../../index.css";
-import { initAxiosConfig } from "../../utils/axiosConfig.js";
 import { reportTeaEvent } from "./utils/tea.js";
 import { useAppInfo } from "../../hooks/index.js";
 import { TrackKey } from "../../types/tea.js";
 import safety from "./safety.js";
 import { getAppId } from "../../utils/getAppId.js";
-import { ServerLogSSEClient } from "../../server-log/index.js";
 import QueryProvider from "../QueryProvider/index.js";
-import { initObservable } from "./utils/observable.js";
-registerDayjsPlugins();
-initAxiosConfig();
-initObservable();
+import { AuthProvider } from "@lark-apaas/auth-sdk";
+import "../../runtime/index.js";
 const isMiaodaPreview = window.IS_MIAODA_PREVIEW;
 const readCssVarColor = (varName, fallback)=>{
     try {
@@ -33,9 +27,8 @@ const readCssVarColor = (varName, fallback)=>{
     }
 };
 const App = (props)=>{
-    const { themeMeta = {} } = props;
+    const { themeMeta = {}, enableAuth } = props;
     useAppInfo();
-    const serverLogClientRef = useRef(null);
     const { rem } = findValueByPixel(themeMetaOptions.themeRadius, themeMeta.borderRadius) || {
         rem: '0.625'
     };
@@ -47,40 +40,6 @@ const App = (props)=>{
             borderRadius: radiusToken
         }
     };
-    useEffect(()=>{
-        if ('production' !== process.env.NODE_ENV && window.parent !== window) {
-            try {
-                const backendUrl = window.location.origin;
-                serverLogClientRef.current = new ServerLogSSEClient({
-                    serverUrl: backendUrl,
-                    sseEndpoint: '/dev/logs/server-logs/stream',
-                    debug: true
-                });
-                serverLogClientRef.current.start();
-                console.log('[AppContainer] Server log SSE client started');
-            } catch (error) {
-                console.error('[AppContainer] Failed to start server log SSE client:', error);
-            }
-            const handleVisibilityChange = ()=>{
-                if (!serverLogClientRef.current) return;
-                if (document.hidden) {
-                    serverLogClientRef.current.pause();
-                    console.log('[AppContainer] Tab hidden, SSE paused');
-                } else {
-                    serverLogClientRef.current.resume();
-                    console.log('[AppContainer] Tab visible, SSE resumed');
-                }
-            };
-            document.addEventListener('visibilitychange', handleVisibilityChange);
-            return ()=>{
-                document.removeEventListener('visibilitychange', handleVisibilityChange);
-                if (serverLogClientRef.current) {
-                    serverLogClientRef.current.stop();
-                    console.log('[AppContainer] Server log SSE client stopped');
-                }
-            };
-        }
-    }, []);
     useEffect(()=>{
         if (isMiaodaPreview) fetch(`${location.origin}/ai/api/feida_preview/csrf`).then(()=>{
             setTimeout(()=>{
@@ -99,7 +58,10 @@ const App = (props)=>{
             }
         });
     }, []);
-    return /*#__PURE__*/ jsxs(Fragment, {
+    return /*#__PURE__*/ jsxs(AuthProvider, {
+        config: {
+            enable: enableAuth
+        },
         children: [
             /*#__PURE__*/ jsx(Toaster, {}),
             'production' !== process.env.NODE_ENV && /*#__PURE__*/ jsx(MiaodaInspector, {
@@ -247,6 +209,7 @@ const AppContainer_AppContainer = (props)=>{
                     },
                     children: /*#__PURE__*/ jsx(App, {
                         themeMeta: props.themeMeta,
+                        enableAuth: props.enableAuth,
                         children: children
                     })
                 })

package/lib/components/AppContainer/utils/childApi.js

@@ -16,6 +16,7 @@ async function getRoutes() {
     return routes;
 }
 async function getSourceMap() {
+    if ('vite' === process.env.BUILD_TOOL) return '';
     let sourceMapContent = '';
     try {
         const basePath = normalizeBasePath(process.env.CLIENT_BASE_PATH);

package/lib/components/AppContainer/utils/observable.js

@@ -1,12 +1,15 @@
 import { AppEnv, observable } from "@lark-apaas/observable-web";
 const initObservable = ()=>{
     try {
+        const appId = window.appId;
         observable.start({
             serviceName: "app",
             env: 'development' === process.env.NODE_ENV ? AppEnv.Dev : AppEnv.Prod,
             collectorUrl: {
-                log: `/spark/app/${window.appId}/runtime/api/v1/observability/logs/collect`,
-                metric: `/spark/app/${window.appId}/runtime/api/v1/observability/metrics/collect`
+                log: `/spark/app/${appId}/runtime/api/v1/observability/logs/collect`,
+                trace: `/spark/app/${appId}/runtime/api/v1/observability/traces/collect`,
+                metric: `/spark/app/${appId}/runtime/api/v1/observability/metrics/collect`,
+                time: `/spark/api/v1/observability/app/${appId}/current_server_timestamp`
             }
         });
     } catch (error) {

package/lib/components/ErrorRender/index.js

@@ -1,7 +1,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect } from "react";
 import { logger } from "../../logger/index.js";
-import { createApplyHandle, getModuleHot } from "../../utils/module-hot.js";
+import { getHmrApi } from "../../utils/hmr-api.js";
 import { submitPostMessage } from "../../utils/postMessage.js";
 const RenderError = (props)=>{
     const { error, resetErrorBoundary } = props;
@@ -27,16 +27,10 @@ const RenderError = (props)=>{
     ]);
     useEffect(()=>{
         if (!resetErrorBoundary) return;
-        const hot = getModuleHot();
-        if (hot) {
-            const handler = createApplyHandle((success)=>{
-                if (success) resetErrorBoundary();
-            });
-            hot.addStatusHandler(handler);
-            return ()=>{
-                hot.removeStatusHandler(handler);
-            };
-        }
+        const hmr = getHmrApi();
+        if (hmr) return hmr.onSuccess(()=>{
+            resetErrorBoundary();
+        });
     }, [
         resetErrorBoundary
     ]);

package/lib/components/PagePlaceholder/index.js

@@ -15,7 +15,7 @@ const PagePlaceholder = ({ title = '页面待开发', description = '页面暂
                 children: title
             }),
             /*#__PURE__*/ jsx("div", {
-                className: "text-center text-muted-foreground text-base leading-6",
+                className: "text-center text-muted-foreground text-base leading-6 line-clamp-2 sm:max-w-[480px]",
                 children: description
             })
         ]

package/lib/components/User/UserSelect.js

@@ -67,20 +67,8 @@ const UserSelect = ({ mode = 'single', defaultValue, value, onChange, placeholde
         if (!normalizedIds.length) return void setUiValue(void 0);
         const fetchProfiles = async ()=>{
             try {
-                const ids = normalizedIds.map((id)=>Number(id)).filter((id)=>Number.isFinite(id));
-                if (!ids.length) {
-                    const profiles = normalizedIds.map((id)=>inputProfilesMap.get(id) ?? {
-                            user_id: id,
-                            name: '',
-                            avatar: '',
-                            email: '',
-                            status: 1
-                        });
-                    setUiValue('single' === mode ? profiles[0] : profiles);
-                    return;
-                }
                 const dataloom = await getDataloom();
-                const response = await dataloom.service.user.getByIds(ids);
+                const response = await dataloom.service.user.getByIds(normalizedIds);
                 const fetchedList = Array.isArray(response?.data) ? response?.data : Array.isArray(response?.data?.user_list) ? response?.data?.user_list : [];
                 const fetchedMap = new Map();
                 fetchedList.forEach((profile)=>{

package/lib/index.js

@@ -1,5 +1,6 @@
 import { createClient } from "@lark-apaas/client-capability";
 import { normalizeBasePath } from "./utils/utils.js";
+import { logger } from "./logger/index.js";
 import { version } from "../package.json";
 const capabilityClient = createClient({
     baseURL: normalizeBasePath(process.env.CLIENT_BASE_PATH),
@@ -7,7 +8,8 @@ const capabilityClient = createClient({
         headers: {
             'X-Suda-Csrf-Token': window.csrfToken ?? ''
         }
-    }
+    },
+    logger: logger
 });
 const src = {
     version: version

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>;
+}