@umituz/react-native-design-system 4.25.98 → 4.25.100

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

@@ -0,0 +1,25 @@
+/**
+ * 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

@@ -0,0 +1,27 @@
+/**
+ * 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

@@ -0,0 +1,31 @@
+/**
+ * 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

@@ -0,0 +1,34 @@
+/**
+ * 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

@@ -0,0 +1,16 @@
+/**
+ * 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

@@ -0,0 +1,26 @@
+/**
+ * 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

@@ -0,0 +1,22 @@
+/**
+ * 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

@@ -0,0 +1,6 @@
+/**
+ * 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

@@ -0,0 +1,17 @@
+/**
+ * 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

@@ -0,0 +1,8 @@
+/**
+ * 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

@@ -0,0 +1,38 @@
+/**
+ * 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

@@ -0,0 +1,41 @@
+/**
+ * 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

@@ -0,0 +1,14 @@
+/**
+ * @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

@@ -0,0 +1,34 @@
+/**
+ * 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

@@ -0,0 +1,12 @@
+/**
+ * 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

@@ -0,0 +1,25 @@
+/**
+ * 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

@@ -0,0 +1,5 @@
+/**
+ * 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

@@ -0,0 +1,10 @@
+/**
+ * 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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Encoding Service
+ * Single Responsibility: Handle file encoding/decoding operations
+ */
+import type { FileEncoding } from "../../domain/entities/File";
+/**
+ * Encoding type for Expo FileSystem
+ */
+export type ExpoEncodingType = FileEncoding;
+/**
+ * Convert FileEncoding to Expo FileSystem encoding type
+ */
+export declare function getEncodingType(encoding: FileEncoding): ExpoEncodingType;
+/**
+ * Validate encoding type
+ */
+export declare function isValidEncoding(encoding: string): encoding is FileEncoding;

package/dist/filesystem/infrastructure/services/file-info.service.d.ts

@@ -0,0 +1,17 @@
+/**
+ * File Info Service
+ * Single Responsibility: Get file information and metadata
+ */
+import type { FileInfo } from "../../domain/entities/File";
+/**
+ * Get file information
+ */
+export declare function getFileInfo(uri: string): Promise<FileInfo | null>;
+/**
+ * Check if file exists
+ */
+export declare function fileExists(uri: string): Promise<boolean>;
+/**
+ * Get file size
+ */
+export declare function getFileSize(uri: string): Promise<number>;

package/dist/filesystem/infrastructure/services/file-manager.service.d.ts

@@ -0,0 +1,17 @@
+/**
+ * File Manager Service
+ * Single Responsibility: Manage file operations (delete, copy, move)
+ */
+import type { FileOperationResult } from "../../domain/entities/File";
+/**
+ * Delete file or directory
+ */
+export declare function deleteFile(uri: string): Promise<boolean>;
+/**
+ * Copy file
+ */
+export declare function copyFile(sourceUri: string, destinationUri: string): Promise<FileOperationResult>;
+/**
+ * Move file
+ */
+export declare function moveFile(sourceUri: string, destinationUri: string): Promise<FileOperationResult>;

package/dist/filesystem/infrastructure/services/file-path.service.d.ts

@@ -0,0 +1,9 @@
+/**
+ * File Path Service
+ * Single Responsibility: Generate and manage file paths
+ */
+import type { DirectoryType } from "../../domain/entities/File";
+/**
+ * Generate unique file path in specified directory
+ */
+export declare function generateFilePath(filename: string, directory?: DirectoryType): string;

package/dist/filesystem/infrastructure/services/file-reader.service.d.ts

@@ -0,0 +1,13 @@
+/**
+ * File Reader Service
+ * Single Responsibility: Read files from device storage
+ */
+import type { FileEncoding } from "../../domain/entities/File";
+/**
+ * Read file as string with encoding
+ */
+export declare function readFile(uri: string, encoding?: FileEncoding): Promise<string | null>;
+/**
+ * Read file as base64 string
+ */
+export declare function readFileAsBase64(uri: string): Promise<string | null>;

package/dist/filesystem/infrastructure/services/file-writer.service.d.ts

