@lark-apaas/client-toolkit 1.2.9 → 1.2.34

package/lib/components/ui/confirm.js

@@ -0,0 +1,83 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import "react";
+import { createRoot } from "react-dom/client";
+import { Content, Description, Overlay, Portal, Root, Title } from "@radix-ui/react-dialog";
+import { Button } from "./button.js";
+import { clsxWithTw } from "../../utils/utils.js";
+function showConfirm(options) {
+    const opts = 'string' == typeof options ? {
+        message: options
+    } : options;
+    const { title = '提示', message, confirmText = '确认', cancelText = '取消', variant = 'default' } = opts;
+    return new Promise((resolve)=>{
+        const container = document.createElement('div');
+        document.body.appendChild(container);
+        const root = createRoot(container);
+        function cleanup() {
+            root.unmount();
+            container.remove();
+        }
+        function handleConfirm() {
+            cleanup();
+            resolve(true);
+        }
+        function handleCancel() {
+            cleanup();
+            resolve(false);
+        }
+        root.render(/*#__PURE__*/ jsx(ConfirmDialog, {
+            title: title,
+            message: message,
+            confirmText: confirmText,
+            cancelText: cancelText,
+            variant: variant,
+            onConfirm: handleConfirm,
+            onCancel: handleCancel
+        }));
+    });
+}
+function ConfirmDialog({ title, message, confirmText, cancelText, variant, onConfirm, onCancel }) {
+    return /*#__PURE__*/ jsx(Root, {
+        defaultOpen: true,
+        onOpenChange: (open)=>{
+            if (!open) onCancel();
+        },
+        children: /*#__PURE__*/ jsxs(Portal, {
+            children: [
+                /*#__PURE__*/ jsx(Overlay, {
+                    className: clsxWithTw('fixed inset-0 z-[99999] bg-black/40', 'data-[state=open]:animate-in data-[state=open]:fade-in-0', 'data-[state=closed]:animate-out data-[state=closed]:fade-out-0')
+                }),
+                /*#__PURE__*/ jsxs(Content, {
+                    className: clsxWithTw('fixed left-1/2 top-1/2 z-[99999] -translate-x-1/2 -translate-y-1/2', 'w-[90vw] max-w-[400px] rounded-lg', 'bg-[var(--popover,var(--color-neutral-00,#fff))] text-[var(--popover-foreground,var(--color-neutral-950,#1f2329))]', 'border border-[var(--border,var(--color-neutral-300,#dee0e3))]', 'shadow-lg p-6', 'data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95', 'data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95'),
+                    children: [
+                        /*#__PURE__*/ jsx(Title, {
+                            className: clsxWithTw('text-base font-medium leading-6', 'text-[var(--foreground,var(--color-neutral-950,#1f2329))]'),
+                            children: title
+                        }),
+                        /*#__PURE__*/ jsx(Description, {
+                            className: clsxWithTw('mt-2 text-sm leading-5', 'text-[var(--muted-foreground,var(--color-neutral-700,#646a73))]'),
+                            children: message
+                        }),
+                        /*#__PURE__*/ jsxs("div", {
+                            className: clsxWithTw('mt-6 flex justify-end gap-2'),
+                            children: [
+                                /*#__PURE__*/ jsx(Button, {
+                                    variant: "outline",
+                                    className: "!bg-transparent !text-inherit",
+                                    onClick: onCancel,
+                                    children: cancelText
+                                }),
+                                /*#__PURE__*/ jsx(Button, {
+                                    variant: variant,
+                                    onClick: onConfirm,
+                                    children: confirmText
+                                })
+                            ]
+                        })
+                    ]
+                })
+            ]
+        })
+    });
+}
+export { showConfirm };

package/lib/components/ui/toast.d.ts

@@ -0,0 +1,2 @@
+/** 显示 toast 提示（兼容 PC/移动端） */
+export declare function showToast(message: string, duration?: number): Promise<void>;

package/lib/components/ui/toast.js

