@umituz/react-native-design-system 4.28.6 → 4.28.8

package/dist/device/domain/entities/DeviceUtils.d.ts

@@ -1,34 +0,0 @@
-/**
- * Device Utilities
- * Helper functions for processing device information
- */
-import { DeviceInfo, ApplicationInfo } from './Device';
-export declare class DeviceUtils {
-    /**
-     * Check if running on physical device (not simulator/emulator)
-     */
-    static isPhysicalDevice(isDevice: boolean): boolean;
-    /**
-     * Get device display name
-     */
-    static getDeviceDisplayName(info: DeviceInfo): string;
-    /**
-     * Get OS display string
-     */
-    static getOSDisplayString(info: DeviceInfo): string;
-    /**
-     * Get app version string
-     */
-    static getAppVersionString(info: ApplicationInfo): string;
-    /**
-     * Check if device meets minimum requirements
-     */
-    static meetsMinimumRequirements(info: DeviceInfo, minMemoryGB?: number): {
-        meets: boolean;
-        reasons: string[];
-    };
-    /**
-     * Get device tier (low/mid/high) based on specs
-     */
-    static getDeviceTier(info: DeviceInfo): 'low' | 'mid' | 'high';
-}

package/dist/device/domain/types/AnonymousUserTypes.d.ts

@@ -1,44 +0,0 @@
-/**
- * Anonymous User Types
- *
- * Type definitions for device-based anonymous user identification.
- * Device ID is persistent across app reinstalls but device-specific.
- *
- * @domain device
- * @layer domain/types
- */
-/**
- * Anonymous user data with persistent device-based identification
- */
-export interface AnonymousUser {
-    /** Persistent device-based user ID (stable across sessions and reinstalls) */
-    userId: string;
-    /** User-friendly device name (e.g., "iPhone13-A8F2") */
-    deviceName: string;
-    /** Display name for the anonymous user */
-    displayName: string;
-    /** Always true for anonymous users */
-    isAnonymous: boolean;
-}
-/**
- * Options for anonymous user hook
- */
-export interface UseAnonymousUserOptions {
-    /** Custom display name for anonymous user */
-    anonymousDisplayName?: string;
-    /** Fallback user ID if device ID generation fails */
-    fallbackUserId?: string;
-}
-/**
- * Return type for useAnonymousUser hook
- */
-export interface UseAnonymousUserResult {
-    /** Anonymous user data with persistent device-based ID */
-    anonymousUser: AnonymousUser | null;
-    /** Loading state */
-    isLoading: boolean;
-    /** Error message if ID generation failed */
-    error: string | null;
-    /** Refresh function to reload user data */
-    refresh: () => Promise<void>;
-}

package/dist/device/index.d.ts

