@nitra/zebra 7.0.0 → 7.0.1

package/README.md

@@ -18,19 +18,21 @@ npx cap sync
 
 ## API
 
-### `print(value: string): Promise<boolean>`
+### `print(zpl: string | PrintOptions): Promise<{ sent?: boolean }>`
 
 Відправляє ZPL-команду на принтер Zebra.
 
-| Платформа   | Поведінка                                                                                                       |
-| ----------- | --------------------------------------------------------------------------------------------------------------- |
-| **Web**     | Запитує порт через Web Serial API, відкриває з'єднання (9600 baud) і відправляє рядок ZPL на вибраний пристрій. |
-| **iOS**     | Нативна реалізація (через плагін).                                                                              |
-| **Android** | Нативна реалізація (через плагін).                                                                              |
+| Платформа   | Поведінка                                                                                                                                                           |
+| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Web**     | Запитує порт через Web Serial API, відкриває з'єднання (9600 baud) і відправляє рядок ZPL на вибраний пристрій.                                                     |
+| **iOS**     | Нативна реалізація (через плагін).                                                                                                                                  |
+| **Android** | Відправка ZPL по **Bluetooth Classic (SPP)**. Потрібно спочатку викликати `setPrinterAddress({ address: "MAC" })` або передати `address` (Bluetooth MAC) у виклику. |
 
