@oxyhq/services 5.27.0 → 6.0.0

package/dist/web/types/shared/utils/errorUtils.d.ts

@@ -1,97 +0,0 @@
-/**
- * Error Utility Functions
- *
- * Consolidated error handling utilities for the OxyServices ecosystem.
- * These functions help with common error patterns like checking HTTP status codes.
- *
- * @module shared/utils/errorUtils
- */
-/**
- * Common HTTP status codes used in error checking.
- */
-export declare const HttpStatus: {
-    readonly BAD_REQUEST: 400;
-    readonly UNAUTHORIZED: 401;
-    readonly FORBIDDEN: 403;
-    readonly NOT_FOUND: 404;
-    readonly CONFLICT: 409;
-    readonly UNPROCESSABLE_ENTITY: 422;
-    readonly TOO_MANY_REQUESTS: 429;
-    readonly INTERNAL_SERVER_ERROR: 500;
-    readonly BAD_GATEWAY: 502;
-    readonly SERVICE_UNAVAILABLE: 503;
-    readonly GATEWAY_TIMEOUT: 504;
-};
-/**
- * Extracts the HTTP status code from an error object.
- *
- * @param error - Any error object
- * @returns The status code if found, undefined otherwise
- */
-export declare const getErrorStatus: (error: unknown) => number | undefined;
-/**
- * Extracts the error message from an error object.
- *
- * @param error - Any error object
- * @param fallback - Fallback message if none found
- * @returns The error message
- */
-export declare const getErrorMessage: (error: unknown, fallback?: string) => string;
-/**
- * Check if an error indicates the user is already registered (HTTP 409 Conflict).
- *
- * The backend should always return HTTP 409 for duplicate registrations.
- *
- * @param error - Any error object
- * @returns true if the error is a 409 Conflict
- */
-export declare const isAlreadyRegisteredError: (error: unknown) => boolean;
-/**
- * Check if an error is an authentication error (HTTP 401).
- *
- * @param error - Any error object
- * @returns true if the error is a 401 Unauthorized
- */
-export declare const isUnauthorizedError: (error: unknown) => boolean;
-/**
- * Check if an error is a forbidden error (HTTP 403).
- *
- * @param error - Any error object
- * @returns true if the error is a 403 Forbidden
- */
-export declare const isForbiddenError: (error: unknown) => boolean;
-/**
- * Check if an error is a not found error (HTTP 404).
- *
- * @param error - Any error object
- * @returns true if the error is a 404 Not Found
- */
-export declare const isNotFoundError: (error: unknown) => boolean;
-/**
- * Check if an error is a rate limit error (HTTP 429).
- *
- * @param error - Any error object
- * @returns true if the error is a 429 Too Many Requests
- */
-export declare const isRateLimitError: (error: unknown) => boolean;
-/**
- * Check if an error is a server error (HTTP 5xx).
- *
- * @param error - Any error object
- * @returns true if the error is a 5xx server error
- */
-export declare const isServerError: (error: unknown) => boolean;
-/**
- * Check if an error is a network error (no response received).
- *
- * @param error - Any error object
- * @returns true if the error appears to be a network error
- */
-export declare const isNetworkError: (error: unknown) => boolean;
-/**
- * Check if an error is retryable (network errors or 5xx server errors).
- *
- * @param error - Any error object
- * @returns true if the request should be retried
- */
-export declare const isRetryableError: (error: unknown) => boolean;

package/dist/web/types/shared/utils/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * Shared Utility Functions
- *
- * Re-exports all shared utilities for convenient importing.
- *
- * @module shared/utils
- */
-export { darkenColor, lightenColor, hexToRgb, rgbToHex, withOpacity, isLightColor, getContrastTextColor, } from './colorUtils';
-export { normalizeTheme, normalizeColorScheme, getOppositeTheme, systemPrefersDarkMode, getSystemColorScheme, } from './themeUtils';
-export type { ThemeValue } from './themeUtils';
-export { HttpStatus, getErrorStatus, getErrorMessage, isAlreadyRegisteredError, isUnauthorizedError, isForbiddenError, isNotFoundError, isRateLimitError, isServerError, isNetworkError, isRetryableError, } from './errorUtils';
-export { DEFAULT_CIRCUIT_BREAKER_CONFIG, createCircuitBreakerState, calculateBackoffInterval, recordFailure, recordSuccess, shouldAllowRequest, delay, withRetry, } from './networkUtils';
-export type { CircuitBreakerState, CircuitBreakerConfig, } from './networkUtils';

