@rdlabo/capacitor-brotherprint 8.2.2 → 8.2.3

package/README.md

@@ -289,7 +289,7 @@ These are optional. If these are not set, default values are assigned by the pri
 
 #### BRLMSearchOption
 
-<code>{ /** * 'usb' is android only, and now developing. */ port: <a href="#brlmprinterport">BRLMPrinterPort</a>; /** * searchDuration is the time to end search for devices. * default is 15 seconds. * use only port is 'wifi' or 'bluetoothLowEnergy'. */ searchDuration: number; /** * Android Bluetooth Classic only. Include only devices whose Bluetooth class * reports a printer. Defaults to false; ignored for other ports and on iOS. * This does not identify Brother devices. Devices with an unknown class are excluded when true. */ bluetoothPrintersOnly?: boolean; }</code>
+<code>{ /** * 'usb' is android only, and now developing. */ port: <a href="#brlmprinterport">BRLMPrinterPort</a>; /** * searchDuration is the time to end search for devices. * default is 15 seconds. * Used for Wi-Fi, BLE, and the iOS Bluetooth accessory picker wait. * Timing out does not dismiss the system accessory picker; close it before retrying. */ searchDuration: number; /** * Android Bluetooth Classic only. Include only devices whose Bluetooth class * reports a printer. Defaults to false; ignored for other ports and on iOS. * This does not identify Brother devices. Devices with an unknown class are excluded when true. */ bluetoothPrintersOnly?: boolean; }</code>
 
 
 #### isChannelAvailableResult

package/dist/docs.json

