@rejaul/react-native-printer-kit 0.3.3 → 0.4.0

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,39 @@ 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);
+}
+
 /**
  * Print raw text using the printer's built-in font (ASCII only - use
  * printHtml() for Bangla or other non-Latin scripts).
@@ -114,6 +174,19 @@ export function printHtml(params) {
   return ReactNativePrinterKit.printHtml(params);
 }
 
+/**
+ * Opens a file with whatever app the user has installed that can handle its
+ * type (e.g. a PDF viewer) - shows the system's "Open with" chooser if more
+ * than one app matches. Returns false if the file doesn't exist or no app
+ * can open it.
+ */
+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 } 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"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,qBAAqB,MAWrB,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,eAAeN,qBAAqB","ignoreList":[]}
+{"version":3,"names":["ReactNativePrinterKit","isBluetoothEnabled","hasBluetoothPermission","requestBluetoothPermission","getBondedBluetoothPrinters","params","getUsbPrinters","hasUsbPermission","requestUsbPermission","connectPrinter","disconnectPrinter","isConnectedPrinter","getConnectedPrinter","isPrinterReady","getPrinterStatus","printTestPage","saveFile","printText","printImage","printImageBase64","pdfToImage","printPdf","htmlToPdf","printHtml","openFile","FileLocation","PrinterConfidence","PrinterConnectionType","PrinterFilter","PrinterImageType"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

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

@@ -1,11 +1,90 @@
 import { type TurboModule } from 'react-native';
+/** How sure the library is that a paired Bluetooth device is a printer. */
+export type PrinterConfidence = 'CONFIDENT' | 'LIKELY' | 'UNKNOWN';
+/** `ALL` lists every paired device, `LIKELY_PRINTERS` hides non-printers, `STRICT` keeps only certain ones. */
+export type PrinterFilter = 'ALL' | 'LIKELY_PRINTERS' | 'STRICT';
+export type PrinterConnectionType = 'BLUETOOTH' | 'NETWORK' | 'USB';
 export type BluetoothPrinterDevice = {
+    /** `null` for a Wi-Fi/LAN printer. */
     name: string | null;
+    /** Bluetooth MAC, the host for a Wi-Fi/LAN printer, or `"vendorId:productId"` for a USB printer. */
     address: string;
+    confidence: PrinterConfidence;
+    /** Why it got that confidence, e.g. "Printer-like name + SPP service". May be `null`. */
+    reason: string | null;
+};
+export type GetBondedPrintersParams = {
+    filter?: PrinterFilter;
+    /** Extra name fragments to treat as printers, for printers with unusual names. */
+    extraNameKeywords?: string[];
+};
+export type UsbPrinterDevice = {
+    name: string | null;
+    vendorId: number;
+    productId: number;
+    deviceName: string;
+};
+export type UsbDeviceParams = {
+    vendorId: number;
+    productId: number;
 };
 export type PrinterImageType = 'PNG' | 'JPEG';
 export type ConnectPrinterParams = {
+    /** Bluetooth MAC address, or the IP/host for `NETWORK`. Ignored (use `""`) for `USB`. */
     address: string;
+    /** Default `BLUETOOTH`. */
+    type?: PrinterConnectionType;
+    /** `NETWORK` only. Default 9100. */
+    port?: number;
+    /** `NETWORK` connect timeout in ms. Default 5000. */
+    timeoutMs?: number;
+    /** `USB` only, from `getUsbPrinters()`. */
+    vendorId?: number;
+    /** `USB` only, from `getUsbPrinters()`. */
+    productId?: number;
+    /** Title of the ongoing "connected" notification. Default "Printer connected". */
+    notificationTitle?: string;
+    /** Title of the notification shown if the printer drops later. Default "Printer disconnected". */
+    disconnectedNotificationTitle?: string;
+};
+export type PrinterStatusParams = {
+    /** How long to wait for the printer to answer, in ms. Default 800. */
+    timeoutMs?: number;
+};
+/**
+ * `null` means "unknown" - the printer did not answer or does not report that condition. It is NOT "ok".
+ */
+export type PrinterStatus = {
+    connected: boolean;
+    /** `false` means the printer ignored the status request and every field below is `null`. */
+    responded: boolean;
+    online: boolean | null;
+    paperOut: boolean | null;
+    paperNearEnd: boolean | null;
+    coverOpen: boolean | null;
+    hasError: boolean | null;
+};
+export type FileLocation = 'CACHE' | 'APP_FILES' | 'DOWNLOADS' | 'DOCUMENTS' | 'CUSTOM_FOLDER';
+export type SaveFileParams = {
+    sourcePath: string;
+    /** Defaults to the source file's name. */
+    fileName?: string;
+    /** Default `DOWNLOADS`. */
+    location?: FileLocation;
+    /** Required for `CUSTOM_FOLDER`: a `content://` tree Uri string or a directory path. */
+    customFolder?: string;
+    subFolder?: string;
+    /** Guessed from the file extension when not given. */
+    mimeType?: string;
+    overwrite?: boolean;
+    deleteSource?: boolean;
+};
+export type SaveFileResult = {
+    success: boolean;
+    path: string | null;
+    uri: string | null;
+    fileName: string | null;
+    error: string | null;
 };
 export type PrintTextParams = {
     text: string;
@@ -62,6 +141,11 @@ export type PrintHtmlParams = {
     /** See PrintImageParams.bandDelayMs. */
     bandDelayMs?: number;
 };
+export type OpenFileParams = {
+    path: string;
+    /** Inferred from the file extension if not given. */
+    mimeType?: string;
+};
 export interface Spec extends TurboModule {
     /**
      * Whether the device's Bluetooth adapter itself is turned on. Needs no runtime
@@ -80,15 +164,29 @@ export interface Spec extends TurboModule {
      */
     requestBluetoothPermission(): Promise<boolean>;
     /**
-     * Returns all Bluetooth devices already paired (bonded) with this device.
+     * Returns the Bluetooth devices already paired (bonded) with this device, best printer matches first.
      * On Android 12+ this requires the BLUETOOTH_CONNECT permission to be granted.
+     * Pass `{}` for every paired device, or `{ filter: 'LIKELY_PRINTERS' }` to hide non-printers.
+     */
+    getBondedBluetoothPrinters(params: GetBondedPrintersParams): BluetoothPrinterDevice[];
+    /**
+     * USB printers currently plugged in (USB printer class). Needs a phone with USB host (OTG).
+     */
+    getUsbPrinters(): UsbPrinterDevice[];
+    /**
+     * Whether the user already granted this app access to that USB printer.
      */
-    getBondedBluetoothPrinters(): BluetoothPrinterDevice[];
+    hasUsbPermission(params: UsbDeviceParams): boolean;
     /**
-     * Opens a Bluetooth SPP connection to the paired printer at the given address.
-     * Closes any existing printer connection first. Remembers the address so the
+     * Shows the system USB permission dialog and resolves with the user's answer.
+     * Call this before `connectPrinter` with `type: 'USB'`. The grant is lost when the app is reinstalled.
+     */
+    requestUsbPermission(params: UsbDeviceParams): Promise<boolean>;
+    /**
+     * Connects over Bluetooth (default), Wi-Fi/LAN or USB depending on `params.type`.
+     * Closes any existing printer connection first. Remembers the printer so the
      * app reconnects automatically next time it's opened (see the README's
-     * "Persistent connection" section).
+     * "Persistent connection" section). Resolves `false` (does not reject) if it could not connect.
      */
     connectPrinter(params: ConnectPrinterParams): Promise<boolean>;
     /**
@@ -103,6 +201,25 @@ export interface Spec extends TurboModule {
      * Get the currently connected printer, if any.
      */
     getConnectedPrinter(): Promise<BluetoothPrinterDevice | null>;
+    /**
+     * Whether a printer is connected AND currently accepts data (it may be switched off or out of range).
+     * Does not check paper or the cover - use `getPrinterStatus` for that.
+     */
+    isPrinterReady(): Promise<boolean>;
+    /**
+     * Asks the printer for its state (online, paper, cover, error). Many cheap printers do not answer:
+     * then `responded` is `false` and every other field is `null` (unknown, NOT ok).
+     */
+    getPrinterStatus(params: PrinterStatusParams): Promise<PrinterStatus>;
+    /**
+     * Prints a short ASCII test page (connection type, printer, address, time).
+     */
+    printTestPage(): Promise<void>;
+    /**
+     * Copies a finished file (e.g. the PDF from `htmlToPdf`) to cache, app storage, public
+     * Downloads/Documents or a chosen folder. Never rejects: check `result.success`.
+     */
+    saveFile(params: SaveFileParams): Promise<SaveFileResult>;
     /**
      * Print raw text using the printer's built-in font. ASCII only - not
      * suitable for Bangla or other non-Latin scripts, use printHtml() instead.
@@ -144,6 +261,13 @@ export interface Spec extends TurboModule {
      * content with Bangla or other non-Latin text, or any real HTML/CSS layout.
      */
     printHtml(params: PrintHtmlParams): Promise<boolean>;
+    /**
+     * Opens a file with whatever app the user has installed that can handle its
+     * type (e.g. a PDF viewer) - shows the system's "Open with" chooser if more
+     * than one app matches. `mimeType` is inferred from the file extension if
+     * not given. Returns false if the file doesn't exist or no app can open it.
+     */
+    openFile(params: OpenFileParams): 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":"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"}
+{"version":3,"file":"NativeReactNativePrinterKit.d.ts","sourceRoot":"","sources":["../../../src/NativeReactNativePrinterKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAY,MAAM,cAAc,CAAC;AAE/E,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE,+GAA+G;AAC/G,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAEjE,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC;AAEpE,MAAM,MAAM,sBAAsB,GAAG;IACnC,sCAAsC;IACtC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,oGAAoG;IACpG,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,yFAAyF;IACzF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kGAAkG;IAClG,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,4FAA4F;IAC5F,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GACtB,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kKAAkK;IAClK,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;;OAKG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;OAEG;IACH,sBAAsB,IAAI,OAAO,CAAC;IAElC;;;OAGG;IACH,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/C;;;;OAIG;IACH,0BAA0B,CACxB,MAAM,EAAE,uBAAuB,GAC9B,sBAAsB,EAAE,CAAC;IAE5B;;OAEG;IACH,cAAc,IAAI,gBAAgB,EAAE,CAAC;IAErC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;IAEnD;;;OAGG;IACH,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/D;;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,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEtE;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE1D;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE3D;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC;CAC3C;;AAQD,wBAA2B"}

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

@@ -0,0 +1,34 @@
+/** How sure the library is that a paired Bluetooth device is a printer. */
+export declare const PrinterConfidence: {
+    readonly CONFIDENT: "CONFIDENT";
+    readonly LIKELY: "LIKELY";
+    readonly UNKNOWN: "UNKNOWN";
+};
+export type PrinterConfidence = (typeof PrinterConfidence)[keyof typeof PrinterConfidence];
+/** `ALL` lists every paired device, `LIKELY_PRINTERS` hides non-printers, `STRICT` keeps only certain ones. */
+export declare const PrinterFilter: {
+    readonly ALL: "ALL";
+    readonly LIKELY_PRINTERS: "LIKELY_PRINTERS";
+    readonly STRICT: "STRICT";
+};
+export type PrinterFilter = (typeof PrinterFilter)[keyof typeof PrinterFilter];
+export declare const PrinterConnectionType: {
+    readonly BLUETOOTH: "BLUETOOTH";
+    readonly NETWORK: "NETWORK";
+    readonly USB: "USB";
+};
+export type PrinterConnectionType = (typeof PrinterConnectionType)[keyof typeof PrinterConnectionType];
+export declare const PrinterImageType: {
+    readonly PNG: "PNG";
+    readonly JPEG: "JPEG";
+};
+export type PrinterImageType = (typeof PrinterImageType)[keyof typeof PrinterImageType];
+export declare const FileLocation: {
+    readonly CACHE: "CACHE";
+    readonly APP_FILES: "APP_FILES";
+    readonly DOWNLOADS: "DOWNLOADS";
+    readonly DOCUMENTS: "DOCUMENTS";
+    readonly CUSTOM_FOLDER: "CUSTOM_FOLDER";
+};
+export type FileLocation = (typeof FileLocation)[keyof typeof FileLocation];
+//# sourceMappingURL=enums.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../../src/enums.ts"],"names":[],"mappings":"AAaA,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB;;;;CAI6C,CAAC;AAC5E,MAAM,MAAM,iBAAiB,GAC3B,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE7D,+GAA+G;AAC/G,eAAO,MAAM,aAAa;;;;CAIyC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,eAAO,MAAM,qBAAqB;;;;CAOjC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAErE,eAAO,MAAM,gBAAgB;;;CAG4C,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,eAAO,MAAM,YAAY;;;;;;CAMwC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

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

@@ -1,4 +1,4 @@
-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';
+import ReactNativePrinterKit, { type BluetoothPrinterDevice, type ConnectPrinterParams, type GetBondedPrintersParams, type HtmlToPdfParams, type OpenFileParams, type PdfToImageParams, type PrinterStatus, type PrinterStatusParams, type PrintHtmlParams, type PrintImageBase64Params, type PrintImageParams, type PrintPdfParams, type PrintTextParams, type SaveFileParams, type SaveFileResult, type UsbDeviceParams, type UsbPrinterDevice } from './NativeReactNativePrinterKit.js';
 /**
  * Whether the device's Bluetooth adapter itself is turned on. Needs no runtime
  * permission - check this before `hasBluetoothPermission`/`requestBluetoothPermission`.
@@ -13,13 +13,31 @@ export declare function hasBluetoothPermission(): boolean;
  */
 export declare function requestBluetoothPermission(): Promise<boolean>;
 /**
- * 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 declare function getBondedBluetoothPrinters(): BluetoothPrinterDevice[];
+export declare function getBondedBluetoothPrinters(params?: GetBondedPrintersParams): BluetoothPrinterDevice[];
 /**
- * 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 declare function getUsbPrinters(): UsbPrinterDevice[];
+/**
+ * Whether the user already granted this app access to that USB printer.
+ */
+export declare function hasUsbPermission(params: UsbDeviceParams): boolean;
+/**
+ * Shows the system USB permission dialog. Call before `connectPrinter` with
+ * `type: 'USB'`. The grant is lost when the app is reinstalled.
+ */
+export declare function requestUsbPermission(params: UsbDeviceParams): Promise<boolean>;
+/**
+ * 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 declare function connectPrinter(params: ConnectPrinterParams): Promise<boolean>;
 /**
@@ -34,6 +52,27 @@ export declare function isConnectedPrinter(): Promise<boolean>;
  * Get the currently connected printer, if any.
  */
 export declare function getConnectedPrinter(): Promise<BluetoothPrinterDevice | null>;
+/**
+ * Whether a printer is connected and currently accepts data. Does not check
+ * paper or cover - use `getPrinterStatus()`.
+ */
+export declare function isPrinterReady(): Promise<boolean>;
+/**
+ * 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 declare function getPrinterStatus(params?: PrinterStatusParams): Promise<PrinterStatus>;
+/**
+ * Prints a short ASCII test page.
+ */
+export declare function printTestPage(): Promise<void>;
+/**
+ * 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 declare function saveFile(params: SaveFileParams): Promise<SaveFileResult>;
 /**
  * Print raw text using the printer's built-in font (ASCII only - use
  * printHtml() for Bangla or other non-Latin scripts).
@@ -66,6 +105,14 @@ export declare function htmlToPdf(params: HtmlToPdfParams): Promise<string | nul
  * (or other non-Latin) text or any real HTML/CSS layout.
  */
 export declare function printHtml(params: PrintHtmlParams): Promise<boolean>;
-export type { BluetoothPrinterDevice, ConnectPrinterParams, HtmlToPdfParams, PdfToImageParams, PrinterImageType, PrintHtmlParams, PrintImageBase64Params, PrintImageParams, PrintPdfParams, PrintTextParams, };
+/**
+ * Opens a file with whatever app the user has installed that can handle its
+ * type (e.g. a PDF viewer) - shows the system's "Open with" chooser if more
+ * than one app matches. Returns false if the file doesn't exist or no app
+ * can open it.
+ */
+export declare function openFile(params: OpenFileParams): boolean;
+export { FileLocation, PrinterConfidence, PrinterConnectionType, PrinterFilter, PrinterImageType, } from './enums.js';
+export type { BluetoothPrinterDevice, ConnectPrinterParams, GetBondedPrintersParams, HtmlToPdfParams, OpenFileParams, PdfToImageParams, PrinterStatus, PrinterStatusParams, PrintHtmlParams, PrintImageBase64Params, PrintImageParams, PrintPdfParams, PrintTextParams, SaveFileParams, SaveFileResult, UsbDeviceParams, UsbPrinterDevice, };
 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,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;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rejaul/react-native-printer-kit",
-  "version": "0.3.3",
+  "version": "0.4.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",