package/dist/web/types/shared/utils/networkUtils.d.ts

@@ -1,139 +0,0 @@
-/**
- * Network Utility Functions
- *
- * Consolidated network utilities including circuit breaker pattern
- * and exponential backoff for resilient API calls.
- *
- * @module shared/utils/networkUtils
- */
-/**
- * State for circuit breaker pattern.
- */
-export interface CircuitBreakerState {
-    /** Number of consecutive failures */
-    consecutiveFailures: number;
-    /** Current interval between retries (ms) */
-    currentInterval: number;
-    /** Base interval for retries (ms) */
-    baseInterval: number;
-    /** Maximum interval cap (ms) */
-    maxInterval: number;
-    /** Number of failures before circuit opens */
-    maxFailures: number;
-    /** Whether the circuit is currently open (blocking requests) */
-    isOpen?: boolean;
-    /** Timestamp when circuit was opened */
-    openedAt?: number;
-}
-/**
- * Configuration for circuit breaker.
- */
-export interface CircuitBreakerConfig {
-    /** Base interval between retries in milliseconds. Default: 10000 (10s) */
-    baseInterval?: number;
-    /** Maximum interval cap in milliseconds. Default: 60000 (60s) */
-    maxInterval?: number;
-    /** Number of consecutive failures before opening circuit. Default: 5 */
-    maxFailures?: number;
-    /** Time to wait before attempting recovery in milliseconds. Default: 30000 (30s) */
-    recoveryTimeout?: number;
-}
-/**
- * Default circuit breaker configuration.
- */
-export declare const DEFAULT_CIRCUIT_BREAKER_CONFIG: Required<CircuitBreakerConfig>;
-/**
- * Creates initial circuit breaker state.
- *
- * @param config - Optional custom configuration
- * @returns Initial circuit breaker state
- *
- * @example
- * ```ts
- * const state = createCircuitBreakerState({ maxFailures: 3 });
- * ```
- */
-export declare const createCircuitBreakerState: (config?: CircuitBreakerConfig) => CircuitBreakerState;
-/**
- * Calculates next interval using exponential backoff.
- *
- * @param state - Current circuit breaker state
- * @returns Next interval in milliseconds
- *
- * @example
- * ```ts
- * const nextInterval = calculateBackoffInterval(state);
- * await delay(nextInterval);
- * ```
- */
-export declare const calculateBackoffInterval: (state: CircuitBreakerState) => number;
-/**
- * Records a failure and updates circuit breaker state.
- *
- * @param state - Current circuit breaker state
- * @returns Updated state after recording failure
- *
- * @example
- * ```ts
- * try {
- *   await apiCall();
- *   state = recordSuccess(state);
- * } catch (error) {
- *   state = recordFailure(state);
- * }
- * ```
- */
-export declare const recordFailure: (state: CircuitBreakerState) => CircuitBreakerState;
-/**
- * Records a success and resets circuit breaker state.
- *
- * @param state - Current circuit breaker state
- * @returns Reset state after successful request
- */
-export declare const recordSuccess: (state: CircuitBreakerState) => CircuitBreakerState;
-/**
- * Checks if the circuit breaker should allow a request.
- *
- * When the circuit is open, it will only allow requests after
- * the recovery timeout has passed (half-open state).
- *
- * @param state - Current circuit breaker state
- * @param recoveryTimeout - Time to wait before allowing recovery attempts
- * @returns true if request should be allowed
- */
-export declare const shouldAllowRequest: (state: CircuitBreakerState, recoveryTimeout?: number) => boolean;
-/**
- * Delays execution for a specified duration.
- *
- * @param ms - Milliseconds to delay
- * @returns Promise that resolves after the delay
- *
- * @example
- * ```ts
- * await delay(1000); // Wait 1 second
- * ```
- */
-export declare const delay: (ms: number) => Promise<void>;
-/**
- * Executes a function with exponential backoff retry.
- *
- * @param fn - Async function to execute
- * @param options - Retry options
- * @returns Result of the function
- * @throws Last error if all retries fail
- *
- * @example
- * ```ts
- * const result = await withRetry(
- *   () => fetchData(),
- *   { maxRetries: 3, baseDelay: 1000 }
- * );
- * ```
- */
-export declare const withRetry: <T>(fn: () => Promise<T>, options?: {
-    maxRetries?: number;
-    baseDelay?: number;
-    maxDelay?: number;
-    shouldRetry?: (error: unknown) => boolean;
-    onRetry?: (error: unknown, attempt: number) => void;
-}) => Promise<T>;