@@ -1,32 +0,0 @@
-/**
- * Device Module - Public API
- *
- * Complete device utilities including:
- * - Device detection (phone, tablet, iPad variants)
- * - Device info and capabilities
- * - Anonymous user management
- */
-export { IPAD_BREAKPOINTS, TOUCH_TARGETS, CONTENT_WIDTH_CONSTRAINTS, IPAD_LAYOUT_CONFIG, DeviceType, getScreenDimensions, isPhone, isSmallPhone, isLargePhone, isTablet, isLandscape, getDeviceType, getSpacingMultiplier, isIPad, isIPadMini, isIPadPro, isIPadLandscape, getContentMaxWidth, getIPadGridColumns, getTouchTargetSize, getIPadScreenPadding, getIPadFontScale, getIPadLayoutInfo, type IPadLayoutInfo, getIPadModalDimensions, getPaywallDimensions, type ModalDimensions, type PaywallDimensions, } from './detection';
-export type { DeviceInfo, ApplicationInfo, SystemInfo, DeviceType as DeviceInfoType, } from './domain/entities/Device';
-export { DEVICE_CONSTANTS, } from './domain/entities/Device';
-export { DeviceUtils } from './domain/entities/DeviceUtils';
-export type { DeviceFeatureConfig, DeviceFeatureUsage, DeviceFeatureAccess, FeatureLimit, ResetPeriod, } from './domain/entities/DeviceFeatureConfig';
-export { DEFAULT_FEATURE_CONFIG } from './domain/entities/DeviceFeatureConfig';
-export { DeviceTypeUtils } from './domain/entities/DeviceTypeUtils';
-export { DeviceMemoryUtils } from './domain/entities/DeviceMemoryUtils';
-export { DeviceService } from './infrastructure/services/DeviceService';
-export { UserFriendlyIdService } from './infrastructure/services/UserFriendlyIdService';
-import { PersistentDeviceIdService } from './infrastructure/services/PersistentDeviceIdService';
-export { PersistentDeviceIdService };
-export { DeviceFeatureService } from './infrastructure/services/DeviceFeatureService';
-export { collectDeviceExtras } from './infrastructure/services/DeviceExtrasCollector';
-export type { DeviceExtras } from './infrastructure/services/DeviceExtrasCollector';
-export { SecureDeviceIdRepository } from './infrastructure/repositories/SecureDeviceIdRepository';
-export { useDeviceInfo, useDeviceCapabilities, useDeviceId, } from './presentation/hooks/useDeviceInfo';
-export { useAnonymousUser, } from './presentation/hooks/useAnonymousUser';
-export type { AnonymousUser, UseAnonymousUserOptions, UseAnonymousUserResult, } from './domain/types/AnonymousUserTypes';
-export { useDeviceFeatures } from './presentation/hooks/useDeviceFeatures';
-/**
- * Get anonymous user ID for services
- */
-export declare function getAnonymousUserId(): Promise<string>;

package/dist/device/infrastructure/repositories/SecureDeviceIdRepository.d.ts

@@ -1,18 +0,0 @@
-/**
- * Secure Device ID Repository
- *
- * Uses iOS Keychain with AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY for:
- * - Persistence across app reinstalls
- * - Device-specific (no backup migration)
- * - Accessible after first unlock (background tasks)
- *
- * @domain device
- * @layer infrastructure/repositories
- */
-export declare class SecureDeviceIdRepository {
-    get(): Promise<string | null>;
-    set(deviceId: string): Promise<void>;
-    hasMigrated(): Promise<boolean>;
-    setMigrated(): Promise<void>;
-    remove(): Promise<void>;
-}

package/dist/device/infrastructure/services/ApplicationInfoService.d.ts

@@ -1,21 +0,0 @@
-/**
- * Application Info Service
- *
- * Single Responsibility: Get application information from native modules
- * Follows SOLID principles - only handles application info retrieval
- */
-import type { ApplicationInfo } from '../../domain/entities/Device';
-/**
- * Service for retrieving application information
- */
-export declare class ApplicationInfoService {
-    /**
-     * Get application information
-     * SAFE: Returns minimal info if native modules are not ready
-     */
-    static getApplicationInfo(): Promise<ApplicationInfo>;
-    /**
-     * Get minimal application info (fallback)
-     */
-    private static getMinimalApplicationInfo;
-}

package/dist/device/infrastructure/services/DeviceCapabilityService.d.ts

@@ -1,28 +0,0 @@
-/**
- * Device Capability Service
- *
- * Single Responsibility: Check device capabilities and features
- * Follows SOLID principles - only handles capability checks
- */
-/**
- * Service for checking device capabilities
- */
-export declare class DeviceCapabilityService {
-    /**
-     * Check if device supports specific features
-     */
-    static getDeviceCapabilities(): Promise<{
-        isDevice: boolean;
-        isTablet: boolean;
-        hasNotch: boolean;
-        totalMemoryGB: number | null;
-    }>;
-    /**
-     * Check if device has notch/dynamic island from existing info
-     */
-    private static hasNotchFromInfo;
-    /**
-     * Check if device has notch/dynamic island
-     */
-    static hasNotch(): Promise<boolean>;
-}

package/dist/device/infrastructure/services/DeviceExtrasCollector.d.ts