@@ -0,0 +1,9 @@
+/**
+ * File Writer Service
+ * Single Responsibility: Write files to device storage
+ */
+import type { FileEncoding, FileOperationResult } from "../../domain/entities/File";
+/**
+ * Write string to file
+ */
+export declare function writeFile(uri: string, content: string, encoding?: FileEncoding): Promise<FileOperationResult>;

package/dist/filesystem/infrastructure/utils/blob.utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Blob Utils
+ * Base64 and file utility functions for React Native
+ */
+/**
+ * Extract raw base64 from data URI
+ */
+export declare function extractBase64FromDataUri(dataUri: string): string;
+/**
+ * Detect MIME type from data URI or base64
+ */
+export declare function detectMimeType(base64: string): string;
+/**
+ * Get file extension from MIME type
+ */
+export declare function getExtensionFromMimeType(mimeType: string): string;
+/**
+ * Write base64 to a temp file and return the file URI
+ * This is React Native compatible (no Blob/ArrayBuffer needed)
+ */
+export declare function base64ToTempFile(base64: string, filename?: string): Promise<string>;
+/**
+ * Delete a temp file
+ */
+export declare function deleteTempFile(uri: string): Promise<void>;
+/**
+ * Get file size from URI
+ */
+export declare function getFileSize(uri: string): number;

package/dist/gallery/gallery-download.service.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Gallery Download Service
+ * Single Responsibility: Download remote media to local storage
+ */
+import type { DownloadMediaResult } from "./types";
+declare class GalleryDownloadService {
+    downloadMedia(mediaUri: string, prefix?: string): Promise<DownloadMediaResult>;
+    isRemoteUrl(uri: string): boolean;
+    cleanupFile(fileUri: string): Promise<void>;
+}
+export declare const galleryDownloadService: GalleryDownloadService;
+export {};

package/dist/gallery/gallery-save.service.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Gallery Save Service
+ * Single Responsibility: Save media to device gallery
+ */
+import type { SaveMediaResult } from "./types";
+declare class GallerySaveService {
+    saveToGallery(mediaUri: string, prefix?: string): Promise<SaveMediaResult>;
+}
+export declare const gallerySaveService: GallerySaveService;
+export {};

package/dist/gallery/index.d.ts

@@ -0,0 +1,3 @@
+export { gallerySaveService } from "./gallery-save.service";
+export { galleryDownloadService } from "./gallery-download.service";
+export type { SaveMediaResult, DownloadMediaResult } from "./types";

package/dist/gallery/types.d.ts

@@ -0,0 +1,10 @@
+export interface SaveMediaResult {
+    success: boolean;
+    fileUri?: string;
+    error?: string;
+}
+export interface DownloadMediaResult {
+    success: boolean;
+    localUri?: string;
+    error?: string;
+}

package/dist/haptics/domain/entities/Haptic.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Haptics Domain - Core Entities
+ *
+ * This file defines core types and interfaces for haptic feedback.
+ * Handles vibration patterns and feedback types using expo-haptics.
+ *
+ * @domain haptics
+ * @layer domain/entities
+ */
+/**
+ * Impact feedback style (compatible with expo-haptics)
+ */
+export type ImpactStyle = 'Light' | 'Medium' | 'Heavy' | 'Rigid' | 'Soft';
+/**
+ * Notification feedback type (compatible with expo-haptics)
+ */
+export type NotificationType = 'Success' | 'Warning' | 'Error';
+/**
+ * Haptic patterns for common interactions
+ */
+export type HapticPattern = 'success' | 'warning' | 'error' | 'selection';
+/**
+ * Haptic constants
+ */
+export declare const HAPTIC_CONSTANTS: {
+    readonly DEFAULT_IMPACT: ImpactStyle;
+    readonly BUTTON_IMPACT: ImpactStyle;
+    readonly DELETE_IMPACT: ImpactStyle;
+    readonly ERROR_IMPACT: ImpactStyle;
+};
+/**
+ * Type guards for runtime type safety
+ */
+/**
+ * Check if value is a valid ImpactStyle
+ */
+export declare function isImpactStyle(value: unknown): value is ImpactStyle;
+/**
+ * Check if value is a valid NotificationType
+ */
+export declare function isNotificationType(value: unknown): value is NotificationType;
+/**
+ * Check if value is a valid HapticPattern
+ */
+export declare function isHapticPattern(value: unknown): value is HapticPattern;