@@ -0,0 +1,53 @@
+function showToast(message, duration = 3000) {
+    return new Promise((resolve)=>{
+        const toast = document.createElement('div');
+        const iconSvg = `<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path fill-rule="evenodd" clip-rule="evenodd" d="M8 1.333a6.667 6.667 0 1 1 0 13.334A6.667 6.667 0 0 1 8 1.333ZM8 10a.667.667 0 1 0 0 1.333A.667.667 0 0 0 8 10Zm0-5.333a.667.667 0 0 0-.667.666v3.334a.667.667 0 0 0 1.334 0V5.333A.667.667 0 0 0 8 4.667Z" fill="#ff811a"/>
+    </svg>`;
+        const iconWrapper = document.createElement('span');
+        iconWrapper.innerHTML = iconSvg;
+        Object.assign(iconWrapper.style, {
+            display: 'flex',
+            alignItems: 'center',
+            marginRight: '8px',
+            flexShrink: '0'
+        });
+        const textWrapper = document.createElement('span');
+        textWrapper.textContent = message;
+        toast.appendChild(iconWrapper);
+        toast.appendChild(textWrapper);
+        Object.assign(toast.style, {
+            position: 'fixed',
+            top: '32px',
+            left: '50%',
+            transform: 'translate(-50%, -50%)',
+            display: 'flex',
+            alignItems: 'center',
+            padding: '12px 16px',
+            backgroundColor: '#fff',
+            color: '#1f2329',
+            border: '1px solid #dee0e3',
+            borderRadius: '6px',
+            fontSize: '14px',
+            lineHeight: '1.5',
+            zIndex: '99999',
+            maxWidth: '80vw',
+            wordBreak: 'break-word',
+            boxShadow: '0 4px 8px rgba(0, 0, 0, 0.03), 0 3px 6px rgba(0, 0, 0, 0.05), 0 6px 18px rgba(0, 0, 0, 0.03)',
+            opacity: '0',
+            transition: 'opacity 0.3s ease'
+        });
+        document.body.appendChild(toast);
+        requestAnimationFrame(()=>{
+            toast.style.opacity = '1';
+        });
+        setTimeout(()=>{
+            toast.style.opacity = '0';
+            setTimeout(()=>{
+                document.body.removeChild(toast);
+                resolve();
+            }, 300);
+        }, duration);
+    });
+}
+export { showToast };

package/lib/hooks/index.d.ts

@@ -2,3 +2,4 @@ export * from './useAppInfo';
 export * from './useCurrentUserProfile';
 export * from './useIsMobile';
 export * from './useLogout';
+export * from './useScrollReveal';

package/lib/hooks/index.js

@@ -2,3 +2,4 @@ export * from "./useAppInfo.js";
 export * from "./useCurrentUserProfile.js";
 export * from "./useIsMobile.js";
 export * from "./useLogout.js";
+export * from "./useScrollReveal.js";

package/lib/hooks/useCurrentUserProfile.d.ts

@@ -1,5 +1,11 @@
 import { IUserProfile } from '../apis/udt-types';
