@talex-touch/utils 1.0.29 → 1.0.31

package/renderer/index.ts

@@ -3,3 +3,4 @@ export * from './storage'
 export * from './touch-sdk'
 export * from './touch-sdk/utils'
 export * from './hooks'
+export * from '../auth' // Re-export auth for renderer

package/renderer/storage/app-settings.ts

@@ -32,5 +32,3 @@ class AppSettingsStorage extends TouchStorage<AppSetting> {
  * Global instance of the application settings
  */
 export const appSettings = new AppSettingsStorage();
-
-console.log(appSettings)

package/renderer/storage/base-storage.ts

@@ -29,8 +29,14 @@ export interface IStorageChannel extends ITouchClientChannel {
 
 let channel: IStorageChannel | null = null;
 
+/**
+ * Queue of initialization callbacks waiting for channel initialization
+ */
+const pendingInitializations: Array<() => void> = [];
+
 /**
  * Initializes the global channel for communication.
+ * Processes all pending storage initializations after initialization.
  *
  * @example
  * ```ts
@@ -45,6 +51,14 @@ let channel: IStorageChannel | null = null;
  */
 export function initStorageChannel(c: IStorageChannel): void {
   channel = c;
+
+  // Process all pending storage initializations
+  for (const initFn of pendingInitializations) {
+    initFn();
+  }
+
+  // Clear the queue
+  pendingInitializations.length = 0;
 }
 
 /**
@@ -64,6 +78,7 @@ export class TouchStorage<T extends object> {
   #assigning = false;
   readonly originalData: T;
   private readonly _onUpdate: Array<() => void> = [];
+  #channelInitialized = false;
 
   /**
    * The reactive data exposed to users.
@@ -72,6 +87,7 @@ export class TouchStorage<T extends object> {
 
   /**
    * Creates a new reactive storage instance.
+   * If channel is not initialized, the instance will be queued for initialization.
    *
    * @param qName Globally unique name for the instance
    * @param initData Initial data to populate the storage
@@ -86,30 +102,52 @@ export class TouchStorage<T extends object> {
     if (storages.has(qName)) {
       throw new Error(`Storage "${qName}" already exists`);
     }
+
+    this.#qualifiedName = qName;
+    this.originalData = initData;
+    this.data = reactive({ ...initData }) as UnwrapNestedRefs<T>;
+
+    if (onUpdate) this._onUpdate.push(onUpdate);
+
+    // Register to storages map immediately
+    storages.set(qName, this);
+
+    // Initialize channel-dependent operations
+    if (channel) {
+      this.#initializeChannel();
+    } else {
+      // Queue initialization callback for later
+      pendingInitializations.push(() => this.#initializeChannel());
+    }
+  }
+
+  /**
+   * Initialize channel-dependent operations
+   */
+  #initializeChannel(): void {
+    if (this.#channelInitialized) {
+      return;
+    }
+
     if (!channel) {
       throw new Error(
         'TouchStorage: channel is not initialized. Please call initStorageChannel(...) before using.'
       );
     }
 
-    this.#qualifiedName = qName;
-    this.originalData = initData;
-
-    // const stored = (channel.sendSync('storage:get', qName) as Partial<T>) || {};
-    this.data = reactive({ ...initData }) as UnwrapNestedRefs<T>;
-    this.loadFromRemote()
+    this.#channelInitialized = true;
 
-    if (onUpdate) this._onUpdate.push(onUpdate);
+    // Load data from remote
+    this.loadFromRemote();
 
+    // Register update listener
     channel.regChannel('storage:update', ({ data }) => {
       const { name } = data!
 
-      if (name === qName) {
+      if (name === this.#qualifiedName) {
         this.loadFromRemote()
       }
-    })
-
-    storages.set(qName, this);
+    });
   }
 
   /**
@@ -313,6 +351,7 @@ export class TouchStorage<T extends object> {
   }
   /**
    * Loads data from remote storage and applies it.
+   * If channel is not initialized yet, this method will do nothing.
    *
    * @returns The current instance
    *
@@ -323,11 +362,11 @@ export class TouchStorage<T extends object> {
    */
   loadFromRemote(): this {
     if (!channel) {
-      throw new Error("TouchStorage: channel not initialized");
+      // Channel not initialized yet, data will be loaded when channel is ready
+      return this;
     }
 
     const result = channel.sendSync('storage:get', this.#qualifiedName)
-    console.log("result", result)
     const parsed = result ? (result as Partial<T>) : {};
     this.assignData(parsed, true);
 

package/search/types.ts

@@ -16,7 +16,8 @@
  * @version 1.0.0
  */
 
-import type { IPluginIcon, IFeatureCommand } from '../plugin';
+import type { IFeatureCommand } from '../plugin';
+import type { ITuffIcon, TuffIconType } from '../types/icon';
 
 /**
  * Search Result Item Interface
@@ -59,9 +60,9 @@ export interface ISearchItem {
    * Defines how the item's icon should be displayed in the UI.
    * Supports various icon types including files, remix icons, and data URLs.
    *
-   * @see {@link IPluginIcon} for icon configuration options
+   * @see {@link ITuffIcon} for icon configuration options
    */
-  icon: IPluginIcon;
+  icon: ITuffIcon;
 
   /**
    * Whether this item supports push mode functionality
@@ -590,9 +591,8 @@ export function createDataItem(options: {
     name,
     desc,
     icon: {
-      type: iconType,
-      value: iconValue,
-      init: async () => {} // Required by IPluginIcon interface
+      type: (iconType === 'remix' || iconType === 'base64' ? 'url' : (iconType === 'file' || iconType === 'emoji' ? iconType : 'emoji')) as TuffIconType,
+      value: iconValue
     },
     push: false,                    // Data items don't support push mode
     names: [name],                  // Include name in searchable names
@@ -675,7 +675,7 @@ export function createSearchItem(options: {
   /** Description or subtitle text */
   desc: string;
   /** Icon configuration object */
-  icon: IPluginIcon;
+  icon: ITuffIcon;
   /** Name of the plugin creating this item */
   pluginName: string;
   /** Plugin type (defaults to "feature") */

package/types/download.ts

@@ -0,0 +1,162 @@
+// 下载优先级枚举
+export enum DownloadPriority {
+  CRITICAL = 100,    // 用户手动触发
+  HIGH = 80,         // 插件安装
+  NORMAL = 50,       // 应用更新
+  LOW = 20,          // 资源文件
+  BACKGROUND = 10    // 后台预加载
+}
+
+// 下载模块枚举
+export enum DownloadModule {
+  APP_UPDATE = 'app_update',
+  PLUGIN_INSTALL = 'plugin_install',
+  RESOURCE_DOWNLOAD = 'resource_download',
+  USER_MANUAL = 'user_manual'
+}
+
+// 下载状态枚举
+export enum DownloadStatus {
+  PENDING = 'pending',       // 等待中
+  DOWNLOADING = 'downloading', // 下载中
+  PAUSED = 'paused',         // 已暂停
+  COMPLETED = 'completed',   // 已完成
+  FAILED = 'failed',         // 失败
+  CANCELLED = 'cancelled'    // 已取消
+}
+
+// 切片状态枚举
+export enum ChunkStatus {
+  PENDING = 'pending',
+  DOWNLOADING = 'downloading',
+  COMPLETED = 'completed',
+  FAILED = 'failed'
+}
+
+// 下载任务请求接口
+export interface DownloadRequest {
+  id?: string
+  url: string
+  destination: string
+  filename?: string
+  priority: DownloadPriority
+  module: DownloadModule
+  metadata?: Record<string, any>
+  checksum?: string
+  headers?: Record<string, string>
+}
+
+// 下载任务实体
+export interface DownloadTask {
+  id: string
+  url: string
+  destination: string
+  filename: string
+  priority: DownloadPriority
+  module: DownloadModule
+  status: DownloadStatus
+  progress: DownloadProgress
+  chunks: ChunkInfo[]
+  metadata: Record<string, any>
+  createdAt: Date
+  updatedAt: Date
+  error?: string
+}
+
+// 下载进度接口
+export interface DownloadProgress {
+  totalSize?: number
+  downloadedSize: number
+  speed: number // bytes/s
+  remainingTime?: number // seconds
+  percentage: number // 0-100
+}
+
+// 切片信息接口
+export interface ChunkInfo {
+  index: number
+  start: number
+  end: number
+  size: number
+  downloaded: number
+  status: ChunkStatus
+  filePath: string
+}
+
+// 下载配置接口
+export interface DownloadConfig {
+  concurrency: {
+    maxConcurrent: number        // 最大并发数 (1-10)
+    autoAdjust: boolean          // 自动调整
+    networkAware: boolean       // 网络感知
+    priorityBased: boolean       // 基于优先级
+  }
+  chunk: {
+    size: number                 // 切片大小
+    resume: boolean             // 断点续传
+    autoRetry: boolean          // 自动重试
+    maxRetries: number          // 最大重试次数
+  }
+  storage: {
+    tempDir: string             // 临时目录
+    historyRetention: number    // 历史保留天数
+    autoCleanup: boolean        // 自动清理
+  }
+  network: {
+    timeout: number             // 超时时间
+    retryDelay: number          // 重试延迟
+    maxRetries: number          // 最大重试次数
+  }
+}
+
+// 网络状态接口
+export interface NetworkStatus {
+  speed: number        // bytes/s
+  latency: number      // ms
+  stability: number     // 0-1
+  recommendedConcurrency: number
+}
+
+// 队列状态接口
+export interface QueueStatus {
+  totalTasks: number
+  pendingTasks: number
+  activeTasks: number
+  completedTasks: number
+  failedTasks: number
+}
+
+// 下载统计接口
+export interface DownloadStats {
+  totalTasks: number
+  completedTasks: number
+  failedTasks: number
+  totalDownloaded: number
+  averageSpeed: number
+}
+
+// 默认下载配置
+export const defaultDownloadConfig: DownloadConfig = {
+  concurrency: {
+    maxConcurrent: 3,
+    autoAdjust: true,
+    networkAware: true,
+    priorityBased: true
+  },
+  chunk: {
+    size: 1024 * 1024, // 1MB
+    resume: true,
+    autoRetry: true,
+    maxRetries: 3
+  },
+  storage: {
+    tempDir: '', // 将在运行时设置
+    historyRetention: 30,
+    autoCleanup: true
+  },
+  network: {
+    timeout: 30000,
+    retryDelay: 5000,
+    maxRetries: 3
+  }
+}

package/types/icon.ts

@@ -0,0 +1,45 @@
+/**
+ * Icon type definitions
+ *
+ * @description
+ * Defines common icon interfaces and types, supporting emoji, url, and file types
+ */
+
+/**
+ * Icon type enumeration
+ * @description
+ * - emoji: Emoji characters (e.g., "🚀")
+ * - url: Remote URL (http/https) or Data URL (data:image/...)
+ * - file: Local file path (relative to plugin root directory)
+ * - class: Class name (e.g., "i-ri-rocket-line")
+ */
+export type TuffIconType = 'emoji' | 'url' | 'file' | 'class'
+
+/**
+ * Icon status enumeration
+ * @description
+ * - normal: Normal state
+ * - loading: Loading state
+ * - error: Error state
+ */
+export type TuffIconStatus = 'normal' | 'loading' | 'error'
+
+/**
+ * Common icon interface
+ *
+ * @description
+ * Unified icon data structure supporting three icon types and status management
+ */
+export interface ITuffIcon {
+  /** Icon type */
+  type: TuffIconType
+
+  /** Icon value */
+  value: string
+
+  /** Icon status (optional) */
+  status?: TuffIconStatus
+
+  /** Error message (when status is error) */
+  error?: string
+}

package/types/index.ts

@@ -1,2 +1,3 @@
 export * from './touch-app-core'
 export * from './modules'
+export * from './storage'

package/types/modules/module-lifecycle.ts

@@ -1,4 +1,4 @@
-import { ITouchEventBus } from "packages/utils/eventbus";
+import { ITouchEventBus } from "../../eventbus";
 import { ModuleKey } from ".";
 import { TalexTouch } from "../touch-app-core";
 import { ModuleDirectory, ResolvedModuleFileConfig } from "./base";

package/types/storage.ts

@@ -0,0 +1,56 @@
+/**
+ * Plugin storage statistics
+ */
+export interface StorageStats {
+  /** Total size in bytes */
+  totalSize: number
+  /** Number of files (excluding directories) */
+  fileCount: number
+  /** Number of directories */
+  dirCount: number
+  /** Maximum size limit in bytes (10MB) */
+  maxSize: number
+  /** Usage percentage (0-100) */
+  usagePercent: number
+}
+
+/**
+ * Storage tree node representing a file or directory
+ */
+export interface StorageTreeNode {
+  /** File or directory name */
+  name: string
+  /** Relative path from storage root */
+  path: string
+  /** Node type */
+  type: 'file' | 'directory'
+  /** Size in bytes (for directories, this is the total size of all contained files) */
+  size: number
+  /** Last modified timestamp */
+  modified: number
+  /** Child nodes (only for directories) */
+  children?: StorageTreeNode[]
+}
+
+/**
+ * Detailed information about a specific file
+ */
+export interface FileDetails {
+  /** File name */
+  name: string
+  /** Relative path from storage root */
+  path: string
+  /** File size in bytes */
+  size: number
+  /** Creation timestamp */
+  created: number
+  /** Last modified timestamp */
+  modified: number
+  /** File type (extension or detected type) */
+  type: string
+  /** File content (if available and size permits) */
+  content?: any
+  /** Whether content was truncated due to size */
+  truncated?: boolean
+}
+

package/types/update.ts

@@ -0,0 +1,99 @@
+// 更新源类型枚举
+export enum UpdateProviderType {
+  GITHUB = 'github',
+  OFFICIAL = 'official',
+  CUSTOM = 'custom'
+}
+
+// 更新源配置接口
+export interface UpdateSourceConfig {
+  type: UpdateProviderType
+  name: string
+  url?: string
+  enabled: boolean
+  priority: number
+}
+
+// 下载资源接口
+export interface DownloadAsset {
+  name: string
+  url: string
+  size: number
+  platform: 'win32' | 'darwin' | 'linux'
+  arch: 'x64' | 'arm64'
+  checksum?: string
+}
+
+// GitHub Release接口（兼容GitHub API格式）
+export interface GitHubRelease {
+  tag_name: string
+  name: string
+  published_at: string
+  body: string
+  assets: DownloadAsset[]
+}
+
+// 更新检查结果接口
+export interface UpdateCheckResult {
+  hasUpdate: boolean
+  release?: GitHubRelease
+  error?: string
+  source: string
+}
+
+// 自定义更新源配置
+export interface CustomUpdateConfig {
+  name: string
+  url: string
+  apiFormat: 'github' | 'custom'
+  headers?: Record<string, string>
+}
+
+// 应用预览渠道枚举
+export enum AppPreviewChannel {
+  MASTER = 'master',
+  SNAPSHOT = 'snapshot'
+}
+
+// 更新设置配置
+export interface UpdateSettings {
+  enabled: boolean
+  frequency: 'startup' | 'daily' | 'weekly' | 'manual'
+  source: UpdateSourceConfig
+  crossChannel: boolean
+  ignoredVersions: string[]
+  customSources: CustomUpdateConfig[]
+}
+
+// 默认更新设置
+export const defaultUpdateSettings: UpdateSettings = {
+  enabled: true,
+  frequency: 'startup',
+  source: {
+    type: UpdateProviderType.GITHUB,
+    name: 'GitHub Releases',
+    url: 'https://api.github.com/repos/talex-touch/tuff/releases',
+    enabled: true,
+    priority: 1
+  },
+  crossChannel: false,
+  ignoredVersions: [],
+  customSources: []
+}
+
+// 更新错误类型
+export enum UpdateErrorType {
+  NETWORK_ERROR = 'network_error',
+  TIMEOUT_ERROR = 'timeout_error',
+  API_ERROR = 'api_error',
+  PARSE_ERROR = 'parse_error',
+  VERSION_ERROR = 'version_error',
+  UNKNOWN_ERROR = 'unknown_error'
+}
+
+// 更新错误接口
+export interface UpdateError extends Error {
+  type: UpdateErrorType
+  code?: string
+  statusCode?: number
+}