@mentra/engine 0.1.0-beta.0

package/build/utils/permissions/MediaLibraryPermissions.js

@@ -0,0 +1,145 @@
+import { Platform } from "react-native";
+import { check, request, PERMISSIONS, RESULTS } from "react-native-permissions";
+import CrustModule from "@mentra/crust";
+import { deriveGalleryDisplayName } from "./galleryDisplayName";
+/**
+ * MediaLibraryPermissions - Handles save-only permissions for camera roll
+ *
+ * Platform behavior:
+ * - iOS: Uses PHOTO_LIBRARY (read-write) so we can manage the MentraOS album
+ * - Android 10+ (API 29+): No permission needed to save your own files to MediaStore
+ * - Android 9-: Uses WRITE_EXTERNAL_STORAGE (legacy)
+ */
+export class MediaLibraryPermissions {
+    /** Limited iOS access cannot see historical, unselected assets for duplicate reconciliation. */
+    static async hasLimitedAccess() {
+        if (Platform.OS !== "ios")
+            return false;
+        try {
+            return (await check(PERMISSIONS.IOS.PHOTO_LIBRARY)) === RESULTS.LIMITED;
+        }
+        catch (error) {
+            console.error("[MediaLibrary] Error checking limited-library access:", error);
+            // Conservatively block legacy reconciliation when the scope cannot be verified.
+            return true;
+        }
+    }
+    /**
+     * Check if we have permission to save to the camera roll
+     * Note: On Android 10+, this always returns true since no permission is needed
+     */
+    static async checkPermission() {
+        try {
+            if (Platform.OS === "ios") {
+                const status = await check(PERMISSIONS.IOS.PHOTO_LIBRARY);
+                return status === RESULTS.GRANTED || status === RESULTS.LIMITED;
+            }
+            if (Platform.OS === "android") {
+                // Android 10+ (API 29+): No permission needed to save your own files
+                if (Platform.Version >= 29) {
+                    return true;
+                }
+                // Android 9 and below: Check legacy write permission
+                const status = await check(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE);
+                return status === RESULTS.GRANTED;
+            }
+            return false;
+        }
+        catch (error) {
+            console.error("[MediaLibrary] Error checking permission:", error);
+            // On error, assume we can try (Android 10+ doesn't need permission anyway)
+            return Platform.OS === "android" && Platform.Version >= 29;
+        }
+    }
+    /**
+     * Request permission to save to the camera roll
+     * Note: On Android 10+, this always returns true since no permission is needed
+     */
+    static async requestPermission() {
+        try {
+            if (Platform.OS === "ios") {
+                const status = await request(PERMISSIONS.IOS.PHOTO_LIBRARY);
+                return status === RESULTS.GRANTED || status === RESULTS.LIMITED;
+            }
+            if (Platform.OS === "android") {
+                // Android 10+ (API 29+): No permission needed to save your own files
+                if (Platform.Version >= 29) {
+                    return true;
+                }
+                // Android 9 and below: Request legacy write permission
+                const status = await request(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE);
+                return status === RESULTS.GRANTED;
+            }
+            return false;
+        }
+        catch (error) {
+            console.error("[MediaLibrary] Error requesting permission:", error);
+            // On error, assume we can try (Android 10+ doesn't need permission anyway)
+            return Platform.OS === "android" && Platform.Version >= 29;
+        }
+    }
+    /**
+     * Save a file to the photo library in a glasses-specific location (MentraOS album on iOS;
+     * Pictures/MentraOS or Movies/MentraOS on Android 10+).
+     * On Android 10+, this works without any permission.
+     *
+     * IMPORTANT: This method sets the DATE_TAKEN (Android) or creation date (iOS)
+     * metadata to the original capture time, so gallery apps show the correct date.
+     * Also saves files in chronological order for proper "date added" ordering.
+     *
+     * @param filePath - Path to the file to save
+     * @param creationTime - Optional creation/capture time in milliseconds (Unix timestamp)
+     */
+    static async saveToLibrary(filePath, creationTime) {
+        return (await this.saveToLibraryWithReceipt(filePath, creationTime)).success;
+    }
+    /** Save and return the durable MediaStore/PhotoKit identifier used as the export receipt. */
+    static async saveToLibraryWithReceipt(filePath, creationTime) {
+        const platform = Platform.OS === "ios" || Platform.OS === "android" ? Platform.OS : "unknown";
+        try {
+            // On Android 10+, we can save without permission
+            // On iOS and older Android, check permission first
+            if (!(Platform.OS === "android" && Platform.Version >= 29)) {
+                const hasPermission = await this.checkPermission();
+                if (!hasPermission) {
+                    // Try requesting permission one more time
+                    const granted = await this.requestPermission();
+                    if (!granted) {
+                        console.warn("[MediaLibrary] No permission to save to library - photos saved to app storage only");
+                        return { success: false, platform, error: "permission denied" };
+                    }
+                }
+            }
+            // Remove file:// prefix if present
+            const cleanPath = filePath.replace("file://", "");
+            const displayName = deriveGalleryDisplayName(cleanPath);
+            // Use native module to save with proper DATE_TAKEN / creation date metadata
+            // This ensures gallery apps show the correct capture date, not the sync date
+            const result = await CrustModule.saveToGalleryWithDate(cleanPath, creationTime, displayName);
+            if (result.success) {
+                if (creationTime) {
+                    const captureDate = new Date(creationTime);
+                    console.log(`[MediaLibrary] Saved to camera roll with DATE_TAKEN: ${cleanPath} (captured: ${captureDate.toISOString()})`);
+                }
+                else {
+                    console.log(`[MediaLibrary] Saved to camera roll: ${cleanPath}`);
+                }
+                return {
+                    success: true,
+                    platform,
+                    uri: result.uri,
+                    identifier: result.identifier,
+                };
+            }
+            else {
+                console.error(`[MediaLibrary] Failed to save to library: ${result.error}`);
+                return { success: false, platform, error: result.error || "native export failed" };
+            }
+        }
+        catch (error) {
+            console.error("[MediaLibrary] Error saving to library:", error);
+            return { success: false, platform, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+}
+//# sourceMappingURL=MediaLibraryPermissions.js.map

package/build/utils/permissions/MediaLibraryPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaLibraryPermissions.js","sourceRoot":"","sources":["../../../src/utils/permissions/MediaLibraryPermissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAA;AACrC,OAAO,EAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAC,MAAM,0BAA0B,CAAA;AAE7E,OAAO,WAAW,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAC,wBAAwB,EAAC,MAAM,sBAAsB,CAAA;AAU7D;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IAClC,gGAAgG;IAChG,MAAM,CAAC,KAAK,CAAC,gBAAgB;QAC3B,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK;YAAE,OAAO,KAAK,CAAA;QACvC,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAA;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uDAAuD,EAAE,KAAK,CAAC,CAAA;YAC7E,gFAAgF;YAChF,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,eAAe;QAC1B,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;gBACzD,OAAO,MAAM,KAAK,OAAO,CAAC,OAAO,IAAI,MAAM,KAAK,OAAO,CAAC,OAAO,CAAA;YACjE,CAAC;YAED,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;gBAC9B,qEAAqE;gBACrE,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;oBAC3B,OAAO,IAAI,CAAA;gBACb,CAAC;gBACD,qDAAqD;gBACrD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAA;gBACtE,OAAO,MAAM,KAAK,OAAO,CAAC,OAAO,CAAA;YACnC,CAAC;YAED,OAAO,KAAK,CAAA;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAA;YACjE,2EAA2E;YAC3E,OAAO,QAAQ,CAAC,EAAE,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAA;QAC5D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,iBAAiB;QAC5B,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;gBAC3D,OAAO,MAAM,KAAK,OAAO,CAAC,OAAO,IAAI,MAAM,KAAK,OAAO,CAAC,OAAO,CAAA;YACjE,CAAC;YAED,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;gBAC9B,qEAAqE;gBACrE,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;oBAC3B,OAAO,IAAI,CAAA;gBACb,CAAC;gBACD,uDAAuD;gBACvD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAA;gBACxE,OAAO,MAAM,KAAK,OAAO,CAAC,OAAO,CAAA;YACnC,CAAC;YAED,OAAO,KAAK,CAAA;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAA;YACnE,2EAA2E;YAC3E,OAAO,QAAQ,CAAC,EAAE,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAA;QAC5D,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,YAAqB;QAChE,OAAO,CAAC,MAAM,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAA;IAC9E,CAAC;IAED,6FAA6F;IAC7F,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,QAAgB,EAAE,YAAqB;QAC3E,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QAC7F,IAAI,CAAC;YACH,iDAAiD;YACjD,mDAAmD;YACnD,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC3D,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;gBAClD,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,0CAA0C;oBAC1C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAA;oBAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,OAAO,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAA;wBAClG,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAC,CAAA;oBAC/D,CAAC;gBACH,CAAC;YACH,CAAC;YAED,mCAAmC;YACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;YACjD,MAAM,WAAW,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAA;YAEvD,4EAA4E;YAC5E,6EAA6E;YAC7E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,qBAAqB,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC,CAAA;YAE5F,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,YAAY,EAAE,CAAC;oBACjB,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAA;oBAC1C,OAAO,CAAC,GAAG,CACT,wDAAwD,SAAS,eAAe,WAAW,CAAC,WAAW,EAAE,GAAG,CAC7G,CAAA;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,wCAAwC,SAAS,EAAE,CAAC,CAAA;gBAClE,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,QAAQ;oBACR,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC9B,CAAA;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,6CAA6C,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;gBAC1E,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,sBAAsB,EAAC,CAAA;YAClF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAA;YAC/D,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAC,CAAA;QAClG,CAAC;IACH,CAAC;CACF","sourcesContent":["import {Platform} from \"react-native\"\nimport {check, request, PERMISSIONS, RESULTS} from \"react-native-permissions\"\n\nimport CrustModule from \"@mentra/crust\"\n\nimport {deriveGalleryDisplayName} from \"./galleryDisplayName\"\n\nexport interface MediaLibrarySaveReceipt {\n  success: boolean\n  platform: \"ios\" | \"android\" | \"unknown\"\n  uri?: string\n  identifier?: string\n  error?: string\n}\n\n/**\n * MediaLibraryPermissions - Handles save-only permissions for camera roll\n *\n * Platform behavior:\n * - iOS: Uses PHOTO_LIBRARY (read-write) so we can manage the MentraOS album\n * - Android 10+ (API 29+): No permission needed to save your own files to MediaStore\n * - Android 9-: Uses WRITE_EXTERNAL_STORAGE (legacy)\n */\nexport class MediaLibraryPermissions {\n  /** Limited iOS access cannot see historical, unselected assets for duplicate reconciliation. */\n  static async hasLimitedAccess(): Promise<boolean> {\n    if (Platform.OS !== \"ios\") return false\n    try {\n      return (await check(PERMISSIONS.IOS.PHOTO_LIBRARY)) === RESULTS.LIMITED\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error checking limited-library access:\", error)\n      // Conservatively block legacy reconciliation when the scope cannot be verified.\n      return true\n    }\n  }\n\n  /**\n   * Check if we have permission to save to the camera roll\n   * Note: On Android 10+, this always returns true since no permission is needed\n   */\n  static async checkPermission(): Promise<boolean> {\n    try {\n      if (Platform.OS === \"ios\") {\n        const status = await check(PERMISSIONS.IOS.PHOTO_LIBRARY)\n        return status === RESULTS.GRANTED || status === RESULTS.LIMITED\n      }\n\n      if (Platform.OS === \"android\") {\n        // Android 10+ (API 29+): No permission needed to save your own files\n        if (Platform.Version >= 29) {\n          return true\n        }\n        // Android 9 and below: Check legacy write permission\n        const status = await check(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE)\n        return status === RESULTS.GRANTED\n      }\n\n      return false\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error checking permission:\", error)\n      // On error, assume we can try (Android 10+ doesn't need permission anyway)\n      return Platform.OS === \"android\" && Platform.Version >= 29\n    }\n  }\n\n  /**\n   * Request permission to save to the camera roll\n   * Note: On Android 10+, this always returns true since no permission is needed\n   */\n  static async requestPermission(): Promise<boolean> {\n    try {\n      if (Platform.OS === \"ios\") {\n        const status = await request(PERMISSIONS.IOS.PHOTO_LIBRARY)\n        return status === RESULTS.GRANTED || status === RESULTS.LIMITED\n      }\n\n      if (Platform.OS === \"android\") {\n        // Android 10+ (API 29+): No permission needed to save your own files\n        if (Platform.Version >= 29) {\n          return true\n        }\n        // Android 9 and below: Request legacy write permission\n        const status = await request(PERMISSIONS.ANDROID.WRITE_EXTERNAL_STORAGE)\n        return status === RESULTS.GRANTED\n      }\n\n      return false\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error requesting permission:\", error)\n      // On error, assume we can try (Android 10+ doesn't need permission anyway)\n      return Platform.OS === \"android\" && Platform.Version >= 29\n    }\n  }\n\n  /**\n   * Save a file to the photo library in a glasses-specific location (MentraOS album on iOS;\n   * Pictures/MentraOS or Movies/MentraOS on Android 10+).\n   * On Android 10+, this works without any permission.\n   *\n   * IMPORTANT: This method sets the DATE_TAKEN (Android) or creation date (iOS)\n   * metadata to the original capture time, so gallery apps show the correct date.\n   * Also saves files in chronological order for proper \"date added\" ordering.\n   *\n   * @param filePath - Path to the file to save\n   * @param creationTime - Optional creation/capture time in milliseconds (Unix timestamp)\n   */\n  static async saveToLibrary(filePath: string, creationTime?: number): Promise<boolean> {\n    return (await this.saveToLibraryWithReceipt(filePath, creationTime)).success\n  }\n\n  /** Save and return the durable MediaStore/PhotoKit identifier used as the export receipt. */\n  static async saveToLibraryWithReceipt(filePath: string, creationTime?: number): Promise<MediaLibrarySaveReceipt> {\n    const platform = Platform.OS === \"ios\" || Platform.OS === \"android\" ? Platform.OS : \"unknown\"\n    try {\n      // On Android 10+, we can save without permission\n      // On iOS and older Android, check permission first\n      if (!(Platform.OS === \"android\" && Platform.Version >= 29)) {\n        const hasPermission = await this.checkPermission()\n        if (!hasPermission) {\n          // Try requesting permission one more time\n          const granted = await this.requestPermission()\n          if (!granted) {\n            console.warn(\"[MediaLibrary] No permission to save to library - photos saved to app storage only\")\n            return {success: false, platform, error: \"permission denied\"}\n          }\n        }\n      }\n\n      // Remove file:// prefix if present\n      const cleanPath = filePath.replace(\"file://\", \"\")\n      const displayName = deriveGalleryDisplayName(cleanPath)\n\n      // Use native module to save with proper DATE_TAKEN / creation date metadata\n      // This ensures gallery apps show the correct capture date, not the sync date\n      const result = await CrustModule.saveToGalleryWithDate(cleanPath, creationTime, displayName)\n\n      if (result.success) {\n        if (creationTime) {\n          const captureDate = new Date(creationTime)\n          console.log(\n            `[MediaLibrary] Saved to camera roll with DATE_TAKEN: ${cleanPath} (captured: ${captureDate.toISOString()})`,\n          )\n        } else {\n          console.log(`[MediaLibrary] Saved to camera roll: ${cleanPath}`)\n        }\n        return {\n          success: true,\n          platform,\n          uri: result.uri,\n          identifier: result.identifier,\n        }\n      } else {\n        console.error(`[MediaLibrary] Failed to save to library: ${result.error}`)\n        return {success: false, platform, error: result.error || \"native export failed\"}\n      }\n    } catch (error) {\n      console.error(\"[MediaLibrary] Error saving to library:\", error)\n      return {success: false, platform, error: error instanceof Error ? error.message : String(error)}\n    }\n  }\n}\n"]}

package/build/utils/permissions/galleryDisplayName.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Derive a unique MediaStore display name for camera-roll saves.
+ *
+ * Capture downloads use folder layout `IMG_xxx/base.jpg` (or `VID_xxx/base.mp4`).
+ * Using the leaf filename (`base.jpg`) causes MediaStore collisions on Android.
+ */
+export declare function deriveGalleryDisplayName(filePath: string): string;
+//# sourceMappingURL=galleryDisplayName.d.ts.map

package/build/utils/permissions/galleryDisplayName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"galleryDisplayName.d.ts","sourceRoot":"","sources":["../../../src/utils/permissions/galleryDisplayName.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBjE"}

package/build/utils/permissions/galleryDisplayName.js

@@ -0,0 +1,25 @@
+const CAPTURE_FOLDER_PATTERN = /^(IMG|VID)_/;
+/**
+ * Derive a unique MediaStore display name for camera-roll saves.
+ *
+ * Capture downloads use folder layout `IMG_xxx/base.jpg` (or `VID_xxx/base.mp4`).
+ * Using the leaf filename (`base.jpg`) causes MediaStore collisions on Android.
+ */
+export function deriveGalleryDisplayName(filePath) {
+    const cleanPath = filePath.replace("file://", "");
+    const lastSlash = cleanPath.lastIndexOf("/");
+    if (lastSlash < 0) {
+        return cleanPath;
+    }
+    const fileName = cleanPath.substring(lastSlash + 1);
+    const parentDir = cleanPath.substring(0, lastSlash);
+    const parentSlash = parentDir.lastIndexOf("/");
+    const parentName = parentSlash < 0 ? parentDir : parentDir.substring(parentSlash + 1);
+    if (!CAPTURE_FOLDER_PATTERN.test(parentName)) {
+        return fileName;
+    }
+    const isVideo = /\.(mp4|mov|m4v|avi)(\.|$)/i.test(fileName);
+    const extension = isVideo ? "mp4" : "jpg";
+    return `${parentName}.${extension}`;
+}
+//# sourceMappingURL=galleryDisplayName.js.map

package/build/utils/permissions/galleryDisplayName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"galleryDisplayName.js","sourceRoot":"","sources":["../../../src/utils/permissions/galleryDisplayName.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,aAAa,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC5C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC,CAAA;IACnD,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IACnD,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC9C,MAAM,UAAU,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,GAAG,CAAC,CAAC,CAAA;IAErF,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;IACzC,OAAO,GAAG,UAAU,IAAI,SAAS,EAAE,CAAA;AACrC,CAAC","sourcesContent":["const CAPTURE_FOLDER_PATTERN = /^(IMG|VID)_/\n\n/**\n * Derive a unique MediaStore display name for camera-roll saves.\n *\n * Capture downloads use folder layout `IMG_xxx/base.jpg` (or `VID_xxx/base.mp4`).\n * Using the leaf filename (`base.jpg`) causes MediaStore collisions on Android.\n */\nexport function deriveGalleryDisplayName(filePath: string): string {\n  const cleanPath = filePath.replace(\"file://\", \"\")\n  const lastSlash = cleanPath.lastIndexOf(\"/\")\n  if (lastSlash < 0) {\n    return cleanPath\n  }\n\n  const fileName = cleanPath.substring(lastSlash + 1)\n  const parentDir = cleanPath.substring(0, lastSlash)\n  const parentSlash = parentDir.lastIndexOf(\"/\")\n  const parentName = parentSlash < 0 ? parentDir : parentDir.substring(parentSlash + 1)\n\n  if (!CAPTURE_FOLDER_PATTERN.test(parentName)) {\n    return fileName\n  }\n\n  const isVideo = /\\.(mp4|mov|m4v|avi)(\\.|$)/i.test(fileName)\n  const extension = isVideo ? \"mp4\" : \"jpg\"\n  return `${parentName}.${extension}`\n}\n"]}

package/build/utils/storage/index.d.ts

@@ -0,0 +1,3 @@
+export { storage, StorageValueNotFoundError } from "./storage";
+export { printDirectory } from "./zip";
+//# sourceMappingURL=index.d.ts.map

package/build/utils/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,yBAAyB,EAAC,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAC,cAAc,EAAC,MAAM,OAAO,CAAA"}

package/build/utils/storage/index.js

@@ -0,0 +1,3 @@
+export { storage, StorageValueNotFoundError } from "./storage";
+export { printDirectory } from "./zip";
+//# sourceMappingURL=index.js.map

package/build/utils/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,yBAAyB,EAAC,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAC,cAAc,EAAC,MAAM,OAAO,CAAA","sourcesContent":["export {storage, StorageValueNotFoundError} from \"./storage\"\nexport {printDirectory} from \"./zip\"\n"]}

