@lark-apaas/miaoda-core 0.0.1-alpha.1

package/lib/utils/copyToClipboard.js

@@ -0,0 +1,32 @@
+async function copyToClipboard(text) {
+    try {
+        if (navigator.clipboard && window.isSecureContext) {
+            await navigator.clipboard.writeText(text);
+            return true;
+        }
+        return fallbackCopyToClipboard(text);
+    } catch (error) {
+        console.error('复制到剪切板失败:', error);
+        return false;
+    }
+}
+function fallbackCopyToClipboard(text) {
+    try {
+        const textArea = document.createElement('textarea');
+        textArea.value = text;
+        textArea.style.position = 'fixed';
+        textArea.style.left = '-999999px';
+        textArea.style.top = '-999999px';
+        textArea.setAttribute('readonly', '');
+        document.body.appendChild(textArea);
+        textArea.focus();
+        textArea.select();
+        const successful = document.execCommand('copy');
+        document.body.removeChild(textArea);
+        return successful;
+    } catch (error) {
+        console.error('降级复制方案失败:', error);
+        return false;
+    }
+}
+export { copyToClipboard };

package/lib/utils/getAppId.d.ts

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

package/lib/utils/getAppId.js

@@ -0,0 +1,11 @@
+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/';
+    if (!path.startsWith(prefix)) return null;
+    const remainder = path.substring(prefix.length);
+    const nextSlashIndex = remainder.indexOf('/');
+    if (-1 === nextSlashIndex) return remainder;
+    return remainder.substring(0, nextSlashIndex);
+}
+export { getAppId };

package/lib/utils/getCsrfToken.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 获取cookie中存放的suda-csrf-token值
+ * @returns {string | null} - suda-csrf-token的值，如果不存在则返回null
+ */
+export declare function getCsrfToken(): string;

package/lib/utils/getCsrfToken.js

@@ -0,0 +1,10 @@
+function getCsrfToken() {
+    const cookieName = 'suda-csrf-token';
+    const cookies = document.cookie.split('; ');
+    for (const cookie of cookies){
+        const [name, value] = cookie.split('=');
+        if (name === cookieName) return decodeURIComponent(value);
+    }
+    return window.csrfToken ?? null;
+}
+export { getCsrfToken };

package/lib/utils/getEnvPath.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @internal
+ */
+export declare function getEnvPath(): "feida_preview" | "feida_runtime";

package/lib/utils/getEnvPath.js

@@ -0,0 +1,4 @@
+function getEnvPath() {
+    return window.IS_MIAODA_PREVIEW ? 'feida_preview' : 'feida_runtime';
+}
+export { getEnvPath };

package/lib/utils/getInitialInfo.d.ts

@@ -0,0 +1,20 @@
+interface AppRuntimeExtra {
+    token?: string;
+    url?: string;
+    bucket?: BucketConfig;
+}
+interface AppRuntimePublished {
+    app_name?: string;
+    css_urls?: string[];
+    js_urls?: string[];
+    app_avatar?: string;
+}
+interface BucketConfig {
+    default_bucket_id?: string;
+}
+/** 获取应用初始化信息（仅全栈沙箱模式下使用） */
+export declare function getInitialInfo(): Promise<{
+    app_info?: AppRuntimePublished;
+    app_runtime_extra?: AppRuntimeExtra;
+}>;
+export {};

package/lib/utils/getInitialInfo.js

@@ -0,0 +1,32 @@
+import { getAppId } from "./getAppId.js";
+import { getCsrfToken } from "./getCsrfToken.js";
+async function getAppPublished() {
+    try {
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-Kunlun-Token': window.token,
+            '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 response = await fetch(url, {
+            method: 'GET',
+            headers,
+            credentials: 'include'
+        });
+        const res = await response.json();
+        if (0 === res.code) return res.data;
+        console.error('Error fetching published app info:', res);
+    } catch (error) {
+        console.error('Error fetching published app info:', error);
+    }
+}
+let initialInfo;
+async function getInitialInfo() {
+    if (initialInfo) return initialInfo;
+    initialInfo = await getAppPublished();
+    if (initialInfo) window._bucket_id = initialInfo.app_runtime_extra?.bucket?.default_bucket_id;
+    return initialInfo;
+}
+export { getInitialInfo };

