react-native-android-media-fetcher 1.0.0

package/android/src/oldarch/java/com/androidmediafetcher/AndroidMediaFetcherModule.kt

@@ -0,0 +1,170 @@
+package com.androidmediafetcher
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.Promise
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.androidmediafetcher.providers.AudioMediaProvider
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.cancel
+import org.json.JSONArray
+import org.json.JSONObject
+
+/**
+ * React Native Native Module for fetching audio files from Android MediaStore
+ * This version supports the old architecture (Bridge)
+ */
+class AndroidMediaFetcherModule(reactContext: ReactApplicationContext) :
+    ReactContextBaseJavaModule(reactContext) {
+
+    private val scope = CoroutineScope(SupervisorJob() + Dispatchers.Main)
+    private val audioProvider by lazy { AudioMediaProvider(reactContext) }
+
+    override fun getName(): String = NAME
+
+    /**
+     * Send event to JavaScript
+     */
+    private fun sendEvent(eventName: String, params: Any?) {
+        reactApplicationContext
+            .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+            .emit(eventName, params)
+    }
+
+    /**
+     * Get paginated audio files
+     */
+    @ReactMethod
+    fun getAudioFiles(pageSize: Int, offset: Int, promise: Promise) {
+        scope.launch {
+            try {
+                val totalCount = audioProvider.getTotalCount()
+                val files = audioProvider.getItems(pageSize, offset)
+                
+                val filesArray = JSONArray()
+                files.forEach { file ->
+                    filesArray.put(file.toJson())
+                }
+                
+                val result = JSONObject().apply {
+                    put("files", filesArray)
+                    put("totalCount", totalCount)
+                    put("hasMore", offset + files.size < totalCount)
+                    put("nextOffset", offset + files.size)
+                }
+                
+                promise.resolve(result.toString())
+            } catch (e: Exception) {
+                sendErrorEvent(e.message ?: "Unknown error", "FETCH_ERROR")
+                promise.reject("FETCH_ERROR", e.message, e)
+            }
+        }
+    }
+
+    /**
+     * Get all audio files with progress events
+     */
+    @ReactMethod
+    fun getAllAudioFiles(promise: Promise) {
+        scope.launch {
+            try {
+                val files = audioProvider.getAllItems { current, total ->
+                    val progress = JSONObject().apply {
+                        put("current", current)
+                        put("total", total)
+                        put("percentage", if (total > 0) (current * 100 / total) else 0)
+                    }
+                    sendEvent(EVENT_PROGRESS, progress.toString())
+                }
+                
+                val filesArray = JSONArray()
+                files.forEach { file ->
+                    filesArray.put(file.toJson())
+                }
+                
+                promise.resolve(filesArray.toString())
+            } catch (e: Exception) {
+                sendErrorEvent(e.message ?: "Unknown error", "FETCH_ALL_ERROR")
+                promise.reject("FETCH_ALL_ERROR", e.message, e)
+            }
+        }
+    }
+
+    /**
+     * Get single audio file by ID
+     */
+    @ReactMethod
+    fun getAudioFileById(id: String, promise: Promise) {
+        scope.launch {
+            try {
+                val file = audioProvider.getItemById(id)
+                if (file != null) {
+                    promise.resolve(file.toJson().toString())
+                } else {
+                    promise.resolve(null)
+                }
+            } catch (e: Exception) {
+                sendErrorEvent(e.message ?: "Unknown error", "FETCH_BY_ID_ERROR")
+                promise.reject("FETCH_BY_ID_ERROR", e.message, e)
+            }
+        }
+    }
+
+    /**
+     * Get total count of audio files
+     */
+    @ReactMethod
+    fun getTotalAudioCount(promise: Promise) {
+        scope.launch {
+            try {
+                val count = audioProvider.getTotalCount()
+                promise.resolve(count)
+            } catch (e: Exception) {
+                sendErrorEvent(e.message ?: "Unknown error", "COUNT_ERROR")
+                promise.reject("COUNT_ERROR", e.message, e)
+            }
+        }
+    }
+
+    /**
+     * Required for NativeEventEmitter
+     */
+    @ReactMethod
+    fun addListener(eventName: String) {
+        // Keep: Required for NativeEventEmitter
+    }
+
+    /**
+     * Required for NativeEventEmitter
+     */
+    @ReactMethod
+    fun removeListeners(count: Int) {
+        // Keep: Required for NativeEventEmitter
+    }
+
+    /**
+     * Send error event to JavaScript
+     */
+    private fun sendErrorEvent(message: String, code: String) {
+        val error = JSONObject().apply {
+            put("message", message)
+            put("code", code)
+        }
+        sendEvent(EVENT_ERROR, error.toString())
+    }
+
+    override fun invalidate() {
+        super.invalidate()
+        scope.cancel()
+    }
+
+    companion object {
+        const val NAME = "AndroidMediaFetcher"
+        private const val EVENT_PROGRESS = "MediaFetcher_Progress"
+        private const val EVENT_ERROR = "MediaFetcher_Error"
+    }
+}

