@umituz/react-native-design-system 4.25.90 → 4.25.91

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';

package/dist/filesystem/domain/types/FileTypes.d.ts

@@ -1,38 +0,0 @@
-/**
- * File Types
- * Domain layer type definitions for file operations
- */
-/**
- * File encoding types supported by expo-file-system
- */
-export type FileEncoding = 'utf8' | 'base64';
-/**
- * Directory types available in expo-file-system
- */
-export type DirectoryType = 'documentDirectory' | 'cacheDirectory';
-/**
- * Result of a file operation
- */
-export interface FileOperationResult {
-    success: boolean;
-    uri?: string;
-    error?: string;
-}
-/**
- * File information metadata
- */
-export interface FileInfo {
-    uri: string;
-    name?: string;
-    size: number;
-    exists: boolean;
-    isDirectory: boolean;
-    modificationTime?: number;
-}
-/**
- * Download progress information
- */
-export interface DownloadProgress {
-    totalBytesWritten: number;
-    totalBytesExpectedToWrite: number;
-}

package/dist/filesystem/domain/utils/FileUtils.d.ts

@@ -1,41 +0,0 @@
-/**
- * File Utils
- * File utility functions for common operations
- */
-/**
- * File utility functions
- */
-export declare class FileUtils {
-    /**
-     * Format file size in bytes to human-readable format
-     */
-    static formatFileSize(bytes: number): string;
-    /**
-     * Generate unique filename with timestamp
-     */
-    static generateUniqueFilename(filename: string): string;
-    /**
-     * Sanitize filename by removing invalid characters
-     */
-    static sanitizeFilename(filename: string): string;
-    /**
-     * Join path segments
-     */
-    static joinPaths(...segments: string[]): string;
-    /**
-     * Get file extension from filename
-     */
-    static getFileExtension(filename: string): string;
-    /**
-     * Check if file extension is allowed
-     */
-    static isAllowedExtension(filename: string): boolean;
-    /**
-     * Get filename from URI
-     */
-    static getFilenameFromUri(uri: string): string;
-    /**
-     * Validate file size
-     */
-    static isValidFileSize(size: number): boolean;
-}

package/dist/filesystem/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * @filesystem
- */
-export type { FileEncoding, DirectoryType, FileOperationResult, FileInfo, DownloadProgress } from "./domain/entities/File";
-export { FILE_CONSTANTS, FileUtils } from "./domain/entities/File";
-export type { DownloadProgressCallback, DownloadWithProgressResult } from "./infrastructure/services/download.types";
-export { downloadFile, downloadFileWithProgress, isUrlCached, getCachedFileUri, deleteCachedFile } from "./infrastructure/services/download.service";
-export { getCacheDirectory, getDocumentDirectory, createDirectory } from "./infrastructure/services/directory.service";
-export { FileSystemService } from "./infrastructure/services/FileSystemService";
-export { fileExists, getFileInfo } from "./infrastructure/services/file-info.service";
-export { deleteFile } from "./infrastructure/services/file-manager.service";
-export { clearCache } from "./infrastructure/services/cache.service";
-export { readFile, readFileAsBase64 } from "./infrastructure/services/file-reader.service";
-export { extractBase64FromDataUri, detectMimeType, getExtensionFromMimeType, base64ToTempFile, deleteTempFile, getFileSize, } from "./infrastructure/utils/blob.utils";

package/dist/filesystem/infrastructure/services/FileSystemService.d.ts