package/build/utils/storage/storage.d.ts

@@ -0,0 +1,24 @@
+import { Result } from "typesafe-ts";
+/**
+ * Thrown by load() when the key has no stored value. Callers that treat a
+ * missing key as an expected state (e.g. first run) should branch on
+ * `instanceof StorageValueNotFoundError` rather than matching the message.
+ */
+export declare class StorageValueNotFoundError extends Error {
+    constructor(key: string);
+}
+declare class MMKVStorage {
+    private _store?;
+    private get store();
+    save(key: string, value: unknown): Result<void, Error>;
+    load<T>(key: string): Result<T, Error>;
+    private saveString;
+    getAllKeys(): string[];
+    removeMultiple(keys: string[]): Result<void, Error>;
+    loadSubKeys(key: string): Result<Record<string, unknown>, Error>;
+    remove(key: string): Result<void, Error>;
+    clearAll(): Result<void, Error>;
+}
+export declare const storage: MMKVStorage;
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/build/utils/storage/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/utils/storage/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,MAAM,EAAC,MAAM,aAAa,CAAA;AAEjD;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,GAAG,EAAE,MAAM;CAIxB;AAED,cAAM,WAAW;IACf,OAAO,CAAC,MAAM,CAAC,CAAM;IAErB,OAAO,KAAK,KAAK,GAKhB;IAEM,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;IAItD,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC;IAW7C,OAAO,CAAC,UAAU;IAKX,UAAU,IAAI,MAAM,EAAE;IAItB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;IAenD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC;IAwBhE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;IAKxC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;CAIvC;AAED,eAAO,MAAM,OAAO,aAAoB,CAAA"}

