@talex-touch/utils 1.0.42 → 1.0.45

package/transport/events/types/download.ts

@@ -0,0 +1,115 @@
+import type {
+  DownloadConfig,
+  DownloadHistory,
+  DownloadRequest,
+  DownloadStats,
+  DownloadStatus,
+  DownloadTask,
+} from '../../../types/download'
+
+export type DownloadAddTaskRequest = DownloadRequest
+
+export type DownloadTaskPayload = DownloadTask
+
+export interface DownloadOpResponse {
+  success: boolean
+  error?: string
+}
+
+export type DownloadAddTaskResponse = DownloadOpResponse & {
+  taskId?: string
+}
+
+export interface DownloadTaskIdRequest {
+  taskId: string
+}
+
+export type DownloadGetTasksResponse = DownloadOpResponse & {
+  tasks?: DownloadTask[]
+}
+
+export type DownloadGetTaskStatusResponse = DownloadOpResponse & {
+  task?: DownloadTask | null
+}
+
+export type DownloadGetConfigResponse = DownloadOpResponse & {
+  config?: DownloadConfig
+}
+
+export type DownloadGetNotificationConfigResponse = DownloadOpResponse & {
+  config?: unknown
+}
+
+export type DownloadGetHistoryResponse = DownloadOpResponse & {
+  history?: DownloadHistory[]
+}
+
+export type DownloadGetLogsResponse = DownloadOpResponse & {
+  logs?: unknown
+}
+
+export type DownloadGetErrorStatsResponse = DownloadOpResponse & {
+  stats?: unknown
+}
+
+export type DownloadGetTempStatsResponse = DownloadOpResponse & {
+  stats?: unknown
+}
+
+export interface DownloadGetTasksByStatusRequest {
+  status: DownloadStatus
+}
+
+export interface DownloadUpdatePriorityRequest {
+  taskId: string
+  priority: number
+}
+
+export interface DownloadGetHistoryRequest {
+  limit?: number
+}
+
+export interface DownloadClearHistoryItemRequest {
+  historyId: string
+}
+
+export interface DownloadUpdateConfigRequest {
+  config: DownloadConfig
+}
+
+export interface DownloadUpdateNotificationConfigRequest {
+  config: unknown
+}
+
+export interface DownloadTaskRetryingPayload {
+  taskId: string
+  attempt: number
+  error: string
+  delay: number
+}
+
+export interface DownloadNotificationClickedPayload {
+  taskId: string
+  action: string
+}
+
+export type DownloadMigrationStatusResponse = DownloadOpResponse & {
+  currentVersion?: number
+  appliedMigrations?: unknown[]
+}
+
+export type DownloadMigrationNeededResponse = DownloadOpResponse & {
+  needed?: boolean
+}
+
+export type DownloadMigrationStartResponse = DownloadOpResponse & {
+  result?: { migrated: boolean }
+}
+
+export type DownloadMigrationRetryResponse = DownloadOpResponse & {
+  result?: { migrated: boolean }
+}
+
+export type DownloadGetStatsResponse = DownloadOpResponse & {
+  stats?: DownloadStats
+}

package/transport/events/types/file-index.ts

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview Type definitions for File Index events
+ * @module @talex-touch/utils/transport/events/types/file-index
+ */
+
+export type FileIndexStage
+  = | 'idle'
+    | 'cleanup'
+    | 'scanning'
+    | 'indexing'
+    | 'reconciliation'
+    | 'completed'
+    | string
+
+export interface FileIndexProgress {
+  stage: FileIndexStage
+  current: number
+  total: number
+  progress: number
+  startTime: number | null
+  estimatedRemainingMs: number | null
+  averageItemsPerSecond: number
+}
+
+export interface FileIndexStatus {
+  isInitializing: boolean
+  initializationFailed: boolean
+  error: string | null
+  progress: {
+    stage: FileIndexStage | null
+    current: number
+    total: number
+  }
+  startTime: number | null
+  estimatedCompletion: number | null
+  estimatedRemainingMs: number | null
+  averageItemsPerSecond: number
+}
+
+export interface FileIndexStats {
+  totalFiles: number
+  failedFiles: number
+  skippedFiles: number
+  completedFiles: number
+  embeddingCompletedFiles: number
+  embeddingRows: number
+}
+
+export interface FileIndexAddPathRequest {
+  path: string
+}
+
+export interface FileIndexAddPathResult {
+  success: boolean
+  status: 'added' | 'exists' | 'invalid' | 'error'
+  path?: string
+  reason?: string
+}
+
+export interface FileIndexRebuildRequest {
+  force?: boolean
+}
+
+export interface FileIndexRebuildResult {
+  success: boolean
+  message?: string
+  error?: string
+  requiresConfirm?: boolean
+  reason?: 'battery-low' | 'initializing' | 'missing-context' | 'policy-blocked'
+  battery?: FileIndexBatteryStatus | null
+  threshold?: number
+}
+
+export interface FileIndexFailedFile {
+  fileId: number
+  path: string
+  lastError: string | null
+  updatedAt: string | null
+}
+
+export interface FileIndexBatteryStatus {
+  level: number
+  charging: boolean
+}