package/dist/web/types/shared/utils/themeUtils.d.ts

@@ -1,90 +0,0 @@
-/**
- * Theme Utility Functions
- *
- * Consolidated theme utilities for normalizing and handling color schemes
- * across the OxyServices ecosystem.
- *
- * @module shared/utils/themeUtils
- */
-/**
- * Valid theme values in the Oxy ecosystem.
- */
-export type ThemeValue = 'light' | 'dark';
-/**
- * Normalizes a theme value to ensure it's always 'light' or 'dark'.
- *
- * @param theme - Theme value (may be 'light' | 'dark' | string | undefined)
- * @returns Normalized 'light' | 'dark' theme (defaults to 'light')
- *
- * @example
- * ```ts
- * normalizeTheme('dark');     // 'dark'
- * normalizeTheme('light');    // 'light'
- * normalizeTheme('unknown');  // 'light'
- * normalizeTheme(undefined);  // 'light'
- * normalizeTheme(null);       // 'light'
- * ```
- */
-export declare const normalizeTheme: (theme?: string | null) => ThemeValue;
-/**
- * Normalizes a color scheme value with optional fallback chain.
- *
- * Handles null/undefined cases from React Native's useColorScheme() hook
- * with a proper fallback chain.
- *
- * @param colorScheme - The color scheme from useColorScheme() hook (may be null/undefined)
- * @param theme - Optional theme prop as fallback
- * @returns Normalized 'light' | 'dark' color scheme
- *
- * @example
- * ```ts
- * // In a React Native component:
- * const systemScheme = useColorScheme(); // might be null
- * const colorScheme = normalizeColorScheme(systemScheme, props.theme);
- *
- * normalizeColorScheme('dark', 'light');      // 'dark'
- * normalizeColorScheme(null, 'dark');         // 'dark'
- * normalizeColorScheme(undefined, undefined); // 'light'
- * ```
- */
-export declare const normalizeColorScheme: (colorScheme?: string | null, theme?: string) => ThemeValue;
-/**
- * Gets the opposite theme value.
- *
- * @param theme - Current theme value
- * @returns The opposite theme ('light' → 'dark', 'dark' → 'light')
- *
- * @example
- * ```ts
- * getOppositeTheme('light'); // 'dark'
- * getOppositeTheme('dark');  // 'light'
- * ```
- */
-export declare const getOppositeTheme: (theme: ThemeValue) => ThemeValue;
-/**
- * Checks if the system prefers dark mode.
- *
- * This function only works in browser environments.
- * Returns false in non-browser environments (Node.js, React Native).
- *
- * @returns true if system prefers dark mode, false otherwise
- *
- * @example
- * ```ts
- * if (systemPrefersDarkMode()) {
- *   setTheme('dark');
- * }
- * ```
- */
-export declare const systemPrefersDarkMode: () => boolean;
-/**
- * Gets the system's preferred color scheme.
- *
- * @returns 'dark' if system prefers dark mode, 'light' otherwise
- *
- * @example
- * ```ts
- * const theme = getSystemColorScheme();
- * ```
- */
-export declare const getSystemColorScheme: () => ThemeValue;

package/dist/web/types/ui/client.d.ts