package/build/utils/storage/storage.js

@@ -0,0 +1,85 @@
+// @ts-nocheck
+import { createMMKV } from "react-native-mmkv";
+import { result as Res } from "typesafe-ts";
+/**
+ * Thrown by load() when the key has no stored value. Callers that treat a
+ * missing key as an expected state (e.g. first run) should branch on
+ * `instanceof StorageValueNotFoundError` rather than matching the message.
+ */
+export class StorageValueNotFoundError extends Error {
+    constructor(key) {
+        super(`No value found for ${key}`);
+        this.name = "StorageValueNotFoundError";
+    }
+}
+class MMKVStorage {
+    _store;
+    get store() {
+        if (!this._store) {
+            this._store = createMMKV();
+        }
+        return this._store;
+    }
+    save(key, value) {
+        return this.saveString(key, JSON.stringify(value));
+    }
+    load(key) {
+        return Res.try(() => {
+            const loadedString = this.store.getString(key) ?? "";
+            if (loadedString === "") {
+                throw new StorageValueNotFoundError(key);
+            }
+            const value = JSON.parse(loadedString);
+            return value;
+        });
+    }
+    saveString(key, value) {
+        this.store.set(key, value);
+        return Res.ok(undefined);
+    }
+    getAllKeys() {
+        return this.store.getAllKeys();
+    }
+    removeMultiple(keys) {
+        let success = true;
+        for (const key of keys) {
+            const res = this.store.remove(key);
+            if (!res) {
+                success = false;
+            }
+        }
+        if (!success) {
+            console.error("Failed to remove one or more keys");
+            return Res.error(new Error("Failed to remove one or more keys"));
+        }
+        return Res.ok(undefined);
+    }
+    loadSubKeys(key) {
+        return Res.try(() => {
+            // return the key value pair of any keys that start with the given key and contain a colon:
+            const keys = this.store.getAllKeys();
+            const subKeys = keys.filter((k) => k.startsWith(key) && k.includes(":"));
+            if (subKeys.length === 0) {
+                throw new Error(`No subkeys found for ${key}`);
+            }
+            let subKeysObject = {};
+            for (const subKey of subKeys) {
+                const res = this.load(subKey);
+                if (res.is_ok()) {
+                    subKeysObject[subKey] = res.value;
+                }
+            }
+            return subKeysObject;
+        });
+    }
+    remove(key) {
+        this.store.remove(key);
+        return Res.ok(undefined);
+    }
+    clearAll() {
+        this.store.clearAll();
+        return Res.ok(undefined);
+    }
+}
+export const storage = new MMKVStorage();
+//# sourceMappingURL=storage.js.map

