@kesha-antonov/react-native-background-downloader 4.3.4 → 4.3.7

package/README.md

@@ -355,6 +355,43 @@ task.start()
 ```
 Headers given in `createDownloadTask()` are **merged** with the ones given in `setConfig({ headers: { ... } })`.
 
+### Enabling Debug Logs
+
+The library includes verbose debug logging that can help diagnose download issues. Logging is disabled by default but can be enabled at runtime using `setConfig()`. **Logging works in both debug and production/release builds.**
+
+```javascript
+import { setConfig } from '@kesha-antonov/react-native-background-downloader'
+
+// Option 1: Enable native console logging (logs appear in Xcode/Android Studio console)
+setConfig({
+  isLogsEnabled: true
+})
+
+// Option 2: Enable logging with a JavaScript callback to capture logs in your app
+setConfig({
+  isLogsEnabled: true,
+  logCallback: (log) => {
+    // log.message - The debug message
+    // log.taskId - Optional task ID associated with the log (iOS only)
+    console.log('[BackgroundDownloader]', log.message)
+
+    // You can also send logs to your analytics/crash reporting service
+    // crashlytics.log(log.message)
+  }
+})
+
+// Disable logging
+setConfig({
+  isLogsEnabled: false
+})
+```
+
+**Notes:**
+- When `isLogsEnabled` is `true`, native debug logs (NSLog on iOS, Log.d/w/e on Android) are printed
+- The `logCallback` function is called for each native debug log (iOS only sends logs to callback currently)
+- Logs include detailed information about download lifecycle, session management, and errors
+- In production builds, logs are only printed when explicitly enabled via `isLogsEnabled`
+
 ### Handling Slow-Responding URLs
 
 This library automatically includes connection timeout improvements for slow-responding URLs. By default, the following headers are added to all download requests on Android:
@@ -469,7 +506,27 @@ An object containing configuration properties
 | `headers`     | Record<string, string \| null> | Optional headers to use in all future downloads. Headers with null values will be removed |
 | `progressInterval` | Number | Interval in milliseconds for download progress updates. Must be >= 250. Default is 1000 |
 | `progressMinBytes` | Number | Minimum number of bytes that must be downloaded before a progress event is emitted. When set to 0, only the percentage threshold (1% change) triggers progress updates. Default is 1048576 (1MB) |
-| `isLogsEnabled`   | Boolean | Enables/disables debug logs in library. Default is false |
+| `isLogsEnabled`   | Boolean | Enables/disables verbose debug logs in native code (iOS and Android). Works in both debug and release builds. Default is false |
+| `logCallback`   | (log: { message: string, taskId?: string }) => void | Optional callback function to receive native debug logs in JavaScript. Only called when `isLogsEnabled` is true |
+
+**Example:**
+
+```javascript
+import { setConfig } from '@kesha-antonov/react-native-background-downloader'
+
+// Enable verbose logging with callback
+setConfig({
+  isLogsEnabled: true,
+  logCallback: (log) => {
+    console.log('[BackgroundDownloader]', log.message, log.taskId ? `(${log.taskId})` : '')
+  }
+})
+
+// Or just enable native console logging without JS callback
+setConfig({
+  isLogsEnabled: true
+})
+```
 
 ### DownloadTask
 

package/android/src/main/java/com/eko/DownloadConstants.kt

@@ -40,7 +40,7 @@ object DownloadConstants {
     const val KEEP_ALIVE_HEADER_VALUE = "timeout=600, max=1000"
 
     /** Library version for User-Agent */
-    const val VERSION = "4.3.4"
+    const val VERSION = "4.3.5"
 
     /** User-Agent string for HTTP requests */
     const val USER_AGENT = "ReactNative-BackgroundDownloader/$VERSION"

package/android/src/main/java/com/eko/DownloadEventEmitter.kt

@@ -1,6 +1,5 @@
 package com.eko
 
-import android.util.Log
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.modules.core.DeviceEventManagerModule
@@ -30,7 +29,7 @@ class DownloadEventEmitter(
         try {
             getEmitter().emit(eventName, params)
         } catch (e: Exception) {
-            Log.w(TAG, "Failed to emit $eventName event: ${e.message}")
+            RNBackgroundDownloaderModuleImpl.logW(TAG, "Failed to emit $eventName event: ${e.message}")
         }
     }
 

package/android/src/main/java/com/eko/Downloader.kt

@@ -48,7 +48,7 @@ class Downloader(private val context: Context) {
       val binder = service as ResumableDownloadService.LocalBinder
       downloadService = binder.getService()
       serviceBound = true
-      Log.d(TAG, "ResumableDownloadService connected")
+      RNBackgroundDownloaderModuleImpl.logD(TAG, "ResumableDownloadService connected")
 
       // Execute any pending operations
       var operation = pendingServiceOperations.poll()
@@ -61,7 +61,7 @@ class Downloader(private val context: Context) {
     override fun onServiceDisconnected(name: ComponentName?) {
       downloadService = null
       serviceBound = false
-      Log.d(TAG, "ResumableDownloadService disconnected")
+      RNBackgroundDownloaderModuleImpl.logD(TAG, "ResumableDownloadService disconnected")
     }
   }
 
@@ -132,7 +132,7 @@ class Downloader(private val context: Context) {
     // Remove any stale paused state from a previous download with the same ID
     val pausedInfo = pausedDownloads.remove(configId)
     if (pausedInfo != null) {
-      Log.d(TAG, "Cleaned up stale paused state for: $configId")
+      RNBackgroundDownloaderModuleImpl.logD(TAG, "Cleaned up stale paused state for: $configId")
       TempFileUtils.deleteTempFile(pausedInfo.destination)
     }
   }
@@ -195,7 +195,7 @@ class Downloader(private val context: Context) {
       bytesTotal = bytesTotal
     )
 
-    Log.d(TAG, "Paused download $configId at $bytesDownloaded/$bytesTotal bytes")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Paused download $configId at $bytesDownloaded/$bytesTotal bytes")
     return true
   }
 
@@ -205,7 +205,7 @@ class Downloader(private val context: Context) {
   fun resume(configId: String, listener: ResumableDownloader.DownloadListener): Boolean {
     val pausedInfo = pausedDownloads[configId]
     if (pausedInfo == null) {
-      Log.w(TAG, "No paused download found for configId: $configId")
+      RNBackgroundDownloaderModuleImpl.logW(TAG, "No paused download found for configId: $configId")
       return false
     }
 
@@ -220,7 +220,7 @@ class Downloader(private val context: Context) {
       listener
     )
 
-    Log.d(TAG, "Resuming download $configId from ${pausedInfo.bytesDownloaded} bytes via service")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Resuming download $configId from ${pausedInfo.bytesDownloaded} bytes via service")
     return true
   }
 
@@ -247,7 +247,7 @@ class Downloader(private val context: Context) {
       try {
         context.startForegroundService(startIntent)
       } catch (e: Exception) {
-        Log.w(TAG, "Could not start foreground service: ${e.message}")
+        RNBackgroundDownloaderModuleImpl.logW(TAG, "Could not start foreground service: ${e.message}")
       }
     } else {
       context.startService(startIntent)
@@ -281,7 +281,7 @@ class Downloader(private val context: Context) {
       -1L, // Total bytes unknown
       listener
     )
-    Log.d(TAG, "Started ResumableDownloader for $configId (DownloadManager fallback)")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Started ResumableDownloader for $configId (DownloadManager fallback)")
   }
 
   /**
@@ -368,7 +368,7 @@ class Downloader(private val context: Context) {
         }
       }
     } catch (e: Exception) {
-      Log.e(TAG, "Downloader: ${Log.getStackTraceString(e)}")
+      RNBackgroundDownloaderModuleImpl.logE(TAG, "Downloader: ${Log.getStackTraceString(e)}")
     }
 
     return result

package/android/src/main/java/com/eko/RNBackgroundDownloaderModuleImpl.kt

@@ -45,6 +45,23 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
     )
 
     private val sharedLock = Any()
+
+    // Controls whether debug logs are enabled
+    @Volatile
+    private var isLogsEnabled = false
+
+    // Helper functions for conditional logging
+    fun logD(tag: String, message: String) {
+      if (isLogsEnabled) Log.d(tag, message)
+    }
+
+    fun logW(tag: String, message: String) {
+      if (isLogsEnabled) Log.w(tag, message)
+    }
+
+    fun logE(tag: String, message: String) {
+      if (isLogsEnabled) Log.e(tag, message)
+    }
   }
 
   // Storage manager for persistent state
@@ -91,7 +108,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
           ee = reactContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
         }
       } catch (e: Exception) {
-        Log.w(NAME, "Event emitter not ready yet: ${e.message}")
+        logW(NAME, "Event emitter not ready yet: ${e.message}")
         return null
       }
     }
@@ -107,9 +124,9 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
     if (!::ee.isInitialized) {
       try {
         ee = reactContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
-        Log.d(NAME, "Event emitter initialized eagerly before download")
+        logD(NAME, "Event emitter initialized eagerly before download")
       } catch (e: Exception) {
-        Log.w(NAME, "Could not initialize event emitter: ${e.message}")
+        logW(NAME, "Could not initialize event emitter: ${e.message}")
       }
     }
   }
@@ -123,7 +140,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
     synchronized(sharedLock) {
       if (!isReceiverRegistered) {
         registerDownloadReceiver()
-        Log.d(NAME, "Download receiver registered eagerly before download")
+        logD(NAME, "Download receiver registered eagerly before download")
       }
     }
   }
@@ -183,6 +200,10 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
     return constants
   }
 
+  fun setLogsEnabled(enabled: Boolean) {
+    isLogsEnabled = enabled
+  }
+
   fun initialize() {
     ee = reactContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
     isInitialized = true
@@ -217,7 +238,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
         val cancelIntent = downloader.getCancelIntent(downloadId)
         if (cancelIntent != null) {
           downloader.clearCancelIntent(downloadId)
-          Log.d(NAME, "Ignoring broadcast for ${cancelIntent.name.lowercase()} download: $downloadId")
+          logD(NAME, "Ignoring broadcast for ${cancelIntent.name.lowercase()} download: $downloadId")
           return
         }
 
@@ -284,7 +305,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
       try {
         reactContext.unregisterReceiver(it)
       } catch (e: Exception) {
-        Log.w(NAME, "Could not unregister receiver: ${e.message}")
+        logW(NAME, "Could not unregister receiver: ${e.message}")
       }
       downloadReceiver = null
       isReceiverRegistered = false
@@ -319,7 +340,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
         val onProgressFuture = cachedExecutorPool.submit(onProgressCallable)
         configIdToProgressFuture[config.id] = onProgressFuture
       } catch (e: Exception) {
-        Log.e(NAME, "resumeTasks: ${Log.getStackTraceString(e)}")
+        logE(NAME, "resumeTasks: ${Log.getStackTraceString(e)}")
       }
     }.start()
   }
@@ -402,7 +423,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
           // This is a redirect
           val location = connection.getHeaderField("Location")
           if (location == null) {
-            Log.w(NAME, "Redirect response without Location header at: $currentUrl")
+            logW(NAME, "Redirect response without Location header at: $currentUrl")
             break
           }
 
@@ -419,7 +440,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
             else -> location
           }
 
-          Log.d(NAME, "Redirect ${redirectCount + 1}/$maxRedirects: $currentUrl -> $location")
+          logD(NAME, "Redirect ${redirectCount + 1}/$maxRedirects: $currentUrl -> $location")
           redirectCount++
         } else {
           // Not a redirect, we've found the final URL
@@ -430,18 +451,18 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
       }
 
       if (redirectCount >= maxRedirects) {
-        Log.w(
+        logW(
           NAME,
           "Reached maximum redirects ($maxRedirects) for URL: $originalUrl. Final URL: $currentUrl"
         )
       } else {
-        Log.d(NAME, "Resolved URL after $redirectCount redirects: $currentUrl")
+        logD(NAME, "Resolved URL after $redirectCount redirects: $currentUrl")
       }
 
       return currentUrl
 
     } catch (e: Exception) {
-      Log.e(NAME, "Failed to resolve redirects for URL: $originalUrl. Error: ${e.message}")
+      logE(NAME, "Failed to resolve redirects for URL: $originalUrl. Error: ${e.message}")
       // Return original URL if redirect resolution fails
       return originalUrl
     }
@@ -474,7 +495,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
               JSONObject(it.toString()).toString()
             } ?: "{}"
           } catch (e: Exception) {
-            Log.w(NAME, "Failed to convert metadata map to string: ${e.message}")
+            logW(NAME, "Failed to convert metadata map to string: ${e.message}")
             "{}"
           }
         }
@@ -503,15 +524,15 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
     }
 
     if (id == null || url == null || destination == null) {
-      Log.e(NAME, "download: id, url and destination must be set.")
+      logE(NAME, "download: id, url and destination must be set.")
       return
     }
 
     // Resolve redirects if maxRedirects is specified
     if (maxRedirects > 0) {
-      Log.d(NAME, "Resolving redirects for URL: $url (maxRedirects: $maxRedirects)")
+      logD(NAME, "Resolving redirects for URL: $url (maxRedirects: $maxRedirects)")
       url = resolveRedirects(url, maxRedirects, headers)
-      Log.d(NAME, "Final resolved URL: $url")
+      logD(NAME, "Final resolved URL: $url")
     }
 
     val request = DownloadManager.Request(Uri.parse(url))
@@ -596,18 +617,18 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
     } else {
       // External files directory path is invalid or null
       // Try setDestinationInExternalFilesDir as fallback, then ResumableDownloader if that fails
-      Log.w(NAME, "External files directory path may be invalid for DownloadManager: ${externalFilesDir?.absolutePath}")
+      logW(NAME, "External files directory path may be invalid for DownloadManager: ${externalFilesDir?.absolutePath}")
 
       try {
         // Try standard setDestinationInExternalFilesDir - may work on some devices
         request.setDestinationInExternalFilesDir(reactContext, null, filename)
         startDownloadManagerDownload(downloader.download(request))
-        Log.d(NAME, "Using setDestinationInExternalFilesDir for download: $id")
+        logD(NAME, "Using setDestinationInExternalFilesDir for download: $id")
       } catch (e: Exception) {
         // DownloadManager failed - fall back to ResumableDownloader
         // This handles OnePlus and other devices that return paths like /data/local/tmp/external/
-        Log.w(NAME, "DownloadManager failed with: ${e.message}")
-        Log.d(NAME, "Using ResumableDownloader as fallback for download: $id")
+        logW(NAME, "DownloadManager failed with: ${e.message}")
+        logD(NAME, "Using ResumableDownloader as fallback for download: $id")
         startWithResumableDownloader()
       }
     }
@@ -620,7 +641,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
       // First check if it's an active resumable download
       if (downloader.isResumableDownload(configId)) {
         downloader.pauseResumable(configId)
-        Log.d(NAME, "Paused resumable download: $configId")
+        logD(NAME, "Paused resumable download: $configId")
         return
       }
 
@@ -642,11 +663,15 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
             downloadIdToConfig.remove(downloadId)
             configIdToDownloadId.remove(configId)
             saveDownloadIdToConfigMap()
-            Log.d(NAME, "Paused DownloadManager download: $configId")
+            logD(NAME, "Paused DownloadManager download: $configId")
+          } else {
+            logD(NAME, "pauseTask: Download not paused (may already be paused): $configId")
           }
+        } else {
+          logW(NAME, "pauseTask: No config found for downloadId: $downloadId")
         }
       } else {
-        Log.w(NAME, "pauseTask: No download found for configId: $configId")
+        logW(NAME, "pauseTask: No download found for configId: $configId")
       }
     }
   }
@@ -657,7 +682,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
       // First check if it's a paused resumable download
       if (downloader.resumableDownloader.isPaused(configId)) {
         downloader.resumeResumable(configId, resumableDownloadListener)
-        Log.d(NAME, "Resumed paused resumable download: $configId")
+        logD(NAME, "Resumed paused resumable download: $configId")
         return
       }
 
@@ -665,14 +690,14 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
       if (downloader.isPaused(configId)) {
         val resumed = downloader.resume(configId, resumableDownloadListener)
         if (resumed) {
-          Log.d(NAME, "Resumed download via ResumableDownloader: $configId")
+          logD(NAME, "Resumed download via ResumableDownloader: $configId")
         } else {
-          Log.w(NAME, "Failed to resume download: $configId")
+          logW(NAME, "Failed to resume download: $configId")
         }
         return
       }
 
-      Log.w(NAME, "resumeTask: No paused download found for configId: $configId")
+      logW(NAME, "resumeTask: No paused download found for configId: $configId")
     }
   }
 
@@ -699,11 +724,11 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
     // Firebase Performance compatibility: Add defensive programming to prevent crashes
     // when Firebase Performance SDK is installed and uses bytecode instrumentation
 
-    Log.d(NAME, "completeHandler called with configId: $configId")
+    logD(NAME, "completeHandler called with configId: $configId")
 
     // Defensive programming: Validate parameters
     if (configId.isEmpty()) {
-      Log.w(NAME, "completeHandler: Invalid configId provided")
+      logW(NAME, "completeHandler: Invalid configId provided")
       return
     }
 
@@ -711,12 +736,12 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
       // Currently this method doesn't have any implementation on Android
       // as completion handlers are handled differently than iOS.
       // This defensive structure ensures Firebase Performance compatibility.
-      Log.d(NAME, "completeHandler executed successfully for configId: $configId")
+      logD(NAME, "completeHandler executed successfully for configId: $configId")
 
     } catch (e: Exception) {
       // Catch any potential exceptions that might be thrown due to Firebase Performance
       // bytecode instrumentation interfering with method dispatch
-      Log.e(NAME, "completeHandler: Exception occurred: ${Log.getStackTraceString(e)}")
+      logE(NAME, "completeHandler: Exception occurred: ${Log.getStackTraceString(e)}")
     }
   }
 
@@ -745,7 +770,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
                         val future = setFileChangesBeforeCompletion(localUri, config.destination)
                         future.get()
                       } catch (e: Exception) {
-                        Log.e(NAME, "Error moving completed download file: ${e.message}")
+                        logE(NAME, "Error moving completed download file: ${e.message}")
                         // Continue with normal processing even if file move fails
                       }
                     }
@@ -775,7 +800,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
           }
         }
       } catch (e: Exception) {
-        Log.e(NAME, "getExistingDownloadTasks: ${Log.getStackTraceString(e)}")
+        logE(NAME, "getExistingDownloadTasks: ${Log.getStackTraceString(e)}")
       }
     }
 
@@ -826,7 +851,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
   }
 
   private fun onFailedDownload(config: RNBGDTaskConfig, downloadStatus: WritableMap) {
-    Log.e(
+    logE(
       NAME, "onFailedDownload: " +
           "${downloadStatus.getInt("status")}:" +
           "${downloadStatus.getInt("reason")}:" +
@@ -838,7 +863,7 @@ class RNBackgroundDownloaderModuleImpl(private val reactContext: ReactApplicatio
 
     // Enhanced handling for ERROR_CANNOT_RESUME (1008)
     if (reason == DownloadManager.ERROR_CANNOT_RESUME) {
-      Log.w(
+      logW(
         NAME, "ERROR_CANNOT_RESUME detected for download: ${config.id}" +
             ". This is a known Android DownloadManager issue with larger files. " +
             "Consider restarting the download or using smaller file segments."

package/android/src/main/java/com/eko/ResumableDownloadService.kt

@@ -10,7 +10,6 @@ import android.os.Binder
 import android.os.Build
 import android.os.IBinder
 import android.os.PowerManager
-import android.util.Log
 import androidx.core.app.NotificationCompat
 import java.util.concurrent.ConcurrentHashMap
 import java.util.concurrent.ExecutorService
@@ -92,7 +91,7 @@ class ResumableDownloadService : Service() {
       private fun logStale(event: String) {
         val currentJob = activeDownloads[id]
         val currentGeneration = downloadGeneration[id] ?: 0
-        Log.d(TAG, "Ignoring stale $event for $id (session: my=$sessionToken vs job=${currentJob?.sessionToken}, gen: my=$generation vs current=$currentGeneration)")
+        RNBackgroundDownloaderModuleImpl.logD(TAG, "Ignoring stale $event for $id (session: my=$sessionToken vs job=${currentJob?.sessionToken}, gen: my=$generation vs current=$currentGeneration)")
       }
 
       override fun onBegin(id: String, expectedBytes: Long, headers: Map<String, String>) {
@@ -112,7 +111,7 @@ class ResumableDownloadService : Service() {
         val now = System.currentTimeMillis()
         val lastLogTime = lastProgressLogTime[id] ?: 0L
         if (now - lastLogTime >= DownloadConstants.PROGRESS_LOG_INTERVAL_MS) {
-          Log.d(TAG, "onProgress: id=$id, bytes=$bytesDownloaded, myToken=$sessionToken, jobToken=${currentJob?.sessionToken}, myGen=$generation, currentGen=$currentGeneration")
+          RNBackgroundDownloaderModuleImpl.logD(TAG, "onProgress: id=$id, bytes=$bytesDownloaded, myToken=$sessionToken, jobToken=${currentJob?.sessionToken}, myGen=$generation, currentGen=$currentGeneration")
           lastProgressLogTime[id] = now
         }
 
@@ -163,7 +162,7 @@ class ResumableDownloadService : Service() {
 
   override fun onCreate() {
     super.onCreate()
-    Log.d(TAG, "Service created")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Service created")
     createNotificationChannel()
   }
 
@@ -172,7 +171,7 @@ class ResumableDownloadService : Service() {
   }
 
   override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
-    Log.d(TAG, "onStartCommand: action=${intent?.action}")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "onStartCommand: action=${intent?.action}")
 
     when (intent?.action) {
       ACTION_START_DOWNLOAD -> {
@@ -215,7 +214,7 @@ class ResumableDownloadService : Service() {
   }
 
   override fun onDestroy() {
-    Log.d(TAG, "Service destroyed")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Service destroyed")
     releaseWakeLock()
     executorService.shutdownNow()
     super.onDestroy()
@@ -244,7 +243,7 @@ class ResumableDownloadService : Service() {
     startByte: Long,
     totalBytes: Long
   ) {
-    Log.d(TAG, "Starting download: $id from byte $startByte")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Starting download: $id from byte $startByte")
 
     // Start foreground service if not already
     startForegroundWithNotification()
@@ -254,7 +253,7 @@ class ResumableDownloadService : Service() {
     // This ensures we can detect stale events even if job was removed and re-added
     val generation = (downloadGeneration[id] ?: 0) + 1
     downloadGeneration[id] = generation
-    Log.d(TAG, "Download $id starting with generation $generation")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Download $id starting with generation $generation")
 
     val job = DownloadJob(id, url, destination, headers, startByte, totalBytes)
     activeDownloads[id] = job
@@ -275,7 +274,7 @@ class ResumableDownloadService : Service() {
   }
 
   fun pauseDownload(id: String): Boolean {
-    Log.d(TAG, "Pausing download: $id")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Pausing download: $id")
     val result = resumableDownloader.pause(id)
     if (result) {
       updateNotification()
@@ -285,13 +284,13 @@ class ResumableDownloadService : Service() {
   }
 
   fun resumeDownload(id: String): Boolean {
-    Log.d(TAG, "Resuming download: $id")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Resuming download: $id")
 
     if (this.listener == null) return false
     val currentJob = activeDownloads[id] ?: return false
     val sessionToken = currentJob.sessionToken
     val generation = downloadGeneration[id] ?: 0
-    Log.d(TAG, "Resuming $id with session=$sessionToken, generation=$generation")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Resuming $id with session=$sessionToken, generation=$generation")
 
     // Create a validating listener wrapper (don't cleanup since job already exists)
     val serviceListener = createValidatingListener(id, sessionToken, generation, cleanupOnTerminal = false)
@@ -304,7 +303,7 @@ class ResumableDownloadService : Service() {
   }
 
   fun cancelDownload(id: String): Boolean {
-    Log.d(TAG, "Cancelling download: $id")
+    RNBackgroundDownloaderModuleImpl.logD(TAG, "Cancelling download: $id")
     activeDownloads.remove(id)
     val result = resumableDownloader.cancel(id)
     stopServiceIfIdle()
@@ -324,7 +323,7 @@ class ResumableDownloadService : Service() {
         startForeground(DownloadConstants.NOTIFICATION_ID, notification)
       }
     } catch (e: Exception) {
-      Log.e(TAG, "Failed to start foreground service: ${e.message}")
+      RNBackgroundDownloaderModuleImpl.logE(TAG, "Failed to start foreground service: ${e.message}")
     }
   }
 
@@ -379,7 +378,7 @@ class ResumableDownloadService : Service() {
         setReferenceCounted(false)
         acquire(DownloadConstants.WAKELOCK_TIMEOUT_MS)
       }
-      Log.d(TAG, "WakeLock acquired")
+      RNBackgroundDownloaderModuleImpl.logD(TAG, "WakeLock acquired")
     }
   }
 
@@ -387,7 +386,7 @@ class ResumableDownloadService : Service() {
     wakeLock?.let {
       if (it.isHeld) {
         it.release()
-        Log.d(TAG, "WakeLock released")
+        RNBackgroundDownloaderModuleImpl.logD(TAG, "WakeLock released")
       }
     }
     wakeLock = null
@@ -399,12 +398,12 @@ class ResumableDownloadService : Service() {
     val hasPausedInResumable = activeDownloads.keys.any { resumableDownloader.getState(it) != null }
 
     if (!hasActiveDownloads && !hasPausedInResumable) {
-      Log.d(TAG, "No active downloads, stopping service")
+      RNBackgroundDownloaderModuleImpl.logD(TAG, "No active downloads, stopping service")
       releaseWakeLock()
       stopForeground(STOP_FOREGROUND_REMOVE)
       stopSelf()
     } else {
-      Log.d(TAG, "Service has active downloads, keeping alive")
+      RNBackgroundDownloaderModuleImpl.logD(TAG, "Service has active downloads, keeping alive")
       updateNotification()
     }
   }