@talex-touch/utils 1.0.30 → 1.0.32

package/service/protocol/index.ts

@@ -1,18 +1,18 @@
-import { IService } from './../index';
+import type { IService } from './../index'
 
 export abstract class ProtocolService<T extends string> implements IService {
-  id: symbol;
-  name: string;
-  description: string;
+  id: symbol
+  name: string
+  description: string
 
   protocol: string[]
 
   type: T
 
   constructor(id: symbol, protocol: string[]) {
-    this.id = id;
-    this.name = id.description!;
-    this.description = `${this.name} Protocol Service`;
+    this.id = id
+    this.name = id.description!
+    this.description = `${this.name} Protocol Service`
     this.protocol = protocol
 
     this.type = id.description as T
@@ -20,7 +20,17 @@ export abstract class ProtocolService<T extends string> implements IService {
 }
 
 export const IMAGE_SUFFIX = [
-  'jpg', 'png', 'gif', 'bmp', 'webp', 'svg', 'ico', 'tiff', 'tif', 'jpeg', 'avif'
+  'jpg',
+  'png',
+  'gif',
+  'bmp',
+  'webp',
+  'svg',
+  'ico',
+  'tiff',
+  'tif',
+  'jpeg',
+  'avif',
 ]
 
 export class ImageProtocolService extends ProtocolService<'image'> {
@@ -30,7 +40,69 @@ export class ImageProtocolService extends ProtocolService<'image'> {
 }
 
 export const AUDIO_SUFFIX = [
-  'mp3', 'wav', 'ogg', 'aac', 'flac', 'wma', 'ape', 'm4a', 'm4r', 'm4b', 'm4p', 'm4v', 'mp4', '3gp', 'avi', 'mov', 'wmv', 'flv', 'mkv', 'rmvb', 'rm', 'asf', 'dat', 'mpg', 'mpeg', 'vob', 'f4v', 'm3u8', 'webm', 'ts', 'mts', 'm2ts', 'mts', 'dv', 'divx', 'xvid', 'mpe', 'mod', 'sdp', 'm2v', 'm2p', 'm2t', 'm2ts', 'm2v', 'm2p', 'm2t', 'm2ts', 'm2v', 'm2p', 'm2t', 'm2ts', 'm2v', 'm2p', 'm2t', 'm2ts', 'm2v', 'm2p', 'm2t', 'm2ts', 'm2v', 'm2p', 'm2t', 'm2ts'
+  'mp3',
+  'wav',
+  'ogg',
+  'aac',
+  'flac',
+  'wma',
+  'ape',
+  'm4a',
+  'm4r',
+  'm4b',
+  'm4p',
+  'm4v',
+  'mp4',
+  '3gp',
+  'avi',
+  'mov',
+  'wmv',
+  'flv',
+  'mkv',
+  'rmvb',
+  'rm',
+  'asf',
+  'dat',
+  'mpg',
+  'mpeg',
+  'vob',
+  'f4v',
+  'm3u8',
+  'webm',
+  'ts',
+  'mts',
+  'm2ts',
+  'mts',
+  'dv',
+  'divx',
+  'xvid',
+  'mpe',
+  'mod',
+  'sdp',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
 ]
 
 export class AudioProtocolService extends ProtocolService<'audio'> {
@@ -40,7 +112,53 @@ export class AudioProtocolService extends ProtocolService<'audio'> {
 }
 
 export const VIDEO_SUFFIX = [
-  'mp4', '3gp', 'avi', 'mov', 'wmv', 'flv', 'mkv', 'rmvb', 'rm', 'asf', 'dat', 'mpg', 'mpeg', 'vob', 'f4v', 'm3u8', 'webm', 'ts', 'mts', 'm2ts', 'mts', 'dv', 'divx', 'xvid', 'mpe', 'mod', 'sdp', 'm2v', 'm2p', 'm2t', 'm2ts', 'm2v', 'm2p', 'm2t', 'm2ts', 'm2v', 'm2p', 'm2t', 'm2ts', 'm2v', 'm2p', 'm2t', 'm2ts', 'm2v', 'm2p', 'm2t', 'm2ts'
+  'mp4',
+  '3gp',
+  'avi',
+  'mov',
+  'wmv',
+  'flv',
+  'mkv',
+  'rmvb',
+  'rm',
+  'asf',
+  'dat',
+  'mpg',
+  'mpeg',
+  'vob',
+  'f4v',
+  'm3u8',
+  'webm',
+  'ts',
+  'mts',
+  'm2ts',
+  'mts',
+  'dv',
+  'divx',
+  'xvid',
+  'mpe',
+  'mod',
+  'sdp',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
+  'm2v',
+  'm2p',
+  'm2t',
+  'm2ts',
 ]
 
 export class VideoProtocolService extends ProtocolService<'video'> {
@@ -50,7 +168,93 @@ export class VideoProtocolService extends ProtocolService<'video'> {
 }
 
 export const TEXT_SUFFIX = [
-  'txt', 'md', 'markdown', 'json', 'js', 'ts', 'html', 'css', 'scss', 'sass', 'less', 'xml', 'yaml', 'yml', 'ini', 'log', 'bat', 'sh', 'cmd', 'c', 'cpp', 'h', 'hpp', 'java', 'py', 'go', 'php', 'sql', 'swift', 'vb', 'vbs', 'lua', 'rb', 'r', 'cs', 'm', 'mm', 'pl', 'perl', 'asm', 'asmx', 'inc', 'coffee', 'ts', 'tsx', 'jsx', 'vue', 'php', 'php3', 'php4', 'php5', 'php7', 'phps', 'phtml', 'pht', 'phar', 'phpt', 'php-cgi', 'php-cs-fixer', 'phpunit', 'phpunit.xml', 'phpunit.xml.dist', 'phpunit.phar', 'phpunit.phar.dist', 'phpunit-4.8.36.phar', 'phpunit-4.8.36.phar.dist', 'phpunit-5.7.27.phar', 'phpunit-5.7.27.phar.dist', 'phpunit-6.5.14.phar', 'phpunit-6.5.14.phar.dist', 'phpunit-7.5.20.phar', 'phpunit-7.5.20.phar.dist', 'phpunit-8.5.8.phar', 'phpunit-8.5.8.phar.dist', 'phpunit-9.3.10.phar', 'phpunit-9.3.10.phar.dist', 'phpunit-9.4.3.phar', 'phpunit-9.4.3.phar.dist', 'phpunit-9.5.0.phar', 'phpunit-9.5.0.phar.dist', 'phpunit-9.5.1.phar', 'phpunit-9.5.1.phar.dist', 'phpunit-9.5.2.phar', 'phpunit-9.5.2.phar.dist', 'phpunit-9.5.4.phar', 'phpunit-9.5.4.phar.dist', 'php'
+  'txt',
+  'md',
+  'markdown',
+  'json',
+  'js',
+  'ts',
+  'html',
+  'css',
+  'scss',
+  'sass',
+  'less',
+  'xml',
+  'yaml',
+  'yml',
+  'ini',
+  'log',
+  'bat',
+  'sh',
+  'cmd',
+  'c',
+  'cpp',
+  'h',
+  'hpp',
+  'java',
+  'py',
+  'go',
+  'php',
+  'sql',
+  'swift',
+  'vb',
+  'vbs',
+  'lua',
+  'rb',
+  'r',
+  'cs',
+  'm',
+  'mm',
+  'pl',
+  'perl',
+  'asm',
+  'asmx',
+  'inc',
+  'coffee',
+  'ts',
+  'tsx',
+  'jsx',
+  'vue',
+  'php',
+  'php3',
+  'php4',
+  'php5',
+  'php7',
+  'phps',
+  'phtml',
+  'pht',
+  'phar',
+  'phpt',
+  'php-cgi',
+  'php-cs-fixer',
+  'phpunit',
+  'phpunit.xml',
+  'phpunit.xml.dist',
+  'phpunit.phar',
+  'phpunit.phar.dist',
+  'phpunit-4.8.36.phar',
+  'phpunit-4.8.36.phar.dist',
+  'phpunit-5.7.27.phar',
+  'phpunit-5.7.27.phar.dist',
+  'phpunit-6.5.14.phar',
+  'phpunit-6.5.14.phar.dist',
+  'phpunit-7.5.20.phar',
+  'phpunit-7.5.20.phar.dist',
+  'phpunit-8.5.8.phar',
+  'phpunit-8.5.8.phar.dist',
+  'phpunit-9.3.10.phar',
+  'phpunit-9.3.10.phar.dist',
+  'phpunit-9.4.3.phar',
+  'phpunit-9.4.3.phar.dist',
+  'phpunit-9.5.0.phar',
+  'phpunit-9.5.0.phar.dist',
+  'phpunit-9.5.1.phar',
+  'phpunit-9.5.1.phar.dist',
+  'phpunit-9.5.2.phar',
+  'phpunit-9.5.2.phar.dist',
+  'phpunit-9.5.4.phar',
+  'phpunit-9.5.4.phar.dist',
+  'php',
 ]
 
 export class TextProtocolService extends ProtocolService<'text'> {
@@ -59,7 +263,7 @@ export class TextProtocolService extends ProtocolService<'text'> {
   }
 }
 
-export const serviceSuffixMap = new Map<ProtocolService<string>, string[]>
+export const serviceSuffixMap = new Map<ProtocolService<string>, string[]>()
 
 serviceSuffixMap.set(new ImageProtocolService(), IMAGE_SUFFIX)
 serviceSuffixMap.set(new AudioProtocolService(), AUDIO_SUFFIX)
@@ -67,7 +271,6 @@ serviceSuffixMap.set(new VideoProtocolService(), VIDEO_SUFFIX)
 serviceSuffixMap.set(new TextProtocolService(), TEXT_SUFFIX)
 
 export function suffix2Service(suffix: string): ProtocolService<string> | null {
-
   for (const [type, suffixes] of serviceSuffixMap.entries()) {
     if (suffixes.includes(suffix)) {
       return type
@@ -75,4 +278,4 @@ export function suffix2Service(suffix: string): ProtocolService<string> | null {
   }
 
   return null
-}
+}

package/types/division-box.ts

@@ -0,0 +1,248 @@
+/**
+ * DivisionBox Type Definitions
+ * 
+ * Shared types for DivisionBox system across main and renderer processes.
+ * These types define the contract for inter-process communication and state management.
+ */
+
+/**
+ * DivisionBox lifecycle states
+ * State machine: prepare → attach → active → inactive → detach → destroy
+ */
+export enum DivisionBoxState {
+  PREPARE = 'prepare',
+  ATTACH = 'attach',
+  ACTIVE = 'active',
+  INACTIVE = 'inactive',
+  DETACH = 'detach',
+  DESTROY = 'destroy'
+}
+
+/**
+ * Error codes for DivisionBox operations
+ */
+export enum DivisionBoxErrorCode {
+  RESOURCE_ERROR = 'RESOURCE_ERROR',
+  STATE_ERROR = 'STATE_ERROR',
+  IPC_ERROR = 'IPC_ERROR',
+  PERMISSION_DENIED = 'PERMISSION_DENIED',
+  CONFIG_ERROR = 'CONFIG_ERROR',
+  INVALID_TRANSITION = 'INVALID_TRANSITION',
+  SESSION_NOT_FOUND = 'SESSION_NOT_FOUND',
+  LIMIT_EXCEEDED = 'LIMIT_EXCEEDED'
+}
+
+/**
+ * Error messages for each error code
+ */
+export const ERROR_MESSAGES: Record<DivisionBoxErrorCode, string> = {
+  [DivisionBoxErrorCode.RESOURCE_ERROR]: 'Resource allocation or management failed',
+  [DivisionBoxErrorCode.STATE_ERROR]: 'Invalid state or state operation',
+  [DivisionBoxErrorCode.IPC_ERROR]: 'Inter-process communication failed',
+  [DivisionBoxErrorCode.PERMISSION_DENIED]: 'Permission denied for requested operation',
+  [DivisionBoxErrorCode.CONFIG_ERROR]: 'Invalid configuration provided',
+  [DivisionBoxErrorCode.INVALID_TRANSITION]: 'Invalid state transition attempted',
+  [DivisionBoxErrorCode.SESSION_NOT_FOUND]: 'Session not found',
+  [DivisionBoxErrorCode.LIMIT_EXCEEDED]: 'Resource limit exceeded'
+}
+
+/**
+ * Custom error class for DivisionBox operations
+ */
+export class DivisionBoxError extends Error {
+  constructor(
+    public readonly code: DivisionBoxErrorCode,
+    message: string,
+    public readonly sessionId?: string,
+    public readonly timestamp: number = Date.now()
+  ) {
+    super(message)
+    this.name = 'DivisionBoxError'
+    Error.captureStackTrace(this, DivisionBoxError)
+  }
+  
+  /**
+   * Gets a user-friendly error message
+   */
+  getUserMessage(): string {
+    return ERROR_MESSAGES[this.code] || 'An unknown error occurred'
+  }
+}
+
+/**
+ * Header action button configuration
+ */
+export interface HeaderAction {
+  label: string
+  icon?: string
+  onClick: () => void
+}
+
+/**
+ * Header configuration for DivisionBox
+ */
+export interface HeaderConfig {
+  show: boolean
+  title?: string
+  icon?: string
+  actions?: HeaderAction[]
+}
+
+/**
+ * Size presets for DivisionBox
+ */
+export type DivisionBoxSize = 'compact' | 'medium' | 'expanded'
+
+/**
+ * Configuration for creating a DivisionBox instance
+ */
+export interface DivisionBoxConfig {
+  /** URL to load in the WebContentsView */
+  url: string
+  
+  /** Associated plugin ID (optional) */
+  pluginId?: string
+  
+  /** Display title */
+  title: string
+  
+  /** Icon (supports iconify format) */
+  icon?: string
+  
+  /** Size preset */
+  size?: DivisionBoxSize
+  
+  /** Enable keepAlive caching mode */
+  keepAlive?: boolean
+  
+  /** Header configuration */
+  header?: HeaderConfig
+  
+  /** WebContentsView preferences (main process only) */
+  webPreferences?: any
+}
+
+/**
+ * Session metadata
+ */
+export interface SessionMeta {
+  /** Associated plugin ID */
+  pluginId?: string
+  
+  /** Display title */
+  title: string
+  
+  /** Icon */
+  icon?: string
+  
+  /** Size preset */
+  size: DivisionBoxSize
+  
+  /** KeepAlive mode enabled */
+  keepAlive: boolean
+  
+  /** Creation timestamp */
+  createdAt: number
+  
+  /** Last accessed timestamp */
+  lastAccessedAt: number
+}
+
+/**
+ * Bounds information for DivisionBox positioning
+ */
+export interface DivisionBoxBounds {
+  x: number
+  y: number
+  width: number
+  height: number
+}
+
+/**
+ * Session information returned to clients
+ */
+export interface SessionInfo {
+  /** Unique session identifier */
+  sessionId: string
+  
+  /** Current lifecycle state */
+  state: DivisionBoxState
+  
+  /** Session metadata */
+  meta: SessionMeta
+  
+  /** Position and size bounds */
+  bounds?: DivisionBoxBounds
+}
+
+/**
+ * Options for closing a DivisionBox
+ */
+export interface CloseOptions {
+  /** Delay before closing (milliseconds) */
+  delay?: number
+  
+  /** Play closing animation */
+  animation?: boolean
+  
+  /** Force close (ignore keepAlive) */
+  force?: boolean
+}
+
+/**
+ * State change event data
+ */
+export interface StateChangeEvent {
+  sessionId: string
+  oldState: DivisionBoxState
+  newState: DivisionBoxState
+  timestamp: number
+}
+
+/**
+ * IPC message types for DivisionBox operations
+ */
+export enum DivisionBoxIPCChannel {
+  OPEN = 'division-box:open',
+  CLOSE = 'division-box:close',
+  GET_STATE = 'division-box:get-state',
+  UPDATE_STATE = 'division-box:update-state',
+  GET_ACTIVE_SESSIONS = 'division-box:get-active-sessions',
+  STATE_CHANGED = 'division-box:state-changed',
+  SESSION_DESTROYED = 'division-box:session-destroyed'
+}
+
+/**
+ * IPC response wrapper
+ */
+export interface IPCResponse<T = any> {
+  success: boolean
+  data?: T
+  error?: {
+    code: DivisionBoxErrorCode
+    message: string
+  }
+}
+
+/**
+ * DivisionBox configuration in plugin manifest
+ * This configuration is declared in the plugin's manifest.json file
+ * and provides default settings for DivisionBox instances created by the plugin.
+ */
+export interface ManifestDivisionBoxConfig {
+  /** Default size preset for DivisionBox instances */
+  defaultSize?: DivisionBoxSize
+  
+  /** Enable keepAlive caching mode by default */
+  keepAlive?: boolean
+  
+  /** Default header configuration */
+  header?: {
+    /** Whether to show the header by default */
+    show?: boolean
+    /** Default title (can be overridden at runtime) */
+    title?: string
+    /** Default icon (can be overridden at runtime) */
+    icon?: string
+  }
+}

package/types/download.ts

@@ -1,10 +1,31 @@
 // 下载优先级枚举
 export enum DownloadPriority {
-  CRITICAL = 100,    // 用户手动触发
-  HIGH = 80,         // 插件安装
-  NORMAL = 50,       // 应用更新
-  LOW = 20,          // 资源文件
-  BACKGROUND = 10    // 后台预加载
+  CRITICAL = 100, // 用户手动触发
+  HIGH = 80, // 插件安装
+  NORMAL = 50, // 应用更新
+  LOW = 20, // 资源文件
+  BACKGROUND = 10, // 后台预加载
+}
+
+// 错误类型枚举
+export enum DownloadErrorType {
+  NETWORK_ERROR = 'network_error',
+  TIMEOUT_ERROR = 'timeout_error',
+  DISK_SPACE_ERROR = 'disk_space_error',
+  PERMISSION_ERROR = 'permission_error',
+  CHECKSUM_ERROR = 'checksum_error',
+  FILE_NOT_FOUND = 'file_not_found',
+  INVALID_URL = 'invalid_url',
+  CANCELLED = 'cancelled',
+  UNKNOWN_ERROR = 'unknown_error',
+}
+
+// 错误严重程度
+export enum ErrorSeverity {
+  LOW = 'low',
+  MEDIUM = 'medium',
+  HIGH = 'high',
+  CRITICAL = 'critical',
 }
 
 // 下载模块枚举
@@ -12,17 +33,17 @@ export enum DownloadModule {
   APP_UPDATE = 'app_update',
   PLUGIN_INSTALL = 'plugin_install',
   RESOURCE_DOWNLOAD = 'resource_download',
-  USER_MANUAL = 'user_manual'
+  USER_MANUAL = 'user_manual',
 }
 
 // 下载状态枚举
 export enum DownloadStatus {
-  PENDING = 'pending',       // 等待中
+  PENDING = 'pending', // 等待中
   DOWNLOADING = 'downloading', // 下载中
-  PAUSED = 'paused',         // 已暂停
-  COMPLETED = 'completed',   // 已完成
-  FAILED = 'failed',         // 失败
-  CANCELLED = 'cancelled'    // 已取消
+  PAUSED = 'paused', // 已暂停
+  COMPLETED = 'completed', // 已完成
+  FAILED = 'failed', // 失败
+  CANCELLED = 'cancelled', // 已取消
 }
 
 // 切片状态枚举
@@ -30,7 +51,7 @@ export enum ChunkStatus {
   PENDING = 'pending',
   DOWNLOADING = 'downloading',
   COMPLETED = 'completed',
-  FAILED = 'failed'
+  FAILED = 'failed',
 }
 
 // 下载任务请求接口
@@ -86,34 +107,34 @@ export interface ChunkInfo {
 // 下载配置接口
 export interface DownloadConfig {
   concurrency: {
-    maxConcurrent: number        // 最大并发数 (1-10)
-    autoAdjust: boolean          // 自动调整
-    networkAware: boolean       // 网络感知
-    priorityBased: boolean       // 基于优先级
+    maxConcurrent: number // 最大并发数 (1-10)
+    autoAdjust: boolean // 自动调整
+    networkAware: boolean // 网络感知
+    priorityBased: boolean // 基于优先级
   }
   chunk: {
-    size: number                 // 切片大小
-    resume: boolean             // 断点续传
-    autoRetry: boolean          // 自动重试
-    maxRetries: number          // 最大重试次数
+    size: number // 切片大小
+    resume: boolean // 断点续传
+    autoRetry: boolean // 自动重试
+    maxRetries: number // 最大重试次数
   }
   storage: {
-    tempDir: string             // 临时目录
-    historyRetention: number    // 历史保留天数
-    autoCleanup: boolean        // 自动清理
+    tempDir: string // 临时目录
+    historyRetention: number // 历史保留天数
+    autoCleanup: boolean // 自动清理
   }
   network: {
-    timeout: number             // 超时时间
-    retryDelay: number          // 重试延迟
-    maxRetries: number          // 最大重试次数
+    timeout: number // 超时时间
+    retryDelay: number // 重试延迟
+    maxRetries: number // 最大重试次数
   }
 }
 
 // 网络状态接口
 export interface NetworkStatus {
-  speed: number        // bytes/s
-  latency: number      // ms
-  stability: number     // 0-1
+  speed: number // bytes/s
+  latency: number // ms
+  stability: number // 0-1
   recommendedConcurrency: number
 }
 
@@ -135,28 +156,45 @@ export interface DownloadStats {
   averageSpeed: number
 }
 
+// 下载历史记录接口
+export interface DownloadHistory {
+  id: string
+  taskId: string
+  url: string
+  filename: string
+  module: DownloadModule
+  status: DownloadStatus
+  totalSize?: number
+  downloadedSize: number
+  duration?: number // seconds
+  averageSpeed?: number // bytes/s
+  destination: string
+  createdAt: Date
+  completedAt?: Date
+}
+
 // 默认下载配置
 export const defaultDownloadConfig: DownloadConfig = {
   concurrency: {
     maxConcurrent: 3,
     autoAdjust: true,
     networkAware: true,
-    priorityBased: true
+    priorityBased: true,
   },
   chunk: {
     size: 1024 * 1024, // 1MB
     resume: true,
     autoRetry: true,
-    maxRetries: 3
+    maxRetries: 3,
   },
   storage: {
     tempDir: '', // 将在运行时设置
     historyRetention: 30,
-    autoCleanup: true
+    autoCleanup: true,
   },
   network: {
     timeout: 30000,
     retryDelay: 5000,
-    maxRetries: 3
-  }
+    maxRetries: 3,
+  },
 }