package/build/utils/storage/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/utils/storage/storage.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport {createMMKV, type MMKV} from \"react-native-mmkv\"\nimport {result as Res, Result} from \"typesafe-ts\"\n\n/**\n * Thrown by load() when the key has no stored value. Callers that treat a\n * missing key as an expected state (e.g. first run) should branch on\n * `instanceof StorageValueNotFoundError` rather than matching the message.\n */\nexport class StorageValueNotFoundError extends Error {\n  constructor(key: string) {\n    super(`No value found for ${key}`)\n    this.name = \"StorageValueNotFoundError\"\n  }\n}\n\nclass MMKVStorage {\n  private _store?: MMKV\n\n  private get store(): MMKV {\n    if (!this._store) {\n      this._store = createMMKV()\n    }\n    return this._store\n  }\n\n  public save(key: string, value: unknown): Result<void, Error> {\n    return this.saveString(key, JSON.stringify(value))\n  }\n\n  public load<T>(key: string): Result<T, Error> {\n    return Res.try(() => {\n      const loadedString = this.store.getString(key) ?? \"\"\n      if (loadedString === \"\") {\n        throw new StorageValueNotFoundError(key)\n      }\n      const value = JSON.parse(loadedString) as T\n      return value\n    })\n  }\n\n  private saveString(key: string, value: string): Result<void, Error> {\n    this.store.set(key, value)\n    return Res.ok(undefined)\n  }\n\n  public getAllKeys(): string[] {\n    return this.store.getAllKeys()\n  }\n\n  public removeMultiple(keys: string[]): Result<void, Error> {\n    let success = true\n    for (const key of keys) {\n      const res = this.store.remove(key)\n      if (!res) {\n        success = false\n      }\n    }\n    if (!success) {\n      console.error(\"Failed to remove one or more keys\")\n      return Res.error(new Error(\"Failed to remove one or more keys\"))\n    }\n    return Res.ok(undefined)\n  }\n\n  public loadSubKeys(key: string): Result<Record<string, unknown>, Error> {\n    return Res.try(() => {\n      // return the key value pair of any keys that start with the given key and contain a colon:\n      const keys = this.store.getAllKeys()\n\n      const subKeys = keys.filter((k) => k.startsWith(key) && k.includes(\":\"))\n\n      if (subKeys.length === 0) {\n        throw new Error(`No subkeys found for ${key}`)\n      }\n\n      let subKeysObject: Record<string, unknown> = {}\n\n      for (const subKey of subKeys) {\n        const res = this.load(subKey)\n        if (res.is_ok()) {\n          subKeysObject[subKey] = res.value\n        }\n      }\n\n      return subKeysObject\n    })\n  }\n\n  public remove(key: string): Result<void, Error> {\n    this.store.remove(key)\n    return Res.ok(undefined)\n  }\n\n  public clearAll(): Result<void, Error> {\n    this.store.clearAll()\n    return Res.ok(undefined)\n  }\n}\n\nexport const storage = new MMKVStorage()\n"]}