@@ -1,59 +0,0 @@
-/**
- * Device Extras Collector
- *
- * Collects device and application information for user documents.
- * Used with @umituz/react-native-auth's UserDocumentService.
- *
- * @domain device
- * @layer infrastructure/services
- */
-/**
- * Device extras for user documents
- * Compatible with UserDocumentExtras from @umituz/react-native-auth
- * Index signature added for Record<string, unknown> compatibility
- */
-export interface DeviceExtras {
-    [key: string]: string | number | boolean | undefined;
-    /** The stable ID stored in Keychain/SecureStore */
-    deviceId: string;
-    /** Alias for deviceId for clarity in Firestore */
-    persistentDeviceId: string;
-    /** The raw native platform ID (IDFV on iOS, Android ID on Android) */
-    nativeDeviceId: string;
-    platform: string;
-    deviceModel: string;
-    deviceBrand: string;
-    deviceName: string;
-    deviceType: number | string;
-    deviceYearClass: number | string;
-    isDevice: boolean;
-    osName: string;
-    osVersion: string;
-    osBuildId: string;
-    totalMemory: number | string;
-    appVersion: string;
-    buildNumber: string;
-    locale: string;
-    region: string;
-    timezone: string;
-    screenWidth: number;
-    screenHeight: number;
-    screenScale: number;
-    fontScale: number;
-    isLandscape: boolean;
-}
-/**
- * Collect device extras for user documents
- *
- * @example
- * ```typescript
- * import { collectDeviceExtras } from '@umituz/react-native-design-system';
- * import { initializeAuth } from '@umituz/react-native-auth';
- *
- * await initializeAuth({
- *   userCollection: 'users',
- *   collectExtras: collectDeviceExtras,
- * });
- * ```
- */
-export declare function collectDeviceExtras(): Promise<DeviceExtras>;

package/dist/device/infrastructure/services/DeviceFeatureService.d.ts

@@ -1,22 +0,0 @@
-/**
- * Device Feature Service
- *
- * Generic service for tracking device-based feature usage.
- * Apps configure feature limits via props, service tracks usage.
- *
- * @domain device
- * @layer infrastructure/services
- */
-import type { DeviceFeatureConfig, DeviceFeatureAccess } from '../../domain/entities/DeviceFeatureConfig';
-export declare class DeviceFeatureService {
-    private static config;
-    static setConfig(config: DeviceFeatureConfig): void;
-    static checkFeatureAccess(featureName: string): Promise<DeviceFeatureAccess>;
-    static incrementFeatureUsage(featureName: string): Promise<void>;
-    private static getFeatureUsage;
-    private static setFeatureUsage;
-    private static resetFeatureUsage;
-    private static shouldResetUsage;
-    private static calculateNextReset;
-    private static getStorageKey;
-}

package/dist/device/infrastructure/services/DeviceIdService.d.ts

@@ -1,32 +0,0 @@
-/**
- * Device ID Service
- *
- * Single Responsibility: Get device unique identifiers
- * Follows SOLID principles - only handles device ID retrieval
- */
-/**
- * Service for retrieving device unique identifiers
- */
-export declare class DeviceIdService {
-    /**
-     * Get device unique identifier (platform-specific)
-     *
-     * WARNING: Use with caution - user privacy considerations!
-     * Android: androidId (can be reset)
-     * iOS: iosIdForVendor (changes on reinstall)
-     * Web: null (not supported)
-     *
-     * SAFE: Returns null if native modules are not ready
-     */
-    static getDeviceId(): Promise<string | null>;
-    /**
-     * Get offline user ID with fallback (iOS/Android only)
-     *
-     * For offline apps that need a persistent user ID:
-     * 1. Try to get platform-specific device ID (iOS/Android)
-     * 2. Fallback to a default offline user ID if device ID not available
-     *
-     * NOTE: Returns null for web platform (not supported)
-     */
-    static getOfflineUserId(fallbackId?: string): Promise<string | null>;
-}

package/dist/device/infrastructure/services/DeviceInfoService.d.ts