package/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./plugin/build');

package/lib/commonjs/AudioFetcher.js

@@ -0,0 +1,153 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AudioFetcher = void 0;
+var _reactNative = require("react-native");
+var _NativeModule = require("./NativeModule");
+/**
+ * Default page size for pagination
+ */
+const DEFAULT_PAGE_SIZE = 50;
+
+/**
+ * Maximum page size allowed
+ */
+const MAX_PAGE_SIZE = 500;
+
+/**
+ * Parse JSON response from native module safely
+ */
+function parseNativeResponse(json) {
+  try {
+    return JSON.parse(json);
+  } catch {
+    throw new Error('Failed to parse response from native module');
+  }
+}
+
+/**
+ * Validate that we're running on Android
+ */
+function validatePlatform() {
+  if (_reactNative.Platform.OS !== 'android') {
+    throw new Error('react-native-android-media-fetcher only supports Android. ' + `Current platform: ${_reactNative.Platform.OS}`);
+  }
+}
+
+/**
+ * AudioFetcher provides methods to fetch audio files from the device
+ * with full metadata including album art, artist, duration, etc.
+ * 
+ * @example
+ * ```typescript
+ * import { AudioFetcher } from 'react-native-android-media-fetcher';
+ * 
+ * // Fetch first page of audio files
+ * const result = await AudioFetcher.getAudioFiles({ pageSize: 20 });
+ * console.log(result.files);
+ * 
+ * // Fetch all audio files (with progress events)
+ * const allFiles = await AudioFetcher.getAllAudioFiles();
+ * ```
+ */
+const AudioFetcher = exports.AudioFetcher = {
+  /**
+   * Fetch audio files with pagination
+   * 
+   * @param options - Pagination options
+   * @returns Promise resolving to FetchResult with files and pagination info
+   * 
+   * @example
+   * ```typescript
+   * // Fetch first page
+   * const result = await AudioFetcher.getAudioFiles({ pageSize: 20, offset: 0 });
+   * 
+   * // Fetch next page
+   * if (result.hasMore) {
+   *   const nextPage = await AudioFetcher.getAudioFiles({
+   *     pageSize: 20,
+   *     offset: result.nextOffset,
+   *   });
+   * }
+   * ```
+   */
+  async getAudioFiles(options) {
+    validatePlatform();
+    const pageSize = Math.min(Math.max(1, options?.pageSize ?? DEFAULT_PAGE_SIZE), MAX_PAGE_SIZE);
+    const offset = Math.max(0, options?.offset ?? 0);
+    const json = await _NativeModule.AndroidMediaFetcherModule.getAudioFiles(pageSize, offset);
+    return parseNativeResponse(json);
+  },
+  /**
+   * Fetch all audio files from the device
+   * 
+   * For large libraries, use addProgressListener to track progress:
+   * 
+   * @returns Promise resolving to array of all AudioFile objects
+   * 
+   * @example
+   * ```typescript
+   * import { AudioFetcher, addProgressListener } from 'react-native-android-media-fetcher';
+   * 
+   * const unsubscribe = addProgressListener((progress) => {
+   *   console.log(`Loading: ${progress.percentage}%`);
+   * });
+   * 
+   * const allFiles = await AudioFetcher.getAllAudioFiles();
+   * unsubscribe();
+   * 
+   * console.log(`Found ${allFiles.length} audio files`);
+   * ```
+   */
+  async getAllAudioFiles() {
+    validatePlatform();
+    const json = await _NativeModule.AndroidMediaFetcherModule.getAllAudioFiles();
+    return parseNativeResponse(json);
+  },
+  /**
+   * Fetch a single audio file by its ID
+   * 
+   * @param id - The unique ID of the audio file (from AudioFile.id)
+   * @returns Promise resolving to AudioFile or null if not found
+   * 
+   * @example
+   * ```typescript
+   * const file = await AudioFetcher.getAudioFileById('12345');
+   * if (file) {
+   *   console.log(`Found: ${file.title} by ${file.artist}`);
+   * }
+   * ```
+   */
+  async getAudioFileById(id) {
+    validatePlatform();
+    if (!id || typeof id !== 'string') {
+      throw new Error('Invalid audio file ID');
+    }
+    const json = await _NativeModule.AndroidMediaFetcherModule.getAudioFileById(id);
+    if (!json) {
+      return null;
+    }
+    return parseNativeResponse(json);
+  },
+  /**
+   * Get the total count of audio files on the device
+   * 
+   * This is a lightweight operation that only counts files without
+   * fetching their metadata.
+   * 
+   * @returns Promise resolving to total number of audio files
+   * 
+   * @example
+   * ```typescript
+   * const count = await AudioFetcher.getTotalAudioCount();
+   * console.log(`Device has ${count} audio files`);
+   * ```
+   */
+  async getTotalAudioCount() {
+    validatePlatform();
+    return _NativeModule.AndroidMediaFetcherModule.getTotalAudioCount();
+  }
+};
+//# sourceMappingURL=AudioFetcher.js.map