@@ -1,34 +0,0 @@
-/**
- * FileSystem Service - Facade
- */
-import { readFile, readFileAsBase64 } from "./file-reader.service";
-import { writeFile } from "./file-writer.service";
-import { deleteFile, copyFile, moveFile } from "./file-manager.service";
-import { createDirectory, listDirectory, getDirectoryPath, getDocumentDirectory, getCacheDirectory } from "./directory.service";
-import { getFileInfo, fileExists, getFileSize } from "./file-info.service";
-import { downloadFile } from "./download.service";
-import { clearCache, getDirectorySize } from "./cache.service";
-import { generateFilePath } from "./file-path.service";
-import type { FileOperationResult } from "../../domain/entities/File";
-export declare class FileSystemService {
-    static readFile: typeof readFile;
-    static readFileAsBase64: typeof readFileAsBase64;
-    static writeFile: typeof writeFile;
-    static deleteFile: typeof deleteFile;
-    static copyFile: typeof copyFile;
-    static moveFile: typeof moveFile;
-    static createDirectory: typeof createDirectory;
-    static listDirectory: typeof listDirectory;
-    static getDirectoryPath: typeof getDirectoryPath;
-    static getDocumentDirectory: typeof getDocumentDirectory;
-    static getCacheDirectory: typeof getCacheDirectory;
-    static getFileInfo: typeof getFileInfo;
-    static exists: typeof fileExists;
-    static getFileSize: typeof getFileSize;
-    static downloadFile: typeof downloadFile;
-    static clearCache: typeof clearCache;
-    static getDirectorySize: typeof getDirectorySize;
-    static generateFilePath: typeof generateFilePath;
-    static copyToCache(sourceUri: string, filename?: string): Promise<FileOperationResult>;
-    static copyToDocuments(sourceUri: string, filename?: string): Promise<FileOperationResult>;
-}

package/dist/filesystem/infrastructure/services/cache.service.d.ts

@@ -1,12 +0,0 @@
-/**
- * Cache Service
- * Single Responsibility: Manage cache directory operations
- */
-/**
- * Clear cache directory
- */
-export declare function clearCache(): Promise<boolean>;
-/**
- * Get total size of directory
- */
-export declare function getDirectorySize(uri: string): Promise<number>;

package/dist/filesystem/infrastructure/services/directory.service.d.ts

@@ -1,25 +0,0 @@
-/**
- * Directory Service
- * Single Responsibility: Manage directory operations
- */
-import type { DirectoryType } from "../../domain/entities/File";
-/**
- * Create directory
- */
-export declare function createDirectory(uri: string): Promise<boolean>;
-/**
- * List directory contents
- */
-export declare function listDirectory(uri: string): Promise<string[]>;
-/**
- * Get directory path by type
- */
-export declare function getDirectoryPath(type: DirectoryType): string;
-/**
- * Get document directory path
- */
-export declare function getDocumentDirectory(): string;
-/**
- * Get cache directory path
- */
-export declare function getCacheDirectory(): string;

package/dist/filesystem/infrastructure/services/download.constants.d.ts

@@ -1,5 +0,0 @@
-/**
- * Download Service Constants
- */
-export declare const SUPPORTED_DOWNLOAD_EXTENSIONS: readonly ["mp4", "mov", "m4v", "webm", "jpg", "png", "pdf"];
-export declare const DEFAULT_DOWNLOAD_EXTENSION: "mp4";

package/dist/filesystem/infrastructure/services/download.service.d.ts

@@ -1,10 +0,0 @@
-/**
- * Download Service
- */
-import type { FileOperationResult } from "../../domain/entities/File";
-import type { DownloadProgressCallback, DownloadWithProgressResult } from "./download.types";
-export declare function downloadFile(url: string, dest?: string): Promise<FileOperationResult>;
-export declare function downloadFileWithProgress(url: string, cacheDir: string, onProgress?: DownloadProgressCallback, signal?: AbortSignal): Promise<DownloadWithProgressResult>;
-export declare const isUrlCached: (url: string, dir: string) => boolean;
-export declare const getCachedFileUri: (url: string, dir: string) => string | null;
-export declare const deleteCachedFile: (url: string, dir: string) => Promise<boolean>;

package/dist/filesystem/infrastructure/services/download.types.d.ts

@@ -1,5 +0,0 @@
-import type { FileOperationResult, DownloadProgress } from "../../domain/entities/File";
-export type DownloadProgressCallback = (progress: DownloadProgress) => void;
-export interface DownloadWithProgressResult extends FileOperationResult {
-    fromCache?: boolean;
-}