package/lib/utils/getParentOrigin.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @internal
+ * 获取预览环境父级域名
+ */
+export declare function getPreviewParentOrigin(): "https://miaoda.feishu.cn" | "https://miaoda.feishu-pre.cn" | "https://miaoda.feishu-boe.cn";

package/lib/utils/getParentOrigin.js

@@ -0,0 +1,7 @@
+function getPreviewParentOrigin() {
+    const { origin } = window.location;
+    if (origin.includes('feishuapp.cn') || origin.includes('miaoda.feishuapp.net')) return 'https://miaoda.feishu.cn';
+    if (origin.includes('fsapp.kundou.cn') || origin.includes('miaoda-pre.feishuapp.net')) return 'https://miaoda.feishu-pre.cn';
+    return 'https://miaoda.feishu-boe.cn';
+}
+export { getPreviewParentOrigin };

package/lib/utils/getUserProfile.d.ts

@@ -0,0 +1,47 @@
+export interface GetUserProfileRequest {
+    userID?: string;
+}
+interface I18nText {
+    text: string;
+    language_code: number;
+}
+export interface UserProfile {
+    userID?: string;
+    email?: string;
+    name?: I18nText[];
+    avatar?: string;
+    departmentName?: I18nText[];
+    /**
+     * 1 正常
+     * 2 已暂停
+     */
+    status?: 1 | 2;
+    feishuOpenID?: string;
+    userType?: string;
+}
+export interface GetUserProfileResponse {
+    userProfile?: UserProfile;
+    code?: number;
+    msg?: string;
+}
+/**
+ * @internal
+ * 获取用户资料
+ *
+ * 使用示例:
+ * ```typescript
+ * const response = await getUserProfile({
+ *   userID: 12345,
+ * });
+ *
+ * if (response.userProfile) {
+ *   console.log('User name:', response.userProfile.name);
+ * }
+ * ```
+ *
+ * @param request - 用户资料请求参数
+ * @param headers - 额外的请求头
+ * @returns 用户资料响应
+ */
+export declare function getUserProfile(request: GetUserProfileRequest, headers?: Record<string, string>): Promise<any>;
+export {};

package/lib/utils/getUserProfile.js

@@ -0,0 +1,39 @@
+import { getAppId } from "./getAppId.js";
+import { getCsrfToken } from "./getCsrfToken.js";
+import { getEnvPath } from "./getEnvPath.js";
+import { isSparkRuntime } from "./utils.js";
+async function getUserProfile(request, headers = {}) {
+    const appId = getAppId(window.location.pathname);
+    if (!appId) return {
+        code: 1,
+        msg: 'appId is required',
+        userProfile: {}
+    };
+    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 || {}
+    };
+    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 response = await fetch(`${window.location.origin}${endpoint}`, {
+        method: 'POST',
+        headers: mergedHeaders,
+        credentials: 'include',
+        body: JSON.stringify({
+            userID: request.userID
+        })
+    });
+    return await response.json();
+}
+export { getUserProfile };

package/lib/utils/postMessage.d.ts

@@ -0,0 +1,8 @@
+import type { IncomingMessage, OutgoingMessage } from '../types/iframe-events';
+export declare function postMessage<T extends OutgoingMessage>(message: T, targetOrigin?: string): void;
+export declare function isOutgoingMessage<T extends OutgoingMessage['type']>(msg: OutgoingMessage, type: T): msg is Extract<OutgoingMessage, {
+    type: T;
+}>;
+export declare function isIncomingMessage<T extends IncomingMessage['type']>(msg: IncomingMessage, type: T): msg is Extract<IncomingMessage, {
+    type: T;
+}>;

package/lib/utils/postMessage.js

@@ -0,0 +1,11 @@
+import { getPreviewParentOrigin } from "./getParentOrigin.js";
+function postMessage(message, targetOrigin) {
+    window.parent.postMessage(message, targetOrigin ?? getPreviewParentOrigin());
+}
+function isOutgoingMessage(msg, type) {
+    return msg.type === type;
+}
+function isIncomingMessage(msg, type) {
+    return msg.type === type;
+}
+export { isIncomingMessage, isOutgoingMessage, postMessage };