package/lib/commonjs/AudioFetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_NativeModule","DEFAULT_PAGE_SIZE","MAX_PAGE_SIZE","parseNativeResponse","json","JSON","parse","Error","validatePlatform","Platform","OS","AudioFetcher","exports","getAudioFiles","options","pageSize","Math","min","max","offset","AndroidMediaFetcherModule","getAllAudioFiles","getAudioFileById","id","getTotalAudioCount"],"sourceRoot":"..\\..\\src","sources":["AudioFetcher.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AAGA;AACA;AACA;AACA,MAAME,iBAAiB,GAAG,EAAE;;AAE5B;AACA;AACA;AACA,MAAMC,aAAa,GAAG,GAAG;;AAEzB;AACA;AACA;AACA,SAASC,mBAAmBA,CAAIC,IAAY,EAAK;EAC7C,IAAI;IACA,OAAOC,IAAI,CAACC,KAAK,CAACF,IAAI,CAAC;EAC3B,CAAC,CAAC,MAAM;IACJ,MAAM,IAAIG,KAAK,CAAC,6CAA6C,CAAC;EAClE;AACJ;;AAEA;AACA;AACA;AACA,SAASC,gBAAgBA,CAAA,EAAS;EAC9B,IAAIC,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAAE;IAC3B,MAAM,IAAIH,KAAK,CACX,4DAA4D,GAC5D,qBAAqBE,qBAAQ,CAACC,EAAE,EACpC,CAAC;EACL;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAG;EACxB;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,MAAME,aAAaA,CAACC,OAAsB,EAAwB;IAC9DN,gBAAgB,CAAC,CAAC;IAElB,MAAMO,QAAQ,GAAGC,IAAI,CAACC,GAAG,CACrBD,IAAI,CAACE,GAAG,CAAC,CAAC,EAAEJ,OAAO,EAAEC,QAAQ,IAAId,iBAAiB,CAAC,EACnDC,aACJ,CAAC;IACD,MAAMiB,MAAM,GAAGH,IAAI,CAACE,GAAG,CAAC,CAAC,EAAEJ,OAAO,EAAEK,MAAM,IAAI,CAAC,CAAC;IAEhD,MAAMf,IAAI,GAAG,MAAMgB,uCAAyB,CAACP,aAAa,CAACE,QAAQ,EAAEI,MAAM,CAAC;IAC5E,OAAOhB,mBAAmB,CAAcC,IAAI,CAAC;EACjD,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,MAAMiB,gBAAgBA,CAAA,EAAyB;IAC3Cb,gBAAgB,CAAC,CAAC;IAElB,MAAMJ,IAAI,GAAG,MAAMgB,uCAAyB,CAACC,gBAAgB,CAAC,CAAC;IAC/D,OAAOlB,mBAAmB,CAAcC,IAAI,CAAC;EACjD,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,MAAMkB,gBAAgBA,CAACC,EAAU,EAA6B;IAC1Df,gBAAgB,CAAC,CAAC;IAElB,IAAI,CAACe,EAAE,IAAI,OAAOA,EAAE,KAAK,QAAQ,EAAE;MAC/B,MAAM,IAAIhB,KAAK,CAAC,uBAAuB,CAAC;IAC5C;IAEA,MAAMH,IAAI,GAAG,MAAMgB,uCAAyB,CAACE,gBAAgB,CAACC,EAAE,CAAC;IACjE,IAAI,CAACnB,IAAI,EAAE;MACP,OAAO,IAAI;IACf;IACA,OAAOD,mBAAmB,CAAYC,IAAI,CAAC;EAC/C,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,MAAMoB,kBAAkBA,CAAA,EAAoB;IACxChB,gBAAgB,CAAC,CAAC;IAElB,OAAOY,uCAAyB,CAACI,kBAAkB,CAAC,CAAC;EACzD;AACJ,CAAC","ignoreList":[]}

