@oxyhq/core 1.0.0

package/src/i18n/locales/zh-CN.json

@@ -0,0 +1,120 @@
+{
+  "signin": {
+    "title": "登录",
+    "subtitle": "登录以继续",
+    "addAccountTitle": "添加另一个账户",
+    "addAccountSubtitle": "使用另一个账户登录",
+    "username": {
+      "label": "用户名",
+      "placeholder": "输入您的用户名",
+      "helper": "3-30个字符，仅字母和数字",
+      "required": "请输入您的用户名。",
+      "minLength": "用户名必须至少包含3个字符。"
+    },
+    "password": {
+      "label": "密码",
+      "placeholder": "输入您的密码",
+      "required": "请输入您的密码。",
+      "hint": "输入您的密码以登录"
+    },
+    "actions": {
+      "continue": "继续",
+      "back": "返回",
+      "signIn": "登录",
+      "verify": "验证",
+      "openAccountSwitcher": "切换到另一个账户",
+      "openAccountSwitcherSubtitle": "{{count}}个其他账户可用",
+      "openAccountSwitcherSubtitle_singular": "1个其他账户可用",
+      "openAccountSwitcherSubtitle_zero": "查看您保存的账户",
+      "manageAccounts": "管理保存的账户",
+      "manageAccountsSubtitle": "查看会话、删除或登出",
+      "loadingOtherAccounts": "加载其他账户中…",
+      "switchAccountFailed": "无法切换账户。请重试。"
+    },
+    "forgotPrompt": "忘记密码？",
+    "security": {
+      "dataSecure": "您的数据已加密且安全"
+    },
+    "currentlySignedInAs": "当前登录为",
+    "alreadySignedInWith": "已登录",
+    "alreadySignedIn": "已登录",
+    "alreadySignedInMessage": "此账户已登录。继续使用此账户？",
+    "continueWithAccount": "继续",
+    "currentAccount": "当前",
+    "or": "或",
+    "viewAllAccounts": "查看更多{{count}}个",
+    "status": {
+      "accountSwitched": "正在使用{{name}}"
+    },
+  },
+  "signup": {
+    "welcome": {
+      "title": "欢迎使用Oxy！",
+      "subtitle": "只需几步即可创建您的账户",
+      "haveAccount": "已有账户？",
+      "signInCta": "登录"
+    },
+    "identity": {
+      "title": "您是谁？",
+      "subtitle": "选择您的用户名并输入您的电子邮件"
+    },
+    "username": {
+      "helper": "3-30个字符，仅字母和数字",
+      "required": "请输入用户名",
+      "minLength": "用户名必须至少包含3个字符"
+    },
+    "email": {
+      "required": "请输入电子邮件地址",
+      "invalid": "请输入有效的电子邮件地址",
+      "helper": "我们绝不会分享您的电子邮件"
+    },
+    "security": {
+      "title": "保护您的账户",
+      "subtitle": "创建强密码以保护您的账户"
+    },
+    "password": {
+      "helper": "至少8个字符",
+      "required": "请输入密码",
+      "minLength": "密码必须至少包含8个字符",
+      "confirmRequired": "请确认您的密码",
+      "mismatch": "密码不匹配",
+      "confirmHint": "重新输入您的密码以确认"
+    },
+    "summary": {
+      "title": "快完成了！",
+      "subtitle": "查看您的信息并创建账户",
+      "sectionTitle": "账户信息",
+      "fields": {
+        "username": "用户名",
+        "email": "电子邮件",
+        "password": "密码"
+      },
+      "notSet": "未设置",
+      "securityTip": "为了更强的安全性，创建账户后，请在账户设置中启用生物识别身份验证。",
+      "legalReminder": "创建账户即表示您同意我们的服务条款和隐私政策。"
+    }
+  },
+  "common": {
+    "actions": {
+      "back": "返回",
+      "continue": "继续",
+      "next": "下一步",
+      "getStarted": "开始",
+      "createAccount": "创建账户",
+      "signIn": "登录",
+      "verify": "验证",
+      "resetPassword": "重置密码"
+    },
+    "links": {
+      "recoverAccount": "恢复您的账户",
+      "signUp": "注册"
+    },
+    "labels": {
+      "username": "用户名",
+      "email": "电子邮件",
+      "password": "密码",
+      "confirmPassword": "确认密码"
+    }
+  }
+}
+

package/src/index.ts