package/transport/events/types/flow.ts

@@ -0,0 +1,149 @@
+import type {
+  FlowDispatchOptions,
+  FlowDispatchResult,
+  FlowPayload,
+  FlowPayloadType,
+  FlowSessionUpdate,
+  FlowTargetInfo,
+  NativeShareResult,
+} from '../../../types/flow'
+
+export interface FlowDispatchRequest {
+  senderId?: string
+  actorPluginId?: string
+  payload: FlowPayload
+  options?: FlowDispatchOptions
+  _sdkapi?: number
+}
+
+export interface FlowDispatchResponse {
+  success: boolean
+  data?: FlowDispatchResult
+  error?: { message: string }
+}
+
+export interface FlowGetTargetsRequest {
+  payloadType?: FlowPayloadType
+  _sdkapi?: number
+}
+
+export interface FlowGetTargetsResponse {
+  success: boolean
+  data?: FlowTargetInfo[]
+  error?: { message: string }
+}
+
+export interface FlowSessionActionRequest {
+  sessionId: string
+  _sdkapi?: number
+}
+
+export interface FlowCancelResponse {
+  success: boolean
+  data?: { cancelled: boolean }
+  error?: { message: string }
+}
+
+export interface FlowAcknowledgeRequest {
+  sessionId: string
+  ackPayload?: any
+  _sdkapi?: number
+}
+
+export interface FlowAcknowledgeResponse {
+  success: boolean
+  data?: { acknowledged: boolean }
+  error?: { message: string }
+}
+
+export interface FlowReportErrorRequest {
+  sessionId: string
+  message: string
+  _sdkapi?: number
+}
+
+export interface FlowReportErrorResponse {
+  success: boolean
+  data?: { reported: boolean }
+  error?: { message: string }
+}
+
+export interface FlowSetPluginHandlerRequest {
+  pluginId: string
+  hasHandler: boolean
+  _sdkapi?: number
+}
+
+export interface FlowRegisterTargetsRequest {
+  pluginId: string
+  targets: any[]
+  pluginName?: string
+  pluginIcon?: string
+  isEnabled?: boolean
+  _sdkapi?: number
+}
+
+export interface FlowUnregisterTargetsRequest {
+  pluginId: string
+  _sdkapi?: number
+}
+
+export interface FlowSetPluginEnabledRequest {
+  pluginId: string
+  enabled: boolean
+  _sdkapi?: number
+}
+
+export interface FlowNativeShareRequest {
+  payload: FlowPayload
+  target?: string
+  _sdkapi?: number
+}
+
+export type FlowNativeShareResponse = NativeShareResult
+
+export interface FlowSelectTargetRequest {
+  sessionId: string
+  targetId: string | null
+  _sdkapi?: number
+}
+
+export interface FlowSelectTargetResponse {
+  success: boolean
+  data?: { resolved: boolean }
+  error?: { message: string }
+}
+
+export interface FlowConsentCheckRequest {
+  senderId: string
+  targetId: string
+  _sdkapi?: number
+}
+
+export interface FlowConsentCheckResponse {
+  success: boolean
+  data?: { allowed: boolean }
+  error?: { message: string }
+}
+
+export interface FlowConsentGrantRequest {
+  senderId: string
+  targetId: string
+  mode: 'once' | 'always'
+  _sdkapi?: number
+}
+
+export interface FlowConsentGrantResponse {
+  success: boolean
+  data?: { token?: string }
+  error?: { message: string }
+}
+
+export interface FlowDeliverPayload {
+  sessionId: string
+  payload: FlowPayload
+  senderId: string
+  senderName?: string
+}
+
+export type FlowSessionUpdatePayload = FlowSessionUpdate

package/transport/events/types/index.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Type exports for all TuffTransport event domains
+ * @module @talex-touch/utils/transport/events/types
+ */
+
+// Agents domain types
+export * from './agents'
+
+// App domain types
+export * from './app'
+
+// App index domain types
+export * from './app-index'
+
+// BoxItem domain types
+export * from './box-item'
+
+// Clipboard domain types
+export * from './clipboard'
+
+// CoreBox domain types
+export * from './core-box'
+
+// Device idle domain types
+export * from './device-idle'
+
+// DivisionBox domain types
+export * from './division-box'
+
+// Download domain types
+export * from './download'
+
+// File index domain types
+export * from './file-index'
+
+// Flow domain types
+export * from './flow'
+
+// Market domain types
+export * from './market'
+
+// MetaOverlay domain types
+export * from './meta-overlay'
+
+// Notification domain types
+export * from './notification'
+
+// Permission domain types
+export * from './permission'
+
+// Platform domain types
+export * from './platform'
+
+// Plugin domain types
+export * from './plugin'
+
+// Sentry domain types
+export * from './sentry'
+
+// Storage domain types
+export * from './storage'
+
+// Transport domain types
+export * from './transport'
+
+// Tray domain types
+export * from './tray'
+
+// Update domain types
+export * from './update'