package/lib/commonjs/NativeModule.js

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MediaFetcherEventEmitter = exports.AndroidMediaFetcherModule = void 0;
+var _reactNative = require("react-native");
+const LINKING_ERROR = `The package 'react-native-android-media-fetcher' doesn't seem to be linked. Make sure: \n\n` + _reactNative.Platform.select({
+  ios: "- You have run 'pod install'\n",
+  default: ''
+}) + '- You rebuilt the app after installing the package\n' + '- You are not using Expo Go (use development builds instead)';
+
+/**
+ * Native module interface - internal use only
+ */
+
+/**
+ * Get the native module with proper error handling
+ */
+function getNativeModule() {
+  const module = _reactNative.NativeModules.AndroidMediaFetcher;
+  if (!module) {
+    throw new Error(LINKING_ERROR);
+  }
+  return module;
+}
+
+/**
+ * The native Android Media Fetcher module
+ */
+const AndroidMediaFetcherModule = exports.AndroidMediaFetcherModule = getNativeModule();
+
+/**
+ * Event emitter for native events
+ */
+const MediaFetcherEventEmitter = exports.MediaFetcherEventEmitter = new _reactNative.NativeEventEmitter(_reactNative.NativeModules.AndroidMediaFetcher);
+//# sourceMappingURL=NativeModule.js.map

package/lib/commonjs/NativeModule.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","LINKING_ERROR","Platform","select","ios","default","getNativeModule","module","NativeModules","AndroidMediaFetcher","Error","AndroidMediaFetcherModule","exports","MediaFetcherEventEmitter","NativeEventEmitter"],"sourceRoot":"..\\..\\src","sources":["NativeModule.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAEA,MAAMC,aAAa,GACf,6FAA6F,GAC7FC,qBAAQ,CAACC,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,8DAA8D;;AAElE;AACA;AACA;;AAUA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAA6B;EACjD,MAAMC,MAAM,GAAGC,0BAAa,CAACC,mBAAmB;EAEhD,IAAI,CAACF,MAAM,EAAE;IACT,MAAM,IAAIG,KAAK,CAACT,aAAa,CAAC;EAClC;EAEA,OAAOM,MAAM;AACjB;;AAEA;AACA;AACA;AACO,MAAMI,yBAAyB,GAAAC,OAAA,CAAAD,yBAAA,GAAGL,eAAe,CAAC,CAAC;;AAE1D;AACA;AACA;AACO,MAAMO,wBAAwB,GAAAD,OAAA,CAAAC,wBAAA,GAAG,IAAIC,+BAAkB,CAC1DN,0BAAa,CAACC,mBAClB,CAAC","ignoreList":[]}

