@talex-touch/utils 1.0.33 → 1.0.34

package/common/file-scan-utils.ts

@@ -8,7 +8,6 @@
  */
 
 import type { FileScanOptions } from './file-scan-constants'
-// eslint-disable-next-line @typescript-eslint/no-var-requires
 import {
   BASE_BLACKLISTED_DIRS,
   BLACKLISTED_EXTENSIONS,

package/common/storage/constants.ts

@@ -3,6 +3,7 @@ export enum StorageList {
   SHORTCUT_SETTING = 'shortcut-setting.ini',
   OPENERS = 'openers.json',
   IntelligenceConfig = 'aisdk-config',
+  MARKET_SOURCES = 'market-sources.json',
 }
 
 /**

package/index.ts

@@ -11,3 +11,4 @@ export * from './types'
 export * from './types/download'
 export * from './types/icon'
 export * from './types/update'
+export * from './market'

package/market/constants.ts

@@ -0,0 +1,95 @@
+import { StorageList } from '../common/storage/constants'
+import type {
+  MarketProviderDefinition,
+  MarketSourcesPayload,
+  MarketSourcesStorageInfo,
+  MarketProviderTrustLevel,
+} from './types'
+
+export const MARKET_SOURCES_STORAGE_KEY = StorageList.MARKET_SOURCES
+export const MARKET_SOURCES_STORAGE_VERSION = 1
+
+function defineProvider(
+  provider: Omit<MarketProviderDefinition, 'trustLevel'> & {
+    trustLevel?: MarketProviderTrustLevel
+  },
+): MarketProviderDefinition {
+  return {
+    trustLevel: provider.trustLevel ?? 'unverified',
+    ...provider,
+  }
+}
+
+export const DEFAULT_MARKET_PROVIDERS: MarketProviderDefinition[] = [
+  defineProvider({
+    id: 'talex-official',
+    name: 'Talex Official',
+    type: 'nexusStore',
+    url: 'https://raw.githubusercontent.com/talex-touch/tuff-official-plugins/main/plugins.json',
+    description: '官方插件市场，提供经过审核的核心插件。',
+    enabled: true,
+    priority: 100,
+    trustLevel: 'official',
+    readOnly: true,
+    config: {
+      manifestUrl:
+        'https://raw.githubusercontent.com/talex-touch/tuff-official-plugins/main/plugins.json',
+      baseUrl: 'https://raw.githubusercontent.com/talex-touch/tuff-official-plugins/main/',
+    },
+  }),
+  defineProvider({
+    id: 'github-releases',
+    name: 'GitHub Releases',
+    type: 'repository',
+    description: '从 GitHub 仓库 releases / manifest 中读取插件。',
+    enabled: false,
+    priority: 80,
+    trustLevel: 'unverified',
+    config: {
+      platform: 'github',
+      apiBase: 'https://api.github.com',
+    },
+  }),
+  defineProvider({
+    id: 'gitee-repos',
+    name: 'Gitee 仓库',
+    type: 'repository',
+    description: 'Gitee 平台插件仓库，适合国内网络。',
+    enabled: false,
+    priority: 70,
+    trustLevel: 'unverified',
+    config: {
+      platform: 'gitee',
+      apiBase: 'https://gitee.com/api/v5',
+    },
+  }),
+  defineProvider({
+    id: 'npm-scope',
+    name: 'NPM 包',
+    type: 'npmPackage',
+    description: '基于 NPM 关键字或 scope 的插件发布渠道。',
+    enabled: false,
+    priority: 60,
+    trustLevel: 'unverified',
+    config: {
+      registryUrl: 'https://registry.npmjs.org',
+      keyword: 'talex-touch-plugin',
+    },
+  }),
+]
+
+export const MARKET_SOURCES_STORAGE_INFO: MarketSourcesStorageInfo = {
+  storageKey: MARKET_SOURCES_STORAGE_KEY,
+  version: MARKET_SOURCES_STORAGE_VERSION,
+}
+
+export function createDefaultMarketSourcesPayload(): MarketSourcesPayload {
+  const clone = typeof structuredClone === 'function'
+    ? structuredClone(DEFAULT_MARKET_PROVIDERS)
+    : JSON.parse(JSON.stringify(DEFAULT_MARKET_PROVIDERS))
+
+  return {
+    version: MARKET_SOURCES_STORAGE_VERSION,
+    sources: clone,
+  }
+}

package/market/index.ts

@@ -0,0 +1,2 @@
+export * from './types'
+export * from './constants'

package/market/types.ts

@@ -0,0 +1,118 @@
+import type { StorageList } from '../common/storage/constants'
+
+export type MarketProviderType = 'repository' | 'nexusStore' | 'npmPackage'
+
+export type MarketProviderTrustLevel = 'official' | 'verified' | 'unverified'
+
+export interface MarketProviderDefinition {
+  id: string
+  name: string
+  type: MarketProviderType
+  /**
+   * Base URL or identifier for the provider.
+   * Individual provider implementations can interpret this differently.
+   */
+  url?: string
+  /**
+   * Additional configuration object for provider specific options.
+   */
+  config?: Record<string, any>
+  description?: string
+  enabled: boolean
+  priority: number
+  trustLevel?: MarketProviderTrustLevel
+  tags?: string[]
+  /**
+    * Whether this provider should be treated as read-only (no install)
+    */
+  readOnly?: boolean
+}
+
+export interface MarketSourcesPayload {
+  /**
+   * Schema version, used for migrations.
+   */
+  version: number
+  sources: MarketProviderDefinition[]
+}
+
+export type MarketInstallInstruction =
+  | {
+    type: 'url'
+    url: string
+    format?: 'zip' | 'tar' | 'tgz' | 'tpex'
+    integrity?: string
+  }
+  | {
+    type: 'npm'
+    packageName: string
+    version?: string
+    registry?: string
+  }
+  | {
+    type: 'git'
+    repo: string
+    ref?: string
+    sparse?: boolean
+  }
+
+export interface MarketPlugin {
+  id: string
+  name: string
+  version?: string
+  description?: string
+  category?: string
+  tags?: string[]
+  author?: string
+  icon?: string
+  metadata?: Record<string, unknown>
+  readmeUrl?: string
+  homepage?: string
+  downloadUrl?: string
+  install?: MarketInstallInstruction
+  providerId: string
+  providerName: string
+  providerType: MarketProviderType
+  providerTrustLevel: MarketProviderTrustLevel
+  trusted: boolean
+  official?: boolean
+  timestamp?: number | string
+}
+
+export interface MarketProviderResultMeta {
+  providerId: string
+  providerName: string
+  providerType: MarketProviderType
+  success: boolean
+  error?: string
+  fetchedAt: number
+  itemCount: number
+}
+
+export interface MarketProviderListOptions {
+  keyword?: string
+  force?: boolean
+}
+
+export interface MarketHttpRequestOptions {
+  url: string
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE'
+  headers?: Record<string, string>
+  params?: Record<string, any>
+  data?: any
+  timeout?: number
+  responseType?: 'json' | 'text' | 'arraybuffer'
+}
+
+export interface MarketHttpResponse<T = unknown> {
+  status: number
+  statusText: string
+  headers: Record<string, string>
+  data: T
+  url: string
+}
+
+export interface MarketSourcesStorageInfo {
+  storageKey: StorageList
+  version: number
+}