@@ -929,7 +929,7 @@
       "docs": "",
       "types": [
         {
-          "text": "{\n  /**\n   * 'usb' is android only, and now developing.\n   */\n  port: BRLMPrinterPort;\n\n  /**\n   * searchDuration is the time to end search for devices.\n   * default is 15 seconds.\n   * use only port is 'wifi' or 'bluetoothLowEnergy'.\n   */\n  searchDuration: number;\n  /**\n   * Android Bluetooth Classic only. Include only devices whose Bluetooth class\n   * reports a printer. Defaults to false; ignored for other ports and on iOS.\n   * This does not identify Brother devices. Devices with an unknown class are excluded when true.\n   */\n  bluetoothPrintersOnly?: boolean;\n}",
+          "text": "{\n  /**\n   * 'usb' is android only, and now developing.\n   */\n  port: BRLMPrinterPort;\n\n  /**\n   * searchDuration is the time to end search for devices.\n   * default is 15 seconds.\n   * Used for Wi-Fi, BLE, and the iOS Bluetooth accessory picker wait.\n   * Timing out does not dismiss the system accessory picker; close it before retrying.\n   */\n  searchDuration: number;\n  /**\n   * Android Bluetooth Classic only. Include only devices whose Bluetooth class\n   * reports a printer. Defaults to false; ignored for other ports and on iOS.\n   * This does not identify Brother devices. Devices with an unknown class are excluded when true.\n   */\n  bluetoothPrintersOnly?: boolean;\n}",
           "complexTypes": [
             "BRLMPrinterPort"
           ]

package/dist/esm/interfaces.d.ts

@@ -121,7 +121,8 @@ export type BRLMSearchOption = {
     /**
      * searchDuration is the time to end search for devices.
      * default is 15 seconds.
-     * use only port is 'wifi' or 'bluetoothLowEnergy'.
+     * Used for Wi-Fi, BLE, and the iOS Bluetooth accessory picker wait.
+     * Timing out does not dismiss the system accessory picker; close it before retrying.
      */
     searchDuration: number;
     /**

package/dist/esm/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/interfaces.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  BRLMPrinterLabelName,\n  BRLMPrinterModelName,\n  BRLMPrinterAutoCutType,\n  BRLMPrinterCompressMode,\n  BRLMPrinterHalftone,\n  BRLMPrinterHalftoneThresholdType,\n  BRLMPrinterHorizontalAlignment,\n  BRLMPrinterNumberOfCopies,\n  BRLMPrinterPrintQuality,\n  BRLMPrinterImageRotation,\n  BRLMPrinterScaleMode,\n  BRLMPrinterScaleValueType,\n  BRLMPrinterVerticalAlignment,\n  BRLMPrinterCustomPaperType,\n  BRLMPrinterCustomPaperUnit,\n  BRLMPrinterPort,\n} from './brother-printer.enum';\n\nexport type BRLMChannelResult = {\n  port: BRLMPrinterPort;\n  modelName: string;\n  serialNumber: string;\n  macAddress: string;\n  nodeName: string;\n  location: string;\n\n  /**\n   * This need to connect to the printer.\n   * wifi: IP Address\n   * bluetooth: macAddress\n   * bluetoothLowEnergy: modelName for bluetoothLowEnergy\n   */\n  channelInfo: string;\n};\n\nexport type BRLMPrintOptions = {\n  encodedImage: string;\n\n  /**\n   * Should use enum BRLMPrinterModelName\n   */\n  modelName: BRLMPrinterModelName;\n} & Partial<BRLMChannelResult> &\n  (BRLMPrinterQLModelSettings | BRLMPrinterTDModelSettings);\n\nexport type isChannelAvailableResult = {\n  result: boolean;\n};\n\nexport type BRLMPrinterTDModelSettings = {\n  /**\n   * Should use enum BRKMPrinterCustomPaperType\n   */\n  paperType: BRLMPrinterCustomPaperType;\n\n  /**\n   * The width of the label. For example, the RD-U04J1 is 60.0 wide.\n   */\n  tapeWidth: number;\n\n  /**\n   * The length of the label. For example, the RD-U04J1 is 60.0 wide.\n   */\n  tapeLength: number;\n\n  /**\n   * It is the difference between a sticker and a mount.\n   * For example, the RD-U04J1 is `1.0, 2.0, 1.0, 2.0`\n   */\n  marginTop: number;\n  marginRight: number;\n  marginBottom: number;\n  marginLeft: number;\n\n  /**\n   * The spacing between seals. For example, the RD-U04J1 is 0.2.\n   */\n  gapLength: number;\n\n  paperMarkPosition: number;\n  paperMarkLength: number;\n\n  /**\n   * Should use enum BRKMPrinterCustomPaperUnit.\n   * For example, the RD-U04J1 is mm.\n   */\n  paperUnit: BRLMPrinterCustomPaperUnit;\n};\n\nexport type BRLMPrinterQLModelSettings = {\n  /**\n   * Should use enum BRLMPrinterLabelName\n   */\n  labelName: BRLMPrinterLabelName;\n} & BRLMPrinterSettings;\n\n/**\n * These are optional. If these are not set, default values are assigned by the printer.\n */\nexport type BRLMPrinterSettings = {\n  /**\n   * The number of copies you print.\n   */\n  numberOfCopies?: BRLMPrinterNumberOfCopies;\n\n  /**\n   * Whether the auto-cut is enabled or not. If true, your printer cut the paper each page.\n   */\n  autoCut?: BRLMPrinterAutoCutType;\n\n  /**\n   * A scale mode that specifies how your data is scaled in a print area of your printer.\n   */\n  scaleMode?: BRLMPrinterScaleMode;\n\n  /**\n   * A scale value. This is effective when ScaleMode is ScaleValue.\n   */\n  scaleValue?: BRLMPrinterScaleValueType;\n\n  /**\n   * A way to rasterize your data.\n   */\n  halftone?: BRLMPrinterHalftone;\n\n  /**\n   * A threshold value. This is effective when the Halftone is Threshold.\n   */\n  halftoneThreshold?: BRLMPrinterHalftoneThresholdType;\n\n  /**\n   * An image rotation that specifies the angle in which your data is placed in the print area. Rotation direction is clockwise.\n   */\n  imageRotation?: BRLMPrinterImageRotation;\n\n  /**\n   * A vertical alignment that specifies how your data is placed in the printable area.\n   */\n  verticalAlignment?: BRLMPrinterVerticalAlignment;\n\n  /**\n   * A horizontal alignment that specifies how your data is placed in the printable area.\n   */\n  horizontalAlignment?: BRLMPrinterHorizontalAlignment;\n\n  /**\n   * A compress mode that specifies how to compress your data.\n   * note: This is ios only.\n   */\n  compressMode?: BRLMPrinterCompressMode;\n\n  /**\n   * A priority that is print speed or print quality. Whether or not this has an effect is depend on your printer.\n   */\n  printQuality?: BRLMPrinterPrintQuality;\n};\n\nexport type BRLMSearchOption = {\n  /**\n   * 'usb' is android only, and now developing.\n   */\n  port: BRLMPrinterPort;\n\n  /**\n   * searchDuration is the time to end search for devices.\n   * default is 15 seconds.\n   * use only port is 'wifi' or 'bluetoothLowEnergy'.\n   */\n  searchDuration: number;\n  /**\n   * Android Bluetooth Classic only. Include only devices whose Bluetooth class\n   * reports a printer. Defaults to false; ignored for other ports and on iOS.\n   * This does not identify Brother devices. Devices with an unknown class are excluded when true.\n   */\n  bluetoothPrintersOnly?: boolean;\n};\n\nexport type ErrorInfo = {\n  message: string;\n  code: number;\n};\n"]}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/interfaces.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  BRLMPrinterLabelName,\n  BRLMPrinterModelName,\n  BRLMPrinterAutoCutType,\n  BRLMPrinterCompressMode,\n  BRLMPrinterHalftone,\n  BRLMPrinterHalftoneThresholdType,\n  BRLMPrinterHorizontalAlignment,\n  BRLMPrinterNumberOfCopies,\n  BRLMPrinterPrintQuality,\n  BRLMPrinterImageRotation,\n  BRLMPrinterScaleMode,\n  BRLMPrinterScaleValueType,\n  BRLMPrinterVerticalAlignment,\n  BRLMPrinterCustomPaperType,\n  BRLMPrinterCustomPaperUnit,\n  BRLMPrinterPort,\n} from './brother-printer.enum';\n\nexport type BRLMChannelResult = {\n  port: BRLMPrinterPort;\n  modelName: string;\n  serialNumber: string;\n  macAddress: string;\n  nodeName: string;\n  location: string;\n\n  /**\n   * This need to connect to the printer.\n   * wifi: IP Address\n   * bluetooth: macAddress\n   * bluetoothLowEnergy: modelName for bluetoothLowEnergy\n   */\n  channelInfo: string;\n};\n\nexport type BRLMPrintOptions = {\n  encodedImage: string;\n\n  /**\n   * Should use enum BRLMPrinterModelName\n   */\n  modelName: BRLMPrinterModelName;\n} & Partial<BRLMChannelResult> &\n  (BRLMPrinterQLModelSettings | BRLMPrinterTDModelSettings);\n\nexport type isChannelAvailableResult = {\n  result: boolean;\n};\n\nexport type BRLMPrinterTDModelSettings = {\n  /**\n   * Should use enum BRKMPrinterCustomPaperType\n   */\n  paperType: BRLMPrinterCustomPaperType;\n\n  /**\n   * The width of the label. For example, the RD-U04J1 is 60.0 wide.\n   */\n  tapeWidth: number;\n\n  /**\n   * The length of the label. For example, the RD-U04J1 is 60.0 wide.\n   */\n  tapeLength: number;\n\n  /**\n   * It is the difference between a sticker and a mount.\n   * For example, the RD-U04J1 is `1.0, 2.0, 1.0, 2.0`\n   */\n  marginTop: number;\n  marginRight: number;\n  marginBottom: number;\n  marginLeft: number;\n\n  /**\n   * The spacing between seals. For example, the RD-U04J1 is 0.2.\n   */\n  gapLength: number;\n\n  paperMarkPosition: number;\n  paperMarkLength: number;\n\n  /**\n   * Should use enum BRKMPrinterCustomPaperUnit.\n   * For example, the RD-U04J1 is mm.\n   */\n  paperUnit: BRLMPrinterCustomPaperUnit;\n};\n\nexport type BRLMPrinterQLModelSettings = {\n  /**\n   * Should use enum BRLMPrinterLabelName\n   */\n  labelName: BRLMPrinterLabelName;\n} & BRLMPrinterSettings;\n\n/**\n * These are optional. If these are not set, default values are assigned by the printer.\n */\nexport type BRLMPrinterSettings = {\n  /**\n   * The number of copies you print.\n   */\n  numberOfCopies?: BRLMPrinterNumberOfCopies;\n\n  /**\n   * Whether the auto-cut is enabled or not. If true, your printer cut the paper each page.\n   */\n  autoCut?: BRLMPrinterAutoCutType;\n\n  /**\n   * A scale mode that specifies how your data is scaled in a print area of your printer.\n   */\n  scaleMode?: BRLMPrinterScaleMode;\n\n  /**\n   * A scale value. This is effective when ScaleMode is ScaleValue.\n   */\n  scaleValue?: BRLMPrinterScaleValueType;\n\n  /**\n   * A way to rasterize your data.\n   */\n  halftone?: BRLMPrinterHalftone;\n\n  /**\n   * A threshold value. This is effective when the Halftone is Threshold.\n   */\n  halftoneThreshold?: BRLMPrinterHalftoneThresholdType;\n\n  /**\n   * An image rotation that specifies the angle in which your data is placed in the print area. Rotation direction is clockwise.\n   */\n  imageRotation?: BRLMPrinterImageRotation;\n\n  /**\n   * A vertical alignment that specifies how your data is placed in the printable area.\n   */\n  verticalAlignment?: BRLMPrinterVerticalAlignment;\n\n  /**\n   * A horizontal alignment that specifies how your data is placed in the printable area.\n   */\n  horizontalAlignment?: BRLMPrinterHorizontalAlignment;\n\n  /**\n   * A compress mode that specifies how to compress your data.\n   * note: This is ios only.\n   */\n  compressMode?: BRLMPrinterCompressMode;\n\n  /**\n   * A priority that is print speed or print quality. Whether or not this has an effect is depend on your printer.\n   */\n  printQuality?: BRLMPrinterPrintQuality;\n};\n\nexport type BRLMSearchOption = {\n  /**\n   * 'usb' is android only, and now developing.\n   */\n  port: BRLMPrinterPort;\n\n  /**\n   * searchDuration is the time to end search for devices.\n   * default is 15 seconds.\n   * Used for Wi-Fi, BLE, and the iOS Bluetooth accessory picker wait.\n   * Timing out does not dismiss the system accessory picker; close it before retrying.\n   */\n  searchDuration: number;\n  /**\n   * Android Bluetooth Classic only. Include only devices whose Bluetooth class\n   * reports a printer. Defaults to false; ignored for other ports and on iOS.\n   * This does not identify Brother devices. Devices with an unknown class are excluded when true.\n   */\n  bluetoothPrintersOnly?: boolean;\n};\n\nexport type ErrorInfo = {\n  message: string;\n  code: number;\n};\n"]}