package/lib/commonjs/events.js

@@ -0,0 +1,73 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.addErrorListener = addErrorListener;
+exports.addProgressListener = addProgressListener;
+exports.removeAllListeners = removeAllListeners;
+var _NativeModule = require("./NativeModule");
+/**
+ * Event names used by the native module
+ */
+const EVENTS = {
+  PROGRESS: 'MediaFetcher_Progress',
+  ERROR: 'MediaFetcher_Error'
+};
+
+/**
+ * Add a listener for progress updates during getAllAudioFiles operation
+ * 
+ * @param listener - Callback function that receives progress updates
+ * @returns Unsubscribe function to remove the listener
+ * 
+ * @example
+ * ```typescript
+ * const unsubscribe = addProgressListener((progress) => {
+ *   console.log(`Loading: ${progress.percentage}%`);
+ * });
+ * 
+ * // Later, when done:
+ * unsubscribe();
+ * ```
+ */
+function addProgressListener(listener) {
+  const subscription = _NativeModule.MediaFetcherEventEmitter.addListener(EVENTS.PROGRESS, event => {
+    listener(event);
+  });
+  return () => {
+    subscription.remove();
+  };
+}
+
+/**
+ * Add a listener for error events during fetch operations
+ * 
+ * @param listener - Callback function that receives error information
+ * @returns Unsubscribe function to remove the listener
+ * 
+ * @example
+ * ```typescript
+ * const unsubscribe = addErrorListener((error) => {
+ *   console.error(`Error: ${error.message} (${error.code})`);
+ * });
+ * ```
+ */
+function addErrorListener(listener) {
+  const subscription = _NativeModule.MediaFetcherEventEmitter.addListener(EVENTS.ERROR, event => {
+    listener(event);
+  });
+  return () => {
+    subscription.remove();
+  };
+}
+
+/**
+ * Remove all listeners for media fetcher events
+ * Useful for cleanup in useEffect
+ */
+function removeAllListeners() {
+  _NativeModule.MediaFetcherEventEmitter.removeAllListeners(EVENTS.PROGRESS);
+  _NativeModule.MediaFetcherEventEmitter.removeAllListeners(EVENTS.ERROR);
+}
+//# sourceMappingURL=events.js.map

package/lib/commonjs/events.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_NativeModule","require","EVENTS","PROGRESS","ERROR","addProgressListener","listener","subscription","MediaFetcherEventEmitter","addListener","event","remove","addErrorListener","removeAllListeners"],"sourceRoot":"..\\..\\src","sources":["events.ts"],"mappings":";;;;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAQA;AACA;AACA;AACA,MAAMC,MAAM,GAAG;EACXC,QAAQ,EAAE,uBAAuB;EACjCC,KAAK,EAAE;AACX,CAAU;;AAEV;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,mBAAmBA,CAACC,QAA0B,EAAe;EACzE,MAAMC,YAAY,GAAGC,sCAAwB,CAACC,WAAW,CACrDP,MAAM,CAACC,QAAQ,EACdO,KAAoB,IAAK;IACtBJ,QAAQ,CAACI,KAAK,CAAC;EACnB,CACJ,CAAC;EAED,OAAO,MAAM;IACTH,YAAY,CAACI,MAAM,CAAC,CAAC;EACzB,CAAC;AACL;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAACN,QAAuB,EAAe;EACnE,MAAMC,YAAY,GAAGC,sCAAwB,CAACC,WAAW,CACrDP,MAAM,CAACE,KAAK,EACXM,KAAwC,IAAK;IAC1CJ,QAAQ,CAACI,KAAK,CAAC;EACnB,CACJ,CAAC;EAED,OAAO,MAAM;IACTH,YAAY,CAACI,MAAM,CAAC,CAAC;EACzB,CAAC;AACL;;AAEA;AACA;AACA;AACA;AACO,SAASE,kBAAkBA,CAAA,EAAS;EACvCL,sCAAwB,CAACK,kBAAkB,CAACX,MAAM,CAACC,QAAQ,CAAC;EAC5DK,sCAAwB,CAACK,kBAAkB,CAACX,MAAM,CAACE,KAAK,CAAC;AAC7D","ignoreList":[]}

