@lark-apaas/aily-web-sdk 0.0.2-alpha.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/device-detector.ts","../src/message-bridge.ts","../src/iframe-manager.ts"],"sourcesContent":["/*\n * index.ts\n * Author: perterpon.wang<perterpon.wang@bytedance.com>\n * Create: Tue Feb 10 2026\n */\n\nimport { IframeManager } from './iframe-manager';\n\nimport type { ChatPanel, WebSDKConfig } from './types/config';\n\n/**\n * Initialize Aily Chat via iframe\n * This is the primary method for initializing the chat panel\n * @param root - Container element for the iframe\n * @param config - Configuration options\n * @returns ChatPanel instance for controlling the chat\n */\nexport async function initAilyChat(root: HTMLElement, config: WebSDKConfig): Promise<ChatPanel> {\n  const manager = new IframeManager(root, config);\n  return manager.init();\n}\n\n// Export types\nexport type {\n  ChatPanel,\n  WebSDKConfig,\n  WebSDKCommonConfig,\n  WebSDKConversionConfig,\n  WebSDKEditorConfig,\n  WebSDKEvents,\n} from './types/config';\n\n// Export constants\nexport { getIframeBaseURL, IFRAME_BASE_URL, MESSAGE_TIMEOUT } from './constants';\n\n// Export message types\nexport type {\n  IframeMessageType,\n  IframeRequestMessage,\n  IframeResponseMessage,\n  IframeEventMessage,\n  IframeMessage,\n} from './types/message';\n","/**\n * Constants for Aily Web SDK\n */\n\n/** Message business ID for postMessage identification */\nexport const MESSAGE_BIZ_ID = 'cui-sdk-message' as const;\n\n/** Iframe base URLs by environment */\nexport const IFRAME_BASE_URL: Record<string, string> = {\n  production: 'https://aily.feishu.cn/cui',\n  staging: 'https://aily.feishu-pre.cn/cui',\n  boe: 'https://aily.feishu-boe.cn/cui',\n  development: 'http://localhost:8080/cui',\n};\n\n/**\n * Get iframe base URL based on environment\n */\nexport function getIframeBaseURL(env?: string): string {\n  if (env && IFRAME_BASE_URL[env]) {\n    return IFRAME_BASE_URL[env];\n  }\n\n  // Auto-detect based on hostname\n  // MiaoDa 宿主域名: miaoda.feishu[-env].cn, *.aiforce[-env][-preview].bytedance.net, *.aiforce.run, *.aiforce.cloud\n  const hostname = typeof window !== 'undefined' ? window.location.hostname : '';\n\n  if (hostname.includes('aiforce-boe')) {\n    return IFRAME_BASE_URL.boe;\n  }\n  if (hostname.includes('aiforce-pre')) {\n    return IFRAME_BASE_URL.staging;\n  }\n  if (hostname.includes('localhost') || hostname.includes('127.0.0.1')) {\n    return IFRAME_BASE_URL.development;\n  }\n\n  return IFRAME_BASE_URL.production;\n}\n\n/** Timeout for postMessage requests (30 seconds) */\nexport const MESSAGE_TIMEOUT = 30 * 1000;\n\n/** Miaoda 渠道标识（本 SDK 为 Miaoda 专用包，不允许外部自定义） */\nexport const CHANNEL_TYPE = 'MIAODA_CUI_SDK';\nexport const ANONYMOUS_CHANNEL_TYPE = 'MIAODA_ANONYMOUS_CUI_SDK';\n\n/** Allowed origins for postMessage (cui-iframe 的 origin) */\nexport const ALLOWED_ORIGINS = [\n  'https://aily.feishu.cn',\n  'https://aily.feishu-pre.cn',\n  'https://aily.feishu-boe.cn',\n  'http://localhost:3000',\n  'http://localhost:5173',\n  'http://localhost:8080',\n];\n","const MOBILE_BREAKPOINT = 768;\n\ntype DeviceType = 'pc' | 'mobile';\ntype DeviceChangeCallback = (device: DeviceType) => void;\n\n/**\n * 设备类型自动检测器\n *\n * 使用 matchMedia + 768px 断点检测设备类型，与 miaoda useIsMobile 逻辑一致。\n * 检测在宿主页面（而非 iframe）中执行，结果通过 postMessage 推送给 iframe。\n */\nexport class DeviceDetector {\n  private mediaQuery: MediaQueryList;\n  private currentDevice: DeviceType;\n  private callback: DeviceChangeCallback | null = null;\n  private handleChange: (() => void) | null = null;\n\n  constructor() {\n    this.mediaQuery = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);\n    this.currentDevice = window.innerWidth < MOBILE_BREAKPOINT ? 'mobile' : 'pc';\n  }\n\n  getDevice(): DeviceType {\n    return this.currentDevice;\n  }\n\n  observe(callback: DeviceChangeCallback): void {\n    this.callback = callback;\n    this.handleChange = () => {\n      const newDevice: DeviceType = window.innerWidth < MOBILE_BREAKPOINT ? 'mobile' : 'pc';\n      if (newDevice !== this.currentDevice) {\n        this.currentDevice = newDevice;\n        this.callback?.(newDevice);\n      }\n    };\n    this.mediaQuery.addEventListener('change', this.handleChange);\n  }\n\n  destroy(): void {\n    if (this.handleChange) {\n      this.mediaQuery.removeEventListener('change', this.handleChange);\n      this.handleChange = null;\n    }\n    this.callback = null;\n  }\n}\n","import { MESSAGE_TIMEOUT, ALLOWED_ORIGINS } from './constants';\nimport {\n  MESSAGE_BIZ_ID,\n  type IframeMessage,\n  type IframeRequestMessage,\n  type IframeResponseMessage,\n  type IframeEventMessage,\n  type IframeMessageType,\n} from './types/message';\n\ninterface PendingRequest {\n  resolve: (value: unknown) => void;\n  reject: (reason: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n}\n\n/**\n * MessageBridge handles postMessage communication between parent and iframe\n */\nexport class MessageBridge {\n  private iframe: HTMLIFrameElement | null = null;\n  private requestId = 0;\n  private pendingRequests = new Map<number, PendingRequest>();\n  private eventHandlers = new Map<string, ((data: unknown) => void)[]>();\n  private targetOrigin: string;\n\n  constructor(targetOrigin: string) {\n    this.targetOrigin = targetOrigin;\n    this.handleMessage = this.handleMessage.bind(this);\n  }\n\n  /**\n   * Attach to an iframe and start listening for messages\n   */\n  attach(iframe: HTMLIFrameElement): void {\n    this.iframe = iframe;\n    window.addEventListener('message', this.handleMessage);\n  }\n\n  /**\n   * Detach from iframe and clean up\n   */\n  detach(): void {\n    window.removeEventListener('message', this.handleMessage);\n    this.iframe = null;\n    // Clear all pending requests\n    this.pendingRequests.forEach(({ reject }) => {\n      reject(new Error('MessageBridge detached'));\n    });\n    this.pendingRequests.clear();\n  }\n\n  /**\n   * Send a message to the iframe and wait for response\n   */\n  send<T = unknown>(type: IframeMessageType, data?: unknown): Promise<T> {\n    return new Promise((resolve, reject) => {\n      if (!this.iframe?.contentWindow) {\n        reject(new Error('Iframe not attached'));\n        return;\n      }\n\n      this.requestId += 1;\n      const id = this.requestId;\n      const message: IframeRequestMessage = {\n        messageBizId: MESSAGE_BIZ_ID,\n        id,\n        type,\n        data,\n        timestamp: Date.now(),\n        isRequest: true,\n      };\n\n      const timer = setTimeout(() => {\n        this.pendingRequests.delete(id);\n        reject(new Error(`Message timeout: ${type}`));\n      }, MESSAGE_TIMEOUT);\n\n      this.pendingRequests.set(id, { resolve: resolve as (value: unknown) => void, reject, timer });\n\n      this.iframe.contentWindow.postMessage(message, this.targetOrigin);\n    });\n  }\n\n  /**\n   * Register an event handler\n   */\n  onEvent(eventName: string, handler: (data: unknown) => void): void {\n    const handlers = this.eventHandlers.get(eventName) || [];\n    handlers.push(handler);\n    this.eventHandlers.set(eventName, handlers);\n  }\n\n  /**\n   * Remove an event handler\n   */\n  offEvent(eventName: string, handler: (data: unknown) => void): void {\n    const handlers = this.eventHandlers.get(eventName) || [];\n    const index = handlers.indexOf(handler);\n    if (index > -1) {\n      handlers.splice(index, 1);\n      this.eventHandlers.set(eventName, handlers);\n    }\n  }\n\n  private handleMessage(event: MessageEvent<IframeMessage>): void {\n    // Validate origin\n    if (!ALLOWED_ORIGINS.includes(event.origin)) {\n      return;\n    }\n\n    const { data } = event;\n\n    // Validate message format\n    if (data?.messageBizId !== MESSAGE_BIZ_ID) {\n      return;\n    }\n\n    // Handle response messages\n    if (this.isResponseMessage(data)) {\n      const pending = this.pendingRequests.get(data.id);\n      if (pending) {\n        clearTimeout(pending.timer);\n        this.pendingRequests.delete(data.id);\n\n        if (data.error) {\n          pending.reject(new Error(data.error.message));\n        } else {\n          pending.resolve(data.data);\n        }\n      }\n    }\n\n    // Handle event messages\n    if (this.isEventMessage(data)) {\n      const handlers = this.eventHandlers.get(data.eventName) || [];\n      handlers.forEach((handler) => {\n        try {\n          handler(data.data);\n        } catch {\n          // Ignore handler errors\n        }\n      });\n    }\n  }\n\n  private isResponseMessage(data: IframeMessage): data is IframeResponseMessage {\n    return 'isResponse' in data && data.isResponse === true;\n  }\n\n  private isEventMessage(data: IframeMessage): data is IframeEventMessage {\n    return data.type === 'event';\n  }\n}\n","import { getIframeBaseURL, MESSAGE_BIZ_ID, CHANNEL_TYPE, ANONYMOUS_CHANNEL_TYPE } from './constants';\nimport { DeviceDetector } from './device-detector';\nimport { MessageBridge } from './message-bridge';\n\nimport type { WebSDKConfig, ChatPanel } from './types/config';\n\n/**\n * IframeManager handles iframe creation and lifecycle\n *\n * iframe 采用自初始化模式：配置通过 URL hash 传入，iframe 加载后自行解析并渲染，\n * 与旧版 copilot iframe 的行为保持一致。宿主通过 postMessage 进行后续操作。\n */\nexport class IframeManager {\n  private iframe: HTMLIFrameElement | null = null;\n  private messageBridge: MessageBridge;\n  private config: WebSDKConfig;\n  private channelType: string;\n  private root: HTMLElement;\n  private deviceDetector: DeviceDetector | null = null;\n\n  constructor(root: HTMLElement, config: WebSDKConfig) {\n    this.root = root;\n    this.config = config;\n    this.channelType = config.anonymous ? ANONYMOUS_CHANNEL_TYPE : CHANNEL_TYPE;\n    this.messageBridge = new MessageBridge(getIframeBaseURL());\n  }\n\n  /**\n   * Initialize the iframe and establish communication\n   * 配置通过 URL hash 编码传入 iframe，iframe 加载后自行初始化\n   */\n  async init(): Promise<ChatPanel> {\n    const initStart = performance.now();\n\n    // Auto-detect device if not explicitly provided\n    if (!this.config.device) {\n      this.deviceDetector = new DeviceDetector();\n      this.config.device = this.deviceDetector.getDevice();\n    }\n\n    // Create iframe element\n    this.iframe = document.createElement('iframe');\n    this.iframe.src = this.buildIframeURL();\n    this.iframe.style.width = '100%';\n    this.iframe.style.height = '100%';\n    this.iframe.style.border = 'none';\n    this.iframe.allow = 'microphone; clipboard-write';\n\n    // Attach to DOM\n    this.root.appendChild(this.iframe);\n\n    // Attach message bridge (开始监听消息)\n    this.messageBridge.attach(this.iframe);\n\n    // Setup event handlers (在 iframe 初始化完成之前就开始监听，确保不丢失事件)\n    this.setupEventHandlers();\n\n    // Listen for device changes and push updates to iframe\n    if (this.deviceDetector) {\n      this.deviceDetector.observe((newDevice) => {\n        this.messageBridge.send('updateConfig', { device: newDevice });\n      });\n    }\n\n    // Wait for iframe to finish initialization (iframe 自行读取 URL 配置并渲染，完成后发送 ready 事件)\n    await this.waitForReady();\n\n    // 上报 cui_init_total 耗时（iframe 创建 → init 完成）\n    this.reportInitMetrics(initStart);\n\n    // Return ChatPanel interface\n    return this.createChatPanel();\n  }\n\n  /**\n   * Destroy the iframe and cleanup\n   */\n  async destroy(): Promise<void> {\n    try {\n      await this.messageBridge.send('destroy');\n    } catch {\n      // Ignore errors during destroy\n    }\n\n    this.messageBridge.detach();\n\n    if (this.deviceDetector) {\n      this.deviceDetector.destroy();\n      this.deviceDetector = null;\n    }\n\n    if (this.iframe && this.iframe.parentNode) {\n      this.iframe.parentNode.removeChild(this.iframe);\n    }\n\n    this.iframe = null;\n  }\n\n  /**\n   * 构建 iframe URL，将配置编码到 hash 中\n   * 格式: {baseURL}#{params} 其中 config 为 base64(JSON.stringify(configWithoutEvents))\n   *\n   * 鉴权说明：SDK 不参与 token 获取/传递。iframe 自行处理飞书登录流程，\n   * 允许用户在 iframe 中独立登录。匿名渠道跳过登录检查。\n   */\n  private buildIframeURL(): string {\n    const baseURL = getIframeBaseURL();\n\n    // 移除 events（函数无法序列化）\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    const { events, anonymous: _anonymous, ...configWithoutEvents } = this.config;\n    // 注入 channelType/resourceType（SDK 内部控制，不暴露给消费者）\n    const iframeConfig = {\n      ...configWithoutEvents,\n      common: {\n        ...configWithoutEvents.common,\n        channelType: this.channelType,\n        resourceType: this.channelType,\n      },\n    };\n    const configBase64 = btoa(JSON.stringify(iframeConfig));\n\n    const params = new URLSearchParams({\n      appKey: this.config.appKey,\n      config: encodeURIComponent(configBase64),\n    });\n\n    return `${baseURL}#${params.toString()}`;\n  }\n\n  /**\n   * 等待 iframe 自行初始化完成后发送 ready 事件\n   */\n  private waitForReady(): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        reject(new Error('Iframe ready timeout'));\n      }, 30000);\n\n      const checkMessage = (event: MessageEvent) => {\n        if (\n          event.data?.messageBizId === MESSAGE_BIZ_ID &&\n          event.data?.type === 'event' &&\n          event.data?.eventName === 'ready'\n        ) {\n          clearTimeout(timeout);\n          window.removeEventListener('message', checkMessage);\n          resolve();\n        }\n      };\n\n      window.addEventListener('message', checkMessage);\n    });\n  }\n\n  private setupEventHandlers(): void {\n    const { events } = this.config;\n    if (!events) return;\n\n    if (events.onReady) {\n      this.messageBridge.onEvent('ready', events.onReady);\n    }\n\n    if (events.onError) {\n      this.messageBridge.onEvent('error', (data: unknown) => {\n        const msg = (data as { message?: string })?.message || 'Unknown error';\n        events.onError!(new Error(msg));\n      });\n    }\n\n    if (events.onMessage) {\n      this.messageBridge.onEvent('onMessage', events.onMessage);\n    }\n  }\n\n  private reportInitMetrics(initStart: number): void {\n    try {\n      const cost = performance.now() - initStart;\n      const Slardar = (window as unknown as Record<string, unknown>).__Slardar as\n        | { sendEvent?: (event: Record<string, unknown>) => void }\n        | undefined;\n      if (Slardar?.sendEvent) {\n        Slardar.sendEvent({\n          name: 'cui_init_total',\n          metrics: { cost },\n          categories: {\n            arch: 'iframe-static',\n            appKey: this.config.appKey,\n            channelType: this.channelType,\n          },\n        });\n      }\n    } catch {\n      // 性能上报失败不影响功能\n    }\n  }\n\n  private createChatPanel(): ChatPanel {\n    return {\n      sendMessage: async (data) => {\n        await this.messageBridge.send('sendMessage', data);\n      },\n      clear: async () => {\n        await this.messageBridge.send('clear');\n      },\n      cancelMessage: async (messageItem) => {\n        await this.messageBridge.send('cancelMessage', messageItem);\n      },\n      clearAndStop: async () => {\n        await this.messageBridge.send('clearAndStop');\n      },\n      updateWelcomeMessage: async () => {\n        await this.messageBridge.send('updateWelcomeMessage');\n      },\n      updateConfig: async (config) => {\n        await this.messageBridge.send('updateConfig', config);\n      },\n      observeSkill: async (skillId, name, skillType) => {\n        await this.messageBridge.send('observeSkill', { skillId, name, skillType });\n      },\n      setCurrentSkill: async (skill) => {\n        await this.messageBridge.send('setCurrentSkill', skill);\n      },\n      destroy: async () => {\n        await this.destroy();\n      },\n    };\n  }\n}\n"],"mappings":"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","names":["MESSAGE_BIZ_ID","IFRAME_BASE_URL","production","staging","boe","development","getIframeBaseURL","env","hostname","window","location","includes","MESSAGE_TIMEOUT","CHANNEL_TYPE","ANONYMOUS_CHANNEL_TYPE","ALLOWED_ORIGINS","MOBILE_BREAKPOINT","DeviceDetector","mediaQuery","currentDevice","callback","handleChange","window","matchMedia","innerWidth","getDevice","observe","newDevice","addEventListener","destroy","removeEventListener","MessageBridge","iframe","requestId","pendingRequests","Map","eventHandlers","targetOrigin","handleMessage","bind","attach","window","addEventListener","detach","removeEventListener","forEach","reject","Error","clear","send","type","data","Promise","resolve","contentWindow","id","message","messageBizId","MESSAGE_BIZ_ID","timestamp","Date","now","isRequest","timer","setTimeout","delete","MESSAGE_TIMEOUT","set","postMessage","onEvent","eventName","handler","handlers","get","push","offEvent","index","indexOf","splice","event","ALLOWED_ORIGINS","includes","origin","isResponseMessage","pending","clearTimeout","error","isEventMessage","isResponse","IframeManager","iframe","messageBridge","config","channelType","root","deviceDetector","anonymous","ANONYMOUS_CHANNEL_TYPE","CHANNEL_TYPE","MessageBridge","getIframeBaseURL","init","initStart","performance","now","device","DeviceDetector","getDevice","document","createElement","src","buildIframeURL","style","width","height","border","allow","appendChild","attach","setupEventHandlers","observe","newDevice","send","waitForReady","reportInitMetrics","createChatPanel","destroy","detach","parentNode","removeChild","baseURL","events","_anonymous","configWithoutEvents","iframeConfig","common","resourceType","configBase64","btoa","JSON","stringify","params","URLSearchParams","appKey","encodeURIComponent","toString","Promise","resolve","reject","timeout","setTimeout","Error","checkMessage","event","data","messageBizId","MESSAGE_BIZ_ID","type","eventName","clearTimeout","window","removeEventListener","addEventListener","onReady","onEvent","onError","msg","message","onMessage","cost","Slardar","__Slardar","sendEvent","name","metrics","categories","arch","sendMessage","clear","cancelMessage","messageItem","clearAndStop","updateWelcomeMessage","updateConfig","observeSkill","skillId","skillType","setCurrentSkill","skill","initAilyChat","root","config","manager","IframeManager","init"]}

