@lark-apaas/client-toolkit 1.2.10-alpha.4 → 1.2.10-alpha.40

package/lib/apis/hooks/useScrollReveal.d.ts

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

package/lib/apis/hooks/useScrollReveal.js

@@ -0,0 +1 @@
+export * from "../../hooks/useScrollReveal.js";

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

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

package/lib/apis/utils/scopedStorage.js

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

package/lib/components/AppContainer/api-proxy/core.js

@@ -139,7 +139,8 @@ class ApiProxy {
             ...config,
             headers: {
                 ...this.defaultConfig.headers,
-                ...config.headers
+                ...config.headers,
+                'X-Page-Route': 'undefined' != typeof window ? window.location?.pathname || '/' : '/'
             }
         };
         const requestKey = this.generateRequestKey(mergedConfig);

package/lib/components/AppContainer/index.js

@@ -13,6 +13,7 @@ import { useAppInfo } from "../../hooks/index.js";
 import { TrackKey } from "../../types/tea.js";
 import safety from "./safety.js";
 import { getAppId } from "../../utils/getAppId.js";
+import { isNewPathEnabled } from "../../utils/apiPath.js";
 import QueryProvider from "../QueryProvider/index.js";
 import { AuthProvider } from "@lark-apaas/auth-sdk";
 import "../../runtime/index.js";
@@ -52,15 +53,20 @@ const App = (props)=>{
         if ('production' === process.env.NODE_ENV) reportTeaEvent({
             trackKey: TrackKey.VIEW,
             trackParams: {
-                artifact_uid: getAppId(window.location.pathname),
+                artifact_uid: getAppId(),
                 agent_id: 'agent_miaoda',
                 url: window.location.href
             }
         });
     }, []);