package/lib/commonjs/index.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "AudioFetcher", {
+  enumerable: true,
+  get: function () {
+    return _AudioFetcher.AudioFetcher;
+  }
+});
+Object.defineProperty(exports, "addErrorListener", {
+  enumerable: true,
+  get: function () {
+    return _events.addErrorListener;
+  }
+});
+Object.defineProperty(exports, "addProgressListener", {
+  enumerable: true,
+  get: function () {
+    return _events.addProgressListener;
+  }
+});
+Object.defineProperty(exports, "removeAllListeners", {
+  enumerable: true,
+  get: function () {
+    return _events.removeAllListeners;
+  }
+});
+var _AudioFetcher = require("./AudioFetcher");
+var _events = require("./events");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_AudioFetcher","require","_events"],"sourceRoot":"..\\..\\src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,IAAAA,aAAA,GAAAC,OAAA;AAGA,IAAAC,OAAA,GAAAD,OAAA","ignoreList":[]}

package/lib/commonjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/commonjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"..\\..\\src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/AudioFetcher.js

@@ -0,0 +1,147 @@
+import { Platform } from 'react-native';
+import { AndroidMediaFetcherModule } from './NativeModule';
+/**
+ * Default page size for pagination
+ */
+const DEFAULT_PAGE_SIZE = 50;
+
+/**
+ * Maximum page size allowed
+ */
+const MAX_PAGE_SIZE = 500;
+
+/**
+ * Parse JSON response from native module safely
+ */
+function parseNativeResponse(json) {
+  try {
+    return JSON.parse(json);
+  } catch {
+    throw new Error('Failed to parse response from native module');
+  }
+}
+
+/**
+ * Validate that we're running on Android
+ */
+function validatePlatform() {
+  if (Platform.OS !== 'android') {
+    throw new Error('react-native-android-media-fetcher only supports Android. ' + `Current platform: ${Platform.OS}`);
+  }
+}
+
+/**
+ * AudioFetcher provides methods to fetch audio files from the device
+ * with full metadata including album art, artist, duration, etc.
+ * 
+ * @example
+ * ```typescript
+ * import { AudioFetcher } from 'react-native-android-media-fetcher';
+ * 
+ * // Fetch first page of audio files
+ * const result = await AudioFetcher.getAudioFiles({ pageSize: 20 });
+ * console.log(result.files);
+ * 
+ * // Fetch all audio files (with progress events)
+ * const allFiles = await AudioFetcher.getAllAudioFiles();
+ * ```
+ */
+export const AudioFetcher = {
+  /**
+   * Fetch audio files with pagination
+   * 
+   * @param options - Pagination options
+   * @returns Promise resolving to FetchResult with files and pagination info
+   * 
+   * @example
+   * ```typescript
+   * // Fetch first page
+   * const result = await AudioFetcher.getAudioFiles({ pageSize: 20, offset: 0 });
+   * 
+   * // Fetch next page
+   * if (result.hasMore) {
+   *   const nextPage = await AudioFetcher.getAudioFiles({
+   *     pageSize: 20,
+   *     offset: result.nextOffset,
+   *   });
+   * }
+   * ```
+   */
+  async getAudioFiles(options) {
+    validatePlatform();
+    const pageSize = Math.min(Math.max(1, options?.pageSize ?? DEFAULT_PAGE_SIZE), MAX_PAGE_SIZE);
+    const offset = Math.max(0, options?.offset ?? 0);
+    const json = await AndroidMediaFetcherModule.getAudioFiles(pageSize, offset);
+    return parseNativeResponse(json);
+  },
+  /**
+   * Fetch all audio files from the device
+   * 
+   * For large libraries, use addProgressListener to track progress:
+   * 
+   * @returns Promise resolving to array of all AudioFile objects
+   * 
+   * @example
+   * ```typescript
+   * import { AudioFetcher, addProgressListener } from 'react-native-android-media-fetcher';
+   * 
+   * const unsubscribe = addProgressListener((progress) => {
+   *   console.log(`Loading: ${progress.percentage}%`);
+   * });
+   * 
+   * const allFiles = await AudioFetcher.getAllAudioFiles();
+   * unsubscribe();
+   * 
+   * console.log(`Found ${allFiles.length} audio files`);
+   * ```
+   */
+  async getAllAudioFiles() {
+    validatePlatform();
+    const json = await AndroidMediaFetcherModule.getAllAudioFiles();
+    return parseNativeResponse(json);
+  },
+  /**
+   * Fetch a single audio file by its ID
+   * 
+   * @param id - The unique ID of the audio file (from AudioFile.id)
+   * @returns Promise resolving to AudioFile or null if not found
+   * 
+   * @example
+   * ```typescript
+   * const file = await AudioFetcher.getAudioFileById('12345');
+   * if (file) {
+   *   console.log(`Found: ${file.title} by ${file.artist}`);
+   * }
+   * ```
+   */
+  async getAudioFileById(id) {
+    validatePlatform();
+    if (!id || typeof id !== 'string') {
+      throw new Error('Invalid audio file ID');
+    }
+    const json = await AndroidMediaFetcherModule.getAudioFileById(id);
+    if (!json) {
+      return null;
+    }
+    return parseNativeResponse(json);
+  },
+  /**
+   * Get the total count of audio files on the device
+   * 
+   * This is a lightweight operation that only counts files without
+   * fetching their metadata.
+   * 
+   * @returns Promise resolving to total number of audio files
+   * 
+   * @example
+   * ```typescript
+   * const count = await AudioFetcher.getTotalAudioCount();
+   * console.log(`Device has ${count} audio files`);
+   * ```
+   */
+  async getTotalAudioCount() {
+    validatePlatform();
+    return AndroidMediaFetcherModule.getTotalAudioCount();
+  }
+};
+//# sourceMappingURL=AudioFetcher.js.map

