@talex-touch/utils 1.0.42 → 1.0.44

package/account/index.ts

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

package/account/types.ts

@@ -0,0 +1,321 @@
+/**
+ * Account subscription plan types
+ */
+export enum SubscriptionPlan {
+  FREE = 'free',
+  PRO = 'pro',
+  PLUS = 'plus',
+  TEAM = 'team',
+  ENTERPRISE = 'enterprise',
+}
+
+/**
+ * Subscription billing cycle
+ */
+export enum BillingCycle {
+  MONTHLY = 'monthly',
+  YEARLY = 'yearly',
+  LIFETIME = 'lifetime',
+}
+
+/**
+ * Subscription status
+ */
+export enum SubscriptionStatus {
+  ACTIVE = 'active',
+  TRIALING = 'trialing',
+  PAST_DUE = 'past_due',
+  CANCELED = 'canceled',
+  EXPIRED = 'expired',
+  PAUSED = 'paused',
+}
+
+/**
+ * Account verification status
+ */
+export enum VerificationStatus {
+  UNVERIFIED = 'unverified',
+  PENDING = 'pending',
+  VERIFIED = 'verified',
+}
+
+/**
+ * User role in organization/team
+ */
+export enum TeamRole {
+  OWNER = 'owner',
+  ADMIN = 'admin',
+  MEMBER = 'member',
+  GUEST = 'guest',
+}
+
+/**
+ * Feature flag for gated features
+ */
+export interface FeatureFlag {
+  id: string
+  enabled: boolean
+  value?: string | number | boolean
+}
+
+/**
+ * Plan quota limits
+ */
+export interface PlanQuota {
+  /** AI requests per day */
+  aiRequestsPerDay: number
+  /** AI tokens per month */
+  aiTokensPerMonth: number
+  /** Max plugins allowed */
+  maxPlugins: number
+  /** Max storage in bytes */
+  maxStorageBytes: number
+  /** Max team members (for team/enterprise) */
+  maxTeamMembers?: number
+  /** Max workspaces */
+  maxWorkspaces?: number
+  /** Custom model access */
+  customModelAccess: boolean
+  /** Priority support */
+  prioritySupport: boolean
+  /** API access */
+  apiAccess: boolean
+  /** Advanced analytics */
+  advancedAnalytics: boolean
+}
+
+/**
+ * Current usage statistics
+ */
+export interface UsageStats {
+  /** AI requests used today */
+  aiRequestsToday: number
+  /** AI requests used this month */
+  aiRequestsThisMonth: number
+  /** AI tokens used this month */
+  aiTokensThisMonth: number
+  /** Storage used in bytes */
+  storageUsedBytes: number
+  /** Plugins installed count */
+  pluginsInstalled: number
+  /** Last activity timestamp */
+  lastActivityAt?: number
+}
+
+/**
+ * Subscription details
+ */
+export interface Subscription {
+  /** Subscription ID */
+  id: string
+  /** Current plan */
+  plan: SubscriptionPlan
+  /** Subscription status */
+  status: SubscriptionStatus
+  /** Billing cycle */
+  billingCycle: BillingCycle
+  /** Plan quota limits */
+  quota: PlanQuota
+  /** Current usage */
+  usage: UsageStats
+  /** Start date */
+  startedAt: number
+  /** Current period end date */
+  currentPeriodEnd: number
+  /** Trial end date (if trialing) */
+  trialEndAt?: number
+  /** Cancellation date (if canceled) */
+  canceledAt?: number
+  /** Cancel at period end */
+  cancelAtPeriodEnd: boolean
+  /** Auto-renew enabled */
+  autoRenew: boolean
+  /** Payment method on file */
+  hasPaymentMethod: boolean
+  /** Price in cents */
+  priceInCents?: number
+  /** Currency code */
+  currency?: string
+}
+
+/**
+ * Social connection info
+ */
+export interface SocialConnection {
+  provider: 'google' | 'github' | 'apple' | 'microsoft' | 'discord' | 'twitter'
+  providerId: string
+  email?: string
+  username?: string
+  avatarUrl?: string
+  connectedAt: number
+}
+
+/**
+ * User profile
+ */
+export interface UserProfile {
+  /** User ID */
+  id: string
+  /** Display name */
+  displayName: string
+  /** Username (unique) */
+  username?: string
+  /** First name */
+  firstName?: string
+  /** Last name */
+  lastName?: string
+  /** Primary email */
+  email: string
+  /** Email verified */
+  emailVerified: boolean
+  /** Avatar URL */
+  avatarUrl?: string
+  /** Phone number */
+  phone?: string
+  /** Phone verified */
+  phoneVerified?: boolean
+  /** Bio/description */
+  bio?: string
+  /** Locale/language preference */
+  locale?: string
+  /** Timezone */
+  timezone?: string
+  /** Account created at */
+  createdAt: number
+  /** Last updated at */
+  updatedAt: number
+  /** Last sign in at */
+  lastSignInAt?: number
+  /** Two-factor enabled */
+  twoFactorEnabled: boolean
+  /** Connected social accounts */
+  socialConnections: SocialConnection[]
+}
+
+/**
+ * Team/Organization info
+ */
+export interface Team {
+  /** Team ID */
+  id: string
+  /** Team name */
+  name: string
+  /** Team slug (URL-safe) */
+  slug: string
+  /** Team logo URL */
+  logoUrl?: string
+  /** Team description */
+  description?: string
+  /** User's role in team */
+  role: TeamRole
+  /** Member count */
+  memberCount: number
+  /** Team created at */
+  createdAt: number
+  /** Team subscription (if separate from user) */
+  subscription?: Subscription
+}
+
+/**
+ * Device session info
+ */
+export interface DeviceSession {
+  /** Session ID */
+  id: string
+  /** Device name/type */
+  deviceName: string
+  /** Device type */
+  deviceType: 'desktop' | 'mobile' | 'tablet' | 'unknown'
+  /** Operating system */
+  os?: string
+  /** Browser/client */
+  client?: string
+  /** IP address */
+  ipAddress?: string
+  /** Location (city, country) */
+  location?: string
+  /** Is current session */
+  isCurrent: boolean
+  /** Last active at */
+  lastActiveAt: number
+  /** Created at */
+  createdAt: number
+}
+
+/**
+ * Complete account info
+ */
+export interface AccountInfo {
+  /** User profile */
+  profile: UserProfile
+  /** Subscription details */
+  subscription: Subscription
+  /** Teams user belongs to */
+  teams: Team[]
+  /** Active sessions */
+  sessions: DeviceSession[]
+  /** Feature flags */
+  features: FeatureFlag[]
+  /** Account verification status */
+  verificationStatus: VerificationStatus
+  /** Is beta tester */
+  isBetaTester: boolean
+  /** Referral code */
+  referralCode?: string
+  /** Referred by user ID */
+  referredBy?: string
+  /** Referral count */
+  referralCount: number
+}
+
+/**
+ * Account SDK configuration
+ */
+export interface AccountSDKConfig {
+  /** API base URL */
+  apiBaseUrl?: string
+  /** Cache TTL in milliseconds */
+  cacheTTL?: number
+  /** Enable offline mode */
+  offlineMode?: boolean
+}
+
+/**
+ * Quota check result
+ */
+export interface QuotaCheckResult {
+  /** Is allowed */
+  allowed: boolean
+  /** Reason if not allowed */
+  reason?: string
+  /** Remaining quota */
+  remaining?: number
+  /** Reset time */
+  resetAt?: number
+}
+
+/**
+ * Plan comparison item
+ */
+export interface PlanComparisonItem {
+  feature: string
+  free: string | boolean | number
+  pro: string | boolean | number
+  plus: string | boolean | number
+  team: string | boolean | number
+  enterprise: string | boolean | number
+}
+
+/**
+ * Upgrade options
+ */
+export interface UpgradeOption {
+  plan: SubscriptionPlan
+  name: string
+  description: string
+  priceMonthly: number
+  priceYearly: number
+  currency: string
+  features: string[]
+  recommended?: boolean
+}

