@talex-touch/utils 1.0.40 → 1.0.44

package/types/modules/base.ts

@@ -1,3 +1,5 @@
+import type { Buffer } from 'node:buffer'
+
 /**
  * Unique key for a module.
  * @public

package/types/path-browserify.d.ts

@@ -0,0 +1,5 @@
+declare module 'path-browserify' {
+  import type * as path from 'path'
+  const pathBrowserify: typeof path
+  export = pathBrowserify
+}

package/types/platform.ts

@@ -0,0 +1,12 @@
+export type PlatformCapabilityScope = 'system' | 'plugin' | 'ai'
+
+export type PlatformCapabilityStatus = 'alpha' | 'beta' | 'stable'
+
+export interface PlatformCapability {
+  id: string
+  name: string
+  description: string
+  scope: PlatformCapabilityScope
+  status: PlatformCapabilityStatus
+  sensitive?: boolean
+}

package/types/startup-info.ts

@@ -0,0 +1,32 @@
+export interface StartupPaths {
+  appDataPath: string
+  appPath: string
+  configPath: string
+  exePath: string
+  homePath: string
+  modulePath: string
+  pluginPath: string
+  rootPath: string
+  tempPath: string
+  userDataPath: string
+}
+
+export interface StartupInfo {
+  id: number
+  version: string
+  path: StartupPaths
+  isPackaged: boolean
+  isDev: boolean
+  isRelease: boolean
+  platform: string
+  arch: string
+  platformWarning?: string
+  t: {
+    _s: number
+    s: number
+    e: number
+    p: number
+    h: number[]
+  }
+  appUpdate?: boolean
+}

package/types/touch-app-core.ts

@@ -26,13 +26,13 @@ export namespace TalexTouch {
      * the close button of the window. The web page may cancel the close though. See
      * the close event.
      */
-    close(): void
+    close: () => void
 
     /**
      * Minimizes the window. On some platforms the minimized window will be shown in
      * the Dock.
      */
-    minimize(): void
+    minimize: () => void
 
     /**
      * Opens the devtools.
@@ -43,16 +43,16 @@ export namespace TalexTouch {
      * On Windows, if Windows Control Overlay is enabled, Devtools will be opened with
      * `mode: 'detach'`.
      */
-    openDevTools(options?: OpenDevToolsOptions): void
+    openDevTools: (options?: OpenDevToolsOptions) => void
 
-    loadURL(
+    loadURL: (
       url: string,
       options?: LoadURLOptions | undefined,
-    ): Promise<Electron.WebContents>
-    loadFile(
+    ) => Promise<Electron.WebContents>
+    loadFile: (
       filePath: string,
       options?: LoadFileOptions | undefined,
-    ): Promise<Electron.WebContents>
+    ) => Promise<Electron.WebContents>
   }
 
   export type TouchWindowConstructorOptions
@@ -76,7 +76,7 @@ export namespace TalexTouch {
   export interface IConfiguration {
     configPath: string
     data: TouchAppConfig
-    triggerSave: Function
+    triggerSave: () => void
   }
 
   export interface TouchAppConfig {

package/types/update.ts

@@ -97,6 +97,14 @@ export interface UpdateSettings {
   updateChannel: AppPreviewChannel
   ignoredVersions: string[]
   customSources: CustomUpdateConfig[]
+  /**
+   * Automatically download update packages when available.
+   */
+  autoDownload?: boolean
+  /**
+   * Enable experimental renderer override updates.
+   */
+  rendererOverrideEnabled?: boolean
   /**
    * Timestamp (ms) of the last successful update check.
    */
@@ -123,6 +131,11 @@ export interface UpdateSettings {
   retryDelay?: number
 }
 
+export const UPDATE_GITHUB_REPO = 'talex-touch/tuff'
+export const UPDATE_GITHUB_RELEASES_API = `https://api.github.com/repos/${UPDATE_GITHUB_REPO}/releases`
+export const UPDATE_TAG_PREFIX = 'v'
+export const UPDATE_RELEASE_MANIFEST_NAME = 'tuff-release-manifest.json'
+
 /**
  * Safe defaults used when no user configuration exists yet.
  */
@@ -132,13 +145,15 @@ export const defaultUpdateSettings: UpdateSettings = {
   source: {
     type: UpdateProviderType.GITHUB,
     name: 'GitHub Releases',
-    url: 'https://api.github.com/repos/talex-touch/tuff/releases',
+    url: UPDATE_GITHUB_RELEASES_API,
     enabled: true,
     priority: 1,
   },
   updateChannel: AppPreviewChannel.RELEASE,
   ignoredVersions: [],
   customSources: [],
+  autoDownload: false,
+  rendererOverrideEnabled: false,
   lastCheckedAt: null,
   cacheEnabled: true,
   cacheTTL: 30,
@@ -147,6 +162,84 @@ export const defaultUpdateSettings: UpdateSettings = {
   retryDelay: 2000,
 }
 
+const UPDATE_CHANNEL_LABELS = {
+  beta: ['BETA', 'SNAPSHOT', 'ALPHA'],
+  release: ['RELEASE', 'MASTER'],
+}
+
+/**
+ * Resolve a release channel from the tag suffix label.
+ */
+export function resolveUpdateChannelLabel(label?: string): AppPreviewChannel {
+  const normalized = (label || '').trim().toUpperCase()
+
+  if (UPDATE_CHANNEL_LABELS.beta.some((value) => normalized.startsWith(value))) {
+    return AppPreviewChannel.BETA
+  }
+  if (UPDATE_CHANNEL_LABELS.release.some((value) => normalized.startsWith(value))) {
+    return AppPreviewChannel.RELEASE
+  }
+
+  return AppPreviewChannel.RELEASE
+}
+
+/**
+ * Split an update tag into the numeric version part and optional channel label.
+ * Expected format: v<major>.<minor>.<patch>[-<channel>]
+ */
+export function splitUpdateTag(tag: string): { version: string; channelLabel?: string } {
+  const trimmed = tag.trim()
+  const cleaned = trimmed.toLowerCase().startsWith(UPDATE_TAG_PREFIX)
+    ? trimmed.slice(UPDATE_TAG_PREFIX.length)
+    : trimmed
+  const [version = '', channelLabel] = cleaned.split('-', 2)
+  return { version, channelLabel }
+}
+
+export function parseUpdateTag(tag: string): { version: string; channel: AppPreviewChannel } {
+  const { version, channelLabel } = splitUpdateTag(tag)
+  return { version, channel: resolveUpdateChannelLabel(channelLabel) }
+}
+
+export type UpdateArtifactComponent = 'core' | 'renderer' | 'extensions'
+
+export type SystemUpdateType = 'announcement' | 'config' | 'data'
+
+export interface FxRatePayload {
+  kind: 'fx-rate'
+  base: string
+  asOf?: string
+  providerUpdatedAt?: string | null
+  fetchedAt: string
+  providerNextUpdateAt?: string | null
+  ttlMs?: number
+  source?: string
+  rates: Record<string, number>
+}
+
+export type SystemUpdatePayload = FxRatePayload | { kind: string; [key: string]: unknown }
+
+export interface UpdateReleaseArtifact {
+  name: string
+  component: UpdateArtifactComponent
+  platform?: 'win32' | 'darwin' | 'linux'
+  arch?: 'x64' | 'arm64'
+  sha256: string
+  signature?: string
+  signatureKey?: string
+  coreRange?: string
+}
+
+export interface UpdateReleaseManifest {
+  schemaVersion: 1
+  release: {
+    version: string
+    channel: AppPreviewChannel
+    tag: string
+  }
+  artifacts: UpdateReleaseArtifact[]
+}
+
 /**
  * Categorized error types emitted by the updater pipeline.
  */

package/vitest.config.ts

@@ -0,0 +1,25 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['__tests__/**/*.test.ts'],
+    exclude: ['**/node_modules/**', '**/dist/**'],
+    testTimeout: 10000,
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      include: [
+        'core-box/**/*.ts',
+        'search/**/*.ts',
+        'transport/**/*.ts',
+      ],
+      exclude: [
+        '**/*.d.ts',
+        '**/index.ts',
+        '**/types.ts',
+      ],
+    },
+  },
+})