package/dist/index.d.cts

@@ -0,0 +1,175 @@
+/**
+ * Configuration types for Aily Web SDK
+ */
+/**
+ * Common configuration options
+ */
+interface WebSDKCommonConfig {
+    /** Base URL for the Aily service */
+    baseURL: string;
+    /** Additional headers to send with requests */
+    headers?: Record<string, string>;
+    /** APAAS application info for API authentication */
+    apaasAppInfo?: {
+        namespace?: string;
+        tenantID?: number;
+        tenantType?: number;
+    };
+}
+/**
+ * Event callbacks
+ */
+interface WebSDKEvents {
+    /** Callback when iframe is ready */
+    onReady?: () => void;
+    /** Callback when an error occurs */
+    onError?: (error: Error) => void;
+    /** Callback when a message is received */
+    onMessage?: (message: unknown) => void;
+}
+/**
+ * Conversion (conversation) configuration passed through to cui-sdk
+ */
+interface WebSDKConversionConfig {
+    /** Enable message caching. Default: false */
+    needCache?: boolean;
+    /** Storage type for caching: 'memory' | 'sessionStorage' | 'localStorage' | 'indexDB' | 'server'. Default: 'memory' */
+    storageType?: string;
+    /** User avatar: 'default' renders built-in Avatar component, or pass an image URL string */
+    userAvatar?: string;
+    /** Whether to show avatars. Default: true */
+    needAvatar?: boolean;
+    /** Whether to show feedback buttons. Default: true */
+    supportFeedback?: boolean;
+    /** Step text mapping (URL-encoded key=value pairs separated by &) */
+    stepTextMap?: string;
+}
+/**
+ * Editor configuration passed through to cui-sdk
+ */
+interface WebSDKEditorConfig {
+    /** Interaction mode: 'v1' for classic, 'v2' for new interaction. Default: 'v1' */
+    interactionMode?: 'v1' | 'v2';
+    /** Auto skill selection. Default: true */
+    autoSkill?: boolean;
+    /** Whether to show the editor. Default: true */
+    display?: boolean;
+}
+/**
+ * Main configuration interface for Web SDK
+ */
+interface WebSDKConfig {
+    /** Application key */
+    appKey: string;
+    /** User identifier */
+    uuid?: string;
+    /** Device type */
+    device?: 'pc' | 'mobile';
+    /** Interaction mode: 'v1' for classic, 'v2' for new interaction */
+    interactionMode?: 'v1' | 'v2';
+    /**
+     * Enable anonymous mode (skips login check). Default: false
+     * 非匿名模式下，iframe 内自行完成飞书登录（用户在 iframe 中独立登录），
+     * SDK 不参与 token 获取/传递。
+     */
+    anonymous?: boolean;
+    /** Common configuration */
+    common: WebSDKCommonConfig;
+    /** Conversation/conversion configuration (avatar, caching, etc.) */
+    conversion?: WebSDKConversionConfig;
+    /** Editor configuration (interaction mode, auto skill, etc.) */
+    editor?: WebSDKEditorConfig;
+    /** Event callbacks */
+    events?: WebSDKEvents;
+}
+/**
+ * Chat panel control interface
+ * 与 aily-cui-sdk 的 ChatPanel 接口保持一致
+ */
+interface ChatPanel {
+    /** Send a message to the chat */
+    sendMessage: (data: {
+        content: string;
+        channelContext?: Record<string, unknown>;
+        skillID?: string;
+    }) => Promise<void>;
+    /** Clear the chat history */
+    clear: () => Promise<void>;
+    /** Cancel a message */
+    cancelMessage: (messageItem: unknown) => Promise<void>;
+    /** Clear messages and stop current response */
+    clearAndStop: () => Promise<void>;
+    /** Refresh welcome message */
+    updateWelcomeMessage: () => Promise<void>;
+    /** Update panel config */
+    updateConfig: (config: unknown) => Promise<void>;
+    /** Observe a skill */
+    observeSkill: (skillId: string, name: string, skillType: 'qna' | 'bi' | 'dataCreate') => Promise<void>;
+    /** Set current skill */
+    setCurrentSkill: (skill: {
+        id: string;
+        name: string;
+    }) => Promise<void>;
+    /** Destroy the chat panel instance */
+    destroy: () => Promise<void>;
+}
+
+/** Iframe base URLs by environment */
+declare const IFRAME_BASE_URL: Record<string, string>;
+/**
+ * Get iframe base URL based on environment
+ */
+declare function getIframeBaseURL(env?: string): string;
+/** Timeout for postMessage requests (30 seconds) */
+declare const MESSAGE_TIMEOUT: number;
+
+/**
+ * Message types for postMessage communication between aily-web-sdk and iframe
+ */
+
+/** Message types for iframe communication */
+type IframeMessageType = 'sendMessage' | 'clear' | 'cancelMessage' | 'clearAndStop' | 'updateWelcomeMessage' | 'updateConfig' | 'observeSkill' | 'setCurrentSkill' | 'destroy';
+/** Request message from parent to iframe */
+interface IframeRequestMessage {
+    messageBizId: 'cui-sdk-message';
+    id: number;
+    type: IframeMessageType;
+    data: unknown;
+    timestamp: number;
+    isRequest: true;
+}
+/** Response message from iframe to parent */
+interface IframeResponseMessage {
+    messageBizId: 'cui-sdk-message';
+    id: number;
+    type: IframeMessageType;
+    data?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+    timestamp: number;
+    isResponse: true;
+}
+/** Event message from iframe to parent */
+interface IframeEventMessage {
+    messageBizId: 'cui-sdk-message';
+    id: number;
+    type: 'event';
+    eventName: string;
+    data: unknown;
+    timestamp: number;
+}
+/** Union type for all iframe messages */
+type IframeMessage = IframeRequestMessage | IframeResponseMessage | IframeEventMessage;
+
+/**
+ * Initialize Aily Chat via iframe
+ * This is the primary method for initializing the chat panel
+ * @param root - Container element for the iframe
+ * @param config - Configuration options
+ * @returns ChatPanel instance for controlling the chat
+ */
+declare function initAilyChat(root: HTMLElement, config: WebSDKConfig): Promise<ChatPanel>;
+
+export { type ChatPanel, IFRAME_BASE_URL, type IframeEventMessage, type IframeMessage, type IframeMessageType, type IframeRequestMessage, type IframeResponseMessage, MESSAGE_TIMEOUT, type WebSDKCommonConfig, type WebSDKConfig, type WebSDKConversionConfig, type WebSDKEditorConfig, type WebSDKEvents, getIframeBaseURL, initAilyChat };