@@ -1,33 +0,0 @@
-/**
- * Client-only UI exports (tree-shakeable)
- *
- * Import from this module for client-side bundles where tree-shaking is important.
- * These are direct exports without runtime detection overhead.
- *
- * @example
- * import { OxyProvider, useOxy, Avatar } from '@oxyhq/services/ui/client';
- */
-export { default as OxyProvider } from './components/OxyProvider';
-export { default as WebOxyProvider } from './components/WebOxyProvider';
-export { default as OxySignInButton } from './components/OxySignInButton';
-export { default as OxyLogo } from './components/OxyLogo';
-export { default as Avatar } from './components/Avatar';
-export { default as FollowButton } from './components/FollowButton';
-export { default as OxyPayButton } from './components/OxyPayButton';
-export { FontLoader, setupFonts } from './components/FontLoader';
-export { OxyIcon } from './components/icon';
-export { useOxy } from './context/OxyContext';
-export { useAuth } from './hooks/useAuth';
-export type { AuthState, AuthActions, UseAuthReturn } from './hooks/useAuth';
-export { useFollow } from './hooks';
-export { useStorage } from './hooks/useStorage';
-export type { UseStorageOptions, UseStorageResult } from './hooks/useStorage';
-export { default as ProfileScreen } from './screens/ProfileScreen';
-export { useAuthStore } from './stores/authStore';
-export { useAccountStore } from './stores/accountStore';
-export { fontFamilies, fontStyles } from './styles/fonts';
-export { toast } from '../lib/sonner';
-export { OxyServices } from '../core';
-export type { User, LoginResponse, ApiError } from '../models/interfaces';
-export { handleAuthError, isInvalidSessionError, isTimeoutOrNetworkError, extractErrorMessage, } from './utils/errorHandlers';
-export type { HandleAuthErrorOptions } from './utils/errorHandlers';

package/dist/web/types/ui/components/ActivityIndicator.d.ts

@@ -1,44 +0,0 @@
-import * as React from 'react';
-import { StyleProp, View, ViewStyle } from 'react-native';
-import type { ThemeProp } from './types';
-export type Props = React.ComponentPropsWithRef<typeof View> & {
-    /**
-     * Whether to show the indicator or hide it.
-     */
-    animating?: boolean;
-    /**
-     * The color of the spinner.
-     */
-    color?: string;
-    /**
-     * Size of the indicator.
-     */
-    size?: 'small' | 'large' | number;
-    /**
-     * Whether the indicator should hide when not animating.
-     */
-    hidesWhenStopped?: boolean;
-    style?: StyleProp<ViewStyle>;
-    /**
-     * @optional
-     */
-    theme?: ThemeProp;
-};
-/**
- * Activity indicator is used to present progress of some activity in the app.
- * It can be used as a drop-in replacement for the ActivityIndicator shipped with React Native.
- *
- * ## Usage
- * ```js
- * import * as React from 'react';
- * import { ActivityIndicator, MD2Colors } from 'react-native-paper';
- *
- * const MyComponent = () => (
- *   <ActivityIndicator animating={true} color={MD2Colors.red800} />
- * );
- *
- * export default MyComponent;
- * ```
- */
-declare const ActivityIndicator: ({ animating, color: indicatorColor, hidesWhenStopped, size: indicatorSize, style, theme: themeOverrides, ...rest }: Props) => import("react/jsx-runtime").JSX.Element;
-export default ActivityIndicator;

package/dist/web/types/ui/components/AnimationExample.d.ts

@@ -1,3 +0,0 @@
-import type React from 'react';
-declare const AnimationExample: React.FC;
-export default AnimationExample;

package/dist/web/types/ui/components/AutoHeightScrollView.d.ts

@@ -1,22 +0,0 @@
-import React from 'react';
-import { ScrollView, type ScrollViewProps, type ViewStyle } from 'react-native';
-export type AutoHeightScrollViewProps = ScrollViewProps & {
-    /**
-     * Optional style override.
-     * Note: height and flexShrink are managed internally but can be overridden if absolutely necessary.
-     */
-    style?: ViewStyle;
-};
-/**
- * A ScrollView that automatically adjusts its height to match its content,
- * but shrinks if constrained by a parent (e.g., a Max Height Bottom Sheet).
- *
- * This solves the "collapsed to 0 height" issue when using ScrollView inside an auto-height container.
- */
-export declare const AutoHeightScrollView: React.ForwardRefExoticComponent<ScrollViewProps & {
-    /**
-     * Optional style override.
-     * Note: height and flexShrink are managed internally but can be overridden if absolutely necessary.
-     */
-    style?: ViewStyle;
-} & React.RefAttributes<ScrollView>>;