@@ -1,11 +0,0 @@
-/**
- * Device Info Service
- *
- * Single Responsibility: Get device information from native modules.
- * Uses expo-device (optional peer dep) with safe fallback.
- */
-import type { DeviceInfo } from '../../domain/entities/Device';
-export declare class DeviceInfoService {
-    static getDeviceInfo(): Promise<DeviceInfo>;
-    private static getMinimalDeviceInfo;
-}

package/dist/device/infrastructure/services/DeviceService.d.ts

@@ -1,66 +0,0 @@
-/**
- * Device Service - Facade/Orchestrator
- *
- * Main entry point for device operations.
- * Delegates to specialized services following Single Responsibility Principle.
- *
- * @domain device
- * @layer infrastructure/services
- */
-import type { DeviceInfo, ApplicationInfo, SystemInfo } from '../../domain/entities/Device';
-/**
- * Device Service - Facade for all device operations
- *
- * This is a facade that delegates to specialized services.
- * Each service has a single responsibility (SOLID principles).
- */
-export declare class DeviceService {
-    /**
-     * Get device information
-     * Delegates to DeviceInfoService
-     */
-    static getDeviceInfo(): Promise<DeviceInfo>;
-    /**
-     * Get application information
-     * Delegates to ApplicationInfoService
-     */
-    static getApplicationInfo(): Promise<ApplicationInfo>;
-    /**
-     * Get complete system information (device + app)
-     * @param options - Optional configuration
-     * @param options.userId - Optional user ID to include in system info
-     */
-    static getSystemInfo(options?: {
-        userId?: string;
-    }): Promise<SystemInfo>;
-    /**
-     * Get device unique identifier (platform-specific)
-     * Delegates to DeviceIdService
-     */
-    static getDeviceId(): Promise<string | null>;
-    /**
-     * Get offline user ID with fallback
-     * Delegates to DeviceIdService
-     */
-    static getOfflineUserId(fallbackId?: string): Promise<string | null>;
-    /**
-     * Check if device supports specific features
-     * Delegates to DeviceCapabilityService
-     */
-    static getDeviceCapabilities(): Promise<{
-        isDevice: boolean;
-        isTablet: boolean;
-        hasNotch: boolean;
-        totalMemoryGB: number | null;
-    }>;
-    /**
-     * Check if device has notch/dynamic island
-     * Delegates to DeviceCapabilityService
-     */
-    static hasNotch(): Promise<boolean>;
-    /**
-     * Get user friendly device ID
-     * Delegates to UserFriendlyIdService
-     */
-    static getUserFriendlyId(): Promise<string>;
-}

package/dist/device/infrastructure/services/PersistentDeviceIdService.d.ts

@@ -1,36 +0,0 @@
-/**
- * Persistent Device ID Service
- *
- * Provides a stable device identifier that survives app reinstalls.
- * Priority: SecureStore (true keychain persistence) > Migration > Native ID > Generated UUID
- *
- * @domain device
- * @layer infrastructure/services
- */
-export declare class PersistentDeviceIdService {
-    private static secureRepo;
-    /**
-     * Get device ID with caching and concurrent request handling
-     */
-    static getDeviceId(): Promise<string>;
-    /**
-     * Logic to establish a persistent ID
-     */
-    private static initializeDeviceId;
-    /**
-     * Generates a new ID based on platform info if possible
-     */
-    private static createNewDeviceId;
-    /**
-     * Check if an ID exists without initializing
-     */
-    static hasStoredId(): Promise<boolean>;
-    /**
-     * Fully clear all stored identifiers
-     */
-    static clearStoredId(): Promise<void>;
-    /**
-     * Get current cached ID synchronously
-     */
-    static getCachedId(): string | null;
-}

package/dist/device/infrastructure/services/UserFriendlyIdService.d.ts

@@ -1,25 +0,0 @@
-/**
- * User Friendly ID Service
- *
- * Single Responsibility: Generate user-friendly device identifiers
- * Follows SOLID principles - only handles ID generation logic
- */
-/**
- * Service for generating user-friendly device IDs
- */
-export declare class UserFriendlyIdService {
-    /**
-     * Get user friendly device ID (e.g. "iPhone13-A8F2")
-     *
-     * Useful for displaying a readable user identifier in profiles.
-     * Combines cleaned model name with short device hash.
-     *
-     * SAFE: This method has multiple fallback layers to prevent native module crashes.
-     * If native modules are not ready, it will return a safe fallback ID.
-     */
-    static getUserFriendlyId(): Promise<string>;
-    /**
-     * Generate fallback ID when native modules are not available
-     */
-    private static generateFallbackId;
-}

