@posx/capacitor-usb-printer 0.0.1 → 0.0.2

package/README.md

@@ -1,16 +1,16 @@
-# @posx/capacitor-usb-printer
-
-Capacitor plugin for
-
-## Install
-
-```bash
-npm install @posx/capacitor-usb-printer
-npx cap sync
-```
-
-## API
-
+# @posx/capacitor-usb-printer
+
+Capacitor plugin for
+
+## Install
+
+```bash
+npm install @posx/capacitor-usb-printer
+npx cap sync
+```
+
+## API
+
 <docgen-index>
 
 * [`listDevices()`](#listdevices)
@@ -19,10 +19,12 @@ npx cap sync
 * [`disconnect(...)`](#disconnect)
 * [`print(...)`](#print)
 * [`getStatus(...)`](#getstatus)
+* [`addListener('deviceAttached', ...)`](#addlistenerdeviceattached-)
+* [`addListener('deviceDetached', ...)`](#addlistenerdevicedetached-)
 * [Interfaces](#interfaces)
 
-</docgen-index>
-
+</docgen-index>
+
 <docgen-api>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
@@ -108,6 +110,38 @@ getStatus(options: { deviceId: number; }) => Promise<{ connected: boolean; devic
 --------------------
 
 
+### addListener('deviceAttached', ...)
+
+```typescript
+addListener(eventName: 'deviceAttached', listenerFunc: (device: UsbDevice) => void) => Promise<PluginListenerHandle>
+```
+
+| Param              | Type                                                                 |
+| ------------------ | -------------------------------------------------------------------- |
+| **`eventName`**    | <code>'deviceAttached'</code>                                        |
+| **`listenerFunc`** | <code>(device: <a href="#usbdevice">UsbDevice</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener('deviceDetached', ...)
+
+```typescript
+addListener(eventName: 'deviceDetached', listenerFunc: (device: UsbDevice) => void) => Promise<PluginListenerHandle>
+```
+
+| Param              | Type                                                                 |
+| ------------------ | -------------------------------------------------------------------- |
+| **`eventName`**    | <code>'deviceDetached'</code>                                        |
+| **`listenerFunc`** | <code>(device: <a href="#usbdevice">UsbDevice</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -123,4 +157,11 @@ getStatus(options: { deviceId: number; }) => Promise<{ connected: boolean; devic
 | **`productName`**      | <code>string</code> |
 | **`serialNumber`**     | <code>string</code> |
 
-</docgen-api>
+
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
+
+</docgen-api>

package/android/build.gradle

@@ -1,58 +1,58 @@
-ext {
-    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
-    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
-    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
-    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
-}
-
-buildscript {
-    repositories {
-        google()
-        mavenCentral()
-    }
-    dependencies {
-        classpath 'com.android.tools.build:gradle:8.13.0'
-    }
-}
-
-apply plugin: 'com.android.library'
-
-android {
-    namespace = "ai.posx.capacitor.usbprinter"
-    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
-    defaultConfig {
-        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
-        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
-        versionCode 1
-        versionName "1.0"
-        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
-    }
-    buildTypes {
-        release {
-            minifyEnabled false
-            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
-        }
-    }
-    lintOptions {
-        abortOnError = false
-    }
-    compileOptions {
-        sourceCompatibility JavaVersion.VERSION_21
-        targetCompatibility JavaVersion.VERSION_21
-    }
-}
-
-repositories {
-    google()
-    mavenCentral()
-}
-
-
-dependencies {
-    implementation fileTree(dir: 'libs', include: ['*.jar'])
-    implementation project(':capacitor-android')
-    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
-    testImplementation "junit:junit:$junitVersion"
-    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
-    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
-}
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace = "ai.posx.capacitor.usbprinter"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError = false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
-    <uses-feature android:name="android.hardware.usb.host" android:required="false" />
-</manifest>
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-feature android:name="android.hardware.usb.host" android:required="false" />
+</manifest>

package/android/src/main/java/ai/posx/capacitor/usbprinter/UsbPrinter.java

@@ -1,179 +1,179 @@
-package ai.posx.capacitor.usbprinter;
-
-import android.app.PendingIntent;
-import android.content.BroadcastReceiver;
-import android.content.Context;
-import android.content.Intent;
-import android.content.IntentFilter;
-import android.hardware.usb.*;
-import android.os.Build;
-import android.util.Log;
-
-import java.util.ArrayList;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.concurrent.ConcurrentHashMap;
-
-public class UsbPrinter {
-    private static final String TAG = "UsbPrinter";
-    private static final String ACTION_USB_PERMISSION = "ai.posx.capacitor.usbprinter.USB_PERMISSION";
-
-    private final UsbManager usbManager;
-    private final Map<Integer, DeviceConnection> connections = new ConcurrentHashMap<>();
-
-    public UsbPrinter(Context context) {
-        usbManager = (UsbManager) context.getSystemService(Context.USB_SERVICE);
-    }
-
-    public List<UsbDevice> listDevices() {
-        return new ArrayList<>(usbManager.getDeviceList().values());
-    }
-
-    public String getSerialNumber(UsbDevice device) {
-        try {
-            return device.getSerialNumber() != null ? device.getSerialNumber() : "";
-        } catch (SecurityException e) {
-            return "";
-        }
-    }
-
-    public void requestPermission(Context context, UsbDevice device, PermissionCallback callback) {
-        if (usbManager.hasPermission(device)) {
-            callback.onResult(true);
-            return;
-        }
-
-        BroadcastReceiver receiver = new BroadcastReceiver() {
-            @Override
-            public void onReceive(Context ctx, Intent intent) {
-                context.unregisterReceiver(this);
-                boolean granted = intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false);
-                callback.onResult(granted);
-            }
-        };
-
-        IntentFilter filter = new IntentFilter(ACTION_USB_PERMISSION);
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
-            context.registerReceiver(receiver, filter, Context.RECEIVER_NOT_EXPORTED);
-        } else {
-            context.registerReceiver(receiver, filter);
-        }
-
-        int flags = Build.VERSION.SDK_INT >= Build.VERSION_CODES.S ? PendingIntent.FLAG_MUTABLE : 0;
-        PendingIntent pi = PendingIntent.getBroadcast(context, device.getDeviceId(), new Intent(ACTION_USB_PERMISSION), flags);
-        usbManager.requestPermission(device, pi);
-    }
-
-    public boolean connect(UsbDevice device) {
-        int id = device.getDeviceId();
-        if (connections.containsKey(id)) return true;
-
-        UsbEndpoint bulkOut = null;
-        UsbInterface usbInterface = null;
-
-        for (int i = 0; i < device.getInterfaceCount(); i++) {
-            UsbInterface iface = device.getInterface(i);
-            for (int j = 0; j < iface.getEndpointCount(); j++) {
-                UsbEndpoint ep = iface.getEndpoint(j);
-                if (ep.getType() == UsbConstants.USB_ENDPOINT_XFER_BULK && ep.getDirection() == UsbConstants.USB_DIR_OUT) {
-                    usbInterface = iface;
-                    bulkOut = ep;
-                    break;
-                }
-            }
-            if (bulkOut != null) break;
-        }
-
-        if (bulkOut == null) {
-            Log.e(TAG, "No bulk OUT endpoint found for device " + id);
-            return false;
-        }
-
-        UsbDeviceConnection conn = usbManager.openDevice(device);
-        if (conn == null) {
-            Log.e(TAG, "Failed to open device " + id);
-            return false;
-        }
-
-        try {
-            conn.claimInterface(usbInterface, true);
-            String name = device.getProductName() != null ? device.getProductName() : device.getDeviceName();
-            String serial = getSerialNumber(device);
-            connections.put(id, new DeviceConnection(conn, bulkOut, usbInterface, name, serial));
-            return true;
-        } catch (Exception e) {
-            conn.close();
-            Log.e(TAG, "Failed to claim interface for device " + id, e);
-            return false;
-        }
-    }
-
-    public void disconnect(int deviceId) {
-        DeviceConnection dc = connections.remove(deviceId);
-        if (dc != null) dc.close();
-    }
-
-    public void disconnectAll() {
-        for (DeviceConnection dc : connections.values()) {
-            try { dc.close(); } catch (Exception e) { Log.e(TAG, "Failed to close connection", e); }
-        }
-        connections.clear();
-    }
-
-    public boolean print(int deviceId, byte[] data) {
-        DeviceConnection dc = connections.get(deviceId);
-        if (dc == null) return false;
-        int result = dc.connection.bulkTransfer(dc.bulkOut, data, data.length, 10000);
-        if (result < 0) Log.e(TAG, "Transfer failed for device " + deviceId + ": " + result);
-        return result >= 0;
-    }
-
-    public boolean isConnected(int deviceId) {
-        return connections.containsKey(deviceId);
-    }
-
-    public DeviceConnection getConnection(int deviceId) {
-        return connections.get(deviceId);
-    }
-
-    public UsbDevice findDevice(int deviceId) {
-        for (UsbDevice device : usbManager.getDeviceList().values()) {
-            if (device.getDeviceId() == deviceId) return device;
-        }
-        return null;
-    }
-
-    public static byte[] hexToBytes(String hex) {
-        int len = hex.length();
-        byte[] data = new byte[len / 2];
-        for (int i = 0; i < len; i += 2) {
-            data[i / 2] = (byte) ((Character.digit(hex.charAt(i), 16) << 4) + Character.digit(hex.charAt(i + 1), 16));
-        }
-        return data;
-    }
-
-    public interface PermissionCallback {
-        void onResult(boolean granted);
-    }
-
-    public static class DeviceConnection {
-        public final UsbDeviceConnection connection;
-        public final UsbEndpoint bulkOut;
-        public final UsbInterface usbInterface;
-        public final String deviceName;
-        public final String serialNumber;
-
-        DeviceConnection(UsbDeviceConnection connection, UsbEndpoint bulkOut, UsbInterface usbInterface, String deviceName, String serialNumber) {
-            this.connection = connection;
-            this.bulkOut = bulkOut;
-            this.usbInterface = usbInterface;
-            this.deviceName = deviceName;
-            this.serialNumber = serialNumber;
-        }
-
-        void close() {
-            try { connection.releaseInterface(usbInterface); } finally { connection.close(); }
-        }
-    }
-}
+package ai.posx.capacitor.usbprinter;
+
+import android.app.PendingIntent;
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.hardware.usb.*;
+import android.os.Build;
+import android.util.Log;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+public class UsbPrinter {
+    private static final String TAG = "UsbPrinter";
+    private static final String ACTION_USB_PERMISSION = "ai.posx.capacitor.usbprinter.USB_PERMISSION";
+
+    private final UsbManager usbManager;
+    private final Map<Integer, DeviceConnection> connections = new ConcurrentHashMap<>();
+    private final Map<Integer, BroadcastReceiver> pendingPermissions = new ConcurrentHashMap<>();
+
+    public UsbPrinter(Context context) {
+        usbManager = (UsbManager) context.getSystemService(Context.USB_SERVICE);
+    }
+
+    public List<UsbDevice> listDevices() {
+        return new ArrayList<>(usbManager.getDeviceList().values());
+    }
+
+    public String getSerialNumber(UsbDevice device) {
+        try {
+            return device.getSerialNumber() != null ? device.getSerialNumber() : "";
+        } catch (SecurityException e) {
+            return "";
+        }
+    }
+
+    public void requestPermission(Context context, UsbDevice device, PermissionCallback callback) {
+        if (usbManager.hasPermission(device)) {
+            callback.onResult(true);
+            return;
+        }
+        int deviceId = device.getDeviceId();
+        BroadcastReceiver receiver = new BroadcastReceiver() {
+            @Override
+            public void onReceive(Context ctx, Intent intent) {
+                pendingPermissions.remove(deviceId);
+                context.unregisterReceiver(this);
+                callback.onResult(intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false));
+            }
+        };
+        pendingPermissions.put(deviceId, receiver);
+        IntentFilter filter = new IntentFilter(ACTION_USB_PERMISSION);
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU)
+            context.registerReceiver(receiver, filter, Context.RECEIVER_NOT_EXPORTED);
+        else
+            context.registerReceiver(receiver, filter);
+        int flags = Build.VERSION.SDK_INT >= Build.VERSION_CODES.S ? PendingIntent.FLAG_MUTABLE : 0;
+        PendingIntent pi = PendingIntent.getBroadcast(context, deviceId, new Intent(ACTION_USB_PERMISSION), flags);
+        usbManager.requestPermission(device, pi);
+    }
+
+    public void releasePermissionReceivers(Context context) {
+        for (BroadcastReceiver r : pendingPermissions.values())
+            try { context.unregisterReceiver(r); } catch (Exception ignored) {}
+        pendingPermissions.clear();
+    }
+
+    public boolean connect(UsbDevice device) {
+        int id = device.getDeviceId();
+        if (connections.containsKey(id)) return true;
+
+        UsbEndpoint bulkOut = null;
+        UsbInterface usbInterface = null;
+
+        for (int i = 0; i < device.getInterfaceCount(); i++) {
+            UsbInterface iface = device.getInterface(i);
+            for (int j = 0; j < iface.getEndpointCount(); j++) {
+                UsbEndpoint ep = iface.getEndpoint(j);
+                if (ep.getType() == UsbConstants.USB_ENDPOINT_XFER_BULK && ep.getDirection() == UsbConstants.USB_DIR_OUT) {
+                    usbInterface = iface;
+                    bulkOut = ep;
+                    break;
+                }
+            }
+            if (bulkOut != null) break;
+        }
+
+        if (bulkOut == null) {
+            Log.e(TAG, "No bulk OUT endpoint found for device " + id);
+            return false;
+        }
+
+        UsbDeviceConnection conn = usbManager.openDevice(device);
+        if (conn == null) {
+            Log.e(TAG, "Failed to open device " + id);
+            return false;
+        }
+
+        try {
+            conn.claimInterface(usbInterface, true);
+            String name = device.getProductName() != null ? device.getProductName() : device.getDeviceName();
+            String serial = getSerialNumber(device);
+            connections.put(id, new DeviceConnection(conn, bulkOut, usbInterface, name, serial));
+            return true;
+        } catch (Exception e) {
+            conn.close();
+            Log.e(TAG, "Failed to claim interface for device " + id, e);
+            return false;
+        }
+    }
+
+    public void disconnect(int deviceId) {
+        DeviceConnection dc = connections.remove(deviceId);
+        if (dc != null) dc.close();
+    }
+
+    public void disconnectAll() {
+        for (DeviceConnection dc : connections.values()) {
+            try { dc.close(); } catch (Exception e) { Log.e(TAG, "Failed to close connection", e); }
+        }
+        connections.clear();
+    }
+
+    public boolean print(int deviceId, byte[] data) {
+        DeviceConnection dc = connections.get(deviceId);
+        if (dc == null) return false;
+        int result = dc.connection.bulkTransfer(dc.bulkOut, data, data.length, 10000);
+        if (result < 0) Log.e(TAG, "Transfer failed for device " + deviceId + ": " + result);
+        return result >= 0;
+    }
+
+    public DeviceConnection getConnection(int deviceId) {
+        return connections.get(deviceId);
+    }
+
+    public UsbDevice findDevice(int deviceId) {
+        for (UsbDevice device : usbManager.getDeviceList().values()) {
+            if (device.getDeviceId() == deviceId) return device;
+        }
+        return null;
+    }
+
+    public static byte[] hexToBytes(String hex) {
+        if (hex.length() % 2 != 0) throw new IllegalArgumentException("Hex string length must be even");
+        int len = hex.length();
+        byte[] data = new byte[len / 2];
+        for (int i = 0; i < len; i += 2)
+            data[i / 2] = (byte) ((Character.digit(hex.charAt(i), 16) << 4) + Character.digit(hex.charAt(i + 1), 16));
+        return data;
+    }
+
+    public interface PermissionCallback {
+        void onResult(boolean granted);
+    }
+
+    public static class DeviceConnection {
+        public final UsbDeviceConnection connection;
+        public final UsbEndpoint bulkOut;
+        public final UsbInterface usbInterface;
+        public final String deviceName;
+        public final String serialNumber;
+
+        DeviceConnection(UsbDeviceConnection connection, UsbEndpoint bulkOut, UsbInterface usbInterface, String deviceName, String serialNumber) {
+            this.connection = connection;
+            this.bulkOut = bulkOut;
+            this.usbInterface = usbInterface;
+            this.deviceName = deviceName;
+            this.serialNumber = serialNumber;
+        }
+
+        void close() {
+            try { connection.releaseInterface(usbInterface); } finally { connection.close(); }
+        }
+    }
+}

package/android/src/main/java/ai/posx/capacitor/usbprinter/UsbPrinterPlugin.java

@@ -1,138 +1,179 @@
-package ai.posx.capacitor.usbprinter;
-
-import android.hardware.usb.UsbDevice;
-
-import com.getcapacitor.JSArray;
-import com.getcapacitor.JSObject;
-import com.getcapacitor.Plugin;
-import com.getcapacitor.PluginCall;
-import com.getcapacitor.PluginMethod;
-import com.getcapacitor.annotation.CapacitorPlugin;
-
-import java.util.List;
-
-@CapacitorPlugin(name = "UsbPrinter")
-public class UsbPrinterPlugin extends Plugin {
-
-    private UsbPrinter implementation;
-
-    @Override
-    public void load() {
-        implementation = new UsbPrinter(getContext());
-    }
-
-    @Override
-    protected void handleOnDestroy() {
-        implementation.disconnectAll();
-        super.handleOnDestroy();
-    }
-
-    @PluginMethod
-    public void listDevices(PluginCall call) {
-        try {
-            List<UsbDevice> devices = implementation.listDevices();
-            JSArray arr = new JSArray();
-            for (UsbDevice device : devices) {
-                JSObject d = new JSObject();
-                d.put("deviceId", device.getDeviceId());
-                d.put("vendorId", device.getVendorId());
-                d.put("productId", device.getProductId());
-                d.put("deviceName", device.getDeviceName());
-                d.put("manufacturerName", device.getManufacturerName() != null ? device.getManufacturerName() : "");
-                d.put("productName", device.getProductName() != null ? device.getProductName() : "");
-                d.put("serialNumber", implementation.getSerialNumber(device));
-                arr.put(d);
-            }
-            JSObject result = new JSObject();
-            result.put("devices", arr);
-            call.resolve(result);
-        } catch (Exception e) {
-            call.reject("Failed to list devices", e);
-        }
-    }
-
-    @PluginMethod
-    public void requestPermission(PluginCall call) {
-        try {
-            int deviceId = call.getInt("deviceId", -1);
-            UsbDevice device = implementation.findDevice(deviceId);
-            if (device == null) {
-                call.reject("Device not found");
-                return;
-            }
-            implementation.requestPermission(getContext(), device, granted -> {
-                JSObject result = new JSObject();
-                result.put("granted", granted);
-                call.resolve(result);
-            });
-        } catch (Exception e) {
-            call.reject("Failed to request permission", e);
-        }
-    }
-
-    @PluginMethod
-    public void connect(PluginCall call) {
-        try {
-            int deviceId = call.getInt("deviceId", -1);
-            UsbDevice device = implementation.findDevice(deviceId);
-            if (device == null) {
-                call.reject("Device not found");
-                return;
-            }
-            boolean connected = implementation.connect(device);
-            if (!connected) {
-                call.reject("Failed to connect");
-                return;
-            }
-            JSObject result = new JSObject();
-            result.put("connected", true);
-            call.resolve(result);
-        } catch (Exception e) {
-            call.reject("Failed to connect", e);
-        }
-    }
-
-    @PluginMethod
-    public void disconnect(PluginCall call) {
-        try {
-            int deviceId = call.getInt("deviceId", -1);
-            implementation.disconnect(deviceId);
-            call.resolve();
-        } catch (Exception e) {
-            call.reject("Failed to disconnect", e);
-        }
-    }
-
-    @PluginMethod
-    public void print(PluginCall call) {
-        try {
-            int deviceId = call.getInt("deviceId", -1);
-            String hex = call.getString("data", "");
-            if (hex.isEmpty()) {
-                call.reject("No data");
-                return;
-            }
-            byte[] bytes = UsbPrinter.hexToBytes(hex);
-            boolean success = implementation.print(deviceId, bytes);
-            if (success) call.resolve();
-            else call.reject("Not connected or transfer failed");
-        } catch (Exception e) {
-            call.reject("Failed to print", e);
-        }
-    }
-
-    @PluginMethod
-    public void getStatus(PluginCall call) {
-        try {
-            int deviceId = call.getInt("deviceId", -1);
-            UsbPrinter.DeviceConnection dc = implementation.getConnection(deviceId);
-            JSObject result = new JSObject();
-            result.put("connected", dc != null);
-            result.put("deviceName", dc != null ? dc.deviceName : "");
-            result.put("serialNumber", dc != null ? dc.serialNumber : "");
-            call.resolve(result);
-        } catch (Exception e) {
-            call.reject("Failed to get status", e);
-        }
-    }
-}
+package ai.posx.capacitor.usbprinter;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.hardware.usb.UsbDevice;
+import android.hardware.usb.UsbManager;
+import android.os.Build;
+
+import com.getcapacitor.JSArray;
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+
+import java.util.List;
+
+@CapacitorPlugin(name = "UsbPrinter")
+public class UsbPrinterPlugin extends Plugin {
+
+    private UsbPrinter implementation;
+    private BroadcastReceiver usbReceiver;
+
+    @Override
+    public void load() {
+        implementation = new UsbPrinter(getContext());
+        usbReceiver = new BroadcastReceiver() {
+            @Override
+            public void onReceive(Context ctx, Intent intent) {
+                UsbDevice device = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);
+                if (device == null) return;
+                JSObject data = deviceToJs(device);
+                if (UsbManager.ACTION_USB_DEVICE_DETACHED.equals(intent.getAction())) {
+                    UsbPrinter.DeviceConnection dc = implementation.getConnection(device.getDeviceId());
+                    data.put("serialNumber", dc != null ? dc.serialNumber : implementation.getSerialNumber(device));
+                    implementation.disconnect(device.getDeviceId());
+                    notifyListeners("deviceDetached", data);
+                } else {
+                    data.put("serialNumber", implementation.getSerialNumber(device));
+                    notifyListeners("deviceAttached", data);
+                }
+            }
+        };
+        IntentFilter filter = new IntentFilter();
+        filter.addAction(UsbManager.ACTION_USB_DEVICE_ATTACHED);
+        filter.addAction(UsbManager.ACTION_USB_DEVICE_DETACHED);
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU)
+            getContext().registerReceiver(usbReceiver, filter, Context.RECEIVER_NOT_EXPORTED);
+        else
+            getContext().registerReceiver(usbReceiver, filter);
+    }
+
+    @Override
+    protected void handleOnDestroy() {
+        if (usbReceiver != null) {
+            getContext().unregisterReceiver(usbReceiver);
+            usbReceiver = null;
+        }
+        implementation.releasePermissionReceivers(getContext());
+        implementation.disconnectAll();
+        super.handleOnDestroy();
+    }
+
+    private JSObject deviceToJs(UsbDevice device) {
+        JSObject d = new JSObject();
+        d.put("deviceId", device.getDeviceId());
+        d.put("vendorId", device.getVendorId());
+        d.put("productId", device.getProductId());
+        d.put("deviceName", device.getDeviceName());
+        d.put("manufacturerName", device.getManufacturerName() != null ? device.getManufacturerName() : "");
+        d.put("productName", device.getProductName() != null ? device.getProductName() : "");
+        return d;
+    }
+
+    @PluginMethod
+    public void listDevices(PluginCall call) {
+        try {
+            List<UsbDevice> devices = implementation.listDevices();
+            JSArray arr = new JSArray();
+            for (UsbDevice device : devices) {
+                JSObject d = deviceToJs(device);
+                d.put("serialNumber", implementation.getSerialNumber(device));
+                arr.put(d);
+            }
+            JSObject result = new JSObject();
+            result.put("devices", arr);
+            call.resolve(result);
+        } catch (Exception e) {
+            call.reject("Failed to list devices", e);
+        }
+    }
+
+    @PluginMethod
+    public void requestPermission(PluginCall call) {
+        try {
+            int deviceId = call.getInt("deviceId", -1);
+            UsbDevice device = implementation.findDevice(deviceId);
+            if (device == null) {
+                call.reject("Device not found");
+                return;
+            }
+            implementation.requestPermission(getContext(), device, granted -> {
+                JSObject result = new JSObject();
+                result.put("granted", granted);
+                call.resolve(result);
+            });
+        } catch (Exception e) {
+            call.reject("Failed to request permission", e);
+        }
+    }
+
+    @PluginMethod
+    public void connect(PluginCall call) {
+        try {
+            int deviceId = call.getInt("deviceId", -1);
+            UsbDevice device = implementation.findDevice(deviceId);
+            if (device == null) {
+                call.reject("Device not found");
+                return;
+            }
+            boolean connected = implementation.connect(device);
+            if (!connected) {
+                call.reject("Failed to connect");
+                return;
+            }
+            JSObject result = new JSObject();
+            result.put("connected", true);
+            call.resolve(result);
+        } catch (Exception e) {
+            call.reject("Failed to connect", e);
+        }
+    }
+
+    @PluginMethod
+    public void disconnect(PluginCall call) {
+        try {
+            int deviceId = call.getInt("deviceId", -1);
+            implementation.disconnect(deviceId);
+            call.resolve();
+        } catch (Exception e) {
+            call.reject("Failed to disconnect", e);
+        }
+    }
+
+    @PluginMethod
+    public void print(PluginCall call) {
+        try {
+            int deviceId = call.getInt("deviceId", -1);
+            String hex = call.getString("data", "");
+            if (hex.isEmpty()) {
+                call.reject("No data");
+                return;
+            }
+            byte[] bytes = UsbPrinter.hexToBytes(hex);
+            boolean success = implementation.print(deviceId, bytes);
+            if (success) call.resolve();
+            else call.reject("Not connected or transfer failed");
+        } catch (Exception e) {
+            call.reject("Failed to print", e);
+        }
+    }
+
+    @PluginMethod
+    public void getStatus(PluginCall call) {
+        try {
+            int deviceId = call.getInt("deviceId", -1);
+            UsbPrinter.DeviceConnection dc = implementation.getConnection(deviceId);
+            JSObject result = new JSObject();
+            result.put("connected", dc != null);
+            result.put("deviceName", dc != null ? dc.deviceName : "");
+            result.put("serialNumber", dc != null ? dc.serialNumber : "");
+            call.resolve(result);
+        } catch (Exception e) {
+            call.reject("Failed to get status", e);
+        }
+    }
+}

package/android/src/main/res/xml/usb_device_filter.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
-<resources>
-    <usb-device />
-</resources>
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <usb-device />
+</resources>

package/dist/docs.json

@@ -96,6 +96,54 @@
         "docs": "",
         "complexTypes": [],
         "slug": "getstatus"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'deviceAttached', listenerFunc: (device: UsbDevice) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'deviceAttached'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(device: UsbDevice) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "UsbDevice"
+        ],
+        "slug": "addlistenerdeviceattached-"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'deviceDetached', listenerFunc: (device: UsbDevice) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'deviceDetached'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(device: UsbDevice) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "UsbDevice"
+        ],
+        "slug": "addlistenerdevicedetached-"
       }
     ],
     "properties": []
@@ -158,6 +206,22 @@
           "type": "string"
         }
       ]