package/dist/index.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Configuration types for Aily Web SDK
+ */
+/**
+ * Common configuration options
+ */
+interface WebSDKCommonConfig {
+    /** Base URL for the Aily service */
+    baseURL: string;
+    /** Additional headers to send with requests */
+    headers?: Record<string, string>;
+    /** APAAS application info for API authentication */
+    apaasAppInfo?: {
+        namespace?: string;
+        tenantID?: number;
+        tenantType?: number;
+    };
+}
+/**
+ * Event callbacks
+ */
+interface WebSDKEvents {
+    /** Callback when iframe is ready */
+    onReady?: () => void;
+    /** Callback when an error occurs */
+    onError?: (error: Error) => void;
+    /** Callback when a message is received */
+    onMessage?: (message: unknown) => void;
+}
+/**
+ * Conversion (conversation) configuration passed through to cui-sdk
+ */
+interface WebSDKConversionConfig {
+    /** Enable message caching. Default: false */
+    needCache?: boolean;
+    /** Storage type for caching: 'memory' | 'sessionStorage' | 'localStorage' | 'indexDB' | 'server'. Default: 'memory' */
+    storageType?: string;
+    /** User avatar: 'default' renders built-in Avatar component, or pass an image URL string */
+    userAvatar?: string;
+    /** Whether to show avatars. Default: true */
+    needAvatar?: boolean;
+    /** Whether to show feedback buttons. Default: true */
+    supportFeedback?: boolean;
+    /** Step text mapping (URL-encoded key=value pairs separated by &) */
+    stepTextMap?: string;
+}
+/**
+ * Editor configuration passed through to cui-sdk
+ */
+interface WebSDKEditorConfig {
+    /** Interaction mode: 'v1' for classic, 'v2' for new interaction. Default: 'v1' */
+    interactionMode?: 'v1' | 'v2';
+    /** Auto skill selection. Default: true */
+    autoSkill?: boolean;
+    /** Whether to show the editor. Default: true */
+    display?: boolean;
+}
+/**
+ * Main configuration interface for Web SDK
+ */
+interface WebSDKConfig {
+    /** Application key */
+    appKey: string;
+    /** User identifier */
+    uuid?: string;
+    /** Device type */
+    device?: 'pc' | 'mobile';
+    /** Interaction mode: 'v1' for classic, 'v2' for new interaction */
+    interactionMode?: 'v1' | 'v2';
+    /**
+     * Enable anonymous mode (skips login check). Default: false
+     * 非匿名模式下，iframe 内自行完成飞书登录（用户在 iframe 中独立登录），
+     * SDK 不参与 token 获取/传递。
+     */
+    anonymous?: boolean;
+    /** Common configuration */
+    common: WebSDKCommonConfig;
+    /** Conversation/conversion configuration (avatar, caching, etc.) */
+    conversion?: WebSDKConversionConfig;
+    /** Editor configuration (interaction mode, auto skill, etc.) */
+    editor?: WebSDKEditorConfig;
+    /** Event callbacks */
+    events?: WebSDKEvents;
+}
+/**
+ * Chat panel control interface
+ * 与 aily-cui-sdk 的 ChatPanel 接口保持一致
+ */
+interface ChatPanel {
+    /** Send a message to the chat */
+    sendMessage: (data: {
+        content: string;
+        channelContext?: Record<string, unknown>;
+        skillID?: string;
+    }) => Promise<void>;
+    /** Clear the chat history */
+    clear: () => Promise<void>;
+    /** Cancel a message */
+    cancelMessage: (messageItem: unknown) => Promise<void>;
+    /** Clear messages and stop current response */
+    clearAndStop: () => Promise<void>;
+    /** Refresh welcome message */
+    updateWelcomeMessage: () => Promise<void>;
+    /** Update panel config */
+    updateConfig: (config: unknown) => Promise<void>;
+    /** Observe a skill */
+    observeSkill: (skillId: string, name: string, skillType: 'qna' | 'bi' | 'dataCreate') => Promise<void>;
+    /** Set current skill */
+    setCurrentSkill: (skill: {
+        id: string;
+        name: string;
+    }) => Promise<void>;
+    /** Destroy the chat panel instance */
+    destroy: () => Promise<void>;
+}
+
+/** Iframe base URLs by environment */
+declare const IFRAME_BASE_URL: Record<string, string>;
+/**
+ * Get iframe base URL based on environment
+ */
+declare function getIframeBaseURL(env?: string): string;
+/** Timeout for postMessage requests (30 seconds) */
+declare const MESSAGE_TIMEOUT: number;
+
+/**
+ * Message types for postMessage communication between aily-web-sdk and iframe
+ */
+
+/** Message types for iframe communication */
+type IframeMessageType = 'sendMessage' | 'clear' | 'cancelMessage' | 'clearAndStop' | 'updateWelcomeMessage' | 'updateConfig' | 'observeSkill' | 'setCurrentSkill' | 'destroy';
+/** Request message from parent to iframe */
+interface IframeRequestMessage {
+    messageBizId: 'cui-sdk-message';
+    id: number;
+    type: IframeMessageType;
+    data: unknown;
+    timestamp: number;
+    isRequest: true;
+}
+/** Response message from iframe to parent */
+interface IframeResponseMessage {
+    messageBizId: 'cui-sdk-message';
+    id: number;
+    type: IframeMessageType;
+    data?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+    timestamp: number;
+    isResponse: true;
+}
+/** Event message from iframe to parent */
+interface IframeEventMessage {
+    messageBizId: 'cui-sdk-message';
+    id: number;
+    type: 'event';
+    eventName: string;
+    data: unknown;
+    timestamp: number;
+}
+/** Union type for all iframe messages */
+type IframeMessage = IframeRequestMessage | IframeResponseMessage | IframeEventMessage;
+
+/**
+ * Initialize Aily Chat via iframe
+ * This is the primary method for initializing the chat panel
+ * @param root - Container element for the iframe
+ * @param config - Configuration options
+ * @returns ChatPanel instance for controlling the chat
+ */
+declare function initAilyChat(root: HTMLElement, config: WebSDKConfig): Promise<ChatPanel>;
+
+export { type ChatPanel, IFRAME_BASE_URL, type IframeEventMessage, type IframeMessage, type IframeMessageType, type IframeRequestMessage, type IframeResponseMessage, MESSAGE_TIMEOUT, type WebSDKCommonConfig, type WebSDKConfig, type WebSDKConversionConfig, type WebSDKEditorConfig, type WebSDKEvents, getIframeBaseURL, initAilyChat };