@talex-touch/utils 1.0.42 → 1.0.45

package/electron/env-tool.ts

@@ -1,6 +1,8 @@
 import type { ExecException } from 'node:child_process'
-import { exec } from 'node:child_process'
 import { platform } from 'node:process'
+import { execFileSafe } from '../common/utils/safe-shell'
+
+type ExecError = { error?: unknown }
 
 export interface IGlobalPkgResult {
   exist: boolean
@@ -9,53 +11,53 @@ export interface IGlobalPkgResult {
   version?: string
 }
 
-export function checkGlobalPackageExist(packageName: string): Promise<IGlobalPkgResult> {
-  return new Promise((resolve, reject) => {
-    exec(`npm list -g ${packageName}`, (error, stdout, stderr) => {
-      if (error) {
-        reject({
-          exits: false,
-          error,
-        })
-        return
-      }
-      if (stderr) {
-        reject({
-          exits: false,
-          error: stderr,
-        })
-        return
-      }
+export async function checkGlobalPackageExist(packageName: string): Promise<IGlobalPkgResult> {
+  const name = packageName.trim()
+  if (!name) {
+    throw new Error('Package name is required')
+  }
 
-      const lines = stdout.split('\n')
-      const lastLine = lines[lines.length - 3]
-      const match = lastLine.match(/(\S+)@(\S+)/)
-      if (match) {
-        resolve({
-          exist: true,
-          name: match[1],
-          version: match[2],
-        } as IGlobalPkgResult)
-        return
-      }
+  try {
+    const { stdout, stderr } = await execFileSafe('npm', ['list', '-g', name])
+    if (stderr) {
+      const stderrError = Object.assign(new Error('Failed to check global package'), {
+        error: stderr
+      })
+      throw stderrError
+    }
 
-      resolve({
-        exist: false,
-      } as IGlobalPkgResult)
+    const lines = stdout.split('\n')
+    const lastLine = lines[lines.length - 3]
+    const match = lastLine.match(/([^@\s]+)@(\S+)/)
+    if (match) {
+      return {
+        exist: true,
+        name: match[1],
+        version: match[2]
+      } as IGlobalPkgResult
+    }
+
+    return {
+      exist: false
+    } as IGlobalPkgResult
+  } catch (error) {
+    const execError = Object.assign(new Error('Failed to check global package'), {
+      error: error as ExecError
     })
-  })
+    return Promise.reject(execError)
+  }
 }
 
 // Check npm version
 export function getNpmVersion(): Promise<string | null> {
-  return new Promise((resolve) => {
-    exec(`npm --version`, (error, stdout, stderr) => {
-      if (error || stderr)
-        resolve(null)
-
-      resolve(stdout.trim())
+  return execFileSafe('npm', ['--version'])
+    .then(({ stdout, stderr }) => {
+      if (stderr) {
+        return null
+      }
+      return stdout.trim()
     })
-  })
+    .catch(() => null)
 }
 
 export interface OSAdapter<R, T> {

package/electron/index.ts

@@ -1,3 +1,2 @@
 export * from './download-manager'
 export * from './env-tool'
-

package/env/index.ts

@@ -0,0 +1,156 @@
+export const NEXUS_BASE_URL = 'https://tuff.tagzxia.com'
+
+export interface EnvLike {
+  [key: string]: unknown
+}
+
+function getProcess(): any {
+  return (globalThis as any)?.process
+}
+
+function readGlobalEnv(): Record<string, string | undefined> {
+  const g: any = globalThis as any
+  const fromGlobal = g.__TUFF_ENV && typeof g.__TUFF_ENV === 'object' ? g.__TUFF_ENV : null
+  const record: Record<string, string | undefined> = {}
+
+  if (fromGlobal) {
+    for (const [k, v] of Object.entries(fromGlobal)) {
+      if (typeof v === 'string') {
+        record[k] = v
+      }
+      else if (typeof v === 'number' || typeof v === 'boolean') {
+        record[k] = String(v)
+      }
+    }
+  }
+
+  const p: any = getProcess()
+  if (p && p.env && typeof p.env === 'object') {
+    for (const [k, v] of Object.entries(p.env)) {
+      if (typeof v === 'string') {
+        record[k] = v
+      }
+      else if (typeof v === 'number' || typeof v === 'boolean') {
+        record[k] = String(v)
+      }
+    }
+  }
+
+  return record
+}
+
+export function setRuntimeEnv(env: Record<string, string | undefined>): void {
+  const g: any = globalThis as any
+  const normalized: Record<string, string | undefined> = {}
+  for (const [k, v] of Object.entries(env ?? {})) {
+    if (typeof v === 'string') {
+      normalized[k] = v
+    }
+    else if (typeof v === 'number' || typeof v === 'boolean') {
+      normalized[k] = String(v)
+    }
+  }
+  g.__TUFF_ENV = { ...(g.__TUFF_ENV || {}), ...normalized }
+}
+
+export function getEnv(key: string): string | undefined {
+  return readGlobalEnv()[key]
+}
+
+export function getEnvOrDefault(key: string, fallback: string): string {
+  return getEnv(key) ?? fallback
+}
+
+export function getBooleanEnv(key: string, fallback = false): boolean {
+  const raw = getEnv(key)
+  if (raw === undefined)
+    return fallback
+  if (raw === '1' || raw === 'true')
+    return true
+  if (raw === '0' || raw === 'false')
+    return false
+  return fallback
+}
+
+export function hasWindow(): boolean {
+  return typeof window !== 'undefined'
+}
+
+export function hasDocument(): boolean {
+  return typeof document !== 'undefined'
+}
+
+export function hasNavigator(): boolean {
+  return typeof navigator !== 'undefined'
+}
+
+export function isBrowserRuntime(): boolean {
+  return hasWindow() && hasDocument()
+}
+
+export function isNodeRuntime(): boolean {
+  const proc: any = getProcess()
+  return typeof proc !== 'undefined'
+    && Boolean(proc?.versions?.node)
+}
+
+export function isElectronRuntime(): boolean {
+  const proc: any = getProcess()
+  return Boolean(proc?.versions?.electron)
+}
+
+export function isElectronRenderer(): boolean {
+  const proc: any = getProcess()
+  return Boolean(proc?.versions?.electron)
+    && proc?.type === 'renderer'
+}
+
+export function isElectronMain(): boolean {
+  const proc: any = getProcess()
+  return Boolean(proc?.versions?.electron)
+    && (proc?.type === 'browser' || !proc?.type)
+}
+
+export function isDevEnv(): boolean {
+  const nodeEnv = getEnv('NODE_ENV')
+  if (nodeEnv) {
+    return nodeEnv === 'development' || nodeEnv === 'test'
+  }
+  const mode = getEnv('MODE') || getEnv('VITE_MODE')
+  if (mode) {
+    return mode === 'development'
+  }
+  return getBooleanEnv('DEV', false)
+}
+
+export function isProdEnv(): boolean {
+  const nodeEnv = getEnv('NODE_ENV')
+  if (nodeEnv) {
+    return nodeEnv === 'production'
+  }
+  const mode = getEnv('MODE') || getEnv('VITE_MODE')
+  if (mode) {
+    return mode === 'production'
+  }
+  return getBooleanEnv('PROD', false)
+}
+
+export function normalizeBaseUrl(input: string): string {
+  return input.replace(/\/$/, '')
+}
+
+export function getTuffBaseUrl(): string {
+  return normalizeBaseUrl(getEnvOrDefault('VITE_NEXUS_URL', NEXUS_BASE_URL))
+}
+
+export function getTelemetryApiBase(): string {
+  const url = normalizeBaseUrl(getEnvOrDefault('NEXUS_API_BASE', NEXUS_BASE_URL))
+  if (!url) {
+    throw new Error('Telemetry API base URL is not configured')
+  }
+  return url
+}
+
+export function getTpexApiBase(): string {
+  return normalizeBaseUrl(getEnvOrDefault('TPEX_API_BASE', NEXUS_BASE_URL))
+}

package/eslint.config.js

@@ -0,0 +1,55 @@
+const antfu = require('@antfu/eslint-config').default
+
+module.exports = antfu(
+  {
+    type: 'lib',
+    typescript: true,
+    stylistic: false,
+    unicorn: false,
+    test: false,
+    markdown: false,
+    regexp: false,
+    ignores: [
+      'plugin/sdk/examples/**',
+    ],
+  },
+  {
+    rules: {
+      'antfu/if-newline': 'off',
+      'jsdoc/check-param-names': 'off',
+      'jsdoc/empty-tags': 'off',
+      'import/consistent-type-specifier-style': 'off',
+      'import/first': 'off',
+      'node/prefer-global/buffer': 'off',
+      'node/prefer-global/process': 'off',
+      'no-console': 'off',
+      'no-useless-return': 'off',
+      'perfectionist/sort-exports': 'off',
+      'perfectionist/sort-imports': 'off',
+      'perfectionist/sort-named-exports': 'off',
+      'perfectionist/sort-named-imports': 'off',
+      'prefer-promise-reject-errors': 'off',
+      'test/prefer-lowercase-title': 'off',
+      'ts/consistent-type-definitions': 'off',
+      'ts/ban-ts-comment': 'off',
+      'ts/explicit-function-return-type': 'off',
+      'ts/method-signature-style': 'off',
+      'ts/no-namespace': 'off',
+      'ts/no-empty-object-type': 'off',
+      'ts/no-require-imports': 'off',
+      'ts/no-unsafe-function-type': 'off',
+      'ts/no-use-before-define': 'off',
+      'unicorn/escape-case': 'off',
+      'unicorn/new-for-builtins': 'off',
+      'unicorn/no-instanceof-builtins': 'off',
+      'unicorn/no-new-array': 'off',
+      'vars-on-top': 'off',
+    },
+  },
+  {
+    files: ['plugin/channel.ts'],
+    rules: {
+      'no-eval': 'off',
+    },
+  },
+)

package/i18n/index.ts

@@ -0,0 +1,62 @@
+/**
+ * I18n Utilities
+ *
+ * Shared i18n utilities for backend-frontend communication.
+ *
+ * ## Backend Usage (Main Process)
+ * ```typescript
+ * import { i18nMsg, DevServerKeys } from '@talex-touch/utils/i18n'
+ *
+ * // Send i18n message to frontend
+ * win.webContents.send('notification', {
+ *   message: i18nMsg(DevServerKeys.DISCONNECTED)
+ * })
+ * ```
+ *
+ * ## Frontend Usage (Renderer)
+ * ```typescript
+ * import { resolveI18nMessage, i18nResolver } from '@talex-touch/utils/i18n'
+ *
+ * // Set locale
+ * i18nResolver.setLocale('zh')
+ *
+ * // Resolve message
+ * const text = resolveI18nMessage('$i18n:devServer.disconnected')
+ * // => '开发服务器已断开'
+ * ```
+ */
+
+// Locale data
+export { default as enMessages } from './locales/en.json'
+
+export { default as zhMessages } from './locales/zh.json'
+
+// Message keys and utilities for backend
+export {
+  type DevServerKey,
+  DevServerKeys,
+  type FlowTransferKey,
+  FlowTransferKeys,
+  I18N_PREFIX,
+  i18nMsg,
+  i18nMsgWithParams,
+  isI18nMessage,
+  MessageKeys,
+  parseI18nMessage,
+  type PluginKey,
+  PluginKeys,
+  type SystemKey,
+  SystemKeys,
+  type WidgetKey,
+  WidgetKeys,
+} from './message-keys'
+// Resolver for frontend
+export {
+  createI18nMessage,
+  I18nResolver,
+  i18nResolver,
+  type MessageLocale,
+  type Messages,
+  resolveI18nMessage,
+  useI18nResolver,
+} from './resolver'

package/i18n/locales/en.json

@@ -0,0 +1,226 @@
+{
+  "devServer": {
+    "disconnected": "Dev Server Disconnected",
+    "disconnectedDesc": "Connection to Dev Server lost. Server may have crashed or network interrupted.",
+    "reconnected": "Dev Server Reconnected",
+    "reconnecting": "Reconnecting to Dev Server...",
+    "checkServer": "Check if Dev Server is running correctly, or try manual reconnection.",
+    "connectionLost": "Dev Server connection lost",
+    "connectionRestored": "Dev Server connection restored"
+  },
+  "flowTransfer": {
+    "shareComplete": "Share Complete",
+    "shareFailed": "Share Failed",
+    "copiedToClipboard": "Copied to Clipboard",
+    "fileRevealed": "File Revealed",
+    "airdropReady": "AirDrop Ready",
+    "mailReady": "Mail Opened",
+    "messagesReady": "Messages Opened"
+  },
+  "plugin": {
+    "loadFailed": "Plugin Load Failed",
+    "manifestInvalid": "Invalid Manifest",
+    "dependencyMissing": "Missing Dependency",
+    "versionMismatch": "Version Mismatch",
+    "permissionDenied": "Permission Denied",
+    "sdkVersionMissing": "Plugin SDK version not declared",
+    "sdkVersionOutdated": "Plugin SDK version outdated",
+    "permissionMissing": "Required permission missing"
+  },
+  "permission": {
+    "category": {
+      "fs": "Filesystem",
+      "clipboard": "Clipboard",
+      "network": "Network",
+      "system": "System",
+      "intelligence": "Intelligence",
+      "storage": "Storage",
+      "window": "Window"
+    },
+    "risk": {
+      "low": "Low Risk",
+      "medium": "Medium Risk",
+      "high": "High Risk"
+    },
+    "fs": {
+      "read": { "name": "Read Files", "desc": "Read files from your filesystem" },
+      "write": { "name": "Write Files", "desc": "Create, modify, or delete files" },
+      "execute": { "name": "Execute Files", "desc": "Run executable files or scripts" }
+    },
+    "clipboard": {
+      "read": { "name": "Read Clipboard", "desc": "Access clipboard contents" },
+      "write": { "name": "Write Clipboard", "desc": "Copy content to clipboard" }
+    },
+    "network": {
+      "local": { "name": "Local Network", "desc": "Access local network resources" },
+      "internet": { "name": "Internet Access", "desc": "Send and receive internet requests" },
+      "download": { "name": "Download Files", "desc": "Download files from the internet" }
+    },
+    "system": {
+      "shell": { "name": "Execute Commands", "desc": "Run system commands or scripts" },
+      "notification": { "name": "Notifications", "desc": "Send system notifications" },
+      "tray": { "name": "System Tray", "desc": "Access system tray features" }
+    },
+    "intelligence": {
+      "basic": { "name": "Basic Intelligence", "desc": "Use basic Intelligence capabilities" },
+      "admin": { "name": "Intelligence Admin", "desc": "Use high-risk Intelligence capabilities" },
+      "agents": { "name": "Intelligence Agents", "desc": "Invoke the agents system" }
+    },
+    "storage": {
+      "plugin": { "name": "Plugin Storage", "desc": "Use plugin private storage" },
+      "shared": { "name": "Shared Storage", "desc": "Access cross-plugin shared storage" },
+      "sqlite": { "name": "Plugin SQLite", "desc": "Read and write plugin local SQLite database" }
+    },
+    "window": {
+      "create": { "name": "Create Windows", "desc": "Create new windows or views" },
+      "capture": { "name": "Screen Capture", "desc": "Capture screen content" }
+    },
+    "grant": "Grant",
+    "revoke": "Revoke",
+    "granted": "Granted",
+    "denied": "Denied",
+    "required": "Required",
+    "optional": "Optional",
+    "allowOnce": "Allow Once",
+    "allowAlways": "Always Allow",
+    "requestTitle": "Permission Request",
+    "requestDesc": "{plugin} requests {permission} permission",
+    "enforcementDisabled": "Permission enforcement disabled",
+    "legacyPluginWarning": "This plugin uses legacy SDK, permission checks skipped"
+  },
+  "widget": {
+    "compileFailed": "Widget Compile Failed",
+    "unsupportedType": "Unsupported Widget Type",
+    "invalidDependency": "Invalid Dependency",
+    "loadFailed": "Widget Load Failed"
+  },
+  "system": {
+    "networkError": "Network Error",
+    "timeout": "Request Timeout",
+    "unknownError": "Unknown Error",
+    "operationCancelled": "Operation Cancelled"
+  },
+  "intelligence": {
+    "search": {
+      "placeholder": "Search providers...",
+      "clear": "Clear"
+    },
+    "config": {
+      "api": {
+        "apiKeyRequired": "API Key is required",
+        "baseUrlInvalid": "Invalid base URL format"
+      }
+    },
+    "usage": {
+      "requests": "Requests",
+      "tokens": "Tokens",
+      "cost": "Cost",
+      "successRate": "Success Rate",
+      "success": "Success",
+      "failure": "Failure",
+      "promptTokens": "Prompt Tokens",
+      "completionTokens": "Completion Tokens",
+      "today": "Today",
+      "thisMonth": "This Month"
+    },
+    "audit": {
+      "records": "records",
+      "noLogs": "No audit logs"
+    },
+    "agents": {
+      "enabled": "Enabled",
+      "disabled": "Disabled",
+      "empty": "No agents available",
+      "active": "Active",
+      "inactive": "Inactive",
+      "description": "Description",
+      "capabilities": "Capabilities",
+      "task_success": "Task completed successfully",
+      "task_failed": "Task execution failed"
+    },
+    "landing": {
+      "prompts": {
+        "title": "Prompt Management",
+        "desc": "Manage AI prompts for various tasks",
+        "editTitle": "Edit Prompts",
+        "editDesc": "Create and manage custom prompts",
+        "editButton": "Open Editor",
+        "folderTitle": "Prompts Folder",
+        "folderDesc": "Access prompt files directly",
+        "folderButton": "Open Folder",
+        "statsTitle": "{count} Prompts",
+        "statsDesc": "Approximately {words} words",
+        "newPromptButton": "New Prompt",
+        "folderOpenSuccess": "Prompts folder opened",
+        "folderOpenFailed": "Failed to open prompts folder",
+        "createPromptHint": "Create new prompt in the editor"
+      },
+      "capabilities": {
+        "title": "Capabilities",
+        "desc": "Configure AI capabilities and routing",
+        "manageTitle": "Manage Capabilities",
+        "manageDesc": "Configure provider bindings and models",
+        "manageButton": "Configure",
+        "auditTitle": "Audit Logs",
+        "auditDesc": "View capability invocation history",
+        "auditButton": "View Logs",
+        "statsTitle": "{count} Invocations",
+        "statsDesc": "{total} capabilities, {bound} bound, avg {freq}/day",
+        "statsButton": "View Metrics"
+      }
+    }
+  },
+  "settings": {
+    "intelligence": {
+      "selectProvider": "Select Provider",
+      "selectProviderPlaceholder": "Choose a provider",
+      "selectProviderHint": "Select a provider to view available models",
+      "testCapability": "Test Capability",
+      "testing": "Testing...",
+      "testSuccess": "Test Successful",
+      "testFailed": "Test Failed",
+      "selectModel": "Select Model",
+      "defaultModel": "Default Model",
+      "latency": "Latency",
+      "capabilitySearchPlaceholder": "Search capabilities...",
+      "capabilityListEmpty": "No capabilities found",
+      "capabilitySummary": "{count} capabilities available",
+      "providers": "Provider",
+      "addChannel": "Add Channel",
+      "emptyProviders": "No providers configured. Click 'Add Channel' to get started.",
+      "promptFilterAll": "All Prompts",
+      "builtin": "Built-in",
+      "custom": "Custom",
+      "promptMetaDescription": "No description available",
+      "promptNewDefaultName": "New Prompt {index}",
+      "promptDescriptionPlaceholder": "Enter prompt description...",
+      "promptCreateSuccess": "Prompt created successfully",
+      "promptDuplicateSuffix": "(Copy)",
+      "promptDuplicateSuccess": "Prompt duplicated successfully",
+      "promptSaveSuccess": "Prompt saved successfully",
+      "promptSaveFailed": "Failed to save prompt",
+      "promptDeleteConfirm": "Are you sure you want to delete this prompt?",
+      "promptDeleteSuccess": "Prompt deleted successfully",
+      "promptDeleteFailed": "Failed to delete prompt",
+      "promptCopySuccess": "Prompt copied to clipboard",
+      "promptImportSuccess": "{count} prompts imported successfully",
+      "promptImportFailed": "Failed to import prompts",
+      "promptExportEmpty": "No custom prompts to export",
+      "promptExportSuccess": "{count} prompts exported successfully",
+      "promptTimestampUnknown": "Unknown",
+      "promptSearchPlaceholder": "Search prompts...",
+      "promptListEmpty": "No prompts found",
+      "promptStatsLabel": "{builtin} built-in, {custom} custom",
+      "promptPageTitle": "Prompt Management",
+      "promptPageDesc": "Create and manage AI prompts for various tasks",
+      "landing": {
+        "prompts": {
+          "folderOpenSuccess": "Prompts folder opened",
+          "folderOpenFailed": "Failed to open prompts folder",
+          "statsDesc": "Approximately {words} words",
+          "newPromptButton": "New Prompt"
+        }
+      }
+    }
+  }
+}