package/transport/events/types/market.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Type definitions for Market domain events
+ * @module @talex-touch/utils/transport/events/types/market
+ */
+
+import type { MarketHttpRequestOptions, MarketHttpResponse } from '../../../market/types'
+import type { MarketPluginInfo, MarketSearchOptions, MarketSearchResult } from '../../../plugin/providers'
+
+export interface MarketPluginUpdateInfo {
+  slug: string
+  currentVersion: string
+  latestVersion: string
+  hasUpdate: boolean
+  downloadUrl?: string
+  changelog?: string
+}
+
+export interface MarketCheckUpdatesResponse {
+  updates: MarketPluginUpdateInfo[]
+  checkedAt: string
+}
+
+export type MarketSearchRequest = MarketSearchOptions
+
+export type MarketSearchResponse = MarketSearchResult
+
+export interface MarketGetPluginRequest {
+  identifier?: string
+  source?: 'tpex' | 'npm'
+}
+
+export type MarketGetPluginResponse = MarketPluginInfo | null
+
+export type MarketHttpRequest = MarketHttpRequestOptions
+export type MarketHttpRequestResponse<T = unknown> = MarketHttpResponse<T>
+
+export interface MarketUpdatesAvailablePayload {
+  updates: MarketPluginUpdateInfo[]
+}

package/transport/events/types/meta-overlay.ts

@@ -0,0 +1,184 @@
+/**
+ * @fileoverview Type definitions for MetaOverlay domain events
+ * @module @talex-touch/utils/transport/events/types/meta-overlay
+ */
+
+import type { TuffItem } from '../../../core-box/tuff/tuff-dsl'
+import type { ITuffIcon } from '../../../types/icon'
+
+// ============================================================================
+// MetaAction Types
+// ============================================================================
+
+/**
+ * Simplified TuffRenderDSL for MetaOverlay actions.
+ * Does not support widgets, only basic rendering.
+ */
+export interface MetaActionRender {
+  /**
+   * Basic information
+   */
+  basic: {
+    /**
+     * Action title
+     */
+    title: string
+
+    /**
+     * Optional subtitle/description
+     */
+    subtitle?: string
+
+    /**
+     * Optional icon
+     */
+    icon?: ITuffIcon
+  }
+
+  /**
+   * Keyboard shortcut (optional)
+   * e.g., '⌘C', '⌘⇧F', '⌘⇧D'
+   */
+  shortcut?: string
+
+  /**
+   * Group title (optional)
+   * e.g., '列表', '操作'
+   */
+  group?: string
+
+  /**
+   * Whether action is disabled
+   */
+  disabled?: boolean
+
+  /**
+   * Whether this is a dangerous action (red color)
+   */
+  danger?: boolean
+}
+
+/**
+ * Meta action definition
+ */
+export interface MetaAction {
+  /**
+   * Unique action ID
+   */
+  id: string
+
+  /**
+   * Render configuration
+   */
+  render: MetaActionRender
+
+  /**
+   * Handler identifier
+   * - 'builtin': Built-in action (handled by main process)
+   * - 'item': Item-specific action (from item.actions)
+   * - plugin ID: Plugin-registered action
+   */
+  handler?: string
+
+  /**
+   * Priority for sorting (higher = top)
+   * - Built-in actions: 0
+   * - Item actions: 50
+   * - Plugin actions: 100
+   */
+  priority?: number
+}
+
+// ============================================================================
+// Request/Response Types
+// ============================================================================
+
+/**
+ * Request to show MetaOverlay
+ */
+export interface MetaShowRequest {
+  /**
+   * Current selected item
+   */
+  item: TuffItem
+
+  /**
+   * Built-in actions (fixed/copy/display/transfer)
+   */
+  builtinActions: MetaAction[]
+
+  /**
+   * Item-specific actions (from item.actions)
+   */
+  itemActions?: MetaAction[]
+
+  /**
+   * Plugin-registered global actions
+   */
+  pluginActions?: MetaAction[]
+}
+
+/**
+ * Request to execute an action
+ */
+export interface MetaActionExecuteRequest {
+  /**
+   * Action ID to execute
+   */
+  actionId: string
+
+  /**
+   * Item ID context
+   */
+  itemId: string
+}
+
+/**
+ * Response from action execution
+ */
+export interface MetaActionExecuteResponse {
+  /**
+   * Whether execution succeeded
+   */
+  success: boolean
+
+  /**
+   * Error message if failed
+   */
+  error?: string
+}
+
+/**
+ * Request to register a plugin action
+ */
+export interface MetaRegisterActionRequest {
+  /**
+   * Plugin ID
+   */
+  pluginId: string
+
+  /**
+   * Action to register
+   */
+  action: MetaAction
+}
+
+/**
+ * Request to unregister plugin actions
+ */
+export interface MetaUnregisterActionsRequest {
+  /**
+   * Plugin ID
+   */
+  pluginId: string
+}
+
+/**
+ * Response from visibility check
+ */
+export interface MetaVisibilityResponse {
+  /**
+   * Whether MetaOverlay is visible
+   */
+  visible: boolean
+}