@nitra/zebra 8.1.0 → 8.2.1

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

@@ -131,6 +131,8 @@ public class Zebra {
                     out.write(data, offset, len);
                 }
                 out.flush();
+                // Затримка перед закриттям: дає Bluetooth-стеку та принтеру час відправити/прийняти дані (інакше перший друк іноді не виконується, лише другий).
+                Thread.sleep(400);
 
                 Logger.info("Zebra", "ZPL успішно відправлено: " + data.length + " байт");
                 callback.onSuccess(addrTrimmed, data.length);

package/ios/Sources/ZebraPlugin/Zebra.swift

@@ -23,9 +23,6 @@ import ExternalAccessory
     /// Невелика затримка між черговими завданнями, щоб дати прошивці час стабілізуватися
     private let cooldownInterval: TimeInterval = 1.0
 
-    /// Перемикач debug-логування
-    private static let debugLogging = true
-
     /// Один раз реєструємося для нотифікацій EA — потрібно для коректного доступу до аксесуарів при холодному запуску (без Xcode).
     private static var didRegisterForAccessoryNotifications = false
     private static let registerLock = NSLock()
@@ -35,13 +32,7 @@ import ExternalAccessory
         guard !Zebra.didRegisterForAccessoryNotifications else { return }
         EAAccessoryManager.shared().registerForLocalNotifications()
         Zebra.didRegisterForAccessoryNotifications = true
-        log("EAAccessoryManager.registerForLocalNotifications() called")
-    }
-
-    /// Функція логування з префіксом [Zebra]
-    private func log(_ items: Any...) {
-        guard Zebra.debugLogging else { return }
-        print("[Zebra]", items.map { String(describing: $0) }.joined(separator: " "))
+        logDebug("EAAccessoryManager.registerForLocalNotifications() called")
     }
 
     /// Представляє інформацію про підключений аксесуар, яку використовує плагін
@@ -95,7 +86,8 @@ import ExternalAccessory
         }
     }
 