package/dist/web/types/ui/components/Avatar.d.ts

@@ -1,60 +0,0 @@
-import type React from 'react';
-import { type StyleProp, type ViewStyle, type ImageStyle, type TextStyle } from 'react-native';
-export interface AvatarProps {
-    /**
-     * URL of the avatar image
-     */
-    uri?: string;
-    /**
-     * Text to display when no image is available
-     * Defaults to first letter of name if name is provided
-     */
-    text?: string;
-    /**
-     * Full name to derive the initials from
-     * For single word: takes first letter
-     * For multiple words: takes first letter of first and last word (e.g., "John Doe" -> "JD")
-     * For usernames starting with @: takes first two letters after @
-     */
-    name?: string;
-    /**
-     * Size of the avatar in pixels
-     * @default 40
-     */
-    size?: number;
-    /**
-     * Theme to use for colors
-     * @default 'light'
-     */
-    theme?: 'light' | 'dark';
-    /**
-     * Background color for text avatar
-     * Defaults to theme primary color
-     */
-    backgroundColor?: string;
-    /**
-     * Text color for text avatar
-     * @default '#FFFFFF'
-     */
-    textColor?: string;
-    /**
-     * Additional styles for the container
-     */
-    style?: StyleProp<ViewStyle>;
-    /**
-     * Additional styles for the image
-     * Only used when uri is provided
-     */
-    imageStyle?: StyleProp<ImageStyle>;
-    /**
-     * Additional styles for the text
-     */
-    textStyle?: StyleProp<TextStyle>;
-    /**
-     * Is loading state
-     * @default false
-     */
-    isLoading?: boolean;
-}
-declare const _default: React.NamedExoticComponent<AvatarProps>;
-export default _default;

package/dist/web/types/ui/components/BottomSheet.d.ts

@@ -1,28 +0,0 @@
-import React from 'react';
-import { type ViewStyle, type StyleProp } from 'react-native';
-export interface BottomSheetRef {
-    present: () => void;
-    dismiss: () => void;
-    close: () => void;
-    expand: () => void;
-    collapse: () => void;
-    scrollTo: (y: number, animated?: boolean) => void;
-}
-export interface BottomSheetProps {
-    children: React.ReactNode;
-    onDismiss?: () => void;
-    enablePanDownToClose?: boolean;
-    backgroundComponent?: (props: {
-        style?: StyleProp<ViewStyle>;
-    }) => React.ReactElement | null;
-    backdropComponent?: (props: {
-        style?: StyleProp<ViewStyle>;
-        onPress?: () => void;
-    }) => React.ReactElement | null;
-    style?: StyleProp<ViewStyle>;
-    enableHandlePanningGesture?: boolean;
-    onDismissAttempt?: () => boolean;
-    detached?: boolean;
-}
-declare const BottomSheet: React.ForwardRefExoticComponent<BottomSheetProps & React.RefAttributes<BottomSheetRef>>;
-export default BottomSheet;

package/dist/web/types/ui/components/BottomSheetRouter.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import type { RouteName } from '../navigation/routes';
-export interface BottomSheetRouterProps {
-    onScreenChange?: (screen: RouteName | null) => void;
-    onDismiss?: () => void;
-}
-declare const _default: React.NamedExoticComponent<BottomSheetRouterProps>;
-export default _default;

package/dist/web/types/ui/components/CrossFadeIcon.d.ts

