@talex-touch/utils 1.0.34 → 1.0.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talex-touch/utils",
-  "version": "1.0.34",
+  "version": "1.0.36",
   "private": false,
   "description": "Tuff series utils",
   "author": "TalexDreamSoul",

package/plugin/channel.ts

@@ -10,6 +10,8 @@ import {
   DataCode,
 } from '../channel'
 
+const CHANNEL_DEFAULT_TIMEOUT = 10_000
+
 let cachedIpcRenderer: IpcRenderer | null = null
 
 // 使用惰性解析避免在打包阶段静态引入 electron
@@ -197,6 +199,19 @@ class TouchChannel implements ITouchClientChannel {
     return true
   }
 
+  private formatPayloadPreview(payload: unknown): string {
+    if (payload === null || payload === undefined)
+      return String(payload)
+    if (typeof payload === 'string')
+      return payload.length > 200 ? `${payload.slice(0, 200)}…` : payload
+    try {
+      return JSON.stringify(payload)
+    }
+    catch {
+      return '[unserializable]'
+    }
+  }
+
   send(eventName: string, arg: any): Promise<any> {
     const uniqueId = `${new Date().getTime()}#${eventName}@${Math.random().toString(
       12,
@@ -207,7 +222,7 @@ class TouchChannel implements ITouchClientChannel {
       data: arg,
       sync: {
         timeStamp: new Date().getTime(),
-        timeout: 10000,
+        timeout: CHANNEL_DEFAULT_TIMEOUT,
         id: uniqueId,
       },
       name: eventName,
@@ -218,10 +233,40 @@ class TouchChannel implements ITouchClientChannel {
       },
     } as RawStandardChannelData
 
-    return new Promise((resolve) => {
-      this.ipcRenderer.send('@plugin-process-message', data)
+    return new Promise((resolve, reject) => {
+      try {
+        this.ipcRenderer.send('@plugin-process-message', data)
+      }
+      catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error)
+        console.error(
+          `[PluginChannel] Failed to send "${eventName}": ${errorMessage}`,
+          { payloadPreview: this.formatPayloadPreview(arg) },
+        )
+        reject(
+          Object.assign(
+            new Error(`Failed to send plugin channel message "${eventName}": ${errorMessage}`),
+            { code: 'plugin_channel_send_failed' },
+          ),
+        )
+        return
+      }
+
+      const timeoutMs = data.sync?.timeout ?? CHANNEL_DEFAULT_TIMEOUT
+      const timeoutHandle = setTimeout(() => {
+        if (!this.pendingMap.has(uniqueId))
+          return
+        this.pendingMap.delete(uniqueId)
+        const timeoutError = Object.assign(
+          new Error(`Plugin channel request "${eventName}" timed out after ${timeoutMs}ms`),
+          { code: 'plugin_channel_timeout' },
+        )
+        console.warn(timeoutError.message)
+        reject(timeoutError)
+      }, timeoutMs)
 
       this.pendingMap.set(uniqueId, (res: any) => {
+        clearTimeout(timeoutHandle)
         this.pendingMap.delete(uniqueId)
 
         resolve(res.data)
@@ -241,12 +286,26 @@ class TouchChannel implements ITouchClientChannel {
       },
     } as RawStandardChannelData
 
-    const res = this.__parse_raw_data(void 0, this.ipcRenderer.sendSync('@plugin-process-message', data))!
+    try {
+      const res = this.__parse_raw_data(
+        void 0,
+        this.ipcRenderer.sendSync('@plugin-process-message', data),
+      )!
 
-    if (res.header.status === 'reply')
-      return res.data
+      if (res.header.status === 'reply')
+        return res.data
 
-    return res
+      return res
+    }
+    catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error)
+      console.error('[PluginChannel] Failed to sendSync message', {
+        eventName,
+        error: errorMessage,
+        payloadPreview: this.formatPayloadPreview(arg),
+      })
+      throw new Error(`Failed to sendSync plugin channel message "${eventName}": ${errorMessage}`)
+    }
   }
 }
 

package/plugin/sdk/README.md

@@ -26,8 +26,10 @@ plugin.box.shrink()
 plugin.box.hideInput()
 plugin.box.showInput()
 
-// 获取当前输入
+// 获取与设置输入
 const input = await plugin.box.getInput()
+await plugin.box.setInput('Hello Touch!')
+await plugin.box.clearInput()
 ```
 
 ### 2. FeatureSDK - 搜索结果管理
@@ -203,6 +205,8 @@ export default {
 - `core-box:hide-input` - 隐藏输入框
 - `core-box:show-input` - 显示输入框
 - `core-box:get-input` - 获取当前输入值
+- `core-box:set-input` - 设置输入框内容
+- `core-box:clear-input` - 清空输入框
 - `core-box:input-changed` - 输入变化广播（主进程 → 插件）
 - `core-box:set-input-visibility` - 设置输入框可见性（主进程 → 渲染进程）
 - `core-box:request-input-value` - 请求输入值（主进程 → 渲染进程）

package/plugin/sdk/box-sdk.ts

@@ -1,9 +1,28 @@
 /**
  * Box SDK for Plugin Development
- * 
+ *
  * Provides a unified API for plugins to control the CoreBox window behavior,
  * including visibility, size, input field control, and input value access.
  */
+import { ensureRendererChannel } from './channel'
+
+/**
+ * Clipboard content type flags for binary combination
+ */
+export enum ClipboardType {
+  TEXT = 0b0001,
+  IMAGE = 0b0010,
+  FILE = 0b0100,
+}
+
+/**
+ * Preset clipboard type combinations
+ */
+export const ClipboardTypePresets = {
+  TEXT_ONLY: ClipboardType.TEXT,
+  TEXT_AND_IMAGE: ClipboardType.TEXT | ClipboardType.IMAGE,
+  ALL: ClipboardType.TEXT | ClipboardType.IMAGE | ClipboardType.FILE,
+} as const
 
 /**
  * Expand options for CoreBox window
@@ -17,18 +36,18 @@ export interface BoxExpandOptions {
 
 /**
  * Box SDK interface for plugins
- * 
+ *
  * @example
  * ```typescript
  * // Hide CoreBox
  * plugin.box.hide()
- * 
+ *
  * // Show CoreBox
  * plugin.box.show()
- * 
+ *
  * // Expand to show 10 items
  * plugin.box.expand({ length: 10 })
- * 
+ *
  * // Get current input
  * const input = plugin.box.getInput()
  * ```
@@ -36,119 +55,172 @@ export interface BoxExpandOptions {
 export interface BoxSDK {
   /**
    * Hides the CoreBox window
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.hide()
    * ```
    */
-  hide(): void
+  hide: () => void
 
   /**
    * Shows the CoreBox window
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.show()
    * ```
    */
-  show(): void
+  show: () => void
 
   /**
    * Expands the CoreBox window
-   * 
+   *
    * @param options - Optional expansion configuration
-   * 
+   *
    * @example
    * ```typescript
    * // Expand to show 10 items
    * plugin.box.expand({ length: 10 })
-   * 
+   *
    * // Force maximum expansion
    * plugin.box.expand({ forceMax: true })
-   * 
+   *
    * // Default expansion
    * plugin.box.expand()
    * ```
    */
-  expand(options?: BoxExpandOptions): Promise<void>
+  expand: (options?: BoxExpandOptions) => Promise<void>
 
   /**
    * Shrinks the CoreBox window to compact size
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.shrink()
    * ```
    */
-  shrink(): Promise<void>
+  shrink: () => Promise<void>
 
   /**
    * Hides the input field in CoreBox
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.hideInput()
    * ```
    */
-  hideInput(): Promise<void>
+  hideInput: () => Promise<void>
 
   /**
    * Shows the input field in CoreBox
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.showInput()
    * ```
    */
-  showInput(): Promise<void>
+  showInput: () => Promise<void>
 
   /**
    * Gets the current input value from CoreBox search field
-   * 
+   *
    * @returns Promise resolving to the current input string
-   * 
+   *
    * @example
    * ```typescript
    * const input = await plugin.box.getInput()
    * console.log('Current input:', input)
    * ```
    */
-  getInput(): Promise<string>
+  getInput: () => Promise<string>
+
+  /**
+   * Sets the CoreBox search input to the specified value
+   *
+   * @example
+   * ```typescript
+   * await plugin.box.setInput('hello world')
+   * ```
+   */
+  setInput: (value: string) => Promise<void>
+
+  /**
+   * Clears the CoreBox search input
+   *
+   * @example
+   * ```typescript
+   * await plugin.box.clearInput()
+   * ```
+   */
+  clearInput: () => Promise<void>
+
+  /**
+   * Enable input monitoring for attached UI view
+   *
+   * @example
+   * ```typescript
+   * await plugin.box.allowInput()
+   * plugin.channel.regChannel('core-box:input-change', ({ data }) => {
+   *   console.log('Input changed:', data.input)
+   * })
+   * ```
+   */
+  allowInput: () => Promise<void>
+
+  /**
+   * Enable clipboard monitoring for specified type combination
+   *
+   * @param types - Binary combination of ClipboardType flags
+   *
+   * @example
+   * ```typescript
+   * // Allow text and images
+   * await plugin.box.allowClipboard(ClipboardType.TEXT | ClipboardType.IMAGE)
+   *
+   * // Or use presets
+   * await plugin.box.allowClipboard(ClipboardTypePresets.TEXT_AND_IMAGE)
+   * ```
+   */
+  allowClipboard: (types: number) => Promise<void>
 }
 
 /**
  * Creates a Box SDK instance for plugin use
- * 
+ *
  * @param channel - The plugin channel bridge for IPC communication
  * @returns Configured Box SDK instance
- * 
+ *
  * @internal
  */
 export function createBoxSDK(channel: any): BoxSDK {
-  const sendFn = channel.sendToMain || channel.send
-
-  if (!sendFn) {
-    throw new Error('[Box SDK] Channel send function not available')
-  }
+  const send: (eventName: string, payload?: any) => Promise<any> =
+    typeof channel?.sendToMain === 'function'
+      ? channel.sendToMain.bind(channel)
+      : typeof channel?.send === 'function'
+        ? channel.send.bind(channel)
+        : (() => {
+            throw new Error('[Box SDK] Channel send function not available')
+          })()
 
   return {
     hide(): void {
-      sendFn('core-box:hide').catch((error: any) => {
+      send('core-box:hide').catch((error: any) => {
         console.error('[Box SDK] Failed to hide CoreBox:', error)
       })
     },
 
     show(): void {
-      sendFn('core-box:show').catch((error: any) => {
+      send('core-box:show').catch((error: any) => {
         console.error('[Box SDK] Failed to show CoreBox:', error)
       })
     },
 
     async expand(options?: BoxExpandOptions): Promise<void> {
       try {
-        await sendFn('core-box:expand', options || {})
-      } catch (error) {
+        await send('core-box:expand', options || {})
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to expand CoreBox:', error)
         throw error
       }
@@ -156,8 +228,9 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async shrink(): Promise<void> {
       try {
-        await sendFn('core-box:expand', { mode: 'collapse' })
-      } catch (error) {
+        await send('core-box:expand', { mode: 'collapse' })
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to shrink CoreBox:', error)
         throw error
       }
@@ -165,8 +238,9 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async hideInput(): Promise<void> {
       try {
-        await sendFn('core-box:hide-input')
-      } catch (error) {
+        await send('core-box:hide-input')
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to hide input:', error)
         throw error
       }
@@ -174,8 +248,9 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async showInput(): Promise<void> {
       try {
-        await sendFn('core-box:show-input')
-      } catch (error) {
+        await send('core-box:show-input')
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to show input:', error)
         throw error
       }
@@ -183,37 +258,72 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async getInput(): Promise<string> {
       try {
-        const result = await sendFn('core-box:get-input')
+        const result = await send('core-box:get-input')
         return result?.data?.input || result?.input || ''
-      } catch (error) {
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to get input:', error)
         throw error
       }
-    }
+    },
+
+    async setInput(value: string): Promise<void> {
+      try {
+        await send('core-box:set-input', { value })
+      }
+      catch (error) {
+        console.error('[Box SDK] Failed to set input:', error)
+        throw error
+      }
+    },
+
+    async clearInput(): Promise<void> {
+      try {
+        await send('core-box:clear-input')
+      }
+      catch (error) {
+        console.error('[Box SDK] Failed to clear input:', error)
+        throw error
+      }
+    },
+
+    async allowInput(): Promise<void> {
+      try {
+        await send('core-box:allow-input')
+      }
+      catch (error) {
+        console.error('[Box SDK] Failed to enable input monitoring:', error)
+        throw error
+      }
+    },
+
+    async allowClipboard(types: number): Promise<void> {
+      try {
+        await send('core-box:allow-clipboard', types)
+      }
+      catch (error) {
+        console.error('[Box SDK] Failed to enable clipboard monitoring:', error)
+        throw error
+      }
+    },
   }
 }
 
 /**
  * Hook for using Box SDK in plugin context
- * 
+ *
  * @returns Box SDK instance
- * 
+ *
  * @example
  * ```typescript
  * const box = useBox()
- * 
+ *
  * box.hide()
  * box.expand({ length: 10 })
  * const input = await box.getInput()
  * ```
  */
 export function useBox(): BoxSDK {
-  // @ts-ignore - window.$channel is injected by the plugin system
-  const channel = window.$channel
-  
-  if (!channel) {
-    throw new Error('[Box SDK] Channel not available. Make sure this is called in a plugin context.')
-  }
-  
+  const channel = ensureRendererChannel('[Box SDK] Channel not available. Make sure this is called in a plugin context.')
   return createBoxSDK(channel)
 }

package/plugin/sdk/channel.ts

@@ -4,6 +4,34 @@ import { genChannel } from '../channel'
 
 const ensureClientChannel = (): ITouchClientChannel => genChannel()
 
+const DEFAULT_CHANNEL_ERROR = '[Plugin SDK] Channel not available. Make sure this code runs inside a plugin renderer context.'
+
+let cachedWindowChannel: ITouchClientChannel | null = null
+
+/**
+ * Ensures that the renderer-side plugin channel (window.$channel) exists and returns it.
+ *
+ * @param errorMessage - Optional custom error message when the channel is unavailable
+ */
+export function ensureRendererChannel(errorMessage = DEFAULT_CHANNEL_ERROR): ITouchClientChannel {
+  const globalWindow = typeof window === 'undefined' ? undefined : window
+  const channel = globalWindow?.$channel ?? cachedWindowChannel
+
+  if (!channel) {
+    throw new Error(errorMessage)
+  }
+
+  cachedWindowChannel = channel
+  return channel
+}
+
+/**
+ * Convenience hook for accessing window.$channel in plugin renderers.
+ */
+export function useChannel(errorMessage?: string): ITouchClientChannel {
+  return ensureRendererChannel(errorMessage)
+}
+
 export function createPluginRendererChannel(): IPluginRendererChannel {
   const client = ensureClientChannel()
 
@@ -46,3 +74,9 @@ export function usePluginRendererChannel(): IPluginRendererChannel {
 
   return cachedRendererChannel
 }
+
+declare global {
+  interface Window {
+    $channel: ITouchClientChannel
+  }
+}

package/plugin/sdk/division-box.ts

@@ -11,6 +11,7 @@ import type {
   DivisionBoxState,
   SessionInfo,
 } from '../../types/division-box'
+import { ensureRendererChannel } from './channel'
 
 /**
  * State change event handler
@@ -180,11 +181,19 @@ export function createDivisionBoxSDK(channel: any): DivisionBoxSDK {
 
   registerListener()
 
+  const send: (eventName: string, payload?: any) => Promise<any> =
+    typeof channel?.sendToMain === 'function'
+      ? channel.sendToMain.bind(channel)
+      : typeof channel?.send === 'function'
+        ? channel.send.bind(channel)
+        : (() => {
+            throw new Error('[DivisionBox SDK] Channel send function not available')
+          })()
+
   return {
     async open(config: DivisionBoxConfig): Promise<SessionInfo> {
       // Send to main process
-      const sendFn = channel.sendToMain || channel.send
-      const result = await sendFn('division-box:open', config)
+      const result = await send('division-box:open', config)
       
       if (!result.success) {
         throw new Error(result.error?.message || 'Failed to open DivisionBox')
@@ -194,8 +203,7 @@ export function createDivisionBoxSDK(channel: any): DivisionBoxSDK {
     },
 
     async close(sessionId: string, options?: CloseOptions): Promise<void> {
-      const sendFn = channel.sendToMain || channel.send
-      const result = await sendFn('division-box:close', { sessionId, options })
+      const result = await send('division-box:close', { sessionId, options })
       
       if (!result.success) {
         throw new Error(result.error?.message || 'Failed to close DivisionBox')
@@ -211,8 +219,7 @@ export function createDivisionBoxSDK(channel: any): DivisionBoxSDK {
     },
 
     async updateState(sessionId: string, key: string, value: any): Promise<void> {
-      const sendFn = channel.sendToMain || channel.send
-      const result = await sendFn('division-box:update-state', {
+      const result = await send('division-box:update-state', {
         sessionId,
         key,
         value
@@ -224,8 +231,7 @@ export function createDivisionBoxSDK(channel: any): DivisionBoxSDK {
     },
 
     async getState(sessionId: string, key: string): Promise<any> {
-      const sendFn = channel.sendToMain || channel.send
-      const result = await sendFn('division-box:get-state', {
+      const result = await send('division-box:get-state', {
         sessionId,
         key
       })
@@ -255,12 +261,6 @@ export function createDivisionBoxSDK(channel: any): DivisionBoxSDK {
  * ```
  */
 export function useDivisionBox(): DivisionBoxSDK {
-  // @ts-ignore - window.$channel is injected by the plugin system
-  const channel = window.$channel
-  
-  if (!channel) {
-    throw new Error('[DivisionBox SDK] Channel not available. Make sure this is called in a plugin context.')
-  }
-  
+  const channel = ensureRendererChannel('[DivisionBox SDK] Channel not available. Make sure this is called in a plugin context.')
   return createDivisionBoxSDK(channel)
 }

package/plugin/sdk/feature-sdk.ts

@@ -7,6 +7,7 @@
  */
 
 import type { TuffItem } from '../../core-box/tuff'
+import { ensureRendererChannel } from './channel'
 
 /**
  * Input change event handler
@@ -218,18 +219,13 @@ export function createFeatureSDK(boxItemsAPI: any, channel: any): FeatureSDK {
  * ```
  */
 export function useFeature(): FeatureSDK {
-  // @ts-ignore - window.$boxItems and window.$channel are injected by the plugin system
+  // @ts-ignore - window.$boxItems is injected by the plugin system
   const boxItemsAPI = window.$boxItems
-  // @ts-ignore
-  const channel = window.$channel
+  const channel = ensureRendererChannel('[Feature SDK] Channel not available. Make sure this is called in a plugin context.')
   
   if (!boxItemsAPI) {
     throw new Error('[Feature SDK] boxItems API not available. Make sure this is called in a plugin context.')
   }
   
-  if (!channel) {
-    throw new Error('[Feature SDK] Channel not available. Make sure this is called in a plugin context.')
-  }
-  
   return createFeatureSDK(boxItemsAPI, channel)
 }

package/plugin/sdk/hooks/bridge.ts

@@ -1,4 +1,5 @@
 import { BridgeEventForCoreBox } from '../enum/bridge-event'
+import { ensureRendererChannel } from '../channel'
 
 export type BridgeEvent = BridgeEventForCoreBox
 
@@ -26,7 +27,8 @@ export function injectBridgeEvent<T>(type: BridgeEvent, hook: BridgeHook<T>) {
 
   // Only register the channel listener once per event type
   if (hooks.length === 0) {
-    window.$channel.regChannel(type, ({ data }) => {
+    const channel = ensureRendererChannel('[TouchSDK] Bridge channel not available. Make sure hooks run in plugin renderer context.')
+    channel.regChannel(type, ({ data }) => {
       console.debug(`[TouchSDK] ${type} event received: `, data)
       // When the event is received, call all registered hooks for this type
       const registeredHooks = __hooks[type]

package/plugin/sdk/hooks/life-cycle.ts

@@ -1,3 +1,5 @@
+import { ensureRendererChannel } from '../channel'
+
 export enum LifecycleHooks {
   ENABLE = 'en',
   DISABLE = 'di',
@@ -22,7 +24,8 @@ export function injectHook(type: LifecycleHooks, hook: Function, processFunc = (
   const hooks: Array<Function> = __hooks[type] || (__hooks[type] = [])
 
   if (hooks.length === 0) {
-    window.$channel.regChannel(`@lifecycle:${type}`, (obj: any) => {
+    const channel = ensureRendererChannel('[Lifecycle Hook] Channel not available. Make sure hooks run in plugin renderer context.')
+    channel.regChannel(`@lifecycle:${type}`, (obj: any) => {
       processFunc(obj)
 
       // @ts-ignore

package/plugin/sdk/storage.ts

@@ -1,4 +1,5 @@
 import type { FileDetails, StorageStats, StorageTreeNode } from '../../types/storage'
+import { ensureRendererChannel } from './channel'
 
 /**
  * Get the storage for the current plugin.
@@ -15,7 +16,7 @@ export function usePluginStorage() {
     throw new Error('[Plugin SDK] Cannot determine plugin name. Make sure this is called in a plugin context.')
   }
 
-  const channel = window.$channel
+  const channel = ensureRendererChannel('[Plugin Storage] Channel not available. Make sure this is called in a plugin context.')
 
   return {
     /**