@umituz/react-native-design-system 4.23.128 → 4.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-design-system",
-  "version": "4.23.128",
+  "version": "4.24.0",
   "description": "Universal design system for React Native apps - Consolidated package with atoms, molecules, organisms, theme, typography, responsive, safe area, exception, infinite scroll, UUID, image, timezone, offline, onboarding, and loading utilities",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/gallery/gallery-download.service.ts

@@ -0,0 +1,69 @@
+/**
+ * Gallery Download Service
+ * Single Responsibility: Download remote media to local storage
+ */
+
+import { FileSystemService } from "../filesystem";
+import { validateImageUri, getFileExtension } from "../image";
+import { timezoneService } from "../timezone";
+import type { DownloadMediaResult } from "./types";
+
+const generateFilename = (uri: string, prefix: string): string => {
+  const extension = getFileExtension(uri) || "jpg";
+  const timestamp = timezoneService.formatDateToString(new Date());
+  const randomId = Math.random().toString(36).substring(2, 10);
+  return `${prefix}_${timestamp}_${randomId}.${extension}`;
+};
+
+class GalleryDownloadService {
+  async downloadMedia(
+    mediaUri: string,
+    prefix: string = "media",
+  ): Promise<DownloadMediaResult> {
+    try {
+      const validationResult = validateImageUri(mediaUri, "Media");
+      if (!validationResult.isValid) {
+        return {
+          success: false,
+          error: validationResult.error || "Invalid media file",
+        };
+      }
+
+      const filename = generateFilename(mediaUri, prefix);
+      const documentDir = FileSystemService.getDocumentDirectory();
+      const fileUri = `${documentDir}${filename}`;
+
+      const downloadResult = await FileSystemService.downloadFile(
+        mediaUri,
+        fileUri,
+      );
+
+      if (!downloadResult.success || !downloadResult.uri) {
+        return {
+          success: false,
+          error: downloadResult.error || "Download failed",
+        };
+      }
+
+      return {
+        success: true,
+        localUri: downloadResult.uri,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Download failed",
+      };
+    }
+  }
+
+  isRemoteUrl(uri: string): boolean {
+    return uri.startsWith("http://") || uri.startsWith("https://");
+  }
+
+  async cleanupFile(fileUri: string): Promise<void> {
+    await FileSystemService.deleteFile(fileUri);
+  }
+}
+
+export const galleryDownloadService = new GalleryDownloadService();

package/src/gallery/gallery-save.service.ts

@@ -0,0 +1,80 @@
+/**
+ * Gallery Save Service
+ * Single Responsibility: Save media to device gallery
+ */
+
+import * as MediaLibrary from "expo-media-library";
+import { validateImageUri } from "../image";
+import { galleryDownloadService } from "./gallery-download.service";
+import type { SaveMediaResult } from "./types";
+
+const requestMediaPermissions = async (): Promise<boolean> => {
+  try {
+    const { status } = await MediaLibrary.requestPermissionsAsync();
+    return status === "granted";
+  } catch {
+    return false;
+  }
+};
+
+class GallerySaveService {
+  async saveToGallery(
+    mediaUri: string,
+    prefix?: string,
+  ): Promise<SaveMediaResult> {
+    try {
+      const validationResult = validateImageUri(mediaUri, "Media");
+      if (!validationResult.isValid) {
+        return {
+          success: false,
+          error: validationResult.error || "Invalid media file",
+        };
+      }
+
+      const hasPermission = await requestMediaPermissions();
+      if (!hasPermission) {
+        return {
+          success: false,
+          error: "Media library permission denied",
+        };
+      }
+
+      let localUri = mediaUri;
+      const isRemote = galleryDownloadService.isRemoteUrl(mediaUri);
+
+      if (isRemote) {
+        const downloadResult = await galleryDownloadService.downloadMedia(
+          mediaUri,
+          prefix,
+        );
+
+        if (!downloadResult.success || !downloadResult.localUri) {
+          return {
+            success: false,
+            error: downloadResult.error || "Download failed",
+          };
+        }
+
+        localUri = downloadResult.localUri;
+      }
+
+      const asset = await MediaLibrary.createAssetAsync(localUri);
+
+      if (isRemote && localUri) {
+        await galleryDownloadService.cleanupFile(localUri);
+      }
+
+      return {
+        success: true,
+        fileUri: asset.uri,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Save failed",
+      };
+    }
+  }
+}
+
+export const gallerySaveService = new GallerySaveService();

package/src/gallery/index.ts

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

package/src/gallery/types.ts

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

package/src/index.ts

@@ -147,3 +147,8 @@ export * from "./loading";
 // INIT EXPORTS
 // =============================================================================
 export * from "./init";
+
+// =============================================================================
+// GALLERY EXPORTS
+// =============================================================================
+export * from "./gallery";