@rejaul/react-native-printer-kit 0.1.0

package/lib/module/index.js

@@ -0,0 +1,113 @@
+"use strict";
+
+import ReactNativePrinterKit from "./NativeReactNativePrinterKit.js";
+
+/**
+ * Whether Bluetooth permission is already granted (always true below Android 12).
+ */
+export function hasBluetoothPermission() {
+  return ReactNativePrinterKit.hasBluetoothPermission();
+}
+
+/**
+ * Shows the system permission dialog if needed, and resolves with the result.
+ */
+export function requestBluetoothPermission() {
+  return ReactNativePrinterKit.requestBluetoothPermission();
+}
+
+/**
+ * Get all Bluetooth devices already paired (bonded) with this device.
+ */
+export function getBondedBluetoothPrinters() {
+  return ReactNativePrinterKit.getBondedBluetoothPrinters();
+}
+
+/**
+ * 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.
+ */
+export function connectPrinter(address) {
+  return ReactNativePrinterKit.connectPrinter(address);
+}
+
+/**
+ * Disconnect from the current printer.
+ */
+export function disconnectPrinter() {
+  return ReactNativePrinterKit.disconnectPrinter();
+}
+
+/**
+ * Check if a printer is currently connected.
+ */
+export function isConnectedPrinter() {
+  return ReactNativePrinterKit.isConnectedPrinter();
+}
+
+/**
+ * Get the currently connected printer, if any.
+ */
+export function getConnectedPrinter() {
+  return ReactNativePrinterKit.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);
+}
+
+/**
+ * Print an image file as an ESC/POS raster image.
+ * @param printerWidthDots 384 for 58mm printers, 576 for 80mm printers (default 384).
+ */
+export function printImage(imagePath, printerWidthDots, feedLines) {
+  return ReactNativePrinterKit.printImage(imagePath, printerWidthDots, feedLines);
+}
+
+/**
+ * Print a base64-encoded image as an ESC/POS raster image.
+ */
+export function printImageBase64(base64, printerWidthDots, feedLines) {
+  return ReactNativePrinterKit.printImageBase64(base64, printerWidthDots, feedLines);
+}
+
+/**
+ * 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);
+}
+
+/**
+ * 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);
+}
+
+/**
+ * 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);
+}
+
+/**
+ * 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 types
+
+// Export native module
+export default ReactNativePrinterKit;
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +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":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

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

@@ -0,0 +1,85 @@
+import { type TurboModule } from 'react-native';
+export type BluetoothPrinterDevice = {
+    name: string | null;
+    address: string;
+};
+export type PrinterImageType = 'PNG' | 'JPEG';
+export interface Spec extends TurboModule {
+    /**
+     * Whether Bluetooth permission is already granted (always true below Android 12).
+     */
+    hasBluetoothPermission(): boolean;
+    /**
+     * Shows the system permission dialog if needed, and resolves with the result.
+     * A no-op that resolves `true` on Android < 12, where no runtime grant is needed.
+     */
+    requestBluetoothPermission(): Promise<boolean>;
+    /**
+     * Returns all Bluetooth devices already paired (bonded) with this device.
+     * On Android 12+ this requires the BLUETOOTH_CONNECT permission to be granted.
+     */
+    getBondedBluetoothPrinters(): BluetoothPrinterDevice[];
+    /**
+     * Opens a Bluetooth SPP connection to the paired printer at the given address.
+     * Closes any existing printer connection first. Remembers the address so the
+     * app reconnects automatically next time it's opened (see the README's
+     * "Persistent connection" section).
+     */
+    connectPrinter(address: string): Promise<boolean>;
+    /**
+     * Closes the current printer connection, if any, and forgets it for auto-reconnect.
+     */
+    disconnectPrinter(): Promise<void>;
+    /**
+     * Check if a printer connection is currently open.
+     */
+    isConnectedPrinter(): Promise<boolean>;
+    /**
+     * Get the currently connected printer, if any.
+     */
+    getConnectedPrinter(): Promise<BluetoothPrinterDevice | null>;
+    /**
+     * 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>;
+    /**
+     * Print an image file as a dithered ESC/POS raster image.
+     * @param printerWidthDots 384 for 58mm printers, 576 for 80mm printers (default 384).
+     */
+    printImage(imagePath: string, printerWidthDots?: number, feedLines?: number): Promise<void>;
+    /**
+     * Print a base64-encoded image as a dithered ESC/POS raster image.
+     */
+    printImageBase64(base64: string, printerWidthDots?: number, feedLines?: number): 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>;
+    /**
+     * Renders a page of a PDF to an image, then prints it.
+     */
+    printPdf(pdfPath: string, printerWidthDots?: number, page?: number, feedLines?: number): 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.
+     */
+    htmlToPdf(html: string, pageWidthDp?: number, heightDp?: number, minPageHeightDp?: number): 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>;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeReactNativePrinterKit.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,66 @@
+import ReactNativePrinterKit, { type BluetoothPrinterDevice, type PrinterImageType } from './NativeReactNativePrinterKit.js';
+/**
+ * Whether Bluetooth permission is already granted (always true below Android 12).
+ */
+export declare function hasBluetoothPermission(): boolean;
+/**
+ * Shows the system permission dialog if needed, and resolves with the result.
+ */
+export declare function requestBluetoothPermission(): Promise<boolean>;
+/**
+ * Get all Bluetooth devices already paired (bonded) with this device.
+ */
+export declare function getBondedBluetoothPrinters(): 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.
+ */
+export declare function connectPrinter(address: string): Promise<boolean>;
+/**
+ * Disconnect from the current printer.
+ */
+export declare function disconnectPrinter(): Promise<void>;
+/**
+ * Check if a printer is currently connected.
+ */
+export declare function isConnectedPrinter(): Promise<boolean>;
+/**
+ * Get the currently connected printer, if any.
+ */
+export declare 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 declare function printText(text: string, feedLines?: number): Promise<void>;
+/**
+ * Print an image file as an ESC/POS raster image.
+ * @param printerWidthDots 384 for 58mm printers, 576 for 80mm printers (default 384).
+ */
+export declare function printImage(imagePath: string, printerWidthDots?: number, feedLines?: number): 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>;
+/**
+ * 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>;
+/**
+ * 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>;
+/**
+ * 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>;
+/**
+ * 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 default ReactNativePrinterKit;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,133 @@
+{
+  "name": "@rejaul/react-native-printer-kit",
+  "version": "0.1.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",
+  "exports": {
+    ".": {
+      "rejaul-react-native-printer-kit-source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace @rejaul/react-native-printer-kit-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\""
+  },
+  "keywords": [
+    "react-native",
+    "android",
+    "bluetooth",
+    "printer",
+    "pos",
+    "escpos",
+    "thermal-printer",
+    "receipt-printer",
+    "bangla"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DeveloperRejaul/react-native-printer-kit.git"
+  },
+  "author": "Rejaul Karim <devrejaul.official@gmail.com> (https://github.com/DeveloperRejaul)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/DeveloperRejaul/react-native-printer-kit/issues"
+  },
+  "homepage": "https://github.com/DeveloperRejaul/react-native-printer-kit#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.1.0",
+    "@eslint/eslintrc": "^3.3.6",
+    "@eslint/js": "^9.39.5",
+    "@react-native/babel-preset": "0.86.2",
+    "@react-native/eslint-config": "0.86.2",
+    "@types/react": "^19.2.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.5",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.6",
+    "prettier": "^3.9.6",
+    "react": "19.2.3",
+    "react-native": "0.86.2",
+    "react-native-builder-bob": "^0.43.0",
+    "turbo": "^2.10.8",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "ReactNativePrinterKitSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.rejaul.reactnativeprinterkit"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint"
+    ],
+    "version": "0.63.1"
+  }
+}

package/src/NativeReactNativePrinterKit.ts

@@ -0,0 +1,135 @@
+import { TurboModuleRegistry, type TurboModule, Platform } from 'react-native';
+
+export type BluetoothPrinterDevice = {
+  name: string | null;
+  address: string;
+};
+
+export type PrinterImageType = 'PNG' | 'JPEG';
+
+export interface Spec extends TurboModule {
+  /**
+   * Whether Bluetooth permission is already granted (always true below Android 12).
+   */
+  hasBluetoothPermission(): boolean;
+
+  /**
+   * Shows the system permission dialog if needed, and resolves with the result.
+   * A no-op that resolves `true` on Android < 12, where no runtime grant is needed.
+   */
+  requestBluetoothPermission(): Promise<boolean>;
+
+  /**
+   * Returns all Bluetooth devices already paired (bonded) with this device.
+   * On Android 12+ this requires the BLUETOOTH_CONNECT permission to be granted.
+   */
+  getBondedBluetoothPrinters(): BluetoothPrinterDevice[];
+
+  /**
+   * Opens a Bluetooth SPP connection to the paired printer at the given address.
+   * Closes any existing printer connection first. Remembers the address so the
+   * app reconnects automatically next time it's opened (see the README's
+   * "Persistent connection" section).
+   */
+  connectPrinter(address: string): Promise<boolean>;
+
+  /**
+   * Closes the current printer connection, if any, and forgets it for auto-reconnect.
+   */
+  disconnectPrinter(): Promise<void>;
+
+  /**
+   * Check if a printer connection is currently open.
+   */
+  isConnectedPrinter(): Promise<boolean>;
+
+  /**
+   * Get the currently connected printer, if any.
+   */
+  getConnectedPrinter(): Promise<BluetoothPrinterDevice | null>;
+
+  /**
+   * 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>;
+
+  /**
+   * Print an image file as a dithered ESC/POS raster image.
+   * @param printerWidthDots 384 for 58mm printers, 576 for 80mm printers (default 384).
+   */
+  printImage(
+    imagePath: string,
+    printerWidthDots?: number,
+    feedLines?: number
+  ): Promise<void>;
+
+  /**
+   * Print a base64-encoded image as a dithered ESC/POS raster image.
+   */
+  printImageBase64(
+    base64: string,
+    printerWidthDots?: number,
+    feedLines?: number
+  ): 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>;
+
+  /**
+   * Renders a page of a PDF to an image, then prints it.
+   */
+  printPdf(
+    pdfPath: string,
+    printerWidthDots?: number,
+    page?: number,
+    feedLines?: number
+  ): 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.
+   */
+  htmlToPdf(
+    html: string,
+    pageWidthDp?: number,
+    heightDp?: number,
+    minPageHeightDp?: number
+  ): 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>;
+}
+
+function getModule(): Spec {
+  return Platform.OS === 'android'
+    ? TurboModuleRegistry.getEnforcing<Spec>('ReactNativePrinterKit')
+    : ({} as Spec);
+}
+
+export default getModule();