package/package.json

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

package/plugin/index.ts

@@ -498,3 +498,4 @@ export type { IPluginLogger, LogDataType, LogItem, LogLevel } from './log/types'
 export * from './providers'
 export * from './risk'
 export * from './sdk/index'
+export * from './widget'

package/plugin/widget.ts

@@ -0,0 +1,25 @@
+export const DEFAULT_WIDGET_RENDERERS = {
+  CORE_PREVIEW_CARD: 'core-preview-card',
+  CORE_INTELLIGENCE_ANSWER: 'core-intelligence-answer',
+} as const
+
+const values = Object.values(DEFAULT_WIDGET_RENDERERS)
+export const DEFAULT_WIDGET_RENDERER_IDS = new Set<string>(values)
+
+export function isDefaultWidgetRenderer(id: string | undefined): boolean {
+  return Boolean(id) && DEFAULT_WIDGET_RENDERER_IDS.has(id!)
+}
+
+export interface WidgetRegistrationPayload {
+  widgetId: string
+  pluginName: string
+  featureId: string
+  filePath: string
+  code: string
+  styles: string
+  hash: string
+}
+
+export function makeWidgetId(pluginName: string, featureId: string): string {
+  return `${pluginName}::${featureId}`
+}

package/renderer/storage/storage-subscription.ts

