@ruhiverse/thermal-printer-plugin 1.0.1 → 1.0.3

package/ios/Plugin/ThermalPrinterPlugin.swift

@@ -10,6 +10,76 @@ import CoreBluetooth
 @objc(ThermalPrinterPlugin)
 public class ThermalPrinterPlugin: CAPPlugin {
     
+    /// Protocol identifiers for supported MFi ESC/POS printers.
+    /// Update this list with the protocol strings for your specific printer model.
+    private let supportedPrinterProtocols = [
+        "com.epson.escpos",
+        "com.starmicronics.starprnt",
+    ]
+    
+    /// Find a connected External Accessory that matches the given (optional) name
+    /// and supports one of the known printer protocols.
+    private func findPrinterAccessory(preferredName: String?) -> (EAAccessory, String)? {
+        let manager = EAAccessoryManager.shared()
+        let accessories = manager.connectedAccessories
+        
+        // Filter accessories that support at least one of the known printer protocols
+        let printerAccessories: [(EAAccessory, String)] = accessories.compactMap { accessory in
+            if let protocolString = accessory.protocolStrings.first(where: { supportedPrinterProtocols.contains($0) }) {
+                return (accessory, protocolString)
+            }
+            return nil
+        }
+        
+        guard !printerAccessories.isEmpty else {
+            return nil
+        }
+        
+        // If a preferredName is provided, try to match it against the accessory name
+        if let name = preferredName, !name.isEmpty {
+            if let match = printerAccessories.first(where: { (accessory, _) in
+                accessory.name.localizedCaseInsensitiveContains(name)
+            }) {
+                return match
+            }
+        }
+        
+        // Fallback: just return the first compatible printer
+        return printerAccessories.first
+    }
+    
+    /// Send raw ESC/POS (or plain text) data to the given accessory/protocol.
+    private func sendPrintData(
+        _ data: Data,
+        to accessory: EAAccessory,
+        using protocolString: String
+    ) throws {
+        guard let session = EASession(accessory: accessory, forProtocol: protocolString),
+              let outputStream = session.outputStream else {
+            throw NSError(domain: "ThermalPrinterPlugin", code: 1, userInfo: [
+                NSLocalizedDescriptionKey: "Unable to open session/output stream for printer.",
+            ])
+        }
+        
+        outputStream.open()
+        defer {
+            outputStream.close()
+        }
+        
+        let bytesWritten = data.withUnsafeBytes { buffer -> Int in
+            guard let pointer = buffer.bindMemory(to: UInt8.self).baseAddress else {
+                return -1
+            }
+            return outputStream.write(pointer, maxLength: data.count)
+        }
+        
+        if bytesWritten <= 0 {
+            throw NSError(domain: "ThermalPrinterPlugin", code: 2, userInfo: [
+                NSLocalizedDescriptionKey: "Failed to send data to printer.",
+            ])
+        }
+    }
+    
     @objc func printByUsb(_ call: CAPPluginCall) {
         guard let textToPrint = call.getString("textToPrint") else {
             call.reject("textToPrint is required")
@@ -21,19 +91,42 @@ public class ThermalPrinterPlugin: CAPPlugin {
         // your Info.plist with supported protocols for your printer
         
         DispatchQueue.global(qos: .userInitiated).async {
-            // For iOS, USB printing typically requires:
-            // 1. External Accessory framework
-            // 2. Supported protocol strings in Info.plist
-            // 3. MFi (Made for iPhone) certification for the printer
+            // For many iOS thermal printers, USB/MFi printers are exposed
+            // via the ExternalAccessory framework using the same protocol
+            // strings as Bluetooth / network models.
+            let preferredName = call.getString("name")
             
-            // Basic implementation - send ESC/POS commands
-            // You'll need to implement actual USB connection based on your printer model
+            guard let (accessory, protocolString) = self.findPrinterAccessory(preferredName: preferredName) else {
+                DispatchQueue.main.async {
+                    call.reject("No compatible printer accessory found. Make sure your printer is connected and UISupportedExternalAccessoryProtocols in Info.plist contains its protocol.")
+                }
+                return
+            }
             
-            DispatchQueue.main.async {
-                call.resolve([
-                    "success": true,
-                    "message": "USB print command sent (iOS implementation may require additional setup)"
-                ])
+            // Convert text to basic ESC/POS-compatible data (UTF-8 + line feed).
+            // NOTE: This is a minimal implementation and does not yet parse
+            // formatting tags like [C], <b>, etc. Those will print as plain text.
+            guard let data = (textToPrint + "\n\n").data(using: .utf8) else {
+                DispatchQueue.main.async {
+                    call.reject("Failed to encode text as UTF-8.")
+                }
+                return
+            }
+            
+            do {
+                try self.sendPrintData(data, to: accessory, using: protocolString)
+                DispatchQueue.main.async {
+                    call.resolve([
+                        "success": true,
+                        "message": "USB print data sent to printer.",
+                        "printerName": accessory.name,
+                        "protocol": protocolString,
+                    ])
+                }
+            } catch {
+                DispatchQueue.main.async {
+                    call.reject("USB print failed: \(error.localizedDescription)")
+                }
             }
         }
     }
@@ -49,32 +142,87 @@ public class ThermalPrinterPlugin: CAPPlugin {
         // Bluetooth permissions in Info.plist
         
         DispatchQueue.global(qos: .userInitiated).async {
-            // For iOS, Bluetooth printing requires:
-            // 1. Core Bluetooth framework
-            // 2. NSBluetoothAlwaysUsageDescription in Info.plist
-            // 3. Actual Bluetooth connection implementation
+            // On many MFi / ExternalAccessory-based thermal printers, the
+            // Bluetooth connection is abstracted behind the ExternalAccessory
+            // protocols (e.g., com.epson.escpos, com.starmicronics.starprnt).
+            // We reuse the same ExternalAccessory-based implementation here.
+            
+            let preferredName = call.getString("name")
+            
+            guard let (accessory, protocolString) = self.findPrinterAccessory(preferredName: preferredName) else {
+                DispatchQueue.main.async {
+                    call.reject("No compatible Bluetooth printer found. Make sure it is paired, connected, and its protocol is listed in UISupportedExternalAccessoryProtocols.")
+                }
+                return
+            }
             
-            // Basic implementation - send ESC/POS commands
-            // You'll need to implement actual Bluetooth connection based on your printer model
+            // Minimal text → ESC/POS data conversion.
+            // Formatting tags like [C] or <b> are not parsed yet and will
+            // be sent as plain text.
+            guard let data = (textToPrint + "\n\n").data(using: .utf8) else {
+                DispatchQueue.main.async {
+                    call.reject("Failed to encode text as UTF-8.")
+                }
+                return
+            }
             
-            DispatchQueue.main.async {
-                call.resolve([
-                    "success": true,
-                    "message": "Bluetooth print command sent (iOS implementation may require additional setup)"
-                ])
+            do {
+                try self.sendPrintData(data, to: accessory, using: protocolString)
+                DispatchQueue.main.async {
+                    call.resolve([
+                        "success": true,
+                        "message": "Bluetooth print data sent to printer.",
+                        "printerName": accessory.name,
+                        "protocol": protocolString,
+                    ])
+                }
+            } catch {
+                DispatchQueue.main.async {
+                    call.reject("Bluetooth print failed: \(error.localizedDescription)")
+                }
             }
         }
     }
     
     @objc func listBluetoothPrinters(_ call: CAPPluginCall) {
+        let manager = EAAccessoryManager.shared()
+        let accessories = manager.connectedAccessories
+        
+        let printers: [[String: String]] = accessories.compactMap { accessory in
+            guard accessory.protocolStrings.contains(where: { supportedPrinterProtocols.contains($0) }) else {
+                return nil
+            }
+            return [
+                "name": accessory.name,
+                // iOS doesn't expose a MAC address for accessories; we
+                // return the serial number or a generated identifier.
+                "address": accessory.serialNumber.isEmpty ? "\(accessory.connectionID)" : accessory.serialNumber,
+            ]
+        }
+        
         call.resolve([
-            "printers": []
+            "printers": printers,
         ])
     }
     
     @objc func listUsbPrinters(_ call: CAPPluginCall) {
+        // On iOS, many thermal printers expose both USB and Bluetooth via the
+        // ExternalAccessory framework. We reuse the same discovery logic here.
+        let manager = EAAccessoryManager.shared()
+        let accessories = manager.connectedAccessories
+        
+        let printers: [[String: String]] = accessories.compactMap { accessory in
+            guard accessory.protocolStrings.contains(where: { supportedPrinterProtocols.contains($0) }) else {
+                return nil
+            }
+            return [
+                "name": accessory.name,
+                "address": accessory.serialNumber.isEmpty ? "\(accessory.connectionID)" : accessory.serialNumber,
+            ]
+        }
+        
         call.resolve([
-            "printers": []
+            "printers": printers,
         ])
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruhiverse/thermal-printer-plugin",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Capacitor plugin for thermal printing via USB and Bluetooth",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",