package/build/utils/storage/zip.d.ts

@@ -0,0 +1,3 @@
+import { Directory } from "expo-file-system";
+export declare function printDirectory(directory: Directory, indent?: number): void;
+//# sourceMappingURL=zip.d.ts.map

package/build/utils/storage/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../../src/utils/storage/zip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,kBAAkB,CAAA;AAE1C,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,GAAE,MAAU,QAUtE"}

package/build/utils/storage/zip.js

@@ -0,0 +1,14 @@
+import { Directory } from "expo-file-system";
+export function printDirectory(directory, indent = 0) {
+    console.log(`${" ".repeat(indent)} + ${directory.name}`);
+    const contents = directory.list();
+    for (const item of contents) {
+        if (item instanceof Directory) {
+            printDirectory(item, indent + 2);
+        }
+        else {
+            console.log(`${" ".repeat(indent + 2)} - ${item.name} (${item.size} bytes)`);
+        }
+    }
+}
+//# sourceMappingURL=zip.js.map

package/build/utils/storage/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../../../src/utils/storage/zip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,kBAAkB,CAAA;AAE1C,MAAM,UAAU,cAAc,CAAC,SAAoB,EAAE,SAAiB,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,CAAA;IACxD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;IACjC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,YAAY,SAAS,EAAE,CAAC;YAC9B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,CAAA;QAClC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,SAAS,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import {Directory} from \"expo-file-system\"\n\nexport function printDirectory(directory: Directory, indent: number = 0) {\n  console.log(`${\" \".repeat(indent)} + ${directory.name}`)\n  const contents = directory.list()\n  for (const item of contents) {\n    if (item instanceof Directory) {\n      printDirectory(item, indent + 2)\n    } else {\n      console.log(`${\" \".repeat(indent + 2)} - ${item.name} (${item.size} bytes)`)\n    }\n  }\n}\n"]}