package/lib/utils/url.d.ts

@@ -0,0 +1,8 @@
+export interface UrlParts {
+    baseUrl: string;
+    workspace: string;
+}
+/**
+ * @internal
+ */
+export declare function splitWorkspaceUrl(fullUrl: string): UrlParts;

package/lib/utils/url.js

@@ -0,0 +1,22 @@
+import { logger } from "../logger/index.js";
+function splitWorkspaceUrl(fullUrl) {
+    try {
+        const url = new URL(fullUrl);
+        const pathParts = url.pathname.split('/');
+        const workspacesIndex = pathParts.findIndex((part)=>'workspaces' === part);
+        if (-1 === workspacesIndex) throw new Error('Invalid workspace URL format');
+        const basePathParts = pathParts.slice(0, workspacesIndex);
+        const workspace = pathParts[workspacesIndex + 1];
+        return {
+            baseUrl: `${url.origin}${basePathParts.join('/')}`,
+            workspace
+        };
+    } catch (error) {
+        logger.error('Error splitting workspace URL:', error);
+    }
+    return {
+        baseUrl: fullUrl,
+        workspace: 'workspace'
+    };
+}
+export { splitWorkspaceUrl };

package/lib/utils/utils.d.ts

@@ -0,0 +1,20 @@
+import { type ClassValue } from 'clsx';
+/**
+ * @internal
+ * 处理 className 与 tailwind-merge
+ */
+export declare function clsxWithTw(...inputs: ClassValue[]): string;
+/**
+ * @internal
+ * 当前是否是预览态
+ */
+export declare function isPreview(): boolean;
+/**
+ * @internal
+ * 标准化基础路径，确保路径格式一致
+ * 移除末尾的斜杠，确保路径不以斜杠结尾
+ */
+export declare function normalizeBasePath(basePath?: string): string;
+export declare function getWsPath(): string;
+/** 判断是否是沙箱模式 */
+export declare function isSparkRuntime(): boolean;

package/lib/utils/utils.js

@@ -0,0 +1,22 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+function clsxWithTw(...inputs) {
+    return twMerge(clsx(inputs));
+}
+function isPreview() {
+    return window.IS_MIAODA_PREVIEW;
+}
+function normalizeBasePath(basePath) {
+    if (!basePath || '/' === basePath) return '';
+    return basePath.replace(/\/+$/, '');
+}
+function getWsPath() {
+    const rawBasePath = process.env.CLIENT_BASE_PATH || '/';
+    const normalizedBasePath = rawBasePath.startsWith('/') ? rawBasePath : `/${rawBasePath}`;
+    const basePathWithoutTrailingSlash = normalizedBasePath.endsWith('/') ? normalizedBasePath.slice(0, -1) : normalizedBasePath;
+    return `${basePathWithoutTrailingSlash}/ws`;
+}
+function isSparkRuntime() {
+    return window._IS_Spark_RUNTIME ?? 'fullstack' === process.env.runtimeMode;
+}
+export { clsxWithTw, getWsPath, isPreview, isSparkRuntime, normalizeBasePath };

package/package.json