-    /// Відповідає за запис байтів у OutputStream з таймаутом та звітує через completion
+    /// Відповідає за запис байтів у OutputStream з таймаутом та звітує через completion.
+    /// Закриття потоків і сесії гарантовано виконується один раз (ідемпотентний close), у т.ч. по таймеру при відсутності подій.
     private class StreamWriter: NSObject, StreamDelegate {
         private let output: OutputStream
         private let data: [UInt8]
@@ -103,12 +95,13 @@ import ExternalAccessory
         private let timeout: TimeInterval
         private var totalWritten = 0
         private var completion: ((Result<PrintResult, ZebraError>) -> Void)?
-        private weak var owner: Zebra?
         private var startTime = Date()
         private let session: EASession
+        private var didClose = false
+        private let closeLock = NSLock()
+        private var timeoutTimer: Timer?
 
-        init(owner: Zebra, session: EASession, output: OutputStream, data: [UInt8], address: String, timeout: TimeInterval = 5.0, completion: @escaping (Result<PrintResult, ZebraError>) -> Void) {
-            self.owner = owner
+        init(owner _: Zebra, session: EASession, output: OutputStream, data: [UInt8], address: String, timeout: TimeInterval = 5.0, completion: @escaping (Result<PrintResult, ZebraError>) -> Void) {
             self.session = session
             self.output = output
             self.data = data
@@ -119,6 +112,7 @@ import ExternalAccessory
         }
 
         /// Запускає стріми — обидва (input і output) відкриваються й додаються в RunLoop, як у документації Apple; інакше сесія може не звільнятися коректно.
+        /// Таймер гарантує закриття при відсутності подій потоку (наприклад, зависання принтера).
         func start() {
             let runLoop = RunLoop.current
             let mode: RunLoop.Mode = .default
@@ -130,24 +124,39 @@ import ExternalAccessory
             output.delegate = self
             output.schedule(in: runLoop, forMode: mode)
             output.open()
-            owner?.log("StreamWriter started, bytes=", data.count)
+            logDebug("StreamWriter started, bytes= \(self.data.count)")
             startTime = Date()
+            timeoutTimer = Timer.scheduledTimer(withTimeInterval: timeout, repeats: false) { [weak self] _ in
+                logDebug("StreamWriter timeout (no events)")
+                self?.close(with: .failure(.writeFailed("Таймаут запису")))
+            }
         }
 
-        /// Після запису всіх байтів дає час на флаш буфера (iOS може не встигнути відправити на пристрій при миттєвому закритті, особливо при запуску без Xcode).
+        /// Після запису всіх байтів дає час на флаш буфера (iOS може не встигнути відправити на пристрій при миттєвому закритті; при першому друці принтер ще "прокидається" — потрібно більше часу).
         private func flushThenClose() {
-            let flushDuration: TimeInterval = 0.75
+            let flushDuration: TimeInterval = 1.5
             let deadline = Date().addingTimeInterval(flushDuration)
             while Date() < deadline {
                 RunLoop.current.run(mode: .default, before: Date().addingTimeInterval(0.1))
             }
-            owner?.log("Flush done, closing stream")
+            logDebug("Flush done, closing stream")
             close(with: .success(PrintResult(address: address)))
         }
 
-        /// Закриває стріми та викликає completion один раз.
+        /// Закриває стріми та викликає completion один раз (ідемпотентно).
         /// Порядок важливий для коректного звільнення EASession у iOS — інакше повторне відкриття сесії до того ж аксесуара може повертати nil.
         func close(with result: Result<PrintResult, ZebraError>) {
+            closeLock.lock()
+            guard !didClose else {
+                closeLock.unlock()
+                return
+            }
+            didClose = true
+            closeLock.unlock()
+
+            timeoutTimer?.invalidate()
+            timeoutTimer = nil
+
             let runLoop = RunLoop.current
             let mode: RunLoop.Mode = .default
             // Даємо RunLoop обробити останні події перед закриттям
@@ -172,26 +181,26 @@ import ExternalAccessory
                 completion(result)
             }
             completion = nil
-            owner?.log("StreamWriter finished with", result)
+            logDebug("StreamWriter finished with \(String(describing: result))")
         }
 
         func stream(_ aStream: Stream, handle eventCode: Stream.Event) {
             // Події input-потоку ігноруємо (потрібен лише для коректного життєвого циклу сесії)
             guard aStream === output else { return }
             if Date().timeIntervalSince(startTime) > timeout {
-                owner?.log("StreamWriter timeout")
+                logDebug("StreamWriter timeout")
                 close(with: .failure(.writeFailed("Таймаут запису")))
                 return
             }
             switch eventCode {
             case .openCompleted:
                 // Потік відкрито
-                owner?.log("Stream open completed")
+                logDebug("Stream open completed")
             case .hasSpaceAvailable:
                 // Є простір для запису, пишемо дані порціями
                 if totalWritten >= data.count {
                     // Усі байти записані — даємо час на флаш буфера перед закриттям (iOS часто не встигає відправити на пристрій)
-                    owner?.log("All bytes written, flushing before close...")
+                    logDebug("All bytes written, flushing before close...")
                     flushThenClose()
                     return
                 }
@@ -200,7 +209,7 @@ import ExternalAccessory
                 let wrote = output.write(Array(data[totalWritten..<(totalWritten + chunkSize)]), maxLength: chunkSize)
                 if wrote <= 0 {
                     let reason = output.streamError?.localizedDescription ?? "Невідома помилка потоку"
-                    owner?.log("StreamWriter write failed:", reason)
+                    logDebug("StreamWriter write failed: \(reason)")
                     close(with: .failure(.writeFailed(reason)))
                     return
                 }
@@ -208,11 +217,11 @@ import ExternalAccessory
             case .errorOccurred:
                 // Сталася помилка потоку
                 let reason = output.streamError?.localizedDescription ?? "Невідома помилка потоку"
-                owner?.log("Stream error:", reason)
+                logDebug("Stream error: \(reason)")
                 close(with: .failure(.writeFailed(reason)))
             case .endEncountered:
                 // Потік закінчився, перевіряємо чи всі дані записані
-                owner?.log("Stream end encountered, bytes=", totalWritten)
+                logDebug("Stream end encountered, bytes= \(self.totalWritten)")
                 if totalWritten >= data.count {
                     close(with: .success(PrintResult(address: address)))
                 } else {
@@ -239,7 +248,18 @@ import ExternalAccessory
     /// Повертає список підключених EA аксесуарів у вигляді DeviceInfo, вибираючи серійний номер або ім'я як адресу
     public func getConnectedAccessories() -> [DeviceInfo] {
         ensureRegisteredForAccessoryNotifications()
-        let accessories = EAAccessoryManager.shared().connectedAccessories
+        // Якщо аксесуарів немає, чекаємо 0.6 с і повторюємо спробу до 3 разів (щоб дати системі час підхопити нове підключення)
+        let maxAttempts = 3
+        let retryDelay: TimeInterval = 0.6
+        var accessories = EAAccessoryManager.shared().connectedAccessories
+        for attempt in 1...maxAttempts {
+            if !accessories.isEmpty { break }
+            if attempt < maxAttempts {
+                logDebug("connectedAccessories attempt: \(attempt)")
+                Thread.sleep(forTimeInterval: retryDelay)
+                accessories = EAAccessoryManager.shared().connectedAccessories
+            }
+        }
         return accessories.compactMap { accessory in
             let address = accessory.serialNumber.isEmpty ? accessory.name : accessory.serialNumber
             if address.isEmpty {
@@ -252,14 +272,14 @@ import ExternalAccessory
     /// Виводить діагностичну інформацію щодо підключених аксесуарів та протоколів у Info.plist
     public func diagnoseEnvironment() {
         let accessories = EAAccessoryManager.shared().connectedAccessories
-        log("Connected accessories count:", accessories.count)
+        logDebug("Connected accessories count: \(accessories.count)")
         for a in accessories {
-            log("Accessory:", "name=\(a.name)", "serial=\(a.serialNumber)", "protocols=\(a.protocolStrings)")
+            logDebug("Accessory: name=\(a.name) serial=\(a.serialNumber) protocols=\(a.protocolStrings)")
         }
         if let supported = Bundle.main.object(forInfoDictionaryKey: "UISupportedExternalAccessoryProtocols") as? [String] {
-            log("Info.plist UISupportedExternalAccessoryProtocols:", supported)
+            logDebug("Info.plist UISupportedExternalAccessoryProtocols: \(supported)")
         } else {
-            log("Info.plist UISupportedExternalAccessoryProtocols: MISSING or not an array")
+            logDebug("Info.plist UISupportedExternalAccessoryProtocols: MISSING or not an array")
         }
     }
 
@@ -270,10 +290,10 @@ import ExternalAccessory
         for proto in protocolsToTry {
             for attempt in 1...retries {
                 if let session = EASession(accessory: accessory, forProtocol: proto) {
-                    self.log("EASession open success on attempt", attempt, "protocol:", proto)
+                    logDebug("EASession open success on attempt \(attempt) protocol: \(proto)")
                     return (session, proto)
                 } else {
-                    self.log("EASession open failed attempt", attempt, "protocol:", proto)
+                    logDebug("EASession open failed attempt \(attempt) protocol: \(proto)")
                     Thread.sleep(forTimeInterval: delay)
                 }
             }
@@ -299,18 +319,25 @@ import ExternalAccessory
             payload += "\r\n"
         }
         let zplBytes = Array(payload.utf8)
-        log("printZpl called with address=\(trimmedAddress)", "zplLength=\(zplBytes.count)")
+        logDebug("printZpl called with address=\(trimmedAddress) zplLength=\(zplBytes.count)")
 
         DispatchQueue.main.async { [weak self] in
             guard let self = self else { return }
             self.ensureRegisteredForAccessoryNotifications()
             let accessories = EAAccessoryManager.shared().connectedAccessories
-            self.log("EA connectedAccessories count=", accessories.count)
+            logDebug("EA connectedAccessories count= \(accessories.count)")
 
             // Шукаємо аксесуар, що відповідає адресі (serialNumber або name)
             let availableList = self.getConnectedAccessories()
+
+            if availableList.isEmpty {
+                logDebug("No accessories found")
+                completion(.failure(.accessoryNotFound(requestedAddress: trimmedAddress, availableAccessories: availableList)))
+                return
+            }
+
             guard let accessory = accessories.first(where: { self.accessoryMatches($0, address: trimmedAddress) }) else {
-                self.log("No accessory matched address:", trimmedAddress)
+                logDebug("No accessory matched address: \(trimmedAddress)")
                 // У failure передаємо не лише адресу, а й список доступних аксесуарів (назви та адреси) для показу в помилці
                 completion(.failure(.accessoryNotFound(requestedAddress: trimmedAddress, availableAccessories: availableList)))
                 return
@@ -318,30 +345,30 @@ import ExternalAccessory
 
             // Обираємо протокол для з’єднання
             let protocolString = self.preferredProtocol(for: accessory)
-            self.log("Chosen accessory:", accessory.name, "serial=\(accessory.serialNumber)")
-            self.log("Selected protocol:", protocolString)
+            logDebug("Chosen accessory: \(accessory.name) serial=\(accessory.serialNumber)")
+            logDebug("Selected protocol: \(protocolString)")
             if let supported = Bundle.main.object(forInfoDictionaryKey: "UISupportedExternalAccessoryProtocols") as? [String] {
                 if !supported.contains(protocolString) {
-                    self.log("WARNING: Selected protocol not present in Info.plist UISupportedExternalAccessoryProtocols")
+                    logDebug("WARNING: Selected protocol not present in Info.plist UISupportedExternalAccessoryProtocols")
                 }
             } else {
-                self.log("WARNING: UISupportedExternalAccessoryProtocols missing in Info.plist")
+                logDebug("WARNING: UISupportedExternalAccessoryProtocols missing in Info.plist")
             }
 
-            self.log("Attempting to open EASession with retries and fallback protocols...")
+            logDebug("Attempting to open EASession with retries and fallback protocols...")
             Thread.sleep(forTimeInterval: 0.1)
             let fallback = accessory.protocolStrings
             // Відкриваємо сесію, пробуємо ретраї і fallback протоколи
             guard let result = self.openSessionWithRetries(accessory: accessory, preferredProtocol: protocolString, fallbackProtocols: fallback) else {
-                self.log("EASession failed after retries and fallback")
+                logDebug("EASession failed after retries and fallback")
                 completion(.failure(.sessionFailed("EASession повернув nil")))
                 return
             }
             let session = result.session
             let protocolUsed = result.protocolUsed
-            self.log("Using protocol for session:", protocolUsed)
+            logDebug("Using protocol for session: \(protocolUsed)")
             guard let outputStream = session.outputStream else {
-                self.log("Session opened but outputStream is nil")
+                logDebug("Session opened but outputStream is nil")
                 completion(.failure(.sessionFailed("Відсутній outputStream")))
                 return
             }

package/ios/Sources/ZebraPlugin/ZebraLog.swift

@@ -0,0 +1,11 @@
+import os
+
+/// Спільна функція дебаг-логування для модуля Zebra.
+/// У Release не виконується й не обчислює повідомлення (zero cost).
+#if DEBUG
+func logDebug(_ message: @autoclosure @escaping () -> String) {
+    Logger(subsystem: "com.nitra.zebra", category: "Zebra").debug("\(message(), privacy: .public)")
+}
+#else
+func logDebug(_ message: @autoclosure @escaping () -> String) {}
+#endif

package/ios/Sources/ZebraPlugin/ZebraPlugin.swift

@@ -36,9 +36,8 @@ public class ZebraPlugin: CAPPlugin, CAPBridgedPlugin {
             return
         }
         Task {
-            // Зберігаємо адресу в UserDefaults
             await implementation.setPrinterAddress(address)
-            // Повертаємо успішний результат
+            logDebug("setPrinterAddress: \(address)")
             await MainActor.run {
                 call.resolve(["address": address])
             }
@@ -49,13 +48,10 @@ public class ZebraPlugin: CAPPlugin, CAPBridgedPlugin {
     /// - Parameter call: Виклик без параметрів
     @objc func getPairedDevices(_ call: CAPPluginCall) {
         Task {
-            // Отримуємо список підключених аксесуарів
             let devices = await implementation.getConnectedAccessories()
-
-            // Перетворюємо масив DeviceInfo в масив словників
+            logDebug("getPairedDevices: \(devices.count) device(s)")
             let list = devices.map { ["address": $0.address, "name": $0.name] }
             await MainActor.run {
-                // Повертаємо результат
                 call.resolve(["devices": list])
             }
         }
@@ -71,13 +67,15 @@ public class ZebraPlugin: CAPPlugin, CAPBridgedPlugin {
             return
         }
         Task {
+            logDebug("print address=\(address) zplLength=\(zpl.utf8.count)")
             do {
                 _ = try await implementation.printZpl(address: address, zpl: zpl)
+                logDebug("print success")
                 await MainActor.run {
-                    // Успішний друк - повертаємо лише success
                     call.resolve(["success": true])
                 }
             } catch let error as Zebra.ZebraError {
+                logDebug("print failed: \(error.localizedDescription)")
                 // Помилка друку - визначаємо код помилки
                 await MainActor.run {
                     let code: String
@@ -110,8 +108,8 @@ public class ZebraPlugin: CAPPlugin, CAPBridgedPlugin {
                     call.reject(error.localizedDescription, code, error)
                 }
             } catch {
+                logDebug("print failed (unknown): \(error.localizedDescription)")
                 await MainActor.run {
-                    // Повертаємо помилку з UNKNOWN
                     call.reject(error.localizedDescription, "UNKNOWN", error)
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/zebra",
-  "version": "8.1.0",
+  "version": "8.2.1",
   "description": "Zebra printer",
   "keywords": [
     "capacitor",