package/build/utils/timers/index.d.ts

@@ -0,0 +1,3 @@
+import { BgTimer, throttle, debounce } from "./timers";
+export { BgTimer, throttle, debounce };
+//# sourceMappingURL=index.d.ts.map

package/build/utils/timers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,UAAU,CAAA;AACpD,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,CAAA"}

package/build/utils/timers/index.js

@@ -0,0 +1,3 @@
+import { BgTimer, throttle, debounce } from "./timers";
+export { BgTimer, throttle, debounce };
+//# sourceMappingURL=index.js.map

package/build/utils/timers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/timers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,UAAU,CAAA;AACpD,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,CAAA","sourcesContent":["import {BgTimer, throttle, debounce} from \"./timers\"\nexport {BgTimer, throttle, debounce}\n"]}

package/build/utils/timers/timers.d.ts

@@ -0,0 +1,9 @@
+export declare class BgTimer {
+    static setInterval(callback: () => void, delay: number): number;
+    static clearInterval(intervalId: number): void;
+    static setTimeout(callback: () => void, delay: number): number;
+    static clearTimeout(timeoutId: number): void;
+}
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void;
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=timers.d.ts.map

package/build/utils/timers/timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"AAoFA,qBAAa,OAAO;IAClB,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/D,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO9D,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAM7C;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAU/G;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAY/G"}

