@foolishandi_tech/utils

Utility functions for One Tech project.

Installation

npm install @foolishandi_tech/utils
# or
yarn add @foolishandi_tech/utils
# or
pnpm add @foolishandi_tech/utils

Usage

Platform Detection

import { getPlatform, isPC, isMobile, Platform } from '@foolishandi_tech/utils';
// or
import { getPlatform } from '@foolishandi_tech/utils/platform';

// Get platform info
const platform = await getPlatform();

// Check platform type
const isDesktop = await isPC();
const isMobileDevice = await isMobile();

// Check specific platform
const isWindows = await Platform.isWindows();
const isMacOS = await Platform.isMacOS();

Error Handling

import {
  createErrorInfo,
  formatErrorMessage,
  isNetworkError,
  logError,
  retryWithBackoff,
} from '@foolishandi_tech/utils';
// or
import { createErrorInfo } from '@foolishandi_tech/utils/error';

// Create error info
const errorInfo = createErrorInfo(error, {
  componentStack: '...',
  errorBoundary: 'ErrorBoundary',
});

// Check error type
if (isNetworkError(error)) {
  // Handle network error
}

// Retry with backoff
const result = await retryWithBackoff(
  async () => {
    return await fetchData();
  },
  {
    maxRetries: 3,
    initialDelay: 1000,
    shouldRetry: (error) => isNetworkError(error),
  }
);

API

Platform Utilities

• getPlatform(): Promise<PlatformInfo> - Get platform information
• isPC(): Promise<boolean> - Check if platform is PC
• isMobile(): Promise<boolean> - Check if platform is mobile
• isDesktop(): Promise<boolean> - Check if platform is desktop
• getPlatformName(): Promise<Platform> - Get platform name
• clearPlatformCache(): void - Clear platform cache
• Platform.isWindows() - Check if Windows
• Platform.isMacOS() - Check if macOS
• Platform.isLinux() - Check if Linux
• Platform.isIOS() - Check if iOS
• Platform.isAndroid() - Check if Android

Error Utilities

• createErrorInfo(error, errorInfo?) - Create error info object
• formatErrorMessage(error) - Format error message
• isNetworkError(error) - Check if network error
• isTimeoutError(error) - Check if timeout error
• isAuthError(error) - Check if authentication error
• isPermissionError(error) - Check if permission error
• getErrorCode(error) - Get error code
• logError(error, context?) - Log error with context
• createErrorHandler(handler, options?) - Create error handler
• retryWithBackoff(fn, options?) - Retry function with exponential backoff

Development

# Build
npm run build

# Watch mode
npm run dev

# Clean
npm run clean