package/auth/useClerkConfig.ts

@@ -1,40 +0,0 @@
-import type { ClerkConfig } from './clerk-types'
-
-const clerkPublishableKey = (import.meta.env as any).VITE_CLERK_PUBLISHABLE_KEY
-const clerkDomain = (import.meta.env as any).VITE_CLERK_DOMAIN
-
-if (!clerkPublishableKey?.length) {
-  throw new Error('VITE_CLERK_PUBLISHABLE_KEY is not set')
-}
-
-export const CLERK_PUBLISHABLE_KEY_KEY = 'clerk-publishable-key'
-
-export const defaultClerkConfig: ClerkConfig = {
-  publishableKey: clerkPublishableKey,
-  domain: clerkDomain,
-  signInUrl: '/sign-in',
-  signUpUrl: '/sign-up',
-  afterSignInUrl: '/home',
-  afterSignUpUrl: '/home',
-}
-
-export function useClerkConfig() {
-  const getClerkConfig = (): ClerkConfig => {
-    return {
-      ...defaultClerkConfig,
-      publishableKey:
-        localStorage.getItem(CLERK_PUBLISHABLE_KEY_KEY) || defaultClerkConfig.publishableKey,
-    }
-  }
-
-  const setClerkConfig = (config: Partial<ClerkConfig>): void => {
-    if (config.publishableKey) {
-      localStorage.setItem(CLERK_PUBLISHABLE_KEY_KEY, config.publishableKey)
-    }
-  }
-
-  return {
-    getClerkConfig,
-    setClerkConfig,
-  }
-}

package/auth/useClerkProvider.ts

@@ -1,52 +0,0 @@
-import { Clerk } from '@clerk/clerk-js'
-import { useClerkConfig } from './useClerkConfig'
-
-let clerkInstance: Clerk | null = null
-
-export function useClerkProvider() {
-  const initializeClerk = async (): Promise<Clerk> => {
-    if (clerkInstance) {
-      return clerkInstance
-    }
-
-    const { getClerkConfig } = useClerkConfig()
-    const config = getClerkConfig()
-
-    if (!config.publishableKey) {
-      throw new Error('Clerk publishable key is required')
-    }
-
-    try {
-      clerkInstance = new Clerk(config.publishableKey)
-      await clerkInstance.load()
-
-      console.log('Clerk initialized successfully')
-      return clerkInstance
-    }
-    catch (error) {
-      console.error('Failed to initialize Clerk:', error)
-      throw error
-    }
-  }
-
-  const getClerk = (): Clerk | null => {
-    return clerkInstance
-  }
-
-  const isClerkInitialized = (): boolean => {
-    return clerkInstance !== null
-  }
-
-  const cleanupClerk = (): void => {
-    if (clerkInstance) {
-      clerkInstance = null
-    }
-  }
-
-  return {
-    initializeClerk,
-    getClerk,
-    isClerkInitialized,
-    cleanupClerk,
-  }
-}