-export interface ICompatibilityUserProfile extends IUserProfile {
+/**
+ * useCurrentUserProfile 的返回类型。
+ * 初始状态为空对象 `{}`（所有字段均为 undefined），异步获取用户信息后字段才会被填充。
+ * 使用时必须通过可选链或空值合并进行安全访问，如 `userInfo?.user_id`。
+ * 判断是否已加载完成应使用 `if (!userInfo?.user_id)` 而非 `if (!userInfo)`（因为空对象是 truthy）。
+ */
+export type ICompatibilityUserProfile = Partial<IUserProfile & {
     /**
      * @deprecated please use `name`
      */
@@ -8,5 +14,14 @@ export interface ICompatibilityUserProfile extends IUserProfile {
      * @deprecated please use `avatar`
      */
     userAvatar: string;
-}
-export declare const useCurrentUserProfile: () => ICompatibilityUserProfile;
+}>;
+export declare const useCurrentUserProfile: () => Partial<IUserProfile & {
+    /**
+     * @deprecated please use `name`
+     */
+    userName: string;
+    /**
+     * @deprecated please use `avatar`
+     */
+    userAvatar: string;
+}>;

package/lib/hooks/useCurrentUserProfile.js

@@ -3,11 +3,25 @@ import { logger } from "../logger/index.js";
 import { getCurrentUserProfile } from "../integrations/getCurrentUserProfile.js";
 import { getDataloom } from "../integrations/dataloom.js";
 import { isSparkRuntime } from "../utils/utils.js";
+import { getAxiosForBackend } from "../utils/getAxiosForBackend.js";
 function getNameFromArray(nameArray) {
     if (!nameArray || 0 === nameArray.length) return;
     const chineseName = nameArray.find((item)=>2052 === item.language_code);
     return chineseName?.text ?? nameArray[0]?.text;
 }
+let _larkUserIdCache = null;
+let _larkUserIdPromise = null;
+function fetchLarkUserId() {
+    if (null !== _larkUserIdCache) return Promise.resolve(_larkUserIdCache);
+    if (_larkUserIdPromise) return _larkUserIdPromise;
+    _larkUserIdPromise = getAxiosForBackend().get('/api/authnpaas/lark-user-id').then(({ data })=>{
+        _larkUserIdCache = data?.lark_user_id || null;
+        return _larkUserIdCache;
+    }).catch(()=>null).finally(()=>{
+        _larkUserIdPromise = null;
+    });
+    return _larkUserIdPromise;
+}
 function getCompatibilityUserProfile() {
     const userInfo = getCurrentUserProfile();
     return {
@@ -19,37 +33,31 @@ function getCompatibilityUserProfile() {
 const useCurrentUserProfile = ()=>{
     const [userInfo, setUserInfo] = useState(()=>getCompatibilityUserProfile());
     useEffect(()=>{
+        let cancelled = false;
+        const fetchAndSetUserInfo = async ()=>{
+            const dataloom = await getDataloom();
+            const result = await dataloom?.service?.session?.getUserInfo();
+            if (cancelled) return;
+            const info = result?.data?.user_info;
+            const userName = getNameFromArray(info?.name);
+            const newUserInfo = {
+                user_id: info?.user_id?.toString(),
+                email: info?.email,
+                name: userName,
+                avatar: info?.avatar?.image?.large,
+                userName: userName,
+                userAvatar: info?.avatar?.image?.large
+            };
+            const larkUserId = await fetchLarkUserId();
+            if (larkUserId) newUserInfo.lark_user_id = larkUserId;
+            if ('development' === process.env.NODE_ENV) logger.info('MiaoDaMetaInfoChanged', newUserInfo);
+            setUserInfo(newUserInfo);
+        };
         let handleMetaInfoChanged;
         if (isSparkRuntime()) {
-            (async ()=>{
-                const dataloom = await getDataloom();
-                const result = await dataloom?.service?.session?.getUserInfo();
-                const userInfo = result?.data?.user_info;
-                const userName = getNameFromArray(userInfo?.name);
-                setUserInfo({
-                    user_id: userInfo?.user_id?.toString(),
-                    email: userInfo?.email,
-                    name: userName,
-                    avatar: userInfo?.avatar?.image?.large,
-                    userName: userName,
-                    userAvatar: userInfo?.avatar?.image?.large
-                });
-            })();
-            handleMetaInfoChanged = async ()=>{
-                const dataloom = await getDataloom();
-                const result = await dataloom?.service?.session?.getUserInfo();
-                const userInfo = result?.data?.user_info;
-                const userName = getNameFromArray(userInfo?.name);
-                const newUserInfo = {
-                    user_id: userInfo?.user_id?.toString(),
-                    email: userInfo?.email,
-                    name: userName,
-                    avatar: userInfo?.avatar?.image?.large,
-                    userName: userName,
-                    userAvatar: userInfo?.avatar?.image?.large
-                };
-                if ('development' === process.env.NODE_ENV) logger.info('MiaoDaMetaInfoChanged', newUserInfo);
-                setUserInfo(newUserInfo);
+            fetchAndSetUserInfo();
+            handleMetaInfoChanged = ()=>{
+                fetchAndSetUserInfo();
             };
         } else handleMetaInfoChanged = ()=>{
             if ('development' === process.env.NODE_ENV) logger.info('MiaoDaMetaInfoChanged', getCompatibilityUserProfile());
@@ -57,6 +65,7 @@ const useCurrentUserProfile = ()=>{
         };
         window.addEventListener('MiaoDaMetaInfoChanged', handleMetaInfoChanged);
         return ()=>{
+            cancelled = true;
             window.removeEventListener('MiaoDaMetaInfoChanged', handleMetaInfoChanged);
         };
     }, []);

package/lib/hooks/useLogout.js

@@ -1,28 +1,13 @@
 import { useState } from "react";
 import { getDataloom } from "../integrations/dataloom.js";
-import { isSparkRuntime } from "../utils/utils.js";
 function useLogout() {
     const [isLoading, setIsLoading] = useState(false);
     async function handlerLogout() {
         if ('production' !== process.env.NODE_ENV) return void console.log('只有生产环境才执行登出');
-        if (isSparkRuntime()) {
-            setIsLoading(true);
-            try {
-                const dataloom = await getDataloom();
-                await dataloom.service.session.signOut();
-            } catch (error) {
-                console.error('登出失败', error);
-            } finally{
-                setIsLoading(false);
-            }
-            return;
-        }
         setIsLoading(true);
         try {
-            await fetch('/ai/api/ui/page/logout', {
-                method: 'GET'
-            });
-            window.location.reload();
+            const dataloom = await getDataloom();
+            await dataloom.service.session.signOut();
         } catch (error) {
             console.error('登出失败', error);
         } finally{

package/lib/hooks/useScrollReveal.d.ts

@@ -0,0 +1,61 @@
+import { RefObject } from 'react';
+/**
+ * Options for useScrollReveal hook
+ */
+export interface UseScrollRevealOptions<T extends HTMLElement = HTMLElement> {
+    /** Ref to the container element to scope the query (default: document.body) */
+    containerRef?: RefObject<T | null>;
+    /** IntersectionObserver threshold - element visibility percentage to trigger (default: 0.1) */
+    threshold?: number;
+    /** IntersectionObserver rootMargin - margin around root (default: '0px 0px -50px 0px') */
+    rootMargin?: string;
+    /** CSS class to add when element becomes visible (default: 'visible') */
+    visibleClass?: string;
+    /** CSS selector for elements to observe (default: '.scroll-reveal') */
+    selector?: string;
+}
+/**
+ * Hook to enable scroll reveal animations using IntersectionObserver.
+ *
+ * Observes elements with the specified selector and adds a visibility class
+ * when they enter the viewport.
+ *
+ * @param options - Configuration options
+ *
+ * @example
+ * ```tsx
+ * // Usage without parameters (queries entire document.body)
+ * import { useScrollReveal } from '@lark-apaas/client-toolkit/hooks/useScrollReveal';
+ *
+ * function MyComponent() {
+ *   useScrollReveal();
+ *
+ *   return <div className="scroll-reveal">I will fade in on scroll!</div>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Usage with container ref
+ * import { useRef } from 'react';
+ * import { useScrollReveal } from '@lark-apaas/client-toolkit/hooks/useScrollReveal';
+ *
+ * function MyComponent() {
+ *   const containerRef = useRef<HTMLDivElement>(null);
+ *   useScrollReveal({ containerRef });
+ *
+ *   return (
+ *     <div ref={containerRef}>
+ *       <div className="scroll-reveal">I will fade in on scroll!</div>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Usage with custom options
+ * useScrollReveal({ threshold: 0.2, visibleClass: 'animate-in' });
+ * ```
+ */
+export declare function useScrollReveal<T extends HTMLElement = HTMLElement>(options?: UseScrollRevealOptions<T>): void;

package/lib/hooks/useScrollReveal.js

@@ -0,0 +1,37 @@
+import { useEffect } from "react";
+const DEFAULT_OPTIONS = {
+    threshold: 0.1,
+    rootMargin: '0px 0px -50px 0px',
+    visibleClass: 'visible',
+    selector: '.scroll-reveal'
+};
+function useScrollReveal(options) {
+    const { containerRef, threshold, rootMargin, visibleClass, selector } = {
+        ...DEFAULT_OPTIONS,
+        ...options
+    };
+    useEffect(()=>{
+        const container = containerRef?.current ?? document.body;
+        if (!container) return;
+        const observer = new IntersectionObserver((entries)=>{
+            entries.forEach((entry)=>{
+                if (entry.isIntersecting) entry.target.classList.add(visibleClass);
+            });
+        }, {
+            threshold,
+            rootMargin
+        });
+        const elements = container.querySelectorAll(selector);
+        elements.forEach((el)=>observer.observe(el));
+        return ()=>{
+            observer.disconnect();
+        };
+    }, [
+        containerRef,
+        threshold,
+        rootMargin,
+        visibleClass,
+        selector
+    ]);
+}
+export { useScrollReveal };

package/lib/index.d.ts

@@ -1,4 +1,6 @@
 export declare const capabilityClient: import("@lark-apaas/client-capability").CapabilityClient;
+export { showConfirm } from './components/ui/confirm';
+export type { ConfirmOptions } from './components/ui/confirm';
 declare const _default: {
     version: string;
 };

package/lib/index.js

@@ -1,17 +1,29 @@
 import { createClient } from "@lark-apaas/client-capability";
 import { normalizeBasePath } from "./utils/utils.js";
+import { getAppId } from "./utils/getAppId.js";
+import { isNewPathEnabled } from "./utils/apiPath.js";
 import { logger } from "./logger/index.js";
+import { showToast } from "./components/ui/toast.js";
 import { version } from "../package.json";
+import { showConfirm } from "./components/ui/confirm.js";
+const _appId = getAppId();
+const _acquireUploadUrl = isNewPathEnabled() ? `/app/${_appId}/__runtime__/api/v1/studio/plugins/tmp_files/acquire_upload_url` : "/af/api/v1/studio/plugins/tmp_files/acquire_upload_url";
+const _acquireDownloadUrl = isNewPathEnabled() ? `/app/${_appId}/__runtime__/api/v1/studio/plugins/tmp_files/acquire_download_url` : "/af/api/v1/studio/plugins/tmp_files/acquire_download_url";
 const capabilityClient = createClient({
     baseURL: normalizeBasePath(process.env.CLIENT_BASE_PATH),
+    acquireUploadUrl: _acquireUploadUrl,
+    acquireDownloadUrl: _acquireDownloadUrl,
     fetchOptions: {
         headers: {
             'X-Suda-Csrf-Token': window.csrfToken ?? ''
         }
     },
-    logger: logger
+    logger: logger,
+    onRateLimitError: ()=>{
+        showToast('应用额度已耗尽，请联系应用开发者');
+    }
 });
 const src = {
     version: version
 };
-export { capabilityClient, src as default };
+export { capabilityClient, src as default, showConfirm };

package/lib/integrations/dataloom.d.ts

@@ -1,2 +1,4 @@
+declare const createDataLoomClient: (url?: string, pat?: string) => import("@data-loom/js").DataloomClient<any, "public", any>;
 /** 获取dataloom实例 */
-export declare function getDataloom(): Promise<import("@data-loom/js").DataloomClient<any, "public", any>>;
+export declare function getDataloom(): Promise<ReturnType<typeof createDataLoomClient>>;
+export {};

package/lib/integrations/dataloom.js

@@ -3,9 +3,11 @@ import { createClient } from "@data-loom/js";
 import { getAppId } from "../utils/getAppId.js";
 import { getInitialInfo } from "../utils/getInitialInfo.js";
 const createDataLoomClient = (url, pat)=>{
-    if (!url) return null;
-    const { baseUrl, workspace } = splitWorkspaceUrl(url);
-    const appId = getAppId(window.location.pathname);
+    const { baseUrl, workspace } = url ? splitWorkspaceUrl(url) : {
+        baseUrl: '',
+        workspace: ''
+    };
+    const appId = getAppId();
     return createClient(baseUrl, pat, workspace, {
         global: {
             enableDataloomLog: 'production' !== process.env.NODE_ENV,
@@ -21,12 +23,18 @@ const createDataLoomClient = (url, pat)=>{
     });
 };
 let dataloom = null;
-async function getDataloom() {
-    if (dataloom) return dataloom;
-    const info = await getInitialInfo();
-    const DATALOOM_CLIENT_URL = info?.app_runtime_extra?.url;
-    const DATALOOM_PAT = info?.app_runtime_extra?.token;
-    dataloom = createDataLoomClient(DATALOOM_CLIENT_URL, DATALOOM_PAT);
-    return dataloom;
+let pendingPromise = null;
+function getDataloom() {
+    if (dataloom) return Promise.resolve(dataloom);
+    if (pendingPromise) return pendingPromise;
+    pendingPromise = getInitialInfo().then((info)=>{
+        const DATALOOM_CLIENT_URL = info?.app_runtime_extra?.url;
+        const DATALOOM_PAT = info?.app_runtime_extra?.token;
+        dataloom = createDataLoomClient(DATALOOM_CLIENT_URL, DATALOOM_PAT);
+        return dataloom;
+    }).finally(()=>{
+        pendingPromise = null;
+    });
+    return pendingPromise;
 }
 export { getDataloom };

package/lib/integrations/getCurrentUserProfile.d.ts

@@ -1,5 +1,11 @@
 import { IUserProfile } from '../apis/udt-types';
-export declare function getCurrentUserProfile(): IUserProfile;
+/**
+ * 获取当前用户信息。
+ * 返回 Partial<IUserProfile>，因为初始值来自 window._userInfo，
+ * 该值在运行时始终为空对象 {}，所有字段均为 undefined。
+ * 异步获取用户信息后才会被填充为完整的 IUserProfile。
+ */
+export declare function getCurrentUserProfile(): Partial<IUserProfile>;
 /**
  * @deprecated 请使用 getCurrentUserProfile 代替
  */

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

@@ -0,0 +1,12 @@
+import type { BatchGetChatsResponse, SearchChatsParams, SearchChatsResponse } from './types';
+export type ChatServiceConfig = {
+    getAppId?: () => string | null | undefined;
+    searchChatsUrl?: (appId: string) => string;
+    listChatsUrl?: (appId: string) => string;
+};
+export declare class ChatService {
+    private config;
+    constructor(config?: ChatServiceConfig);
+    searchChats(params: SearchChatsParams): Promise<SearchChatsResponse>;
+    listChatsByIds(chatIds: string[]): Promise<BatchGetChatsResponse>;
+}

package/lib/integrations/services/ChatService.js

@@ -0,0 +1,67 @@
+import { getAppId } from "../../utils/getAppId.js";
+const DEFAULT_CONFIG = {
+    getAppId: ()=>getAppId(),
+    searchChatsUrl: (appId)=>`/app/${appId}/__runtime__/api/v1/account/search`,
+    listChatsUrl: (appId)=>`/app/${appId}/__runtime__/api/v1/account/chat/list_chats`
+};
+class ChatService {
+    config;
+    constructor(config = {}){
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config
+        };
+    }
+    async searchChats(params) {
+        const appId = this.config.getAppId();
+        if (!appId) throw new Error('Failed to get appId');
+        const response = await fetch(this.config.searchChatsUrl(appId), {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                query: params.query,
+                filters: {
+                    userParam: {
+                        commonParam: {
+                            searchable: false
+                        }
+                    },
+                    departmentParam: {
+                        commonParam: {
+                            searchable: false
+                        }
+                    },
+                    chatParam: {
+                        commonParam: {
+                            searchable: true,
+                            pageSize: params.pageSize ?? 100,
+                            offset: params.offset ?? 0
+                        }
+                    }
+                }
+            }),
+            credentials: 'include'
+        });
+        if (!response.ok) throw new Error('Failed to search chats');
+        return response.json();
+    }
+    async listChatsByIds(chatIds) {
+        const appId = this.config.getAppId();
+        if (!appId) throw new Error('Failed to get appId');
+        const response = await fetch(this.config.listChatsUrl(appId), {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                chatIDList: chatIds
+            }),
+            credentials: 'include'
+        });
+        if (!response.ok) throw new Error('Failed to fetch chats by ids');
+        return response.json();
+    }
+}
+export { ChatService };

package/lib/integrations/services/DepartmentService.js

@@ -1,7 +1,8 @@
 import { getAppId } from "../../utils/getAppId.js";
+import { isNewPathEnabled } from "../../utils/apiPath.js";
 const DEFAULT_CONFIG = {
-    getAppId: ()=>getAppId(window.location.pathname),
-    searchDepartmentUrl: (appId)=>`/af/app/${appId}/runtime/api/v1/account/search_department`
+    getAppId: ()=>getAppId(),
+    searchDepartmentUrl: (appId)=>isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/account/search_department` : `/af/app/${appId}/runtime/api/v1/account/search_department`
 };
 class DepartmentService {
     config;

package/lib/integrations/services/UserProfileService.js

@@ -1,11 +1,12 @@
 import { getAppId } from "../../utils/getAppId.js";
+import { isNewPathEnabled } from "../../utils/apiPath.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`
+    getAppId: ()=>getAppId(),
+    userProfileUrl: (appId)=>isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/account/user_profile` : `/af/app/${appId}/runtime/api/v1/account/user_profile`
 };
 class UserProfileService {
     config;

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

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