@umituz/react-native-filesystem 2.1.3 → 2.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-filesystem",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "Domain-Driven Design filesystem utilities for React Native apps with build-time module loading and runtime file operations",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/domain/entities/File.ts

@@ -0,0 +1,132 @@
+/**
+ * File Entity
+ * Domain layer types and utilities 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;
+}
+
+/**
+ * File-related constants
+ */
+export const FILE_CONSTANTS = {
+  MAX_FILE_SIZE: 100 * 1024 * 1024, // 100 MB
+  ALLOWED_EXTENSIONS: ['.jpg', '.jpeg', '.png', '.pdf', '.txt', '.json', '.mp4', '.mp3'],
+  DEFAULT_ENCODING: 'utf8' as FileEncoding,
+} as const;
+
+/**
+ * File utility functions
+ */
+export class FileUtils {
+  /**
+   * Format file size in bytes to human-readable format
+   */
+  static formatFileSize(bytes: number): string {
+    if (bytes === 0) return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + ' ' + sizes[i];
+  }
+
+  /**
+   * Generate unique filename with timestamp
+   */
+  static generateUniqueFilename(filename: string): string {
+    const timestamp = Date.now();
+    const extension = filename.includes('.') ? filename.substring(filename.lastIndexOf('.')) : '';
+    const nameWithoutExt = filename.includes('.')
+      ? filename.substring(0, filename.lastIndexOf('.'))
+      : filename;
+    return `${nameWithoutExt}_${timestamp}${extension}`;
+  }
+
+  /**
+   * Sanitize filename by removing invalid characters
+   */
+  static sanitizeFilename(filename: string): string {
+    return filename.replace(/[^a-zA-Z0-9._-]/g, '_');
+  }
+
+  /**
+   * Join path segments
+   */
+  static joinPaths(...segments: string[]): string {
+    return segments
+      .map((segment, index) => {
+        if (index === 0) {
+          return segment.replace(/\/+$/, '');
+        }
+        return segment.replace(/^\/+/, '').replace(/\/+$/, '');
+      })
+      .filter(segment => segment.length > 0)
+      .join('/');
+  }
+
+  /**
+   * Get file extension from filename
+   */
+  static getFileExtension(filename: string): string {
+    const lastDot = filename.lastIndexOf('.');
+    return lastDot > 0 ? filename.substring(lastDot) : '';
+  }
+
+  /**
+   * Check if file extension is allowed
+   */
+  static isAllowedExtension(filename: string): boolean {
+    const extension = this.getFileExtension(filename).toLowerCase();
+    return (FILE_CONSTANTS.ALLOWED_EXTENSIONS as readonly string[]).includes(extension);
+  }
+
+  /**
+   * Get filename from URI
+   */
+  static getFilenameFromUri(uri: string): string {
+    return uri.split('/').pop() || '';
+  }
+
+  /**
+   * Validate file size
+   */
+  static isValidFileSize(size: number): boolean {
+    return size > 0 && size <= FILE_CONSTANTS.MAX_FILE_SIZE;
+  }
+}

package/src/domain/entities/ModuleContext.ts

@@ -0,0 +1,31 @@
+/**
+ * Module Context Entity
+ * Domain layer types for build-time module loading
+ *
+ * DEPRECATED: These types are kept for backward compatibility only.
+ * The module loading functionality is no longer actively used.
+ */
+
+/**
+ * RequireFunction interface for Webpack/Metro require.context
+ * @deprecated No longer actively used
+ */
+export interface RequireContext {
+  keys(): string[];
+  (id: string): any;
+  <T>(id: string): T;
+  resolve(id: string): string;
+  id: string;
+}
+
+/**
+ * Collection of loaded modules
+ * @deprecated No longer actively used
+ */
+export type ModuleCollection = Record<string, any>;
+
+/**
+ * Supported file extensions for module loading
+ * @deprecated No longer actively used
+ */
+export type FileExtension = '.json' | '.js' | '.ts' | '.tsx';