package/dist/device/infrastructure/utils/nativeModuleUtils.d.ts

@@ -1,27 +0,0 @@
-/**
- * Native Module Utilities
- *
- * Safe wrappers for native module access with timeout and error handling
- * Prevents crashes when native modules are not ready
- */
-/**
- * Execute a native module call with timeout
- * @param operation - Async operation to execute
- * @param timeoutMs - Timeout in milliseconds (default: 1000)
- * @returns Result of operation or null if timeout/error
- */
-export declare function withTimeout<T>(operation: () => Promise<T>, timeoutMs?: number): Promise<T | null>;
-/**
- * Safely access a native module property
- * @param accessor - Function that accesses the property
- * @param fallback - Fallback value if access fails
- * @returns Property value or fallback
- */
-export declare function safeAccess<T>(accessor: () => T, fallback: T): T;
-/**
- * Execute multiple native module operations with timeout
- * @param operations - Array of async operations
- * @param timeoutMs - Timeout in milliseconds (default: 2000)
- * @returns Array of results (null for failed operations)
- */
-export declare function withTimeoutAll<T>(operations: Array<() => Promise<T>>, timeoutMs?: number): Promise<Array<T | null>>;

package/dist/device/infrastructure/utils/stringUtils.d.ts

@@ -1,31 +0,0 @@
-/**
- * String Utilities
- *
- * Pure utility functions for string manipulation
- * No dependencies, no side effects
- */
-/**
- * Clean model name by removing special characters
- * @param model - Device model name
- * @returns Cleaned model name with only alphanumeric characters
- */
-export declare function cleanModelName(model: string | null | undefined): string;
-/**
- * Extract ID part from device ID
- * @param deviceId - Full device ID
- * @param length - Length of ID part to extract (default: 6)
- * @returns Last N characters of device ID in uppercase
- */
-export declare function extractIdPart(deviceId: string | null, length?: number): string;
-/**
- * Generate random alphanumeric ID
- * @param length - Length of ID to generate (default: 6)
- * @returns Random ID in uppercase
- */
-export declare function generateRandomId(length?: number): string;
-/**
- * Get platform prefix for device ID
- * @param platform - Platform OS
- * @returns Platform prefix string
- */
-export declare function getPlatformPrefix(platform: string): string;

package/dist/device/presentation/hooks/useAnonymousUser.d.ts

@@ -1,34 +0,0 @@
-/**
- * Anonymous User Hook
- *
- * Provides persistent device-based user ID for anonymous users.
- * Uses iOS Keychain with AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY for:
- * - Stable ID across app restarts and reinstalls
- * - Device-specific (no backup migration)
- * - Compatible with Firebase Anonymous Auth
- *
- * @domain device
- * @layer presentation/hooks
- */
-import type { UseAnonymousUserOptions, UseAnonymousUserResult } from '../../domain/types/AnonymousUserTypes';
-/**
- * useAnonymousUser hook for persistent device-based user identification
- *
- * USAGE:
- * ```typescript
- * import { useAnonymousUser } from '@umituz/react-native-design-system';
- *
- * const { anonymousUser, isLoading } = useAnonymousUser();
- *
- * // Use for subscription services
- * await subscriptionService.initialize(anonymousUser?.userId);
- *
- * // Use in SettingsScreen
- * <UserProfileHeader
- *   userId={anonymousUser?.userId}
- *   displayName={anonymousUser?.displayName}
- *   isAnonymous={anonymousUser?.isAnonymous}
- * />
- * ```
- */
-export declare const useAnonymousUser: (options?: UseAnonymousUserOptions) => UseAnonymousUserResult;

package/dist/device/presentation/hooks/useDeviceFeatures.d.ts