-**Параметри:**
+**Параметри (об'єкт для Android):**
 
-- `value` — рядок з ZPL-командами (наприклад, `^XA^FO50,50^A0N,28,28^FDHello^FS^XZ`).
+- `zpl` — рядок ZPL-команд (наприклад, `^XA^FO50,50^A0N,28,28^FDHello^FS^XZ`).
+- `address` — (Android, опційно) Bluetooth MAC-адреса принтера (наприклад `00:11:22:33:44:55`); якщо не передано, використовується збережена через `setPrinterAddress()`.
+- `port` — ігнорується (для сумісності API).
 
 **Приклад:**
 
@@ -41,6 +43,33 @@ const zpl = "^XA^FO50,50^A0N,28,28^FDHello World^FS^XZ";
 await Zebra.print(zpl);
 ```
 
+### `setPrinterAddress(options: { address: string, port?: number }): Promise<{ address }>` (Android)
+
+Зберігає Bluetooth MAC-адресу принтера Zebra для подальших викликів `print(zpl)` без передачі адреси.
+
+**Параметри:**
+
+- `address` — Bluetooth MAC-адреса принтера (наприклад `00:11:22:33:44:55`).
+- `port` — ігнорується (для сумісності API).
+
+**Приклад (Android):**
+
+```javascript
+await Zebra.setPrinterAddress({ address: "00:11:22:33:44:55" });
+await Zebra.print(zpl);
+```
+
+### `getPairedDevices(): Promise<{ devices: { address: string, name: string }[] }>` (Android)
+
+Повертає список спарених Bluetooth-пристроїв. Корисно для вибору принтера в налаштуваннях. На Android 12+ потрібен дозвіл **BLUETOOTH_CONNECT** (запитати до виклику).
+
+**Приклад (Android):**
+
+```javascript
+const { devices } = await Zebra.getPairedDevices();
+// devices: [{ address: "00:11:22:33:44:55", name: "Zebra ZD420" }, ...]
+```
+
 ## Веб (Web Serial API)
 
 На веб-платформі плагін використовує Web Serial API:
@@ -51,6 +80,17 @@ await Zebra.print(zpl);
 
 **Обмеження:** Web Serial API працює лише в підтримуваних браузерах (Chrome, Edge, Opera) і зазвичай лише через HTTPS або localhost.
 
+## Android (Bluetooth Classic)
+
+На Android плагін відправляє ZPL на принтер Zebra по **Bluetooth Classic** (профіль SPP):
+
+1. Спаріть принтер у налаштуваннях Bluetooth пристрою.
+2. Викличте `getPairedDevices()` щоб отримати список пристроїв (опційно) або введіть MAC-адресу вручну.
+3. Викличте `setPrinterAddress({ address: "MAC_ПРИНТЕРА" })` один раз (наприклад, з налаштувань) або передайте `address` у виклику `print({ zpl, address })`.
+4. Викличте `print(zpl)` або `print({ zpl })` — ZPL буде відправлено на принтер по Bluetooth.
+
+Потрібні дозволи **BLUETOOTH**, **BLUETOOTH_ADMIN** (до API 30), **BLUETOOTH_CONNECT** (API 31+). На Android 12+ дозвіл `BLUETOOTH_CONNECT` потрібно запитати під час виконання (наприклад перед `getPairedDevices()` або `print()`).
+
 ## Структура пакету
 
 - `dist/` — зібраний JS-плагін (rolldown)

package/android/src/main/AndroidManifest.xml

@@ -1,2 +1,5 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
+    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
 </manifest>

package/android/src/main/java/dev/nitra/zebra/Zebra.java

@@ -1,11 +1,227 @@
 package dev.nitra.zebra;
 
+import android.Manifest;
+import android.bluetooth.BluetoothAdapter;
+import android.bluetooth.BluetoothDevice;
+import android.bluetooth.BluetoothSocket;
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.content.pm.PackageManager;
+import android.os.Build;
+
+import androidx.core.app.ActivityCompat;
+
 import com.getcapacitor.Logger;
 
+import java.io.IOException;
+import java.io.OutputStream;
+import java.nio.charset.StandardCharsets;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Set;
+import java.util.UUID;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+/**
+ * Реалізація друку ZPL на принтері Zebra через Bluetooth Classic (SPP).
+ * Зберігає MAC-адресу принтера та відправляє ZPL по SPP.
+ */
 public class Zebra {
 
-    public String echo(String value) {
-        Logger.info("Echo", value);
-        return value;
+    /** UUID профілю SPP (Serial Port Profile) для Bluetooth Classic. */
+    private static final UUID SPP_UUID = UUID.fromString("00001101-0000-1000-8000-00805F9B34FB");
+
+    private static final String PREFS_NAME = "ZebraPrinter";
+    private static final String KEY_ADDRESS = "printer_address";
+
+    private final ExecutorService executor = Executors.newSingleThreadExecutor();
+
+    /**
+     * Зберігає Bluetooth MAC-адресу принтера для подальшого використання в print().
+     *
+     * @param address MAC-адреса пристрою (наприклад "00:11:22:33:44:55")
+     */
+    public void setPrinterAddress(Context context, String address, int port) {
+        SharedPreferences prefs = context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
+        String normalized = address != null ? address.trim() : "";
+        prefs.edit().putString(KEY_ADDRESS, normalized).apply();
+        Logger.info("Zebra", "Printer address saved: " + normalized);
+    }
+
+    /**
+     * Повертає збережену MAC-адресу принтера або null.
+     */
+    public String getStoredAddress(Context context) {
+        SharedPreferences prefs = context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
+        return prefs.getString(KEY_ADDRESS, null);
+    }
+
+    /**
+     * Повертає список спарених Bluetooth-пристроїв (для вибору принтера).
+     */
+    public List<BluetoothDeviceInfo> getPairedDevices(Context context) {
+        List<BluetoothDeviceInfo> result = new ArrayList<>();
+        BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
+        if (adapter == null) {
+            return result;
+        }
+        if (!adapter.isEnabled()) {
+            return result;
+        }
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S && ActivityCompat.checkSelfPermission(context, Manifest.permission.BLUETOOTH_CONNECT) != PackageManager.PERMISSION_GRANTED) {
+            return result;
+        }
+        Set<BluetoothDevice> paired = adapter.getBondedDevices();
+        if (paired == null) {
+            return result;
+        }
+        for (BluetoothDevice device : paired) {
+            String name = device.getName();
+            String address = device.getAddress();
+            if (address != null && !address.isEmpty()) {
+                result.add(new BluetoothDeviceInfo(
+                        address,
+                        name != null ? name : ""
+                ));
+            }
+        }
+        return result;
+    }
+
+    /**
+     * Відправляє ZPL на принтер Zebra по Bluetooth Classic (SPP).
+     *
+     * @param address MAC-адреса принтера (якщо null, використовується збережена адреса)
+     * @param port    ігнорується (для сумісності API)
+     * @param zpl     рядок ZPL для друку
+     * @param callback результат успіху або помилки
+     */
+    public void printZpl(Context context, String address, int port, String zpl, PrintCallback callback) {
+        final String addr = (address != null && !address.isEmpty()) ? address.trim() : getStoredAddress(context);
+
+        if (addr == null || addr.isEmpty()) {
+            callback.onError("ADDRESS_MISSING", new IllegalArgumentException("Адреса принтера не вказана. Викличте setPrinterAddress() з Bluetooth MAC або передайте address у print()."));
+            return;
+        }
+
+        String zplTrimmed = zpl != null ? zpl.trim() : "";
+        if (zplTrimmed.isEmpty()) {
+            callback.onError("ZPL_EMPTY", new IllegalArgumentException("ZPL команда порожня."));
+            return;
+        }
+
+        executor.execute(() -> {
+            BluetoothSocket socket = null;
+            OutputStream out = null;
+            try {
+                BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
+                if (adapter == null) {
+                    callback.onError("BLUETOOTH_NOT_SUPPORTED", new IllegalStateException("Bluetooth не підтримується на цьому пристрої."));
+                    return;
+                }
+                if (!adapter.isEnabled()) {
+                    callback.onError("BLUETOOTH_DISABLED", new IllegalStateException("Увімкніть Bluetooth в налаштуваннях."));
+                    return;
+                }
+
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S && ActivityCompat.checkSelfPermission(context, Manifest.permission.BLUETOOTH_CONNECT) != PackageManager.PERMISSION_GRANTED) {
+                    callback.onError("PERMISSION_DENIED", new SecurityException("Відсутній дозвіл BLUETOOTH_CONNECT"));
+                    return;
+                }
+
+                BluetoothDevice device;
+                try {
+                    device = adapter.getRemoteDevice(addr);
+                } catch (IllegalArgumentException e) {
+                    callback.onError("INVALID_ADDRESS", new IllegalArgumentException("Некоректна MAC-адреса: " + addr));
+                    return;
+                }
+
+                try {
+                    socket = device.createRfcommSocketToServiceRecord(SPP_UUID);
+                    socket.connect();
+                } catch (IOException e) {
+                    // Частина пристроїв (зокрема Zebra) потребує fallback через RFCOMM канал 1
+                    Logger.info("Zebra", "SPP UUID connect failed, trying fallback RFCOMM channel 1");
+                    if (socket != null) {
+                        try {
+                            socket.close();
+                        } catch (IOException ignored) {
+                        }
+                        socket = null;
+                    }
+                    socket = createRfcommSocket(device, 1);
+                    socket.connect();
+                }
+
+                out = socket.getOutputStream();
+                byte[] data = zplTrimmed.getBytes(StandardCharsets.UTF_8);
+                out.write(data);
+                out.flush();
+
+                Logger.info("Zebra", "ZPL sent successfully (" + data.length + " bytes) to " + addr);
+                callback.onSuccess(addr, data.length);
+            } catch (IOException e) {
+                Logger.error("Zebra", "Print failed: " + e.getMessage(), e);
+                callback.onError("CONNECTION_FAILED", e);
+            } finally {
+                if (out != null) {
+                    try {
+                        out.close();
+                    } catch (IOException ignored) {
+                    }
+                }
+                if (socket != null) {
+                    try {
+                        socket.close();
+                    } catch (IOException ignored) {
+                    }
+                }
+            }
+        });
+    }
+
+    @SuppressWarnings("JavaReflectionMemberAccess")
+    private static BluetoothSocket createRfcommSocket(BluetoothDevice device, int channel) throws IOException {
+        try {
+            return (BluetoothSocket) device.getClass()
+                    .getMethod("createRfcommSocket", int.class)
+                    .invoke(device, channel);
+        } catch (Exception e) {
+            throw new IOException("Fallback createRfcommSocket failed: " + e.getMessage(), e);
+        }
+    }
+
+    /**
+     * Інформація про Bluetooth-пристрій (для списку спарених).
+     */
+    public static class BluetoothDeviceInfo {
+        public final String address;
+        public final String name;
+
+        public BluetoothDeviceInfo(String address, String name) {
+            this.address = address;
+            this.name = name;
+        }
+    }
+
+    /**
+     * Колбек результату друку.
+     */
+    public interface PrintCallback {
+        /**
+         * Успішне відправлення даних.
+         * @param address MAC-адреса, на яку відправлено.
+         * @param bytesSent кількість відправлених байт.
+         */
+        void onSuccess(String address, int bytesSent);
+
+        /**
+         * Помилка друку.
+         * @param code Короткий код помилки.
+         * @param error Об'єкт виключення з деталями.
+         */
+        void onError(String code, Throwable error);
     }
 }

package/android/src/main/java/dev/nitra/zebra/ZebraPlugin.java

@@ -1,22 +1,128 @@
 package dev.nitra.zebra;
 
+import android.Manifest;
 import com.getcapacitor.JSObject;
+import com.getcapacitor.PermissionState;
 import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
+import com.getcapacitor.annotation.Permission;
+import com.getcapacitor.annotation.PermissionCallback;
 
-@CapacitorPlugin(name = "Zebra")
+import org.json.JSONArray;
+import org.json.JSONObject;
+
+import java.util.List;
+
+@CapacitorPlugin(
+    name = "Zebra",
+    permissions = {
+        @Permission(
+            strings = { Manifest.permission.BLUETOOTH_CONNECT },
+            alias = "bt_connect"
+        )
+    }
+)
 public class ZebraPlugin extends Plugin {
 
-    private Zebra implementation = new Zebra();
+    private final Zebra implementation = new Zebra();
+
+    @PluginMethod
+    public void setPrinterAddress(PluginCall call) {
+        String address = call.getString("address");
+        Integer port = call.getInt("port", 0);
+
+        if (address == null || address.trim().isEmpty()) {
+            call.reject("Параметр 'address' обов'язковий (Bluetooth MAC-адреса принтера).");
+            return;
+        }
+
+        implementation.setPrinterAddress(getContext(), address.trim(), port != null ? port : 0);
+        JSObject ret = new JSObject();
+        ret.put("address", address.trim());
+        call.resolve(ret);
+    }
 
     @PluginMethod
-    public void echo(PluginCall call) {
-        String value = call.getString("value");
+    public void getPairedDevices(PluginCall call) {
+        if (getPermissionState("bt_connect") != PermissionState.GRANTED) {
+            requestPermissionForAlias("bt_connect", call, "getPairedDevicesCallback");
+        } else {
+            loadPairedDevices(call);
+        }
+    }
+
+    @PermissionCallback
+    private void getPairedDevicesCallback(PluginCall call) {
+        if (getPermissionState("bt_connect") != PermissionState.GRANTED) {
+            call.reject("Permission is required to access Bluetooth devices.");
+            return;
+        }
+        loadPairedDevices(call);
+    }
 
+    void loadPairedDevices(PluginCall call) {
+        List<Zebra.BluetoothDeviceInfo> devices = implementation.getPairedDevices(getContext());
+        JSONArray arr = new JSONArray();
+        for (Zebra.BluetoothDeviceInfo d : devices) {
+            JSONObject o = new JSONObject();
+            try {
+                o.put("address", d.address);
+                o.put("name", d.name);
+            } catch (Exception ignored) {
+            }
+            arr.put(o);
+        }
         JSObject ret = new JSObject();
-        ret.put("value", implementation.echo(value));
+        ret.put("devices", arr);
         call.resolve(ret);
     }
+
+    @PluginMethod
+    public void print(PluginCall call) {
+        // Підтримка лише print({ zpl, address?, port? })
+        String zpl = call.getString("zpl");
+        String address = call.getString("address");
+        Integer port = call.getInt("port", 0);
+
+        implementation.printZpl(
+                getContext(),
+                address,
+                port != null ? port : 0,
+                zpl != null ? zpl : "",
+                new Zebra.PrintCallback() {
+                    @Override
+                    public void onSuccess(String address, int bytesSent) {
+                        runOnMainThread(() -> {
+                            JSObject ret = new JSObject();
+                            ret.put("success", true);
+                            ret.put("address", address);
+                            ret.put("bytesSent", bytesSent);
+                            call.resolve(ret);
+                        });
+                    }
+
+                    @Override
+                    public void onError(String code, Throwable error) {
+                        runOnMainThread(() -> {
+                            JSObject ret = new JSObject();
+                            ret.put("success", false);
+                            ret.put("code", code);
+                            ret.put("message", error.getMessage());
+                            // Також робимо reject для стандартної обробки помилок Capacitor
+                            call.reject(error.getMessage(), code, new Exception(error), ret);
+                        });
+                    }
+                }
+        );
+    }
+
+    private void runOnMainThread(Runnable runnable) {
+        if (getActivity() != null) {
+            getActivity().runOnUiThread(runnable);
+        } else {
+            runnable.run();
+        }
+    }
 }

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+//#region src/index.d.ts
+type PairedDevice = {
+  address: string;
+  name: string;
+};
+type PrintResult = {
+  success?: boolean;
+  address?: string;
+  bytesSent?: number;
+  devices?: PairedDevice[];
+};
+interface ZebraPlugin {
+  print(zpl: string): Promise<PrintResult>;
+  setPrinterAddress(options: {
+    address: string;
+    port?: number;
+  }): Promise<{
+    address: string;
+  }>;
+  getPairedDevices(): Promise<{
+    devices: PairedDevice[];
+  }>;
+}
+declare const Zebra: ZebraPlugin;
+//#endregion
+export { PairedDevice, PrintResult, Zebra, ZebraPlugin };