@rejaul/react-native-printer-kit 0.1.1 → 0.3.0

package/README.md

@@ -76,13 +76,13 @@ async function printReceipt() {
   // 2. List paired printers and connect to one
   const printers = getBondedBluetoothPrinters();
   if (printers.length === 0) return;
-  await connectPrinter(printers[0]!.address);
+  await connectPrinter({ address: printers[0]!.address });
 
   // 3a. Print plain text
-  await printText('Hello from PrinterKit');
+  await printText({ text: 'Hello from PrinterKit' });
 
   // 3b. Or print a full HTML receipt (Bangla, styling, everything)
-  const ok = await printHtml(myReceiptHtml);
+  const ok = await printHtml({ html: myReceiptHtml });
   console.log('Printed:', ok);
 }
 ```
@@ -113,12 +113,14 @@ Whether `BLUETOOTH_CONNECT` specifically is already granted (always `true` below
 #### `requestBluetoothPermission(): Promise<boolean>`
 Shows the system permission dialog(s) for whatever's needed on this Android version — `BLUETOOTH_CONNECT` (12+) and `POST_NOTIFICATIONS` (13+, for the persistent-connection notification's visibility) — and resolves based on `BLUETOOTH_CONNECT`'s result specifically. A denied `POST_NOTIFICATIONS` alone doesn't make this resolve `false`: printing still works, the notification just won't show.
 
+Every function that takes data (anything beyond a bare callback) takes a single params object instead of positional arguments, so new fields can be added later without breaking existing call sites.
+
 ### Connection
 
 #### `getBondedBluetoothPrinters(): BluetoothPrinterDevice[]`
 Lists Bluetooth devices already paired with the phone via Android's own Bluetooth settings.
 
-#### `connectPrinter(address: string): Promise<boolean>`
+#### `connectPrinter(params: ConnectPrinterParams): Promise<boolean>`
 Opens an RFCOMM/SPP connection to the paired printer. Closes any existing connection first, and remembers the address for auto-reconnect on the next app launch.
 
 #### `disconnectPrinter(): Promise<void>`
@@ -132,26 +134,26 @@ The currently connected printer, if any.
 
 ### Printing
 
-#### `printText(text: string, feedLines?: number): Promise<void>`
+#### `printText(params: PrintTextParams): Promise<void>`
 Prints raw text using the printer's built-in font. **ASCII only** — use `printHtml()` for Bangla or other non-Latin scripts.
 
-#### `printImage(imagePath: string, printerWidthDots?: number, feedLines?: number): Promise<void>`
+#### `printImage(params: PrintImageParams): Promise<void>`
 Prints an image file as a dithered ESC/POS raster image. `printerWidthDots`: 384 for 58mm printers, 576 for 80mm printers (default 384).
 
-#### `printImageBase64(base64: string, printerWidthDots?: number, feedLines?: number): Promise<void>`
+#### `printImageBase64(params: PrintImageBase64Params): Promise<void>`
 Same as above, from a base64-encoded image string.
 
-#### `pdfToImage(pdfPath: string, imageType?: 'PNG' | 'JPEG', page?: number, targetWidthPx?: number): Promise<string>`
+#### `pdfToImage(params: PdfToImageParams): Promise<string>`
 Renders one PDF page to an image file and returns its path.
 
-#### `printPdf(pdfPath: string, printerWidthDots?: number, page?: number, feedLines?: number): Promise<void>`
+#### `printPdf(params: PrintPdfParams): Promise<void>`
 `pdfToImage` + print, in one call.
 
-#### `htmlToPdf(html: string, pageWidthDp?: number, heightDp?: number, minPageHeightDp?: number): Promise<string | null>`
+#### `htmlToPdf(params: HtmlToPdfParams): Promise<string | null>`
 Renders HTML to a PDF file using an off-screen `WebView` and returns its path, or `null` on failure. `pageWidthDp` controls how large the content renders (like a CSS viewport width), independent of the final printed width. Leave `heightDp` unset to auto-measure the real content height (recommended).
 
-#### `printHtml(html: string, printerWidthDots?: number, pageWidthDp?: number, heightDp?: number, minPageHeightDp?: number): Promise<boolean>`
-Full pipeline: `htmlToPdf` → `printPdf`. This is how you print Bangla (or other non-Latin) text or any real HTML/CSS layout.
+#### `printHtml(params: PrintHtmlParams): Promise<boolean>`
+Full pipeline: `htmlToPdf` → `printPdf`. This is how you print Bangla (or other non-Latin) text or any real HTML/CSS layout. Retries once (reconnect + resend) if the underlying write fails, e.g. from a "Broken pipe" when a cheap board drops the link mid-print.
 
 ## Type Definitions
 
@@ -162,6 +164,59 @@ type BluetoothPrinterDevice = {
 };
 
 type PrinterImageType = 'PNG' | 'JPEG';
+
+type ConnectPrinterParams = { address: string };
+
+type PrintTextParams = { text: string; feedLines?: number };
+
+type PrintImageParams = {
+  imagePath: string;
+  printerWidthDots?: number;
+  feedLines?: number;
+  bandHeightDots?: number; // default 16 - lower for printers that drop/garble large images
+  bandDelayMs?: number; // default 60 - raise for printers that drop/garble large images
+};
+
+type PrintImageBase64Params = {
+  base64: string;
+  printerWidthDots?: number;
+  feedLines?: number;
+  bandHeightDots?: number;
+  bandDelayMs?: number;
+};
+
+type PdfToImageParams = {
+  pdfPath: string;
+  imageType?: PrinterImageType;
+  page?: number;
+  targetWidthPx?: number;
+};
+
+type PrintPdfParams = {
+  pdfPath: string;
+  printerWidthDots?: number;
+  page?: number;
+  feedLines?: number;
+  bandHeightDots?: number;
+  bandDelayMs?: number;
+};
+
+type HtmlToPdfParams = {
+  html: string;
+  pageWidthDp?: number;
+  heightDp?: number;
+  minPageHeightDp?: number;
+};
+
+type PrintHtmlParams = {
+  html: string;
+  printerWidthDots?: number;
+  pageWidthDp?: number;
+  heightDp?: number;
+  minPageHeightDp?: number;
+  bandHeightDots?: number;
+  bandDelayMs?: number;
+};
 ```
 
 ## Persistent connection & auto-reconnect