package/lib/module/AudioFetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","AndroidMediaFetcherModule","DEFAULT_PAGE_SIZE","MAX_PAGE_SIZE","parseNativeResponse","json","JSON","parse","Error","validatePlatform","OS","AudioFetcher","getAudioFiles","options","pageSize","Math","min","max","offset","getAllAudioFiles","getAudioFileById","id","getTotalAudioCount"],"sourceRoot":"..\\..\\src","sources":["AudioFetcher.ts"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,SAASC,yBAAyB,QAAQ,gBAAgB;AAG1D;AACA;AACA;AACA,MAAMC,iBAAiB,GAAG,EAAE;;AAE5B;AACA;AACA;AACA,MAAMC,aAAa,GAAG,GAAG;;AAEzB;AACA;AACA;AACA,SAASC,mBAAmBA,CAAIC,IAAY,EAAK;EAC7C,IAAI;IACA,OAAOC,IAAI,CAACC,KAAK,CAACF,IAAI,CAAC;EAC3B,CAAC,CAAC,MAAM;IACJ,MAAM,IAAIG,KAAK,CAAC,6CAA6C,CAAC;EAClE;AACJ;;AAEA;AACA;AACA;AACA,SAASC,gBAAgBA,CAAA,EAAS;EAC9B,IAAIT,QAAQ,CAACU,EAAE,KAAK,SAAS,EAAE;IAC3B,MAAM,IAAIF,KAAK,CACX,4DAA4D,GAC5D,qBAAqBR,QAAQ,CAACU,EAAE,EACpC,CAAC;EACL;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,YAAY,GAAG;EACxB;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,MAAMC,aAAaA,CAACC,OAAsB,EAAwB;IAC9DJ,gBAAgB,CAAC,CAAC;IAElB,MAAMK,QAAQ,GAAGC,IAAI,CAACC,GAAG,CACrBD,IAAI,CAACE,GAAG,CAAC,CAAC,EAAEJ,OAAO,EAAEC,QAAQ,IAAIZ,iBAAiB,CAAC,EACnDC,aACJ,CAAC;IACD,MAAMe,MAAM,GAAGH,IAAI,CAACE,GAAG,CAAC,CAAC,EAAEJ,OAAO,EAAEK,MAAM,IAAI,CAAC,CAAC;IAEhD,MAAMb,IAAI,GAAG,MAAMJ,yBAAyB,CAACW,aAAa,CAACE,QAAQ,EAAEI,MAAM,CAAC;IAC5E,OAAOd,mBAAmB,CAAcC,IAAI,CAAC;EACjD,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,MAAMc,gBAAgBA,CAAA,EAAyB;IAC3CV,gBAAgB,CAAC,CAAC;IAElB,MAAMJ,IAAI,GAAG,MAAMJ,yBAAyB,CAACkB,gBAAgB,CAAC,CAAC;IAC/D,OAAOf,mBAAmB,CAAcC,IAAI,CAAC;EACjD,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,MAAMe,gBAAgBA,CAACC,EAAU,EAA6B;IAC1DZ,gBAAgB,CAAC,CAAC;IAElB,IAAI,CAACY,EAAE,IAAI,OAAOA,EAAE,KAAK,QAAQ,EAAE;MAC/B,MAAM,IAAIb,KAAK,CAAC,uBAAuB,CAAC;IAC5C;IAEA,MAAMH,IAAI,GAAG,MAAMJ,yBAAyB,CAACmB,gBAAgB,CAACC,EAAE,CAAC;IACjE,IAAI,CAAChB,IAAI,EAAE;MACP,OAAO,IAAI;IACf;IACA,OAAOD,mBAAmB,CAAYC,IAAI,CAAC;EAC/C,CAAC;EAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,MAAMiB,kBAAkBA,CAAA,EAAoB;IACxCb,gBAAgB,CAAC,CAAC;IAElB,OAAOR,yBAAyB,CAACqB,kBAAkB,CAAC,CAAC;EACzD;AACJ,CAAC","ignoreList":[]}