@@ -1,26 +0,0 @@
-import { IconSource } from './Icon';
-import type { ThemeProp } from './types';
-type Props = {
-    /**
-     * Icon to display for the `CrossFadeIcon`.
-     */
-    source: IconSource;
-    /**
-     * Color of the icon.
-     */
-    color: string;
-    /**
-     * Size of the icon.
-     */
-    size: number;
-    /**
-     * TestID used for testing purposes
-     */
-    testID?: string;
-    /**
-     * @optional
-     */
-    theme?: ThemeProp;
-};
-declare const CrossFadeIcon: ({ color, size, source, theme: themeOverrides, testID, }: Props) => import("react/jsx-runtime").JSX.Element;
-export default CrossFadeIcon;

package/dist/web/types/ui/components/EmptyState.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-export interface EmptyStateProps {
-    message: string;
-    textColor?: string;
-}
-declare const _default: React.NamedExoticComponent<EmptyStateProps>;
-export default _default;

package/dist/web/types/ui/components/ErrorBoundary.d.ts

@@ -1,30 +0,0 @@
-import React, { Component, ErrorInfo, ReactNode } from 'react';
-interface Props {
-    children: ReactNode;
-    fallback?: ReactNode;
-    onError?: (error: Error, errorInfo: ErrorInfo) => void;
-}
-interface State {
-    hasError: boolean;
-    error: Error | null;
-    errorInfo: ErrorInfo | null;
-}
-/**
- * Error Boundary Component
- *
- * Catches JavaScript errors anywhere in the child component tree,
- * logs those errors, and displays a fallback UI instead of crashing.
- *
- * Usage:
- * <ErrorBoundary>
- *   <YourComponent />
- * </ErrorBoundary>
- */
-export declare class ErrorBoundary extends Component<Props, State> {
-    constructor(props: Props);
-    static getDerivedStateFromError(error: Error): Partial<State>;
-    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
-    handleReset: () => void;
-    render(): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
-}
-export default ErrorBoundary;

package/dist/web/types/ui/components/FollowButton.d.ts

@@ -1,17 +0,0 @@
-import type React from 'react';
-import { type ViewStyle, type TextStyle, type StyleProp } from 'react-native';
-export interface FollowButtonProps {
-    userId: string;
-    initiallyFollowing?: boolean;
-    size?: 'small' | 'medium' | 'large';
-    onFollowChange?: (isFollowing: boolean) => void;
-    style?: StyleProp<ViewStyle>;
-    textStyle?: StyleProp<TextStyle>;
-    disabled?: boolean;
-    showLoadingState?: boolean;
-    preventParentActions?: boolean;
-    theme?: 'light' | 'dark';
-}
-declare const FollowButton: React.FC<FollowButtonProps>;
-export { FollowButton };
-export default FollowButton;

package/dist/web/types/ui/components/FontLoader.d.ts

@@ -1,14 +0,0 @@
-import React from 'react';
-/**
- * FontLoader component that loads custom fonts in the background while rendering children immediately
- * This works in both the package development and when consumed as an npm package
- * Children render immediately with system fonts as fallback until custom fonts are loaded
- */
-export declare const FontLoader: ({ children, }: {
-    children: React.ReactNode;
-}) => import("react/jsx-runtime").JSX.Element;
-/**
- * Setup fonts for applications consuming this package
- * This should be called by applications using your package
- */
-export declare const setupFonts: () => Promise<boolean>;

package/dist/web/types/ui/components/GroupedItem.d.ts

@@ -1,23 +0,0 @@
-import React from 'react';
-interface GroupedItemProps {
-    icon?: string;
-    iconColor?: string;
-    title: string;
-    subtitle?: string;
-    onPress?: () => void;
-    isFirst?: boolean;
-    isLast?: boolean;
-    showChevron?: boolean;
-    disabled?: boolean;
-    customContent?: React.ReactNode;
-    customIcon?: React.ReactNode;
-    /** Accessibility label (defaults to title) */
-    accessibilityLabel?: string;
-    /** Accessibility hint for what happens on press */
-    accessibilityHint?: string;
-}
-export declare const GroupedItem: React.MemoExoticComponent<{
-    ({ icon, iconColor, title, subtitle, onPress, isFirst, isLast, showChevron, disabled, customContent, customIcon, accessibilityLabel, accessibilityHint, }: GroupedItemProps): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-}>;
-export default GroupedItem;