@@ -0,0 +1,196 @@
+import type { IStorageChannel } from './base-storage'
+
+/**
+ * Storage subscription callback type
+ */
+export type StorageSubscriptionCallback = (data: any) => void
+
+/**
+ * Storage subscription manager for renderer process
+ * Provides easy subscription to storage updates via channel events
+ */
+class StorageSubscriptionManager {
+  private channel: IStorageChannel | null = null
+  private subscribers = new Map<string, Set<StorageSubscriptionCallback>>()
+  private channelListenerRegistered = false
+  private pendingUpdates = new Map<string, NodeJS.Timeout>()
+
+  /**
+   * Initialize the subscription manager with a channel
+   */
+  init(channel: IStorageChannel): void {
+    this.channel = channel
+
+    if (!this.channelListenerRegistered) {
+      // Listen to storage:update events from main process
+      this.channel.regChannel('storage:update', ({ data }) => {
+        const { name } = data as { name: string }
+        this.handleStorageUpdate(name)
+      })
+      this.channelListenerRegistered = true
+    }
+  }
+
+  /**
+   * Subscribe to storage changes for a specific config
+   * @param configName - The configuration file name (e.g., 'app-setting.ini')
+   * @param callback - Callback function to receive updates
+   * @returns Unsubscribe function
+   * 
+   * @example
+   * ```typescript
+   * const unsubscribe = subscribeStorage('app-setting.ini', (data) => {
+   *   console.log('Config updated:', data)
+   * })
+   * 
+   * // Later:
+   * unsubscribe()
+   * ```
+   */
+  subscribe(configName: string, callback: StorageSubscriptionCallback): () => void {
+    if (!this.subscribers.has(configName)) {
+      this.subscribers.set(configName, new Set())
+    }
+
+    this.subscribers.get(configName)!.add(callback)
+
+    // Immediately load and call with current data
+    if (this.channel) {
+      const currentData = this.channel.sendSync('storage:get', configName)
+      if (currentData) {
+        try {
+          callback(currentData)
+        }
+        catch (error) {
+          console.error(`[StorageSubscription] Callback error for "${configName}":`, error)
+        }
+      }
+    }
+
+    // Return unsubscribe function
+    return () => {
+      this.unsubscribe(configName, callback)
+    }
+  }
+
+  /**
+   * Unsubscribe from storage changes
+   * @param configName - The configuration file name
+   * @param callback - The same callback function used in subscribe
+   */
+  unsubscribe(configName: string, callback: StorageSubscriptionCallback): void {
+    const callbacks = this.subscribers.get(configName)
+    if (callbacks) {
+      callbacks.delete(callback)
+      if (callbacks.size === 0) {
+        this.subscribers.delete(configName)
+      }
+    }
+  }
+
+  /**
+   * Handle storage update events from main process
+   * @private
+   */
+  private async handleStorageUpdate(configName: string): Promise<void> {
+    const callbacks = this.subscribers.get(configName)
+    if (!callbacks || callbacks.size === 0) {
+      return
+    }
+
+    if (!this.channel) {
+      return
+    }
+
+    // Debounce updates to avoid excessive IPC and callback invocations
+    const existing = this.pendingUpdates.get(configName)
+    if (existing) {
+      clearTimeout(existing)
+    }
+
+    const timer = setTimeout(async () => {
+      // Fetch latest data
+      const data = await this.channel!.send('storage:get', configName)
+      if (!data) {
+        this.pendingUpdates.delete(configName)
+        return
+      }
+
+      // Notify all subscribers
+      callbacks.forEach((callback) => {
+        try {
+          callback(data)
+        }
+        catch (error) {
+          console.error(`[StorageSubscription] Callback error for "${configName}":`, error)
+        }
+      })
+
+      this.pendingUpdates.delete(configName)
+    }, 50) // 50ms debounce window
+
+    this.pendingUpdates.set(configName, timer)
+  }
+
+  /**
+   * Get the number of active subscriptions for a config
+   * @param configName - The configuration file name
+   * @returns Number of active callbacks subscribed to this config
+   */
+  getSubscriberCount(configName: string): number {
+    return this.subscribers.get(configName)?.size ?? 0
+  }
+
+  /**
+   * Clear all subscriptions
+   */
+  clear(): void {
+    this.subscribers.clear()
+  }
+}
+
+// Global singleton instance
+const subscriptionManager = new StorageSubscriptionManager()
+
+/**
+ * Initialize storage subscription system with channel
+ * Must be called before using subscribeStorage
+ * 
+ * @param channel - The storage channel
+ */
+export function initStorageSubscription(channel: IStorageChannel): void {
+  subscriptionManager.init(channel)
+}
+
+/**
+ * Subscribe to storage configuration changes
+ * 
+ * @param configName - Configuration file name (e.g., 'app-setting.ini')
+ * @param callback - Callback function that receives updated data
+ * @returns Unsubscribe function
+ * 
+ * @example
+ * ```typescript
+ * import { subscribeStorage } from '@talex-touch/utils/renderer/storage/storage-subscription'
+ * 
+ * const unsubscribe = subscribeStorage('app-setting.ini', (data) => {
+ *   console.log('Settings updated:', data)
+ * })
+ * 
+ * // Clean up when no longer needed
+ * unsubscribe()
+ * ```
+ */
+export function subscribeStorage(
+  configName: string,
+  callback: StorageSubscriptionCallback,
+): () => void {
+  return subscriptionManager.subscribe(configName, callback)
+}
+
+/**
+ * Get subscription manager instance (for debugging)
+ */
+export function getSubscriptionManager(): StorageSubscriptionManager {
+  return subscriptionManager
+}

package/types/icon.ts

@@ -37,6 +37,13 @@ export interface ITuffIcon {
   /** Icon value */
   value: string
 
+  /**
+   * Icon Colorful (Only for URL type)
+   * @desc This prop defines whether a URL icon should be rendered in colorful mode.
+   * It is only applicable when the icon type is 'url'.
+   */
+  colorful?: boolean
+
   /** Icon status (optional) */
   status?: TuffIconStatus