package/build/utils/timers/timers.js

@@ -0,0 +1,105 @@
+// until https://github.com/tconns/react-native-nitro-bg-timer/issues/2 is resolved, we need to use this class to disable this package on iOS:
+import { Platform } from "react-native";
+let nitroTimer;
+let nitroDisabled = false;
+let warnedUnavailable = false;
+function warnUnavailable(reason) {
+    if (warnedUnavailable) {
+        return;
+    }
+    warnedUnavailable = true;
+    console.warn(`BgTimer: ${reason}, using JS timers`);
+}
+function getNitroTimer() {
+    if (nitroDisabled || Platform.OS !== "android") {
+        return null;
+    }
+    // react-native-nitro-bg-timer calls createHybridObject() at require() time. On dev
+    // builds with a stale native binary that throws NPE, React Native still surfaces a
+    // red LogBox error even when the exception is caught. Skip nitro in __DEV__ unless
+    // explicitly enabled after a native rebuild (bun android).
+    if (__DEV__ && process.env.EXPO_PUBLIC_USE_NITRO_BG_TIMER !== "true") {
+        warnUnavailable("nitro bg-timer disabled in dev (set EXPO_PUBLIC_USE_NITRO_BG_TIMER=true after native rebuild)");
+        return null;
+    }
+    if (nitroTimer !== undefined) {
+        return nitroTimer;
+    }
+    try {
+        const { isRuntimeAlive } = require("react-native-nitro-modules");
+        if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) {
+            nitroTimer = null;
+            warnUnavailable("nitro runtime is not alive");
+            return nitroTimer;
+        }
+        const { BackgroundTimer } = require("react-native-nitro-bg-timer");
+        nitroTimer =
+            BackgroundTimer &&
+                typeof BackgroundTimer.setTimeout === "function" &&
+                typeof BackgroundTimer.setInterval === "function" &&
+                typeof BackgroundTimer.clearTimeout === "function" &&
+                typeof BackgroundTimer.clearInterval === "function"
+                ? BackgroundTimer
+                : null;
+    }
+    catch {
+        nitroTimer = null;
+        nitroDisabled = true;
+    }
+    if (!nitroTimer) {
+        warnUnavailable("react-native-nitro-bg-timer unavailable");
+    }
+    return nitroTimer;
+}
+function withNitro(run, fallback) {
+    const api = getNitroTimer();
+    if (!api) {
+        return fallback();
+    }
+    try {
+        return run(api);
+    }
+    catch (error) {
+        nitroDisabled = true;
+        nitroTimer = null;
+        console.warn("BgTimer: nitro timer failed, using JS timers", error);
+        return fallback();
+    }
+}
+export class BgTimer {
+    static setInterval(callback, delay) {
+        return withNitro((api) => api.setInterval(callback, delay), () => setInterval(callback, delay));
+    }
+    static clearInterval(intervalId) {
+        withNitro((api) => api.clearInterval(intervalId), () => clearInterval(intervalId));
+    }
+    static setTimeout(callback, delay) {
+        return withNitro((api) => api.setTimeout(callback, delay), () => setTimeout(callback, delay));
+    }
+    static clearTimeout(timeoutId) {
+        withNitro((api) => api.clearTimeout(timeoutId), () => clearTimeout(timeoutId));
+    }
+}
+export function throttle(fn, ms) {
+    let lastCalled = 0;
+    return (...args) => {
+        const now = Date.now();
+        if (now - lastCalled >= ms) {
+            lastCalled = now;
+            fn(...args);
+        }
+    };
+}
+export function debounce(fn, ms) {
+    let timeoutId = null;
+    return (...args) => {
+        if (timeoutId) {
+            BgTimer.clearTimeout(timeoutId);
+        }
+        timeoutId = BgTimer.setTimeout(() => {
+            fn(...args);
+            timeoutId = null;
+        }, ms);
+    };
+}
+//# sourceMappingURL=timers.js.map

