@rejaul/react-native-printer-kit 0.3.4 → 0.4.1

package/android/src/main/java/com/rejaul/reactnativeprinterkit/ReactNativePrinterKitModule.kt

@@ -15,18 +15,29 @@ import com.facebook.react.bridge.WritableArray
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.modules.core.PermissionAwareActivity
 import com.rezaul.printerkit.BluetoothPermissions
-import com.rezaul.printerkit.BluetoothPrinter
-import com.rezaul.printerkit.BluetoothPrinterDevice
-import com.rezaul.printerkit.BluetoothPrinterService
-import com.rezaul.printerkit.ConnectPrinterParams
-import com.rezaul.printerkit.HtmlToPdfParams
-import com.rezaul.printerkit.PdfToImageParams
-import com.rezaul.printerkit.PrintHtmlParams
-import com.rezaul.printerkit.PrintImageBase64Params
-import com.rezaul.printerkit.PrintImageFileParams
-import com.rezaul.printerkit.PrintPdfParams
-import com.rezaul.printerkit.PrinterImageType
-import com.rezaul.printerkit.PrintTextParams
+import com.rezaul.printerkit.PosPrinter
+import com.rezaul.printerkit.PrinterService
+import com.rezaul.printerkit.model.BluetoothPrinterDevice
+import com.rezaul.printerkit.model.ConnectPrinterParams
+import com.rezaul.printerkit.model.FileLocation
+import com.rezaul.printerkit.model.HtmlToPdfParams
+import com.rezaul.printerkit.model.PdfToImageParams
+import com.rezaul.printerkit.model.PrintHtmlParams
+import com.rezaul.printerkit.model.PrintImageBase64Params
+import com.rezaul.printerkit.model.PrintImageFileParams
+import com.rezaul.printerkit.model.PrintPdfParams
+import com.rezaul.printerkit.model.PrintTextParams
+import com.rezaul.printerkit.model.PrinterConnectionType
+import com.rezaul.printerkit.model.PrinterFilter
+import com.rezaul.printerkit.model.PrinterImageType
+import com.rezaul.printerkit.model.HtmlToImageParams
+import com.rezaul.printerkit.model.ReadDirParams
+import com.rezaul.printerkit.model.ReadFileFormat
+import com.rezaul.printerkit.model.ReadFileParams
+import com.rezaul.printerkit.model.ReadFileResult
+import com.rezaul.printerkit.model.RemoveFileParams
+import com.rezaul.printerkit.model.SaveFileParams
+import com.rezaul.printerkit.model.UsbPrinterDevice
 import java.util.concurrent.Executors
 
 /** Reads an optional numeric field, falling back to [default] if absent/null. */
@@ -41,21 +52,33 @@ private fun ReadableMap.optIntOrNull(key: String): Int? =
 private fun ReadableMap.optLong(key: String, default: Long): Long =
   if (hasKey(key) && !isNull(key)) getDouble(key).toLong() else default
 
+/** Reads an optional string field, or null if absent/null. */
+private fun ReadableMap.optString(key: String): String? =
+  if (hasKey(key) && !isNull(key)) getString(key) else null
+
+/** Reads an optional boolean field, falling back to [default] if absent/null. */
+private fun ReadableMap.optBoolean(key: String, default: Boolean): Boolean =
+  if (hasKey(key) && !isNull(key)) getBoolean(key) else default
+
+/** Parses an enum by name, falling back to [default] for a missing or unknown value. */
+private inline fun <reified T : Enum<T>> enumOrDefault(name: String?, default: T): T =
+  name?.let { runCatching { enumValueOf<T>(it) }.getOrNull() } ?: default
+
 /**
- * Bridges [com.rezaul.printerkit.BluetoothPrinter] to React Native.
+ * Bridges [com.rezaul.printerkit.PosPrinter] to React Native.
  *
- * Connect/print calls run through a bound [BluetoothPrinterService] (started once,
- * on module init) instead of a bare [BluetoothPrinter], so the connection survives
- * the app being swiped away from Recents - see [BluetoothPrinterService]. Calls made
+ * Connect/print calls run through a bound [PrinterService] (started once,
+ * on module init) instead of a bare [PosPrinter], so the connection survives
+ * the app being swiped away from Recents - see [PrinterService]. Calls made
  * before the service finishes binding (essentially instant, but not synchronous) are
  * queued and run once it connects.
  *
- * All blocking Bluetooth/PDF/image I/O runs on a single background executor, off the
+ * All blocking Bluetooth/USB/network/PDF/image I/O runs on a single background executor, off the
  * calling (JS) thread - also serializing printer writes, since concurrent writes to
  * the same socket from two overlapping calls would corrupt the output.
  *
  * Every JS-facing method that takes data receives a single [ReadableMap] (the object
- * param the TS Spec declares), matching [com.rezaul.printerkit.BluetoothPrinter]'s own
+ * param the TS Spec declares), matching [com.rezaul.printerkit.PosPrinter]'s own
  * single-params-object functions on the native side.
  */
 class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