@@ -0,0 +1,134 @@
+{
+  "name": "@lark-apaas/miaoda-core",
+  "version": "0.0.1-alpha.1",
+  "types": "./lib/index.d.ts",
+  "main": "./lib/index.js",
+  "files": [
+    "lib"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./lib/index.js",
+      "require": "./lib/index.js",
+      "types": "./lib/index.d.ts"
+    },
+    "./lib/index.css": "./lib/index.css",
+    "./dataloom": {
+      "import": "./lib/apis/dataloom.js",
+      "require": "./lib/apis/dataloom.js",
+      "types": "./lib/apis/dataloom.d.ts"
+    },
+    "./logger": {
+      "import": "./lib/apis/logger.js",
+      "require": "./lib/apis/logger.js",
+      "types": "./lib/apis/logger.d.ts"
+    },
+    "./udt-types": {
+      "import": "./lib/apis/udt-types.js",
+      "require": "./lib/apis/udt-types.js",
+      "types": "./lib/apis/udt-types.d.ts"
+    },
+    "./components/*": {
+      "import": "./lib/apis/components/*.js",
+      "require": "./lib/apis/components/*.js",
+      "types": "./lib/apis/components/*.d.ts"
+    },
+    "./constants/*": {
+      "import": "./lib/apis/constants/**/*.js",
+      "require": "./lib/apis/constants/**/*.js",
+      "types": "./lib/apis/constants/**/*.d.ts"
+    },
+    "./hooks/*": {
+      "import": "./lib/apis/hooks/*.js",
+      "require": "./lib/apis/hooks/*.js",
+      "types": "./lib/apis/hooks/*.d.ts"
+    },
+    "./tools/*": {
+      "import": "./lib/apis/tools/*.js",
+      "require": "./lib/apis/tools/*.js",
+      "types": "./lib/apis/tools/*.d.ts"
+    },
+    "./utils/*": {
+      "import": "./lib/apis/utils/*.js",
+      "require": "./lib/apis/utils/*.js",
+      "types": "./lib/apis/utils/*.d.ts"
+    }
+  },
+  "scripts": {
+    "tsc": "tsc --declaration",
+    "build": "rslib build",
+    "build:storybook": "storybook build",
+    "bump": "changeset version",
+    "change": "changeset",
+    "check": "biome check --write",
+    "dev": "rslib build --watch",
+    "format": "biome format --write",
+    "storybook": "storybook dev",
+    "test": "echo 0",
+    "lint": "eslint src --ext .js,.jsx,.ts,.tsx",
+    "lint:fix": "eslint src --ext .js,.jsx,.ts,.tsx --fix",
+    "prepublishOnly": "npm run build && node scripts/replace-workspace-alias.js"
+  },
+  "dependencies": {
+    "@ant-design/colors": "^7.2.1",
+    "@ant-design/cssinjs": "^1.24.0",
+    "@data-loom/js": "0.3.1",
+    "@lark-apaas/miaoda-inspector": "0.1.0-alpha.8",
+    "clsx": "~2.0.1",
+    "dayjs": "^1.11.13",
+    "echarts": "^6.0.0",
+    "html2canvas-pro": "^1.5.11",
+    "lodash": "^4.17.21",
+    "penpal": "^6.2.2",
+    "sockjs-client": "^1.6.1",
+    "sonner": "~2.0.0",
+    "tailwind-merge": "~2.0.0",
+    "tailwind-variants": "0.3.1",
+    "tailwindcss-animate": "^1.0.7"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.0.6",
+    "@changesets/cli": "^2.29.5",
+    "@rsbuild/core": "~1.4.13",
+    "@rsbuild/plugin-react": "^1.3.4",
+    "@rslib/core": "^0.15.0",
+    "@storybook/addon-essentials": "^8.6.14",
+    "@storybook/addon-interactions": "^8.6.14",
+    "@storybook/addon-links": "^8.6.14",
+    "@storybook/addon-onboarding": "^8.6.14",
+    "@storybook/blocks": "^8.6.14",
+    "@storybook/react": "^8.6.14",
+    "@storybook/test": "^8.6.14",
+    "@testing-library/jest-dom": "^6.6.4",
+    "@testing-library/react": "^16.3.0",
+    "@types/lodash": "^4.17.20",
+    "@types/node": "^22.10.2",
+    "@types/react": "^18.3.23",
+    "@types/react-dom": "^18.3.7",
+    "@types/sockjs-client": "^1",
+    "antd": "^5.26.6",
+    "eslint": "^8.57.0",
+    "jsdom": "^26.1.0",
+    "lucide-react": "npm:@lark-apaas/lucide-react@0.1.0-alpha.5",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.26.2",
+    "storybook": "^8.6.14",
+    "storybook-addon-rslib": "^1.0.2",
+    "storybook-react-rsbuild": "^1.0.2",
+    "tailwindcss": "^4.1.13",
+    "tsc-watch": "^7.1.1",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.41.0",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "antd": ">=5.26.6",
+    "react": ">=16.14.0",
+    "react-dom": ">=16.14.0",
+    "react-router-dom": ">=6.26.2"
+  }
+}