@@ -1,16 +0,0 @@
-/**
- * useDeviceFeatures Hook
- *
- * Hook for checking and tracking device-based feature usage.
- * Main app provides feature configuration via DesignSystemProvider.
- *
- * @param featureName - Name of the feature to track
- * @returns Feature access status and usage tracking functions
- */
-import type { DeviceFeatureAccess } from '../../domain/entities/DeviceFeatureConfig';
-interface UseDeviceFeaturesResult extends DeviceFeatureAccess {
-    incrementUsage: () => Promise<void>;
-    refresh: () => Promise<void>;
-}
-export declare function useDeviceFeatures(featureName: string): UseDeviceFeaturesResult;
-export {};

package/dist/device/presentation/hooks/useDeviceInfo.d.ts

@@ -1,26 +0,0 @@
-/**
- * Device Domain - useDeviceInfo Hook
- *
- * React hook for device and application information.
- */
-export declare const useDeviceInfo: () => {
-    deviceInfo: import("../..").DeviceInfo | null;
-    appInfo: import("../..").ApplicationInfo | null;
-    systemInfo: import("../..").SystemInfo | null;
-    isLoading: boolean;
-    error: null;
-    refresh: (...args: any[]) => Promise<import("../..").SystemInfo | null>;
-    loadDeviceInfo: (...args: any[]) => Promise<import("../..").DeviceInfo | null>;
-    loadAppInfo: (...args: any[]) => Promise<import("../..").ApplicationInfo | null>;
-};
-export declare const useDeviceCapabilities: () => {
-    isDevice: boolean;
-    isTablet: boolean;
-    hasNotch: boolean;
-    totalMemoryGB: number | null;
-    isLoading: boolean;
-};
-export declare const useDeviceId: () => {
-    deviceId: string | null;
-    isLoading: boolean;
-};

package/dist/exception/ErrorBoundary.d.ts

@@ -1,22 +0,0 @@
-/**
- * ErrorBoundary Component
- * React 19 compatible error boundary for catching rendering errors
- */
-import React, { Component, ReactNode } from "react";
-export interface ErrorBoundaryProps {
-    children: ReactNode;
-    fallback?: ReactNode;
-    onError?: (error: Error, errorInfo: React.ErrorInfo) => void;
-}
-interface ErrorBoundaryState {
-    hasError: boolean;
-    error: Error | null;
-}
-export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
-    constructor(props: ErrorBoundaryProps);
-    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
-    componentDidCatch(error: Error, errorInfo: React.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> | React.JSX.Element | null | undefined;
-}
-export {};

package/dist/exception/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Exception handling exports
- * Error boundaries and error handling utilities
- */
-export { ErrorBoundary } from "./ErrorBoundary";
-export type { ErrorBoundaryProps } from "./ErrorBoundary";

package/dist/filesystem/domain/constants/FileConstants.d.ts

@@ -1,17 +0,0 @@
-/**
- * File Constants
- * File-related constants for the filesystem package
- */
-import type { FileEncoding } from '../types/FileTypes';
-/**
- * File-related constants
- */
-export declare const FILE_CONSTANTS: {
-    readonly MAX_FILE_SIZE: number;
-    readonly ALLOWED_EXTENSIONS: readonly [".jpg", ".jpeg", ".png", ".pdf", ".txt", ".json", ".mp4", ".mp3"];
-    readonly DEFAULT_ENCODING: FileEncoding;
-};
-/**
- * Allowed file extensions type
- */
-export type AllowedExtension = typeof FILE_CONSTANTS.ALLOWED_EXTENSIONS[number];

package/dist/filesystem/domain/entities/File.d.ts

@@ -1,8 +0,0 @@
-/**
- * File Entity - Module Index
- * Domain layer exports for file operations
- */
-export type { FileEncoding, DirectoryType, FileOperationResult, FileInfo, DownloadProgress, } from '../types/FileTypes';
-export { FILE_CONSTANTS } from '../constants/FileConstants';
-export type { AllowedExtension } from '../constants/FileConstants';
-export { FileUtils } from '../utils/FileUtils';