package/analytics/client.ts

@@ -0,0 +1,136 @@
+import type { ITuffTransport } from '../transport'
+import type {
+  CounterPayload,
+  FeatureStats,
+  GaugePayload,
+  HistogramPayload,
+  PluginAnalyticsSDK,
+  PluginStats,
+} from './types'
+import { hasWindow } from '../env'
+import { useTuffTransport } from '../transport'
+import { AppEvents } from '../transport/events'
+
+const emptyStats: PluginStats = {
+  featureCalls: {},
+  totalCalls: 0,
+  avgResponseTime: 0,
+  topFeatures: [],
+  counters: {},
+  gauges: {},
+  histograms: {},
+}
+
+/**
+ * Create a plugin/renderer analytics client powered by TuffTransport.
+ */
+export function createPluginAnalyticsClient(options?: {
+  pluginName?: string
+  pluginVersion?: string
+  transport?: ITuffTransport
+}): PluginAnalyticsSDK {
+  let transport = options?.transport
+  const pluginName = options?.pluginName
+  const pluginVersion = options?.pluginVersion ?? resolveRuntimePluginVersion()
+
+  const getTransport = () => {
+    if (transport)
+      return transport
+    try {
+      transport = useTuffTransport()
+      return transport
+    }
+    catch {
+      return null
+    }
+  }
+
+  const withDefaultPlugin = <T extends Record<string, any>>(
+    payload: T,
+  ): T & { pluginName?: string, pluginVersion?: string } => ({
+    ...payload,
+    pluginName: payload.pluginName ?? pluginName,
+    pluginVersion: payload.pluginVersion ?? pluginVersion,
+  })
+
+  return {
+    async trackEvent(eventName, metadata, featureId) {
+      const tx = getTransport()
+      if (!tx)
+        return
+      await tx.send(AppEvents.analytics.sdk.trackEvent, withDefaultPlugin({ eventName, featureId, metadata }))
+    },
+
+    async trackDuration(operationName, durationMs, featureId) {
+      const tx = getTransport()
+      if (!tx)
+        return
+      await tx.send(AppEvents.analytics.sdk.trackDuration, withDefaultPlugin({ operationName, durationMs, featureId }))
+    },
+
+    async measure(operationName, fn) {
+      const startedAt = Date.now()
+      try {
+        const result = await fn()
+        await this.trackDuration(operationName, Date.now() - startedAt)
+        return result
+      }
+      catch (error) {
+        await this.trackDuration(operationName, Date.now() - startedAt)
+        throw error
+      }
+    },
+
+    async getStats() {
+      const tx = getTransport()
+      if (!tx)
+        return emptyStats
+      return tx.send(AppEvents.analytics.sdk.getStats, withDefaultPlugin({}))
+    },
+
+    async getFeatureStats(featureId) {
+      const tx = getTransport()
+      if (!tx)
+        return { count: 0, avgDuration: 0 } satisfies FeatureStats
+      return tx.send(AppEvents.analytics.sdk.getFeatureStats, withDefaultPlugin({ featureId }))
+    },
+
+    async getTopFeatures(limit) {
+      const tx = getTransport()
+      if (!tx)
+        return []
+      return tx.send(AppEvents.analytics.sdk.getTopFeatures, withDefaultPlugin({ limit }))
+    },
+
+    async incrementCounter(name, value) {
+      const tx = getTransport()
+      if (!tx)
+        return
+      const payload: CounterPayload = { name, value }
+      await tx.send(AppEvents.analytics.sdk.incrementCounter, withDefaultPlugin(payload))
+    },
+
+    async setGauge(name, value) {
+      const tx = getTransport()
+      if (!tx)
+        return
+      const payload: GaugePayload = { name, value }
+      await tx.send(AppEvents.analytics.sdk.setGauge, withDefaultPlugin(payload))
+    },
+
+    async recordHistogram(name, value) {
+      const tx = getTransport()
+      if (!tx)
+        return
+      const payload: HistogramPayload = { name, value }
+      await tx.send(AppEvents.analytics.sdk.recordHistogram, withDefaultPlugin(payload))
+    },
+  }
+}
+
+function resolveRuntimePluginVersion(): string | undefined {
+  if (!hasWindow())
+    return undefined
+  const plugin = (window as any).$plugin as { version?: unknown } | undefined
+  return typeof plugin?.version === 'string' ? plugin.version : undefined
+}