package/build/utils/timers/timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"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","sourcesContent":["// until https://github.com/tconns/react-native-nitro-bg-timer/issues/2 is resolved, we need to use this class to disable this package on iOS:\n\nimport {Platform} from \"react-native\"\n\ntype NitroTimerApi = {\n  setInterval: (callback: () => void, delay: number) => number\n  clearInterval: (intervalId: number) => void\n  setTimeout: (callback: () => void, delay: number) => number\n  clearTimeout: (timeoutId: number) => void\n}\n\nlet nitroTimer: NitroTimerApi | null | undefined\nlet nitroDisabled = false\nlet warnedUnavailable = false\n\nfunction warnUnavailable(reason: string) {\n  if (warnedUnavailable) {\n    return\n  }\n  warnedUnavailable = true\n  console.warn(`BgTimer: ${reason}, using JS timers`)\n}\n\nfunction getNitroTimer(): NitroTimerApi | null {\n  if (nitroDisabled || Platform.OS !== \"android\") {\n    return null\n  }\n\n  // react-native-nitro-bg-timer calls createHybridObject() at require() time. On dev\n  // builds with a stale native binary that throws NPE, React Native still surfaces a\n  // red LogBox error even when the exception is caught. Skip nitro in __DEV__ unless\n  // explicitly enabled after a native rebuild (bun android).\n  if (__DEV__ && process.env.EXPO_PUBLIC_USE_NITRO_BG_TIMER !== \"true\") {\n    warnUnavailable(\"nitro bg-timer disabled in dev (set EXPO_PUBLIC_USE_NITRO_BG_TIMER=true after native rebuild)\")\n    return null\n  }\n\n  if (nitroTimer !== undefined) {\n    return nitroTimer\n  }\n\n  try {\n    const {isRuntimeAlive} = require(\"react-native-nitro-modules\") as {isRuntimeAlive?: () => boolean}\n    if (typeof isRuntimeAlive === \"function\" && !isRuntimeAlive()) {\n      nitroTimer = null\n      warnUnavailable(\"nitro runtime is not alive\")\n      return nitroTimer\n    }\n\n    const {BackgroundTimer} = require(\"react-native-nitro-bg-timer\") as {BackgroundTimer?: NitroTimerApi}\n    nitroTimer =\n      BackgroundTimer &&\n      typeof BackgroundTimer.setTimeout === \"function\" &&\n      typeof BackgroundTimer.setInterval === \"function\" &&\n      typeof BackgroundTimer.clearTimeout === \"function\" &&\n      typeof BackgroundTimer.clearInterval === \"function\"\n        ? BackgroundTimer\n        : null\n  } catch {\n    nitroTimer = null\n    nitroDisabled = true\n  }\n\n  if (!nitroTimer) {\n    warnUnavailable(\"react-native-nitro-bg-timer unavailable\")\n  }\n  return nitroTimer\n}\n\nfunction withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {\n  const api = getNitroTimer()\n  if (!api) {\n    return fallback()\n  }\n  try {\n    return run(api)\n  } catch (error) {\n    nitroDisabled = true\n    nitroTimer = null\n    console.warn(\"BgTimer: nitro timer failed, using JS timers\", error)\n    return fallback()\n  }\n}\n\nexport class BgTimer {\n  static setInterval(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setInterval(callback, delay),\n      () => setInterval(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearInterval(intervalId: number): void {\n    withNitro(\n      (api) => api.clearInterval(intervalId),\n      () => clearInterval(intervalId),\n    )\n  }\n\n  static setTimeout(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setTimeout(callback, delay),\n      () => setTimeout(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearTimeout(timeoutId: number): void {\n    withNitro(\n      (api) => api.clearTimeout(timeoutId),\n      () => clearTimeout(timeoutId),\n    )\n  }\n}\n\nexport function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let lastCalled = 0\n\n  return (...args: Parameters<T>) => {\n    const now = Date.now()\n    if (now - lastCalled >= ms) {\n      lastCalled = now\n      fn(...args)\n    }\n  }\n}\n\nexport function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let timeoutId: number | null = null\n\n  return (...args: Parameters<T>) => {\n    if (timeoutId) {\n      BgTimer.clearTimeout(timeoutId)\n    }\n    timeoutId = BgTimer.setTimeout(() => {\n      fn(...args)\n      timeoutId = null\n    }, ms)\n  }\n}\n"]}