package/android/build.gradle

@@ -61,5 +61,5 @@ repositories {
 
 dependencies {
   implementation "com.facebook.react:react-android"
-  implementation("com.github.DeveloperRejaul:android-printer-kit:v0.0.5")
+  implementation("com.github.DeveloperRejaul:android-printer-kit:v0.0.10")
 }

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

@@ -10,6 +10,7 @@ import androidx.core.content.ContextCompat
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.bridge.WritableArray
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.modules.core.PermissionAwareActivity
@@ -17,9 +18,29 @@ 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 java.util.concurrent.Executors
 
+/** Reads an optional numeric field, falling back to [default] if absent/null. */
+private fun ReadableMap.optInt(key: String, default: Int): Int =
+  if (hasKey(key) && !isNull(key)) getDouble(key).toInt() else default
+
+/** Reads an optional numeric field, or null if absent/null. */
+private fun ReadableMap.optIntOrNull(key: String): Int? =
+  if (hasKey(key) && !isNull(key)) getDouble(key).toInt() else null
+
+/** Reads an optional numeric field as a Long, falling back to [default] if absent/null. */
+private fun ReadableMap.optLong(key: String, default: Long): Long =
+  if (hasKey(key) && !isNull(key)) getDouble(key).toLong() else default
+
 /**
  * Bridges [com.rezaul.printerkit.BluetoothPrinter] to React Native.
  *
@@ -32,6 +53,10 @@ import java.util.concurrent.Executors
  * All blocking Bluetooth/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
+ * single-params-object functions on the native side.
  */
 class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
   NativeReactNativePrinterKitSpec(reactContext) {
@@ -126,11 +151,16 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     return result
   }
 
-  override fun connectPrinter(address: String, promise: Promise) {
+  override fun connectPrinter(params: ReadableMap, promise: Promise) {
+    val address = params.getString("address")
+    if (address == null) {
+      promise.reject("ERROR", "address is required")
+      return
+    }
     withService { service ->
       executor.execute {
         try {
-          promise.resolve(service.connectAndKeepAlive(address))
+          promise.resolve(service.connectAndKeepAlive(ConnectPrinterParams(address)))
         } catch (e: Exception) {
           promise.reject("ERROR", e.message)
         }
@@ -176,11 +206,16 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun printText(text: String, feedLines: Double?, promise: Promise) {
+  override fun printText(params: ReadableMap, promise: Promise) {
+    val text = params.getString("text")
+    if (text == null) {
+      promise.reject("ERROR", "text is required")
+      return
+    }
     withService { service ->
       executor.execute {
         try {
-          service.printer.printText(text, (feedLines ?: 3.0).toInt())
+          service.printer.printText(PrintTextParams(text, params.optInt("feedLines", 3)))
           promise.resolve(null)
         } catch (e: Exception) {
           promise.reject("ERROR", e.message)
@@ -189,11 +224,24 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun printImage(imagePath: String, printerWidthDots: Double?, feedLines: Double?, promise: Promise) {
+  override fun printImage(params: ReadableMap, promise: Promise) {
+    val imagePath = params.getString("imagePath")
+    if (imagePath == null) {
+      promise.reject("ERROR", "imagePath is required")
+      return
+    }
     withService { service ->
       executor.execute {
         try {
-          service.printer.printImageFile(imagePath, (printerWidthDots ?: 384.0).toInt(), (feedLines ?: 3.0).toInt())
+          service.printer.printImageFile(
+            PrintImageFileParams(
+              imagePath = imagePath,
+              printerWidthDots = params.optInt("printerWidthDots", 384),
+              feedLines = params.optInt("feedLines", 3),
+              bandHeightDots = params.optInt("bandHeightDots", 16),
+              bandDelayMs = params.optLong("bandDelayMs", 60L)
+            )
+          )
           promise.resolve(null)
         } catch (e: Exception) {
           promise.reject("ERROR", e.message)
@@ -202,11 +250,24 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun printImageBase64(base64: String, printerWidthDots: Double?, feedLines: Double?, promise: Promise) {
+  override fun printImageBase64(params: ReadableMap, promise: Promise) {
+    val base64 = params.getString("base64")
+    if (base64 == null) {
+      promise.reject("ERROR", "base64 is required")
+      return
+    }
     withService { service ->
       executor.execute {
         try {
-          service.printer.printImageBase64(base64, (printerWidthDots ?: 384.0).toInt(), (feedLines ?: 3.0).toInt())
+          service.printer.printImageBase64(
+            PrintImageBase64Params(
+              base64 = base64,
+              printerWidthDots = params.optInt("printerWidthDots", 384),
+              feedLines = params.optInt("feedLines", 3),
+              bandHeightDots = params.optInt("bandHeightDots", 16),
+              bandDelayMs = params.optLong("bandDelayMs", 60L)
+            )
+          )
           promise.resolve(null)
         } catch (e: Exception) {
           promise.reject("ERROR", e.message)
@@ -215,12 +276,28 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun pdfToImage(pdfPath: String, imageType: String?, page: Double?, targetWidthPx: Double?, promise: Promise) {
+  override fun pdfToImage(params: ReadableMap, promise: Promise) {
+    val pdfPath = params.getString("pdfPath")
+    if (pdfPath == null) {
+      promise.reject("ERROR", "pdfPath is required")
+      return
+    }
     withService { service ->
       executor.execute {
         try {
-          val type = if (imageType == "JPEG") PrinterImageType.JPEG else PrinterImageType.PNG
-          val path = service.printer.pdfToImage(pdfPath, type, (page ?: 0.0).toInt(), targetWidthPx?.toInt())
+          val imageType = if (params.getString("imageType") == "JPEG") {
+            PrinterImageType.JPEG
+          } else {
+            PrinterImageType.PNG
+          }
+          val path = service.printer.pdfToImage(
+            PdfToImageParams(
+              pdfPath = pdfPath,
+              imageType = imageType,
+              page = params.optInt("page", 0),
+              targetWidthPx = params.optIntOrNull("targetWidthPx")
+            )
+          )
           promise.resolve(path)
         } catch (e: Exception) {
           promise.reject("ERROR", e.message)
@@ -229,11 +306,25 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun printPdf(pdfPath: String, printerWidthDots: Double?, page: Double?, feedLines: Double?, promise: Promise) {
+  override fun printPdf(params: ReadableMap, promise: Promise) {
+    val pdfPath = params.getString("pdfPath")
+    if (pdfPath == null) {
+      promise.reject("ERROR", "pdfPath is required")
+      return
+    }
     withService { service ->
       executor.execute {
         try {
-          service.printer.printPdf(pdfPath, (printerWidthDots ?: 384.0).toInt(), (page ?: 0.0).toInt(), (feedLines ?: 3.0).toInt())
+          service.printer.printPdf(
+            PrintPdfParams(
+              pdfPath = pdfPath,
+              printerWidthDots = params.optInt("printerWidthDots", 384),
+              page = params.optInt("page", 0),
+              feedLines = params.optInt("feedLines", 3),
+              bandHeightDots = params.optInt("bandHeightDots", 16),
+              bandDelayMs = params.optLong("bandDelayMs", 60L)
+            )
+          )
           promise.resolve(null)
         } catch (e: Exception) {
           promise.reject("ERROR", e.message)
@@ -242,34 +333,43 @@ class ReactNativePrinterKitModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun htmlToPdf(html: String, pageWidthDp: Double?, heightDp: Double?, minPageHeightDp: Double?, promise: Promise) {
+  override fun htmlToPdf(params: ReadableMap, promise: Promise) {
+    val html = params.getString("html")
+    if (html == null) {
+      promise.reject("ERROR", "html is required")
+      return
+    }
     withService { service ->
       service.printer.htmlToPdf(
-        html = html,
-        pageWidthDp = (pageWidthDp ?: 412.0).toInt(),
-        heightDp = heightDp?.toInt(),
-        minPageHeightDp = (minPageHeightDp ?: 1000.0).toInt()
+        HtmlToPdfParams(
+          html = html,
+          pageWidthDp = params.optInt("pageWidthDp", 412),
+          heightDp = params.optIntOrNull("heightDp"),
+          minPageHeightDp = params.optInt("minPageHeightDp", 1000)
+        )
       ) { path ->
         promise.resolve(path)
       }
     }
   }
 
-  override fun printHtml(
-    html: String,
-    printerWidthDots: Double?,
-    pageWidthDp: Double?,
-    heightDp: Double?,
-    minPageHeightDp: Double?,
-    promise: Promise
-  ) {
+  override fun printHtml(params: ReadableMap, promise: Promise) {
+    val html = params.getString("html")
+    if (html == null) {
+      promise.reject("ERROR", "html is required")
+      return
+    }
     withService { service ->
       service.printer.printHtml(
-        html = html,
-        printerWidthDots = (printerWidthDots ?: 384.0).toInt(),
-        pageWidthDp = (pageWidthDp ?: 412.0).toInt(),
-        heightDp = heightDp?.toInt(),
-        minPageHeightDp = (minPageHeightDp ?: 1000.0).toInt()
+        PrintHtmlParams(
+          html = html,
+          printerWidthDots = params.optInt("printerWidthDots", 384),
+          pageWidthDp = params.optInt("pageWidthDp", 412),
+          heightDp = params.optIntOrNull("heightDp"),
+          minPageHeightDp = params.optInt("minPageHeightDp", 1000),
+          bandHeightDots = params.optInt("bandHeightDots", 16),
+          bandDelayMs = params.optLong("bandDelayMs", 60L)
+        )
       ) { ok ->
         promise.resolve(ok)
       }

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;AAgI9E,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;AAqK9E,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/index.js

@@ -28,8 +28,8 @@ export function getBondedBluetoothPrinters() {
  * survives the app being swiped from Recents, and is reconnected to
  * automatically the next time the app starts.
  */
-export function connectPrinter(address) {
-  return ReactNativePrinterKit.connectPrinter(address);
+export function connectPrinter(params) {
+  return ReactNativePrinterKit.connectPrinter(params);
 }
 
 /**
@@ -57,53 +57,53 @@ export function getConnectedPrinter() {
  * Print raw text using the printer's built-in font (ASCII only - use
  * printHtml() for Bangla or other non-Latin scripts).
  */
-export function printText(text, feedLines) {
-  return ReactNativePrinterKit.printText(text, feedLines);
+export function printText(params) {
+  return ReactNativePrinterKit.printText(params);
 }
 
 /**
  * Print an image file as an ESC/POS raster image.
- * @param printerWidthDots 384 for 58mm printers, 576 for 80mm printers (default 384).
+ * `printerWidthDots`: 384 for 58mm printers, 576 for 80mm printers (default 384).
  */
-export function printImage(imagePath, printerWidthDots, feedLines) {
-  return ReactNativePrinterKit.printImage(imagePath, printerWidthDots, feedLines);
+export function printImage(params) {
+  return ReactNativePrinterKit.printImage(params);
 }
 
 /**
  * Print a base64-encoded image as an ESC/POS raster image.
  */
-export function printImageBase64(base64, printerWidthDots, feedLines) {
-  return ReactNativePrinterKit.printImageBase64(base64, printerWidthDots, feedLines);
+export function printImageBase64(params) {
+  return ReactNativePrinterKit.printImageBase64(params);
 }
 
 /**
  * Render a page of a PDF file to an image file. Returns the image path.
  */
-export function pdfToImage(pdfPath, imageType, page, targetWidthPx) {
-  return ReactNativePrinterKit.pdfToImage(pdfPath, imageType, page, targetWidthPx);
+export function pdfToImage(params) {
+  return ReactNativePrinterKit.pdfToImage(params);
 }
 
 /**
  * Render a page of a PDF to an image, then print it.
  */
-export function printPdf(pdfPath, printerWidthDots, page, feedLines) {
-  return ReactNativePrinterKit.printPdf(pdfPath, printerWidthDots, page, feedLines);
+export function printPdf(params) {
+  return ReactNativePrinterKit.printPdf(params);
 }
 
 /**
  * Render HTML to a PDF file and return its path, or null on failure. See
  * NativeReactNativePrinterKit's Spec for what pageWidthDp/heightDp/minPageHeightDp control.
  */
-export function htmlToPdf(html, pageWidthDp, heightDp, minPageHeightDp) {
-  return ReactNativePrinterKit.htmlToPdf(html, pageWidthDp, heightDp, minPageHeightDp);
+export function htmlToPdf(params) {
+  return ReactNativePrinterKit.htmlToPdf(params);
 }
 
 /**
  * Full pipeline: render HTML to PDF, then print it - the way to print Bangla
  * (or other non-Latin) text or any real HTML/CSS layout.
  */
-export function printHtml(html, printerWidthDots, pageWidthDp, heightDp, minPageHeightDp) {
-  return ReactNativePrinterKit.printHtml(html, printerWidthDots, pageWidthDp, heightDp, minPageHeightDp);
+export function printHtml(params) {
+  return ReactNativePrinterKit.printHtml(params);
 }
 
 // Export types

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["ReactNativePrinterKit","hasBluetoothPermission","requestBluetoothPermission","getBondedBluetoothPrinters","connectPrinter","address","disconnectPrinter","isConnectedPrinter","getConnectedPrinter","printText","text","feedLines","printImage","imagePath","printerWidthDots","printImageBase64","base64","pdfToImage","pdfPath","imageType","page","targetWidthPx","printPdf","htmlToPdf","html","pageWidthDp","heightDp","minPageHeightDp","printHtml"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,qBAAqB,MAGrB,kCAA+B;;AAEtC;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAAA,EAAY;EAChD,OAAOD,qBAAqB,CAACC,sBAAsB,CAAC,CAAC;AACvD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CAAA,EAAqB;EAC7D,OAAOF,qBAAqB,CAACE,0BAA0B,CAAC,CAAC;AAC3D;;AAEA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CAAA,EAA6B;EACrE,OAAOH,qBAAqB,CAACG,0BAA0B,CAAC,CAAC;AAC3D;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACC,OAAe,EAAoB;EAChE,OAAOL,qBAAqB,CAACI,cAAc,CAACC,OAAO,CAAC;AACtD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAkB;EACjD,OAAON,qBAAqB,CAACM,iBAAiB,CAAC,CAAC;AAClD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAqB;EACrD,OAAOP,qBAAqB,CAACO,kBAAkB,CAAC,CAAC;AACnD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAA2C;EAC5E,OAAOR,qBAAqB,CAACQ,mBAAmB,CAAC,CAAC;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACC,IAAY,EAAEC,SAAkB,EAAiB;EACzE,OAAOX,qBAAqB,CAACS,SAAS,CAACC,IAAI,EAAEC,SAAS,CAAC;AACzD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CACxBC,SAAiB,EACjBC,gBAAyB,EACzBH,SAAkB,EACH;EACf,OAAOX,qBAAqB,CAACY,UAAU,CAACC,SAAS,EAAEC,gBAAgB,EAAEH,SAAS,CAAC;AACjF;;AAEA;AACA;AACA;AACA,OAAO,SAASI,gBAAgBA,CAC9BC,MAAc,EACdF,gBAAyB,EACzBH,SAAkB,EACH;EACf,OAAOX,qBAAqB,CAACe,gBAAgB,CAACC,MAAM,EAAEF,gBAAgB,EAAEH,SAAS,CAAC;AACpF;;AAEA;AACA;AACA;AACA,OAAO,SAASM,UAAUA,CACxBC,OAAe,EACfC,SAA4B,EAC5BC,IAAa,EACbC,aAAsB,EACL;EACjB,OAAOrB,qBAAqB,CAACiB,UAAU,CAACC,OAAO,EAAEC,SAAS,EAAEC,IAAI,EAAEC,aAAa,CAAC;AAClF;;AAEA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CACtBJ,OAAe,EACfJ,gBAAyB,EACzBM,IAAa,EACbT,SAAkB,EACH;EACf,OAAOX,qBAAqB,CAACsB,QAAQ,CAACJ,OAAO,EAAEJ,gBAAgB,EAAEM,IAAI,EAAET,SAAS,CAAC;AACnF;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASY,SAASA,CACvBC,IAAY,EACZC,WAAoB,EACpBC,QAAiB,EACjBC,eAAwB,EACA;EACxB,OAAO3B,qBAAqB,CAACuB,SAAS,CAACC,IAAI,EAAEC,WAAW,EAAEC,QAAQ,EAAEC,eAAe,CAAC;AACtF;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CACvBJ,IAAY,EACZV,gBAAyB,EACzBW,WAAoB,EACpBC,QAAiB,EACjBC,eAAwB,EACN;EAClB,OAAO3B,qBAAqB,CAAC4B,SAAS,CACpCJ,IAAI,EACJV,gBAAgB,EAChBW,WAAW,EACXC,QAAQ,EACRC,eACF,CAAC;AACH;;AAEA;;AAGA;AACA,eAAe3B,qBAAqB","ignoreList":[]}
+{"version":3,"names":["ReactNativePrinterKit","hasBluetoothPermission","requestBluetoothPermission","getBondedBluetoothPrinters","connectPrinter","params","disconnectPrinter","isConnectedPrinter","getConnectedPrinter","printText","printImage","printImageBase64","pdfToImage","printPdf","htmlToPdf","printHtml"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,qBAAqB,MAWrB,kCAA+B;;AAEtC;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAAA,EAAY;EAChD,OAAOD,qBAAqB,CAACC,sBAAsB,CAAC,CAAC;AACvD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CAAA,EAAqB;EAC7D,OAAOF,qBAAqB,CAACE,0BAA0B,CAAC,CAAC;AAC3D;;AAEA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CAAA,EAA6B;EACrE,OAAOH,qBAAqB,CAACG,0BAA0B,CAAC,CAAC;AAC3D;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACC,MAA4B,EAAoB;EAC7E,OAAOL,qBAAqB,CAACI,cAAc,CAACC,MAAM,CAAC;AACrD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAkB;EACjD,OAAON,qBAAqB,CAACM,iBAAiB,CAAC,CAAC;AAClD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAqB;EACrD,OAAOP,qBAAqB,CAACO,kBAAkB,CAAC,CAAC;AACnD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAA2C;EAC5E,OAAOR,qBAAqB,CAACQ,mBAAmB,CAAC,CAAC;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACJ,MAAuB,EAAiB;EAChE,OAAOL,qBAAqB,CAACS,SAAS,CAACJ,MAAM,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASK,UAAUA,CAACL,MAAwB,EAAiB;EAClE,OAAOL,qBAAqB,CAACU,UAAU,CAACL,MAAM,CAAC;AACjD;;AAEA;AACA;AACA;AACA,OAAO,SAASM,gBAAgBA,CAACN,MAA8B,EAAiB;EAC9E,OAAOL,qBAAqB,CAACW,gBAAgB,CAACN,MAAM,CAAC;AACvD;;AAEA;AACA;AACA;AACA,OAAO,SAASO,UAAUA,CAACP,MAAwB,EAAmB;EACpE,OAAOL,qBAAqB,CAACY,UAAU,CAACP,MAAM,CAAC;AACjD;;AAEA;AACA;AACA;AACA,OAAO,SAASQ,QAAQA,CAACR,MAAsB,EAAiB;EAC9D,OAAOL,qBAAqB,CAACa,QAAQ,CAACR,MAAM,CAAC;AAC/C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASS,SAASA,CAACT,MAAuB,EAA0B;EACzE,OAAOL,qBAAqB,CAACc,SAAS,CAACT,MAAM,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASU,SAASA,CAACV,MAAuB,EAAoB;EACnE,OAAOL,qBAAqB,CAACe,SAAS,CAACV,MAAM,CAAC;AAChD;;AAEA;;AAcA;AACA,eAAeL,qBAAqB","ignoreList":[]}

package/lib/typescript/src/NativeReactNativePrinterKit.d.ts

@@ -4,6 +4,64 @@ export type BluetoothPrinterDevice = {
     address: string;
 };
 export type PrinterImageType = 'PNG' | 'JPEG';
+export type ConnectPrinterParams = {
+    address: string;
+};
+export type PrintTextParams = {
+    text: string;
+    feedLines?: number;
+};
+export type PrintImageParams = {
+    imagePath: string;
+    printerWidthDots?: number;
+    feedLines?: number;
+    /** Height (in dots) of each raster band sent to the printer. Lower this for printers with a small receive buffer that drop or garble large images. Default 16. */
+    bandHeightDots?: number;
+    /** Pause (ms) between raster bands, giving the printer time to catch up. Default 60. */
+    bandDelayMs?: number;
+};
+export type PrintImageBase64Params = {
+    base64: string;
+    printerWidthDots?: number;
+    feedLines?: number;
+    /** See PrintImageParams.bandHeightDots. */
+    bandHeightDots?: number;
+    /** See PrintImageParams.bandDelayMs. */
+    bandDelayMs?: number;
+};
+export type PdfToImageParams = {
+    pdfPath: string;
+    imageType?: PrinterImageType;
+    page?: number;
+    targetWidthPx?: number;
+};
+export type PrintPdfParams = {
+    pdfPath: string;
+    printerWidthDots?: number;
+    page?: number;
+    feedLines?: number;
+    /** See PrintImageParams.bandHeightDots. */
+    bandHeightDots?: number;
+    /** See PrintImageParams.bandDelayMs. */
+    bandDelayMs?: number;
+};
+export type HtmlToPdfParams = {
+    html: string;
+    pageWidthDp?: number;
+    heightDp?: number;
+    minPageHeightDp?: number;
+};
+export type PrintHtmlParams = {
+    html: string;
+    printerWidthDots?: number;
+    pageWidthDp?: number;
+    heightDp?: number;
+    minPageHeightDp?: number;
+    /** See PrintImageParams.bandHeightDots. */
+    bandHeightDots?: number;
+    /** See PrintImageParams.bandDelayMs. */
+    bandDelayMs?: number;
+};
 export interface Spec extends TurboModule {
     /**
      * Whether Bluetooth permission is already granted (always true below Android 12).
@@ -25,7 +83,7 @@ export interface Spec extends TurboModule {
      * app reconnects automatically next time it's opened (see the README's
      * "Persistent connection" section).
      */
-    connectPrinter(address: string): Promise<boolean>;
+    connectPrinter(params: ConnectPrinterParams): Promise<boolean>;
     /**
      * Closes the current printer connection, if any, and forgets it for auto-reconnect.
      */
@@ -42,43 +100,43 @@ export interface Spec extends TurboModule {
      * Print raw text using the printer's built-in font. ASCII only - not
      * suitable for Bangla or other non-Latin scripts, use printHtml() instead.
      */
-    printText(text: string, feedLines?: number): Promise<void>;
+    printText(params: PrintTextParams): Promise<void>;
     /**
      * Print an image file as a dithered ESC/POS raster image.
-     * @param printerWidthDots 384 for 58mm printers, 576 for 80mm printers (default 384).
+     * `printerWidthDots`: 384 for 58mm printers, 576 for 80mm printers (default 384).
      */
-    printImage(imagePath: string, printerWidthDots?: number, feedLines?: number): Promise<void>;
+    printImage(params: PrintImageParams): Promise<void>;
     /**
      * Print a base64-encoded image as a dithered ESC/POS raster image.
      */
-    printImageBase64(base64: string, printerWidthDots?: number, feedLines?: number): Promise<void>;
+    printImageBase64(params: PrintImageBase64Params): Promise<void>;
     /**
      * Renders a page of a PDF file to an image file (via Android's PdfRenderer)
      * and returns the image's absolute path.
      */
-    pdfToImage(pdfPath: string, imageType?: PrinterImageType, page?: number, targetWidthPx?: number): Promise<string>;
+    pdfToImage(params: PdfToImageParams): Promise<string>;
     /**
      * Renders a page of a PDF to an image, then prints it.
      */
-    printPdf(pdfPath: string, printerWidthDots?: number, page?: number, feedLines?: number): Promise<void>;
+    printPdf(params: PrintPdfParams): Promise<void>;
     /**
      * Renders HTML to a PDF file using an off-screen WebView (no external
      * library) and returns the PDF's absolute path, or null on failure.
      *
-     * @param pageWidthDp layout width in dp the HTML is rendered at - controls
-     *   how large the content looks relative to the page, independent of the
-     *   final printed width (printerWidthDots on printHtml/printPdf downscales it).
-     * @param heightDp if set, forces the page to exactly this height (dp) instead
-     *   of auto-measuring the HTML's real content height.
-     * @param minPageHeightDp ignored if heightDp is set - a height floor (dp) for
-     *   auto-measured content, only relevant for very short/empty HTML.
+     * `pageWidthDp` is the layout width the HTML is rendered at - controls how
+     * large the content looks relative to the page, independent of the final
+     * printed width (`printerWidthDots` on printHtml/printPdf downscales it).
+     * `heightDp`, if set, forces the page to exactly this height (dp) instead
+     * of auto-measuring the HTML's real content height. `minPageHeightDp` is
+     * ignored if `heightDp` is set - a height floor (dp) for auto-measured
+     * content, only relevant for very short/empty HTML.
      */
-    htmlToPdf(html: string, pageWidthDp?: number, heightDp?: number, minPageHeightDp?: number): Promise<string | null>;
+    htmlToPdf(params: HtmlToPdfParams): Promise<string | null>;
     /**
      * Full pipeline: htmlToPdf -> printPdf, in one call. This is how to print
      * content with Bangla or other non-Latin text, or any real HTML/CSS layout.
      */
-    printHtml(html: string, printerWidthDots?: number, pageWidthDp?: number, heightDp?: number, minPageHeightDp?: number): Promise<boolean>;
+    printHtml(params: PrintHtmlParams): Promise<boolean>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/src/NativeReactNativePrinterKit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeReactNativePrinterKit.d.ts","sourceRoot":"","sources":["../../../src/NativeReactNativePrinterKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAY,MAAM,cAAc,CAAC;AAE/E,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;OAEG;IACH,sBAAsB,IAAI,OAAO,CAAC;IAElC;;;OAGG;IACH,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/C;;;OAGG;IACH,0BAA0B,IAAI,sBAAsB,EAAE,CAAC;IAEvD;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAE9D;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;OAGG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,MAAM,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;OAGG;IACH,UAAU,CACR,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,gBAAgB,EAC5B,IAAI,CAAC,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;OAEG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,MAAM,EACzB,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;;OAWG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,gBAAgB,CAAC,EAAE,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;;AAQD,wBAA2B"}
+{"version":3,"file":"NativeReactNativePrinterKit.d.ts","sourceRoot":"","sources":["../../../src/NativeReactNativePrinterKit.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/index.d.ts

@@ -1,4 +1,4 @@
-import ReactNativePrinterKit, { type BluetoothPrinterDevice, type PrinterImageType } from './NativeReactNativePrinterKit.js';
+import ReactNativePrinterKit, { type BluetoothPrinterDevice, type ConnectPrinterParams, type HtmlToPdfParams, type PdfToImageParams, type PrinterImageType, type PrintHtmlParams, type PrintImageBase64Params, type PrintImageParams, type PrintPdfParams, type PrintTextParams } from './NativeReactNativePrinterKit.js';
 /**
  * Whether Bluetooth permission is already granted (always true below Android 12).
  */
@@ -16,7 +16,7 @@ export declare function getBondedBluetoothPrinters(): BluetoothPrinterDevice[];
  * survives the app being swiped from Recents, and is reconnected to
  * automatically the next time the app starts.
  */
-export declare function connectPrinter(address: string): Promise<boolean>;
+export declare function connectPrinter(params: ConnectPrinterParams): Promise<boolean>;
 /**
  * Disconnect from the current printer.
  */
@@ -33,34 +33,34 @@ export declare function getConnectedPrinter(): Promise<BluetoothPrinterDevice |
  * Print raw text using the printer's built-in font (ASCII only - use
  * printHtml() for Bangla or other non-Latin scripts).
  */
-export declare function printText(text: string, feedLines?: number): Promise<void>;
+export declare function printText(params: PrintTextParams): Promise<void>;
 /**
  * Print an image file as an ESC/POS raster image.
- * @param printerWidthDots 384 for 58mm printers, 576 for 80mm printers (default 384).
+ * `printerWidthDots`: 384 for 58mm printers, 576 for 80mm printers (default 384).
  */
-export declare function printImage(imagePath: string, printerWidthDots?: number, feedLines?: number): Promise<void>;
+export declare function printImage(params: PrintImageParams): Promise<void>;
 /**
  * Print a base64-encoded image as an ESC/POS raster image.
  */
-export declare function printImageBase64(base64: string, printerWidthDots?: number, feedLines?: number): Promise<void>;
+export declare function printImageBase64(params: PrintImageBase64Params): Promise<void>;
 /**
  * Render a page of a PDF file to an image file. Returns the image path.
  */
-export declare function pdfToImage(pdfPath: string, imageType?: PrinterImageType, page?: number, targetWidthPx?: number): Promise<string>;
+export declare function pdfToImage(params: PdfToImageParams): Promise<string>;
 /**
  * Render a page of a PDF to an image, then print it.
  */
-export declare function printPdf(pdfPath: string, printerWidthDots?: number, page?: number, feedLines?: number): Promise<void>;
+export declare function printPdf(params: PrintPdfParams): Promise<void>;
 /**
  * Render HTML to a PDF file and return its path, or null on failure. See
  * NativeReactNativePrinterKit's Spec for what pageWidthDp/heightDp/minPageHeightDp control.
  */
-export declare function htmlToPdf(html: string, pageWidthDp?: number, heightDp?: number, minPageHeightDp?: number): Promise<string | null>;
+export declare function htmlToPdf(params: HtmlToPdfParams): Promise<string | null>;
 /**
  * Full pipeline: render HTML to PDF, then print it - the way to print Bangla
  * (or other non-Latin) text or any real HTML/CSS layout.
  */
-export declare function printHtml(html: string, printerWidthDots?: number, pageWidthDp?: number, heightDp?: number, minPageHeightDp?: number): Promise<boolean>;
-export type { BluetoothPrinterDevice, PrinterImageType };
+export declare function printHtml(params: PrintHtmlParams): Promise<boolean>;
+export type { BluetoothPrinterDevice, ConnectPrinterParams, HtmlToPdfParams, PdfToImageParams, PrinterImageType, PrintHtmlParams, PrintImageBase64Params, PrintImageParams, PrintPdfParams, PrintTextParams, };
 export default ReactNativePrinterKit;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,EAAE,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,kCAA+B,CAAC;AAEvC;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,sBAAsB,EAAE,CAErE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAErD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAE5E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,MAAM,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,gBAAgB,EAC5B,IAAI,CAAC,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,MAAM,EACzB,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,gBAAgB,CAAC,EAAE,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAGD,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAC;AAGzD,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,EAAE,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,kCAA+B,CAAC;AAEvC;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,sBAAsB,EAAE,CAErE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAErD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAE5E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEzE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAGD,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,CAAC;AAGF,eAAe,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rejaul/react-native-printer-kit",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Direct Bluetooth POS/thermal (ESC/POS) printer integration for React Native on Android — print raw text, images, PDFs, and full HTML/CSS content including Bangla and other non-Latin scripts.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/NativeReactNativePrinterKit.ts

@@ -7,6 +7,72 @@ export type BluetoothPrinterDevice = {
 
 export type PrinterImageType = 'PNG' | 'JPEG';
 
+export type ConnectPrinterParams = {
+  address: string;
+};
+
+export type PrintTextParams = {
+  text: string;
+  feedLines?: number;
+};
+
+export type PrintImageParams = {
+  imagePath: string;
+  printerWidthDots?: number;
+  feedLines?: number;
+  /** Height (in dots) of each raster band sent to the printer. Lower this for printers with a small receive buffer that drop or garble large images. Default 16. */
+  bandHeightDots?: number;
+  /** Pause (ms) between raster bands, giving the printer time to catch up. Default 60. */
+  bandDelayMs?: number;
+};
+
+export type PrintImageBase64Params = {
+  base64: string;
+  printerWidthDots?: number;
+  feedLines?: number;
+  /** See PrintImageParams.bandHeightDots. */
+  bandHeightDots?: number;
+  /** See PrintImageParams.bandDelayMs. */
+  bandDelayMs?: number;
+};
+
+export type PdfToImageParams = {
+  pdfPath: string;
+  imageType?: PrinterImageType;
+  page?: number;
+  targetWidthPx?: number;
+};
+
+export type PrintPdfParams = {
+  pdfPath: string;
+  printerWidthDots?: number;
+  page?: number;
+  feedLines?: number;
+  /** See PrintImageParams.bandHeightDots. */
+  bandHeightDots?: number;
+  /** See PrintImageParams.bandDelayMs. */
+  bandDelayMs?: number;
+};
+
+export type HtmlToPdfParams = {
+  html: string;
+  pageWidthDp?: number;
+  heightDp?: number;
+  minPageHeightDp?: number;
+};
+
+export type PrintHtmlParams = {
+  html: string;
+  printerWidthDots?: number;
+  pageWidthDp?: number;
+  heightDp?: number;
+  minPageHeightDp?: number;
+  /** See PrintImageParams.bandHeightDots. */
+  bandHeightDots?: number;
+  /** See PrintImageParams.bandDelayMs. */
+  bandDelayMs?: number;
+};
+
 export interface Spec extends TurboModule {
   /**
    * Whether Bluetooth permission is already granted (always true below Android 12).
@@ -31,7 +97,7 @@ export interface Spec extends TurboModule {
    * app reconnects automatically next time it's opened (see the README's
    * "Persistent connection" section).
    */
-  connectPrinter(address: string): Promise<boolean>;
+  connectPrinter(params: ConnectPrinterParams): Promise<boolean>;
 
   /**
    * Closes the current printer connection, if any, and forgets it for auto-reconnect.
@@ -52,78 +118,49 @@ export interface Spec extends TurboModule {
    * Print raw text using the printer's built-in font. ASCII only - not
    * suitable for Bangla or other non-Latin scripts, use printHtml() instead.
    */
-  printText(text: string, feedLines?: number): Promise<void>;
+  printText(params: PrintTextParams): Promise<void>;
 
   /**
    * Print an image file as a dithered ESC/POS raster image.
-   * @param printerWidthDots 384 for 58mm printers, 576 for 80mm printers (default 384).
+   * `printerWidthDots`: 384 for 58mm printers, 576 for 80mm printers (default 384).
    */
-  printImage(
-    imagePath: string,
-    printerWidthDots?: number,
-    feedLines?: number
-  ): Promise<void>;
+  printImage(params: PrintImageParams): Promise<void>;
 
   /**
    * Print a base64-encoded image as a dithered ESC/POS raster image.
    */
-  printImageBase64(
-    base64: string,
-    printerWidthDots?: number,
-    feedLines?: number
-  ): Promise<void>;
+  printImageBase64(params: PrintImageBase64Params): Promise<void>;
 
   /**
    * Renders a page of a PDF file to an image file (via Android's PdfRenderer)
    * and returns the image's absolute path.
    */
-  pdfToImage(
-    pdfPath: string,
-    imageType?: PrinterImageType,
-    page?: number,
-    targetWidthPx?: number
-  ): Promise<string>;
+  pdfToImage(params: PdfToImageParams): Promise<string>;
 
   /**
    * Renders a page of a PDF to an image, then prints it.
    */
-  printPdf(
-    pdfPath: string,
-    printerWidthDots?: number,
-    page?: number,
-    feedLines?: number
-  ): Promise<void>;
+  printPdf(params: PrintPdfParams): Promise<void>;
 
   /**
    * Renders HTML to a PDF file using an off-screen WebView (no external
    * library) and returns the PDF's absolute path, or null on failure.
    *
-   * @param pageWidthDp layout width in dp the HTML is rendered at - controls
-   *   how large the content looks relative to the page, independent of the
-   *   final printed width (printerWidthDots on printHtml/printPdf downscales it).
-   * @param heightDp if set, forces the page to exactly this height (dp) instead
-   *   of auto-measuring the HTML's real content height.
-   * @param minPageHeightDp ignored if heightDp is set - a height floor (dp) for
-   *   auto-measured content, only relevant for very short/empty HTML.
+   * `pageWidthDp` is the layout width the HTML is rendered at - controls how
+   * large the content looks relative to the page, independent of the final
+   * printed width (`printerWidthDots` on printHtml/printPdf downscales it).
+   * `heightDp`, if set, forces the page to exactly this height (dp) instead
+   * of auto-measuring the HTML's real content height. `minPageHeightDp` is
+   * ignored if `heightDp` is set - a height floor (dp) for auto-measured
+   * content, only relevant for very short/empty HTML.
    */
-  htmlToPdf(
-    html: string,
-    pageWidthDp?: number,
-    heightDp?: number,
-    minPageHeightDp?: number
-  ): Promise<string | null>;
+  htmlToPdf(params: HtmlToPdfParams): Promise<string | null>;
 
   /**
    * Full pipeline: htmlToPdf -> printPdf, in one call. This is how to print
    * content with Bangla or other non-Latin text, or any real HTML/CSS layout.
    */
-  printHtml(
-    html: string,
-    printerWidthDots?: number,
-    pageWidthDp?: number,
-    heightDp?: number,
-    minPageHeightDp?: number
-  ): Promise<boolean>;
+  printHtml(params: PrintHtmlParams): Promise<boolean>;
 }
 
 function getModule(): Spec {

package/src/index.tsx

@@ -1,6 +1,14 @@
 import ReactNativePrinterKit, {
   type BluetoothPrinterDevice,
+  type ConnectPrinterParams,
+  type HtmlToPdfParams,
+  type PdfToImageParams,
   type PrinterImageType,
+  type PrintHtmlParams,
+  type PrintImageBase64Params,
+  type PrintImageParams,
+  type PrintPdfParams,
+  type PrintTextParams,
 } from './NativeReactNativePrinterKit';
 
 /**
@@ -29,8 +37,8 @@ export function getBondedBluetoothPrinters(): BluetoothPrinterDevice[] {
  * survives the app being swiped from Recents, and is reconnected to
  * automatically the next time the app starts.
  */
-export function connectPrinter(address: string): Promise<boolean> {
-  return ReactNativePrinterKit.connectPrinter(address);
+export function connectPrinter(params: ConnectPrinterParams): Promise<boolean> {
+  return ReactNativePrinterKit.connectPrinter(params);
 }
 
 /**
@@ -58,92 +66,68 @@ export function getConnectedPrinter(): Promise<BluetoothPrinterDevice | null> {
  * Print raw text using the printer's built-in font (ASCII only - use
  * printHtml() for Bangla or other non-Latin scripts).
  */
-export function printText(text: string, feedLines?: number): Promise<void> {
-  return ReactNativePrinterKit.printText(text, feedLines);
+export function printText(params: PrintTextParams): Promise<void> {
+  return ReactNativePrinterKit.printText(params);
 }
 
 /**
  * Print an image file as an ESC/POS raster image.
- * @param printerWidthDots 384 for 58mm printers, 576 for 80mm printers (default 384).
+ * `printerWidthDots`: 384 for 58mm printers, 576 for 80mm printers (default 384).
  */
-export function printImage(
-  imagePath: string,
-  printerWidthDots?: number,
-  feedLines?: number
-): Promise<void> {
-  return ReactNativePrinterKit.printImage(imagePath, printerWidthDots, feedLines);
+export function printImage(params: PrintImageParams): Promise<void> {
+  return ReactNativePrinterKit.printImage(params);
 }
 
 /**
  * Print a base64-encoded image as an ESC/POS raster image.
  */
-export function printImageBase64(
-  base64: string,
-  printerWidthDots?: number,
-  feedLines?: number
-): Promise<void> {
-  return ReactNativePrinterKit.printImageBase64(base64, printerWidthDots, feedLines);
+export function printImageBase64(params: PrintImageBase64Params): Promise<void> {
+  return ReactNativePrinterKit.printImageBase64(params);
 }
 
 /**
  * Render a page of a PDF file to an image file. Returns the image path.
  */
-export function pdfToImage(
-  pdfPath: string,
-  imageType?: PrinterImageType,
-  page?: number,
-  targetWidthPx?: number
-): Promise<string> {
-  return ReactNativePrinterKit.pdfToImage(pdfPath, imageType, page, targetWidthPx);
+export function pdfToImage(params: PdfToImageParams): Promise<string> {
+  return ReactNativePrinterKit.pdfToImage(params);
 }
 
 /**
  * Render a page of a PDF to an image, then print it.
  */
-export function printPdf(
-  pdfPath: string,
-  printerWidthDots?: number,
-  page?: number,
-  feedLines?: number
-): Promise<void> {
-  return ReactNativePrinterKit.printPdf(pdfPath, printerWidthDots, page, feedLines);
+export function printPdf(params: PrintPdfParams): Promise<void> {
+  return ReactNativePrinterKit.printPdf(params);
 }
 
 /**
  * Render HTML to a PDF file and return its path, or null on failure. See
  * NativeReactNativePrinterKit's Spec for what pageWidthDp/heightDp/minPageHeightDp control.
  */
-export function htmlToPdf(
-  html: string,
-  pageWidthDp?: number,
-  heightDp?: number,
-  minPageHeightDp?: number
-): Promise<string | null> {
-  return ReactNativePrinterKit.htmlToPdf(html, pageWidthDp, heightDp, minPageHeightDp);
+export function htmlToPdf(params: HtmlToPdfParams): Promise<string | null> {
+  return ReactNativePrinterKit.htmlToPdf(params);
 }
 
 /**
  * Full pipeline: render HTML to PDF, then print it - the way to print Bangla
  * (or other non-Latin) text or any real HTML/CSS layout.
  */
-export function printHtml(
-  html: string,
-  printerWidthDots?: number,
-  pageWidthDp?: number,
-  heightDp?: number,
-  minPageHeightDp?: number
-): Promise<boolean> {
-  return ReactNativePrinterKit.printHtml(
-    html,
-    printerWidthDots,
-    pageWidthDp,
-    heightDp,
-    minPageHeightDp
-  );
+export function printHtml(params: PrintHtmlParams): Promise<boolean> {
+  return ReactNativePrinterKit.printHtml(params);
 }
 
 // Export types
-export type { BluetoothPrinterDevice, PrinterImageType };
+export type {
+  BluetoothPrinterDevice,
+  ConnectPrinterParams,
+  HtmlToPdfParams,
+  PdfToImageParams,
+  PrinterImageType,
+  PrintHtmlParams,
+  PrintImageBase64Params,
+  PrintImageParams,
+  PrintPdfParams,
+  PrintTextParams,
+};
 
 // Export native module
 export default ReactNativePrinterKit;