+    const appId = getAppId();
+    const permissionApiUrl = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/permissions/roles` : `/spark/app/${appId}/runtime/api/v1/permissions/roles`;
     return /*#__PURE__*/ jsxs(AuthProvider, {
         config: {
-            enable: enableAuth
+            enable: enableAuth,
+            permissionApi: {
+                url: permissionApiUrl
+            }
         },
         children: [
             /*#__PURE__*/ jsx(Toaster, {}),

package/lib/components/AppContainer/safety.js

@@ -3,11 +3,12 @@ import { useEffect, useRef, useState } from "react";
 import { Popover, PopoverContent, PopoverTrigger } from "../ui/popover.js";
 import { getCsrfToken } from "../../utils/getCsrfToken.js";
 import { getAppId } from "../../utils/getAppId.js";
+import { isNewPathEnabled } from "../../utils/apiPath.js";
 import { useIsMobile } from "../../hooks/index.js";
 import { X } from "lucide-react";
 import { Sheet, SheetContent, SheetTrigger } from "../ui/drawer.js";
 const Component = ()=>{
-    const HasClosedKey = `miaoda-creatByMiaoda-has-closed-${getAppId(window.location.pathname)}`;
+    const HasClosedKey = `miaoda-creatByMiaoda-has-closed-${getAppId()}`;
     const [visible, setVisible] = useState(!window.localStorage?.getItem(HasClosedKey));
     const [open, setOpen] = useState(false);
     const isMobile = useIsMobile();
@@ -15,7 +16,9 @@ const Component = ()=>{
     const [isInternetVisible, setIsInternetVisible] = useState(false);
     const timeoutRef = useRef(null);
     useEffect(()=>{
-        fetch(`/spark/b/${getAppId(window.location.pathname)}/tenant_info`, {
+        const appId = getAppId();
+        const tenantInfoUrl = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/studio/tenant_info` : `/spark/b/${appId}/tenant_info`;
+        fetch(tenantInfoUrl, {
             headers: {
                 'X-Suda-Csrf-Token': getCsrfToken()
             }

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/getLarkUser.js

@@ -1,13 +1,15 @@
 import { getAppId } from "../../../utils/getAppId.js";
 import { getCsrfToken } from "../../../utils/getCsrfToken.js";
+import { isNewPathEnabled } from "../../../utils/apiPath.js";
 async function getLarkUserInfo() {
-    const appId = getAppId(window.location.pathname);
+    const appId = getAppId();
     if (!appId) return {
         code: 1,
         msg: 'appId is required',
         data: {}
     };
-    const response = await fetch(`/spark/b/${appId}/lark/user_info`, {
+    const url = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/studio/lark/user_info` : `/spark/b/${appId}/lark/user_info`;
+    const response = await fetch(url, {
         headers: {
             'X-Suda-Csrf-Token': getCsrfToken()
         }

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

@@ -1,11 +1,17 @@
 import { AppEnv, observable } from "@lark-apaas/observable-web";
+import { isNewPathEnabled } from "../../../utils/apiPath.js";
 const initObservable = ()=>{
     try {
         const appId = window.appId;
         observable.start({
             serviceName: "app",
             env: 'development' === process.env.NODE_ENV ? AppEnv.Dev : AppEnv.Prod,
-            collectorUrl: {
+            collectorUrl: isNewPathEnabled() ? {
+                log: `/app/${appId}/__runtime__/api/v1/observability/logs/collect`,
+                trace: `/app/${appId}/__runtime__/api/v1/observability/traces/collect`,
+                metric: `/app/${appId}/__runtime__/api/v1/observability/metrics/collect`,
+                time: `/app/${appId}/__runtime__/api/v1/observability/current_server_timestamp`
+            } : {
                 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`,

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

@@ -16,7 +16,7 @@ async function createTracker() {
     const userIDEncrypt = userID && '0' !== userID ? encryptTea(userID) : void 0;
     const tenantIDEncrypt = tenantID && '0' !== tenantID ? encryptTea(tenantID) : void 0;
     window.collectEvent('init', {
-        app_id: 672575,
+        app_id: 788827,
         channel: 'cn',
         disable_auto_pv: false,
         enable_ab_test: false,

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/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/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/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.js

@@ -1,15 +1,26 @@
 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";
+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

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,

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.js

@@ -1,8 +1,9 @@
 import { getAppId } from "../../utils/getAppId.js";
+import { isNewPathEnabled } from "../../utils/apiPath.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`
+    getAppId: ()=>getAppId(),
+    searchUserUrl: (appId)=>isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/account/search_user` : `/af/app/${appId}/runtime/api/v1/account/search_user`,
+    listUsersUrl: (appId)=>isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/account/list_users` : `/af/app/${appId}/runtime/api/v1/account/list_users`
 };
 class UserService {
     config;

package/lib/logger/intercept-global-error.js

@@ -1,4 +1,4 @@
-import { createApplyHandle, getModuleHot } from "../utils/module-hot.js";
+import { getHmrApi } from "../utils/hmr-api.js";
 import { submitPostMessage, submitSlardarEvent } from "../utils/postMessage.js";
 import { levelSchema } from "./log-types.js";
 import { logger } from "./logger.js";
@@ -63,26 +63,28 @@ function processDevServerLog(log) {
     }
 }
 function listenModuleHmr() {
-    const hot = getModuleHot();
-    if (hot) hot.addStatusHandler(createApplyHandle((success, status)=>{
-        if (success) submitPostMessage({
-            type: 'DevServerMessage',
-            data: {
-                type: 'devServer-status',
-                status: 'hmr-apply-success'
-            }
+    const hmr = getHmrApi();
+    if (hmr) {
+        hmr.onSuccess(()=>{
+            submitPostMessage({
+                type: 'DevServerMessage',
+                data: {
+                    type: 'devServer-status',
+                    status: 'hmr-apply-success'
+                }
+            });
         });
-        else {
-            console.warn('hmr apply failed', status);
+        hmr.onError((error)=>{
+            console.warn('hmr apply failed', error);
             submitSlardarEvent({
                 name: 'sandbox-devServer',
                 categories: {
                     type: 'hmr-apply-failed',
-                    status
+                    error: String(error)
                 }
             });
-        }
-    }));
+        });
+    }
 }
 function interceptErrors() {
     window.addEventListener('error', (event)=>{

package/lib/theme-layer.css

@@ -1,3 +1,4 @@
 @layer theme, base, antd, components, utilities;
-@import "tailwindcss";
+@import 'tailwindcss' source(none);
+@source "../**/*.{js,jsx,ts,tsx}";
 

package/lib/utils/apiPath.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 判断当前是否启用新的路径规范
+ * 新路径规范：CLIENT_BASE_PATH 以 /app/:appId 格式开头
+ */
+export declare function isNewPathEnabled(): boolean;

package/lib/utils/apiPath.js

@@ -0,0 +1,5 @@
+function isNewPathEnabled() {
+    const basePath = process.env.CLIENT_BASE_PATH || '/';
+    return /^\/app\/[^/]/.test(basePath);
+}
+export { isNewPathEnabled };

package/lib/utils/axiosConfig.js

@@ -54,7 +54,7 @@ async function logResponse(ok, responseOrError) {
             logTraceID
         };
         if (stacktrace) logMeta.stacktrace = stacktrace;
-        logger.debug({
+        logger.log({
             level: ok,
             args: [
                 parts.join(''),
@@ -110,7 +110,7 @@ async function logResponse(ok, responseOrError) {
         const stacktrace = await requestStacktraceMap.get(requestUUID);
         const logMeta = {};
         if (stacktrace) logMeta.stacktrace = stacktrace;
-        logger.debug({
+        logger.log({
             level: 'error',
             args: [
                 parts.join(''),
@@ -120,7 +120,7 @@ async function logResponse(ok, responseOrError) {
         });
         return;
     }
-    logger.debug({
+    logger.log({
         level: 'error',
         args: [
             '请求失败：无响应对象或配置信息'
@@ -234,6 +234,7 @@ function initAxiosConfig(axiosInstance) {
         config._startTime = config._startTime || Date.now();
         const csrfToken = window.csrfToken;
         if (csrfToken) config.headers['X-Suda-Csrf-Token'] = csrfToken;
+        if ('undefined' != typeof window && window.location?.pathname) config.headers['X-Page-Route'] = window.location.pathname;
         return config;
     }, (error)=>Promise.reject(error));
     instance.interceptors.response.use((response)=>response, (error)=>{
@@ -241,8 +242,8 @@ function initAxiosConfig(axiosInstance) {
             if (error.response?.status === 403) {
                 const method = (error.config?.method || 'GET').toUpperCase();
                 const url = (error.config?.url || '').split('?')[0];
-                logger.debug({
-                    level: 'warning',
+                logger.log({
+                    level: 'warn',
                     args: [
                         `请求被拒绝(403)：${method} ${url}`,
                         {

package/lib/utils/getAppId.d.ts

@@ -1,6 +1,4 @@
 /**
- * 提取固定前缀后的第一个目录名
- * @param {string} path - 输入路径字符串
- * @returns {string|null} - 提取的目录名或null
+ * 获取应用 ID
  */
-export declare function getAppId(path: string): string | null;
+export declare function getAppId(): string | null;

package/lib/utils/getAppId.js

@@ -1,12 +1,5 @@
-function getAppId(path) {
-    if (window.MIAODA_APP_ID) return window.MIAODA_APP_ID;
-    let prefix;
-    prefix = path.includes('/ai/feida/runtime/') ? '/ai/feida/runtime/' : path.includes('/spark/r/') ? '/spark/r/' : '/ai/miaoda/';
+function getAppId() {
     const windowAppId = window.appId || null;
-    if (!path.startsWith(prefix)) return windowAppId;
-    const remainder = path.substring(prefix.length);
-    const nextSlashIndex = remainder.indexOf('/');
-    if (-1 === nextSlashIndex) return remainder || windowAppId;
-    return remainder.substring(0, nextSlashIndex) || windowAppId;
+    return windowAppId;
 }
 export { getAppId };

package/lib/utils/getInitialInfo.js

@@ -1,5 +1,6 @@
 import { getAppId } from "./getAppId.js";
 import { getCsrfToken } from "./getCsrfToken.js";
+import { isNewPathEnabled } from "./apiPath.js";
 async function getAppPublished() {
     try {
         const headers = {
@@ -8,15 +9,16 @@ async function getAppPublished() {
             'x-miaoda-token': window.MIAODA_BUILTIN_TTT,
             'X-Suda-Csrf-Token': getCsrfToken()
         };
-        const appId = getAppId(window.location.pathname) || window.appId;
-        const url = `${window.location.origin}/spark/b/${appId}/get_published`;
+        const appId = getAppId();
+        const path = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/studio/get_published` : `/spark/b/${appId}/get_published`;
+        const url = `${window.location.origin}${path}`;
         const response = await fetch(url, {
             method: 'GET',
             headers,
             credentials: 'include'
         });
         const res = await response.json();
-        if (0 === res.code) return res.data;
+        if (0 === res.code || '0' === res.status_code) return res.data;
         console.error('Error fetching published app info:', res);
     } catch (error) {
         console.error('Error fetching published app info:', error);

package/lib/utils/getUserProfile.js

@@ -1,9 +1,8 @@
 import { getAppId } from "./getAppId.js";
 import { getCsrfToken } from "./getCsrfToken.js";
-import { getEnvPath } from "./getEnvPath.js";
-import { isSparkRuntime } from "./utils.js";
+import { isNewPathEnabled } from "./apiPath.js";
 async function getUserProfile(request, headers = {}) {
-    const appId = getAppId(window.location.pathname);
+    const appId = getAppId();
     if (!appId) return {
         code: 1,
         msg: 'appId is required',
@@ -15,17 +14,10 @@ async function getUserProfile(request, headers = {}) {
     const mergedHeaders = {
         ...defaultHeaders,
         ...headers,
-        'X-Kunlun-Token': window.token,
-        'x-miaoda-token': window.MIAODA_BUILTIN_TTT,
-        'x-lgw-csrf-token': window.lgw_csrf_token,
         ...window.CSRF_HEADERS || {}
     };
-    const envPath = getEnvPath();
-    let endpoint;
-    if (isSparkRuntime()) {
-        endpoint = `/spark/b/${appId}/user/profile`;
-        mergedHeaders['X-Suda-Csrf-Token'] = getCsrfToken();
-    } else endpoint = `/ai/api/${envPath}/v1/apps/${appId}/user/profile`;
+    const endpoint = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/studio/user/profile` : `/spark/b/${appId}/user/profile`;
+    mergedHeaders['X-Suda-Csrf-Token'] = getCsrfToken();
     const response = await fetch(`${window.location.origin}${endpoint}`, {
         method: 'POST',
         headers: mergedHeaders,

package/lib/utils/hmr-api.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 统一 HMR API
+ *
+ * 提供统一的 HMR 成功/失败回调接口，屏蔽 Webpack 和 Vite 的差异。
+ *
+ * - Webpack/Rspack: 通过 import.meta.webpackHot 或 module.hot
+ * - Vite: 通过 error-overlay 注入的 window.__VITE_HMR__
+ *
+ * @see docs/RFC_HMR_API.md
+ */
+export interface HmrApi {
+    /**
+     * 注册 HMR 成功回调
+     * @param callback 成功回调函数
+     * @returns cleanup 函数，用于取消注册
+     */
+    onSuccess(callback: () => void): () => void;
+    /**
+     * 注册 HMR 失败回调
+     * @param callback 失败回调函数，参数为错误信息
+     * @returns cleanup 函数，用于取消注册
+     */
+    onError(callback: (error: unknown) => void): () => void;
+}
+declare global {
+    interface Window {
+        __VITE_HMR__?: HmrApi;
+    }
+}
+/**
+ * 获取 HMR API 实例
+ *
+ * 自动检测当前构建工具（Webpack/Vite）并返回对应实现：
+ * - Webpack/Rspack: 使用内置适配器
+ * - Vite: 使用 error-overlay 注入的 window.__VITE_HMR__
+ *
+ * @returns HmrApi 实例，如果不在开发环境或不支持 HMR 则返回 null
+ */
+export declare function getHmrApi(): HmrApi | null;

package/lib/utils/hmr-api.js

@@ -0,0 +1,36 @@
+function createWebpackHmrApi(hot) {
+    return {
+        onSuccess (callback) {
+            let lastStatus = null;
+            const handler = (status)=>{
+                if ('idle' === status && 'apply' === lastStatus) try {
+                    callback();
+                } catch (e) {
+                    console.error('[HMR] Success callback error:', e);
+                }
+                lastStatus = status;
+            };
+            hot.addStatusHandler(handler);
+            return ()=>hot.removeStatusHandler(handler);
+        },
+        onError (callback) {
+            const handler = (status)=>{
+                if ('fail' === status || 'abort' === status) try {
+                    callback(new Error(`HMR ${status}`));
+                } catch (e) {
+                    console.error('[HMR] Error callback error:', e);
+                }
+            };
+            hot.addStatusHandler(handler);
+            return ()=>hot.removeStatusHandler(handler);
+        }
+    };
+}
+function getHmrApi() {
+    if ('production' === process.env.NODE_ENV) return null;
+    if (import.meta.webpackHot) return createWebpackHmrApi(import.meta.webpackHot);
+    'undefined' != typeof module && module.hot;
+    if (window.__VITE_HMR__) return window.__VITE_HMR__;
+    return null;
+}
+export { getHmrApi };

package/lib/utils/module-hot.d.ts

@@ -15,10 +15,15 @@ export interface ModuleHotInstance {
     addStatusHandler: (handler: (status: ModuleHotType) => void) => void;
     removeStatusHandler: (handler: (status: ModuleHotType) => void) => void;
 }
+/**
+ * 获取 Webpack HMR 实例
+ * 仅支持 Webpack/Rspack 的 HMR API
+ */
 export declare function getModuleHot(): ModuleHotInstance | null;
 /**
  * 创建模块热更成功处理函数
- * 监听模块热更状态，当状态为apply时，调用回调函数并传入true
- * @param callback 热更成功回调函数，参数为是否成功
+ * 监听模块热更状态，检测 apply -> idle 转换表示热更成功
+ *
+ * @param callback 热更回调函数，参数为是否成功和当前状态
  */
 export declare function createApplyHandle(callback: (success: boolean, status: ModuleHotType) => void): (status: ModuleHotType) => void;

package/lib/utils/module-hot.js

@@ -1,66 +1,21 @@
-function createViteHmrAdapter(viteHot) {
-    const handlers = new Set();
-    const notifyHandlers = (status)=>{
-        handlers.forEach((handler)=>{
-            try {
-                handler(status);
-            } catch (e) {
-                console.error('[HMR] Status handler error:', e);
-            }
-        });
-    };
-    const beforeUpdateHandler = ()=>{
-        notifyHandlers('prepare');
-        setTimeout(()=>notifyHandlers('apply'), 0);
-    };
-    const afterUpdateHandler = ()=>{
-        notifyHandlers('idle');
-    };
-    const errorHandler = ()=>{
-        notifyHandlers('fail');
-    };
-    const beforeFullReloadHandler = ()=>{
-        notifyHandlers('check');
-    };
-    viteHot.on('vite:beforeUpdate', beforeUpdateHandler);
-    viteHot.on('vite:afterUpdate', afterUpdateHandler);
-    viteHot.on('vite:error', errorHandler);
-    viteHot.on('vite:beforeFullReload', beforeFullReloadHandler);
-    return {
-        addStatusHandler (handler) {
-            handlers.add(handler);
-        },
-        removeStatusHandler (handler) {
-            handlers.delete(handler);
-        }
-    };
-}
-let viteAdapterInstance = null;
 function getModuleHot() {
     if ('production' === process.env.NODE_ENV) return null;
-    if (import.meta.hot) {
-        if (!viteAdapterInstance) viteAdapterInstance = createViteHmrAdapter(import.meta.hot);
-        return viteAdapterInstance;
-    }
     if (import.meta.webpackHot) return import.meta.webpackHot;
     'undefined' != typeof module && module.hot;
     return null;
 }
 function createApplyHandle(callback) {
-    let hasApply = false;
+    let lastStatus = null;
     return (status)=>{
         if ('fail' === status || 'abort' === status) {
-            hasApply = false;
+            lastStatus = status;
             return callback(false, status);
         }
-        if (hasApply) {
-            if ('idle' === status) {
-                hasApply = false;
-                callback(true, status);
-            }
-            return;
+        if ('idle' === status && 'apply' === lastStatus) {
+            lastStatus = status;
+            return callback(true, status);
         }
-        hasApply = 'apply' === status;
+        lastStatus = status;
     };
 }
 export { createApplyHandle, getModuleHot };

package/lib/utils/requestManager.js

@@ -4,9 +4,7 @@ async function fetchUserProfilesByIds(ids) {
     try {
         const dataloom = await getDataloom();
         if (!dataloom) throw new Error('Dataloom client is unavailable');
-        const numericIds = ids.map(Number).filter(Number.isFinite);
-        if (0 === numericIds.length) return [];
-        const response = await dataloom.service.user.getByIds(numericIds);
+        const response = await dataloom.service.user.getByIds(ids);
         return Array.isArray(response?.data) ? response.data : response?.data?.user_list || [];
     } catch (error) {
         console.error(`Failed to fetch profiles for user IDs ${ids.join(', ')}:`, error);

package/lib/utils/scopedStorage.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 按 appId 隔离的 localStorage 封装
+ * API 与原生 localStorage 保持一致
+ */
+export declare const scopedStorage: Storage;

package/lib/utils/scopedStorage.js

@@ -0,0 +1,46 @@
+import { getAppId } from "./getAppId.js";
+function getPrefix() {
+    const appId = getAppId();
+    const namespace = appId || '__global__';
+    return `__miaoda_${namespace}__:`;
+}
+function getScopedKeys() {
+    const prefix = getPrefix();
+    const keys = [];
+    for(let i = 0; i < localStorage.length; i++){
+        const key = localStorage.key(i);
+        if (key && key.startsWith(prefix)) keys.push(key.substring(prefix.length));
+    }
+    return keys;
+}
+const scopedStorage = {
+    getItem (key) {
+        const prefixedKey = getPrefix() + key;
+        return localStorage.getItem(prefixedKey);
+    },
+    setItem (key, value) {
+        const prefixedKey = getPrefix() + key;
+        localStorage.setItem(prefixedKey, value);
+    },
+    removeItem (key) {
+        const prefixedKey = getPrefix() + key;
+        localStorage.removeItem(prefixedKey);
+    },
+    clear () {
+        const prefix = getPrefix();
+        const keysToRemove = [];
+        for(let i = 0; i < localStorage.length; i++){
+            const key = localStorage.key(i);
+            if (key && key.startsWith(prefix)) keysToRemove.push(key);
+        }
+        keysToRemove.forEach((key)=>localStorage.removeItem(key));
+    },
+    key (index) {
+        const keys = getScopedKeys();
+        return keys[index] || null;
+    },
+    get length () {
+        return getScopedKeys().length;
+    }
+};
+export { scopedStorage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/client-toolkit",
-  "version": "1.2.10-alpha.4",
+  "version": "1.2.10-alpha.40",
   "types": "./lib/index.d.ts",
   "main": "./lib/index.js",
   "files": [
@@ -93,10 +93,10 @@
   "dependencies": {
     "@ant-design/colors": "^7.2.1",
     "@ant-design/cssinjs": "^1.24.0",
-    "@data-loom/js": "0.4.4-alpha.10",
-    "@lark-apaas/auth-sdk": "^0.1.0",
-    "@lark-apaas/client-capability": "^0.1.3",
-    "@lark-apaas/miaoda-inspector": "^1.0.14-alpha.5",
+    "@data-loom/js": "0.4.9-alpha.2",
+    "@lark-apaas/auth-sdk": "0.1.0-alpha.55",
+    "@lark-apaas/client-capability": "0.1.3-alpha.14",
+    "@lark-apaas/miaoda-inspector": "^1.0.15",
     "@lark-apaas/observable-web": "^1.0.1",
     "@radix-ui/react-avatar": "^1.1.10",
     "@radix-ui/react-popover": "^1.1.15",

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

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

package/lib/apis/tools/generateImage.js

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

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

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

package/lib/apis/tools/generateTextStream.js

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

package/lib/integrations/generateImage.d.ts

@@ -1 +0,0 @@
-export declare function generateImage(prompt: string, size?: string, headers?: Record<string, string>): Promise<any>;

package/lib/integrations/generateImage.js

@@ -1,47 +0,0 @@
-import { getAppId } from "../utils/getAppId.js";
-import { getCsrfToken } from "../utils/getCsrfToken.js";
-import { getEnvPath } from "../utils/getEnvPath.js";
-import { isSparkRuntime } from "../utils/utils.js";
-async function generateImage(prompt, size = '1024x1024', headers = {}) {
-    const appId = getAppId(window.location.pathname);
-    if (!appId) return {
-        code: 1,
-        msg: 'appId is required',
-        data: {}
-    };
-    const defaultHeaders = {
-        'Content-Type': 'application/json'
-    };
-    const mergedHeaders = {
-        ...defaultHeaders,
-        ...headers,
-        'X-Kunlun-Token': window.token,
-        'x-miaoda-token': window.MIAODA_BUILTIN_TTT,
-        'x-lgw-csrf-token': window.lgw_csrf_token,
-        ...window.CSRF_HEADERS || {}
-    };
-    if (isSparkRuntime()) {
-        mergedHeaders['X-Suda-Csrf-Token'] = getCsrfToken();
-        const response = await fetch(`${window.location.origin}/spark/b/${appId}/text2image`, {
-            method: 'POST',
-            headers: mergedHeaders,
-            credentials: 'include',
-            body: JSON.stringify({
-                prompt,
-                size
-            })
-        });
-        return await response.json();
-    }
-    const response = await fetch(`${window.location.origin}/ai/api/${getEnvPath()}/v1/apps/${appId}/text2image`, {
-        method: 'POST',
-        headers: mergedHeaders,
-        credentials: 'include',
-        body: JSON.stringify({
-            prompt,
-            size
-        })
-    });
-    return await response.json();
-}
-export { generateImage };

package/lib/integrations/generateTextStream.d.ts

@@ -1,21 +0,0 @@
-interface GenerateTextOptions {
-    text: string;
-    thinking_type?: 'enabled' | 'disabled';
-    headers?: Record<string, string>;
-}
-interface GenerateTextResult {
-    content: string;
-    reasoning_content: string;
-    success: boolean;
-    error?: string;
-}
-/**
- * 文生文 - 流式版本
- * 支持实时接收生成内容的回调
- */
-export declare function generateTextStream(options: GenerateTextOptions, onChunk?: (chunk: {
-    content: string;
-    reasoning_content: string;
-    finished: boolean;
-}) => void): Promise<GenerateTextResult>;
-export {};

package/lib/integrations/generateTextStream.js

@@ -1,98 +0,0 @@
-import { getAppId } from "../utils/getAppId.js";
-import { getCsrfToken } from "../utils/getCsrfToken.js";
-import { getEnvPath } from "../utils/getEnvPath.js";
-import { isSparkRuntime } from "../utils/utils.js";
-async function generateTextStream(options, onChunk) {
-    const { text, thinking_type = 'disabled', headers = {} } = options;
-    const appId = getAppId(window.location.pathname);
-    if (!appId) return {
-        content: '',
-        reasoning_content: '',
-        success: false,
-        error: 'appId is required'
-    };
-    try {
-        const mergedHeaders = {
-            'Content-Type': 'application/json',
-            ...headers,
-            'X-Kunlun-Token': window.token,
-            'x-miaoda-token': window.MIAODA_BUILTIN_TTT,
-            'x-lgw-csrf-token': window.lgw_csrf_token,
-            ...window.CSRF_HEADERS || {}
-        };
-        let response;
-        if (isSparkRuntime()) {
-            mergedHeaders['X-Suda-Csrf-Token'] = getCsrfToken();
-            response = await fetch(`${window.location.origin}/spark/b/${appId}/text/generate`, {
-                method: 'POST',
-                headers: mergedHeaders,
-                credentials: 'include',
-                body: JSON.stringify({
-                    text,
-                    thinking_type
-                })
-            });
-        } else response = await fetch(`${window.location.origin}/ai/api/${getEnvPath()}/v1/apps/${appId}/text/generate`, {
-            method: 'POST',
-            headers: mergedHeaders,
-            credentials: 'include',
-            body: JSON.stringify({
-                text,
-                thinking_type
-            })
-        });
-        if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
-        const reader = response.body?.getReader();
-        if (!reader) throw new Error('无法获取响应流');
-        let fullContent = '';
-        let fullReasoningContent = '';
-        const decoder = new TextDecoder();
-        while(true){
-            const { done, value } = await reader.read();
-            if (done) break;
-            const chunk = decoder.decode(value, {
-                stream: true
-            });
-            const lines = chunk.split('\n').filter((line)=>line.trim());
-            for (const line of lines)if (line.startsWith('data: ')) {
-                const jsonStr = line.slice(6);
-                try {
-                    const data = JSON.parse(jsonStr);
-                    if (0 !== data.code) return {
-                        content: '',
-                        reasoning_content: '',
-                        success: false,
-                        error: data.msg || '生成失败'
-                    };
-                    if (data.data.content) fullContent += data.data.content;
-                    if (data.data.reasoning_content) fullReasoningContent += data.data.reasoning_content;
-                    if (onChunk) onChunk({
-                        content: data.data.content || '',
-                        reasoning_content: data.data.reasoning_content || '',
-                        finished: data.finished
-                    });
-                    if (data.finished) return {
-                        content: fullContent,
-                        reasoning_content: fullReasoningContent,
-                        success: true
-                    };
-                } catch (parseError) {
-                    console.error(`解析JSON失败: ${jsonStr}`);
-                }
-            }
-        }
-        return {
-            content: fullContent,
-            reasoning_content: fullReasoningContent,
-            success: true
-        };
-    } catch (error) {
-        return {
-            content: '',
-            reasoning_content: '',
-            success: false,
-            error: error instanceof Error ? error.message : '未知错误'
-        };
-    }
-}
-export { generateTextStream };