+    },
+    {
+      "name": "PluginListenerHandle",
+      "slug": "pluginlistenerhandle",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "remove",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "() => Promise<void>"
+        }
+      ]
     }
   ],
   "enums": [],

package/dist/esm/definitions.d.ts

@@ -1,3 +1,4 @@
+import type { PluginListenerHandle } from '@capacitor/core';
 export interface UsbDevice {
     deviceId: number;
     vendorId: number;
@@ -35,4 +36,6 @@ export interface UsbPrinterPlugin {
         deviceName: string;
         serialNumber: string;
     }>;
+    addListener(eventName: 'deviceAttached', listenerFunc: (device: UsbDevice) => void): Promise<PluginListenerHandle>;
+    addListener(eventName: 'deviceDetached', listenerFunc: (device: UsbDevice) => void): Promise<PluginListenerHandle>;
 }

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface UsbDevice {\n  deviceId: number;\n  vendorId: number;\n  productId: number;\n  deviceName: string;\n  manufacturerName: string;\n  productName: string;\n  serialNumber: string;\n}\n\nexport interface UsbPrinterPlugin {\n  listDevices(): Promise<{ devices: UsbDevice[] }>;\n  requestPermission(options: { deviceId: number }): Promise<{ granted: boolean }>;\n  connect(options: { deviceId: number }): Promise<{ connected: boolean }>;\n  disconnect(options: { deviceId: number }): Promise<void>;\n  print(options: { deviceId: number; data: string }): Promise<void>;\n  getStatus(options: { deviceId: number }): Promise<{ connected: boolean; deviceName: string; serialNumber: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\r\n\r\nexport interface UsbDevice {\r\n  deviceId: number;\r\n  vendorId: number;\r\n  productId: number;\r\n  deviceName: string;\r\n  manufacturerName: string;\r\n  productName: string;\r\n  serialNumber: string;\r\n}\r\n\r\nexport interface UsbPrinterPlugin {\r\n  listDevices(): Promise<{ devices: UsbDevice[] }>;\r\n  requestPermission(options: { deviceId: number }): Promise<{ granted: boolean }>;\r\n  connect(options: { deviceId: number }): Promise<{ connected: boolean }>;\r\n  disconnect(options: { deviceId: number }): Promise<void>;\r\n  print(options: { deviceId: number; data: string }): Promise<void>;\r\n  getStatus(options: { deviceId: number }): Promise<{ connected: boolean; deviceName: string; serialNumber: string }>;\r\n  addListener(eventName: 'deviceAttached', listenerFunc: (device: UsbDevice) => void): Promise<PluginListenerHandle>;\r\n  addListener(eventName: 'deviceDetached', listenerFunc: (device: UsbDevice) => void): Promise<PluginListenerHandle>;\r\n}\r\n"]}

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,UAAU,GAAG,cAAc,CAAmB,YAAY,EAAE;IAChE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;CAC9D,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { UsbPrinterPlugin } from './definitions';\n\nconst UsbPrinter = registerPlugin<UsbPrinterPlugin>('UsbPrinter', {\n  web: () => import('./web').then((m) => new m.UsbPrinterWeb()),\n});\n\nexport * from './definitions';\nexport { UsbPrinter };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,UAAU,GAAG,cAAc,CAAmB,YAAY,EAAE;IAChE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;CAC9D,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\r\n\r\nimport type { UsbPrinterPlugin } from './definitions';\r\n\r\nconst UsbPrinter = registerPlugin<UsbPrinterPlugin>('UsbPrinter', {\r\n  web: () => import('./web').then((m) => new m.UsbPrinterWeb()),\r\n});\r\n\r\nexport * from './definitions';\r\nexport { UsbPrinter };\r\n"]}

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,KAAK,CAAC,WAAW;QACf,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAChE,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { UsbPrinterPlugin } from './definitions';\n\nexport class UsbPrinterWeb extends WebPlugin implements UsbPrinterPlugin {\n  async listDevices(): Promise<{ devices: never[] }> {\n    console.warn('USB Printer is only available on Android devices');\n    return { devices: [] };\n  }\n\n  async requestPermission(): Promise<{ granted: boolean }> {\n    console.warn('USB Printer is only available on Android devices');\n    return { granted: false };\n  }\n\n  async connect(): Promise<{ connected: boolean }> {\n    console.warn('USB Printer is only available on Android devices');\n    return { connected: false };\n  }\n\n  async disconnect(): Promise<void> {\n    console.warn('USB Printer is only available on Android devices');\n  }\n\n  async print(): Promise<void> {\n    console.warn('USB Printer is only available on Android devices');\n  }\n\n  async getStatus(): Promise<{ connected: boolean; deviceName: string; serialNumber: string }> {\n    console.warn('USB Printer is only available on Android devices');\n    return { connected: false, deviceName: '', serialNumber: '' };\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,KAAK,CAAC,WAAW;QACf,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAChE,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\r\n\r\nimport type { UsbPrinterPlugin } from './definitions';\r\n\r\nexport class UsbPrinterWeb extends WebPlugin implements UsbPrinterPlugin {\r\n  async listDevices(): Promise<{ devices: never[] }> {\r\n    console.warn('USB Printer is only available on Android devices');\r\n    return { devices: [] };\r\n  }\r\n\r\n  async requestPermission(): Promise<{ granted: boolean }> {\r\n    console.warn('USB Printer is only available on Android devices');\r\n    return { granted: false };\r\n  }\r\n\r\n  async connect(): Promise<{ connected: boolean }> {\r\n    console.warn('USB Printer is only available on Android devices');\r\n    return { connected: false };\r\n  }\r\n\r\n  async disconnect(): Promise<void> {\r\n    console.warn('USB Printer is only available on Android devices');\r\n  }\r\n\r\n  async print(): Promise<void> {\r\n    console.warn('USB Printer is only available on Android devices');\r\n  }\r\n\r\n  async getStatus(): Promise<{ connected: boolean; deviceName: string; serialNumber: string }> {\r\n    console.warn('USB Printer is only available on Android devices');\r\n    return { connected: false, deviceName: '', serialNumber: '' };\r\n  }\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posx/capacitor-usb-printer",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Capacitor plugin for USB ESC/POS thermal printer via Android USB Host API",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -13,24 +13,34 @@
   ],
   "author": "posx team",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/niceit/capacitor-usb-printer.git"
-  },
-  "bugs": {
-    "url": "https://github.com/niceit/capacitor-usb-printer/issues"
-  },
   "keywords": [
     "capacitor",
     "plugin",
     "native"
   ],
+  "scripts": {
+    "verify": "npm run verify:android && npm run verify:web",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "docgen": "docgen --api UsbPrinterPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "p": "npm run build && npm publish",
+    "bump": "bumpp patch --commit --tag --push --yes",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
   "devDependencies": {
     "@capacitor/android": "^5.7.8",
     "@capacitor/core": "^5.7.8",
     "@capacitor/docgen": "^0.3.1",
     "@ionic/eslint-config": "^0.4.0",
     "@ionic/prettier-config": "^4.0.0",
+    "bumpp": "10.4.1",
     "eslint": "^8.57.1",
     "prettier": "^3.6.2",
     "prettier-plugin-java": "^2.7.7",
@@ -49,20 +59,5 @@
     "android": {
       "src": "android"
     }
-  },
-  "scripts": {
-    "verify": "npm run verify:android && npm run verify:web",
-    "verify:android": "cd android && ./gradlew clean build test && cd ..",
-    "verify:web": "npm run build",
-    "lint": "npm run eslint && npm run prettier -- --check",
-    "fmt": "npm run eslint -- --fix && npm run prettier -- --write",
-    "eslint": "eslint . --ext ts",
-    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
-    "docgen": "docgen --api UsbPrinterPlugin --output-readme README.md --output-json dist/docs.json",
-    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
-    "clean": "rimraf ./dist",
-    "p": "npm run build && npm publish",
-    "bump": "npm version patch",
-    "watch": "tsc --watch"
   }
-}
+}