@@ -63,17 +86,17 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
 
   private val executor = Executors.newSingleThreadExecutor()
 
-  // getBondedBluetoothPrinters() is synchronous (no connection involved) and must
-  // answer immediately, so it uses its own plain BluetoothPrinter rather than
-  // waiting on the service to bind.
-  private val standalonePrinter by lazy { BluetoothPrinter(reactApplicationContext) }
+  // getBondedBluetoothPrinters(), getUsbPrinters() and the USB permission calls need no
+  // connection and must answer immediately, so they use their own plain PosPrinter
+  // rather than waiting on the service to bind.
+  private val standalonePrinter by lazy { PosPrinter(reactApplicationContext) }
 
-  private var printerService: BluetoothPrinterService? = null
-  private val pendingActions = mutableListOf<(BluetoothPrinterService) -> Unit>()
+  private var printerService: PrinterService? = null
+  private val pendingActions = mutableListOf<(PrinterService) -> Unit>()
 
   private val serviceConnection = object : ServiceConnection {
     override fun onServiceConnected(name: ComponentName?, binder: IBinder?) {
-      val service = (binder as BluetoothPrinterService.LocalBinder).getService()
+      val service = (binder as PrinterService.LocalBinder).getService()
       printerService = service
       val queued = synchronized(pendingActions) {
         val copy = pendingActions.toList()
@@ -89,13 +112,13 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
   }
 
   init {
-    val intent = Intent(reactApplicationContext, BluetoothPrinterService::class.java)
+    val intent = Intent(reactApplicationContext, PrinterService::class.java)
     reactApplicationContext.startService(intent)
     reactApplicationContext.bindService(intent, serviceConnection, Context.BIND_AUTO_CREATE)
   }
 
   /** Runs [action] with the bound service, once available (queued if not yet bound). */
-  private fun withService(action: (BluetoothPrinterService) -> Unit) {
+  private fun withService(action: (PrinterService) -> Unit) {
     val service = printerService
     if (service != null) {
       action(service)
@@ -108,6 +131,17 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     val map = Arguments.createMap()
     map.putString("name", device.name)
     map.putString("address", device.address)
+    map.putString("confidence", device.confidence.name)
+    map.putString("reason", device.reason)
+    return map
+  }
+
+  private fun usbToMap(device: UsbPrinterDevice): WritableMap {
+    val map = Arguments.createMap()
+    map.putString("name", device.name)
+    map.putInt("vendorId", device.vendorId)
+    map.putInt("productId", device.productId)
+    map.putString("deviceName", device.deviceName)
     return map
   }
 
@@ -155,24 +189,74 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun getBondedBluetoothPrinters(): WritableArray {
+  override fun getBondedBluetoothPrinters(params: ReadableMap): WritableArray {
+    val filter = enumOrDefault(params.optString("filter"), PrinterFilter.ALL)
+    val keywords = params.getArray("extraNameKeywords")?.let { array ->
+      (0 until array.size()).mapNotNull { array.getString(it) }
+    } ?: emptyList()
     val result: WritableArray = Arguments.createArray()
-    standalonePrinter.getBondedBluetoothPrinters().forEach { device ->
+    standalonePrinter.getBondedBluetoothPrinters(filter, keywords).forEach { device ->
       result.pushMap(deviceToMap(device))
     }
     return result
   }
 
+  override fun getUsbPrinters(): WritableArray {
+    val result: WritableArray = Arguments.createArray()
+    standalonePrinter.getUsbPrinters().forEach { device ->
+      result.pushMap(usbToMap(device))
+    }
+    return result
+  }
+
+  override fun hasUsbPermission(params: ReadableMap): Boolean {
+    if (!params.hasKey("vendorId") || !params.hasKey("productId")) return false
+    return standalonePrinter.hasUsbPermission(
+      params.getDouble("vendorId").toInt(),
+      params.getDouble("productId").toInt()
+    )
+  }
+
+  override fun requestUsbPermission(params: ReadableMap, promise: Promise) {
+    if (!params.hasKey("vendorId") || !params.hasKey("productId")) {
+      promise.reject("ERROR", "vendorId and productId are required")
+      return
+    }
+    try {
+      // The result arrives on the main thread once the user answers the system dialog.
+      standalonePrinter.requestUsbPermission(
+        params.getDouble("vendorId").toInt(),
+        params.getDouble("productId").toInt()
+      ) { granted -> promise.resolve(granted) }
+    } catch (e: Exception) {
+      promise.reject("ERROR", e.message)
+    }
+  }
+
   override fun connectPrinter(params: ReadableMap, promise: Promise) {
-    val address = params.getString("address")
+    val type = enumOrDefault(params.optString("type"), PrinterConnectionType.BLUETOOTH)
+    // USB printers are identified by vendorId/productId, so address may be empty for them.
+    val address = params.optString("address") ?: if (type == PrinterConnectionType.USB) "" else null
     if (address == null) {
       promise.reject("ERROR", "address is required")
       return
     }
+    val defaults = ConnectPrinterParams(address)
+    val connectParams = ConnectPrinterParams(
+      address = address,
+      notificationTitle = params.optString("notificationTitle") ?: defaults.notificationTitle,
+      type = type,
+      port = params.optInt("port", defaults.port),
+      timeoutMs = params.optInt("timeoutMs", defaults.timeoutMs),
+      vendorId = params.optIntOrNull("vendorId"),
+      productId = params.optIntOrNull("productId"),
+      disconnectedNotificationTitle =
+        params.optString("disconnectedNotificationTitle") ?: defaults.disconnectedNotificationTitle
+    )
     withService { service ->
       executor.execute {
         try {
-          promise.resolve(service.connectAndKeepAlive(ConnectPrinterParams(address)))
+          promise.resolve(service.connectAndKeepAlive(connectParams))
         } catch (e: Exception) {
           promise.reject("ERROR", e.message)
         }
@@ -218,6 +302,157 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     }
   }
 
+  override fun isPrinterReady(promise: Promise) {
+    withService { service ->
+      executor.execute {
+        try {
+          promise.resolve(service.printer.isPrinterReady())
+        } catch (e: Exception) {
+          promise.reject("ERROR", e.message)
+        }
+      }
+    }
+  }
+
+  override fun getPrinterStatus(params: ReadableMap, promise: Promise) {
+    withService { service ->
+      executor.execute {
+        try {
+          val status = service.printer.getPrinterStatus(params.optInt("timeoutMs", 800))
+          // Unknown (null) fields must reach JS as null, which makeNativeMap preserves.
+          promise.resolve(Arguments.makeNativeMap(status.toMap()))
+        } catch (e: Exception) {
+          promise.reject("ERROR", e.message)
+        }
+      }
+    }
+  }
+
+  override fun printTestPage(promise: Promise) {
+    withService { service ->
+      executor.execute {
+        try {
+          service.printer.printTestPage()
+          promise.resolve(null)
+        } catch (e: Exception) {
+          promise.reject("ERROR", e.message)
+        }
+      }
+    }
+  }
+
+  override fun saveFile(params: ReadableMap, promise: Promise) {
+    // Exactly one of sourcePath / text / base64 is validated by the native library, which
+    // answers with result.success = false and a message, so nothing to reject here.
+    executor.execute {
+      try {
+        val result = standalonePrinter.saveFile(
+          SaveFileParams(
+            sourcePath = params.optString("sourcePath"),
+            text = params.optString("text"),
+            base64 = params.optString("base64"),
+            fileName = params.optString("fileName"),
+            location = enumOrDefault(params.optString("location"), FileLocation.DOWNLOADS),
+            customFolder = params.optString("customFolder"),
+            subFolder = params.optString("subFolder"),
+            mimeType = params.optString("mimeType"),
+            overwrite = params.optBoolean("overwrite", false),
+            deleteSource = params.optBoolean("deleteSource", false)
+          )
+        )
+        promise.resolve(Arguments.makeNativeMap(result.toMap()))
+      } catch (e: Exception) {
+        promise.reject("ERROR", e.message)
+      }
+    }
+  }
+
+  override fun readFile(params: ReadableMap, promise: Promise) {
+    val path = params.getString("path")
+    if (path == null) {
+      promise.reject("ERROR", "path is required")
+      return
+    }
+    val formatName = params.optString("format")
+    val format = if (formatName == null) ReadFileFormat.BASE64 else ReadFileFormat.fromWireName(formatName)
+    if (format == null) {
+      // Same "never rejects" contract as the other file functions: a bad format is a failed result.
+      val failed = ReadFileResult(false, error = "Unknown format: $formatName (use base64, dataUri, text, hex or bytes)")
+      promise.resolve(Arguments.makeNativeMap(failed.toMap()))
+      return
+    }
+    executor.execute {
+      try {
+        val result = standalonePrinter.readFile(
+          ReadFileParams(
+            path = path,
+            format = format,
+            encoding = params.optString("encoding"),
+            maxBytes = params.optLong("maxBytes", ReadFileParams.DEFAULT_MAX_BYTES)
+          )
+        )
+        promise.resolve(Arguments.makeNativeMap(result.toMap()))
+      } catch (e: Exception) {
+        promise.reject("ERROR", e.message)
+      }
+    }
+  }
+
+  override fun htmlToImage(params: ReadableMap, promise: Promise) {
+    val html = params.getString("html")
+    if (html == null) {
+      promise.reject("ERROR", "html is required")
+      return
+    }
+    // htmlToImage hops to the main thread for the WebView and does the rendering on its own
+    // background thread, so it can be called straight from here.
+    standalonePrinter.htmlToImage(
+      HtmlToImageParams(
+        html = html,
+        outputPath = params.optString("outputPath"),
+        imageType = if (params.getString("imageType") == "JPEG") PrinterImageType.JPEG else PrinterImageType.PNG,
+        targetWidthPx = params.optIntOrNull("targetWidthPx"),
+        pageWidthDp = params.optInt("pageWidthDp", 412),
+        heightDp = params.optIntOrNull("heightDp"),
+        minPageHeightDp = params.optInt("minPageHeightDp", 1000)
+      )
+    ) { path ->
+      promise.resolve(path)
+    }
+  }
+
+  override fun readDir(params: ReadableMap, promise: Promise) {
+    val path = params.getString("path")
+    if (path == null) {
+      promise.reject("ERROR", "path is required")
+      return
+    }
+    executor.execute {
+      try {
+        val result = standalonePrinter.readDir(ReadDirParams(path))
+        promise.resolve(Arguments.makeNativeMap(result.toMap()))
+      } catch (e: Exception) {
+        promise.reject("ERROR", e.message)
+      }
+    }
+  }
+
+  override fun removeFile(params: ReadableMap, promise: Promise) {
+    val path = params.getString("path")
+    if (path == null) {
+      promise.reject("ERROR", "path is required")
+      return
+    }
+    executor.execute {
+      try {
+        val result = standalonePrinter.removeFile(RemoveFileParams(path))
+        promise.resolve(Arguments.makeNativeMap(result.toMap()))
+      } catch (e: Exception) {
+        promise.reject("ERROR", e.message)
+      }
+    }
+  }
+
   override fun printText(params: ReadableMap, promise: Promise) {
     val text = params.getString("text")
     if (text == null) {
@@ -355,6 +590,7 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
       service.printer.htmlToPdf(
         HtmlToPdfParams(
           html = html,
+          outputPath = params.optString("outputPath"),
           pageWidthDp = params.optInt("pageWidthDp", 412),
           heightDp = params.optIntOrNull("heightDp"),
           minPageHeightDp = params.optInt("minPageHeightDp", 1000)

package/lib/module/NativeReactNativePrinterKit.js

@@ -1,6 +1,25 @@
 "use strict";
 
 import { TurboModuleRegistry, Platform } from 'react-native';
+
+/** How sure the library is that a paired Bluetooth device is a printer. */
+
+/** `ALL` lists every paired device, `LIKELY_PRINTERS` hides non-printers, `STRICT` keeps only certain ones. */
+
+/**
+ * `null` means "unknown" - the printer did not answer or does not report that condition. It is NOT "ok".
+ */
+
+/**
+ * `PICTURES` is the public Pictures folder, so the image also shows in the Gallery app; it accepts images
+ * only (a `.png`/`.jpg` file name or an `image/...` `mimeType`) and refuses anything else.
+ */
+
+/**
+ * The shape `readFile` returns the content in: `base64` (plain), `dataUri` (`data:<type>;base64,...`), `text`
+ * (decoded string), `hex` (two lower-case digits per byte) or `bytes` (array of numbers 0..255, max 1 MB).
+ */
+
 function getModule() {
   return Platform.OS === 'android' ? TurboModuleRegistry.getEnforcing('ReactNativePrinterKit') : {};
 }

package/lib/module/NativeReactNativePrinterKit.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","Platform","getModule","OS","getEnforcing"],"sourceRoot":"../../src","sources":["NativeReactNativePrinterKit.ts"],"mappings":";;AAAA,SAASA,mBAAmB,EAAoBC,QAAQ,QAAQ,cAAc;AA2L9E,SAASC,SAASA,CAAA,EAAS;EACzB,OAAOD,QAAQ,CAACE,EAAE,KAAK,SAAS,GAC5BH,mBAAmB,CAACI,YAAY,CAAO,uBAAuB,CAAC,GAC9D,CAAC,CAAU;AAClB;AAEA,eAAeF,SAAS,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","Platform","getModule","OS","getEnforcing"],"sourceRoot":"../../src","sources":["NativeReactNativePrinterKit.ts"],"mappings":";;AAAA,SAASA,mBAAmB,EAAoBC,QAAQ,QAAQ,cAAc;;AAE9E;;AAGA;;AA2DA;AACA;AACA;;AAYA;AACA;AACA;AACA;;AA+HA;AACA;AACA;AACA;;AA2PA,SAASC,SAASA,CAAA,EAAS;EACzB,OAAOD,QAAQ,CAACE,EAAE,KAAK,SAAS,GAC5BH,mBAAmB,CAACI,YAAY,CAAO,uBAAuB,CAAC,GAC9D,CAAC,CAAU;AAClB;AAEA,eAAeF,SAAS,CAAC,CAAC","ignoreList":[]}

package/lib/module/enums.js

@@ -0,0 +1,45 @@
+"use strict";
+
+// Runtime values for the string unions the native module uses, so callers can write
+// `PrinterFilter.LIKELY_PRINTERS` instead of a bare string. Each object is checked
+// against its union with `satisfies`, so a typo or a value the native side does not
+// know fails to compile. The plain strings keep working everywhere too.
+
+/** How sure the library is that a paired Bluetooth device is a printer. */
+export const PrinterConfidence = {
+  CONFIDENT: 'CONFIDENT',
+  LIKELY: 'LIKELY',
+  UNKNOWN: 'UNKNOWN'
+};
+/** `ALL` lists every paired device, `LIKELY_PRINTERS` hides non-printers, `STRICT` keeps only certain ones. */
+export const PrinterFilter = {
+  ALL: 'ALL',
+  LIKELY_PRINTERS: 'LIKELY_PRINTERS',
+  STRICT: 'STRICT'
+};
+export const PrinterConnectionType = {
+  BLUETOOTH: 'BLUETOOTH',
+  NETWORK: 'NETWORK',
+  USB: 'USB'
+};
+export const PrinterImageType = {
+  PNG: 'PNG',
+  JPEG: 'JPEG'
+};
+export const FileLocation = {
+  CACHE: 'CACHE',
+  APP_FILES: 'APP_FILES',
+  DOWNLOADS: 'DOWNLOADS',
+  DOCUMENTS: 'DOCUMENTS',
+  PICTURES: 'PICTURES',
+  CUSTOM_FOLDER: 'CUSTOM_FOLDER'
+};
+/** The shape `readFile` returns the content in. */
+export const ReadFileFormat = {
+  BASE64: 'base64',
+  DATA_URI: 'dataUri',
+  TEXT: 'text',
+  HEX: 'hex',
+  BYTES: 'bytes'
+};
+//# sourceMappingURL=enums.js.map

package/lib/module/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PrinterConfidence","CONFIDENT","LIKELY","UNKNOWN","PrinterFilter","ALL","LIKELY_PRINTERS","STRICT","PrinterConnectionType","BLUETOOTH","NETWORK","USB","PrinterImageType","PNG","JPEG","FileLocation","CACHE","APP_FILES","DOWNLOADS","DOCUMENTS","PICTURES","CUSTOM_FOLDER","ReadFileFormat","BASE64","DATA_URI","TEXT","HEX","BYTES"],"sourceRoot":"../../src","sources":["enums.ts"],"mappings":";;AASA;AACA;AACA;AACA;;AAEA;AACA,OAAO,MAAMA,iBAAiB,GAAG;EAC/BC,SAAS,EAAE,WAAW;EACtBC,MAAM,EAAE,QAAQ;EAChBC,OAAO,EAAE;AACX,CAA2E;AAI3E;AACA,OAAO,MAAMC,aAAa,GAAG;EAC3BC,GAAG,EAAE,KAAK;EACVC,eAAe,EAAE,iBAAiB;EAClCC,MAAM,EAAE;AACV,CAAmE;AAGnE,OAAO,MAAMC,qBAAqB,GAAG;EACnCC,SAAS,EAAE,WAAW;EACtBC,OAAO,EAAE,SAAS;EAClBC,GAAG,EAAE;AACP,CAGC;AAID,OAAO,MAAMC,gBAAgB,GAAG;EAC9BC,GAAG,EAAE,KAAK;EACVC,IAAI,EAAE;AACR,CAAyE;AAIzE,OAAO,MAAMC,YAAY,GAAG;EAC1BC,KAAK,EAAE,OAAO;EACdC,SAAS,EAAE,WAAW;EACtBC,SAAS,EAAE,WAAW;EACtBC,SAAS,EAAE,WAAW;EACtBC,QAAQ,EAAE,UAAU;EACpBC,aAAa,EAAE;AACjB,CAAiE;AAGjE;AACA,OAAO,MAAMC,cAAc,GAAG;EAC5BC,MAAM,EAAE,QAAQ;EAChBC,QAAQ,EAAE,SAAS;EACnBC,IAAI,EAAE,MAAM;EACZC,GAAG,EAAE,KAAK;EACVC,KAAK,EAAE;AACT,CAAwD","ignoreList":[]}

package/lib/module/index.js

@@ -25,16 +25,43 @@ export function requestBluetoothPermission() {
 }
 
 /**
- * Get all Bluetooth devices already paired (bonded) with this device.
+ * Get the Bluetooth devices already paired (bonded) with this device, best printer
+ * matches first. Every device carries a `confidence`. Pass
+ * `{ filter: 'LIKELY_PRINTERS' }` to hide devices that do not look like printers
+ * (headphones, watches...), or `extraNameKeywords` for a printer with an unusual name.
  */
-export function getBondedBluetoothPrinters() {
-  return ReactNativePrinterKit.getBondedBluetoothPrinters();
+export function getBondedBluetoothPrinters(params = {}) {
+  return ReactNativePrinterKit.getBondedBluetoothPrinters(params);
 }
 
 /**
- * Connect to a paired Bluetooth printer by its MAC address. The connection
- * survives the app being swiped from Recents, and is reconnected to
- * automatically the next time the app starts.
+ * USB printers currently plugged in. Needs a phone with USB host (OTG).
+ */
+export function getUsbPrinters() {
+  return ReactNativePrinterKit.getUsbPrinters();
+}
+
+/**
+ * Whether the user already granted this app access to that USB printer.
+ */
+export function hasUsbPermission(params) {
+  return ReactNativePrinterKit.hasUsbPermission(params);
+}
+
+/**
+ * Shows the system USB permission dialog. Call before `connectPrinter` with
+ * `type: 'USB'`. The grant is lost when the app is reinstalled.
+ */
+export function requestUsbPermission(params) {
+  return ReactNativePrinterKit.requestUsbPermission(params);
+}
+
+/**
+ * Connect to a printer over Bluetooth (default; paired printer's MAC address),
+ * Wi-Fi/LAN (`type: 'NETWORK'`, `address` = IP) or USB (`type: 'USB'` with
+ * `vendorId`/`productId`). The connection survives the app being swiped from
+ * Recents, and is reconnected to automatically the next time the app starts.
+ * Resolves `false` if it could not connect.
  */
 export function connectPrinter(params) {
   return ReactNativePrinterKit.connectPrinter(params);
@@ -61,6 +88,77 @@ export function getConnectedPrinter() {
   return ReactNativePrinterKit.getConnectedPrinter();
 }
 
+/**
+ * Whether a printer is connected and currently accepts data. Does not check
+ * paper or cover - use `getPrinterStatus()`.
+ */
+export function isPrinterReady() {
+  return ReactNativePrinterKit.isPrinterReady();
+}
+
+/**
+ * Asks the printer for its state (online / paper out / cover open / error).
+ * Many printers do not answer: then `responded` is `false` and the other fields
+ * are `null` (unknown, not "ok"). Some printers report an open cover as
+ * `paperOut`, so treat `paperOut: true` as "no paper or cover open".
+ */
+export function getPrinterStatus(params = {}) {
+  return ReactNativePrinterKit.getPrinterStatus(params);
+}
+
+/**
+ * Prints a short ASCII test page.
+ */
+export function printTestPage() {
+  return ReactNativePrinterKit.printTestPage();
+}
+
+/**
+ * Copies a file (e.g. the PDF from `htmlToPdf`) to cache, app storage, public
+ * Downloads/Documents or a chosen folder. Never rejects: check `result.success`.
+ */
+export function saveFile(params) {
+  return ReactNativePrinterKit.saveFile(params);
+}
+
+/**
+ * Reads ONE file and returns its content in the shape `format` asks for: `base64` (default), `dataUri`
+ * (`data:<type>;base64,...`), `text` (optionally with an `encoding`), `hex` or `bytes` (array of numbers,
+ * max 1 MB). `path` is an absolute path or the `content://` Uri `saveFile` returned. A file over `maxBytes`
+ * (default 10 MB) is refused instead of loaded. Never rejects: check `result.success`.
+ */
+export function readFile(params) {
+  return ReactNativePrinterKit.readFile(params);
+}
+
+/**
+ * Renders HTML to ONE image file (PNG, or JPEG with `imageType: 'JPEG'`) and returns its path, or `null`
+ * on failure. Pass `outputPath` to choose the file name. A very tall page can run out of memory (then
+ * `null`). For base64 pass the returned path to `readFile`.
+ */
+export function htmlToImage(params) {
+  return ReactNativePrinterKit.htmlToImage(params);
+}
+
+/**
+ * Reads ONE folder: the files and folders directly inside it, folders first and then A-Z (it does not
+ * go into sub-folders; call it again with an entry's `path` to go deeper). `result.names` is just the
+ * names, `result.entries` has `name`, `path`, `isDirectory`, `sizeBytes` and `lastModified`. A path that
+ * is a file, missing or relative is refused. Never rejects: check `result.success`.
+ */
+export function readDir(params) {
+  return ReactNativePrinterKit.readDir(params);
+}
+
+/**
+ * Deletes ONE file: an absolute path, or the `content://` Uri `saveFile` returned. Never a folder or a
+ * pattern; cannot be undone. A missing file is a failure ("File not found"). Never rejects: check
+ * `result.success`.
+ */
+export function removeFile(params) {
+  return ReactNativePrinterKit.removeFile(params);
+}
+
 /**
  * Print raw text using the printer's built-in font (ASCII only - use
  * printHtml() for Bangla or other non-Latin scripts).
@@ -124,6 +222,9 @@ export function openFile(params) {
   return ReactNativePrinterKit.openFile(params);
 }
 
+// Export enum-like constants (usable at runtime, and as types of the same name)
+export { FileLocation, PrinterConfidence, PrinterConnectionType, PrinterFilter, PrinterImageType, ReadFileFormat } from "./enums.js";
+
 // Export types
 
 // Export native module

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["ReactNativePrinterKit","isBluetoothEnabled","hasBluetoothPermission","requestBluetoothPermission","getBondedBluetoothPrinters","connectPrinter","params","disconnectPrinter","isConnectedPrinter","getConnectedPrinter","printText","printImage","printImageBase64","pdfToImage","printPdf","htmlToPdf","printHtml","openFile"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,qBAAqB,MAYrB,kCAA+B;;AAEtC;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAY;EAC5C,OAAOD,qBAAqB,CAACC,kBAAkB,CAAC,CAAC;AACnD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAAA,EAAY;EAChD,OAAOF,qBAAqB,CAACE,sBAAsB,CAAC,CAAC;AACvD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CAAA,EAAqB;EAC7D,OAAOH,qBAAqB,CAACG,0BAA0B,CAAC,CAAC;AAC3D;;AAEA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CAAA,EAA6B;EACrE,OAAOJ,qBAAqB,CAACI,0BAA0B,CAAC,CAAC;AAC3D;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACC,MAA4B,EAAoB;EAC7E,OAAON,qBAAqB,CAACK,cAAc,CAACC,MAAM,CAAC;AACrD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAkB;EACjD,OAAOP,qBAAqB,CAACO,iBAAiB,CAAC,CAAC;AAClD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAqB;EACrD,OAAOR,qBAAqB,CAACQ,kBAAkB,CAAC,CAAC;AACnD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAA2C;EAC5E,OAAOT,qBAAqB,CAACS,mBAAmB,CAAC,CAAC;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACJ,MAAuB,EAAiB;EAChE,OAAON,qBAAqB,CAACU,SAAS,CAACJ,MAAM,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASK,UAAUA,CAACL,MAAwB,EAAiB;EAClE,OAAON,qBAAqB,CAACW,UAAU,CAACL,MAAM,CAAC;AACjD;;AAEA;AACA;AACA;AACA,OAAO,SAASM,gBAAgBA,CAACN,MAA8B,EAAiB;EAC9E,OAAON,qBAAqB,CAACY,gBAAgB,CAACN,MAAM,CAAC;AACvD;;AAEA;AACA;AACA;AACA,OAAO,SAASO,UAAUA,CAACP,MAAwB,EAAmB;EACpE,OAAON,qBAAqB,CAACa,UAAU,CAACP,MAAM,CAAC;AACjD;;AAEA;AACA;AACA;AACA,OAAO,SAASQ,QAAQA,CAACR,MAAsB,EAAiB;EAC9D,OAAON,qBAAqB,CAACc,QAAQ,CAACR,MAAM,CAAC;AAC/C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASS,SAASA,CAACT,MAAuB,EAA0B;EACzE,OAAON,qBAAqB,CAACe,SAAS,CAACT,MAAM,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASU,SAASA,CAACV,MAAuB,EAAoB;EACnE,OAAON,qBAAqB,CAACgB,SAAS,CAACV,MAAM,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASW,QAAQA,CAACX,MAAsB,EAAW;EACxD,OAAON,qBAAqB,CAACiB,QAAQ,CAACX,MAAM,CAAC;AAC/C;;AAEA;;AAeA;AACA,eAAeN,qBAAqB","ignoreList":[]}
+{"version":3,"names":["ReactNativePrinterKit","isBluetoothEnabled","hasBluetoothPermission","requestBluetoothPermission","getBondedBluetoothPrinters","params","getUsbPrinters","hasUsbPermission","requestUsbPermission","connectPrinter","disconnectPrinter","isConnectedPrinter","getConnectedPrinter","isPrinterReady","getPrinterStatus","printTestPage","saveFile","readFile","htmlToImage","readDir","removeFile","printText","printImage","printImageBase64","pdfToImage","printPdf","htmlToPdf","printHtml","openFile","FileLocation","PrinterConfidence","PrinterConnectionType","PrinterFilter","PrinterImageType","ReadFileFormat"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}