package/lib/module/NativeModule.js

@@ -0,0 +1,31 @@
+import { NativeModules, Platform, NativeEventEmitter } from 'react-native';
+const LINKING_ERROR = `The package 'react-native-android-media-fetcher' doesn't seem to be linked. Make sure: \n\n` + Platform.select({
+  ios: "- You have run 'pod install'\n",
+  default: ''
+}) + '- You rebuilt the app after installing the package\n' + '- You are not using Expo Go (use development builds instead)';
+
+/**
+ * Native module interface - internal use only
+ */
+
+/**
+ * Get the native module with proper error handling
+ */
+function getNativeModule() {
+  const module = NativeModules.AndroidMediaFetcher;
+  if (!module) {
+    throw new Error(LINKING_ERROR);
+  }
+  return module;
+}
+
+/**
+ * The native Android Media Fetcher module
+ */
+export const AndroidMediaFetcherModule = getNativeModule();
+
+/**
+ * Event emitter for native events
+ */
+export const MediaFetcherEventEmitter = new NativeEventEmitter(NativeModules.AndroidMediaFetcher);
+//# sourceMappingURL=NativeModule.js.map

package/lib/module/NativeModule.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","Platform","NativeEventEmitter","LINKING_ERROR","select","ios","default","getNativeModule","module","AndroidMediaFetcher","Error","AndroidMediaFetcherModule","MediaFetcherEventEmitter"],"sourceRoot":"..\\..\\src","sources":["NativeModule.ts"],"mappings":"AAAA,SAASA,aAAa,EAAEC,QAAQ,EAAEC,kBAAkB,QAAQ,cAAc;AAE1E,MAAMC,aAAa,GACf,6FAA6F,GAC7FF,QAAQ,CAACG,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,8DAA8D;;AAElE;AACA;AACA;;AAUA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAA6B;EACjD,MAAMC,MAAM,GAAGR,aAAa,CAACS,mBAAmB;EAEhD,IAAI,CAACD,MAAM,EAAE;IACT,MAAM,IAAIE,KAAK,CAACP,aAAa,CAAC;EAClC;EAEA,OAAOK,MAAM;AACjB;;AAEA;AACA;AACA;AACA,OAAO,MAAMG,yBAAyB,GAAGJ,eAAe,CAAC,CAAC;;AAE1D;AACA;AACA;AACA,OAAO,MAAMK,wBAAwB,GAAG,IAAIV,kBAAkB,CAC1DF,aAAa,CAACS,mBAClB,CAAC","ignoreList":[]}