@@ -0,0 +1,153 @@
+/**
+ * @oxyhq/core — OxyHQ SDK Foundation
+ *
+ * Platform-agnostic core providing API client, authentication,
+ * cryptographic identity, and shared utilities.
+ *
+ * Works in Node.js, Browser, and React Native.
+ *
+ * @example
+ * ```ts
+ * import { OxyServices, oxyClient } from '@oxyhq/core';
+ *
+ * const user = await oxyClient.signIn(publicKey);
+ * ```
+ */
+
+// Ensure crypto polyfills are loaded before anything else
+import './crypto/polyfill';
+
+// --- Core API Client ---
+export { OxyServices, OxyAuthenticationError, OxyAuthenticationTimeoutError } from './OxyServices';
+export { OXY_CLOUD_URL, oxyClient } from './OxyServices';
+
+// --- Authentication ---
+export { AuthManager, createAuthManager } from './AuthManager';
+export type { StorageAdapter, AuthStateChangeCallback, AuthMethod, AuthManagerConfig } from './AuthManager';
+
+export { CrossDomainAuth, createCrossDomainAuth } from './CrossDomainAuth';
+export type { CrossDomainAuthOptions } from './CrossDomainAuth';
+
+// --- Crypto / Identity ---
+export { KeyManager, SignatureService, RecoveryPhraseService } from './crypto';
+export type { KeyPair, SignedMessage, AuthChallenge, RecoveryPhraseResult } from './crypto';
+
+// --- Models & Types ---
+export * from './models/interfaces';
+export * from './models/session';
+
+// --- Device Management ---
+export { DeviceManager } from './utils/deviceManager';
+export type { DeviceFingerprint, StoredDeviceInfo } from './utils/deviceManager';
+
+// --- Language Utilities ---
+export {
+  SUPPORTED_LANGUAGES,
+  getLanguageMetadata,
+  getLanguageName,
+  getNativeLanguageName,
+  normalizeLanguageCode,
+} from './utils/languageUtils';
+export type { LanguageMetadata } from './utils/languageUtils';
+
+// --- Platform Detection ---
+export {
+  getPlatformOS,
+  setPlatformOS,
+  isWeb,
+  isNative,
+  isIOS,
+  isAndroid,
+  initPlatformFromReactNative,
+} from './utils/platform';
+export type { PlatformOS } from './utils/platform';
+
+// --- Shared Utilities ---
+export {
+  darkenColor,
+  lightenColor,
+  hexToRgb,
+  rgbToHex,
+  withOpacity,
+  isLightColor,
+  getContrastTextColor,
+} from './shared/utils/colorUtils';
+
+export {
+  normalizeTheme,
+  normalizeColorScheme,
+  getOppositeTheme,
+  systemPrefersDarkMode,
+  getSystemColorScheme,
+} from './shared/utils/themeUtils';
+export type { ThemeValue } from './shared/utils/themeUtils';
+
+export {
+  HttpStatus,
+  getErrorStatus,
+  getErrorMessage,
+  isAlreadyRegisteredError,
+  isUnauthorizedError,
+  isForbiddenError,
+  isNotFoundError,
+  isRateLimitError,
+  isServerError,
+  isNetworkError,
+  isRetryableError,
+} from './shared/utils/errorUtils';
+
+export {
+  DEFAULT_CIRCUIT_BREAKER_CONFIG,
+  createCircuitBreakerState,
+  calculateBackoffInterval,
+  recordFailure,
+  recordSuccess,
+  shouldAllowRequest,
+  delay,
+  withRetry,
+} from './shared/utils/networkUtils';
+export type { CircuitBreakerState, CircuitBreakerConfig } from './shared/utils/networkUtils';
+
+export {
+  isDev,
+  debugLog,
+  debugWarn,
+  debugError,
+  createDebugLogger,
+} from './shared/utils/debugUtils';
+
+// --- i18n ---
+export { translate } from './i18n';
+
+// --- Session Utilities ---
+export { mergeSessions, normalizeAndSortSessions, sessionsArraysEqual } from './utils/sessionUtils';
+
+// --- Constants ---
+export { packageInfo } from './constants/version';
+
+// --- API & Error Utilities ---
+export * from './utils/apiUtils';
+export {
+  ErrorCodes,
+  createApiError,
+  handleHttpError,
+  validateRequiredFields,
+} from './utils/errorUtils';
+export { retryAsync } from './utils/asyncUtils';
+export * from './utils/validationUtils';
+export {
+  logger,
+  LogLevel,
+  logAuth,
+  logApi,
+  logSession,
+  logUser,
+  logDevice,
+  logPayment,
+  logPerformance,
+} from './utils/loggerUtils';
+export type { LogContext } from './utils/loggerUtils';
+
+// Default export
+import { OxyServices } from './OxyServices';
+export default OxyServices;

package/src/mixins/OxyServices.analytics.ts

@@ -0,0 +1,53 @@
+/**
+ * Analytics Methods Mixin
+ * 
+ * Provides methods for analytics tracking and data retrieval
+ */
+import type { OxyServicesBase } from '../OxyServices.base';
+import { CACHE_TIMES } from './mixinHelpers';
+
+export function OxyServicesAnalyticsMixin<T extends typeof OxyServicesBase>(Base: T) {
+  return class extends Base {
+    constructor(...args: any[]) {
+      super(...(args as [any]));
+    }
+
+    /**
+     * Track an analytics event
+     * @param eventName - Name of the event to track
+     * @param properties - Optional event properties
+     */
+    async trackEvent(eventName: string, properties?: Record<string, any>): Promise<void> {
+      try {
+        await this.makeRequest('POST', '/api/analytics/events', {
+          event: eventName,
+          properties
+        }, { cache: false, retry: false }); // Don't retry analytics events
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Get analytics data for a date range
+     * @param startDate - Optional start date (ISO string)
+     * @param endDate - Optional end date (ISO string)
+     * @returns Analytics data
+     */
+    async getAnalytics(startDate?: string, endDate?: string): Promise<any> {
+      try {
+        const params: any = {};
+        if (startDate) params.startDate = startDate;
+        if (endDate) params.endDate = endDate;
+        
+        return await this.makeRequest('GET', '/api/analytics', params, {
+          cache: true,
+          cacheTTL: CACHE_TIMES.LONG,
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+  };
+}
+