package/analytics/index.ts

@@ -0,0 +1,2 @@
+export { createPluginAnalyticsClient } from './client'
+export * from './types'

package/analytics/types.ts

@@ -0,0 +1,156 @@
+/**
+ * Shared analytics types.
+ */
+
+export type AnalyticsWindowType = '1m' | '5m' | '15m' | '1h' | '24h'
+
+export interface CoreMetrics {
+  ipc?: {
+    requestCount?: number
+    avgLatency?: number
+    p50Latency?: number
+    p95Latency?: number
+    p99Latency?: number
+    errorCount?: number
+    slowRequests?: number
+  }
+  system?: {
+    cpuUsage?: number
+    memoryUsed?: number
+    memoryTotal?: number
+    heapUsed?: number
+    heapTotal?: number
+  }
+  modules?: Record<string, {
+    operationCount?: number
+    avgDuration?: number
+    errorCount?: number
+  }>
+  plugins?: Record<string, {
+    featureCalls?: Record<string, number>
+    totalCalls?: number
+    avgResponseTime?: number
+    topFeatures?: Array<{ id: string, count: number }>
+  }>
+  search?: {
+    totalSearches?: number
+    avgDuration?: number
+    providerTimings?: Record<string, number>
+  }
+}
+
+export interface AnalyticsSnapshot {
+  windowType: AnalyticsWindowType
+  timestamp: number
+  metrics: CoreMetrics
+}
+
+export interface AnalyticsRangeRequest {
+  windowType: AnalyticsWindowType
+  from: number
+  to: number
+}
+
+export interface AnalyticsExportPayload extends AnalyticsRangeRequest {
+  format?: 'json' | 'csv'
+  dimensions?: Array<'ipc' | 'system' | 'modules' | 'plugins' | 'search'>
+}
+
+export interface AnalyticsExportResult {
+  format: 'json' | 'csv'
+  content: string
+  payload: AnalyticsExportPayload
+  exportedAt: number
+}
+
+export interface PluginStats {
+  featureCalls: Record<string, number>
+  totalCalls: number
+  avgResponseTime: number
+  topFeatures: Array<{ id: string, count: number }>
+  counters: Record<string, number>
+  gauges: Record<string, number>
+  histograms: Record<string, number[]>
+}
+
+export interface FeatureStats {
+  count: number
+  avgDuration: number
+  lastDuration?: number
+}
+
+export interface TrackEventPayload {
+  eventName: string
+  featureId?: string
+  metadata?: Record<string, unknown>
+  pluginName?: string
+  pluginVersion?: string
+}
+
+export interface TrackDurationPayload {
+  operationName: string
+  durationMs: number
+  featureId?: string
+  pluginName?: string
+  pluginVersion?: string
+}
+
+export interface CounterPayload {
+  name: string
+  value?: number
+  pluginName?: string
+  pluginVersion?: string
+}
+
+export interface GaugePayload {
+  name: string
+  value: number
+  pluginName?: string
+  pluginVersion?: string
+}
+
+export interface HistogramPayload {
+  name: string
+  value: number
+  pluginName?: string
+  pluginVersion?: string
+}
+
+export type AnalyticsMessageStatus = 'unread' | 'read' | 'archived'
+export type AnalyticsMessageSeverity = 'info' | 'warn' | 'error'
+export type AnalyticsMessageSource = 'analytics' | 'sentry' | 'update' | 'permission' | 'system'
+
+export interface AnalyticsMessage {
+  id: string
+  source: AnalyticsMessageSource
+  severity: AnalyticsMessageSeverity
+  title: string
+  message: string
+  meta?: Record<string, unknown>
+  status: AnalyticsMessageStatus
+  createdAt: number
+}
+
+export interface AnalyticsMessageListRequest {
+  status?: AnalyticsMessageStatus | 'all'
+  source?: AnalyticsMessageSource
+  since?: number
+  limit?: number
+}
+
+export interface AnalyticsMessageUpdateRequest {
+  id: string
+  status: AnalyticsMessageStatus
+}
+
+export interface PluginAnalyticsSDK {
+  trackEvent: (eventName: string, metadata?: Record<string, unknown>, featureId?: string) => Promise<void>
+  trackDuration: (operationName: string, durationMs: number, featureId?: string) => Promise<void>
+  measure: <T>(operationName: string, fn: () => T | Promise<T>) => Promise<T>
+  getStats: () => Promise<PluginStats>
+  getFeatureStats: (featureId: string) => Promise<FeatureStats>
+  getTopFeatures: (limit?: number) => Promise<Array<{ id: string, count: number }>>
+  incrementCounter: (name: string, value?: number) => Promise<void>
+  setGauge: (name: string, value: number) => Promise<void>
+  recordHistogram: (name: string, value: number) => Promise<void>
+}