package/docs/search.md

@@ -47,13 +47,15 @@ const stopSearching = async () => {
 
 Call `searchWifiPrinters` from the search button and await `stopSearching` when leaving the screen.
 
-On iOS, `bluetooth` first lists connected MFi printers. If none are connected, the app displays the system Bluetooth accessory picker so you can select and pair a printer. The search promise completes after the picker callback; picker errors reject the promise.
+On iOS, `bluetooth` first lists connected MFi printers. If none are connected, the app displays the system Bluetooth accessory picker so you can select and pair a printer. The search promise completes after the picker callback; picker errors reject the promise. The picker wait rejects after `searchDuration` seconds (default 15, minimum 1), or when `cancelSearchBluetoothPrinter()` is called. Late picker results are ignored. Apple does not provide an API to dismiss this picker: close it before retrying. While the old picker remains open, another picker request rejects immediately. If the system never displays or closes it, restart the app before retrying.
+
+When migrating to `SceneDelegate`, including during the Capacitor 8.5 update, also assign the scene window to `AppDelegate.window`, which the system accessory picker uses. After creating the scene window, set `(UIApplication.shared.delegate as? AppDelegate)?.window = window`. Without this reference, the picker may not appear even though the search has started.
 
 For BLE-capable printers, use `port: BRLMPrinterPort.bluetoothLowEnergy`. On iOS this uses `startBLESearch`, without the Bluetooth accessory picker. Pass the discovered printer's `channelInfo` (BLE local name) unchanged to `isChannelAvailable` or `printImage`. BLE search errors reject the search promise. QL-820NWB/QL-820NWBc do not support BLE printing; use `bluetooth` or `wifi` for these models.
 
 On Android, pair a Bluetooth printer in the system settings before calling `search` with `bluetooth`; the SDK lists paired printers and does not provide the iOS accessory picker. Bluetooth and BLE searches resolve after the search finishes, or reject on SDK errors. Android 12 and later request Nearby devices permissions; Android 11 and earlier request location permission for BLE. `isChannelAvailable` returns `false` when Bluetooth permission is missing.
 
-`searchDuration` applies to `wifi` and `bluetoothLowEnergy`. `usb` is Android only. If nothing is found, you get no error and no printers. Signatures are on the [API](/docs/api#brlmsearchoption) page.
+`searchDuration` applies to `wifi`, `bluetoothLowEnergy`, and the iOS `bluetooth` accessory-picker wait. `usb` is Android only. Completed Wi-Fi/BLE searches with no results resolve without printers; iOS accessory-picker errors, cancellation, and wait timeouts reject the search. Cancellation also rejects an in-progress iOS Bluetooth initial scan and prevents its late result from opening the picker. Signatures are on the [API](/docs/api#brlmsearchoption) page.
 
 On Android, Bluetooth Classic searches return paired devices. To include only devices that report the Bluetooth Imaging/Printer class:
 

package/ios/Sources/BrotherPrintPlugin/BrotherPrintPlugin.swift

@@ -19,6 +19,8 @@ public class BrotherPrintPlugin: CAPPlugin, CAPBridgedPlugin {
     ]
     private var cancelRoutineWiFi: (() -> Void)?
     private var cancelRoutineBluetooth: (() -> Void)?
+    private var bluetoothAccessoryPickerActive = false
+    private var cancelAccessorySearch: (() -> Void)?
 
     @objc func printImage(_ call: CAPPluginCall) {
         let encodedImage: String = call.getString("encodedImage", "")
@@ -201,35 +203,85 @@ public class BrotherPrintPlugin: CAPPlugin, CAPBridgedPlugin {
         }
     }
 
-    private func checkBLEChannel(_ call: CAPPluginCall) {
-        DispatchQueue.global().async {
-            let searcher = BRLMPrinterSearcher.startBluetoothSearch()
-            if searcher.error.code != BRLMPrinterSearchErrorCode.noError {
-                call.reject("Error - startBluetoothSearch: " + PrinterSearchErrorModel.fetchChannelErrorCode(error: searcher.error.code))
-                return
+    func checkBLEChannel(
+        _ call: CAPPluginCall,
+        scan: @escaping () -> (channels: [BRLMChannel], error: BRLMPrinterSearchErrorCode) = {
+            let result = BRLMPrinterSearcher.startBluetoothSearch()
+            return (result.channels, result.error.code)
+        },
+        startAccessorySearch: @escaping (@escaping (BRLMPrinterSearchResult) -> Void) -> Void = BRLMPrinterSearcher.startBluetoothAccessorySearch
+    ) {
+        DispatchQueue.main.async {
+            var cancelled = false
+            self.cancelAccessorySearch = {
+                cancelled = true
+                self.cancelAccessorySearch = nil
+                call.reject("Bluetooth accessory search cancelled.")
             }
-            if searcher.channels.isEmpty {
+            DispatchQueue.global().async {
+                let result = scan()
                 DispatchQueue.main.async {
-                    BRLMPrinterSearcher.startBluetoothAccessorySearch { result in
-                        guard result.error.code == BRLMPrinterSearchErrorCode.noError else {
-                            call.reject("Error - startBluetoothAccessorySearch: " + PrinterSearchErrorModel.fetchChannelErrorCode(error: result.error.code))
-                            return
-                        }
-                        for channel in result.channels {
-                            self.notifyListeners(BrotherPrinterEvent.onPrinterAvailable.rawValue, data: self.chanelToPrinter(port: "bluetooth", channel: channel))
-                        }
-                        call.resolve()
+                    guard !cancelled else { return }
+                    self.cancelAccessorySearch = nil
+                    guard result.error == .noError else {
+                        call.reject("Error - startBluetoothSearch: " + PrinterSearchErrorModel.fetchChannelErrorCode(error: result.error))
+                        return
                     }
+                    if result.channels.isEmpty {
+                        self.searchBluetoothAccessory(call, startSearch: startAccessorySearch)
+                        return
+                    }
+                    for channel in result.channels {
+                        self.notifyListeners(BrotherPrinterEvent.onPrinterAvailable.rawValue, data: self.chanelToPrinter(port: "bluetooth", channel: channel))
+                    }
+                    call.resolve()
                 }
-                return
             }
-            for channel in searcher.channels {
-                NSLog(channel.channelInfo)
-                self.notifyListeners(BrotherPrinterEvent.onPrinterAvailable.rawValue, data: self.chanelToPrinter(port: "bluetooth", channel: channel))
-            }
-            call.resolve()
         }
+    }
 
+    func searchBluetoothAccessory(
+        _ call: CAPPluginCall,
+        startSearch: (@escaping (BRLMPrinterSearchResult) -> Void) -> Void = BRLMPrinterSearcher.startBluetoothAccessorySearch
+    ) {
+        guard !self.bluetoothAccessoryPickerActive else {
+            call.reject("Bluetooth accessory picker is still open. Close it before searching again.")
+            return
+        }
+        self.bluetoothAccessoryPickerActive = true
+        // Only the OS callback closes the picker; timeout/cancellation ends our wait, not the system UI.
+        var finished = false
+        let finish = { () -> Bool in
+            guard !finished else { return false }
+            finished = true
+            self.cancelAccessorySearch = nil
+            return true
+        }
+        let timeout = DispatchWorkItem {
+            guard finish() else { return }
+            call.reject("Bluetooth accessory search timed out. Close the accessory picker before retrying.")
+        }
+        self.cancelAccessorySearch = {
+            guard finish() else { return }
+            timeout.cancel()
+            call.reject("Bluetooth accessory search cancelled.")
+        }
+        DispatchQueue.main.asyncAfter(deadline: .now() + Double(max(1, call.getInt("searchDuration", 15))), execute: timeout)
+        startSearch { result in
+            DispatchQueue.main.async {
+                self.bluetoothAccessoryPickerActive = false
+                guard finish() else { return }
+                timeout.cancel()
+                guard result.error.code == BRLMPrinterSearchErrorCode.noError else {
+                    call.reject("Error - startBluetoothAccessorySearch: " + PrinterSearchErrorModel.fetchChannelErrorCode(error: result.error.code))
+                    return
+                }
+                for channel in result.channels {
+                    self.notifyListeners(BrotherPrinterEvent.onPrinterAvailable.rawValue, data: self.chanelToPrinter(port: "bluetooth", channel: channel))
+                }
+                call.resolve()
+            }
+        }
     }
 
     private func searchBLEPrinter(_ call: CAPPluginCall) {
@@ -280,10 +332,13 @@ public class BrotherPrintPlugin: CAPPlugin, CAPBridgedPlugin {
     }
 
     @objc func cancelSearchBluetoothPrinter(_ call: CAPPluginCall) {
-        DispatchQueue.global().async {
-            self.cancelRoutineBluetooth?()
-            self.cancelRoutineBluetooth = nil
-            call.resolve()
+        DispatchQueue.main.async {
+            self.cancelAccessorySearch?()
+            DispatchQueue.global().async {
+                self.cancelRoutineBluetooth?()
+                self.cancelRoutineBluetooth = nil
+                call.resolve()
+            }
         }
     }
 }

package/ios/Tests/BrotherPrintPluginTests/BrotherPrintPluginTests.swift

@@ -2,6 +2,89 @@ import XCTest
 import Capacitor
 @testable import BrotherPrintPlugin
 
+class BluetoothAccessorySearchTests: XCTestCase {
+    func testCancellationDuringInitialScanDoesNotOpenPicker() {
+        let scanStarted = expectation(description: "Initial scan started")
+        let scanFinished = expectation(description: "Initial scan returned")
+        let pickerOpened = expectation(description: "Cancelled scan must not open picker")
+        pickerOpened.isInverted = true
+        let releaseScan = DispatchSemaphore(value: 0)
+        let plugin = BrotherPrintPlugin()
+        var rejections = 0
+        let call = CAPPluginCall(callbackId: "initial-scan", methodName: "search", options: [:], success: { _, _ in
+            XCTFail("Cancelled search must not resolve")
+        }, error: { error in
+            rejections += 1
+            XCTAssertTrue(error?.message.contains("cancelled") == true)
+        })!
+        plugin.checkBLEChannel(call, scan: {
+            scanStarted.fulfill()
+            XCTAssertEqual(releaseScan.wait(timeout: .now() + 3), .success)
+            scanFinished.fulfill()
+            return ([], .noError)
+        }, startAccessorySearch: { _ in
+            pickerOpened.fulfill()
+        })
+        wait(for: [scanStarted], timeout: 3)
+        let cancel = CAPPluginCall(callbackId: "stop", methodName: "cancelSearchBluetoothPrinter", options: [:], success: { _, _ in
+            releaseScan.signal()
+        }, error: { _ in
+            XCTFail("Cancellation must resolve")
+        })!
+        plugin.cancelSearchBluetoothPrinter(cancel)
+        wait(for: [scanFinished], timeout: 3)
+        wait(for: [pickerOpened], timeout: 0.2)
+        XCTAssertEqual(rejections, 1)
+    }
+
+    func testMissingPickerCallbackTimesOutAndDoesNotOpenAnotherPicker() {
+        let timedOut = expectation(description: "Search rejects without a picker callback")
+        let plugin = BrotherPrintPlugin()
+        var starts = 0
+        let call = CAPPluginCall(callbackId: "timeout", methodName: "search", options: ["searchDuration": 1], success: { _, _ in
+            XCTFail("Search must reject")
+        }, error: { error in
+            XCTAssertTrue(error?.message.contains("timed out") == true)
+            let retry = CAPPluginCall(callbackId: "retry", methodName: "search", options: [:], success: { _, _ in
+                XCTFail("A second picker must not open")
+            }, error: { error in
+                XCTAssertTrue(error?.message.contains("still open") == true)
+            })!
+            plugin.searchBluetoothAccessory(retry) { _ in starts += 1 }
+            XCTAssertEqual(starts, 1)
+            timedOut.fulfill()
+        })!
+        DispatchQueue.main.async {
+            plugin.searchBluetoothAccessory(call) { _ in starts += 1 }
+        }
+        wait(for: [timedOut], timeout: 3)
+    }
+
+    func testCancellationRejectsOnlyOnceEvenAfterDeadline() {
+        let finished = expectation(description: "Cancellation stays settled after the deadline")
+        let plugin = BrotherPrintPlugin()
+        var rejections = 0
+        let call = CAPPluginCall(callbackId: "cancel", methodName: "search", options: ["searchDuration": 1], success: { _, _ in
+            XCTFail("Search must reject")
+        }, error: { error in
+            rejections += 1
+            XCTAssertTrue(error?.message.contains("cancelled") == true)
+        })!
+        let cancel = CAPPluginCall(callbackId: "stop", methodName: "cancelSearchBluetoothPrinter", options: [:], success: { _, _ in }, error: { _ in
+            XCTFail("Cancellation must resolve")
+        })!
+        DispatchQueue.main.async {
+            plugin.searchBluetoothAccessory(call) { _ in }
+            plugin.cancelSearchBluetoothPrinter(cancel)
+            DispatchQueue.main.asyncAfter(deadline: .now() + 1.2) {
+                XCTAssertEqual(rejections, 1)
+                finished.fulfill()
+            }
+        }
+        wait(for: [finished], timeout: 3)
+    }
+}
+
 class PrintImageValidationTests: XCTestCase {
     func testInvalidImagesRejectBeforeOpeningPrinter() {
         for image in ["", "A", "SGVsbG8=", "iVBORw0KGgo="] {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rdlabo/capacitor-brotherprint",
   "private": false,
-  "version": "8.2.2",
+  "version": "8.2.3",
   "description": "Capacitor plugin for Brother Print SDK",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",