@lark-apaas/client-toolkit 1.2.9-beta.3 → 1.2.9-beta.31

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

@@ -10,16 +10,20 @@
  * - abort: An update was aborted, but the system is still in its previous state
  * - fail: An update has thrown an exception and the system's state has been compromised
  */
-type ModuleHotType = 'idle' | 'check' | 'prepare' | 'ready' | 'dispose' | 'apply' | 'abort' | 'fail';
-interface ModuleHotInstance {
+export type ModuleHotType = 'idle' | 'check' | 'prepare' | 'ready' | 'dispose' | 'apply' | 'abort' | 'fail';
+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;
-export {};

package/lib/utils/module-hot.js

@@ -1,22 +1,21 @@
 function getModuleHot() {
     if ('production' === process.env.NODE_ENV) return null;
-    return import.meta.webpackHot || module.hot;
+    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/postMessage.js

@@ -1,3 +1,19 @@
+const PARENT_ORIGIN_KEY = '__parentOrigin';
+function getParentOriginFromParams() {
+    try {
+        const params = new URLSearchParams(window.location.search);
+        const origin = params.get(PARENT_ORIGIN_KEY);
+        if (origin) {
+            sessionStorage.setItem(PARENT_ORIGIN_KEY, origin);
+            return origin;
+        }
+    } catch  {}
+    try {
+        return sessionStorage.getItem(PARENT_ORIGIN_KEY) || void 0;
+    } catch  {
+        return;
+    }
+}
 function getLegacyParentOrigin() {
     const { origin } = window.location;
     if (origin.includes('force.feishuapp.net')) return 'https://force.feishu.cn';
@@ -8,6 +24,8 @@ function getLegacyParentOrigin() {
     return 'https://miaoda.feishu-boe.cn';
 }
 function resolveParentOrigin() {
+    const paramOrigin = getParentOriginFromParams();
+    if (paramOrigin) return paramOrigin;
     return process.env?.FORCE_FRAMEWORK_DOMAIN_MAIN ?? getLegacyParentOrigin();
 }
 function submitPostMessage(message, targetOrigin) {

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

@@ -0,0 +1,27 @@
+/**
+ * 解析应用内路径，自动补全 CLIENT_BASE_PATH 前缀，返回完整 URL
+ * 适用于生成分享链接、二维码等需要完整 URL 的场景
+ *
+ * - 相对路径：补全前缀 + 当前域名
+ * - 当前域名的完整 URL：修正路径部分，补全前缀
+ * - 其他域名的 URL：原样返回，不做处理
+ *
+ * @param path - 应用内相对路径或完整 URL
+ * @returns 完整的 URL 字符串
+ *
+ * @example
+ * // 假设 CLIENT_BASE_PATH = '/app/abc'，当前域名为 https://example.com
+ *
+ * resolveAppUrl('/detail/123')
+ * // => 'https://example.com/app/abc/detail/123'
+ *
+ * resolveAppUrl('https://example.com/detail/123')
+ * // => 'https://example.com/app/abc/detail/123'
+ *
+ * resolveAppUrl('https://example.com/app/abc/detail/123')
+ * // => 'https://example.com/app/abc/detail/123' (已有前缀，不重复添加)
+ *
+ * resolveAppUrl('https://other-site.com/page')
+ * // => 'https://other-site.com/page' (非当前域名，原样返回)
+ */
+export declare function resolveAppUrl(path: string): string;

package/lib/utils/resolveAppUrl.js

@@ -0,0 +1,19 @@
+import { normalizeBasePath } from "./utils.js";
+function ensureBasePath(pathname, basePath) {
+    if (!basePath) return pathname;
+    if (pathname.startsWith(basePath)) return pathname;
+    return `${basePath}${pathname.startsWith('/') ? '' : '/'}${pathname}`;
+}
+function resolveAppUrl(path) {
+    const basePath = normalizeBasePath(process.env.CLIENT_BASE_PATH);
+    try {
+        const url = new URL(path);
+        if (url.origin !== window.location.origin) return path;
+        url.pathname = ensureBasePath(url.pathname, basePath);
+        return url.toString();
+    } catch  {}
+    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+    const resolvedPath = ensureBasePath(normalizedPath, basePath);
+    return `${window.location.origin}${resolvedPath}`;
+}
+export { resolveAppUrl };

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.9-beta.3",
+  "version": "1.2.9-beta.31",
   "types": "./lib/index.d.ts",
   "main": "./lib/index.js",
   "files": [
@@ -71,6 +71,11 @@
       "require": "./lib/apis/utils/*.js",
       "types": "./lib/apis/utils/*.d.ts"
     },
+    "./aily-chat": {
+      "import": "./lib/apis/aily-chat.js",
+      "require": "./lib/apis/aily-chat.js",
+      "types": "./lib/apis/aily-chat.d.ts"
+    },
     "./auth": {
       "import": "./lib/auth.js",
       "require": "./lib/auth.js",
@@ -93,11 +98,12 @@
   "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-beta.3",
-    "@lark-apaas/miaoda-inspector": "^1.0.13",
-    "@lark-apaas/observable-web": "^1.0.1",
+    "@data-loom/js": "0.4.9",
+    "@lark-apaas/aily-web-sdk": "0.0.2-beta.8",
+    "@lark-apaas/auth-sdk": "0.1.0-beta.2",
+    "@lark-apaas/client-capability": "0.1.3-beta.7",
+    "@lark-apaas/miaoda-inspector": "^1.0.16",
+    "@lark-apaas/observable-web": "1.0.1-beta.3",
     "@radix-ui/react-avatar": "^1.1.10",
     "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-slot": "^1.2.3",

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/components/theme/ui-config.d.ts

@@ -1 +0,0 @@
-export { defaultUIConfig, type UIComponentConfig, } from '@lark-apaas/miaoda-inspector';

package/lib/components/theme/ui-config.js

@@ -1,2 +0,0 @@
-import { defaultUIConfig } from "@lark-apaas/miaoda-inspector";
-export { defaultUIConfig };

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