@lark-apaas/client-toolkit 1.2.9-beta.43 → 1.2.9-beta.45

package/lib/apis/tools/storage.js

@@ -1,4 +1,5 @@
 function getDefaultBucketId() {
-    return window._bucket_id;
+    const w = window;
+    return w._bucket_id ?? w.__platform__?.appPublished?.app_runtime_extra?.bucket?.default_bucket_id;
 }
 export { getDefaultBucketId };

package/lib/components/AppContainer/index.js

@@ -1,5 +1,5 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
+import react, { Suspense, useEffect, useMemo, useState } from "react";
 import { ConfigProvider } from "antd";
 import { MiaodaInspector } from "@lark-apaas/miaoda-inspector";
 import zh_CN from "antd/locale/zh_CN";
@@ -10,20 +10,33 @@ import { reportTeaEvent } from "./utils/tea.js";
 import { useAppInfo } from "../../hooks/index.js";
 import { TrackKey } from "../../types/tea.js";
 import { slardar } from "@lark-apaas/internal-slardar";
-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";
+const Safety = /*#__PURE__*/ react.lazy(()=>import("./safety.js"));
 const isMiaodaPreview = window.IS_MIAODA_PREVIEW;
-const readCssVarColor = (varName, fallback)=>{
+const readAllCssVarColors = ()=>{
     try {
-        if ('undefined' == typeof document) return fallback;
-        const value = getComputedStyle(document.documentElement).getPropertyValue(varName).trim();
-        return value || fallback;
+        if ('undefined' == typeof document) return {};
+        const styles = getComputedStyle(document.documentElement);
+        const read = (name)=>styles.getPropertyValue(name).trim() || void 0;
+        return {
+            background: read('--background'),
+            destructive: read('--destructive'),
+            primary: read('--primary'),
+            foreground: read('--foreground'),
+            warning: read('--warning'),
+            success: read('--success'),
+            muted: read('--muted'),
+            mutedForeground: read('--muted-foreground'),
+            border: read('--border'),
+            popover: read('--popover'),
+            accent: read('--accent')
+        };
     } catch  {
-        return fallback;
+        return {};
     }
 };
 const appFlags = process.env.APP_FLAGS || {};
@@ -69,13 +82,17 @@ const App = (props)=>{
     }, []);
     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: {
+    const authConfig = useMemo(()=>({
             enable: enableAuth,
             permissionApi: {
                 url: permissionApiUrl
             }
-        },
+        }), [
+        enableAuth,
+        permissionApiUrl
+    ]);
+    return /*#__PURE__*/ jsxs(AuthProvider, {
+        config: authConfig,
         children: [
             !disableToaster && true !== appFlags.customToaster && /*#__PURE__*/ jsx(Toaster, {}),
             'production' !== process.env.NODE_ENV && /*#__PURE__*/ jsx(MiaodaInspector, {}),
@@ -88,19 +105,7 @@ const App = (props)=>{
 };
 const AppContainer_AppContainer = (props)=>{
     const { children } = props;
-    const [cssColors, setCssColors] = useState(()=>({
-            background: readCssVarColor('--background'),
-            destructive: readCssVarColor('--destructive'),
-            primary: readCssVarColor('--primary'),
-            foreground: readCssVarColor('--foreground'),
-            warning: readCssVarColor('--warning'),
-            success: readCssVarColor('--success'),
-            muted: readCssVarColor('--muted'),
-            mutedForeground: readCssVarColor('--muted-foreground'),
-            border: readCssVarColor('--border'),
-            popover: readCssVarColor('--popover'),
-            accent: readCssVarColor('--accent')
-        }));
+    const [cssColors, setCssColors] = useState(readAllCssVarColors);
     useEffect(()=>{
         if ('production' === process.env.NODE_ENV) return ()=>{};
         const observer = new MutationObserver((mutations)=>{
@@ -119,19 +124,7 @@ const AppContainer_AppContainer = (props)=>{
                     const maxRetries = 10;
                     const retryDelay = 400;
                     const updateColors = ()=>{
-                        const newColors = {
-                            background: readCssVarColor('--background'),
-                            destructive: readCssVarColor('--destructive'),
-                            primary: readCssVarColor('--primary'),
-                            foreground: readCssVarColor('--foreground'),
-                            warning: readCssVarColor('--warning'),
-                            success: readCssVarColor('--success'),
-                            muted: readCssVarColor('--muted'),
-                            mutedForeground: readCssVarColor('--muted-foreground'),
-                            border: readCssVarColor('--border'),
-                            popover: readCssVarColor('--popover'),
-                            accent: readCssVarColor('--accent')
-                        };
+                        const newColors = readAllCssVarColors();
                         setCssColors((currentColors)=>{
                             if (JSON.stringify(currentColors) !== JSON.stringify(newColors)) {
                                 retryCount = 0;
@@ -203,7 +196,10 @@ const AppContainer_AppContainer = (props)=>{
     };
     return /*#__PURE__*/ jsxs(Fragment, {
         children: [
-            /*#__PURE__*/ jsx(safety, {}),
+            /*#__PURE__*/ jsx(Suspense, {
+                fallback: null,
+                children: /*#__PURE__*/ jsx(Safety, {})
+            }),
             /*#__PURE__*/ jsx(QueryProvider, {
                 children: /*#__PURE__*/ jsx(ConfigProvider, {
                     locale: zh_CN,

package/lib/components/AppContainer/safety.js

@@ -1,8 +1,8 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 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 { getCsrfToken } from "../../utils/getCsrfToken.js";
 import { isNewPathEnabled } from "../../utils/apiPath.js";
 import { useIsMobile } from "../../hooks/index.js";
 import { X } from "lucide-react";
@@ -13,35 +13,34 @@ const Component = ()=>{
     const [visible, setVisible] = useState(!window.localStorage?.getItem(HasClosedKey));
     const [open, setOpen] = useState(false);
     const isMobile = useIsMobile();
-    const [userinfo, setUserinfo] = useState(null);
-    const [isInternetVisible, setIsInternetVisible] = useState(false);
-    const [showBadge, setShowBadge] = useState(true);
-    const [badgeLoaded, setBadgeLoaded] = useState(false);
     const timeoutRef = useRef(null);
+    const platformData = window.__platform_data__ || window.__platform__ || {};
+    const appId = getAppId() || platformData.appId;
+    const showBadge = false !== platformData.showBadge;
+    const [tenantName, setTenantName] = useState('');
+    const [isInternetVisible, setIsInternetVisible] = useState(false);
     useEffect(()=>{
-        const appId = getAppId();
+        if (!showBadge || !visible) return;
+        const csrfToken = getCsrfToken() ?? '';
         const csrfHeaders = {
-            'X-Suda-Csrf-Token': getCsrfToken()
+            'X-Suda-Csrf-Token': csrfToken
         };
         const tenantInfoUrl = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/studio/tenant_info` : `/spark/b/${appId}/tenant_info`;
         fetch(tenantInfoUrl, {
             headers: csrfHeaders
         }).then((res)=>res.json()).then((data)=>{
-            setUserinfo(data?.data?.tenant_info);
-            setIsInternetVisible(data?.data?.is_internet_visible);
-        }).catch(()=>{});
-        const getPublishedUrl = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/studio/get_published` : `/spark/b/${appId}/get_published`;
-        fetch(getPublishedUrl, {
-            headers: csrfHeaders
-        }).then((res)=>res.json()).then((data)=>{
-            const badge = data?.data?.app_info?.show_badge;
-            setShowBadge(false !== badge);
-        }).catch(()=>{
-            setShowBadge(true);
-        }).finally(()=>{
-            setBadgeLoaded(true);
+            if (data?.status_code === '0' || data?.code === 0) {
+                setTenantName(data?.data?.tenant_info?.name || '');
+                setIsInternetVisible(data?.data?.is_internet_visible || false);
+            }
+        }).catch((e)=>{
+            console.warn('Failed to fetch tenant info:', e);
         });
-    }, []);
+    }, [
+        appId,
+        showBadge,
+        visible
+    ]);
     useEffect(()=>{
         if (isMobile) {
             const link = document.createElement('link');
@@ -54,7 +53,6 @@ const Component = ()=>{
         isMobile
     ]);
     if ('production' !== process.env.NODE_ENV) return null;
-    if (!badgeLoaded) return null;
     if (!showBadge) return null;
     if (!visible) return null;
     if (isMobile) return /*#__PURE__*/ jsxs(Sheet, {
@@ -114,7 +112,7 @@ const Component = ()=>{
                                                 /*#__PURE__*/ jsx("p", {
                                                     className: "shrink-0 min-w-[96px] m-0! text-[#646A73] text-sm",
                                                     children: t('safety.tenant.operated', {
-                                                        name: userinfo?.name ?? ''
+                                                        name: tenantName
                                                     })
                                                 })
                                             ]
@@ -233,7 +231,7 @@ const Component = ()=>{
                                                 /*#__PURE__*/ jsx("p", {
                                                     className: "shrink-0 min-w-[96px] m-0! text-[#a6a6a6]",
                                                     children: t('safety.tenant.operated', {
-                                                        name: userinfo?.name ?? ''
+                                                        name: tenantName
                                                     })
                                                 })
                                             ]

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

@@ -1,6 +1,6 @@
 import React from 'react';
 declare const RenderError: React.FC<{
-    error: Error;
-    resetErrorBoundary?: () => void;
+    error: unknown;
+    resetErrorBoundary?: (...args: unknown[]) => void;
 }>;
 export default RenderError;

package/lib/components/ErrorRender/index.js

@@ -3,6 +3,7 @@ import { useEffect } from "react";
 import { logger } from "../../logger/index.js";
 import { getHmrApi } from "../../utils/hmr-api.js";
 import { submitPostMessage } from "../../utils/postMessage.js";
+import { t } from "../../locales/index.js";
 const RenderError = (props)=>{
     const { error, resetErrorBoundary } = props;
     useEffect(()=>{
@@ -46,7 +47,7 @@ const RenderError = (props)=>{
                 }),
                 /*#__PURE__*/ jsx("p", {
                     className: "text-l/[22px] text-[14px] text-[#1F2329] font-medium",
-                    children: "页面出错了"
+                    children: t('errorRender.title')
                 })
             ]
         })

package/lib/components/NotFoundRender/index.js

@@ -2,16 +2,21 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { useLocation } from "react-router-dom";
 import { useEffect } from "react";
 import { logger } from "../../logger/index.js";
+import { t } from "../../locales/index.js";
 const NotFound = ()=>{
     const location = useLocation();
     useEffect(()=>{
         logger.log({
             level: 'error',
             args: [
-                `页面 ${location.pathname} 不存在`
+                t('notFound.logger.pageNotExist', {
+                    path: location.pathname
+                })
             ],
             meta: {
-                repairMessage: `页面 ${location.pathname} 不存在，帮我创建对应页面，并配置到"client/src/app.tsx"路由表中`,
+                repairMessage: t('notFound.logger.repairMessage', {
+                    path: location.pathname
+                }),
                 noStacktrace: true,
                 stacktrace: [],
                 type: 'not-found'
@@ -30,7 +35,7 @@ const NotFound = ()=>{
             }),
             /*#__PURE__*/ jsx("p", {
                 className: "text-l/[22px] text-[14px] text-[#1F2329] font-medium",
-                children: "页面不存在"
+                children: t('notFound.pageNotExist')
             })
         ]
     });

package/lib/components/PagePlaceholder/index.js

@@ -1,6 +1,10 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import "react";
-const PagePlaceholder = ({ title = '页面待开发', description = '页面暂未开发，请耐心等待...' })=>/*#__PURE__*/ jsxs("div", {
+import { t } from "../../locales/index.js";
+const PagePlaceholder_PagePlaceholder = ({ title, description })=>{
+    const defaultTitle = t('pagePlaceholder.title');
+    const defaultDescription = t("pagePlaceholder.description");
+    return /*#__PURE__*/ jsxs("div", {
         className: "flex flex-col items-center justify-center px-6 w-full h-[calc(100vh-64px)] text-center",
         children: [
             /*#__PURE__*/ jsx("img", {
@@ -12,13 +16,14 @@ const PagePlaceholder = ({ title = '页面待开发', description = '页面暂
             }),
             /*#__PURE__*/ jsx("div", {
                 className: "text-center text-foreground text-base font-medium mb-1 leading-6",
-                children: title
+                children: title ?? defaultTitle
             }),
             /*#__PURE__*/ jsx("div", {
                 className: "text-center text-muted-foreground text-base leading-6 line-clamp-2 sm:max-w-[480px]",
-                children: description
+                children: description ?? defaultDescription
             })
         ]
     });
-const components_PagePlaceholder = PagePlaceholder;
-export { components_PagePlaceholder as default };
+};
+const PagePlaceholder = PagePlaceholder_PagePlaceholder;
+export { PagePlaceholder as default };

package/lib/components/User/UserProfile/UserProfileUI.js

@@ -3,6 +3,7 @@ import { useState } from "react";
 import { clsxWithTw } from "../../../utils/utils.js";
 import { getChatAppLink } from "./utils.js";
 import { OverflowTooltipText } from "../../ui/overflow-tooltip-text.js";
+import { t } from "../../../locales/index.js";
 function UserProfileUI({ user }) {
     const [avatarError, setAvatarError] = useState(false);
     const canShowAvatar = Boolean(user.avatar) && !avatarError;
@@ -52,7 +53,7 @@ function UserProfileUI({ user }) {
                                         }),
                                         'inactive' === user.status && /*#__PURE__*/ jsx("span", {
                                             className: "shrink-0 inline-flex items-center rounded-sm bg-destructive px-2 py-0.5 text-xs font-medium text-white",
-                                            children: "暂停使用"
+                                            children: t('userProfile.status.inactive')
                                         })
                                     ]
                                 }),
@@ -75,7 +76,7 @@ function UserProfileUI({ user }) {
                                                     fill: "currentColor"
                                                 })
                                             }),
-                                            "消息"
+                                            t('userProfile.button.message')
                                         ]
                                     })
                                 }) : null
@@ -90,7 +91,7 @@ function UserProfileUI({ user }) {
                                 children: [
                                     /*#__PURE__*/ jsx("span", {
                                         className: "min-w-[74px] text-sm text-muted-foreground",
-                                        children: "部门"
+                                        children: t('userProfile.label.department')
                                     }),
                                     /*#__PURE__*/ jsx("span", {
                                         className: clsxWithTw('flex-1 break-all text-sm text-foreground', {
@@ -105,7 +106,7 @@ function UserProfileUI({ user }) {
                                 children: [
                                     /*#__PURE__*/ jsx("span", {
                                         className: "min-w-[74px] text-sm text-muted-foreground",
-                                        children: "邮箱"
+                                        children: t('userProfile.label.email')
                                     }),
                                     user.email ? /*#__PURE__*/ jsx("a", {
                                         href: `mailto:${user.email}`,

package/lib/components/User/UserSelectUI/UserSelectUI.js

@@ -7,7 +7,9 @@ import { MultipleSelectionTags } from "./MultipleSelectionTags.js";
 import { SingleSelectionPreview } from "./SingleSelectionPreview.js";
 import { ActionButtons } from "./ActionButtons.js";
 import { Dropdown } from "./Dropdown.js";
-const UserSelectUI = ({ mode = 'single', value, onChange, placeholder = '请选择用户', disabled = false, allowClear = true, onSearch, loading = false, options = [] })=>{
+import { t } from "../../../locales/index.js";
+const UserSelectUI = ({ mode = 'single', value, onChange, placeholder, disabled = false, allowClear = true, onSearch, loading = false, options = [] })=>{
+    const defaultPlaceholder = t('userSelect.placeholder');
     const [isOpen, setIsOpen] = useState(false);
     const [searchText, setSearchText] = useState('');
     const [searchResults, setSearchResults] = useState([]);
@@ -135,7 +137,7 @@ const UserSelectUI = ({ mode = 'single', value, onChange, placeholder = '请选
     const singleSelectedUser = 'single' === mode && hasSelection ? selectedUsers[0] : void 0;
     const showSingleSelection = !!singleSelectedUser && 0 === searchText.length;
     const canClear = allowClear && hasSelection && !disabled;
-    const inputPlaceholder = hasSelection ? '' : placeholder;
+    const inputPlaceholder = hasSelection ? '' : placeholder ?? defaultPlaceholder;
     const focusInputAtStart = ()=>{
         const input = inputRef.current;
         if (!input) return;

package/lib/components/ui/confirm.js

@@ -4,11 +4,15 @@ 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";
+import { t } from "../../locales/index.js";
 function showConfirm(options) {
     const opts = 'string' == typeof options ? {
         message: options
     } : options;
-    const { title = '提示', message, confirmText = '确认', cancelText = '取消', variant = 'default' } = opts;
+    const { title, message, confirmText, cancelText, variant = 'default' } = opts;
+    const defaultTitle = t('confirm.title');
+    const defaultConfirmText = t('confirm.confirmText');
+    const defaultCancelText = t('confirm.cancelText');
     return new Promise((resolve)=>{
         const container = document.createElement('div');
         document.body.appendChild(container);
@@ -26,10 +30,10 @@ function showConfirm(options) {
             resolve(false);
         }
         root.render(/*#__PURE__*/ jsx(ConfirmDialog, {
-            title: title,
+            title: title ?? defaultTitle,
             message: message,
-            confirmText: confirmText,
-            cancelText: cancelText,
+            confirmText: confirmText ?? defaultConfirmText,
+            cancelText: cancelText ?? defaultCancelText,
             variant: variant,
             onConfirm: handleConfirm,
             onCancel: handleCancel

package/lib/index.js

@@ -4,6 +4,7 @@ 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 { t } from "./locales/index.js";
 import { version } from "../package.json";
 import { showConfirm } from "./components/ui/confirm.js";
 const _appId = getAppId();
@@ -20,7 +21,7 @@ const capabilityClient = createClient({
     },
     logger: logger,
     onRateLimitError: ()=>{
-        showToast('应用额度已耗尽，请联系应用开发者');
+        showToast(t('index.rateLimitError'));
     }
 });
 const src = {

package/lib/integrations/dataloom.js

@@ -1,7 +1,7 @@
 import { splitWorkspaceUrl } from "../utils/url.js";
 import { createClient } from "@data-loom/js";
 import { getAppId } from "../utils/getAppId.js";
-import { getInitialInfo } from "../utils/getInitialInfo.js";
+import { getAppPublished } from "../utils/getInitialInfo.js";
 const createDataLoomClient = (url, pat)=>{
     const { baseUrl, workspace } = url ? splitWorkspaceUrl(url) : {
         baseUrl: '',
@@ -27,7 +27,7 @@ let pendingPromise = null;
 function getDataloom() {
     if (dataloom) return Promise.resolve(dataloom);
     if (pendingPromise) return pendingPromise;
-    pendingPromise = getInitialInfo().then((info)=>{
+    pendingPromise = getAppPublished().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);

package/lib/locales/messages.js

@@ -25,11 +25,107 @@ const messages_messages = {
     },
     'safety.cover.pc': {
         zh: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover.png',
-        en: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-pcen.png'
+        en: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-weben.png'
     },
     'safety.cover.mobile': {
         zh: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-mobile.png',
-        en: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-weben.png'
+        en: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-mobileen.png'
+    },
+    'index.rateLimitError': {
+        zh: '应用额度已耗尽，请联系应用开发者',
+        en: 'Application quota exhausted, please contact the app developer'
+    },
+    'theme.themeColors.title': {
+        zh: '主题色',
+        en: 'Theme Color'
+    },
+    'theme.themeRadius.title': {
+        zh: '圆角',
+        en: 'Border Radius'
+    },
+    'theme.themeSpaces.title': {
+        zh: '间距',
+        en: 'Spacing'
+    },
+    'errorRender.title': {
+        zh: '页面出错了',
+        en: 'Something went wrong'
+    },
+    'notFound.pageNotExist': {
+        zh: '页面不存在',
+        en: 'Page not found'
+    },
+    'notFound.logger.pageNotExist': {
+        zh: '页面 {path} 不存在',
+        en: 'Page {path} does not exist'
+    },
+    'notFound.logger.repairMessage': {
+        zh: '页面 {path} 不存在，帮我创建对应页面，并配置到"client/src/app.tsx"路由表中',
+        en: 'Page {path} does not exist, help me create the corresponding page and configure it in the "client/src/app.tsx" routing table'
+    },
+    'pagePlaceholder.title': {
+        zh: '页面待开发',
+        en: 'Page coming soon'
+    },
+    "pagePlaceholder.description": {
+        zh: '页面暂未开发，请耐心等待...',
+        en: 'This page is under development, please wait...'
+    },
+    'confirm.title': {
+        zh: '提示',
+        en: 'Confirm'
+    },
+    'confirm.confirmText': {
+        zh: '确认',
+        en: 'Confirm'
+    },
+    'confirm.cancelText': {
+        zh: '取消',
+        en: 'Cancel'
+    },
+    'userSelect.placeholder': {
+        zh: '请选择用户',
+        en: 'Select user'
+    },
+    'userProfile.status.inactive': {
+        zh: '暂停使用',
+        en: 'Inactive'
+    },
+    'userProfile.button.message': {
+        zh: '消息',
+        en: 'Message'
+    },
+    'userProfile.label.department': {
+        zh: '部门',
+        en: 'Department'
+    },
+    'userProfile.label.email': {
+        zh: '邮箱',
+        en: 'Email'
+    },
+    'axios.log.requestSuccess': {
+        zh: '请求成功：',
+        en: 'Request succeeded: '
+    },
+    'axios.log.requestFailed': {
+        zh: '请求失败：',
+        en: 'Request failed: '
+    },
+    'axios.log.networkFailed': {
+        zh: '网络请求失败：',
+        en: 'Network request failed: '
+    },
+    'axios.log.noResponseOrConfig': {
+        zh: '请求失败：无响应对象或配置信息',
+        en: 'Request failed: no response object or config'
+    },
+    'axios.log.forbidden': {
+        zh: '请求被拒绝(403)：{method} {url}',
+        en: 'Request rejected (403): {method} {url}'
+    },
+    'axios.log.unknownError': {
+        zh: '未知错误',
+        en: 'Unknown error'
     }
 };
 const messages = messages_messages;

package/lib/utils/axiosConfig.js

@@ -5,6 +5,7 @@ import { getStacktrace } from "../logger/selected-logs.js";
 import { safeStringify } from "./safeStringify.js";
 import { slardar } from "@lark-apaas/internal-slardar";
 import { normalizeBasePath } from "./utils.js";
+import { t } from "../locales/index.js";
 const APP_CLIENT_API_LOG_TYPE = 'app_client_api_log';
 function stripBasePath(urlPath) {
     const base = normalizeBasePath(process.env.CLIENT_BASE_PATH);
@@ -95,8 +96,8 @@ async function logResponse(ok, responseOrError) {
     if (isValidResponse(responseOrError)) {
         const response = responseOrError;
         const okToTextMap = {
-            success: '请求成功：',
-            error: '请求失败：'
+            success: t('axios.log.requestSuccess'),
+            error: t('axios.log.requestFailed')
         };
         const realOK = 'success' === ok && response.status >= 200 && response.status < 300;
         const method = (response.config.method || 'GET').toUpperCase();
@@ -154,13 +155,13 @@ async function logResponse(ok, responseOrError) {
     const error = responseOrError;
     if (error && error.config && 'object' == typeof error.config) {
         const errorType = error.code || 'UNKNOWN_ERROR';
-        const errorMessage = error.message || '未知错误';
+        const errorMessage = error.message || t('axios.log.unknownError');
         const method = (error.config.method || 'GET').toUpperCase();
         const url = error.config.url || '';
         const startTime = error.config._startTime;
         const duration = startTime ? Date.now() - startTime : 0;
         const parts = [
-            '网络请求失败：',
+            t('axios.log.networkFailed'),
             method,
             ' ',
             url.split('?')[0].replace(/^\/spark\/p\/app_\w+/, ''),
@@ -210,7 +211,7 @@ async function logResponse(ok, responseOrError) {
     logger.log({
         level: 'error',
         args: [
-            '请求失败：无响应对象或配置信息'
+            t('axios.log.noResponseOrConfig')
         ],
         meta: {}
     });
@@ -360,7 +361,10 @@ function initAxiosConfig(axiosInstance) {
                 logger.log({
                     level: 'warn',
                     args: [
-                        `请求被拒绝(403)：${method} ${url}`,
+                        t('axios.log.forbidden', {
+                            method,
+                            url
+                        }),
                         {
                             状态码: 403,
                             返回数据: error.response.data

package/lib/utils/getInitialInfo.d.ts

@@ -13,6 +13,13 @@ interface AppRuntimePublished {
 interface BucketConfig {
     default_bucket_id?: string;
 }
+/**
+ * 从API获取已发布的应用信息（仅全栈沙箱模式下使用）
+ */
+export declare function getAppPublished(): Promise<{
+    app_info?: AppRuntimePublished;
+    app_runtime_extra?: AppRuntimeExtra;
+} | undefined>;
 declare let initialInfo: {
     app_info?: AppRuntimePublished;
     app_runtime_extra?: AppRuntimeExtra;

package/lib/utils/getInitialInfo.js

@@ -1,6 +1,11 @@
 import { getAppId } from "./getAppId.js";
 import { getCsrfToken } from "./getCsrfToken.js";
 import { isNewPathEnabled } from "./apiPath.js";
+function syncBucketIdToWindow(info) {
+    if (!info) return;
+    const bucketId = info.app_runtime_extra?.bucket?.default_bucket_id;
+    if (bucketId) window._bucket_id = bucketId;
+}
 async function getAppPublished() {
     try {
         const headers = {
@@ -18,24 +23,40 @@ async function getAppPublished() {
             credentials: 'include'
         });
         const res = await response.json();
-        if (0 === res.code || '0' === res.status_code) return res.data;
+        if (0 === res.code || '0' === res.status_code) {
+            syncBucketIdToWindow(res.data);
+            return res.data;
+        }
         console.error('Error fetching published app info:', res);
     } catch (error) {
         console.error('Error fetching published app info:', error);
     }
 }
+function getPreloadedInfo() {
+    try {
+        const platformData = window.__platform__?.appPublished;
+        if (platformData && 'object' == typeof platformData) return platformData;
+    } catch  {}
+}
 let initialInfo;
 let pendingPromise = null;
 function getInitialInfo(refresh = false) {
     if (initialInfo && !refresh) return Promise.resolve(initialInfo);
+    if (!initialInfo && !refresh) {
+        const preloaded = getPreloadedInfo();
+        if (preloaded) {
+            initialInfo = preloaded;
+            syncBucketIdToWindow(initialInfo);
+            return Promise.resolve(initialInfo);
+        }
+    }
     if (pendingPromise && !refresh) return pendingPromise;
     pendingPromise = getAppPublished().then((info)=>{
         initialInfo = info;
-        if (initialInfo) window._bucket_id = initialInfo.app_runtime_extra?.bucket?.default_bucket_id;
         return initialInfo;
     }).finally(()=>{
         pendingPromise = null;
     });
     return pendingPromise;
 }
-export { getInitialInfo };
+export { getAppPublished, getInitialInfo };

package/lib/utils/locale.d.ts

@@ -1,9 +1,17 @@
 /**
  * 统一的语言判断方法。
  *
- * 基于浏览器 Accept-Language（navigator.language）判断。
- * 返回标准化的 locale code：'zh' | 'en'。
- * 目前只区分中英文，未来需要更多语言时在此扩展。
+ * 生产环境（`process.env.NODE_ENV === 'production'`）：
+ *   只看浏览器容器语言（navigator.language）。
+ *
+ * 非生产环境（沙箱预览场景）：
+ *   优先级 query > localStorage > navigator。
+ *   URL query `locale`（值为 `zh_CN` / `en_US`）由宿主平台（miaoda）
+ *   通过 iframe src 透传，确保产物内的语言与宿主一致；
+ *   读到 query 时会同步写入 localStorage，便于后续无 query 的跳转/刷新场景使用。
+ *
+ * 返回标准化 locale code：'zh' | 'en'。
+ * 目前只区分中英文，未来扩展时在此调整。
  */
 export type Locale = 'zh' | 'en';
 export declare function getLocale(): Locale;

package/lib/utils/locale.js

@@ -1,5 +1,41 @@
+const STORAGE_KEY = 'miaoda:preview-locale';
+function toLocale(value) {
+    const lang = value ?? 'zh';
+    return lang.toLowerCase().startsWith('zh') ? 'zh' : 'en';
+}
+function readLocaleFromQuery() {
+    if ('undefined' == typeof window) return null;
+    try {
+        const value = new URLSearchParams(window.location.search).get('locale');
+        return value && value.length > 0 ? value : null;
+    } catch  {
+        return null;
+    }
+}
+function readLocaleFromStorage() {
+    if ('undefined' == typeof window) return null;
+    try {
+        const value = window.localStorage?.getItem(STORAGE_KEY);
+        return value && value.length > 0 ? value : null;
+    } catch  {
+        return null;
+    }
+}
+function writeLocaleToStorage(value) {
+    if ('undefined' == typeof window) return;
+    try {
+        window.localStorage?.setItem(STORAGE_KEY, value);
+    } catch  {}
+}
 function getLocale() {
-    const lang = navigator.language || 'zh';
-    return lang.startsWith('zh') ? 'zh' : 'en';
+    if ('production' === process.env.NODE_ENV) return toLocale(navigator.language);
+    const fromQuery = readLocaleFromQuery();
+    if (fromQuery) {
+        writeLocaleToStorage(fromQuery);
+        return toLocale(fromQuery);
+    }
+    const fromStorage = readLocaleFromStorage();
+    if (fromStorage) return toLocale(fromStorage);
+    return toLocale(navigator.language);
 }
 export { getLocale };

package/package.json

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